Skip to main content

Withdrawal

Unlike deposits, cryptocurrency withdrawal is similar to classic payment methods. The user fills out a form specifying the address and withdrawal amount. After that, the client system reduces the user's balance and sends a withdrawal request to Crypto2B.

Then the client system must track the withdrawal processing status using the following possible methods:

  1. Process callbacks from Crypto2B with withdrawal information (see Callbacks).
  2. Get withdrawal information via API call /withdrawals/{paymentOrderId}.

Withdrawal Process​

Action Sequence​

  1. The client has a BTC balance in Crypto2B.
  2. The user wants to withdraw funds from their BTC balance in the client system to their BTC wallet.
  3. The user uses the "withdrawal" function in the client system, selects BTC as the withdrawal currency, and fills out the withdrawal form, specifying their BTC address where they want to receive funds and the withdrawal amount.
  4. The client system reduces the user's BTC balance by the withdrawal amount.
  5. After that, the client system makes a request to Crypto2B to withdraw funds.
  6. Crypto2B reduces the client's BTC balance by the withdrawal amount including fees, performs withdrawal checks, sends funds to the user's crypto address on the blockchain, and monitors this transaction on the blockchain.
  7. If the client system uses the callback mechanism, Crypto2B sends a callback to the client system with withdrawal information, including transaction status, amount, fees, and so on.
  8. Otherwise, the client system gets withdrawal information, including transaction status, amount, fees, etc. via API call.
  9. If the withdrawal is unsuccessful, Crypto2B returns the withdrawal amount and fees to the client's BTC balance.
  10. If the withdrawal status received from Crypto2B is unsuccessful, the client system returns the amount from the callback to the user's BTC balance.

Withdrawal Limits​

warning

A withdrawal with an amount less than the minimum withdrawal limit will not be accepted for processing, and the client system will receive an error in response to the withdrawal request.

Information about deposit and withdrawal limits can be obtained:

  • in the response to API call /instruments/list
  • in the personal account in the "Instruments" section

Additional Parameters (Memo)​

Attention

Some cryptocurrencies use a shared address for multiple recipients and require an additional "Memo" parameter (or similar) to identify a specific recipient. For example, XRP uses Memo (Destination Tag) to distinguish deposits from different users to the same address.

If a cryptocurrency requires Memo, the client system must request this value from the user and pass it in the tag parameter when calling the withdrawal API.

Withdrawal Checks in Crypto2B​

Crypto2B performs the following checks on a withdrawal request before sending funds to the user's crypto address on the blockchain:

1. Risk Level Check​

The risk level of the user's crypto address is checked for compliance with the acceptable risk level for the client.

If the check fails for a withdrawal request, processing is suspended. The client can then contact technical support to continue processing or cancel.

User Actions in the Interface​

  1. The user logs into an application (crypto wallet, exchange) where they need to top up their balance of a certain cryptocurrency and receives an address for deposit.
  2. The user goes to the client system where they have a balance of this cryptocurrency, initiates a withdrawal from the account, and selects this cryptocurrency.
  3. The user makes a withdrawal from their balance in the client system to the address previously received for topping up the balance in the third-party application (crypto wallet, exchange).