POST AI agent ready /v1/bin/lookup

API поиска BIN — эмитент карты, тип и страна из BIN/IIN

Принимает первые 6-8 цифр платежной карты (БИН или ИИН) и возвращает схему карты (Visa, Mastercard и т. д.), тип карты (дебетовая/кредитная), бренд, реквизиты банка-эмитента, страну выдачи, а также является ли карта предоплаченной.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/bin/lookup \
  -H "Content-Type: application/json" \
  -d '{"bin":"45717360"}'

When to use this API

Обнаружение мошенничества с платежами

Сравните страну BIN со страной платежного адреса, указанной клиентом. Несоответствие (например, использование литовской карты с платежным адресом в США) является сильным сигналом мошенничества. Направляйте помеченные транзакции посредством проверки вручную или проверки 3D Secure.

Динамический интерфейс оформления заказа

Когда пользователь вводит номер своей карты, найдите БИН после 6 цифр. Отобразите правильный логотип карты (Visa, Mastercard), автоматически выберите тип карты и покажите название банка-эмитента. Это уменьшает количество ошибок при вводе и повышает доверие к процессу оформления заказа.

Ограничения по предоплаченным картам

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

Frequently asked questions

Что такое БИН/ИИН?

Идентификационный номер банка (БИН), также называемый идентификационным номером эмитента (ИИН), представляет собой первые 6-8 цифр номера платежной карты. Он идентифицирует карточную сеть (Visa, Mastercard), банк-эмитент, тип карты и страну выдачи.

Безопасно ли передавать первые 6-8 цифр?

Да. PCI DSS позволяет хранить и передавать первые 6 и последние 4 цифры номера карты в виде открытого текста. Сам по себе БИН не может быть использован для осуществления платежа или идентификации владельца карты.

Какие схемы карт поддерживаются?

База данных охватывает Visa, Mastercard, American Express, Discover, JCB, UnionPay, Diners Club, Maestro и другие региональные схемы. Охват варьируется в зависимости от региона, но включает подавляющее большинство карт, находящихся в активном обращении.

Может ли поле банка быть нулевым?

Да. Некоторые диапазоны BIN, особенно для новых финтех-компаний или эмитентов виртуальных карт, могут не содержать названия банка или данных URL-адреса. Объект банка всегда присутствует, но отдельные поля внутри него (имя, URL-адрес, телефон) могут быть нулевыми.

Насколько актуальна база данных BIN?

База данных БИН ежемесячно пополняется новыми диапазонами карточных сетей. Новые карточные программы от финтех-компаний или региональных банков добавляются по мере их появления в публичных реестрах BIN.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.