Подпись webhook

Каждый webhook подписан, чтобы вы могли убедиться, что он отправлен KassaGO и не был изменён. Подпись передаётся в заголовке x-api-sha256-signature.

Каким ключом подписано

WebhookКлюч
ПлатёжДополнительный ключ кассы
ВыплатаДополнительный ключ пользователя
Ключ
Дополнительный ключ кассы
Ключ
Дополнительный ключ пользователя

Алгоритм

  1. Разберите тело запроса как JSON.
  2. Отсортируйте ключи по алфавиту (A–Z, затем a–z).
  3. Сериализуйте объект обратно в компактный JSON — без пробелов, без экранирования слешей и unicode-символов.
  4. Вычислите HMAC-SHA256 от полученной строки дополнительным ключом и переведите результат в hex.
  5. Сравните результат с заголовком x-api-sha256-signature. Используйте сравнение за постоянное время.

Пример расчёта

Строка для подписи (ключи отсортированы, без пробелов)

  1. 1.{"amount":"100.00","credited":"95.50","custom_fields":{"user":1},"invoice_id":"a3e9ff6f-c5c1-3bcd-854e-4bc995b1ae7a","order_id":"c78d8fe9-ab44-3f21-a37a-ce4ca269cb47","pay_service":"card","pay_time":"2023-04-06 16:27:59","payer_details":"553691******1279","status":"success","type":1}

Ключ example → подпись

  1. 1.x-api-sha256-signature: e582b14dd13f8111711e3cb66a982fd7bff28a0ddece8bde14a34a5bb4449136