Эндпоинты тарифов и оплаты

Просмотр доступных тарифов, создание платежа и история платежей. Платежи обрабатываются через AffiCat Pay. Подробности о тарифах и льготном периоде — в разделе Оплата и тарифы.

Список тарифов

GET /api/tariff/list.json

Возвращает все доступные тарифы.

{
  "status": "ok",
  "data": [
    { "code": "kitten", "name": "Kitten", "campaigns": 1,  "price_usd": 0,  "price_rub": 0    },
    { "code": "cat",   "name": "Kitty", "campaigns": 15, "price_usd": 24, "price_rub": 2400 },
    { "code": "tiger", "name": "Tiger", "campaigns": -1, "price_usd": 88, "price_rub": 8800 }
  ]
}

campaigns равен -1 для тарифа Tiger (безлимитный). Цены — целые числа: доллары USD и рубли RUB. Бесплатный тариф Kitten имеет price_usd: 0.

Купить тариф

POST /api/tariff/buy.json

Создаёт счёт на оплату и возвращает URL для редиректа на AffiCat Pay. Перенаправьте пользователя на этот URL для завершения платежа. Для бесплатного тарифа Kitten подписка активируется мгновенно, URL редиректа не возвращается.

{
  "status": "ok",
  "data": {
    "url": "https://pay.affi.cat/…"
  }
}

После оплаты AffiCat Pay уведомляет наш сервер через push-постбэк, и подписка продлевается автоматически. Дашборд также получает подтверждение, когда пользователь возвращается со страницы оплаты — оба пути идемпотентны.

Накопление: платные тарифы продлеваются от текущей даты истечения, а не от сегодняшнего дня. При досрочном продлении оставшиеся дни не теряются.

Приём постбэка от платёжной системы

POST /api/pay/acp

Эндпоинт для push-подтверждения от AffiCat Pay — вызывается автоматически платёжным шлюзом при завершении платежа. Самостоятельно вызывать не нужно.

Проверить статус платежа

GET /api/pay/check

Pull-подтверждение платежа через запрос к шлюзу. Вызывается автоматически, когда пользователь возвращается со страницы AffiCat Pay. Самостоятельно вызывать не нужно.

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

GET /api/pay/list.json

Возвращает историю ваших платежей, от новых к старым.

{
  "status": "ok",
  "data": [
    {
      "id": 55,
      "tariff": "cat",
      "tariff_name": "Kitty",
      "price_usd": 24,
      "price_rub": 2400,
      "status": 1,
      "created": "2026-05-01 15:00:00",
      "paid": "2026-05-01 15:02:00"
    }
  ]
}

paid равен "0000-00-00 00:00:00" для ожидающих или отменённых счетов.