Build Crypto Payment Gateway
The following guide will walk you step by step through the process of making a crypto gateway: from creating your first payment to preparing a UI ready to accept crypto payments from your customers.
This is a quick start guide for adding crypto payments to your checkout flow with BVNK.
Before you startMake sure you've followed the Getting Started guide, so that you have your account set up, API keys generated, and a MID ready to be used.
For this guide, you will use the BVNK-hosted payments page, as it is the fastest way to add crypto to your payment flows.

You can use the responses from our API to build your UI.
Payment workflow
Payments pass the following statuses throughout the workflow:
Status | Immutable? | Description |
---|---|---|
Pending | No | Initial status of your payment. It will not transition out of this state until the payment expires or a transaction linked to this payment is detected on the blockchain. |
Processing | No | Once your customer sends a payment, and BVNK can see the payment on the blockchain, the payment will transition to processing until funds are credited to your wallet. Payments may still expire when in this state if the customer does not send enough gas or the blockchain does not move within the given expiry time. |
Complete | Yes | Funds have been received and are credited to the merchant account in the desired currency. |
Underpaid | Yes | Funds have been received and are credited to the merchant account in the desired currency. However, the customer did not send enough funds to cover the original amount requested. |
Expired | Yes | The payment expired before the customer sent funds. |
Updated 3 days ago
After becoming familiar with the flow, it's time to create your first payment via the API.