Banqeo provides merchants with information about every change on the status of their bitcoin payment through the following notifications:
- Paid – once the payment has successfully reached your Banqeo blockchain wallet, the order is completed and marked as paid.
- Pending – the payment (or part of it) was forwarded to the blockchain, but is still waiting for the required number of confirmations.
- Failed – an error has occurred.
- Expired – when a customer pays for an item via Banqeo, there is a 15 minute or 24 hour payment window until the transaction expires. This window depends on the project’s configuration and on the receiving currency set by the merchant. If no bitcoin payment has been made within the given window, the order is marked as “Expired” and it is no longer valid. The order also expires if only a part of the payment was done in the given time.
If the payment window has lapsed before the bitcoin transaction was completed, the merchant is still responsible for contacting the customer and determining whether to give a refund or fulfill the order.
Banqeo’s Callback System
When you receive a deposit for your order at your registered cryptocurrency address, all the data about this bitcoin transaction is sent to your defined HTTP callback address (URL). The merchant’s HTTP callback URL must return HTTP Response code 200 with content: *ok* for the Banqeo API to confirm the callback as successful.
Once you have configured your callback endpoint, subscribed to events and set the appropriate permissions to receive the respective notifications, we will start sending them to your application. Each notification contains a unique ID, type, and the corresponding data payload.
More about Banqeo’s callback implementation you can find at our Merchant API.