Маршрутизация оплат по городу нужна, когда интернет-магазин использует несколько подключений Monobank или должен передавать в CRM разные способы оплаты в зависимости от региона покупателя. Типичная проблема выглядит так: клиент указал нужный город, но платеж прошел через общее подключение, а в CRM появился не тот метод. Чаще всего причина не в географии, а в том, как фактический текст города сопоставился с правилами.

Правила работают со строкой, полученной из заказа. Они не определяют область по административному справочнику и не считают автоматически, что «Киев», «г. Киев» и «Киевская обл.» — одно и то же. Поэтому проверку стоит строить вокруг реальных значений из тестового оформления заказа, порядка правил, наличия токена и отдельных параметров для полной и частичной оплаты.

Ключевые выводы

  • По умолчанию правило сравнивает название города точно: без учета регистра и пробелов в начале и конце, но без автоматического приравнивания префикса «г.» к его отсутствию.
  • Переключатель «Срабатывает, когда название города содержит этот текст» переводит правило в режим поиска фрагмента. Например, «Киев» может совпасть и с «г. Киев», и со строкой, где указано «Киевская обл.».
  • Точные правила имеют приоритет над правилами фрагмента независимо от их позиции. Среди правил одного режима используется первое подходящее.
  • Правило без настроенного токена не маршрутизирует платеж. Если подходящего правила нет, применяется общая конфигурация Monobank.
  • Одно городское правило может определять подключение Monobank, параметры записи в CRM и отдельные методы для полной и частичной оплаты. Запись в CRM в конкретном правиле может быть отключена.
  • Проверить нужно как минимум три сценария: город-исключение, населенный пункт нужной области и другой регион, который должен остаться на общей конфигурации.
Оплата за містом та областю: як перевірити маршрутизацію між рахунками й способами оплати CRM

Содержание

Как работает сопоставление города

Точное совпадение — это сравнение текста, а не адресов

В поле «Город (как на сайте)» задается текст, с которым система сравнивает значение из заказа. По умолчанию используется точное совпадение после удаления пробелов по краям и без учета регистра. Поэтому условные значения «Киев», «КИЕВ» и « Киев » могут соответствовать одному точному правилу.

В то же время «Киев» и «г. Киев» — разные строки. Префикс «г.» не отбрасывается автоматически. Система также не определяет, что Бровары относятся к Киевской области, если в полученной строке нет текста, на который настроено правило. Это важно для магазинов, где поле города заполняется вручную или формируется службой доставки в разных форматах.

Когда использовать поиск фрагмента

Переключатель «Срабатывает, когда название города содержит этот текст» позволяет искать заданный фрагмент внутри всей строки. Условное правило с текстом «Киевская обл.» может охватить адреса, где область указана вместе с районом и населенным пунктом. Но оно не охватит строку, в которой записано только «Бровары».

Широкие фрагменты требуют осторожности. Фрагмент «Киев» может совпасть с «г. Киев», «Киевская обл.» или другой строкой, содержащей эту последовательность символов. Это обычный текстовый поиск, а не распознавание административных границ.

Как определяется приоритет

Сначала учитываются точные правила, а затем правила поиска фрагмента. Точное совпадение имеет более высокий приоритет независимо от того, где правило расположено относительно частичных правил. Внутри одного режима срабатывает первое подходящее правило.

Например, магазин хочет направлять платежи из Киева на подключение А, а из остальной Киевской области — на подключение Б. Для города можно создать точное правило «г. Киев» или точное правило для другого фактического формата. Для области используется фрагмент «Киевская обл.». Если точное правило соответствует строке, оно получит приоритет над широким областным правилом.

Что подготовить перед настройкой

Соберите фактические строки из оформления заказа

Не исходите из предположения, что сайт всегда передает короткое название города. Оформите тестовый заказ и зафиксируйте значение именно в том виде, в котором оно попадает в заказ. Строка может содержать префикс, область, район или несколько частей адреса.

Минимальный набор контрольных значений должен включать:

  • город, для которого требуется отдельное подключение;
  • населенный пункт нужной области;
  • возможный альтернативный формат того же города;
  • город из другого региона для проверки общей конфигурации;
  • строку с названием области, если область планируется охватывать с помощью фрагмента.

Составьте карту ожидаемых маршрутов

Для каждого контрольного значения запишите ожидаемый результат до изменения настроек. Нужно отдельно указать подключение Monobank, параметр записи в CRM, метод полной оплаты и метод частичной оплаты. Такая карта не позволит смешать несколько разных ожиданий в одной формулировке «платеж должен пройти правильно».

Условный пример: «г. Киев» должен использовать подключение А, полную оплату записывать методом 11, частичную — методом 12. Строка с «Киевская обл.» должна использовать подключение Б и два других метода. Львов должен остаться на общей конфигурации. Номера методов здесь условные — используйте соответствия своего магазина.

Проверьте базовую платежную конфигурацию

Городское правило не исправит отсутствующее подключение: без настроенного токена оно не маршрутизирует платеж. Перед тестом проверьте общие настройки платежного виджета, провайдера и нужных подключений. Обзор того, где искать саму кнопку и как отличить виджет от штатной оплаты магазина, приведен в материале «Кнопка оплаты Monobank в Хорошопе: где ее искать и как проверить виджет LoyalShop».

Также заранее решите, нужно ли записывать платеж в CRM для каждого маршрута. В городском правиле эта запись может быть отключена, поэтому правильное банковское подключение само по себе еще не означает, что CRM получит ожидаемый метод.

