Отменить подписку

Состояние конечное: возобновить отменённую подписку нельзя, вместо этого заводят новую. Незакрытый период уходит в `cancelled`, счёт по нему не выставляется.

POST/v1/subscriptions/{id}/cancel

Состояние конечное: возобновить отменённую подписку нельзя, вместо этого заводят новую. Незакрытый период уходит в cancelled, счёт по нему не выставляется.

Авторизация

apiKey

АвторизацияBearer <token>

Заголовок Authorization: Bearer <ключ>, например Authorization: Bearer plt_ExampleKeyDoNotUseExampleKeyDoNotUse01. Название схемы сравнивается без учёта регистра. Ключ начинается с plt_; храним мы только его SHA-256, поэтому потерянный ключ не восстанавливается — он перевыпускается.

In: header

Параметры пути

id*string

Идентификатор подписки.

Formatuuid

Заголовки

Idempotency-Key*string

Ключ повтора. Тот же ключ с тем же телом не выполняет операцию заново: возвращается сохранённый ответ и код 200 вместо 201. Живёт 24 часа.

Length1 <= length <= 255

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/subscriptions/d4e5f607-8192-4a34-bb5c-6d7e8f901234/cancel" \  -H "Idempotency-Key: order-4815162342"

{  "id": "d4e5f607-8192-4a34-bb5c-6d7e8f901234",  "status": "cancelled",  "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"}

Отменить подписку

Авторизация

Параметры пути

Заголовки

Тело ответа

200application/json

4XXapplication/json

`application/json`

`application/json`