提现查询接口

功能概述

商户通过此接口查询订单提现状态。

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

接口地址

https://webox-api.5upay.com/webox/withholding/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 打款中
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的方法请参考请求加密流程

参数示例

{ "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" }