Place an order | Voodoo Center

Places an order for an item and charges your balance. Returns 201 immediately with status: "pending"; the final result arrives via your webhook and is readable from GET /api/v1/orders/{id}.

Request fields

item_id (required) — the numeric item id.
quantity — required for top-up items (a decimal amount) and for key items (an integer count, defaults to 1); omit for service items (always 1). Must be within the item’s min/max range.
merchant_order_id (optional) — your own idempotency/reference string, unique per account.
fields — required for top-up and service items only, keyed by the item’s field names. Send a text field’s value as a string; send a choice field’s value as the numeric choice id. Key items take no fields.

Discover an item’s item_id, product type, quantity bounds and field definitions from the catalog export (see the Placing orders guide).

Places an order for an item and charges your balance. Returns `201` immediately with `status: "pending"`; the final result arrives via your webhook and is readable from `GET /api/v1/orders/{id}`. ### Request fields - **`item_id`** (required) — the numeric item id. - **`quantity`** — required for **top-up** items (a decimal amount) and for **key** items (an integer count, defaults to `1`); **omit for service** items (always `1`). Must be within the item's min/max range. - **`merchant_order_id`** (optional) — your own idempotency/reference string, unique per account. - **`fields`** — required for **top-up** and **service** items only, keyed by the item's field names. Send a **text** field's value as a string; send a **choice** field's value as the **numeric choice id**. Key items take no `fields`. Discover an item's `item_id`, product type, quantity bounds and field definitions from the catalog export (see the **Placing orders** guide).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

item_idintegerRequired

The numeric item id.

quantitydoubleOptional

Integer count for key items (default 1); decimal amount for top-up items (required); omit for service items.

merchant_order_idstringOptional<=100 characters

Your reference id, unique per account (optional).

fieldsmap from strings to anyOptional

Item input fields (top-up / service only), keyed by field name. Text fields take a string; choice fields take the numeric choice id.

Response

Order accepted; fulfillment is in progress.

idstringformat: "uuid"

The order id.

iteminteger

Numeric item id.

item_namestring

item_product_typeenum

quantitydouble

delivered_quantityinteger

Units delivered so far (relevant for key items / partials).

pricedouble

Amount charged, in major currency units.

refund_amountdouble

Amount refunded for undelivered units (partial / failed).

fieldsmap from strings to strings

The submitted input fields (choice values shown as their display name).

statusenum

errorstring

Machine error code when status = failed (e.g. OUT_OF_STOCK); otherwise empty.

error_messagestring

Human-readable error message when failed; otherwise empty.

codeslist of strings

Delivered key/code strings (key items only).

merchant_order_idstring

sourceenum

created_byobject or null

created_atdatetime

completed_atdatetime or null

Errors

400

Bad Request Error

401

Unauthorized Error

Places an order for an item and charges your balance. Returns 201 immediately with status: "pending"; the final result arrives via your webhook and is readable from GET /api/v1/orders/{id}.

Request fields

item_id (required) — the numeric item id.
quantity — required for top-up items (a decimal amount) and for key items (an integer count, defaults to 1); omit for service items (always 1). Must be within the item’s min/max range.
merchant_order_id (optional) — your own idempotency/reference string, unique per account.
fields — required for top-up and service items only, keyed by the item’s field names. Send a text field’s value as a string; send a choice field’s value as the numeric choice id. Key items take no fields.

Discover an item’s item_id, product type, quantity bounds and field definitions from the catalog export (see the Placing orders guide).

$	curl -X POST https://api.voodoo.center/api/v1/orders \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"item_id": 4211,
>	"quantity": 10,
>	"merchant_order_id": "po-10232",
>	"fields": {
>	"player_id": "123456789",
>	"server": 17
>	}
>	}'

1	{
2	"id": "0190f8a1-6b2c-7e33-9a10-4c1d2e3f5a6b",
3	"item": 4211,
4	"item_name": "Sample Game Top-up",
5	"item_product_type": "topup",
6	"quantity": 10,
7	"delivered_quantity": 0,
8	"price": 12.5,
9	"refund_amount": 0,
10	"fields": {
11	"player_id": "123456789",
12	"server": "Europe (EU-West)"
13	},
14	"status": "pending",
15	"error": "",
16	"error_message": "",
17	"codes": [],
18	"merchant_order_id": "po-10232",
19	"source": "api",
20	"created_by": {
21	"id": "0190f8a0-1111-7000-8000-000000000001",
22	"email": "[email protected]"
23	},
24	"created_at": "2026-07-05T12:00:00Z",
25	"completed_at": null
26	}