Refund Order

Refunding an order

The refund request initiated will be processed immediately, and the refund amount will be credited back to the customer's wallet immediately in the settlement amount you received. i.e. Your settlement cryptocurrency is USDT, the refund will be in USDT.

Partial Refund

You can issue either a full refund or a partial refund to your customer. For partial refunds, you will be able to issue additional partial refunds until you have reached the total original order amount.

Refund via MMP

In the Merchant Management Platform, you can easily manage and refund your order.

Under the Transaction Tab, merchants can view all the transaction details, and perform the refund directly from the portal.

You can input the amount, reason and description for the refund.

Upon confirmation of the Refund Request, the refund will be instantly reflected back in the customer’s wallet.

Refund via API

You can use the “Refund Order” API to initiate the refund.

End Point

POST   /binancepay/openapi/order/refund

Request Example

For full API specification, please go to

API Request Reference

.

You need to assign a Refund Request ID for a refund request. (Max. length 64)

{  "prepayId": "383729303729303",  "refundRequestId": "68711039982968832",  "refundAmount": 25.17,  "refundReason": ""}

Response Example

For full API specification, please go to

API Request Reference

.

{  "status": "SUCCESS",  "code": "000000",  "data": {    "refundRequestId": "68711039982968832",    "prepayId": "383729303729303",    "orderAmount": "100.11",    "refundedAmount": "50.88",    "refundAmount": "25.17",    "remainingAttempts": 8,    "payerOpenId": "dde730c2e0ea1f1780cf26343b98fd3b",    "duplicateRequest": "N",      },  "errorMessage": ""}

Query Refund Orders via API

You can use the “Query Refund Order” API to initiate refunds for transactions.

End Point

POST   /binancepay/openapi/order/refund/query

Request Example

For full API specification, please go to

API Request Reference

.

You need to assign a Refund Request ID to search for a specific refund transaction.

{  "refundRequestId": "68711039982968832"}

Response Example

For full API specification, please go to

API Request Reference

.

{  "status": "SUCCESS",  "code": "000000",  "data": {    "refundRequestId": "68711039982968832",    "prepayId": "383729303729303",    "orderAmount": "100.11",    "refundedAmount": "50.88",    "refundAmount": "25.17",    "remainingAttempts": 8,    "payerOpenId": "dde730c2e0ea1f1780cf26343b98fd3b",    "duplicateRequest": "N",      },  "errorMessage": ""}

Refund a Order

You can monitor the refund status using the parameter “refundStatus”.

Status	Description
REFUND_SUCCESS	The transaction has been refunded.
REFUND_FAIL	The transaction cannot be refunded.
REFUND_PENDING	The transaction is pending for refund.

Status

REFUND_SUCCESS

Description

The transaction has been refunded.

Status

REFUND_FAIL

Description

The transaction cannot be refunded.

Status

REFUND_PENDING

Description

The transaction is pending for refund.