API для проверки колумбийской Седулы (RU)

Привлечение пользователей в Колумбии означает подтверждение того, что они являются теми, за кого себя выдают. Проверяет данные колумбийской Cédula de Ciudadanía через провайдера верификации личности Didit в Колумбии. Документ или введенные данные лишь доказывают, что данные существуют — но не то, что они подлинные или принадлежат человеку перед вами. Проверка Седулы в Колумбии устраняет этот пробел, проверяя данные по официальному государственному реестру личности страны. Это руководство объясняет, что делает проверка, точные технические детали и как интегрировать ее за считанные минуты.

Основные выводы:

• Что проверяется — Проверка Седулы в Колумбии подтверждает национальное удостоверение личности по официальному государственному реестру страны.
• Что вы получаете — нормализованный match_type плюс результаты на уровне полей, которые вы можете напрямую направить в логику одобрения / рассмотрения / отклонения.
• Почему это важно — Документ может быть подделан; запись в реестре — нет. Проверка удостоверения личности по авторитетному государственному источнику подтверждает, что владелец реален и правильно идентифицирован.
• Как использовать — один POST к конечной точке проверки базы данных Didit или модуль рабочего процесса без кода. 0,20 доллара США за окончательный запрос, результаты за секунды.

Что проверяет проверка Седулы в Колумбии

Проверяет данные колумбийской Cédula de Ciudadanía через провайдера верификации личности Didit в Колумбии. Didit предоставляет это через одну конечную точку, чтобы вы могли проверить представленные данные по официальному государственному реестру личности страны и получить структурированный, нормализованный результат — а не необработанный дамп реестра, который вам придется анализировать самостоятельно.

Окончательный ответ возвращает совпадающие source_data и блок validation для каждого поля, чтобы ваша система управления рисками получала четкий, машиночитаемый вердикт.

Почему это важно

Документ может быть подделан; запись в реестре — нет. Проверка удостоверения личности по авторитетному государственному источнику подтверждает, что владелец реален и правильно идентифицирован.

Для регулируемых предприятий в Колумбии — финтех-компаний, криптоплатформ, кредиторов, торговых площадок и игровых операторов — проверка по авторитетному источнику создает обоснованную, проверяемую запись о том, что личность была подтверждена на источнике, а не просто получена из формы или фотографии.

Технические детали

Didit предоставляет эту услугу через унифицированную конечную точку проверки базы данных. Это один POST — SDK не требуется.

Конечная точка

POST /v3/database-validation/

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

Параметр	Тип	Обязательный	Описание
issuing_state	string	Да	Трехбуквенный код страны по ISO 3166-1 alpha-3. Используйте COL.
services	string	Да	Идентификатор услуги. Используйте col_cedula.
personal_number	string	Да	Личный номер.
first_name	string	Нет	Имя (необязательная перекрестная проверка).
last_name	string	Нет	Фамилия (необязательная перекрестная проверка).

Пример запроса

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=COL" \
  -F "services=col_cedula" \
  -F "personal_number=1111111"

Пример ответа (окончательное совпадение)

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "COL",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "col_cedula",
      "service_name": "Colombia - Cédula verification",
      "source_data": {
        "document_type": "sample_value",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

Производительность и выставление счетов

• Задержка: обычно пара секунд.
• Стоимость: 0,20 доллара США за окончательный запрос. С вас взимается плата только за окончательные результаты — отсутствие платы за простой источника, отсутствующие поля или отклонения до источника.
• Надежность: работает на инфраструктуре Didit с целевым показателем ежеквартального времени безотказной работы 99,9%.

Случаи использования

• Финтех и необанки — подтвердите реального, поддающегося проверке владельца счета перед открытием кошелька или предоставлением кредита в Колумбии.
• Крипто и Web3 — соблюдайте требования VASP по регистрации с помощью авторитетного подтверждения личности.
• Кредитование — уменьшите мошенничество с синтетической личностью и мошенничество первой стороны с помощью данных, проверенных источником.
• Торговые площадки и гиг-платформы — проверяйте пользователей по авторитетным данным, а не только по самостоятельно заполненной форме.
• iGaming — удовлетворяйте проверки личности и соответствия требованиям для игроков из Колумбии с помощью проверяемого следа.

Как интегрироваться с Didit

Вы можете выполнить проверку Седулы в Колумбии двумя способами:

1. Рабочий процесс без кода. В консоли Didit Business Console откройте Workflow Builder, добавьте модуль Database Validation, выберите Colombia → Colombia Cédula Verification и активируйте его. Совпадающие пользователи маршрутизируются автоматически — никаких инженерных работ не требуется.
2. Прямой API. Вызовите конечную точку /v3/database-validation/, показанную выше, с services=col_cedula. Прочитайте match_type и блок validation для каждого поля, чтобы управлять своей логикой одобрения / рассмотрения / отклонения.

Каждая учетная запись Didit включает 500 бесплатных проверок в месяц, поэтому вы можете протестировать весь процесс от начала до конца, прежде чем платить за один запрос.

Часто задаваемые вопросы

Что подтверждает проверка Седулы в Колумбии?

Она проверяет представленные данные по официальному государственному реестру личности страны и возвращает нормализованный результат совпадения, чтобы вы узнали, существует ли национальное удостоверение личности в авторитетном источнике и какие поля совпали.

Что произойдет, если источник временно недоступен?

С вас не взимается плата. Выставление счетов применяется только к окончательным результатам — простой источника, отсутствующие поля и отклонения до источника бесплатны.

Насколько быстра проверка?

Проверка базы данных обычно возвращает результат за пару секунд, поэтому она вписывается в процесс регистрации в реальном времени.

Нужен ли мне SDK?

Нет. Проверка — это один HTTPS POST к одной конечной точке. Вы также можете подключить ее к беcкодовому рабочему процессу в Business Console.

Готовы начать?

Подтвердите свое первое национальное удостоверение личности Колумбии сегодня.

• Прочитайте справочник по API: Проверка Седулы в Колумбии
• Посмотрите все проверки базы данных: Цены и покрытие проверки базы данных
• Начните создавать: Создайте бесплатную учетную запись Didit — 500 проверок в месяц, бесплатно.