Документация
Справочник APIЗаказы

Создать и оплатить заказ авансом

POSThttps://api.astrum.shop/v1/orders
Область orders:writeПовтор — по reseller_ref

Списывает оптовую сумму с аванса и выдаёт товар в той же операции. Товара в ответе нет — только в GET /v1/orders/{id}. Повтор с тем же reseller_ref и телом возвращает тот же заказ.

Тело запроса

application/json
reseller_refstringобязательно

Ваш номер заказа — печатный ASCII до 64 знаков. Он же ключ повтора: сохраните его до запроса.

itemsarrayобязательно

Строки заказа, до 50. Пара «товар + вариант» — одна строка: дубль — 422 duplicate_line.

new_accountboolean

«Новый аккаунт от нас» — только для оплаты нашей картой; надбавка — new_account_fee_usd в каталоге.

max_total_usdstring | null

Потолок суммы. Цена выросла выше — 409 price_changed с новой суммой, аванс не тронут.

metadataobject | null

Ваши данные к заказу, до 1 КБ JSON. Возвращаются в заказе и событиях.

Ответы

Успешно

idНомер заказа.
reseller_refВаш номер заказа.
statuspending, paid, delivered, canceled или refunded.
fulfillmentЧто с активациями: complete, awaiting_customer, in_progress, manual или failed.
total_usdСписано с аванса.
metadataВаши данные к заказу.
linesСтроки с ценой за единицу и итогом.
goods_readyТовар можно забрать из GET /v1/orders/{id}.
activationsАктивации, если товару нужны данные клиента.
refundsВозвраты на аванс.
created_atstring
paid_atstring | null
delivered_atstring | null

Общие для всех методов: 401 unauthenticated, 403 scope_missing, 403 ip_not_allowed, 403 account_suspended, 429 rate_limited, 503 api_disabled, 500 internal_error. Подробно — в разделе «Ошибки».

тестовые доллары,
ключ ask_test_…
curl https://api.astrum.shop/v1/orders -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reseller_ref": "ord-10482",
    "items": [
      {
        "product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11",
        "quantity": 1,
        "item_ref": "line-1"
      }
    ],
    "max_total_usd": "25.00",
    "metadata": {
      "customer": "c-7781"
    }
  }'
Ответ
{
  "id": "b1e04c6e-5a0b-4f6e-9a39-0b9f2f1c8d21",
  "reseller_ref": "ord-10482",
  "status": "delivered",
  "fulfillment": "complete",
  "total_usd": "20.00",
  "metadata": {
    "customer": "c-7781"
  },
  "lines": [
    {
      "item_ref": "line-1",
      "product_id": "3f6c0e7e-2b1d-4c1a-9a57-4d0f1b8e2c11",
      "variant_id": null,
      "title": "ChatGPT Plus · 1 месяц",
      "delivery_type": "activation",
      "subscription_days": 30,
      "new_account": false,
      "quantity": 1,
      "unit_usd": "20.00",
      "line_usd": "20.00"
    }
  ],
  "goods_ready": true,
  "activations": [],
  "refunds": [],
  "created_at": "2026-09-24T10:14:03Z",
  "paid_at": "2026-09-24T10:14:03Z",
  "delivered_at": "2026-09-24T10:14:04Z"
}