Place an order
Creates an order asynchronously. The response returns immediately with an orderId and a processing status, plus an estimatedReadyAt timestamp that indicates when to start polling for codes. Larger orders receive a later estimatedReadyAt.
Send the catalog productCode and the price you expect to pay (used to validate the order). For fixed-price products the price must match the current catalog price; for open-denomination products send the chosen amount within the allowed range.
The externalOrderCode is your idempotency key: re-posting the same code returns the existing order instead of creating a duplicate.
Authorizations
Your Kalixo API key. Send it in the x-api-key header on every request.
Body
Your unique reference for this order. Acts as the idempotency key.
"O-12345"
"GBP"
1Optional expected order total in minor units. If sent, must equal the sum of (line unit price × quantity).
10000
Response
Order accepted and now processing.
"b9f6f9a2-4d0a-4f5c-9a1e-7c2d8f3b6e10"
"O-12345"
processing "processing"
Approximate time the codes should be ready. Poll the order after this time.
"2026-06-02T11:05:00Z"