Особистий кабінет

Колбеки

Отримуйте результат запиту на перевірку на свій сервер замість опитування.

Коли запит на перевірку створено з callback_url, VerifAge надсилає POST на цю адресу, щойно покупець схвалив або відхилив запит або запит прострочився.

Тіло запиту

{
  "id": "01J9…",
  "external_reference": "order-10432",
  "status": "approved",
  "verified": true,
  "sent_at": "2026-10-22T10:15:00Z"
}

Колбек містить ті самі поля, що й GET /api/v1/merchant/verify-requests/{id}: ніколи не ім’я, не дату народження і не дані документа.

Перевірка відправника

Кожен колбек підписаний. Заголовок X-VerifAge-Signature містить HMAC-SHA256 від сирого тіла, обчислений із секретом вашого API-ключа. Обчисліть те саме значення на своєму боці та порівняйте за сталий час, перш ніж довіряти даним. Відхиляйте колбеки старші за кілька хвилин, перевіряючи sent_at.

Доставка

  • Відповідайте будь-яким статусом 2xx протягом 10 секунд.
  • При помилці мережі або відповіді не 2xx VerifAge повторює спроби зі зростаючою затримкою до 24 годин.
  • Доставка ідемпотентна: той самий id і status можуть прийти двічі, тож оновлюйте замовлення, а не додавайте записи.

Тестування

З ключем va_test_… запит схвалюється одразу і колбек надсилається негайно, тож для перегляду повного потоку під час розробки достатньо локального тунелю.

НазадMerchant API