Welcome to the Banxa tutorial. In this section, you will find detailed steps on how best to integrate with our APIs.

The following steps is how we recommend you approach the integration.

  1. You request the Get Payment Methods, Get Fiat Currencies and Get Crypto Currencies endpoints to obtain the Payment Methods, Fiat Currencies and Cryptocurrencies which are available for your account. The Get Crypto Currencies endpoint will also return the supported blockchain networks available for each Cryptocurrency.
  2. Through your website, you allow the user to select the currencies for the order, enter the amount and select the payment method. You may optionally allow the user to select a blockchain network for the Cryptocurrency they wish to buy if there are more than one supported. However, if there is no explicit choice made, the configured default blockchain network will be used.
  3. The order information that the user has selected is sent to Banxa with an account reference and wallet address in the Create Order request. In the response, Banxa will return the checkout URL.
  4. Redirect the user to the checkout URL and we will take care of verifying the customer and taking payment.
  5. Once complete we will redirect the customer back to your site through the success url you gave us on Create Order
  6. Depending on the payment method chosen, the order will be completed in minutes or up to a few hours. You can check on the progress by calling Get Order with the order reference.

There are some variations to this flow, and details can be found in Checkout Approaches