Types of deposit addresses
AlphaPo processes crypto deposits in different ways, based on the way the deposit address was created.System deposit addresses — created for your customers via the API
System deposit addresses — created for your customers via the API
System deposit addresses are created and intended to be used as part of an automated integration with your site. Typically, your site may generate and show an address to each customer, so that they top up their balance on your site.To create such an address, use the API endpoint. Enable automatic conversion if necessary. Each incoming transaction to the address will trigger an API callback.In the merchant dashboard, these addresses can be found at Addresses → System Addresses.
Customer deposit addresses — created for your customers via the dashboard
Customer deposit addresses — created for your customers via the dashboard
Customer deposit addresses are created and managed by you in Addresses → My Addresses. You manually provide such address to your customer, so that they top up their balance on your site. Each address can have a name for easier search, e.g., “Deposits from John Doe”.To create such an address, go to the Addresses → My Addresses tab and click Create address. Alternatively, select a cryptocurrency on the Balances tab, click Receive, then click Create new address. Enable automatic conversion if necessary.AlphaPo does not send API callbacks for the transactions to customer deposit addresses.
Merchant top-up addresses — created automatically for your team
Merchant top-up addresses — created automatically for your team
Merchant top-up addresses are generated automatically when you enable a new cryptocurrency in your merchant dashboard. You can use these addresses to top up your balance.These addresses can be found at Addresses → My Addresses under the names “BTC deposit address”, “ETH deposit address”, etc. Alternatively, select a cryptocurrency on the Balances tab, click Receive and see the default address.Transactions to these addresses may have different fees than to the other addresses. These addresses are intended for usage by the merchant team only. You must not share the merchant top-up addresses with your customers.AlphaPo does not send API callbacks for the transactions to merchant top-up addresses.
Deposits with conversion
When creating a deposit address in one currency, you can enable automatic conversion of all incoming funds. If enabled, the amount of each deposit to this address will be instantly converted to the specified target currency. Enabling conversion is possible for system addresses and customer deposit addresses (see Types of deposit addresses). The target currency can be crypto or fiat. Each conversion is made using the current currency rates at the time of processing the transaction.Reusing addresses
In cryptocurrencies, an address cannot be “deleted” or “closed”: once you created it, your customer can send funds to the address at any time. AlphaPo constantly monitors the blockchain for new transactions to all deposit addresses ever created. It is good practice to have only one deposit address for one currency per user. This way, the customer can save the address in their wallet app’s address book to create new transactions in a more convenient way. However, you can create more than one deposit address per customer. This is useful if you need to use different conversion configurations or if your customer has two different balances on your site.Off-chain deposits
If the funds come from an address that happens to be controlled by AlphaPo, too, the transaction is being processed off-chain. This means that AlphaPo registers the transaction internally, even though it was never sent to the blockchain. Just like a standard deposit, an off-chain deposit can be found on the Transactions tab. However, an off-chain deposit has an internal TXID instead of a public one. You can use this TXID to find the transaction in the merchant dashboard, but not in a blockchain explorer. In the API callback, an off-chain deposit has thetransaction.transaction_type property set to "internal" instead of "blockchain".
The fee for an off-chain deposit may differ from the standard one.
Further reading
Integration guide for deposits
Learn how to integrate the deposit flow into your site
Test cases for deposits
Walk through all scenarios to make sure your integration works correctly
/addresses/take
API endpoint
deposit, deposit_exchange
API callbacks