Create Widget URL

POST

https://api-gateway-stg.transak.com/api/v2/auth/session

This API creates a `widgetUrl` to securely store widget query parameters and authentication context. This facilitates secure widget interactions by encapsulating info in a sessionId, reducing exposure in client-side requests. Use the returned `widgetUrl` to load the Transak Widget. This URL expires 5 minutes after creation. **Important:** - Each `sessionId` is single-use. - The widget cannot be reopened using the same `widgetUrl`. - A new `sessionId` is required for every new user flow. | Environment | Base URL | | :---------- | :------- | | Staging | https://api-gateway-stg.transak.com | | Production | https://api-gateway.transak.com | <Callout intent="note"> Call this API only from the partner backend, with partner IPs whitelisted. Direct frontend calls are not supported. </Callout> <Callout intent="warning"> `apiKey` and `referrerDomain` are mandatory query parameters inside the `widgetParams` object. </Callout>

Create Widget URL

POST

https://api-gateway-stg.transak.com/api/v2/auth/session

This API creates a widgetUrl to securely store widget query parameters and authentication context. This facilitates secure widget interactions by encapsulating info in a sessionId, reducing exposure in client-side requests.

Use the returned widgetUrl to load the Transak Widget. This URL expires 5 minutes after creation.

Important:

Each sessionId is single-use.
The widget cannot be reopened using the same widgetUrl.
A new sessionId is required for every new user flow.

Environment	Base URL
Staging	https://api-gateway-stg.transak.com
Production	https://api-gateway.transak.com

Call this API only from the partner backend, with partner IPs whitelisted. Direct frontend calls are not supported.

apiKey and referrerDomain are mandatory query parameters inside the widgetParams object.

$	curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
>	-H "access-token: " \
>	-H "Content-Type: application/json" \
>	-d '{
>	"widgetParams": {
>	"apiKey": "abc123def456ghi789jkl012mno345pq",
>	"referrerDomain": "partner.example.com"
>	}
>	}'

$	curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
>	-H "access-token: " \
>	-H "Content-Type: application/json" \
>	-d '{
>	"widgetParams": {
>	"apiKey": "abc123def456ghi789jkl012mno345pq",
>	"referrerDomain": "partner.example.com"
>	}
>	}'

Create Widget URL

Create Widget URL

Headers

Request

Response

Errors

Headers

Request

Response

Errors

1	{
2	"data": {
3	"widgetUrl": "https://global-stg.transak.com?apiKey=abc123def456ghi789jkl012mno345pq&sessionId=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1ZDg3Y2YxMi1hYmNkLTQ1ZjYtYmYxMi1hYmNkZWYxMjM0NTYiLCJpYXQiOjE2ODgwMz"
4	}
5	}