Задержки уведомлений и восстановление заказов
Webhook дополняет проверку заказа, но не заменяет её.
Принимающая сторона
Укажите свой доступный HTTPS-адрес, проверяйте подпись и event_id по документации. Быстро подтверждайте получение, а обработку выполняйте асинхронно. Не указывайте наш сайт как адрес приёма.
Пропущенные обновления
Общий webhook и webhook API-ключа охватывают разные события. При ошибках есть повторы, но отсутствие уведомления не означает отказ заказа. Используйте запрос заказов аккаунта с updated_after и пагинацией, удаляйте дубли по event_id и ID заказа.
Настройка получателя
Укажите собственный сервис в настройках уведомлений.
- Используйте доступный извне HTTPS-адрес.
- Выберите нужные источники заказов и события.
- Реализуйте проверку подписи, идентификатора и объекта по текущей документации.
- Надёжно сохраните событие и быстро ответьте успешным статусом, затем обработайте его асинхронно.
Нужен URL вашего обработчика, а не главная страница zovocard.
Дубликаты и порядок событий
Уведомления могут повторяться или приходить в другом порядке.
- Удаляйте повторы по event_id или идентификатору, указанному для API.
- Дополнительно защищайте зачисление или выдачу по номеру заказа либо транзакции.
- При неопределённом событии сначала запросите текущее состояние платформы.
Если уведомление не пришло
Проверьте URL, HTTPS, фильтры шлюза и журнал получателя. Убедитесь, что подписка включает источник заказа: область аккаунта и отдельного Key может различаться. Заполняйте пропуски документированными запросами и пагинацией по времени обновления, сохраняя идентификаторы для поддержки.