Unified Checkout
The Unified Checkout is the fastest way to integrate BTC Direct into your platform. Your users are redirected to a hosted checkout page where they can complete their cryptocurrency purchase. No need to build your own order flow.
How it works
Section titled “How it works”- Your backend authenticates with the BTC Direct API using your partner credentials.
- You create a checkout session by calling the checkout endpoint with the order details.
- The API returns a
checkoutUrl. - You redirect the user to that URL.
- The user completes payment on the BTC Direct hosted checkout page.
- After payment, the user is redirected back to your
returnUrl.
What you need
Section titled “What you need”- API credentials (username and password) from your account manager.
- A backend service to authenticate and create checkout sessions. Never expose your credentials in frontend code.
- A wallet address for the cryptocurrency the user is buying.
Supported flows
Section titled “Supported flows”The Unified Checkout currently supports the buy (fiat-to-coin) flow. The user pays with fiat and receives cryptocurrency.
For available payment methods, see Payment methods. For supported currencies, see Supported currencies.
Sandbox
Section titled “Sandbox”The sandbox environment (api-sandbox.btcdirect.eu) simulates the production flow but does not process real payments. Orders are created and checkout URLs are generated, but no actual transactions occur. Wallet addresses must use mainnet format even in sandbox.
Limitations
Section titled “Limitations”- iFrames are not supported. The user must be redirected to the checkout URL.
- The checkout URL is single-use and expires based on the payment method’s expiration period.
Next steps
Section titled “Next steps”Follow the Quick start: buy (F2C) guide to create your first checkout session.