Приостановить подписку

Списания прекращаются до возобновления. Пропущенные за паузу периоды потом не догоняются: пауза означала «не берите деньги», и списание за три неоказанные услуги — самый короткий путь к трём чарджбэкам подряд.

POST/v1/subscriptions/{id}/pause

Авторизация

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/pause" \  -H "Idempotency-Key: order-4815162342"

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