Справочник

Статусы подписок

Состояния подписки от создания и подтверждения клиента до отмены или завершения с ошибкой

creating
Создаётся · промежуточный
Cashera зарегистрировала запрос и создаёт подписку у платёжного провайдера
creation_unknown
Результат создания неизвестен · промежуточный
Провайдер не дал однозначный ответ. Не создавайте замену автоматически и обратитесь в поддержку
pending_agreement
Ожидает подтверждения · промежуточный
Подписка создана, подтверждение ещё не завершено. confirmation_url может быть null, если ссылку не удалось получить
active
Активна · промежуточный
Согласие получено, автоматические списания выполняются по заданному интервалу
past_due
Есть проблема со списанием · промежуточный
Последнее списание не состоялось. Подписка может вернуться в active после успешного списания
cancelled
Отменена · финальный
Подписка отменена, новые автоматические списания не выполняются
failed
Завершена с ошибкой · финальный
Подписка завершена провайдером с ошибкой и больше не используется
active не подтверждает оплату

active подтверждает согласие клиента и действующую подписку, но не конкретное списание. Результат каждого периода проверяйте по транзакции со статусом paid.

Не смешивайте подписку и платёж

canceled у платежа и cancelled у подписки относятся к разным объектам. Неудачный платёж не означает, что подписка отменена.past_due может сохраняться без новой назначенной даты; API не устанавливает универсального срока автоматической отмены. Для остановки будущих списаний выполните отмену.

Изменение условий и внеочередное списание доступны только для active и past_due при остальных выполненных условиях. Они не возобновляют cancelled или failed и не заменяют подтверждение привязки. При ошибках используйте порядок восстановления.

Изменения приходят событием subscription.status_updated и доступны через методы получения подписки.