Перейти к основному содержанию

​
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-25T11:30:00Z"
}
checkoutUrl зависит от провайдера. Перенаправьте пользователя туда. Активация происходит на сервере, когда вебхук провайдера подтвердит платёж.

​
GET /me/subscription

Получить активную подписку текущего пользователя. Auth: требуется. 
curl https://api.agentflow.website/me/subscription \
  -H "Cookie: af_session=..."
Ответ 
{
  "tier": "pro",
  "status": "active",
  "monthlyGrantFlow": 100,
  "currentGrantRemainingFlow": 73.4,
  "renewsAt": "2026-05-25T11:30:00Z",
  "provider": "cryptobot"
}
Значения status: active, grace (продление не прошло, ретраим), canceled, none.

​
POST /me/payouts/request

Вывести FLOW. Полный поток — в Выплатах.
​
amountFlow
number
обязательно
Сумма во FLOW. Должна быть ≤ withdrawable-баланса.
​
rail
string
обязательно
usdt_bep20, cryptobot или manual.
​
address
string
Обязательно для usdt_bep20.
curl -X POST https://api.agentflow.website/me/payouts/request \
  -H "Content-Type: application/json" \
  -H "Cookie: af_session=..." \
  -d '{ "amountFlow": 100, "rail": "usdt_bep20", "address": "0x..." }'

​
GET /me/payouts

Список выплат пользователя. 
curl https://api.agentflow.website/me/payouts \
  -H "Cookie: af_session=..."
Ответ: массив объектов выплат с id, amountFlow, feeFlow, rail, status, createdAt.

​
GET /me/payouts/:id

Детали одной выплаты, включая rail-специфичный tx-хеш для sent или confirmed.

​
POST /me/payouts/:id/cancel

Отменить pending-выплату и вернуть FLOW на баланс.

​
Ошибки

КодКогда
tier_unknownНеверное значение тарифа
provider_unsupportedПровайдер не включён в этом развёртывании
subscription_activeНовый checkout, когда уже активен
withdraw_too_lowМеньше минимума рельса
withdraw_too_highБольше withdrawable-баланса
address_requiredНе указан address для on-chain рельса
payout_immutableОтмена попыталась на sent/confirmed