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

Отправить данные клиента

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

То, что прислал клиент, — целиком. Что просить — activation.customer_data_type и customer_instruction заказа; при оплате нашей картой вторым шагом сюда же — ссылка из письма.

Формат проверяется до сервиса: не подошёл — 60005 invalid_customer_data, message готов для клиента.

Каждая отправка уходит к сервису — не зовите в цикле.

Параметры

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

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

Тело запроса

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

То, что прислал клиент, — целиком, как есть: что именно просить, говорит activation.customer_data_type заказа.

Ответы

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 — у способа страницы нет. Открывает только активацию этого заказа.

warning
object | null

Данные приняты, но формат непривычный — переспросите клиента. Обычно null.

↳code
integer

Номер предупреждения.

↳name
string

Имя предупреждения — то же, что code, словами.

↳message
string

Что не так — по-русски.

С предупреждением: 60100 customer_data_unusual — Формат непривычный — проверьте, что прислали нужное

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

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/activate -X POST \
  -H "Authorization: Bearer $ASTRUM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_data": "7f3c2a10-4b5e-4c6d-8e9f-0a1b2c3d4e5f"
  }'