API Integration Overview

The API integration gives you full programmatic control over the Banxa checkout experience. You make server-to-server REST API calls to fetch quotes, create orders, and manage your integration. The checkout URL is returned in the order response, and you redirect or embed it from there.

Choose API integration if you need any of the following:

• Webhooks — real-time order status notifications pushed to your endpoint.
• Quote UI — show customers a price comparison within your own interface before they enter checkout.
• KYC sharing — pass verified customer identity data to Banxa to reduce checkout friction.
• Order history — look up past orders programmatically.
• Programmatic control — control which payment methods, currencies, and crypto assets are presented to each customer.

The Banxa v2 API is organised into the following groups:

Create buy and sell orders from your backend. Returns a checkout URL to redirect or embed for the customer.

POST /{partnerRef}/v2/buy · POST /{partnerRef}/v2/sell

Retrieve current pricing for any combination of crypto, fiat, and payment method. Call this before every order to ensure customers see accurate pricing.

GET /{partnerRef}/v2/quotes/{orderType}

Retrieve the full list of payment methods available to your customers.

GET /{partnerRef}/v2/payment-methods

Retrieve supported countries, fiat currencies, and cryptocurrencies.

GET /{partnerRef}/v2/countries · GET /{partnerRef}/v2/fiats · GET /{partnerRef}/v2/crypto

Share verified KYC data with Banxa before order creation to streamline the checkout experience for returning customers.

POST /{partnerRef}/v2/identities/token/share

1. GET  /v2/quotes          → Show customer a price
2. POST /v2/buy             → Create order, receive checkoutUrl
3. Redirect customer        → To checkoutUrl (redirect or iFrame)
4. Webhook notification     → Banxa POSTs order status to your endpoint

→ Detailed steps: Get a Quote · Create Buy Order · Redirecting to Checkout

1. GET  /v2/quotes          → Show customer a price
2. POST /v2/sell            → Create order, receive checkoutUrl
3. Redirect customer        → To checkoutUrl (redirect or iFrame)
4. Webhook notification     → Banxa POSTs order status to your endpoint

→ Detailed steps: Create Sell Order

All v2 API requests require your API key in the request header:

x-api-key: YOUR_API_KEY

The identity endpoint uses HMAC authentication. → See Authentication & Environments.