Invoices may occasionally enter intermediate statuses. Proper handling based on the invoice status is essential to ensure accurate accounting and smooth processing of funds.
Suppose your customer needs to pay 100 EUR in BTC:
Your server sends an API request to our server to generate an invoice.
We exchange 100 EUR to the BTC at the current rate and lock this rate for 10 minutes.
The customer transfers the funds to the BTC address associated with the invoice.
In some cases, the transaction may result in an Unresolved invoice status with one of the following contexts:
Underpaid – the customer paid less than required.
Overpaid – the customer paid more than required.
Paid late – the payment was made after the 10-minute rate validity.
Illicit resource – the transaction has been flagged as high-risk, so the payment is put on hold. More information about transaction risk scoring is available here. If such a case occurs, please contact our B2B Support team at b2bsupport@cryptopay.me – they will be happy to assist you further.
Managing Unresolved Invoices
You can manage unresolved invoices manually depending on the invoice status, as outlined below.
1. For Underpaid and Paid Late invoices, the following actions are available:
Recalculation – the invoice amount can be recalculated based on the received funds. The invoice will change its status to Completed. Please refer to the Invoice recalculation section to do it via API.
Refund – the incoming transaction can be refunded either to the merchant’s cryptocurrency account or to an external wallet address. After the selected action is completed, the invoice status will change to Completed or Refunded, depending on the invoice context.
Please refer to the Invoice refunds sections for instructions on how to perform these actions via the API.
2. Overpaid Invoices
For Overpaid invoices, only a refund of the overpaid amount (overage) is supported.
Recalculation is not available.
A refund of the full invoice amount is not supported.
You can also configure how your invoices are handled automatically on the Integration → API page in your account.
Here is an action-outcome chart:
There is also an option of automatic invoice refunds, which 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 provides further details.
If you have any questions, please feel free to contact us in the live chat or via email at b2bsupport@cryptopay.me