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 start

Make 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.

An example of the BVNK hosted payments page where an end-user can select a cryptocurrency like Butcoin, Tether or Ethereum to make a 150 EUR payment requested by a merchant.

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.


What’s Next

After becoming familiar with the flow, it's time to create your first payment via the API.