Мерчанты
Создание мерчанта, суммы, лимиты, статусы, безопасность и проверка приёма платежа
Мерчант принимает оплату клиента, выдаёт платёжные данные или ссылку и сообщает системе о результате. Настройка мерчанта состоит из самого подключения, поддерживаемых валют, правил суммы, защиты и отдельной связи с направлением.
Для работы требуется право «Разрешить доступ к мерчанту» из блока «Мерчанты и выплаты». Просмотр закрытых параметров и управление их защитой выдаются отдельными правами.
Список
В панели управления откройте:
«Мерчанты и API» — «Список мерчантов»
В списке видны название, провайдер, статус, поддерживаемые валюты, число заявок, объём, приоритет, состояние подключения и время проверки. Фильтры ищут по названию, провайдеру, статусу и датам.
Состояния «Шлюз доступен», «Ошибка» и «Нет данных» относятся к проверке подключения. Они не заменяют тестовую оплату и callback.
Создание мерчанта
Нажмите «Добавить мерчант».
Выберите «Провайдер».
Укажите понятное внутреннее «Название».
Оставьте статус отключённым.
Нажмите «Добавить».
Откройте созданную карточку и завершите настройку.
Нельзя безопасно включить пустую оболочку модуля. Сначала заполните соединение, суммы, лимиты и правила, затем выполните тест.
Вкладка «Основное»
Укажите статус, название и поддерживаемые валюты. Список валют ограничивает применимость сервиса, но фактический выбор также зависит от правила мерчанта и сети.
Не выбирайте валюту только по общему коду актива. Проверьте платёжную систему и сеть, которую реально обслуживает провайдер.
Тексты для клиента
«Инструкция по оплате» отображается клиенту на платёжном этапе. «Примечание для платежа» помогает сотруднику понять особенности провайдера.
Заполните клиентскую инструкцию на всех активных языках. Не помещайте в неё секреты подключения, внутренние пороги или данные другого клиента.
Редактор этих полей предлагает разрешённые теги заявки. Используйте их для номера, сумм и других динамических значений вместо ручного копирования данных. Перед рабочим включением проверьте подстановки на тестовой заявке: недоступный или ошибочно написанный тег может остаться пустым либо отображаться как текст. Пользовательские подстановки описаны в статье «Обработчики тегов».
Суммы и допуски
Настройте:
«Погрешность суммы платежа»;
«Сумма к оплате (для клиента)»;
«Сумма, которая должна быть зачислена».
Для суммы выбирается одна из баз:
«Сумма (с доп. комиссией)»;
«Сумма (с комиссией доп. и ПС)»;
«Сумма (без комиссий)».
Погрешность принимает число или процент в формате, указанном подсказкой. Она используется при сравнении фактического поступления с ожидаемым. Слишком широкий допуск может признать неверную оплату подходящей.
Лимиты мерчанта
Настройте:
дневной объём;
месячный объём;
минимальную сумму одной заявки;
максимальную сумму одной заявки;
дневное количество заявок;
месячное количество заявок.
Нулевое значение означает отсутствие соответствующего ограничения. Лимиты карточки действуют вместе с лимитами правил мерчантов. При отказе выбора проверяйте оба уровня.
Доступ и безопасность
«Включить кнопку в мерчанте „Отменить заявку“» разрешает клиентское действие на странице провайдера. Проверьте, в какой статус переходит заявка и освобождается ли резерв.
«Запретить управлять заявкой с другого IP адреса» ограничивает управление исходным или разрешённым адресом. В поле «Разрешенные IP адреса» можно вводить IPv4, IPv6 или диапазоны в поддерживаемом формате, разделяя значения запятой или новой строкой.
Не включайте ограничение до проверки реального маршрута клиента и доверенных прокси. Иначе легитимный возврат на платёжную страницу может быть заблокирован.
Приоритет и расхождение суммы
Чем выше «Приоритет», тем раньше мерчант рассматривается при одинаковых условиях. Отдельно задаются действия:
«Если сумма поступления меньше чем требуется в заявке»;
«Если сумма поступления больше чем требуется в заявке».
Доступные решения включают признание операции мошеннической, пересчёт с проверкой и перевод в один из рабочих статусов. Выбирайте действие по политике контроля риска. Для недоплаты безопаснее требовать проверку, чем автоматически считать заявку оплаченной.
Вкладка «Соединение»
Набор полей зависит от выбранного провайдера. Панель показывает только параметры установленного модуля. Заполняйте их по названиям формы и инструкции конкретного сервиса.
Callback-адреса «Return URL», «Success URL» и «Failed URL» копируйте кнопками панели. Если используется «Секретный ключ», итоговый callback может включать его. Не отправляйте такие адреса посторонним.
Если карточка сообщает, что файл модуля повреждён, не включайте мерчант. Восстановите или переустановите модуль и повторно проверьте его целостность.
Для провайдера iEXWallet используются точные поля «API domain», «API ID», «API Key», «API secret» и «Callback secret». Порядок создания депозита, настройки callback и проверки сети описан в статье «Подключение iEXWallet».
Вкладка «Настройки» и «Опции»
«Настройки» содержит общие суммы, лимиты, безопасность и поведение статусов. «Опции» появляется только если модуль предоставляет дополнительные поля. Значение по умолчанию берётся из модуля, но его пригодность нужно подтвердить для вашего договора с провайдером.
Общие настройки логирования
Кнопка «Настройки» на странице списка открывает «Общие настройки мерчанта». Флаг «Логирование запросов мерчанта» управляет сохранением запросов к шлюзам приёма платежей.
Включайте логирование на запуске и при диагностике. Учитывайте, что журнал может содержать платёжный контекст и доступен только доверенным сотрудникам.
Подключение к направлению
Создайте правило по инструкции «Правила мерчантов и выплат». Сам статус мерчанта не заставляет направление использовать его.
Полная проверка
Проверьте состояние соединения.
Создайте правило только для тестового направления.
Создайте заявку внутри лимитов.
Сверьте сумму, валюту, сеть и инструкцию.
Откройте платёжную страницу.
Проверьте успешный callback.
Проверьте недоплату и переплату безопасными тестовыми значениями.
Проверьте повторный callback.
Сверьте карточку заявки и три журнала.
Только после этого включайте рабочую область.
Подключение готово к рабочему использованию, когда тестовая оплата получает ожидаемый статус, повторный callback не создаёт повторную операцию, суммы совпадают в карточке и журналах, а правило не выбирает мерчант вне разрешённых валют, сетей и лимитов.
Последнее обновление
Это было полезно?