🏷️ White Label Integration

Overview

Transak provides a flexible solution for partners through rich white-label integration. This is achieved by combining Query parameters and APIs, which allows partners to create their user interface (UI) by consuming the details from the API and passing those values as query parameters. This enables the partner to skip specific screens altogether and only depend on Transak UI for a few mandatory steps. The following flow diagram illustrates the transaction process within a partner application that uses Transak for both On-Ramp and Off-Ramp. The process is divided into several screens, and some of these screens can be skipped based on the integration configuration.

Flow Diagram


Quick View

Here is the quick cheatsheet for the screens that can be bypassed using Query parameters and APIs

ScreenDemo LinkIs skippable?
Exchange ScreenSkip Exchange Flow Demo:white-check-mark:
Wallet Confirmation ScreenSkip Wallet Address Flow Demo:white-check-mark:
Email Verification ScreenSkip Email Flow Demo:white-check-mark:
OTP Verification ScreenNA❌
Lite KYC ScreenSkip Lite KYC Flow Demo:white-check-mark:
Standard KYC ScreenNA❌
Confirm Order ScreenNA❌
Payment ScreenNA❌
Payment Authorization ScreenSkip Payment Authorization Flow - iFrame Demo
Skip Payment Authorization Flow - Transak SDK Demo
:white-check-mark:
Order Status ScreenSkip Order Status Flow - API Demo:white-check-mark:
Order History ScreenSkip Order History Flow - API Demo:white-check-mark:

Screen Flows

Exchange Screen

Transak Exchange Screen

  1. The Exchange Screen is designed to help you select the desired Fiat, Crypto, and Payment methods to Buy or Sell crypto.

  2. The Exchange Screen can be skipped by passing query parameters such as apiKey, fiatCurrency, cryptoCurrencyCode, fiatAmount, productsAvailed, network, paymentMethod, and hideExchangeScreen.

  3. The "Enter Your Wallet Address" screen will be opened directly when all the required parameters are passed.

Note: To build your UI for the Exchange screen, kindly use the public APIs to fetch the quotes, fiats, and cryptos lists.

API Details

Demo: Skip Exchange Flow Demo

Wallet Confirmation Screen: (Only for On-Ramp)

Wallet Confirmation Screen

  1. The Wallet Confirmation Screen confirms the user's wallet address to receive crypto.

  2. The Wallet Confirmation Screen can be skipped by passing query parameters such as walletAddress and disableWalletAddressForm.

  3. The "Please Enter Your Email" screen will be opened directly when all the required parameters are passed.
    Demo:Skip Wallet Address Flow Demo

Email Verification Screen

Email Verification Screen

  1. The Email Verification Screen confirms the user's email address for OTP verification.

  2. The Email Verification Screen can be skipped by passing the query parameter - email.

  3. The "Verify Your Email" screen will be opened directly when all the required parameters are passed.
    Demo: Skip Email Flow Demo

OTP Verification Screen

OTP Verification Screen

  1. The OTP Verification Screen confirms the OTP received in the user's email.

  2. The OTP Verification Screen is a mandatory step for Transak and this screen cannot be skipped.
    Demo:

Lite KYC Screen

Personal DetailsAddress
Personal DetailsAddress
  1. Lite KYC flow consists of two steps - Personal Details and Address.

Note: The document and liveliness step are not required for orders under a specific limit. Users can directly place an order without any document uploads. In this case, the Standard KYC will not appear.

Demo: Skip Lite KYC Flow Demo

Standard KYC Screen (One-time step for new users)

DocumentSelfie
ID Proof & SelfieID Selfie
  1. Standard KYC flow consists of two steps - Document Upload and Liveliness Check (Selfie).
  2. The Standard KYC is a mandatory step when the orders above particular ranges are not fulfilled from Lite KYC Flow

Confirm Order Screen

Confirm Order Screen

Users must confirm the details of their order on this screen. This is a mandatory step in the Transak flow.

Payment Screen

Payment Screen

Users are required to enter the payment details to proceed with the payment. This is a mandatory step in the Transak flow.

Payment Authorization Screen

Payment Authorization Screen

Partners can skip this screen by listening to Transak SDK or iFrame events using the TRANSAK_ORDER_SUCCESSFUL event. To learn more about the various event callbacks, refer to this documentation Javascript SDK events.

Demo:

  1. Skip Payment Authorization Flow - iFrame Demo
  2. Skip Payment Authorization Flow - Transak SDK Demo

Order Status Screen

Order Status Screen

Partners can retrieve the current order status using the Get Orders By ID API or listen to the Orders webhook callbacks using Get Orders Webhook after the Payment Authorization Screen step is completed.

Demo: Skip Order Status Flow - API Demo

Order History Screen

Order History Screen

Partners can retrieve their order history from the Get Orders API. This API allows filtering based on the start and end date range, order status, and product type (BUY or SELL).

Demo: Skip Order History Flow - API Demo