Android

Add Permissions in Manifest File

Update your AndroidManifest.xml to include required permissions for internet access and camera (for KYC verification):

1
<uses-permission android:name="android.permission.INTERNET"/>
2
<uses-permission android:name="android.permission.CAMERA"/>

Implement WebView in Activity

Configure your MainActivity to load the Transak widget URL using your preferred implementation:

1
import android.webkit.PermissionRequest
2
import android.webkit.WebChromeClient
3
import android.webkit.WebView
4
...
5
6
AndroidView(
7
    factory = {
8
        WebView(it).apply {
9
10
            this.layoutParams =
11
                ViewGroup.LayoutParams(
12
                    ViewGroup.LayoutParams.MATCH_PARENT,
13
                    ViewGroup.LayoutParams.MATCH_PARENT
14
                )
15
16
            this.settings.javaScriptEnabled = true
17
            this.settings.domStorageEnabled = true
18
19
            this.webChromeClient = object : WebChromeClient() {
20
                override fun onPermissionRequest(request: PermissionRequest) {
21
                    request.grant(request.resources)
22
                }
23
            }
24
        }
25
    },
26
    update = {
27
        it.loadUrl(
28
            "https://global-stg.transak.com?apiKey=<YOUR_API_KEY>&sessionId=<YOUR_SESSION_ID>"
29
        )
30
    }
31
)

Configure XML Layout (Skip if using Compose)

Add the WebView to your activity_main.xml layout file:

1
<WebView xmlns:android="http://schemas.android.com/apk/res/android"
2
    android:id="@+id/transakWidgetView"
3
    android:layout_width="match_parent"
4
    android:layout_height="match_parent"/>

Create Widget URL (using Backend Only)

Call the Create Widget URL to generate a Widget URL by securely passing the widget parameters.

The response returns a widgetUrl that should be used to load Transak in Android Webview.

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"
>
  }
>
}'

Register Deeplink in AndroidManifest File

Add an intent filter to your AndroidManifest.xml to handle the deeplink:

1
<activity android:name=".MainActivity">
2
    <intent-filter>
3
        <action android:name="android.intent.action.VIEW"/>
4
        <category android:name="android.intent.category.DEFAULT"/>
5
        <category android:name="android.intent.category.BROWSABLE"/>
6
        <data android:scheme="myapp"
7
            android:host="transak-redirect" />
8
    </intent-filter>
9
</activity>

Handle Deeplink and Parse Parameters

Listen for the deeplink and parse the returned parameters in your Activity.

When Transak redirects back, it includes additional query parameters appended to deeplink URL mentioned here.

1
override fun onNewIntent(intent: Intent?) {
2
    super.onNewIntent(intent)
3
    intent?.data?.let { uri ->
4
        val status = uri.getQueryParameter("status")
5
        val orderId = uri.getQueryParameter("order_id")
6
        val cryptoAmount = uri.getQueryParameter("cryptoAmount")
7
        // Handle more parameters
8
    }
9
}

Pass redirectURL in Create Widget URL API

Call the Create Widget URL to generate a Widget URL by securely passing the widget parameters along with the redirectURL parameter.

The response returns a widgetUrl that should be used to load Transak in Android Webview.

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",
>
    "redirectURL": "myapp://transak-redirect"
>
  }
>
}'