充值查询接口

功能概述

商户通过此接口查询充值状态。

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

接口地址

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

参数名称 参数中文名称 类型& 长度 参数说明 是否必填
merchantId 商户编号 varchar(9) 商户在首信易系统的唯一 id,可在商户后台查看 M
requestId 订单号 varchar(50) 提交的订单号必须在账户交易中唯一;首信易数据支付系统中对于已创建的订单,商户端不能重复提交。 M
hmac 参数签名 varchar(500) 商户生成的参数签名结果,获取hmac的方法请参考请求加密流程 M

参数示例

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

同步返回参数列表

参数名称 参数中文名称 参数说明
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的方法请参考请求加密流程

参数示例

{ "bankCode":"ICBC", "walletId":"33704400121845673", "amount":"10", "serialNumber":"201911042372723735545584806014976", "bankCardNumber":"621***1763", "orderStatus":"PROCESS", "bankName":"中国工商银行", "createDateTime":"2019-11-04 19:37:40", "merchantId":"890000595", "requestId":"202002251582614048062", "hmac":"aZfS47oJ+9TaPcZGFBbjJ+jQz8Br6FBJhzcQnVVPVeLCG3AN0Lbu4SzznmAiFuGmv HzRjfE3Yg12fGm+C7DIbpKMV4Xk+i5DORCvReSc8YOIb69sEpJ/R5LEO0VtQmv3jmXCQpd 2i5g4c2TSPptXWvWOHYJdVAAXC8X/jHPs4f0Ag7tZ7SfWBzE6fKt1/qkizCqisbDcZvAmTfzor GqjRUC+2JCQNuyC9J70w64Jc+Riz370QyjVxooeyuKBJXrC6C2j2yg928ANpEehn+hAh3FSml wvDs9VAm4+SDELDTxUc33OhDTFmk9z1jAVOTetEoTe41OgGVySE4zKll0xtg==", "currency":"CNY", "status":"SUCCESS" }