Comment on page
How to handle unresolved invoices
A payment that is in
unresolvedstatus must be authorised, otherwise the funds will be suspended.
unresolvedstatus may be changed to the other two statuses -
refunded- depending on which option the merchant will select. Both statuses are final and cannot be changed to the other statuses in the future.
The update of the payment status from
completedmeans that the payment has been completed and the funds have been credited to the merchant balance and the merchant can in turn replenish the balance of his customer on his side.
Updating the payment status from
refundedmeans that the entire amount of cryptocurrency received will be credited to the merchant account balance or sent back to the merchant wallet (depending on which option the merchant has chosen) and such payment cannot be considered as successfully completed.
You can update the status of a payment from
refundedin two ways - manually from your account in the Transaction History section or automate this process on the Cryptopay side by selecting the appropriate settings in the Settings > API section.
To update the payment status manually, you will need to go to the Transaction history page in your account and find the payment you need.
To do so, use the search fields and filters available on the Transaction history page.
In the search field at the very top of the page, you can insert the address to which the customer has sent the cryptocurrency, or TXID of the cryptocurrency payment. Our system will perform a database search to find out if we have registered such a payment and will give you the result. Alternatively, you can search the reference number of the payment by inserting it into the
custom_idfield in the table below. Alternatively, you can display a list of all
unresolvedpayments with the context you need by selecting the required filters.
After the right payment has been found, click on it to reveal its details. On the right, in the form of payment details, you will see all the events that have taken place with the payment so far.
At the bottom you will see two buttons - “Recalculate” and “Refund”. Press the button you need to get the result you want.
Important: only one option is available for the Overpaid context in case of manual update of the payment status - Refund. In this case, not the entire cryptocurrency payment will be refunded, but only the extra amount.
The incoming transaction will be recalculated at the new exchange rate. The invoice will change its status to
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
refundeddepending on the invoice status context:
underpaid> Refund >
paid_late> Refund >
overpaid> Refund >
You can also configure how to handle your unresolved invoices automatically on the Settings → API page in your account:
We highly recommend using this automation and selecting the option "Automatically recalculate at a new exchange rate and settle" for all three
unresolvedcontexts. This way, all your payments will be automatically assigned with the
completedstatus, regardless of whether the payment is made late or the wrong amount has been sent to this payment. This can save a lot of time for your Support/Payment/Reconciliation teams and your customers without having to spend on communication and manual updating of the payment status.