Информация по картам
Перед включением ограничений по банкам обязательно протестируйте работу проверки BIN на нескольких реальных картах. Если внешний сервис не сможет определить банк или правила будут настроены неправильно, клиенты могут столкнуться с невозможностью создать заявку.
Раздел «Информация по картам» предназначен для проверки банковских карт по BIN и применения правил для работы с банками.
BIN (Bank Identification Number) — это первые 6 цифр банковской карты. По ним внешний сервис может определить банк, платёжную систему, страну, тип карты и другую информацию.
В iEXExchanger этот модуль используется не только для просмотра информации о карте. Он также позволяет разрешать или запрещать работу с определёнными банками для выбранных валют, что помогает автоматически фильтровать заявки.
Для чего нужен модуль
Модуль помогает:
проверять банковские карты по BIN;
определять банк, страну и платёжную систему карты;
сохранять информацию о карте в заявке;
разрешать работу только с выбранными банками;
запрещать отдельные банки;
настраивать отдельные правила для сторон «Отдаю» и «Получаю»;
уменьшать количество ошибочных и нежелательных заявок.
Например, если обменный пункт принимает RUB только от карт определённых банков или не выполняет выплаты на карты некоторых банков, это можно настроить именно здесь.
Где находится раздел
В панели управления откройте: «Утилиты» — «Информация по картам»
На странице раздел может называться: Проверка банковских карт и реквизитов
Если раздел не отображается, проверьте права группы пользователя. Для доступа необходимо разрешение на управление информацией по картам.
Как работает модуль
При создании заявки система анализирует реквизиты клиента.
Если реквизит является банковской картой, система выделяет первые 6 цифр (BIN), отправляет их во внешний сервис проверки и получает информацию о карте.
После этого iEXExchanger:
сохраняет информацию в заявке;
определяет банк;
при необходимости применяет разрешённые и запрещённые списки банков.
Если реквизит не является банковской картой, проверка BIN не выполняется.
Какие данные может определить система
В зависимости от выбранного сервиса система может получить:
номер карты;
платёжную систему;
тип карты;
уровень или бренд карты;
страну банка;
валюту страны;
название банка;
сайт банка;
телефон банка.
Важно учитывать, что разные сервисы возвращают разный объём информации. Некоторые определяют только банк и страну, другие предоставляют более подробные сведения.
Доступные сервисы проверки
В системе поддерживаются три сервиса.
Binlist
Работает без API-ключа.
Подходит для базовой проверки BIN.
BinCodes
Требует API-ключ.
Обычно предоставляет более стабильные и подробные данные.
MrBin
Требует API-ключ.
Используется как альтернативный сервис проверки BIN.
Основные настройки
Включить проверку BIN
Главный переключатель модуля.
Если настройка включена, система будет выполнять проверку банковских карт и применять ограничения по банкам.
Если настройка отключена, проверка BIN полностью выключается.
Запоминать результаты проверки по картам
При включении этой настройки результаты проверки сохраняются на сервере.
Это позволяет:
ускорить повторные проверки;
уменьшить количество обращений к внешнему сервису;
снизить вероятность превышения лимитов API.
Кэш хранится по BIN карты.
В текущей реализации срок хранения составляет 24 часа.
Рекомендуется всегда включать эту настройку, особенно при использовании платных сервисов.
Сервис проверки банковских карт
Здесь выбирается сервис, через который система будет получать информацию по BIN.
Рекомендуется:
использовать Binlist для простой проверки;
использовать BinCodes или MrBin, если необходима более высокая точность или стабильность;
протестировать несколько сервисов, если банки вашей страны определяются некорректно.
API-ключ сервиса
Поле отображается только для сервисов, которым требуется авторизация.
API-ключ необходимо получить в личном кабинете выбранного сервиса и указать в настройках.
Для Binlist API-ключ не нужен.
Валюты, для которых включена проверка BIN
Здесь выбираются валюты, для которых необходимо выполнять проверку банковских карт.
Например:
Для криптовалют и других направлений, где банковские карты не используются, включать проверку не требуется.
Если удалить валюту из списка и сохранить настройки, все правила по разрешённым и запрещённым банкам для этой валюты будут удалены.
Пошаговая настройка
Настройка банков
Для каждой валюты доступны четыре списка:
Разрешённые — Вход;
Разрешённые — Выход;
Запрещённые — Вход;
Запрещённые — Выход.
Каждый банк необходимо указывать с новой строки.
Что означает «Вход» и «Выход»
Вход — сторона заявки «Отдаю».
То есть карта клиента, с которой поступают средства.
Выход — сторона заявки «Получаю».
То есть карта, на которую обменный пункт отправляет выплату.
Разрешённые банки
Разрешённые банки определяют список банков, с которыми разрешено создавать заявки.
Если список заполнен, карты всех остальных банков будут отклоняться.
Если банк определить не удалось, клиент увидит сообщение:
Если банк найден, но отсутствует в разрешённом списке:
Пример
Разрешить принимать RUB только от двух банков.
В поле:
укажите:
После этого остальные банки использоваться не смогут.
Запрещённые банки
Запрещённые банки работают наоборот.
Если название банка совпало с одним из правил, система не позволит создать заявку.
Клиент увидит сообщение:
Пример
Чтобы запретить выплаты на карты определённого банка, откройте:
и укажите название банка.
После сохранения заявки на карты этого банка будут отклоняться.
Как сравниваются названия банков
Названия работают по принципу поиска части строки.
Например, внешний сервис вернул:
Достаточно указать правило:
и оно будет успешно найдено.
Рекомендуется использовать устойчивые и понятные части названий, чтобы случайно не заблокировать другие банки.
Как правильно добавлять банки
Самый безопасный способ настройки:
Включите проверку BIN.
Выберите сервис проверки.
Создайте тестовую заявку.
Посмотрите, какое название банка определила система.
Используйте именно это название при создании правил.
После настройки снова выполните тест.
Такой порядок значительно уменьшает вероятность ошибок.
Пример настройки
Разрешить только определённые банки
Порядок действий:
Откройте:
Включите проверку BIN.
Включите сохранение результатов проверки.
Выберите сервис.
При необходимости укажите API-ключ.
Выберите валюту RUB.
Сохраните настройки.
Нажмите:
В поле:
добавьте банки по одному в каждой строке.
Сохраните настройки банков.
После этого принимать карты смогут только указанные банки.
Что проверить после настройки
После завершения настройки рекомендуется проверить:
включена ли проверка BIN;
выбран ли сервис проверки;
указан ли API-ключ;
выбраны ли нужные валюты;
сохранены ли настройки;
определяется ли банк по тестовой карте;
правильно ли работают разрешённые и запрещённые списки;
отображается ли информация о карте в заявке.
Частые ошибки
Проверка не выполняется
Проверьте:
включена ли проверка BIN;
выбран ли сервис;
указан ли API-ключ;
выбрана ли валюта;
сохранены ли настройки;
является ли реквизит банковской картой.
Банк не определяется
Возможные причины:
сервис не знает этот BIN;
временно недоступен API;
неверный API-ключ;
превышен лимит запросов;
карта слишком новая;
выбранный сервис плохо работает с банками нужной страны.
Попробуйте использовать другой сервис или протестировать карту повторно.
Разрешённые банки не работают
Чаще всего причина в том, что название банка, указанное в правилах, не совпадает с тем, которое возвращает сервис.
Создайте тестовую заявку, посмотрите название банка и используйте его при настройке.
Запрещённые банки не работают
Если внешний сервис не смог определить банк, системе нечего сравнивать с запрещённым списком.
Проверьте работу сервиса проверки и результаты определения BIN.
Рекомендации
Всегда включайте кэширование результатов проверки.
Используйте только карточные валюты.
Перед включением ограничений протестируйте определение банков.
Не копируйте названия банков вручную — сначала посмотрите, как их определяет сервис.
Регулярно проверяйте работу API-ключа.
Ограничьте доступ к разделу только администраторам и ответственным менеджерам.
Безопасность
API-ключи сервисов проверки являются конфиденциальными.
Не публикуйте их в документации, переписках или открытых файлах.
Во внешний сервис передаётся только BIN карты — первые 6 цифр номера. Полный номер банковской карты передаваться не должен.
Несмотря на это, информация о банковских картах относится к чувствительным данным, поэтому доступ к разделу рекомендуется предоставлять только сотрудникам, которым действительно необходима работа с ним.
Коротко
Откройте: «Утилиты» — «Информация по картам»
Включите проверку BIN.
Включите сохранение результатов проверки.
Выберите сервис проверки.
При необходимости укажите API-ключ.
Выберите валюты, для которых нужна проверка.
Настройте разрешённые и запрещённые банки.
Создайте тестовую заявку.
Убедитесь, что банк определяется правильно и ограничения работают так, как ожидается.
Последнее обновление
Это было полезно?