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.

Settings → API

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.

Invoice recalculation

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.

Invoice refund