Перейти к основному содержанию
POST
curl
В продакшене проверка счёта работает в Нигерии, Гане и Кении. Для других стран запрос возвращает 404 с code: country_not_covered, и за него не списывается плата. Со временем список стран будет расширяться. Актуальные возможности по каждой стране всегда указаны в разделе Цены на банковскую верификацию.
Ваш бэкенд отправляет имя и счёт и получает результат. Это проверка счёта на шаге банковской верификации, но без проверки самого человека.

Передайте счёт в формате его страны

В некоторых странах также требуется bic, а для бизнес-счёта registration_id. Пробелы, дефисы и точки игнорируются. Если в проверке страны нужного ключа нет, возвращается 400 с его названием, например "field": "account.bank_code", "reason": "required". Передайте holder.full_name, чтобы проверить счёт физического лица, или holder.business_name, чтобы проверить счёт компании.

Передайте согласие владельца счёта

В некоторых странах проверка счёта требует явного согласия владельца счёта перед каждой проверкой. Запросите его в вашем продукте, затем передайте "consent": true. Без этого поля проверка в таких странах отклоняется с 400 (field: consent, reason: required), и плата за неё не списывается. В остальных странах consent необязателен. Если вы его передадите, Didit сохранит его вместе с начислением за проверку. Ключ песочницы запрашивает согласие в тех же странах, что и боевой ключ.

Прочитайте результат

Биллинг и повторные попытки

Каждая проверка, на которую банк ответил, оплачивается один раз по цене проверки счёта страны счёта, независимо от результата. Запрос, завершившийся ошибкой, никогда не оплачивается: это некорректное тело запроса (400), недостаточно средств на балансе (402), счёт, для которого проверка ещё не поддерживается (404), или банк, который не смог ответить (503). Ключа идемпотентности и endpoint для получения сведений о проверке нет. Повторный запрос запускает новую проверку с новым request_id и оплачивается снова, поэтому сохраняйте ответ. Didit хранит только данные о начислении: идентификатор запроса, страну, результат и маскированный счёт. Имя и полный номер счёта Didit не хранит.

Проверьте в песочнице

API-ключ для песочницы не обращается к банку и ничего не списывает. Последние 4 символа IBAN, а если IBAN нет, то номера счёта, определяют ответ: IBAN, CLABE и CBU содержат контрольные цифры. Используйте тестовые значения песочницы, которые проходят все проверки формата.

Доступ

Аутентифицируйтесь с помощью x-api-key вашего приложения или токена bearer, полученного с использованием учётных данных клиента. API-ключу с ограниченными правами нужен доступ на запись к сессиям. Endpoint использует общий лимит на запись: 300 запросов в минуту на API-ключ.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Тело

application/json
country
string
обязательно

Страна счёта в виде кода ISO 3166-1 alpha-3, например NGA. Допускается строчный регистр.

Required string length: 3
Пример:

"NGA"

account
object
обязательно

Счёт в формате, принятом в соответствующей стране: iban или account_number с кодом банка или отделения, требуемым страной (sort_code, routing_number, transit_institution, bsb, ifsc, bank_code или bic). Для Мексики используется clabe, а для Аргентины cbu_cvu, которые уже содержат код банка. Для счёта компании добавляется registration_id, если это требуется страной. Пробелы, дефисы и точки игнорируются. Ключи, не используемые проверкой соответствующей страны, игнорируются; отсутствие необходимого ключа приводит к ошибке 400 с указанием его имени.

Пример:
holder
object
обязательно

Имя, с которым проверяется учётная запись. Передайте ровно одно из полей: full_name или business_name.

vendor_data
string | null

Ваш собственный идентификатор этой проверки, возвращаемый без изменений.

Пример:

"payout_20481"

Установите значение true, если владелец счёта дал явное согласие на эту проверку. Обязательно в странах, где проверка счёта требует такого согласия: без него в проверке будет отказано с ошибкой 400, где field равен consent, а reason равен required, при этом средства не списываются. В остальных странах параметр необязателен, и Didit фиксирует его вместе с начислением за проверку, если вы его передаёте.

Пример:

true

Ответ

Банк ответил. Проверка тарифицируется независимо от результата.

request_id
string<uuid>
обязательно

ID этой проверки.

result
enum<string>
обязательно

match: банк ведет счет на указанное вами имя. close_match: на близкое имя, например, пропущено отчество/второе имя или допущена опечатка. no_match: на другое имя либо такого счета не существует. cannot_verify: банк вернул ответ без сравнения имени, например, для заблокированного или закрытого счета.

Доступные опции:
match,
close_match,
no_match,
cannot_verify
holder_name
string | null
обязательно

Только при close_match и только если банк его вернул: имя владельца счёта в том виде, в котором оно зарегистрировано в банке. В противном случае null.

account
string
обязательно

Счёт, маскированный до последних 4 символов.

vendor_data
string | null
обязательно

Ваш собственный идентификатор в том виде, в котором вы его отправили.

created_at
string<date-time>
обязательно

Когда выполнялась проверка, в UTC.

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