Withdrawal

Withdraw crypto

post

Withdraw in crypto to any address. You can send cryptocurrency from your Fiat currency balance by using the convert_to parameter.

The end_user_reference parameter is used to group, track and analyse transactions associated with a specific customer. To prevent transactions from getting delayed or cancelled, always make sure to include the correct ID. The ID must not contain any personal or identifying customer data.

Note: Cryptoprocessing is required to collect sender data in compliance with the MiCA regulations. For more details, see About user data collection. The sender_data and the end_user_reference you provide must be associated with the same customer.

Authorizations

xProcessingKey & xProcessingSignature

X-processing-keystringRequired

Your API key.

X-processing-signaturestringRequired

The request body, signed with HMAC-SHA512 with your secret key. You can find the secret key in your account.

Body

application/json

currencystringRequired

The ISO code of the currency you want to withdraw. For a list of all available currencies, see Supported currencies.

convert_tostringOptional

If you want to automatically convert all deposits to a certain currency, specify it here. For a list of all available currencies, see Supported currencies.

addressstringRequired

Cryptocurrency address where you want to send funds.

tagstringOptional

If you are withdrawing XRP, a tag/memo is required. If you withdraw XRP without including a tag/memo, the funds may be lost.

amountnumberRequired

Amount to withdraw.

amount_tonumberOptional

If you want to send a specific amount in the target currency (convert_to), use this parameter. You can only specify either amount_to or amount.

foreign_idstringRequired

Unique ID of the withdrawal request.

end_user_referencestring · max: 255Required

Permanent ID of the customer in your system. Must not contain personal data, such as the user's name or email address. Include this customer's data in the sender_data object.

sender_typestring · enumRequired

Whether the sender is a natural person (natural) or a legal entity (legal).

Possible values:

receiver_typestring · enumRequired

Whether the recipient is a natural person (natural) or a legal entity (legal). For internal transfers, set this to self.

Possible values:

Responses

200

OK

application/jsonapplication/xml

400

The foreign id has already been taken

application/json

403

Bad key header

application/json

post

/withdrawal/crypto

Crypto withdrawal without conversionCrypto withdrawal with conversionCrypto withdrawal with conversion and a specified target amount

POST /api/v2/withdrawal/crypto HTTP/1.1
Host: app.cryptoprocessing.com
X-Processing-Key: text
X-Processing-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 161

{
  "currency": "BTC",
  "address": "2N2xtaZCNygY3iq6XKPJsdoPMDX85LUc8SM",
  "tag": null,
  "amount": 0.001,
  "foreign_id": "user_2317",
  "end_user_reference": "2318",
  "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"
  }
}

{
  "data": {
    "id": 678388,
    "foreign_id": "user_2317",
    "type": "withdrawal_exchange",
    "end_user_reference": "2318",
    "status": "processing",
    "amount": "25.00000000",
    "sender_amount": "25.00000000",
    "sender_currency": "EUR",
    "receiver_currency": "BTC"
  }
}