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».