Overpayments

Receiving payment amounts greater than expected

Over payments happen when end users send too much cryptocurrency.

They can occur when end users accidentally enter a number too high (e.g. they intend to send 0.01 ETH but send 0.1 ETH instead). In this case, the payment will still transition to a COMPLETE status.

How can I see the amount actually received?

On the transactionConfirmed webhook you can see amount actually received in the paidCurrency.actual field. You can compare this value to the paidCurrency.amount field which shows the expected amount.

Handling overpayments

The recommended way to handle overpayments for the best customer experience is to adjust the final payment of the end user to match the higher total amount received. This avoids having to return small excess amounts of crypto, and rather crediting the full amount to the end user's account. The total sent amount will be deposited into the MID wallet that was linked to the transaction.

The total amount sent is given in the .actual fields described in the section above, which can then be used to adjust the end users total payment amount on your system, when comapred to the requested .amount field.