Create Widget URL (Cards, Apple Pay)

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.

This API should be called only from the partner’s backend and subjected to the whitelisting of partner’s IPs addresses. Direct API calls from the frontend apps are not supported.

Each widgetUrl can be used only once and is valid only for 5 minutes from the time of creation.

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. <Callout intent="note"> This API should be called only from the partner’s backend and subjected to the whitelisting of partner's IPs addresses. Direct API calls from the frontend apps are not supported. Each widgetUrl can be used only once and is valid only for 5 minutes from the time of creation. </Callout>

1	curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
2	-H "authorization: " \
3	-H "access-token: " \
4	-H "Content-Type: application/json" \
5	-d '{
6	"widgetParams": {
7	"apiKey": "a1b2c3d4e5f6g7h8i9j0",
8	"referrerDomain": "partner.example.com",
9	"cryptoCurrencyCode": "ETH",
10	"fiatCurrency": "USD",
11	"network": "ethereum",
12	"fiatAmount": 100,
13	"paymentMethod": "card",
14	"walletAddress": "0xAbC1234567890DefABC1234567890defABC12345"
15	}
16	}'

Headers

Request

Response

Errors

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