Exception scenarios
The final step is to build in handling for exceptions that may occur in the payment flow. The types of webhooks are covered on the Receive Payment Notifications page, but the following guides provide a more detailed explanation of the scenarios.
As cryptocurrency payments are push payments rather than pull ones, BVNK cannot control when and how much cryptocurrency BVNK will receive to complete the end-user's payment.
Generally, exception scenarios are caused by user error, hidden or unpredictable fee amounts from the sending exchange, or slow blockchain processing speeds.
There are three payment exception scenarios that need to be considered and handled by merchants:
If you want your customers to pay the exact amount.
📄️ Overpayments
Overpayments occur when end-users send more cryptocurrency than intended. For example, they intend to send 0.01 ETH but send 0.1 ETH instead. In this case, the payment still transitions to a COMPLETE status.
📄️ Underpayments
Underpayments occur when end-users do not transfer enough cryptocurrency to fulfill their payment obligation.
📄️ Late payments
This type of payment is specific for Merchant Payment Services / Payment Links only.
📄️ Refund payments
In the case where a payment exception scenario has taken place, BVNK provides the option to automatically refund the cryptocurrency for merchants who do not want to hold these cryptocurrencies, due to any compliance issues, or for merchants that do not want to internally process any payments that have fallen outside of the agreed upon payment rules.