Оплата и пакеты

Платные пакеты снимают дневной free-лимит и расходуют общий объём изображений из активной подписки.

Доступные plan_code

plan_code	Квота	Срок	Используется в кабинете
`pro_year_500k`	500 000 изображений	365 дней	да
`pro_month_50k`	50 000 изображений	30 дней	да
`pro_month_100k`	100 000 изображений	30 дней	да

Создать платеж

POST /v1/billing/yookassa/create-payment

curl -X POST "https://imgfix.ru/v1/billing/yookassa/create-payment" \
  -H "Content-Type: application/json" \
  --cookie "sid=..." \
  -d '{ "plan_code": "pro_month_50k" }'

{
  "payment_id": "2f4...",
  "confirmation_url": "https://yoomoney.ru/checkout/...",
  "status": "pending",
  "amount": "1490.00",
  "currency": "RUB",
  "plan_code": "pro_month_50k"
}

После получения confirmation_url переведите пользователя на страницу оплаты YooKassa.

Статус оплаты пользователя

GET /v1/billing/status

{
  "is_paid": true,
  "subscription_active": true,
  "active_subscription": {
    "plan_code": "pro_month_50k",
    "total_quota": 50000,
    "used_quota": 120,
    "end_at": "2026-06-16T00:00:00Z"
  },
  "latest_payment": {
    "payment_id": "2f4...",
    "status": "succeeded"
  }
}

История платежей

GET /v1/billing/payments?limit=20&cursor=...

Параметр	Тип	Описание
`limit`	int	Количество записей, максимум 200.
`cursor`	string	Курсор следующей страницы из `next_cursor`.

Активация подписки

Подписка активируется после webhook от YooKassa. Для диагностики webhook-событий используйте серверные логи и страницу Billing Webhook.