Верификация владельца банковского счёта в ЮАР: API

​

Покрытие

• Покрытие: —
• Страна: Южная Африка
• Идентификатор сервиса: zaf_bank_account_holder
• Область данных: Финансы
• Категория: Банковское дело

​

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

• Обязательные входные данные: national_id, bank_account_number, bank_name
• Необязательные входные данные: account_type, first_name, last_name, initials, email, phone_number, vendor_data
• Согласие: обязательно
• Доступность в сценарии: доступно в сценарии с сопоставлением полей
• Покрытие: —
• Цена: $0.40 за успешный запрос

​

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

​

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

• Значение account_type должно быть одним из типов счетов AVS ЮАР: current, savings, transmission, subscriptionShare, notKnown. Сравнение не учитывает регистр. Не передавайте поле, если тип счёта вам неизвестен: тогда Didit отправит notKnown, а проверка типа счёта будет указана как не подтверждённая, а не приведёт к ошибке запроса.

​

Как вызвать

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_bank_account_holder" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "national_id=8708150847085" \
  -F "bank_account_number=1234567890" \
  -F "bank_name=ABSA" \
  -F "account_type=current" \
  -F "last_name=Doe" \
  -F "initials=JD"

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

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": true,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": true
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "zaf_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": true,
        "accepts_debits": true,
        "account_found": true,
        "account_number_length_valid": false,
        "account_open": true,
        "account_type_match": true,
        "id_match": true,
        "identification_number": "SAMPLE-ID-12345",
        "initials_match": true,
        "surname_match": false
      },
      "validation": {
        "full_name": "partial_match",
        "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_bank_account_holder",
      "service_name": "South Africa - Bank Account Holder Verification",
      "source_data": {
        "accepts_credits": false,
        "accepts_debits": false,
        "account_found": false,
        "account_number_length_valid": false,
        "account_open": false,
        "account_type_match": false,
        "id_match": false,
        "identification_number": "NO_MATCH",
        "initials_match": false,
        "surname_match": false
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}

​

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

• accepts_credits
• accepts_debits
• account_found
• account_number_length_valid
• account_open
• account_type_match
• id_match
• identification_number
• initials_match
• surname_match

​

Цены и SLA

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

​

Что подтверждает MATCH

• account_found – банк ведёт счёт с таким номером. Если это значение false, все остальные поля не имеют смысла.
• account_open – счёт открыт. Счёт может быть найден, но закрыт.
• id_match – счёт принадлежит владельцу с указанным вами национальным идентификатором. Именно для этой проверки и существует сервис.
• initials_match, surname_match – переданные initials и last_name совпадают с данными владельца счёта в банке.
• account_type_match – переданный account_type совпадает с реальным типом счёта.
• email_match, phone_match – переданные email и phone_number совпадают с контактными данными, которые хранит банк.
• accepts_debits, accepts_credits – счёт может принимать дебетовые поручения и зачисления.
• account_number_length_valid – номер счёта имеет длину, которую ожидает банк.

• MATCH – счёт существует, и каждое переданное вами поле совпало, включая id_match.
• PARTIAL_MATCH – счёт принадлежит указанному национальному идентификатору, но хотя бы одно другое переданное поле не совпало (например, фамилия записана в банке иначе). outcome_detail называет поля, которые не совпали.
• NO_MATCH – либо банк не ведёт такого счёта, либо счёт существует, но принадлежит другому человеку. Оба варианта являются окончательным ответом о человеке.

​

Допустимые значения bank_name и account_type

​

Как отличить отсутствие счёта от недоступного источника

• Счёт не существует – 200 OK, match_type: "no_match", outcome_code: "NO_MATCH", source_data.account_found: false. Это реальный ответ банка. Запрос тарифицируется, и применяется ваше действие для случая отсутствия совпадения.
• Источник не ответил – 502 Bad Gateway с validation_errors[].code = empty_provider_response и retryable: true. О человеке ничего не установлено, плата не взимается, повторный запрос безопасен.
• Источник отказался выполнить запрос – 400 Bad Request с validation_errors[].code = provider_rejected_input и retryable: false. Источник не выполнял поиск, потому что не принял переданные данные. Исправьте данные: повтор с теми же значениями не даст результата. Плата не взимается.
• Источник ответил и отклонил ваши данные – 502 Bad Gateway с validation_errors[].code = provider_invalid_input (например, номер счёта не проходит проверку формата банка). Повторять запрос бессмысленно, пока данные не исправлены. Плата не взимается.
• Запрос не покинул Didit – 400 Bad Request с указанием поля, которое нужно исправить. Плата не взимается.

​

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

• Обзор проверки баз данных для Южной Африки
• Обзор проверки по базам данных
• Коды результатов