Получить подписку
/v1/subscriptions/{id}Авторизация
apiKey Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.
In: header
Параметры пути
Идентификатор подписки.
uuidТело ответа
application/json
application/json
curl -X GET "https://example.com/v1/subscriptions/d4e5f607-8192-4a34-bb5c-6d7e8f901234"{ "id": "d4e5f607-8192-4a34-bb5c-6d7e8f901234", "status": "active", "amount": { "amount": "49900", "currency": "RUB" }, "period": { "unit": "month", "count": 1 }, "description": "Подписка «Про», ежемесячно", "method": "card", "methodMask": "4488 22** **** 4213", "metadata": { "plan": "pro" }, "startedAt": "2026-08-19T10:20:00Z", "nextChargeAt": "2026-09-19T10:20:00Z", "lastChargedAt": "2026-08-19T10:20:07Z", "cyclesStarted": 1, "createdAt": "2026-08-19T10:20:00Z"}Создать подписку
`providerMethodRef` — токен сохранённого способа у провайдера, который вернула первая оплата. Номера карты в этом поле не будет никогда: PAN живёт ровно один вызов от формы оплаты до провайдера. Списывать по сохранённому способу умеет не всякий провайдер. Мы спрашиваем об этом здесь, а не при первом списании: если способ, подключённый вашему проекту, так не умеет, `422 method_unavailable` приходит сразу — а не через месяц, отсутствием оплат.
Периоды подписки
Все периоды подписки, от первого к последнему, без пагинации. Здесь видно, за что списали и почему не списали.