商户通过此接口提交代付数据
https://apis.5upay.com/transferDomestic/single/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
requestId | 订单号 | varchar(50) | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 | M |
partnerId | 服务商编号 | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | C |
amount | 代付金额 | varchar(18) | 单位:分(如:1元=100) | M |
currency | 代付金额币种 | varchar(15) | CNY | M |
notifyUrl | 通知地址 | varchar(200) | 订单终态后首信易支付会向该地址发送五次成功通知,该地址可以带参数,“www.5upay.com/callback.action?test=test | M |
remark | 备注 | varchar(64) | 商户备注 | O |
payee | 收款人信息 | Json | 见payee表 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
以上参数值中不能包含以下特殊字符’”&<>()
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
name | 收款人姓名 | varchar(100) | 收款方姓名 | M |
bankCardNum | 银行卡号 | varchar(100) | 银行卡号 | M |
bankName | 银行名称 | varchar(100) | 代付到对公账户时此项必填。银行名称参照批量代付模板(商户后台-账户中心-代付-发起代付-批量-下载模板.xlsx) | C |
branchBankName | 支行名称 | varchar(100) | 支行名称 | O |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
status | 请求状态 | SUCCESS 发起成功(不代表代付成功,只能说明代付请求成功提交至首信易系统) |
FAILED 发起失败,重新发起 | ||
ERROR (此状态的返回参数见异常情况说明) | ||
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
partnerId | 服务商id | 同请求参数 |
serialNumber | 交易流水号 | 首信易系统交易流水号 |
amount | 代付金额 | 单位:分,1元=100分 |
currency | 代付币种 | 默认人民币CNY |
status | 状态 | SUCCESS 打款到账成功 |
FAILED 打款失败,重新发起 | ||
CANCEL 打款取消,重新发起 | ||
completeDateTime | 完成时间 | 代付完成时间 |
remark | 备注 | 在下单请求中提交的备注信息 |
errorMessage | 错误信息 | 代付失败后会返回此参数告知商户代付失败原因 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |