提现查询接口
功能概述
商户通过此接口查询订单提现状态。
备注：如果已获知订单已经为终态时，请保存。后续查询请查询本地数据，不要再次调用此接口。
接口地址
https://webox-api.5upay.com/webox/withholding/query
| 参数名称 |
参数中文名称 |
类型& 长度 |
参数说明 |
是否必填 |
| merchantId |
商户编号 |
varchar(9) |
商户在首信易系统的唯一 id，可在商户后台查看 |
M |
| requestId |
订单号 |
varchar(50) |
提现预下单订单号 |
M |
| hmac |
参数签名 |
varchar(500) |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
M |
参数示例
<![CDATA[
{
"merchantId": "890000595",
"requestId": "202002251582614048062",
"hmac": null
}
]]>
同步返回参数列表
| 参数名称 |
参数中文名称 |
参数说明 |
| status |
响应状态 |
SUCCESS 响应正常
|
| FAIL 响应异常 |
| orderStatus |
提现状态 |
INIT 初始化状态
|
| PROCESS 打款中 |
| CANCEL 取消 |
| SUCCESS 成功 |
| FAIL 失败 |
| merchantId |
商户编号 |
同请求参数 |
| requestId |
订单号 |
同请求参数 |
| walletId |
钱包 ID |
钱包 ID |
| serialNumber |
交易流水号 |
首信易支付系统交易流水号 |
| currency |
币种 |
CNY |
| amount |
提现金额 |
同请求参数 |
| arrivalAmount |
实际到账金额 |
同请求参数 |
| bankCardNumber |
卡号掩码 |
卡号掩码 |
| bankCode |
银行代码 |
银行代码 |
| bankName |
银行名称 |
银行名称 |
| remark |
备注 |
在下单请求中提交的备注信息，返回给商户 |
| createDateTime |
发起时间 |
预下订单时间， 格式：yyyy-MM-dd HH:mm:ss |
| completeDateTime |
完成时间 |
支付完成时间，格式：yyyy-MM-dd HH:mm:ss |
| orderErrorMessage |
订单错误信息 |
只有提现状态出现异常时返回此参数 |
| hmac |
参数签名 |
商户生成的参数签名结果，获取hmac的方法请参考请求加密流程 |
参数示例
<![CDATA[
{
"bankCode":"ICBC",
"walletId":"33704400121800000",
"amount":1,
"completeDateTime":"2019-11-05 10:36:08",
"serialNumber":"20191105236638376317738249183232",
"arrivalAmount":1,
"bankCardNumber":"621***1763",
"orderStatus":"SUCCESS",
"bankName":"中国工商银行",
"createDateTime":"2019-11-05 10:32:20",
"merchantId":"890000595",
"requestId":"202002251582614048062",
"hmac":"S26ynGubVJrHI5dn1EVtm0mse01koQfsp9ivN6bb5xnQNy8FC2mQPh9+vzUQnyYA/p
H9KOWABL8ryJ/kbfjCPQ3NnuoPkN1l3/W1d/UQhuRyTS6wIdtW9uDuBvap/zGU/7N52/1Gppis
NI1uI4rsakGVoagNyw4jj6OiEihUUdd2sCfrnv/9ER0BbriYBJfNlR86VAttBwWVOMHT1V3Ax1
UyRXDPAHI5S0AsbiGZSCa5c07wDCsV4zyS/rbI/S8fao5uOnu9SQRolBCy9EbRlBr6yX6Lw9O
V/0NuEJW6V3CYbvADdbvnejjCeItKR+qt7a6iTd2CMisWDLahZUjjPg==",
"currency":"CNY",
"status":"SUCCESS"
}
]]>