Refund callback notification

Webhook 

When the refund order status changes to success or failure or rejected, the merchant will receive a refund callback notification, and the merchant needs to update the local order status based on the callback notification.

info

Merchant can set the callback address when initiating a refund application. When the refund result is confirmed, the system will send a successful refund notification to this URL.

The callback will be sent up to 6 times, respectively at 0 seconds, 15 seconds, 30 seconds, 3 minutes, 5 minutes, and 10 minutes after the recharge is confirmed.

When the merchant returns success normally, the system will consider the callback successful and will not send subsequent callbacks.

Note: The merchant needs to verify the signature of the callback notification to ensure the security of the notification. The signing method of the callback is consistent with the normal request.

Request

application/json

Body

required

chainId int32required

Chain ID

This is the platform internal ID, not the chain ID on the chain or from the wallet, can be obtained from Get Chain List interface

currencyId int32required

Currency ID

Can be obtained from Get Currency List interface

refundId int32required

Refund order ID

outTradeNo stringrequired

Merchant order number

outPaymentNo stringrequired

Payment order number

refundAddress stringrequired

Refund address

refundAmount stringnullablerequired

Refund amount

Note: The value of this field is an integer, calculated by (actual_amount * 10^currency_decimals)

refundFee stringnullable

Commission fee

refundStatus int32required
Possible values: [0, 1, 2, 3, 4, 5]
Refund order status
• 0 - Success
• 1 - Pending approval
• 2 - Under review
• 3 - Block confirmation
• 4 - Failure
• 5 - Rejected
refundTime date-timerequired

Refund time

transferHash stringnullable

Transaction hash

Responses

200

OK

plain/text

Schema

Schema

string

Possible values: [success]

Example

success

Loading...