Skip to main content
POST
Create Order

Overview

Use this endpoint to start a new order for a product — for example, a premium account upgrade or a metal card. The response includes an orderId and, where applicable, a paymentConfig object containing everything needed to route the user through an external crypto payment flow. Once you have an orderId, pass it to your payment gateway. After payment is submitted, poll GET /v1/order/:orderId to confirm the final outcome.
Not sure which productId to use? Call GET /v1/order/products/available first to retrieve the list of products available and eligible for the current user.

Request

Headers

string
required
Bearer token for the authenticated user. Format: Bearer <userAccessToken>
string
required
Your application’s client ID, issued during onboarding.
string
required
Must be application/json.

Body

string
required
The unique identifier of the product to order. Valid values are partner-specific and returned by GET /v1/order/products/available. Example: "PRODUCT_ID_ABC"
string
required
The payment method to use for this order. Supported values:
  • CRYPTO_EXTERNAL_DAIMO

Example Request

Response

200 — Success

The order has been created. Store orderId to track the order status. Use paymentConfig to initiate payment via your gateway.
string
An identifier for the payment request, used to correlate payment gateway callbacks back to this order. Example: "payment_1234"
string
required
Unique identifier for this order. Store this — you’ll need it to poll for the order outcome via GET /v1/order/:orderId.
object
Payment routing details for the external crypto payment. Pass these values to your payment gateway to initiate the transaction.

Error Responses

The bearer token is missing, expired, or invalid. Ensure a valid user access token is included in the Authorization header.
The authenticated user does not have permission to perform this action.
One or more required fields failed validation. Check that productId and paymentMethod are both present and that paymentMethod is a supported enum value (CRYPTO_EXTERNAL_DAIMO).
The X-Client-ID header value is not recognised. Verify your client ID.
The X-Client-ID header is absent from the request.
An unexpected error occurred on the server. Retry with exponential backoff. If the issue persists, contact Baanx support.

Get Available Products

Retrieve the products available and eligible for the current user before placing an order.

Get Order Status

Poll for the async completion of a payment and confirm the order outcome.