Skip to main content
If your customers have a balance on your site, you can provide withdrawals in crypto.

Set up withdrawals

1

Complete your onboarding

Complete your onboarding in your merchant dashboard and generate an API key. For more details on how to create an API key, see Get your API key.
2

Design a withdrawal form

Add a withdrawal form to your site. For our recommendations on how to design the form, see Design a withdrawal form.
3

Request a withdrawal

Send a request to /api/v2/withdrawal/crypto. To request a withdrawal with exchange, include the convert_to parameter.You will also need to include these required parameters:
  • foreign_id is the unique ID of the withdrawal request. You can use any format you prefer.
  • end_user_reference is the customer’s unique ID. CryptoProcessing uses it to group withdrawal requests made by each customer. It must not contain any identifying information, such as the customer’s name.
Request example
{
  "amount": "100",
  "currency": "EUR",
  "convert_to": "BTC", ,
  "address": "tb1qfdxh6gkfr0qgyatnlkd8khcnxph9tw06n6qwjc",
  "foreign_id": "withdrawal_123",
  "end_user_reference": "user_12345",
  "sender_type": "legal",
  "sender_data": {
    "legal_name": "Example GmbH",
    "country_of_registration": "DEU"
  },
  "receiver_type": "natural",
  "receiver_data": {
    "first_name": "Friedrich",
    "last_name": "Müller",
    "date_of_birth": "1995-08-17"
  }
}
Response example
{
  "data": {
    "id": 134702831,
    "foreign_id": "withdrawal_123",
    "end_user_reference": "user_12345",
    "type": "withdrawal_exchange",
    "status": "processing",
    "amount": "100.00000000",
    "sender_amount": "100.00000000",
    "sender_currency": "EUR",
    "receiver_currency": "BTC"
  }
}
4

Process the callback

Once the withdrawal is processed, CryptoProcessing will send you a callback.
Last modified on June 14, 2026