Callback

Назначение

Callback‑метод используется для асинхронной доставки результата верификации на сторону клиента.
Структура тела callback совпадает со структурой ответа метода получения результата (Result).

Транспорт

Сервис вызывает указанный при создании batch‑запроса URL:

• метод: POST;
• протокол: HTTPS (рекомендуется);
• тело: JSON с результатами верификации.

Настройка

Параметры callback задаются при вызове метода batch:

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

Пример:

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

Обработка на стороне клиента

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

• проверять подпись и источник запроса (IP‑фильтрация, mTLS и др.);
• валидировать структуру JSON по контракту API;
• логировать:
• verificationExternalId;
• applicantExternalId;
• статус верификации и ключевые результаты;
• поддерживать идемпотентность обработки (если callback может быть доставлен повторно).

Связанные разделы

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