HEADLESS CARDS API

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.

Headers

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 pricing 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

401
Unauthorized Error
422
Unprocessable Entity Error
500
Internal Server Error