代付提交

功能概述

商户通过此接口提交代付数据

接口地址

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

以上参数值中不能包含以下特殊字符’”&<>()

请求参数(payee,收款人信息)

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
name 收款人姓名 varchar(100) 收款方姓名 M
bankCardNum 银行卡号 varchar(100) 银行卡号 M
bankName 银行名称 varchar(100) 代付到对公账户时此项必填。银行名称参照批量代付模板(商户后台-账户中心-代付-发起代付-批量-下载模板.xlsx) C
branchBankName 支行名称 varchar(100) 支行名称 O

参数示例

{ "payee": { "bankCardNum": "62148***8077", "name": "张**", "branchBankName": "", "bankName": "招商银行" }, "amount": "100", "merchantId": "890000595", "requestId": "1502851459402", "hmac": null, "notifyUrl": "https://demo.5upay.com/sdk", "currency": "CNY", "remark": "" }

同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商id 同请求参数
status 请求状态 SUCCESS 发起成功(不代表代付成功,只能说明代付请求成功提交至首信易系统)
FAILED 发起失败,重新发起
ERROR (此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "890000595", "requestId": "1527746602492", "hmac": "959e138ad2e290328e8d59fd124c618f", "status": "SUCCESS" }

异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
partnerId 服务商id 同请求参数
serialNumber 交易流水号 首信易系统交易流水号
amount 代付金额 单位:分,1元=100分
currency 代付币种 默认人民币CNY
status 状态 SUCCESS 打款到账成功
FAILED 打款失败,重新发起
CANCEL 打款取消,重新发起
completeDateTime 完成时间 代付完成时间
remark 备注 在下单请求中提交的备注信息
errorMessage 错误信息 代付失败后会返回此参数告知商户代付失败原因
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "serialNumber": "832f3f1bdab749849fd5bcf46d3ff7e3", "amount": "1000", "currency": "CNY", "merchantId": "890000595", "requestId": "1527746602492", "hmac": "c5ab9be868a4b79872739362995b39db", "completeDateTime":"2018-03-08 17:01:54", "remark": "备注", "status": "SUCCESS" }