Whitelabel API
A complete API solution for building custom on/off ramp experiences.
A complete API solution for building custom on/off ramp experiences.
The Transak Whitelabel API enables partners to integrate Transak products directly into their own platforms using APIs, without displaying any third-party user interface (such as the Transak Widget).
Partners maintain complete control over the user interface and end-to-end user journey, while Transak manages the backend complexities through APIs, including KYC, compliance, liquidity, payment processing, and fraud management.
This solution is ideal for partners who want to fully own and control the E2E user journey, including the user interface, experience, and flow.
Build and control the complete user journey, from authentication and KYC to order creation and tracking, without any third-party UI.
Access 136+ cryptocurrencies across 45+ blockchains in 64+ countries with transparent pricing via Lookup APIs.
Create and track orders programmatically using REST APIs, Webhooks, and WebSockets.
Transak handles KYC, AML, transaction monitoring, and regulatory compliance.
Reuse your existing KYC data with Transak through Sumsub for faster onboarding.
Follow the steps in the Need help in Integration section to reach us. Then raise the request to enable Whitelabel APIs for your API key and share your public IP addresses with Transak for whitelisting to use our APIs in your backend.
Start by designing and implementing the complete user flow, including error handling. See the Lookup API reference to begin.
You must include Transak’s Terms of Service within their own Terms & Conditions. End users must be able to review and acknowledge Transak’s T&C as part of the user journey.
Whitelabel APIs are to be called only from the partner backend and subjected to the whitelisting of partner IP addresses. Direct API calls from the frontend apps are not supported.
Lookup APIs provide public reference data that you can use before initiating a session. Use them to populate currency selectors, validate supported regions, and fetch real-time quotes — no authentication required.
Fetch all required data before presenting the order form.
Pass the existing User Access Token to Get User Details to fetch the user’s KYC status. Route the user as follows:
This document provides a detailed explanation of KYC flows, covering Simple KYC, Standard KYC and Enhanced KYC, along with the required API interactions and processes. KYC is a mandatory step in compliance with regulatory requirements before users can place orders on Transak.
The KYC requirements are determined dynamically using the quote ID. Transak supports multi-level KYC, meaning different users may have different requirements based on country, regulations, and transaction limits.
When fetching KYC Requirement, there can be three status -
All forms must be submitted in the sequence provided in the Get Additional Requirements API.
Call Get KYC Requirement with the quoteId to fetch current status of the user’s KYC.
Call Patch User Details to collect and submit the user’s personal and address information.
Once submitted, return to Step 1 to re-fetch the updated KYC status.
Call Get Additional Requirements to check which forms still need to be completed.
Check if additional information must be provided for KYC Approval. Multiple forms may appear and must be submitted in the sequence provided in the API response:
type = PURPOSE_OF_USAGE → Follow Step 4type = IDPROOF → Follow Step 5type = US_SSN → Follow Step 6type = FCA → Follow Step 7type = SOURCE_OF_INCOME → Follow Step 8type = DOCUMENT_PROOF → Follow Step 9Redirect the user to the Transak-hosted KYC Widget using the kycUrl returned in the Additional Requirements response.
Call Submit SSN to validate the user’s identity using their Social Security Number.
FCA (Financial Conduct Authority) compliance is required for all UK users. The flow covers three sequential steps — investor categorization, a compliance agreement, and a risk assessment.
See the dedicated guide for the full API sequence, status handling, and step-by-step integration details:
Call Submit Source of Income to capture the user’s primary income source. Required for higher transaction limits.
Call Upload Proof Document to submit supporting documentation for the income source selected in the previous step.
Call Get KYC Reliance Quote with kycShareTokenProvider and kycShareToken alongside the common fields used in the standard Get Quote API.
On success, you will receive a quoteId to use in the next step.
Call Get KYC Reliance Status with the quoteId and kycShareToken to fetch the user’s KYC status, then route accordingly:
Call Get KYC Requirement with the quoteId to fetch the user’s KYC status and route accordingly:
Call Get User Limits with paymentMethod = bank_transfer and fiatCurrency to fetch the user’s monthly, daily, and yearly limits along with available limits to place an order.
On success → proceed to Get Active Orders.
Call Get Active Orders to check for any existing pending orders. Transak doesn’t support placing multiple orders simultaneously.
Call Create Order passing quoteId, paymentInstrumentId (payment method), and walletAddress.
Call Confirm Payment with orderId and paymentMethod to confirm the bank transfer.
On success → proceed to Get Order By ID.
Call Cancel Order with orderId and cancelReason to cancel a pending order.
This step is only required when an existing active order is detected. After cancellation, return to Get User Limits to start a fresh order.