> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/nastroiki/utility/informaciya-po-kartam.md). # Информация по картам {% hint style="info" %} Перед включением ограничений по банкам обязательно протестируйте работу проверки BIN на нескольких реальных картах. Если внешний сервис не сможет определить банк или правила будут настроены неправильно, клиенты могут столкнуться с невозможностью создать заявку. {% endhint %} Раздел «Информация по картам» предназначен для проверки банковских карт по BIN и применения правил для работы с банками. BIN (Bank Identification Number) — это первые 6 цифр банковской карты. По ним внешний сервис может определить банк, платёжную систему, страну, тип карты и другую информацию. В iEXExchanger этот модуль используется не только для просмотра информации о карте. Он также позволяет разрешать или запрещать работу с определёнными банками для выбранных валют, что помогает автоматически фильтровать заявки. *** ## Для чего нужен модуль Модуль помогает: * проверять банковские карты по BIN; * определять банк, страну и платёжную систему карты; * сохранять информацию о карте в заявке; * разрешать работу только с выбранными банками; * запрещать отдельные банки; * настраивать отдельные правила для сторон «Отдаю» и «Получаю»; * уменьшать количество ошибочных и нежелательных заявок. Например, если обменный пункт принимает RUB только от карт определённых банков или не выполняет выплаты на карты некоторых банков, это можно настроить именно здесь. ## Где находится раздел В панели управления откройте: **«Утилиты» — «Информация по картам»** На странице раздел может называться: **Проверка банковских карт и реквизитов**
Если раздел не отображается, проверьте права группы пользователя. Для доступа необходимо разрешение на управление информацией по картам. *** ## Как работает модуль При создании заявки система анализирует реквизиты клиента. Если реквизит является банковской картой, система выделяет первые 6 цифр (BIN), отправляет их во внешний сервис проверки и получает информацию о карте. После этого iEXExchanger: * сохраняет информацию в заявке; * определяет банк; * при необходимости применяет разрешённые и запрещённые списки банков. Если реквизит не является банковской картой, проверка BIN не выполняется. ## Какие данные может определить система В зависимости от выбранного сервиса система может получить: * номер карты; * платёжную систему; * тип карты; * уровень или бренд карты; * страну банка; * валюту страны; * название банка; * сайт банка; * телефон банка. Важно учитывать, что разные сервисы возвращают разный объём информации. Некоторые определяют только банк и страну, другие предоставляют более подробные сведения. *** ## Доступные сервисы проверки В системе поддерживаются три сервиса. #### Binlist Работает без API-ключа. ``` https://binlist.net ``` Подходит для базовой проверки BIN. #### BinCodes Требует API-ключ. ``` https://bincodes.com ``` Обычно предоставляет более стабильные и подробные данные. #### MrBin Требует API-ключ. ``` https://mrbin.io ``` Используется как альтернативный сервис проверки BIN. *** ## Основные настройки ### Включить проверку BIN Главный переключатель модуля. Если настройка включена, система будет выполнять проверку банковских карт и применять ограничения по банкам. Если настройка отключена, проверка BIN полностью выключается. ### Запоминать результаты проверки по картам При включении этой настройки результаты проверки сохраняются на сервере. Это позволяет: * ускорить повторные проверки; * уменьшить количество обращений к внешнему сервису; * снизить вероятность превышения лимитов API. Кэш хранится по BIN карты. В текущей реализации срок хранения составляет 24 часа. Рекомендуется всегда включать эту настройку, особенно при использовании платных сервисов. ### Сервис проверки банковских карт Здесь выбирается сервис, через который система будет получать информацию по BIN. Рекомендуется: * использовать Binlist для простой проверки; * использовать BinCodes или MrBin, если необходима более высокая точность или стабильность; * протестировать несколько сервисов, если банки вашей страны определяются некорректно. ### API-ключ сервиса Поле отображается только для сервисов, которым требуется авторизация. API-ключ необходимо получить в личном кабинете выбранного сервиса и указать в настройках. Для Binlist API-ключ не нужен. ### Валюты, для которых включена проверка BIN Здесь выбираются валюты, для которых необходимо выполнять проверку банковских карт. Например: ``` RUB UAH KZT ``` Для криптовалют и других направлений, где банковские карты не используются, включать проверку не требуется. {% hint style="info" %} Если удалить валюту из списка и сохранить настройки, все правила по разрешённым и запрещённым банкам для этой валюты будут удалены. {% endhint %} ## Пошаговая настройка {% stepper %} {% step %} ### Включите проверку BIN Откройте раздел: ``` «Утилиты» — «Информация по картам» ``` Включите настройку: ``` Включить проверку BIN ``` {% endstep %} {% step %} ### Включите кэширование Активируйте настройку: ``` Запоминать результаты проверки по картам ``` Это уменьшит количество обращений к внешнему сервису. {% endstep %} {% step %} ### Выберите сервис проверки В поле «Сервис проверки банковских карт» выберите подходящий сервис. При необходимости укажите API-ключ. {% endstep %} {% step %} ### Выберите валюты В поле: ``` Валюты, для которых включена проверка BIN ``` отметьте валюты, использующие банковские карты. После изменения списка нажмите: ``` Сохранить настройки ``` {% endstep %} {% step %} ### Настройте банки После сохранения появится блок: ``` Валюты для проверки BIN ``` У каждой валюты нажмите: ``` Настроить ``` После этого можно добавить разрешённые и запрещённые банки. {% endstep %} {% endstepper %} ## Настройка банков
Для каждой валюты доступны четыре списка: * Разрешённые — Вход; * Разрешённые — Выход; * Запрещённые — Вход; * Запрещённые — Выход. Каждый банк необходимо указывать с новой строки. ## Что означает «Вход» и «Выход» Вход — сторона заявки «Отдаю». То есть карта клиента, с которой поступают средства. Выход — сторона заявки «Получаю». То есть карта, на которую обменный пункт отправляет выплату. ## Разрешённые банки Разрешённые банки определяют список банков, с которыми разрешено создавать заявки. Если список заполнен, карты всех остальных банков будут отклоняться. Если банк определить не удалось, клиент увидит сообщение: ``` Не удалось определить банк по номеру счета для проверки разрешённого списка ``` Если банк найден, но отсутствует в разрешённом списке: ``` Номер счета не относится к банкам из разрешённого списка ``` #### Пример Разрешить принимать RUB только от двух банков. В поле: ``` Разрешённые — Вход ``` укажите: ``` Сбер Т-Банк ``` После этого остальные банки использоваться не смогут. ## Запрещённые банки Запрещённые банки работают наоборот. Если название банка совпало с одним из правил, система не позволит создать заявку. Клиент увидит сообщение: ``` Номер счета относится к банкам из запрещённого списка ``` #### Пример Чтобы запретить выплаты на карты определённого банка, откройте: ``` Запрещённые — Выход ``` и укажите название банка. После сохранения заявки на карты этого банка будут отклоняться. *** ## Как сравниваются названия банков Названия работают по принципу поиска части строки. Например, внешний сервис вернул: ``` SBERBANK OF RUSSIA ``` Достаточно указать правило: ``` sber ``` и оно будет успешно найдено. Рекомендуется использовать устойчивые и понятные части названий, чтобы случайно не заблокировать другие банки. *** ## Как правильно добавлять банки Самый безопасный способ настройки: 1. Включите проверку BIN. 2. Выберите сервис проверки. 3. Создайте тестовую заявку. 4. Посмотрите, какое название банка определила система. 5. Используйте именно это название при создании правил. 6. После настройки снова выполните тест. Такой порядок значительно уменьшает вероятность ошибок. *** ## Пример настройки {% stepper %} {% step %} ### Разрешить только определённые банки Порядок действий: 1. Откройте: ``` «Утилиты» — «Информация по картам» ``` 2. Включите проверку BIN. 3. Включите сохранение результатов проверки. 4. Выберите сервис. 5. При необходимости укажите API-ключ. 6. Выберите валюту RUB. 7. Сохраните настройки. 8. Нажмите: ``` Настроить ``` 9. В поле: ``` Разрешённые — Вход ``` добавьте банки по одному в каждой строке. 10. Сохраните настройки банков. После этого принимать карты смогут только указанные банки. {% endstep %} {% step %} ### Запретить банк для выплат Порядок действий: 1. Выберите нужную валюту. 2. Нажмите: ``` Настроить ``` 3. В поле: ``` Запрещённые — Выход ``` укажите название банка. 4. Сохраните настройки. После этого выплаты на карты этого банка будут запрещены. {% endstep %} {% endstepper %} *** ## Что проверить после настройки После завершения настройки рекомендуется проверить: * включена ли проверка BIN; * выбран ли сервис проверки; * указан ли API-ключ; * выбраны ли нужные валюты; * сохранены ли настройки; * определяется ли банк по тестовой карте; * правильно ли работают разрешённые и запрещённые списки; * отображается ли информация о карте в заявке. *** ## Частые ошибки
Проверка не выполняется Проверьте: * включена ли проверка BIN; * выбран ли сервис; * указан ли API-ключ; * выбрана ли валюта; * сохранены ли настройки; * является ли реквизит банковской картой.
Банк не определяется Возможные причины: * сервис не знает этот BIN; * временно недоступен API; * неверный API-ключ; * превышен лимит запросов; * карта слишком новая; * выбранный сервис плохо работает с банками нужной страны. Попробуйте использовать другой сервис или протестировать карту повторно.
Разрешённые банки не работают Чаще всего причина в том, что название банка, указанное в правилах, не совпадает с тем, которое возвращает сервис. Создайте тестовую заявку, посмотрите название банка и используйте его при настройке.
Запрещённые банки не работают Если внешний сервис не смог определить банк, системе нечего сравнивать с запрещённым списком. Проверьте работу сервиса проверки и результаты определения BIN.
*** ## Рекомендации * Всегда включайте кэширование результатов проверки. * Используйте только карточные валюты. * Перед включением ограничений протестируйте определение банков. * Не копируйте названия банков вручную — сначала посмотрите, как их определяет сервис. * Регулярно проверяйте работу API-ключа. * Ограничьте доступ к разделу только администраторам и ответственным менеджерам. ## Безопасность API-ключи сервисов проверки являются конфиденциальными. Не публикуйте их в документации, переписках или открытых файлах. Во внешний сервис передаётся только BIN карты — первые 6 цифр номера. Полный номер банковской карты передаваться не должен. Несмотря на это, информация о банковских картах относится к чувствительным данным, поэтому доступ к разделу рекомендуется предоставлять только сотрудникам, которым действительно необходима работа с ним. *** ## Коротко 1. Откройте: «Утилиты» — «Информация по картам» 2. Включите проверку BIN. 3. Включите сохранение результатов проверки. 4. Выберите сервис проверки. 5. При необходимости укажите API-ключ. 6. Выберите валюты, для которых нужна проверка. 7. Настройте разрешённые и запрещённые банки. 8. Создайте тестовую заявку. 9. Убедитесь, что банк определяется правильно и ограничения работают так, как ожидается. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.iexexchanger.com/guide/nastroiki/utility/informaciya-po-kartam.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.