回款请求接口

功能概述

当约定的回款模式为“商户发起”时,商户可通过此接口向首信易发起回款请求,将商户银行电子账户的指定金额汇入首信易备付金

接口地址

https://apis.5upay.com/eaccount/transInOrder

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商id varchar(9) 二级商户上属服务商商户在首信易系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
requestId 订单号 varchar(50) 商户自行拟定,提交的订单号必须在自身账户交易中唯一 M
bankCode 银行编码 固定值 WEGOBANK 蓝海银行 M
accountNumber 银行账号 varchar(50) 银行电子账户账号 M
amount 金额 varchar(50) 单位:分 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

注意:以上参数值中不能包含以下特殊字符 ' " & < > ( ) 空格

参数示例

{ "merchantId": "896666131", "requestId": "1527231168976", "partnerId": "890001312", "bankCode": "WEGOBANK", "amount": "100", "hmac": "hC798ERjAeIH4156o7ddAK9KVAgHNmvTIKwvZg==" }

请求返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
requestId 订单号 同请求参数
orderId 回款流水号 该笔订单在首信易的流水号
status 请求状态 SUCCESS 成功
ERROR 错误
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程
{ "merchantId": "899646896", "orderId": "8a8984a390e887420190e88eb7b70002", "requestId": "1721874020249725008", "hmac": "peYQ/SGxI69WG+OFjDfUesQlvi2lkE6y1g63qyAiXQ==", "partnerId": "896666813", "status": "PROCESSING" }