TRANSAK WHITELABEL APIOn RampPaymentsHeadless Cards

Transaction Session API

View as Markdown

Creates a Headless Cards transaction session. Returns a sessionId for your integration. Requires a valid partner access token and approved KYC where applicable.

Note: Ensure the quoteId was generated with paymentMethod set to credit_debit_card.

Headers

x-user-ipstringRequired

End user’s originating IP. More details here

x-api-keystringRequired
Your Partner API key. You can find this in the [Partner Dashboard](https://docs.transak.com/guides/how-to-create-partner-dashboard-account#open-the-developers-section).
x-access-tokenstringOptional

Your Partner Access Token. Please refer here for a tutorial on generating your access token.

Note: This is applicable only for Auth Reliance Flows

x-user-identifierstringOptional

The authenticated user’s email address. Note: This is applicable only for Auth Reliance Flows.

authorizationstringOptional

Authorization token is the accessToken received from the API - api/v2/auth/verify

Note: This is not applicable for Auth Reliance Flows

Request

This endpoint expects an object.
quoteIdstringRequired

Quote ID from the Quotes API.

walletAddressstringRequired
Destination crypto wallet address.
successUrlstringRequired
Redirect URL on payment success.
failureUrlstringRequired
Redirect URL on payment failure.
configobjectOptional
Additional optional UI configuration passed through to the session.
billingAddressobjectOptional

Auto-fetched from user profile if omitted.

Response

Success
dataobject

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error