Introduction

After processing a refund, merchants can use this API to check the refund status of an order.

API Description

Request Method: POST

Request URL: open/api/payment/refundQuery

Body Parameters

Parameter	Signature Required	Required	Type	Length	Description
appId	Yes	Yes	string	64	Application ID
merchantOrderNo	Yes	Yes	string	64	Merchant order number
sign	No	Yes	string	64	Signature Check on the sign

Response Parameters

Parameter	Type	Length	Description
refundType	string	64	Refund type (see Refund Type Parameters below)
merchantOrderNo	string	64	Merchant order number
paymentOrderNo	string	64	ACH payment order number
orderStatus	string	16	Refund order status: `INIT`, `PENDING`, `SUCCESS`, `FAILED`
tokenAmount	string	16	Token amount
faitAmount	string	16	Fiat amount
fiatCurrency	string	16	Fiat currency
refundNetwork	string	32	Refund network (e.g., `TRX`)
refundToken	string	32	Refund token (e.g., `USDT`)
hxAddress	string	256	Hash address of the refund order
refundOrderNo	string	64	ACH refund order number

Refund Type Parameters

Value	Refund Type	Description
`USER_WITHDRAW`	USER_WITHDRAW	User-initiated withdrawal
`MERCHANT_APPROVE_REFUND`	MERCHANT_APPROVE_REFUND	Merchant-initiated refund

Response Example

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