退款查询接口

介绍

商户进行退款后,可以通过此接口查询订单的退款状态。

接口说明

请求方式:POST

请求路径:open/api/payment/refundQuery

请求参数

Body参数:

参数名验签必选类型长度说明
appIdstring64appID
merchantOrderNostring64商户订单号
signstring64签名

返回参数:

参数名验签类型长度说明
refundTypestring64退款类型
merchantOrderNostring64商户订单号
paymentOrderNostring64ach支付单号
orderStatusstring16退款订单状态:INIT,PENDING,SUCCESS,FAILED
tokenAmountstring16token数量
faitAmountstring16法币数量
fiatCurrencystring16法币币种
refundNetworkstring32退款网络(例:TRX)
refundTokenstring32退款币种(例:USDT)
hxAddressstring256退款订单的hash地址
refundOrderNostring64ach退款单号

退款类型参数:

退款类型返回內容说明
USER_WITHDRAW"USER_WITHDRAW"用户发起提现
MERCHANT_APPROVE_REFUND"MERCHANT_APPROVE_REFUND"商户申请退款

返回参数示例:

{
    "code": "0",
    "msg": "success",
    "model": [
        {
            "refundType": "MERCHANT_APPROVE_REFUND",
            "merchantOrderNo": "17192822400000test",
            "refundOrderNo": "131313131",
            "paymentOrderNo": null,
            "orderStatus": "INIT",
            "refundCurrency": null,
            "refundNetwork": null,
            "refundAmount": "6.00",
            "hxAddress": null
        }
    ],
    "traceId": "66d98888e6d82738ab3841e8906fb7a6",
    "success": true,
    "error": false
}