Рекуррентные платежи

Отмена подписки

Останавливает будущие автоматические списания и переводит подписку в финальный статус cancelled

POST/integration/subscriptions/{uuid}/cancel
ПолеТипОписание
uuidобязательноеuuidUUID подписки Cashera

Тело запроса не требуется. Используйте UUID подписки Cashera и API-ключ её владельца. Чужая или неизвестная подписка возвращает 404 до запроса к провайдеру. Передача merchant_id или идентификатора провайдера в теле не меняет владельца и цель отмены.

200 OK
curl -X POST https://api.cashera.cash/api/v1/integration/subscriptions/31dc7faa-c380-4ec7-a258-3202a2211e76/cancel \
-H "X-Api-Key: $CASHERA_API_KEY" \
-H "Accept: application/json"
Идемпотентная отмена

Повторная отмена уже отменённой подписки безопасна и возвращает тот же объект сstatus = cancelled. Для подписки в другом финальном статусе или без подтверждённого идентификатора провайдера возвращается 409 Conflict.

Ориентируйтесь на подтверждённый status: cancelled. Поле next_charge_at может содержать сохранённую старую дату: она не означает, что отменённая подписка продолжает плановые списания.

Отмена не возвращает прошлые платежи

Метод прекращает только будущие списания. Уже оплаченные транзакции не отменяются и не возвращаются. Ранее принятая попытка может ещё получить финальный результат; проверяйте её транзакцию отдельно. После отмены не запускайте update или charge-now.