# 代付

# 请求地址

环境	地址
测试环境	http://8.130.9.219:8899/api/supefina/transactions/payout
正式环境	https://api.supefina.net/api/supefina/transactions/payout

# 提交方式

采用POST方法提交

# 请求参数 - 墨西哥

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述	示例值
国家编号	countryId	是	String		- MEX：墨西哥
订单金额	orderAmount	是	String	- 传入100，为100 MXN - 传入最大/最小订单金额时，订单金额也必须传入且必须在区间金额内 - 传入最大/最小订单金额时，以区间金额进行校验
支付产品	payProduct	是	String		- 15：Clabe - 16：银行卡
商户编号	merId	是	String
货币	currency	是	String		- MXN：墨西哥比索
顾客邮箱	customerEmail	否	String
顾客电话	customerPhone	否	String
下游商户订单号	merOrderNo	是	String
账户	account	是	String
收款人银行编号	bankId	是	String	见“下载”>"银行编码"
顾客名字	customerName	是	String
顾客地址	customerAddress	否	String
客户识别号	customerIdentification	否	String	身份证号或身份证明
客户识别号类型	customerIdentificationType	否	String
订单描述	description	是	String	不能带特殊符号
签名	sign	是	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 请求示例 - 墨西哥

{
    "countryId": "MEX",
    "orderAmount": "500",
    "payProduct": "15",
    "description": "111111",
    "merId": "8202000000430043",
    "currency": "MXN",
    "merOrderNo": "123123",
    "account": "659423129000010284",
    "bankId": "90659",
    "customerName": "sss",
    "customerIdentification": "12312312",
    "nonceStr": "12312",
    "sign": "376DA2980FD37223FD2CFB7BA3E0B9C8"
}

# 请求参数 - 哥伦比亚

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述
国家编号	countryId	是	String
订单金额	orderAmount	是	String
支付产品	payProduct	是	String
商户编号	merId	是	String
货币	currency	是	String
顾客邮箱	customerEmail	是	String
顾客电话	customerPhone	是	String
下游商户订单号	merOrderNo	是	String
账户	account	是	String
账户类型	accountType	是	String
银行编号	bankId	支付方式为银行卡时必填	String
银行名字	bankName	否	String
顾客名字	customerName	是	String
顾客地址	customerAddress	否	String
客户识别号	customerIdentification	是	String	身份证号或身份证明
客户识别号类型	customerIdentificationType	支付方式为银行卡时必填	String
订单描述	description	否	String
签名	sign	是	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 请求参数 - 秘鲁

Header

变量名	示例值
Content-Type	application/json

Body

字段名	变量名	必填	类型	描述
国家编号	countryId	是	String
订单金额	orderAmount	是	String
支付产品	payProduct	是	String
商户编号	merId	是	String
货币	currency	是	String
顾客邮箱	customerEmail	否	String
顾客电话	customerPhone	否	String
下游商户订单号	merOrderNo	是	String
账户	account	是	String
账户类型	accountType	是	String
银行编号	bankId	当“bankName”参数为“another bank”时必填	String
银行名字	bankName	是	String
顾客名字	customerName	是	String
顾客地址	customerAddress	否	String
客户识别号	customerIdentification	是	String	身份证号或身份证明
客户识别号类型	customerIdentificationType	是	String
订单描述	description	否	String
签名	sign	是	String
随机字符串	nonceStr	是	String	随机字符串长度不能超过32
交易额外参数	requestData	否	JSONObject	此字段为json对象，不需要可以不传或者传“null”
回调地址	callbackUrl	否	String	具体使用见“通知回调 - API”

# 响应

字段名	变量名	类型	示例值
响应编码	code	String
响应信息	msg	String
响应数据	data
商户编号	merCode	String
随机字符串	nonceStr	String
商户订单号	merOrderNo	String
supefina订单号	supefinaOrderNo	String
订单金额	amount	BigDecimal
手续费	fee	BigDecimal
交易状态	transactionStatus	String	- 00：预下单 - ~~01：交易成功~~ - ~~02：交易失败~~ - ~~03：支付拒绝~~ - 04：下单失败
交易链接	url	String
付款参考	reference	String
付款参考标识符	identifier	String

← 代收交易查询 →