curl --request POST \
--url https://whitebit.com/api/v4/main-account/refund-deposit \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: <api-key>' \
--header 'X-TXC-PAYLOAD: <api-key>' \
--header 'X-TXC-SIGNATURE: <api-key>' \
--data '
{
"transactionId": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"request": "{{request}}",
"nonce": 1594297865000
}
'import requests
url = "https://whitebit.com/api/v4/main-account/refund-deposit"
payload = {
"transactionId": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"request": "{{request}}",
"nonce": 1594297865000
}
headers = {
"X-TXC-APIKEY": "<api-key>",
"X-TXC-PAYLOAD": "<api-key>",
"X-TXC-SIGNATURE": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-TXC-APIKEY': '<api-key>',
'X-TXC-PAYLOAD': '<api-key>',
'X-TXC-SIGNATURE': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
transactionId: '54bffeb7-7a8f-43f8-bcd8-f14ec10fee85',
address: '0x1234567890abcdef1234567890abcdef12345678',
request: '{{request}}',
nonce: 1594297865000
})
};
fetch('https://whitebit.com/api/v4/main-account/refund-deposit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://whitebit.com/api/v4/main-account/refund-deposit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transactionId' => '54bffeb7-7a8f-43f8-bcd8-f14ec10fee85',
'address' => '0x1234567890abcdef1234567890abcdef12345678',
'request' => '{{request}}',
'nonce' => 1594297865000
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <api-key>",
"X-TXC-PAYLOAD: <api-key>",
"X-TXC-SIGNATURE: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://whitebit.com/api/v4/main-account/refund-deposit"
payload := strings.NewReader("{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<api-key>")
req.Header.Add("X-TXC-PAYLOAD", "<api-key>")
req.Header.Add("X-TXC-SIGNATURE", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://whitebit.com/api/v4/main-account/refund-deposit")
.header("X-TXC-APIKEY", "<api-key>")
.header("X-TXC-PAYLOAD", "<api-key>")
.header("X-TXC-SIGNATURE", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/main-account/refund-deposit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-TXC-APIKEY"] = '<api-key>'
request["X-TXC-PAYLOAD"] = '<api-key>'
request["X-TXC-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}"
response = http.request(request)
puts response.read_bodyRefund deposit
Refund a crypto deposit to an external address.
Only a deposit in status 9 can be refunded, and only when the deposit was frozen before it was canceled: held for an AML review (status 21) or under the Travel Rule (status 27 or 28). A refund becomes available in this order: the deposit is frozen, WhiteBIT rejects the deposit after review and support allows a refund, and the deposit moves to status 9. Until support allows a refund, the endpoint returns 400 for the deposit, even when the request is valid. When support handles the refund itself, the endpoint keeps returning 400 for that deposit.
A deposit in status 4, a deposit in status 9 that was never frozen, and a fiat deposit cannot be refunded through this endpoint.
Obtain transactionId from the deposit/withdraw history in the WhiteBIT interface. A deposit in status 9 sends no webhook.
The refund address must support the same network and asset as the original deposit. The refund address must not be a WhiteBIT deposit address. The refund address can differ from the original deposit sender address.
The request needs no email code or 2FA confirmation. A 200 response means the refund request is accepted, not that the refund is sent: every refund passes AML screening and an operator review, and WhiteBIT sends the refund on-chain only after approval. Until then, Get refund history shows the refund as in_process with refundHash null. When the review rejects the refund, the refund history shows canceled, the refund.failed webhook is sent, and no funds are sent.
Rate limit: 1000 requests/10 sec.
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, or check the current status with Get refund history. Refund webhooks go only to the webhook of the account that owns the deposit.
curl --request POST \
--url https://whitebit.com/api/v4/main-account/refund-deposit \
--header 'Content-Type: application/json' \
--header 'X-TXC-APIKEY: <api-key>' \
--header 'X-TXC-PAYLOAD: <api-key>' \
--header 'X-TXC-SIGNATURE: <api-key>' \
--data '
{
"transactionId": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"request": "{{request}}",
"nonce": 1594297865000
}
'import requests
url = "https://whitebit.com/api/v4/main-account/refund-deposit"
payload = {
"transactionId": "54bffeb7-7a8f-43f8-bcd8-f14ec10fee85",
"address": "0x1234567890abcdef1234567890abcdef12345678",
"request": "{{request}}",
"nonce": 1594297865000
}
headers = {
"X-TXC-APIKEY": "<api-key>",
"X-TXC-PAYLOAD": "<api-key>",
"X-TXC-SIGNATURE": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-TXC-APIKEY': '<api-key>',
'X-TXC-PAYLOAD': '<api-key>',
'X-TXC-SIGNATURE': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
transactionId: '54bffeb7-7a8f-43f8-bcd8-f14ec10fee85',
address: '0x1234567890abcdef1234567890abcdef12345678',
request: '{{request}}',
nonce: 1594297865000
})
};
fetch('https://whitebit.com/api/v4/main-account/refund-deposit', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://whitebit.com/api/v4/main-account/refund-deposit",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'transactionId' => '54bffeb7-7a8f-43f8-bcd8-f14ec10fee85',
'address' => '0x1234567890abcdef1234567890abcdef12345678',
'request' => '{{request}}',
'nonce' => 1594297865000
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-TXC-APIKEY: <api-key>",
"X-TXC-PAYLOAD: <api-key>",
"X-TXC-SIGNATURE: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://whitebit.com/api/v4/main-account/refund-deposit"
payload := strings.NewReader("{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-TXC-APIKEY", "<api-key>")
req.Header.Add("X-TXC-PAYLOAD", "<api-key>")
req.Header.Add("X-TXC-SIGNATURE", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://whitebit.com/api/v4/main-account/refund-deposit")
.header("X-TXC-APIKEY", "<api-key>")
.header("X-TXC-PAYLOAD", "<api-key>")
.header("X-TXC-SIGNATURE", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://whitebit.com/api/v4/main-account/refund-deposit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-TXC-APIKEY"] = '<api-key>'
request["X-TXC-PAYLOAD"] = '<api-key>'
request["X-TXC-SIGNATURE"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"transactionId\": \"54bffeb7-7a8f-43f8-bcd8-f14ec10fee85\",\n \"address\": \"0x1234567890abcdef1234567890abcdef12345678\",\n \"request\": \"{{request}}\",\n \"nonce\": 1594297865000\n}"
response = http.request(request)
puts response.read_bodyUsed in these guides
- On/Off-Ramp integration — corporate fiat ↔ crypto over EUR/SEPA rails.
- Payment Integration — crypto deposits, withdrawals, conversion, WhiteBIT Codes, and Express Withdraw.
- Crypto-as-a-Service integration — refunding a canceled end-user deposit.
Authorizations
Body
Request path. See the authentication guide for signature generation details.
"{{request}}"
Destination memo for the refund address. Optional — without it, the refund goes to the address with no memo.
For a currency that uses memos, the system validates the value; an invalid memo fails the request with a validation error. For other currencies, the value is not validated. It is stored on the refund and returned in the refund history and in the refund webhooks.
255"1234567890"
Response
System accepts refund request
Transaction UUID of the deposit, echoed from the request. This is not a refund identifier — the refund's own refundId is returned by Get refund history.
Was this page helpful?