Payment mechanism

To start accepting crypto payments and create a payment address, you need to claim an API key. Once you get an API key, you can create payment addresses or invoices for any available cryptocurrency.

Invoices have a 30-minute limit to complete payment. The created dedicated payment addresses have no limit on the number of payments processed and no limit on the validity period. Therefore, you can link the payment address to a specific internal user or order in your application.

In blockchains with UTXO architecture (Bitcoin, Bitcoin Cash, Litecoin, etc.), the transaction hash and the output number in the transaction are considered a unique payment identifier. For account-based blockchains (Ethereum, Tron), the unique payment identifier is the transaction hash.

For each generated payment address, you can request the current status and statistics, as well as a list of all events for the address. For invoices, you can request details, update the payment method, and remove the order.

To receive notifications of new and confirmed payments to your addresses, you must specify the URL where your payment handler is located when creating a payment address or invoice. We will send notifications to this URL when funds are received.

For security reasons, a request to create a new address must contain a secure token. This must be a unique string and can be stored in the configuration file or database of your application. When you receive a payment notification via webhook, ensure that the data from the Token header matches the local value before processing the incoming transaction or order.

When a new payment is detected or a payment is completed, we will immediately send a payment notification to your server at the specified URL in the callback. You do not need to additionally verify the transaction. We consider the payment completed when the required number of confirmations in the blockchain is reached.

The webhook will be sent twice: when a new payment is detected and when it is completed (i.e., the required number of confirmations has been reached). For invoices, the webhook will be sent only upon completion of payment.

Required number of confirmations

The number of confirmations differs by blockchain network. In the table below, you can see when we consider the payment completed.