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

国家编号 参照:字典表-国家编号 阿根廷:ARG

merId

String

商户ID 商户ID获取路径:Supefina商户后台-商户管理-基本信息-商户ID

merOrderNo

String

商户订单号

payProduct

String

支付类型 Transfer:12

currency

String

币种 参照:字典表-货币 阿根廷比索:ARS

orderAmount

String

订单金额 只支持整数

customerEmail

String

用户邮箱

邮箱用户名不能只有数字(例如[email protected])且同一个邮箱一天支付请求不能超过20次。

customerName

String

用户姓名

customerPhone

String

用户电话

customerIdentificationType

String

用户证件类型

00:身份证(DNI)

02:税号(CUIT)

11:社会保障号(CUIL)

12:外国人税号(CDI)

customerIdentification

String

用户身份证件号

account

String

用户收款cbu或cvu账号

alias

String

用户收款cbu或cvu账号别名

nonceStr

String

随机字符串 长度不能超过32位

sign

String

description

String

描述

不能带特殊符号,长度不超过200字符

callbackUrl

String

回调地址

详见通知回调说明

请求示例

{
    "countryId": "ARG",
    "currency": "ARS",
    "orderAmount": 100,
    "payProduct": "12",
    "merId": "81027695265247",
    "merOrderNo": "20241113013257171",
    "sign": "xxxxxx",
    "nonceStr": "12312",
    "customerEmail": "[email protected]",
    "customerName": "test name"",
    "customerPhone": "123456789",
    "customerIdentificationType": "02",
    "customerIdentification": "11111111-1",
    "account": "0000001700000000111117",
    "description": "test",
    "callbackUrl": "http://127.0.0.1:8080/test",
    "alias":"test"
}

响应参数

变量名
类型
描述

code

String

响应编码 具体参照:响应状态码

msg

String

信息

data

Object

响应数据

amount

BigDecimal

订单金额

merCode

String

商户ID

merOrderNo

String

商户订单号

supefinaOrderNo

String

supefina订单号

transactionStatus

String

下单状态 该笔订单的的发起状态是否成功,与订单真正的交易状态无关。 00:下单成功 04:下单失败

响应示例

{
    "code": "200",
    "msg": "success",
    "data": {
        "merCode": "81027695265247",
        "merOrderNo": "20241113013257171",
        "supefinaOrderNo": "20250212035845634000039707",
        "amount": 100,
        "transactionStatus": "00"
    }
}

回调通知

提交方式: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

实收手续费

reference

String

标识符

sign

String

签名

status

String

交易状态 具体参照:字典表——交易订单状态

successTime

String

交易成功时间

回调通知示例

{
	"amount": "100.00",
	"countryId": "ARG",
	"customerName": "test name",
	"fee": "2.20",
	"identifier": "706180968985601627",
	"merId": "81027695265247",
	"merOrderId": "20241113013257171",
	"msg": "SUCCESS",
	"nonceStr": "e3b8b9c1-00d1-4ca2-ab4a-afa130",
	"realityAmount": "100.00",
	"realityFee": "2.20",
	"reference": "c012afeb-76b3-43",
	"sign": "test",
	"status": "01",
	"supefinaOrderId": "202502120358456340000391117",
	"transactionType": "02"
}

回调通知响应

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

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

最后更新于