TRANSAK WHITELABEL APIOn RampPaymentsHeadless Cards

Create Order (with New Card)

View as Markdown
The **Create Order (with New Card)** is an **authenticated API** that places a **crypto buy order** using a newly added credit/debit card, based on the `requestId` returned when the user submits their card details via the [Transak UI SDK](/features/headless-cards#load-the-card-component-via-transak-ui-sdk).

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).
authorizationstringOptional

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

Note: This is not applicable for Auth Reliance Flows

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.

Request

This endpoint expects an object.
requestIdstringRequired

Request ID returned in the onSuccess callback of the Transak UI SDK after the user submits a new card.

Response

Success
dataobject
Order details returned after processing the card transaction session.

Errors

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