Underpayments

Underpayments occur when end users do not transfer enough cryptocurrency to fulfil their payment obligation.

This can occur if the end user is charged a network fee by their exchange platform that exceeds the amount they anticipated from their payment. Furthermore, the end user might unintentionally send less than intended (e.g. they mean to send 0.1 ETH but send 0.01 ETH instead). In this situation, the payment will still transition to the UNDERPAID status.

To give greater flexibility to your end users on how much they send crypto top-ups is recommended.

How can I see the actual amount received?

To see the actual received amount, on the transactionConfirmed webhook, compare the fields:

• paidCurrency.actual indicates the amount you actually received.
• paidCurrency.amount indicates the original expected amount.

Handle underpayments

To ensure the best customer experience when managing underpayments, it's advisable to adjust the end user's final payment to reflect the lower total amount received. This approach prevents the need to return the entire sum of crypto, which may be slightly less than expected due to fees or rounding errors, and instead, credits the revised amount to the end user's account.

The sent amount is indicated in the .actual fields referenced in the preceding section, which can then be utilised to modify the end user's total payment amount in your system, aligning with the .amount field.

There is the Settle Merchant Wallet setting, where the total sent amount will be deposited into the MID wallet that was linked to the transaction.

In certain circumstances, when it is essential that the full amount is received, and an underpayment does not fulfil this need, two alternative options can be used:

• Handle manually will retain the payment in its originally sent cryptocurrency and deposit it into an equivalent cryptocurrency wallet on your account. No funds are sent to the MID-linked wallet. You can then use the payout functionality to manually return the excess amount to the end user if required, or manually convert to the MID-linked wallet at a new FX spot rate.
• Auto Refund will generate an automatic payout request for the full underpaid amount, keeping it separate from any account wallets and generating a URL. This URL must be sent to the end user for final confirmation of the address where the returned funds should be sent.

Overpayment exception flows

The summary of the flow for three different outcomes is given below:

📘

To change your configuration or learn more, contact your Account or Integration Manager.