How to handle unresolved invoices
Konstantin avatar
Written by Konstantin
Updated over a week ago

In some cases, the invoice may be paid by the customer with the wrong transaction amount or after the invoice validity period has expired.

Simplicity is the shortest path to a solution. We are thriving to introduce you to our guide on handling unresolved invoices within a few clicks.

As an example, let's imagine your customer has to pay 100 EUR in BTC. It goes like this:

  1. Your server sends an API request to our server so we can generate an invoice.

  2. We exchange 100 EUR to the BTC under the current rate and freeze this rate for 10 minutes.

  3. Your customer transfers funds to the BTC address of this invoice.

There are cases when the transaction gets an Unresolved invoice status with one of the following contexts:

  1. Underpaid – the user has paid less than needed

  2. Overpaid – the user has paid more than needed

  3. Paid late – the user has paid after 10 minutes

  4. Illicit resource – the received cryptocurrency transaction has been evaluated as High-Risk, therefore the payment has been put on hold. more info about transaction risk scoring can be found here. If you come across such a case, please get in touch with our B2B support team at – they'll be sure to help you further.

You can configure how to handle your invoices automatically in the IntegrationAPI page in your account:

Here is an action-outcome chart:

Moreover, if you choose to refund automatically, you can enable refund via email option.

You can also manage this manually as described below:

1. Recalculate – the incoming transaction will be recalculated by the current rate. The invoice will change its status to Completed. Refer to the Invoice recalculation section to do it via API.

2. Refund – the incoming transaction will be refunded to the merchant’s cryptocurrency account or to an external wallet address. The invoice will change its status to Completed or Refunded depending on the invoice status context. Refer to the Invoice refunds section to do it via API.

You can also enable automatic invoice refunds. It allows your clients to automate the invoice refund process. By activating this function, you don't need to make a request to have a refund – it'll be done automatically. This guide could help.

If you have any questions, please feel free to contact us in the live chat or via email at

Did this answer your question?