API Reference

Create a new order

post
https://biz-sandbox-api.sodagift.com/v1/orders

Creates a single-item order, charged against your account balance.

Common 400 error codes: account_balance_insufficient, price_range_exceed (custom_amount outside the product's min/max), invalid_request, invalid_phone_number_format. A 500 with order_retry_needed means a temporary concurrency conflict — the request can be safely retried (use external_reference_id to make retries idempotent).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
item
object
required
delivery
object
required
string | null
string | null
string | null
^[a-zA-Z0-9]+$

Idempotency key. Use this field to safely retry order creation and prevent accidental duplicate orders. If an order with the same value already exists within your account, no new order is created — the API returns the existing order with a 200 response. If not provided, this behavior is not enforced.

The value must be an alphanumeric string (letters and numbers only) between 1 and 100 characters in length. This field is returned in the order creation response and order retrieval.

Responses

401

Missing or invalid API key. The response body is empty.

Updated 17 days ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 17 days ago

Did this page help you?