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

Включить поверх текущей подписки

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

Только с согласия клиента: оставшиеся дни его текущей подписки сгорят.

Согласие записывается к заказу. Можно ли — force в available_actions.

Параметры

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

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

Тело запроса

application/json
customer_agreed
true · обязательно

Только true: клиент согласен, что оставшиеся дни его текущей подписки сгорят.

Ответы

order_id
string

Номер заказа — его выдаём мы.

product_id
string | null

Товар из каталога.

product_name
string | null

Название товара на момент заказа.

delivery_method
string | null

Способ выдачи — как в каталоге.

subscription_days
integer | null

Срок подписки в днях; null — не подписка.

status
string

Статус заказа:

completed
выдан или подписка включена
waiting
ждём клиента
processing
работаем
failed
не получилось
canceled
отменён, деньги вернулись на баланс
refunded
возврат по претензии
status_text
string

Что происходит — текст клиенту, показывайте как есть.

price_usdt
string | null

Списано с баланса.

refunded_usdt
string | null

Вернулось на баланс.

created_at
string

Когда создан, UTC.

available_actions
array

Что можно сделать с заказом сейчас; пусто — ничего:

activate
отправить данные клиента
retry
повторить на уже отправленных данных
force
включить поверх текущей подписки клиента — с его согласия
cancel
отменить заказ и вернуть деньги на баланс
activation
object | null

Активация подписки: что спросить у клиента и что с ней сейчас. Есть у способов activation, card_payment и new_account; у ключа и готового аккаунта — null.

↳customer_data_type
string | null

Что прислать от клиента, когда заказ ждёт данные; иначе null:

chatgpt_session
весь текст страницы сессии ChatGPT
claude_org_id
Organization ID аккаунта Claude
claude_session_key
session key Claude, начинается с sk-ant-sid02-
grok_user_id
ID аккаунта Grok или весь текст его страницы сессии
x_account_id
ID аккаунта X для покупок — из закладки на x.com, не имя и не номер
account_email
почта аккаунта Claude: первый шаг оплаты нашей картой
login_link
ссылка входа из письма Anthropic: второй шаг оплаты нашей картой

Что сказать самому клиенту — в customer_instruction.

↳customer_instruction
string | null

Что сделать клиенту — текст ему, показывайте как есть.

↳verification_link
string | null

Сервис просит клиента пройти проверку по этой ссылке; иначе null. Ведёт только на домены сервиса.

↳current_plan_until
string | null

До какого дня действует текущая подписка клиента, если известно.

↳note_to_customer
string | null

Сообщение от нас клиенту — когда пауза не описывается статусом. Показывайте как есть.

↳page_url
string | null

Страница активации этого заказа: клиент сам присылает данные и видит статус. Отдайте ссылку клиенту или покажите виджетом; 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/force -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_agreed": true
  }'