Transfer

（payProduct=12）

请求地址

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

请求方式

请求头

Key	Value
Content-Type	application/json

请求体

变量名	类型	必填	描述
countryId	String	是	国家编号 参照：字典表-国家编号 智利，CHL
merId	String	是	商户ID 商户ID获取路径：Supefina商户后台-商户管理-基本信息-商户ID
payProduct	String	是	支付类型 Transfer：12
currency	String	是	币种 参照：字典表-货币 智利比索：CLP
merOrderNo	String	是	商户订单号
orderAmount	String	是	订单金额 单位比索，只支持整数
customerName	String	是	用户名字 首尾不得包含空格，但姓名之间可以有空格
customerEmail	String	是	用户邮箱
customerPhone	String	是	用户电话
customerIdentification	String	是	用户证件号(RUT证件号位数8位或9位)， 最后一位可以是0-9的数字或字母K，现已支持特殊字符 示例：13251657-K
customerAddress	String	是	用户地址
accountType	Strin	是	收款方账户类型 00--Corriente（活期账户） 01--Ahorro（储蓄账户） 02-- RUT（只有0012-banco estado有这个类型） 07--Vista/Cuenta 08--SALARY ACCOUNT
account	String	是	收款方账户号（当'bankId'是0012-banco estado,银行位数最多是12位，且当0012-banco estado的accountType是02时，account是customerIdentification的前8位数字，示例：26484404）
bankId	String	是	收款人银行编号 参照：“下载”>智利银行编码"
bankName	String	是	收款人银行名称 参照：“下载”>智利银行编码"
nonceStr	String	是	随机字符串 长度不能超过32位
description	String	是	订单描述
sign	String	是	签名 具体参照：签名算法
callbackUrl	String	否	回调地址 详见通知回调说明
customerIdentificationType	String	是	用户证件类型 02: 税号 --RUT 03：护照

请求示例

{
    "account": "50257382",
    "accountType": "00",
    "bankId": "0016",
    "bankName": "BCI",
    "countryId": "CHL",
    "currency": "CLP",
    "customerAddress": "test online 01",
    "customerEmail": "[email protected]",
    "customerIdentification": "111111111",
    "customerName": "Ignacio Andres Donoso Pinochet",
    "customerPhone": "923122312",
    "description": "111111",
    "merId": "8202411379430193",
    "merOrderNo": "testonline",
    "nonceStr": "12312",
    "orderAmount": "1000",
    "payProduct": "12",
    "sign": "CA82EC94A7ED1519812C95E564C7900B",
    "customerIdentificationType": "00"
}

响应参数

变量名	类型	描述
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	预收手续费
identifier	String	付款参考 Clabe
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": "CHL",
    "customerName": "Test Name",
    "fee": "3.00",
    "identifier": "706180968985601627",
    "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";
}

智利代付银行列表

bankId	bankName
0504	Scotiabank Azul
0028	Banco Bice
0055	Banco Consorcio
0001	Banco de Chile
0012	Banco Estado
0051	Banco Falabella
0039	Banco Itau
0053	Banco Ripley
0049	Banco Security
0016	BCI
729	Caja Los Heroes
0672	Coopeuch
732	Los Andes
875	Mercado Pago
0037	Santander
0014	Scotiabank
730	Tenpo
0507	Banco del desarrollo
0009	Banco Internacional
027	Itau-Corpbanca
031	Hsbc Bank
057	Banco Paris
0152	Prepago Los Heroes
0738	Global 66