Create Widget URL
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>
Headers
access-token
Your Partner Access Token. Please refer here for a tutorial on generating your access token.
Request
This endpoint expects an object.
widgetParams
Transak Widget accepts query parameters as a JSON object. Below are some example query parameters. You can refer to the complete list of Transak Query Parameters for more configuration options.
Response
Success
data
Errors
400
Bad Request Error
401
Unauthorized Error
