账户间转账

功能概述

通讯采用 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": "890000595", "partnerId": "890001312", "requestId": "1527231168976", "receiverId": "890000593", "amount": "1527231168976", "currency": "CNY", "remark": "备注", "notifyUrl": " https://demo.5upay.com/sdk ", "hmac": null }

请求同步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
status 请求状态 SUCCESS 发起成功
FAILED 发起失败
ERROR 错误(此状态的返回参数见异常情况说明)
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "merchantId": "890000595", "hmac": "b83dfbc1eb979631c4d1748f165eb5ef", "requestId": "1502851459402", "status": "SUCCESS" }

订单异步返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
receiverId 收款方商户编号 收款方商户编号
amount 转账金额 单位:分,1 元=100 分
currency 币种 默认人民币 CNY
remark 备注 备注
status 状态 SUCCESS 转账成功
FAILED 转账失败
CANCEL 转账取消
completeDateTime 完成时间 转账完成时间,格式:yyyy-MM-dd HH:mm:ss
errorMessage 错误信息 转账失败后会返回此参数告知商户转账失败原因
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程

参数示例

{ "receiverId": "890000593", "amount": "1000", "currency": "CNY", "merchantId": "890000595", "requestId": "1527746602492", "hmac": "c5ab9be868a4b79872739362995b39db", "completeDateTime": "2020-09-08 17:01:54", "remark": "备注", "status": "SUCCESS" }