Skip to navigation
Integration OptionsMobile WebView

React Native

Seamless Transak integration for React Native applications
View as Markdown

The Transak React Native integration allows you to embed a fully functional interface directly into your React Native application.

Google Pay works only with the Transak React Native SDK integration for mobile applications.

Integration Methods

Transak React Native SDK (Recommended)

Fastest way to integrate Transak in Expo and non-Expo apps with built-in callbacks and event support.

React Native WebView

Direct WebView-based integration using react-native-webview.

Official Transak SDK with built-in event handling, callbacks, and simplified camera permissions for both Expo and Non-Expo implementations.

1

Install SDK and Dependencies

Install the Transak SDK based on your project setup.

Install the React Native SDK:

npm i @transak/ui-react-native-sdk

Install required peer dependencies:

npm i react-native-webview
npm i react-native-inappbrowser-reborn
npm i @react-native-community/netinfo
2

Add Permissions

Add required camera and media permissions for KYC verification in Android and iOS.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
3

Implement TransakWebView Component

Add the TransakWebView component to your app with event handling.

import {
  TransakWebView,
  Events,
  TransakConfig,
  OnTransakEvent,
} from '@transak/ui-react-native-sdk';
function TransakWebViewIntegration() {
  const transakConfig: TransakConfig = {
    widgetUrl: "https://global-stg.transak.com?apiKey=YOUR_API_KEY&sessionId=<YOUR_SESSION_ID>"
  };
  const onTransakEventHandler: OnTransakEvent = (event, data) => {
    switch (event) {
      case Events.TRANSAK_WIDGET_INITIALISED:
        console.log('Widget initialized:', event, data);
        break;
      case Events.TRANSAK_ORDER_CREATED:
        console.log('Order created:', event, data);
        break;
      case Events.TRANSAK_ORDER_SUCCESSFUL:
        console.log('Order successful:', event, data);
        break;
      case Events.TRANSAK_ORDER_FAILED:
        console.log('Order failed:', event, data);
        break;
      case Events.TRANSAK_WIDGET_CLOSE:
        console.log('Widget closed:', event, data);
        break;
      default:
        console.log('Widget event:', event, data);
    }
  };
  return (
    <TransakWebView
      transakConfig={transakConfig}
      onTransakEvent={onTransakEventHandler}
    />
  );
}
4

Create a Widget URL (Backend Only)

Call the Create Widget URL API from your backend to generate a secure widget url using Query parameters

The response returns a widgetUrl that should be used in the transakConfig prop.

A widgetUrl is valid for 5 minutes and can only be used once. A new widgetUrl must be generated for every user flow.

Example Request:

curl --request POST \
  --url https://api-gateway-stg.transak.com/api/v2/auth/session \
  --header 'access-token: YOUR_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{
  "widgetParams": {
    "apiKey": "YOUR_API_KEY",
    "referrerDomain": "yourdomain.com"
  }
}'

Component Props

PropDescription
transakConfig

Supports widgetUrl and referrer as mandatory parameters

onTransakEvent

Callback function to listen to widget events

React Native WebView

For teams that prefer managing the WebView directly, you can use the react-native-webview library.

Do not override the WebView user agent

Transak uses the default User-Agent to detect that the widget is running inside a native WebView, which determines the payment methods we offer. Replacing it strips those identifiers, so users may be shown methods that cannot complete in a WebView and our support team loses the signal needed to diagnose failures.

Keep the default User-Agent unchanged. If you need to identify your app, use your platform’s append-only option

1

Add Permissions

Add required camera and media permissions for KYC verification in Android and iOS.

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
2

Install react-native-webview

Install the WebView package:

npm i react-native-webview
3

Implement WebView Component

Import and render the WebView with the Transak widget URL:

import { WebView } from 'react-native-webview';
<WebView
  source={{ url: 'https://global.transak.com?apiKey=<YOUR_API_KEY>&sessionId=<YOUR_SESSION_ID>' }}
  enableApplePay
  allowsInlineMediaPlayback
  mediaPlaybackRequiresUserAction={false}
/>

These props should not be passed for Apple Pay to function properly.

  • sharedCookiesEnabled

  • injectedJavaScript

  • injectedJavaScriptBeforeContentLoaded

4

Create a Widget URL (Backend Only)

Call the Create Widget URL API from your backend to generate a secure widget url using Query parameters

The response returns a widgetUrl that should be used as the source URL in the WebView.

A widgetUrl is valid for 5 minutes and can only be used once. A new widgetUrl must be generated for every user flow.

Example Request:

curl --request POST \
  --url https://api-gateway-stg.transak.com/api/v2/auth/session \
  --header 'access-token: YOUR_ACCESS_TOKEN' \
  --header 'content-type: application/json' \
  --data '{
  "widgetParams": {
    "apiKey": "YOUR_API_KEY",
    "referrerDomain": "yourdomain.com"
  }
}'

Supported Events

Event NameDescription
TRANSAK_WIDGET_INITIALISED

Widget initialised with query params

TRANSAK_ORDER_CREATED

Order created by user

TRANSAK_ORDER_SUCCESSFUL

Order is successful

TRANSAK_ORDER_CANCELLED

Order is cancelled

TRANSAK_ORDER_FAILED

Order is failed

TRANSAK_WALLET_REDIRECTION

Widget is about to redirect to passed URL

TRANSAK_WIDGET_CLOSE

Widget is about to close