Create a refund order
POST/api/v1/order/refund
Create a refund for an incoming, completed payment or deposit order. This endpoint allows you to return part or all of the funds received from a payment or deposit order to the payer. Refunds can only be processed if there are sufficient funds in the wallet balance, including fees.
Refunds cannot exceed the total amount received for the order. For example, if the original order was 10, and a refund of 5 has already been issued, the maximum you can refund in a second transaction is 5.
Request
- application/json
Body
Details of the refund order to create.
The amount to refund to the payer. It should be a positive decimal number, specified with up to 6 decimal places.
Possible values: [TRX
, USDT_TRC20
]
The asset used for the refund. Ensure that the asset matches the one used in the original payment order.
The wallet address where the refund will be sent. It should be a valid blockchain address for the specified asset.
Possible values: Value must match regular expression [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
The unique identifier of the original order that is being refunded. This ID helps link the refund to the correct order.
Responses
- 200
Refund order created successfully.
- application/json
- Schema
- Example (from schema)
Schema
The unique identifier of the created refund or withdrawal order. Use this ID to track the order's status .
{
"orderId": "123e4567-e89b-12d3-a456-426614174000"
}