Перейти к основному содержанию
Вебхуки отправляют HTTP-запрос POST на ваш сервер, когда в магазине что-то происходит, поэтому вам не нужно опрашивать API. Создавайте эндпоинты в разделе Разработчикам › Вебхуки или с помощью POST /webhooks.

События

GET /events/types возвращает тот же список.

Данные события

Суммы в вебхуках указываются в основных единицах (34.99), в отличие от API, где используются минимальные единицы (3499).

Проверьте подпись

Каждый запрос содержит следующие заголовки: Подпись вычисляется как HMAC-SHA256(secret, "<t>.<raw body>") в шестнадцатеричном виде. Секрет (whsec_...) показывается при создании эндпоинта. Вычисляйте подпись по сырому телу запроса, до разбора JSON, и отклоняйте устаревшие метки времени.

Ответ и повторные попытки

  • Ответьте любым статусом 2xx в течение 10 секунд. Медленную работу выполняйте после ответа.
  • Неудачные доставки повторяются через 1 минуту, 5 минут, 30 минут, 2 часа, 6 часов и 12 часов (7 попыток примерно за 21 час).
  • Эндпоинт отключается после 40 неудач подряд без единого успеха за 3 дня. Включите его снова в панели управления или через PATCH /webhooks/{id} с enabled: true.
  • Одно и то же событие может прийти несколько раз. Используйте PapelShip-Event-Id, чтобы обработать его один раз.

Управление эндпоинтами через API

Ответ содержит secret для подписи. Он показывается только один раз; сохраните его в окружении своего сервера. Смена секрета выполняется только в панели управления.