Edge Cases

User Errors (Mispayments)

---

Introduction

Due to the specifics of on-chain transfers, Bitnbox can’t control the amount of tokens users send, nor the currency and networks used.

The correct amount, currency, and network can be guaranteed only with the Binance Pay method, as it’s processed off-chain. In upcoming releases, we plan to support two features that address the mispayment issue:

1. Wallet Connect: Users can directly connect their wallet and sign transactions with a fixed amount on the correct network.

2. Checkout Page: This will allow Bitnbox to communicate directly with the payer to send additional payment requests or initiate a refund of the overpaid amount.

Mispayment cases to keep in mind

• Underpaid: The payment will be marked as “Partially Paid” if the payer sends less than the required amount. We recommend creating an additional payment for Host-to-Host Payments integration to cover the underpaid amount.

  Currently under development, the Checkout Page will support the automated creation of additional payments and sharing them with the payer.

• Overpaid: The payment will be marked as “Overpaid” if the payer sends more than the required amount. We recommend making a payout to send the overpaid amount for H2H integration if needed.

• Late Payment: Payments on the Bitnbox platform expire after 15 minutes. If your customer sends the funds after the payment has expired, it won’t appear in the merchant's transaction history. To accept such a payment, please reach out to your success manager and provide the information from the Mispayments & Funds Recovery Form, which can be found below.

• Incorrect Currency or Network:

  If a payer makes a transaction on the wrong network or sends the incorrect currency, the payment won’t appear in the merchant's transaction history. This payment can still be accepted if it was made using a currency-network pair supported by Bitnbox. If it wasn’t, the funds can be refunded. To accept the payment or request a refund, please reach out to your customer success manager.

• Incorrect Address:

  There are two potential cases of a user sending funds to the wrong address:

  1. The payer sent funds to an address previously used for a payment. Bitnbox payment addresses are not permanently assigned to one user. To recover the funds, please contact your Customer Success Manager and fill out the Mispayments & Funds Recovery Form.

  2. If the payer sends funds to a random address, not managed by Bitnbox, they can not be recovered.

Mispayments & Funds Recovery Form

Transaction details required to process a mispayment:

• Payment ID

• Transaction Hash

• Network

• Issue type: Late payment, incorrect network, incorrect currency, incorrect address

• Sent from a centralized exchange: y/n (applicable only for refunds)

External Edge Cases

---

Network Downtime

During periods of network downtime or disruptions in blockchain networks, transactions may be delayed or fail to process. This can impact the timely processing of payments and require additional communication and coordination with the payer. Bitnbox cannot influence or control blockchain networks’ downtimes.

Stablecoin Depeg

In cases where stablecoins are used for payments and experience a depeg from their intended value (such as 1:1 parity with fiat currency), discrepancies in payment amounts may occur. This can affect the accuracy of transactions and necessitate adjustments in handling payments and settlements. Bitnbox does not have control over stablecoin depegging events.