Deposit
A crypto deposit is similar to a bank transfer. Funds can be sent if the recipient's bank account number is known, and in the case of a cryptocurrency deposit, this is the crypto wallet address. Unlike the classic approach, the client's system must track the deposit processing status in the following possible ways:
- Process callbacks from Crypto2B with deposit information (see Callbacks).
- Retrieve deposit information by calling the API
/deposits/listand/deposits/{id}.
Deposit process
Sequence of actions
- In the client's system, the user wants to top up their account or pay for some service.
- The user uses the "deposit" function in the client's system and selects BTC as the payment method.
- The client's system sends a request to Crypto2B to get a deposit address and shows the user the BTC deposit address.
- The user copies the address and goes to their crypto wallet application.
- The user sends BTC to this address.
- Crypto2B tracks this transaction on the blockchain.
- If the client's system uses the callback mechanism, Crypto2B sends a callback to the client's system with deposit information, including transaction status, amount, fee, etc.
- Otherwise, the client's system retrieves deposit information, including transaction status, amount, fee, etc., via an API call.
- If the deposit is successfully completed on the blockchain, Crypto2B performs deposit checks and, if the checks pass, increases the client's BTC balance by the deposit amount minus the fee.
- If the deposit status in the callback is successful, the client's system adds the amount from the callback to the user's BTC balance.
Important notes
When displaying the deposit address to the user, it is important to notify them about:
- deposit limits
- the selected cryptocurrency
All deposits sent to incorrect addresses will be lost.
Information about deposit and withdrawal limits can be obtained:
- in the response to the API call
/instruments/list - in the personal account under the "Instruments" section
Sometimes users make mistakes and send funds using a specific cryptocurrency to an address from another blockchain. These funds will be lost.
Additional parameters (Memo)
Some cryptocurrencies use a shared address for multiple recipients and require an additional "Memo" parameter (or similar) to identify the specific recipient. For example, XRP uses Memo (Destination Tag) to distinguish deposits of different users to the same address.
If this is required for a specific currency, Crypto2B sends the tag parameter in the response to the API call /channels/take. If the client's system receives this parameter, it must show its value to the user.
If the tag is not specified when making a deposit, the client's system will have to determine on its own to which user's balance the deposit amount should be added.
Deposit check in Crypto2B
Crypto2B performs the following deposit transaction check before crediting funds to the client's balance:
The risk level of the deposit transaction is checked for compliance with the risk level acceptable for the client.
If the check is not passed, processing is suspended. The client can then contact technical support to continue processing or cancel it.
User actions in the interface
- The user in the client's system initiates an account top-up and selects a cryptocurrency
- The user copies the top-up address
- The user goes to the application (crypto wallet, exchange) where they have a balance of the selected cryptocurrency and makes a withdrawal to the address received in the client's system to top up their balance