回款查询接口

功能概述

商户可通过此接口主动查询回款订单的状态。

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一id,可在商户后台查看 M
partnerId 服务商id varchar(9) 二级商户上属服务商商户在首信易系统的唯一身份标识(如果发起商户自身即为主商户此项可不传) C
requestId 订单号 varchar(50) 所查询回款交易的商户订单号
商户订单号、回款流水号必填其一,同时填写优先使用回款流水号
C
orderId 回款流水号 varchar(50) 所查询回款交易的流水号
商户订单号、回款流水号必填其一,同时填写优先使用回款流水号
C
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

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

参数示例

{ "merchantId": "896666131", "requestId": "1527231168976", "partnerId": "890001312", "orderId": "WEGOBANK", "hmac": "hC798ERjAeIH4156o7ddAK9KVAgHNmvTIKwvZg==" }

请求返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 同请求参数
partnerId 服务商Id 同请求参数
requestId 订单号 该笔订单的商户订单号
orderId 回款流水号 该笔订单在首信易的流水号
bankCode 银行编码 银行电子账户的所属银行
accountNumber 银行账号 银行电子账户账号
amount 金额 该笔订单的回款金额,单位:分
status 请求状态 SUCCESS 成功
FAILED 失败
PROCESSING 处理中
CREDITING 待入账
ERROR 错误
errorMessage 错误信息 回款失败时返回错误信息
collectionType 回款方式 该笔回款订单的回款方式
AUTOMATIC 自动发起
MERCHANT 商户发起
hmac 参数签名 首信易生成的参数签名结果,验签过程请参考解密流程
{ "bankCode": "WEGOBANK", "collectionType": "AUTOMATIC", "amount": 4000, "merchantId": "899646896", "orderId": "8a898ae590e438c00190e7b697b70005", "requestId": "", "hmac": "mtRZnpL4RO+s+ZhRCOxMhnFvLu0y+8GXGy37sFKQ==", "errorMessage": "", "partnerId": "896666813", "accountNumber": "83205***0391", "status": "CREDITING" }