Перейти к содержанию

Отчёт по заявителю (PDF / HTML)

GET /v1/applicants/{externalUserId}/report возвращает аудиторский case-file заявителя — тот же документ, что видят операторы в портале по кнопке «Распечатать отчёт», только отрендеренный на сервере. Используется для регуляторных аудитов, архивирования, прикрепления ко внутренним заметкам по делу.

Использование

curl -X GET 'https://api.compliance.example/v1/applicants/user-12345/report?format=pdf&lang=ru' \
  -H 'X-Api-Key: pk_live_...' \
  -H 'X-Api-Secret: ...' \
  -H 'X-Environment: production' \
  -o user-12345.pdf

Параметры запроса

Параметр Значения По умолчанию Эффект
format pdf | html pdf Формат вывода
lang en | ru en Язык отчёта

Что входит в отчёт

Фиксированный партнёрский набор: блок статуса, профиль, документы (со встроенными data-URI изображениями — последнее одобренное на каждый уровень). Внутренние операторские разделы (заметки, EXIF, device intel) исключены — партнёр получает безопасный для интеграции subset.

В партнёрской поверхности нет параметра ?include= — рендерер всегда эмитит партнёрский набор. Селектор разделов остаётся в операторском портале.

Примечания

  • Синхронно и блокирующе. Крупные KYB-кейсы (10+ дочерних) могут занять несколько секунд. Если у вашего шлюза жёсткий таймаут — планируйте; асинхронный режим для долгих случаев — в roadmap.
  • Content-Type отражает выбранный форматapplication/pdf или text/html.
  • Каждое скачивание попадает в аудит — событие applicant.report_downloaded появляется в /review-history с actorType=partner.
  • Совпадает с порталом за вычетом партнёрской фильтрации разделов — оба источника зовут один рендерер (ApplicantReportEndpoint.RenderForApplicantAsync).

Вебхуки vs отчёт

Если нужно реагировать на вердикт — используйте вебхук applicantReviewed (дёшево, push). Отчёт — для архивирования: выпустите его один раз при терминальном решении и сохраните байты на своей стороне.