KYC ПЛАТФОРМА

Postman и примеры запросов

Для упрощения интеграции по каждому продукту доступны коллекции Postman
и описания на интеграционной платформе МТС.

Общий подход

  1. Получите у менеджера со стороны МТС:
  2. ссылки на API на портале интеграционной платформы (portal.intp.mts-corp.ru);
  3. соответствующие коллекции Postman (export .json);
  4. данные для окружений (prod/prodlike/DEV).
  5. Импортируйте коллекции в Postman.
  6. Настройте в Postman переменные окружения:
  7. base_url (для KYC, Verification, OCR, Mobile ID);
  8. client_id, client_secret;
  9. тестовые значения идентификаторов (applicantExternalId, verificationExternalId и т.д.).

Коллекции для KYC

В спецификации KYC выделен отдельный раздел «Коллекция Postman».
Как правило, коллекция включает:

  • методы работы с заявителями (/applicants);
  • методы работы с идентификациями (/identifications, workflow-instances);
  • примеры callback‑уведомлений и PostMessage‑взаимодействия.

Рекомендуемый порядок использования:

  1. Запрос на получение токена (/token).
  2. Создание заявителя.
  3. Создание идентификации.
  4. Получение результата идентификации.

Коллекции для Verification

Для сервиса Verification обычно предоставляется отдельная коллекция, содержащая:

  • POST /api/v2/verifications/workflow-instances — регистрация верификации по сценарию (workflow);
  • POST /api/v2/verifications/results — получение результатов по массиву verificationExternalIds;
  • POST /rfm/is-in-catalog — отдельная проверка по перечню террористов и экстремистов;
  • примеры callback‑запросов.

Коллекция полезна для настройки:

  • параметров parameters (выбор активных проверок);
  • стратегий completionStrategy;
  • обработки результатов и ошибок.

Коллекции для OCR

В спецификации OCR приведён пример запроса curl для метода recognise.
На основе него обычно формируется Postman‑запрос:

  • метод POST;
  • Content-Type: image/jpeg;
  • тело — бинарный файл документа;
  • query‑параметры type и country.

Дополнительно на интеграционной платформе для OCR указаны ссылки:

  • Prod / RC / DEV публикации (идентификаторы API на портале).

Примеры для документации

Во всех разделах API Reference (KYC, Mobile ID, Verification, OCR) приведены
примеры запросов и ответов. Рекомендуется:

  • использовать их как «эталон» при настройке Postman;
  • по мере необходимости добавлять в коллекции свои вариации (другие типы документов, проверки и т.д.).