Как построить правила для города и области

Сначала создайте узкие исключения

Самая безопасная схема — начинать с точных правил для городов, которым нужен особый маршрут. Для каждого правила используйте фактический формат из заказа, а не нормализованное название из справочника. Если сайт может передавать и «Киев», и «г. Киев», эти варианты стоит проверить отдельно.

  1. Возьмите фактическую строку города из контрольного оформления заказа.
  2. Создайте точное правило с этим значением.
  3. Выберите нужное подключение Monobank с настроенным токеном.
  4. Определите, должен ли платеж записываться в CRM.
  5. Установите соответствующие методы для полной и частичной оплаты.
  6. Повторите настройку для других точных исключений.

Точные правила удобны тем, что уменьшают риск случайно охватить соседние регионы или более длинные адресные строки. Их недостаток — необходимость учитывать фактические варианты написания.

После исключений добавьте областное правило

Чтобы охватить область, нужен фрагмент, который действительно присутствует в строке заказа. Например, если оформление передает «Буча, Киевская обл.», условный фрагмент «Киевская обл.» может подойти. Если передается только «Буча», такое правило не сработает, поскольку система не дополняет город названием области.

Включите режим «Срабатывает, когда название города содержит этот текст» и задайте достаточно конкретный фрагмент. Не используйте короткое слово только потому, что оно встречается в нужном регионе: оно может совпасть с нежелательными строками. После этого настройте подключение, запись в CRM и оба метода оплаты так же, как для точного правила.

Оставьте общую конфигурацию в качестве резервной

Если ни одно правило не соответствует городу, используется общая конфигурация. Это не обязательно ошибка: общий маршрут может выполнять роль резервного для всех регионов без специальных условий.

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

Как протестировать маршрутизацию

Используйте матрицу, а не один заказ

Одного успешного теста недостаточно. Он подтверждает только конкретную строку, конкретный тип оплаты и один маршрут. Минимальная матрица для правила города и области состоит как минимум из трех заказов:

  • Город-исключение. Должно сработать точное правило и выбрать специальное подключение.
  • Населенный пункт области. Должно сработать правило фрагмента, если название области присутствует в строке.
  • Другой регион. Ни одно специальное правило не должно совпасть; используется общая конфигурация.

Если магазин принимает и полную, и частичную оплату, каждый важный географический сценарий желательно проверить в обоих режимах. Это позволит увидеть, не перепутаны ли методы CRM для разных сумм оплаты.

Фиксируйте четыре результата каждого теста

Для каждого контрольного заказа запишите фактический текст города, правило, которое должно было сработать, выбранное подключение и ожидаемый способ оплаты CRM. Если запись в CRM для правила отключена, это тоже должно быть явно указано как ожидаемый результат, а не восприниматься как сбой.

Удобный формат проверки: «входное значение → режим совпадения → правило → подключение → полная или частичная оплата → метод CRM». Такая цепочка показывает, на каком этапе ожидание разошлось с результатом.

Проверяйте конфликты правил отдельно

Создайте тест, в котором строка потенциально соответствует точному и частичному правилу. Например, точное правило настроено на «г. Киев», а частичное — на «Киев». Ожидаемо должно сработать точное правило. Затем проверьте строку, которая не соответствует точному значению, но содержит фрагмент: тогда может примениться частичное правило.

Отдельный тест нужен и для двух частичных правил, которые могут совпасть с одной строкой. Внутри этого режима используется первое подходящее правило, поэтому порядок влияет на результат. Аналогичный принцип действует среди нескольких точных правил, хотя одинаковые точные значения лучше не дублировать без необходимости.

Как диагностировать неправильный маршрут

Платеж прошел через общее подключение

Начните со сравнения фактического текста города с правилом. Проверьте префикс «г.», наличие области, района и других частей строки. Регистр и пробелы по краям не должны быть решающими, но дополнительные символы внутри строки меняют точное совпадение.

Затем проверьте режим правила. Если ожидалось совпадение внутри более длинного адреса, но правило осталось точным, оно не сработает. Если текст соответствует, проверьте наличие настроенного токена: правило без него не маршрутизирует платеж.

Сработал не тот региональный маршрут

Просмотрите все точные правила, а не только правило области. Точное совпадение имеет более высокий приоритет, чем фрагмент, независимо от позиции. Если точного совпадения нет, проверьте порядок частичных правил: используется первое подходящее.

Слишком широкий фрагмент также может привести к ошибочному маршруту. Например, «Киев» охватывает больше строк, чем «Киевская обл.». Изменяйте фрагмент только после проверки реальных значений, а затем повторите тесты для города-исключения, области и другого региона. Такая проверка снижает риск исправить один сценарий и нарушить другой.

Банк выбран правильно, но метод CRM неправильный

Не сводите это к одной настройке. Одно и то же городское правило используется для выбора подключения Monobank и городских параметров записи в CRM, но методы полной и частичной оплаты задаются отдельно. Проверьте, какой именно тип оплаты был в тестовом заказе и какой метод ему соответствует.

Также убедитесь, что запись в CRM не отключена для этого правила. Правильный банковский маршрут не гарантирует появления ожидаемой записи, если передача отключена. Этот чек-лист касается подтвержденной маршрутизации Monobank; не следует автоматически переносить его на наложенный платеж или других платежных провайдеров.