🇵🇪秘鲁

（多种支付方式集成）

目前支持的支付产品

1. Cash

2. Transfer

支付流程（具体支付方式的流程请查看代收列表中的文档）

1. 用户在商户网站进行下单付款.

2. 商户向Supefina发起API支付请求.

3. Supefina返回聚合收银台地址以及相关单号数据.

4. 用户在收银台上选择相关的支付方式并进行付款操作.

5. Supefina通知商户订单成功.

请求地址

环境名称	URL
SandBox	POST https://api.supefina.tech/api/supefina/transactions/payin
正式环境	POST https://api.supefina.net/api/supefina/transactions/payin

请求参数

请求头

Key	Value
Content-Type	application/json

请求体

变量名	类型	必填	描述
countryId	String	是	国家编号 参照：字典表-国家编号 秘鲁：PER
currency	String	是	币种 参照：字典表-货币 秘鲁索尔：PEN
orderAmount	String	是	订单金额
payProduct	String	否	支付类型 如果不传入则拉取商户配置下全部支付方式的收银台。 如果传入相关支付方式，则收银台上只展示对应的支付方式。 注意： 如果此时传入没有配置的支付方式会返回异常信息。
customerIdentification	String	是	用户证件号 00：身份证（CC），8位 01：外国人身份证（CE），大于9位 02：税号，11位 03：护照，大于9位 04：离境证（PAR） 05：军官证（LMI） 同一个证件号customerIdentification进行代收 不超过20次/天
customerIdentificationType	String	是	用户证件类型 00：身份证（CC） 01：外国人身份证（CE） 02: 税号 03：护照（PAS) 04：离境证（PAR） 05：军官证（LMI）
customerName	String	是	用户姓名
lastName	String	是	用户姓氏
customerPhone	String	是	用户电话, 9位数字 示例：975728895
customerEmail	String	是	用户邮箱
expireTimeL	Long	否	收银台过期时间（单位秒） 1. 如果不传入默认12H 2.如果传入的时间小于3分钟或者大于7天，我们也会默认为12H
merId	String	是	商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID
merOrderNo	String	是	商户订单号
description	String	是	付款相关描述
callbackUrl	String	否	回调地址 详见通知回调说明
checkOut	Boolean	是	拉取聚合收银台条件 此模式下只支持传入true
nonceStr	String	是	随机字符串 长度不能超过32位
sign	String	是	签名 具体参照：签名算法

请求示例

1. 开通全部支付方式 — 不传入payProduct

{
    "customerIdentificationType": "00",
    "lastName": "xxxx",
    "merOrderNo": "20240920195501",
    "sign": "xxxxxx",
    "customerIdentification": "22345678",
    "countryId": "PER",
    "nonceStr": "20240920195501",
    "customerName": "xxxx",
    "customerPhone": "1234567890",
    "orderAmount": 100,
    "customerEmail": "[email protected]",
    "merId": "xxxxxxx",
    "checkOut": "true",
    "description":"supefina",
    "currency": "PEN",
    "callbackUrl": "xxxxxxxx"
}

1. 传入指定的支付方式

• payProduct：03

{
    "customerIdentificationType": "00",
    "payProduct":"03",
    "lastName": "xxxx",
    "merOrderNo": "20240920195501",
    "sign": "xxxxxx",
    "customerIdentification": "22345678",
    "countryId": "PER",
    "nonceStr": "20240920195501",
    "customerName": "xxxx",
    "customerPhone": "1234567890",
    "orderAmount": 100,
    "customerEmail": "[email protected]",
    "merId": "xxxxxxx",
    "checkOut": "true",
    "description":"supefina",
    "currency": "PEN",
    "callbackUrl": "xxxxxxxx"
}

• payProduct：12

{
    "customerIdentificationType": "00",
    "payProduct":"12",
    "lastName": "xxxx",
    "merOrderNo": "20240920195501",
    "sign": "xxxxxx",
    "customerIdentification": "22345678",
    "countryId": "PER",
    "nonceStr": "20240920195501",
    "customerName": "xxxx",
    "customerPhone": "1234567890",
    "orderAmount": 100,
    "customerEmail": "[email protected]",
    "merId": "xxxxxxx",
    "checkOut": "true",
    "description":"supefina",
    "currency": "PEN",
    "callbackUrl": "xxxxxxxx"
}

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
msg	String	响应描述
data	Object	响应数据
merCode	String	商户ID
merOrderNo	String	商户订单号
supefinaOrderNo	String	Supefina订单号
amount	BigDecimal	订单金额
url	String	交易链接
currency	String	币种

响应示例 — 成功

{
    "code": "200",
    "msg": "success ",
    "data": {
        "merCode": "xxxxxx",
        "merOrderNo": "20240920195501",
        "supefinaOrderNo": "2025011877295415489306624",
        "amount": 100,
        "url": "http://h5.supefina.tech/combineCashier?token=349472b99a184e0f9da91a3b290d4ad7",
        "currency": "PEN"
    }
}

响应示例 — 失败

{
    "code": "400",
    "msg": "param error customerName cannot be empty"
}

回调通知 — 提交方式：POST

变量名	类型	描述
amount	String	订单金额
countryId	String	国家编号
fee	String	预收手续费
identifier	String	付款参考 Clabe
merId	String	商户编号
merOrderId	String	商户订单号
msg	String	消息
nonceStr	String	随机字符串 长度不能超过32位
realityAmount	String	实收金额
realityFee	String	实收手续费
reference	String	标识符
sign	String	签名
status	String	交易状态 具体参照：字典表——交易订单状态
successTime	Date	交易成功时间 UTC时间
supefinaOrderId	String	supefina订单号
transactionType	String	交易类型 01：代收

回调通知示例

{
    "amount": "230.00",
    "countryId": "PER",
    "customerName": "Test Name",
    "fee": "6.90",
    "identifier": "90911988431",
    "merId": "8202980903390150",
    "merOrderId": "17922853818122896811753697281175369728",
    "nonceStr": "935111b9-968e-4b3d-9036-fd1acf",
    "realityAmount": "230",
    "realityFee": "6.90",
    "reference": "90911988431",
    "sign": "69DF96903B85CD1408BD6849C62254C0",
    "status": "01",
    "successTime": 1716149235000,
    "supefinaOrderId": "202405190101010696298b1ca1141",
    "transactionType": "01"
}

回调通知响应

商户成功收到回调后需同步返回指定字符串：SUCCESS 不返回或返回其他内容默认通知失败 如：

public String test(){
	return "SUCCESS";
}