转账查询接口

功能概述

商户通过此接口查询订单转账状态。

备注:如果已获知订单已经为终态时,请保存。后续查询请查询本地数据,不要再次调用此接口。

接口地址

https://webox-api.5upay.com/webox/transfer/query

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 M
requestId 订单号 varchar(50) 转账预下单订单号 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

{ "merchantId": "890000595", "requestId": "202002251582614048062", "hmac": null }

同步返回参数列表

参数名称 参数中文名称 参数说明
status 响应状态 SUCCESS 响应正常
FAIL 响应异常
orderStatus 转账状态 INIT 初始化状态
PROCESS 处理中,付款前状态
SEND 扣款成功,收款方未确认
SUCCESS 转账成功,收款方已经确认
REJECT 拒收,收款方主动拒收
TIMEOUT 超时,超过 24 小时未领取,订单原金额退还
FAIL 失败,付款前失败
CANCEL 取消,没有支付,24 小时后变取消
merchantId 商户编号 同请求参数
requestId 订单号 同请求参数
walletId 钱包 ID 钱包 ID
targetWalletId 收款方钱包 id 收款方钱包 id
serialNumber 交易流水号 首信易支付系统交易流水号
currency 币种 默认:CNY
amount 转账金额 单位为:分
bankCardNumber 卡号掩码 卡号掩码
bankCode 银行代码 银行代码
bankName 银行名称 银行名称
paymentType 支付方式 BALANCE 余额支付
BANK_CARD 银行卡支付
remark 备注 在下单请求中提交的备注信息,返回给商户
createDateTime 创建时间 转账预下单时间, 格式:yyyy-MM-dd HH:mm:ss
debitDateTime 支付完成时间 转账转出时间 格式:yyyy-MM-dd HH:mm:ss
completeDateTime 完成时间 转账确认、拒收或退回时间, 格式:yyyy-MM-dd HH:mm:ss
orderErrorMessage 订单错误信息 只有转账状态出现异常时返回此参数
hmac 参数签名 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程

参数示例

{ "bankCode":"ICBC", "walletId":"33704400121811473", "amount":1, "completeDateTime":"2019-11-05 10:06:54", "serialNumber":"20191105899725376308421777252352", "bankCardNumber":"621***1763", "orderStatus":"SUCCESS", "bankName":"中国工商银行", "targetWalletId":"33704400121811474","createDateTime":"2019-11-05 09:55:19", "paymentType":"BANK_CARD", "merchantId":"890000595", "requestId":"202002251582614048062", "hmac":"1dnOOVjIGN6e5uJDBScR6ljXtx/Ch5N/ODRfV1VGC4OEoCp1Vj2SVfoYiFteJWgEw/ H6VLg40gXqIqNHYs8ODUNHptZaDEFCc16CTa+Koxi7VCVu7JRAaDG66v8HSXJhvWQIVl Uwlb4liDtPsi2+TTsNECx1GW8y8kGis+JVgSwa2VGubllK3mJy5eeuG8sZttTnul3XQ1kE/b3f2a FSk6Wvo+CTcGafhQmwnuXf1hCaojdjBmYZQoUrO/b5/rWvKgcowZH5XtSr2hHpLjbLkmlQ7 mI6+s3RgX6KJhheZH+V3CUYmXzBmpGLDhoWL1UqNlFgAa2D0UXA4qqGSWaQDg==", "currency":"CNY", "status":"SUCCESS" }