ZovoCard Помощь и блог

Задержки уведомлений и восстановление заказов

Webhook дополняет проверку заказа, но не заменяет её.

Обновлено 2026-09-28

Принимающая сторона

Укажите свой доступный HTTPS-адрес, проверяйте подпись и event_id по документации. Быстро подтверждайте получение, а обработку выполняйте асинхронно. Не указывайте наш сайт как адрес приёма.

Пропущенные обновления

Общий webhook и webhook API-ключа охватывают разные события. При ошибках есть повторы, но отсутствие уведомления не означает отказ заказа. Используйте запрос заказов аккаунта с updated_after и пагинацией, удаляйте дубли по event_id и ID заказа.

Настройка получателя

Укажите собственный сервис в настройках уведомлений.

  1. Используйте доступный извне HTTPS-адрес.
  2. Выберите нужные источники заказов и события.
  3. Реализуйте проверку подписи, идентификатора и объекта по текущей документации.
  4. Надёжно сохраните событие и быстро ответьте успешным статусом, затем обработайте его асинхронно.

Нужен URL вашего обработчика, а не главная страница zovocard.

Дубликаты и порядок событий

Уведомления могут повторяться или приходить в другом порядке.

  1. Удаляйте повторы по event_id или идентификатору, указанному для API.
  2. Дополнительно защищайте зачисление или выдачу по номеру заказа либо транзакции.
  3. При неопределённом событии сначала запросите текущее состояние платформы.

Если уведомление не пришло

Проверьте URL, HTTPS, фильтры шлюза и журнал получателя. Убедитесь, что подписка включает источник заказа: область аккаунта и отдельного Key может различаться. Заполняйте пропуски документированными запросами и пагинацией по времени обновления, сохраняя идентификаторы для поддержки.

Перейти к функции ↗