商户通过此接口查询充值状态。
备注:如果已获知订单已经为终态时,请保存。后续查询请查询本地数据,不要再次调用此接口。
https://webox-api.5upay.com/webox/recharge/query
参数名称 | 参数中文名称 | 类型& 长度 | 参数说明 | 是否必填 |
---|---|---|---|---|
merchantId | 商户编号 | varchar(9) | 商户在首信易系统的唯一 id,可在商户后台查看 | M |
requestId | 订单号 | varchar(50) | 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。 | M |
hmac | 参数签名 | varchar(500) | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 | M |
参数名称 | 参数中文名称 | 参数说明 |
---|---|---|
status | 响应状态 | SUCCESS 响应正常 |
FAIL 响应异常 | ||
orderStatus | 订单状态 | INIT 初始化状态 |
PROCESS 处理中 | ||
SUCCESS 成功 | ||
CANCEL 取消 | ||
FAIL 失败 | ||
merchantId | 商户编号 | 同请求参数 |
requestId | 订单号 | 同请求参数 |
walletId | 钱包 ID | 钱包 ID |
serialNumber | 交易流水号 | 首信易支付系统交易流水号 |
currency | 币种 | CNY 人民币 |
amount | 充值金额 | 同请求参数 |
bankCardNumber | 卡号掩码 | 卡号掩码 |
bankCode | 银行代码 | 银行代码 |
bankName | 银行名称 | 银行名称 |
remark | 备注 | 在下单请求中提交的备注信息,返回给商户 |
createDateTime | 创建时间 | 预下单时间 格式:yyyy-MM-dd HH:mm:ss |
completeDateTime | 完成时间 | 支付完成时间 格式:yyyy-MM-dd HH:mm:ss |
orderErrorMessage | 订单错误信息 | 只有订单状态出现异常时返回此参数 |
hmac | 参数签名 | 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 |