Plateshka
APIПодписки

Возобновить подписку

Тело необязательно, но из `past_due` подписка выходит только с новым `providerMethodRef`: прежний способ уже отказал столько раз, сколько мы пробовали, и повтор с ним кончится тем же. Отменённая подписка не возобновляется — заводят новую.

POST/v1/subscriptions/{id}/resume

Тело необязательно, но из past_due подписка выходит только с новым providerMethodRef: прежний способ уже отказал столько раз, сколько мы пробовали, и повтор с ним кончится тем же. Отменённая подписка не возобновляется — заводят новую.

Авторизация

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

TypeScript Definitions

Use the request body type in TypeScript.

Тело возобновления. Целиком необязательно, но из past_due без нового способа оплаты не выйти.

Тело ответа

application/json

application/json

curl -X POST "https://example.com/v1/subscriptions/d4e5f607-8192-4a34-bb5c-6d7e8f901234/resume" \  -H "Idempotency-Key: order-4815162342" \  -H "Content-Type: application/json" \  -d '{    "providerMethodRef": "pm_ExampleStoredMethodDoNotUse2",    "methodMask": "5536 91** **** 7701"  }'
{  "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"}

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

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

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

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