Receive crypto deposits
You can receive crypto deposits from your customers with and without exchange.
At your request, Cryptoprocessing generates a crypto address that you can share with your customers. Once a customer makes a deposit, Cryptoprocessing sends you a callback to notify you. You can then top up the customer's balance on your site with the same amount.
Generate a crypto address
The most common scenario is to automatically generate a crypto address for every new customer. To do that, you can use /v2/addresses/take API endpoint. You need to include the customer's permanent identifier, end_user_reference, as well as foreign_id, which can be any data about the user or the transaction you need to process the deposit on your side. For more details, see Deposit addresses.
To boost conversion rates from cryptocurrency payments, design a user-friendly payment form. For tips on how to improve the form, see Create a crypto payment form. For XRP, you also need to display the customer's personal tag alongside their address. XRP deposits sent without a tag may be lost.
You can create multiple addresses for the same customer.
Warning: If the customer makes the deposit in the wrong cryptocurrency (for example, they send ETH or USDC ERC-20 to a SOL address), the deposit may be lost. When sharing an address with your customers, always display the currency's name and network next to it.
Receive deposits with exchange
For deposits with exchange, all received deposits will be automatically converted to the currency you specified. For example, a customer can top up their EUR balance on your site with BTC, which will be automatically converted to EUR by Cryptoprocessing.
To specify which currency you want the deposit to be converted to, include the convert_to parameter when making a request to /v2/addresses/take.
Once your customer makes a deposit, you will receive a callback with all the relevant data, including the amount of the deposit and the amount of fees charged by Cryptoprocessing. For more details, see Get callbacks.
Tip: For USDC and USDG tokens, the exchange rate is always 1:1. For example, 1 USDC on ERC-20 is always equivalent to 1 USDC on SOL.
Receive deposits without exchange
For deposits without exchange, you will receive the currency the customer deposited.
Once your customer makes a deposit, you will receive a callback with all the relevant data, including the amount of the deposit and the amount of fees charged by Cryptoprocessing. For more details, see Get callbacks.
Handle deposits sent in the wrong currency, on the wrong network or without a tag
Some deposits may not show on your balance automatically or might be lost. Most common cases include:
Deposits sent in the wrong currency on the same network.
Deposits sent in an unsupported currencies on the same network.
XRP and CSC deposits sent without a tag or with the wrong tag.
Deposits sent on the wrong network.
For the list of supported currencies and the networks they are on, see Supported currencies.
If the address is meant for deposits with exchange, deposits in the wrong currency will not be exchanged. For example, if you created an ETH address with conversion to EUR, a USDC ERC-20 deposit sent to this address will not be automatically converted to any currency. You will receive the currency that you or your customer deposited, without conversion.
Deposits within the same network
If you received a deposit in the wrong currency on the same network that is supported by Cryptoprocessing, it will still appear on your balance, but you will not receive a callback. For example, if you generate an Ethereum address for ETH and your customer sends to it, you will still see the USDC deposit on your balance, but Cryptoprocessing will not notify you with a callback. You can manually convert the customer's deposit to your currency of choice (see Make exchanges) and credit their balance on your site.
To see transactions that were sent in the wrong currency, go to Transactions in your merchant dashboard. Click Filters to expand the filter section and select Only cross-currency from the Cross-currency dropdown list. To find a specific transaction, enter its TXID (the transaction's hash on the blockchain). All cross-currency transactions will have Cross currency deposit in the Note field.
Deposits in unsupported currencies
You will not see deposits in unsupported currencies in your merchant dashboard. For example, this applies to all unsupported ERC-20 tokens sent to your Ethereum address, unsupported SPL tokens sent to your Solana address and other similar cases. The deposits will be credited to the address on the blockchain, but you will not see them on your balance in your Cryptoprocessing merchant dashboard.
To see if your deposit can be recovered, contact our support team at [email protected] or using the widget in your merchant dashboard.
XRP or CSC deposits sent without a tag or with the wrong tag
XRP or CSC deposits sent without a tag or with the wrong tag will not be credited to you automatically. To see if your XRP or CSC deposit can be recovered, contact our support team at [email protected] or using the widget in your merchant dashboard.
Deposits across different networks
If your customer sent a deposit on the wrong network (for example, BTC to an Ethereum address), you will not be able to access it.
To prevent this in future, always clearly specify the currency name and network when you share the address with your customers. You should also notify customers that deposits sent to the wrong address cannot be recovered, so they should always double-check the currency and the network before they send a transaction.
To see if your deposti can be recovered, contact our support team at [email protected] or using the widget in your merchant dashboard.
Delete an address
Once a crypto address is created, it cannot be deleted and remains on the blockchain forever. If you want to generate a new address for a customer, notify them about the change and ask them to stop making deposits to the old address.
Last updated
Was this helpful?