通讯采用 https 协议,商户通过向首信易支付指定的 URL 发送账户间转账请求参数数据,并接受首信易支付返回的结果数据
https://apis.5upay.com/transferAccount/order
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一id,可在商户后台查看 | M |
partnerId | 服务商编号 | varchar(9) | 服务商在首信易系统的唯一id,可在商户后台查看 | O |
requestId | 订单编号 | varchar(50) | 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 | M |
receiverId | 收款方商户编号 | varchar(9) | 收款方账户在首信易系统的唯一标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
amount | 转账金额 | varchar(18) | 单位:分 | M |
currency | 币种 | varchar(15) | CNY | M |
remark | 备注 | varchar(300) | 备注 | O |
notifyUrl | 通知地址 | varchar(200) | 服务器通知:当订单状态为终态后首信易服务器会向该地址发送通知,该地址可以带参数,如:http://www.5upay.com/callback.action?test=test。 | M |
deputeMark | 托管模式标识 | 固定值 | DO_DEPUTE 托管 | O |
NOT_DO_DEPUTE 非托管 | ||||
不传默认为“非托管” | ||||
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
status | 请求状态 | SUCCESS 发起成功 |
FAILED 发起失败 | ||
ERROR 错误(此状态的返回参数见异常情况说明) | ||
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
receiverId | 收款方商户编号 | 收款方商户编号 |
amount | 转账金额 | 单位:分,1 元=100 分 |
currency | 币种 | 默认人民币 CNY |
remark | 备注 | 备注 |
status | 状态 | SUCCESS 转账成功 |
FAILED 转账失败 | ||
CANCEL 转账取消 | ||
completeDateTime | 完成时间 | 转账完成时间,格式:yyyy-MM-dd HH:mm:ss |
errorMessage | 错误信息 | 转账失败后会返回此参数告知商户转账失败原因 |
hmac | 参数签名 | 首信易生成的参数签名结果,验签过程请参考解密流程 |