Create Widget URL (Cards, Apple Pay)

curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
     -H "authorization: " \
     -H "access-token: " \
     -H "Content-Type: application/json" \
     -d '{
  "widgetParams": {
    "apiKey": "a1b2c3d4e5f6g7h8i9j0",
    "referrerDomain": "partner.example.com",
    "cryptoCurrencyCode": "ETH",
    "fiatCurrency": "USD",
    "network": "ethereum",
    "fiatAmount": 40,
    "paymentMethod": "credit_card",
    "walletAddress": "0xAbC1234567890DefABC1234567890dEFaBc12345"
  }
}'

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

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>

curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
     -H "authorization: " \
     -H "access-token: " \
     -H "Content-Type: application/json" \
     -d '{
  "widgetParams": {
    "apiKey": "a1b2c3d4e5f6g7h8i9j0",
    "referrerDomain": "partner.example.com",
    "cryptoCurrencyCode": "ETH",
    "fiatCurrency": "USD",
    "network": "ethereum",
    "fiatAmount": 40,
    "paymentMethod": "credit_card",
    "walletAddress": "0xAbC1234567890DefABC1234567890dEFaBc12345"
  }
}'

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

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.

Create Widget URL (Cards, Apple Pay)

Headers

Request

Response

Errors

Headers

Request

Response

Errors

$	curl -X POST https://api-gateway-stg.transak.com/api/v2/auth/session \
>	-H "authorization: " \
>	-H "access-token: " \
>	-H "Content-Type: application/json" \
>	-d '{
>	"widgetParams": {
>	"apiKey": "a1b2c3d4e5f6g7h8i9j0",
>	"referrerDomain": "partner.example.com",
>	"cryptoCurrencyCode": "ETH",
>	"fiatCurrency": "USD",
>	"network": "ethereum",
>	"fiatAmount": 40,
>	"paymentMethod": "credit_card",
>	"walletAddress": "0xAbC1234567890DefABC1234567890dEFaBc12345"
>	}
>	}'

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