Tariffs & billing endpoints

List available plans, start a payment, and view payment history. Payments are processed through AffiCat Pay. See Billing & tariffs for plan details and the full grace period rules.

List tariffs

GET /api/tariff/list.json

Returns all available plans.

{
  "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 is -1 for the Tiger (unlimited) plan. Prices are integers: USD dollars and RUB rubles. The free Kitten plan has price_usd: 0.

Buy a plan

POST /api/tariff/buy.json

Creates a payment invoice and returns the AffiCat Pay redirect URL. Redirect the user to that URL to complete the payment. For the free Kitten plan, the subscription is activated instantly and no redirect URL is returned.

Parameter	Description
`tariff`	Plan code: `kitten`, `cat`, or `tiger`

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

After the user pays, AffiCat Pay notifies our server via a push postback and the subscription is extended automatically. The dashboard also pulls confirmation when the user returns from the payment page — both paths are idempotent.

Stacking: paid plans extend from the current expiry date, not from today. If you renew early you do not lose remaining days.

Error	Meaning
`active`	A paid plan is still running with more than 3 days left; you can only switch or renew in the final 3 days

Payment postback receiver

POST /api/pay/acp

AffiCat Pay’s push confirmation endpoint — called automatically by the payment gateway when a payment completes. You do not need to call this yourself.

Check payment status

GET /api/pay/check

Pull-confirms a payment by querying the gateway. Called automatically when the user returns from the AffiCat Pay page. You do not need to call this yourself.

Parameter	Description
`uid`	Payment id (appended to the return URL by the gateway)

Payment history

GET /api/pay/list.json

Returns your payment history, newest first.

{
  "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"
    }
  ]
}

`status`	Meaning
`0`	Pending — invoice created, payment not yet confirmed
`1`	Paid
`2`	Cancelled or expired

paid is "0000-00-00 00:00:00" for pending or cancelled invoices.

Transfer FAQ