KYC ПЛАТФОРМА

Форматы

Все API МТС KYC платформы используют единые подходы к форматам запросов и ответов.

Транспорт и кодировка

  • Транспорт: HTTPS
  • Кодировка: UTF‑8
  • Формат тела запроса/ответа:
  • application/json — для KYC, Verification, большинства методов;
  • бинарные данные (изображения) — для OCR (image/jpeg, image/png, image/tiff).

JSON‑структуры

Общие правила:

  • имена полей в большинстве случаев в camelCase (firstName, birthDate, verificationExternalId);
  • булевые значения — true / false;
  • даты и дата‑время:
  • либо в формате YYYY-MM-DD (пример: "1993-10-21"),
  • либо в формате ISO 8601 / RFC 3339 для дата‑времени (пример: "2026-02-17T10:00:00Z").

Примеры можно увидеть в разделах:

Идентификаторы

Во всех сервисах используются внешние идентификаторы, которые генерируются на стороне клиента:

  • applicantExternalId — уникальный идентификатор заявителя;
  • verificationExternalId — идентификатор запроса на верификацию;
  • requestGuid / идентификаторы заявок на идентификацию.

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

  • использовать устойчивые идентификаторы (например, UUID);
  • не полагаться на внутренние идентификаторы МТС как на ключи в вашей системе.

Статусы и справочники

Статусы запросов, ошибок и отдельных проверок описаны в справочниках:

  • KYC — статусы идентификаций и ошибок (см. products/kyc/reference/statuses.md, products/kyc/reference/errors.md);
  • Verification — статусы верификаций и кодов ответов (см. products/verification/errors.md);
  • OCR — коды ошибок и статусы (см. products/ocr/errors.md).

Для каждого конкретного API смотрите соответствующий раздел API Reference и продуктовые справочники.