Refund deposit
Refund a deposit.
The system processes refunds only for deposits with status canceled.
Obtain transactionId from the deposit.canceled webhook (uniqueId) or from the deposit/withdraw history in the WhiteBIT interface after support confirms refund availability.
The refund address must support the same network and asset as the original deposit. The refund address must not be a WhiteBIT address. The refund address can differ from the original deposit sender address.
Errors
Errors
{
"code": 0,
"message": "Transaction not refundable"
}
{
"code": 0,
"message": "Validation failed",
"errors": {
"transactionId": ["The transaction id field is required."],
"address": ["The address field is required."]
}
}
The API does not cache the response.
Refund processing does not complete instantly. Use the refund.successful and refund.failed webhooks to receive refund status updates.
Authorizations
API key authentication using signed requests
Body
Transaction UUID of the deposit. Obtain from the deposit.canceled webhook (uniqueId field) or from the deposit/withdraw history in the WhiteBIT interface.
"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85"
Destination wallet address for the refund. The address must support the same network and asset as the original deposit. Cannot be a WhiteBIT address. Does not have to match the original deposit address.
"0x1234567890abcdef1234567890abcdef12345678"
Base64-encoded request body. See the authentication guide for signature generation details.
"{{request}}"
A unique identifier for the request. Use a monotonically increasing value such as a Unix timestamp in milliseconds.
"{{nonce}}"
Response
System accepts refund request
Transaction ID of the deposit (echoed from request)