Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cryptoprocessing.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Your customers withdraw with conversion

For example, if you have EUR on your balance, your customers can still withdraw in BTC. CryptoProcessing will automatically withdraw the EUR equivalent of their transaction from your balance, convert it to BTC and send it to their address.

Your customers withdraw without conversion

Your customers can only withdraw in the currency you chose. For example, if you have BTC on your balance, your customers will only be able to withdraw in BTC.

Set up withdrawals

1

Complete your onboarding

Complete your onboarding in your merchant dashboard and generate 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.
    POST /api/v2/withdrawal/crypto HTTP/1.1
    Host: app.cryptoprocessing.com
    X-Processing-Key: <api-key>
    X-Processing-Signature: <signature>
    Content-Type: application/json
    Accept: */*
    Content-Length: 161
      
    {
      "amount": "25",
      "currency": "EUR",
      "convert_to": "BTC",
      "address": "tb1qjv8alc7c708tddm9nrdtpwm5xna30fgkql5vgs",
      "foreign_id": "user_12345",
      "end_user_reference": "user_12345"
    }
    
    {
      "data": {
        "id": 132512382,
        "foreign_id": "user_12345",
        "end_user_reference": "user_12345",
        "type": "withdrawal_exchange",
        "status": "processing",
        "amount": "25.00000000",
        "sender_amount": "25.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 May 5, 2026