Справочник APIГарантия

Подать заявку по гарантии

POSThttps://api.astrum.shop/v1/orders/{order_id}/claims
Область orders:write

Подписка пропала, не тот тариф или ключ не работает — в течение 7 дней после выдачи. Скриншот обязателен, почта аккаунта клиента — у подписок.

Решаем мы: перезапуск новым ключом или возврат на баланс. Решение — вебхуком order.updated (warranty.claim_status в заказе) и в GET /v1/claims/{claim_id}.

Параметры

order_id
в пути · uuid · обязательно

Номер заказа из ответа POST /v1/orders или списка.

Тело запроса

application/json
problem
string · обязательно

Что случилось:

not_working
подписки нет или ключ не работает
wrong_plan
включился не тот тариф
other
другое — опишите в comment
wish
string · обязательно

Чего хотите:

restart
перезапустить: новый ключ, лучше другого поставщика
refund
вернуть деньги на баланс

Перезапуск есть у способов activation, key и account; у card_payment и new_account — только возврат.

account_email
string | null

Почта аккаунта клиента — обязательна у подписок (activation, card_payment): по ней сверяем скриншот.

comment
string | null

Что ещё важно знать — до 1000 символов.

screenshot_base64
string · обязательно

Скриншот страницы тарифа в аккаунте клиента (или ключа с ошибкой) — PNG, JPEG или WebP до 10 МБ, в base64. Без него заявку не принимаем.

Ответы

claim_id
string

Номер заявки.

order_id
string

Заказ, по которому заявка.

status
string

Статус заявки:

open
ждёт решения
restarted
перезапустили — новым ключом; клиенту, может быть, нужно снова прислать данные
refunded
деньги вернулись на баланс
refused
отказали — причина в refuse_reason
problem
string

Что случилось:

not_working
подписки нет или ключ не работает
wrong_plan
включился не тот тариф
other
другое — опишите в comment
wish
string

Чего хотели:

restart
перезапустить: новый ключ, лучше другого поставщика
refund
вернуть деньги на баланс
refuse_reason
string | null

Почему отказали; иначе null:

account_banned
аккаунт клиента заблокирован — гарантией не покрывается
plan_present
подписка на месте
wrong_screenshot
скриншот не о том
window_closed
гарантия закончилась
account_email
string | null

Почта аккаунта клиента из заявки; через 90 дней после решения стирается.

comment
string | null

Ваш комментарий.

created_at
string

Когда подана, UTC.

decided_at
string | null

Когда решена, UTC; null — ещё ждёт.

warranty_until
string | null

До какого времени действовала гарантия на момент заявки.

Общие для всех методов — подробно в разделе «Коды ошибок»:

10001 invalid_key10002 key_scope_missing10003 ip_not_allowed10004 browser_not_allowed10005 account_suspended20001 too_many_requests90002 api_disabled90001 internal_error
тестовые USDT,
ключ ask_test_…
curl https://api.astrum.shop/v1/orders/$ORDER_ID/claims -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "problem": "not_working",
    "wish": "restart",
    "account_email": "client@example.com",
    "comment": "Вчера был Plus, сегодня Free",
    "screenshot_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  }'
Ответ
{
  "claim_id": "5c2e9a41-7d3b-4e8f-a1c6-2b9d0e4f7a13",
  "order_id": "b1e04c6e-5a0b-4f6e-9a39-0b9f2f1c8d21",
  "status": "open",
  "problem": "not_working",
  "wish": "restart",
  "refuse_reason": null,
  "account_email": "client@example.com",
  "comment": "Вчера был Plus, сегодня Free",
  "created_at": "2026-10-08T09:41:27Z",
  "decided_at": null,
  "warranty_until": "2026-10-12T10:20:44Z"
}