Южная Африка - API поиска директоров компаний

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

POST

database-validation

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Возвращает текущих директоров южноафриканской компании из коммерческого реестра CIPC. Didit предоставляет этот сервис через POST /v3/database-validation/, чтобы вы могли сверить переданные данные с первоисточником и получить нормализованные результаты сопоставления.

Покрытие

Покрытие: —
Страна: Южная Африка
ID сервиса: zaf_company_directors
Домен данных: Государственные данные
Категория: CompanyRegister

Входные данные

Поле	Обязательное	Пример
`company_registration_number`	Да	`REG-123456`
`vendor_data`	Нет	`user-1234`

Обязательные входные данные: company_registration_number
Необязательные входные данные: vendor_data
Согласие: не требуется
Доступность в сценарии: доступно в сценарии с сопоставлением полей
Покрытие: —
Цена: $0.75 за успешный запрос

В сценарии company_registration_number не печатается на документе, удостоверяющем личность, поэтому ни один шаг не создаёт его самостоятельно. Получите его из ответа на вопрос анкеты, из поля, извлечённого с помощью Document AI, или из значения, которое вы передаёте при создании сессии, и сопоставьте его на шаге «Проверка по базам данных». Пока поле не сопоставлено, редактор сценариев показывает этот сервис как отключённый и называет недостающий входной параметр. Во время выполнения отсутствие входного параметра означает, что проверка пропускается до любого запроса, поэтому с вас никогда не взимается плата за базу данных, которую не удалось запросить.

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

string

по умолчанию:"ZAF"

обязательно

Код страны ISO 3166-1 alpha-3 для этого сервиса базы данных.Пример: ZAF

string

по умолчанию:"zaf_company_directors"

обязательно

Массив, содержащий ID этого сервиса. Фиксация сервиса ограничивает запрос этой конкретной базой данных.Пример: zaf_company_directors

string

по умолчанию:"REG-123456"

обязательно

Значение company_registration_number, необходимое этому сервису базы данных.Пример: REG-123456

string

по умолчанию:"user-1234"

Ваш стабильный идентификатор этого человека в вашей системе, например внутренний ID пользователя. Didit использует его, чтобы связывать автономные проверки с одним и тем же конечным пользователем и снижать количество ложных срабатываний при обнаружении дубликатов.Пример: user-1234

Правила ввода и примечания к проверке

Передавайте перечисленные выше поля точно в том виде, в котором они получены от пользователя или документа.
Didit проверяет обязательные поля до обращения к базе данных. Запросы, отклонённые до поиска в источнике, не тарифицируются.

Как выполнить вызов

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"

Каждый успешный вызов возвращает HTTP 200. Поле outcome_code сообщает, что именно произошло, позволяя отличить, например, реальное несовпадение биометрии (BIOMETRIC_NO_MATCH) от селфи, которое не удалось прочитать (BIOMETRIC_IMAGE_UNUSABLE). Показанный status — это статус функции по умолчанию; настроенные вами действия для Partial Match / No Match могут его переопределить.

MATCH — Реестр подтвердил личность, и все проверенные поля совпали.

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}

NO_MATCH — Реестр не нашёл совпадений для переданных данных.

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

Возвращаемые данные

Точный набор полей в source_data зависит от того, что возвращает реестр. Сгенерированный пример для zaf_company_directors на данный момент описывает такую нормализованную структуру:

Зависит от ответа реестра.

Цены и SLA

Запросы сервиса «Поиск директоров компаний в Южной Африке» тарифицируются только тогда, когда Didit получает окончательный результат от источника проверки.

Цена за вызов: $0.75 USD.
Тарификация: за успешный запрос. Плата не взимается, если реестр недоступен, если обязательные поля не заполнены или если запрос отклонён до обращения к источнику.
Задержка: типичное значение p95 < 2 с.
Доступность: 99.9% в квартал со стороны Didit; доступность источника данных зависит от страны и набора данных.

Продолжить чтение

Последнее изменение 7 ноября 2026 г.

​Покрытие

​Входные данные

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

​Правила ввода и примечания к проверке

​Как выполнить вызов

​Возвращаемые данные

​Цены и SLA

​Продолжить чтение

Покрытие

Входные данные

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

Правила ввода и примечания к проверке

Как выполнить вызов

Возвращаемые данные

Цены и SLA

Продолжить чтение