商户通过此接口查询订单转账状态。
备注:如果已获知订单已经为终态时,请保存。后续查询请查询本地数据,不要再次调用此接口。
https://webox-api.5upay.com/webox/transfer/query
| 参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
|---|---|---|---|---|
| merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一身份标识,商户完成首信易系统注册后可登录商户后台商户服务查看。 | M |
| requestId | 订单号 | varchar(50) | 转账预下单订单号 | M |
| hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
| 参数名称 | 参数中文名称 | 参数说明 |
|---|---|---|
| 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的方法请参考请求加密流程 |