查询接口

功能概述

本接口用于商户查询汇款状态,可用于补单。

接口地址

https://apis.5upay.com/transfer/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(50) 订单号为商户自行拟定,提交的订单号必须在自身平台交易中唯一。首信易支付系统已付或撤销的订单,商户平台不能以相同的订单号再次提交。 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "120141994", "requestId": "1493799454674", "hmac": null }

订单查询返回参数列表

参数名称 参数中文名称 参数说明
merchantId 商户编号 商户编号
requestId 订单号 提交的订单号必须在自身账户交易中唯一;首信易支付系统中对于已付或者撤销的订单,商户端不能那个重复提交。
serialNumber 交易流水号 首信易系统交易流水号
currency 汇单金额币种 CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币)
amount 支付金额 单位:分,1 元=100
status 汇款状态 SUCCESS 汇款成功
CANCEL 汇款失败
completeDataTime 创建时间 汇款完成时间
foexignExchangeResponse 购汇返回参数 见下表,购汇返回参数
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

返回参数(foexignExchangeResponse,购汇返回参数)

参数名称 参数中文名称 参数说明
amount 购汇金额 单位:分,1 元=100 分
currency 购汇币种 CNY(人民币)、USD(美元)、JPY(日元)、EUR(欧元)、CHF(瑞士法郎)GBP(英镑)、CAD(加拿大元)、AUD(澳大利亚元)、HKD(港币)
status 购汇状态 SUCCESS 购汇成功
CANCEL 购汇失败
listprice 牌价标识 牌价标识
deductionAmount 购汇扣减额 购汇扣除的人民币金额
completeDataTime 购汇时间 购汇完成时间

示例

{ "merchantId": "120141994", "requestId": "1493799454674", "serialNumber": "2ae9fe97b3fb4f5ab85effb7ba4461ca", "currency": "CNY", "amount": "70", "completeDateTime": "2018-05-04 14:11:23", "foexignExchangeResponse": { "amount": 10, "currency": "USD", "status": "INIT", "deductionAmount": 65, "completeDataTime": "2018-05-05 10:56:32" }, "status": "SUCCESS", "hmac": "7d4db4d001dbb429780c0e8360be5872" }