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 для подписи. Он показывается только один раз; сохраните его в окружении своего сервера.
Смена секрета выполняется только в панели управления.