Docs

Налаштування webhook

HTTPS endpoint та одноразовий секрет.

У кабінеті Розробники → Webhooks додайте публічний HTTPS endpoint свого сервера. Збережіть secret і keyId одразу: секрет показується один раз.

Обробник приймає POST, зберігає початкові UTF-8 байти з обмеженням 256 КіБ, перевіряє всі заголовки v2 і HMAC до використання JSON, усуває дублікати X-Event-Id у постійному сховищі й відповідає 2xx після надійного збереження.

Ротація видає новий секрет і key ID для майбутніх доставок. Створені доставки зберігають старий знімок підпису, тому зберігайте попередні нескомпрометовані ключі за X-Key-Id.

Для створення платежу потрібен активний endpoint. Для видачі нового Live-ключа додатково потрібен успішний тест поточної конфігурації кожного активного Live endpoint. Після зміни налаштувань або секрету повторіть тест.