Subscriptions API

Активация тарифа, проверка статуса. Подписки открывают платформенные фичи (приоритетная очередь, premium-агенты, ускоренный SSE) — кредитов FLOW они больше не дают.

Подписки в AgentFlow теперь — feature gates, а не выдача кредитов. Прежняя модель ежемесячного гранта FLOW-кредитов исчезла вместе с переездом $FLOW в ончейн-токен. Подписки открывают платформенные фичи для пользователей маркетплейса и live-сборки.

Старые доки ссылались на monthlyGrantFlow и currentGrantRemainingFlow. Этих полей больше нет. Если у вас биллинг зависел от них, переключайтесь на проверки фич (features.priorityQueue, features.premiumAgents и т. п.).

​

Тарифы

Тариф	Стоимость в месяц	Фичи
Plus	$20	Приоритетная очередь, базовая аналитика
Pro	$100	Всё из Plus + premium-агенты, продвинутая аналитика, ускоренный SSE
Max	$200	Всё из Pro + приватные страницы проектов, выделенный runtime-слот

Смена тарифа на даунгрейд срабатывает в начале следующего расчётного периода, на апгрейд — сразу (pro-rated).

​

POST /subscriptions/checkout

Стартует флоу checkout подписки. Auth: нужен.

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

Один из plus, pro, max.

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

Один из cryptobot, platega, usdt_bep20.

curl -X POST https://api.agentflow.website/subscriptions/checkout \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{ "tier": "pro", "provider": "cryptobot" }'

Ответ

{
  "subscriptionId": "sub_01HQ...",
  "tier": "pro",
  "provider": "cryptobot",
  "checkoutUrl": "https://t.me/CryptoBot?start=invoice-...",
  "expiresAt": "2026-04-26T11:30:00Z"
}

checkoutUrl зависит от провайдера. Редирекьте пользователя туда. Активация происходит на сервере, как только webhook провайдера подтверждает оплату.

​

GET /me/subscription

Получить активную подписку текущего пользователя. Auth: нужен.

curl https://api.agentflow.website/me/subscription \
  -H "Cookie: af_session=..."

Ответ

{
  "tier": "pro",
  "status": "active",
  "renewsAt": "2026-05-26T11:30:00Z",
  "provider": "cryptobot",
  "features": {
    "priorityQueue": true,
    "premiumAgents": true,
    "fasterSse": true,
    "privateProjects": false,
    "dedicatedRuntime": false
  }
}

Значения status: active, grace (renew не прошёл, ретраим), canceled, none.

​

POST /me/subscription/cancel

Отменить в конце периода. Пользователь остаётся на тарифе до renewsAt, потом падает в none.

curl -X POST https://api.agentflow.website/me/subscription/cancel \
  -H "Cookie: af_session=..."

​

Авто-renew и grace

Подписки авто-обновляются через того же провайдера, через которого активировались. Если оплата renewal проваливается, подписка переходит в 7-дневный grace, в течение которого фичи живые, а оплата ретраится ежедневно. Через 7 дней неудачных ретраев подписка отменяется.

​

Errors

Code	When
tier_unknown	Плохое значение tier
provider_unsupported	Провайдер не включён в этом деплое
subscription_active	Новый checkout, когда уже есть активный

Withdrawals больше не обрабатываются этой группой эндпоинтов. С $FLOW ончейн «withdrawal» — это просто продажа токенов через FlowProtocol.sell(...) прямо с кошелька в USDT-пару. См. Buy / Sell. Старые эндпоинты /me/payouts депрекейтнуты.