Transfer

（payProduct=20）

请求地址

环境名称	URL
SandBox	POST http://8.130.9.219:8899/api/supefina/transactions/payout
正式环境	POST https://api.supefina.net/api/supefina/transactions/payout

请求方式

请求头

Key	Value
Content-Type	application/json

请求体

变量名	类型	必填	描述
account	String	是	收款方账户号 1、秘鲁四大银行账户类型及位数： 03--BBVA，活期账户和储蓄账户位数18位或20位； 04--SCOTIABANK，活期账户和储蓄账户位数10位； 02--INTERBANK，活期账户和储蓄账户位数13位； 01--BCP，00（活期账户）位数13位且在第11位为0；01（储蓄账户）位数14位且在第12位为0。 2、不能带小数点和"-"等特殊符号，只能纯数字。 3、示例：1110333711
accountType	Strin	是	收款方账户类型 00：CORRIENTE(活期账户) 01：AHORROS(储蓄账户) 示例：00
app	String	是	订单app名称
bankName	String	是	银行名称 示例：01，具体参照：秘鲁代付银行列表
callbackUrl	String	否	回调地址 详见通知回调说明
cciNumber	String	否	收款人中转账户 1、当bankName为非四大行（BCP、Interbank、BBVA、Scotiabank），该字段必传。 2、cciNumber位数20位。 3、不能带小数点和"-"等特殊符号，只能纯数字。 4、示例：00911120111033371164
countryId	String	是	国家编号 参照：字典表-国家编号 秘鲁，PER
currency	String	是	币种 参照：字典表-货币 秘鲁比索：PEN
customerEmail	String	是	收款人邮箱
customerIdentification	String	是	用户证件号 00：身份证（DNI），8位 01：外国人身份证（CE），≥9位 02：税号（RUC），11位 03：护照（PAS），≥9位 注意：不能带小数点和"-"等特殊符号，只能纯数字。 示例：42340816
customerIdentificationType	String	是	用户证件类型 00：身份证（DNI） 01：外国人身份证（CE） 02：税号（RUC） 03：护照（PAS） 示例：00
customerName	String	是	收款人姓名
customerPhone	String	是	收款人电话 区号（+51、51）+9位数字手机号，区号可传可不传 示例： [phone]（含区号+51） 51123456789（含区号51） 123456789（不包含区号的电话号码）
merId	String	是	商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID
merOrderNo	String	是	商户订单号
nonceStr	String	是	随机字符串 长度不能超过32位
orderAmount	String	是	订单金额 传入100，为100 PEN，支持2位小数
payProduct	String	是	支付类型 Transfer：20
sign	String	是	签名 具体参照：签名算法

请求示例

{
    "account": "19299172588073",
    "accountType": "01",
    "app": "supefina",
    "bankName": "01",
    "callbackUrl": "https://test.com",
    "countryId": "PER",
    "currency": "PEN",
    "customerEmail": "[e-mail]",
    "customerIdentification": "73313761",
    "customerIdentificationType": "00",
    "customerName": "Test Name",
    "customerPhone": "52173996789",
    "merId": "8202157333970291",
    "merOrderNo": "8485233309941743872",
    "nonceStr": "52b6350acc364578b3d25f30a8ee95f3",
    "orderAmount": "105.00",
    "payProduct": "20",
    "sign": "5E57AE7AF2548AA9020C52752C6A963C"
}

响应参数

变量名	类型	描述
code	String	响应编码 具体参照：响应状态码
data	Object	响应数据
amount	BigDecimal	订单金额
fee	BigDecimal	预收手续费
merCode	String	商户ID
merOrderNo	String	商户订单号
supefinaOrderNo	String	supefina订单号
transactionStatus	String	下单状态 该笔订单的的发起状态是否成功，与订单真正的交易状态无关。 00：下单成功 04：下单失败
msg	String	响应信息

响应示例

{
    "code": "200",
    "data": {
        "amount": 105.00,
        "fee": 3.00,
        "merCode": "8202157333970291",
        "merOrderNo": "8485233309941743872",
        "supefinaOrderNo": "2024052001860105b0fae306a6e43",
        "transactionStatus": "00"
    },
    "msg": "success "
}

回调通知

提交方式：POST

代付存在两次回调通知状态。代付成功收到成功回调事件后，仍然可能接收到代付状态改变的回调事件，代付状态由成功变为失败，这种订单只会出现在秘鲁跨行转账中，执行付款银行会检查账户信息两次，初次通过后渠道就回调成功了，银行第二次检查时，发现账户可能被锁定、账户类型不能转账等，银行不会付款，会一周/一月通知渠道一次。

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

回调通知示例

{
    "amount": "105.00",
    "countryId": "PER",
    "customerName": "Test Name",
    "fee": "3.00",
    "merId": "8202157333970291",
    "merOrderId": "8485233309941743872",
    "msg": "success",
    "nonceStr": "76abf1f3-0486-4c1e-ac2a-1d9e17",
    "realityAmount": "105.00",
    "realityFee": "3.00",
    "sign": "11D7CBC5B0C337F904F227628813F5DE",
    "status": "01",
    "successTime": 1716249060000,
    "supefinaOrderId": "2024052001860105b0fae306a6e43",
    "transactionType": "02"
}

回调通知响应

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

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

秘鲁代付银行列表

01	bcp
02	interbank
03	bbva
04	scotiabank
05	Banco de Comercio
06	BanBif (Banco Interamericano de Finanzas)
07	Banco Pichincha
08	Citibank
09	Banco GNB
10	Banco Santander
11	Banco Azteca
12	Banco Cencosud
13	ICBC PERU BANK
14	Banco de la Nación
15	Caja Cusco
16	Caja Huancayo
17	Caja Maynas
18	Caja Metropolitana
19	Caja Municipal Ica
20	Caja Sullana
21	Caja Tacna
22	Caja Trujillo