Callback

Сервис Verification поддерживает доставку результатов через HTTP‑callback.
Callback вызывается, когда верификация считается завершённой в соответствии с параметром completionStrategy.

Основные особенности:

  • callback всегда один на запрос;
  • вызывается в момент логического завершения верификации;
  • после отправки callback отдельные источники могут продолжать работу и дополнять результат (например, для несрочных проверок).

Настройка callback

В теле batch‑запроса используются параметры:

  • callbackUrl — URL, на который будет отправлен результат верификации;
  • fullDataCallbackEnabled — флаг, управляющий объёмом данных в callback:
  • true — в callback передаётся полный набор данных по проверкам;
  • false — передаётся укороченный/агрегированный результат (зависит от настроек сервиса).

Пример фрагмента запроса:

"fullDataCallbackEnabled": true,
"callbackUrl": "https://your-system.example.com/verification/callback"

Рекомендуется:

  • принимать callback по HTTPS;
  • логировать verificationExternalId и applicantExternalId для сопоставления с внутренними сущностями;
  • предусмотреть повторную обработку callback на случай ретраев.

Формат данных в callback

Структура тела callback идентична структуре ответа метода получения результата верификации и содержит:

  • общие данные по запросу (идентификаторы, статусы);
  • детализированные результаты по каждому подключённому источнику (passportVerification, inn, esiaAccountVerification, скоринги и т.д.);
  • коды и описания ошибок, если они возникли.

Подробный JSON‑пример тела callback см. в разделе
«API Reference → Verification API → Callback».