How to handle exceptions
In some cases, invoices may be paid incorrectly or paid after the invoice has expired.
To manage invoices automatically, enable the option in Settings → API in your account.
Here is an outcome chart.
Action | Status | Status context | Outcome | Final status |
Automatically recalculate the invoice at the new exchange rate and settle | unresolved | underpaid overpaid paid_late | The received transaction amount will be recalculated at the new exchange rate and a new invoice amount will be settled | completed |
Automatically refund to a cryptocurrency account | unresolved | underpaid | The full transaction amount will be added to your cryptocurrency account balance | refunded |
| | overpaid | The original invoice amount will be settled. The overage will be added to your cryptocurrency account balance | completed |
| | paid_late | The full transaction amount will be added to your cryptocurrency account balance | refunded |
Do nothing, I will handle them myself | unresolved | underpaid overpaid paid_late | You will need to resolve them manually | |
You can also manage unresolved payments manually as follows:
1. Recalculate – the transaction will be recalculated using the current exchange rate and the invoice will change its status to completed. Refer to the Invoice recalculation section for more information on how to do it via API.
2. Refund – the incoming transaction will be refunded to the merchant’s cryptocurrency account or to external wallet address. The invoice will change its status to completed or refunded depending on the invoice status_context. Please refer to the Invoice refunds section to do it via API.
