Маршрутизация платежей по кошелькам в QryptoPay

QryptoPay умеет направлять новый платёж не на случайный кошелёк из общего пула, а на конкретный — по упорядоченному списку правил, которые вы задаёте во вкладке «Потоки платежей» карточки мерчанта. Это пригодится, если в одной сети у вас несколько активных кошельков и деньги должны расходиться по ним по правилам, а не наугад — например, платежи из одного региона на один кошелёк, а из другого — на другой, или крупные заказы отдельно от мелких.

Правила решают что-то только тогда, когда в сети минимум два активных кошелька, — как их завести и переключаться между сетями, рассказано в статье Управление кошельками в QryptoPay. Кошелёк Monero в любой момент активен только один, поэтому маршрутизация между несколькими XMR-кошельками не применима.

Вкладка «Потоки платежей»

Настройки маршрутизации живут отдельно от кошельков — на странице мерчанта, во вкладке «Потоки платежей» (идёт сразу после «Страница оплаты»). Вверху страницы — переключатель сети: правила и резервный маршрут настраиваются отдельно для каждой сети, переключение с одной сети на другую ничего не переносит.

Как устроено правило

Правило раскрывается в блок вида «если» … «то»:

• необязательное поле «Название правила» — до 60 символов, ярлык для самого мерчанта. На выбор кошелька название никак не влияет: это подпись для человека, а не часть условия. Пустое название в свёрнутом виде правило показывает как «Без названия»;
• одна или несколько групп условий, разделённых словом «или» — правило срабатывает, если подошла хотя бы одна группа целиком. Новую группу добавляет кнопка «Добавить группу „или“»;
• внутри группы строки соединены словом «и» — группа засчитывается, только если верны все её строки. Это же говорит и сам интерфейс рядом с меткой «если»: «верны все строки», пока группа одна, и «верна одна из групп», как только их становится больше;
• кошелёк-получатель — под условием, рядом с подписью «платёж принимает кошелёк», это и есть часть «то».

Строка внутри группы — одного из двух видов, их добавляет меню «Добавить строку»:

• «Параметр магазина» — пара «ключ = значение». Ключ — тот же, что вы передаёте в metadata при генерации платёжной ссылки (см. Интеграция магазина с QryptoPay), например location. Значение сравнивается без учёта регистра: usa и USA — одно и то же. Таких строк в группе можно добавить сколько угодно.
• «Сумма заказа» — поля «От» и «До», диапазон в долларах без учёта комиссии за оплату криптовалютой. Такая строка в группе только одна: пока она есть, повторно добавить её нельзя.

Верхняя граница суммы не включается

У поля «До» в интерфейсе больше нет пометки об этом — расскажем здесь. Верхняя граница диапазона в условие не входит: заказ ровно на эту сумму строку не проходит и проверяется дальше — следующей группой или следующим правилом. Например, диапазон от $0 до $500 заберёт заказ на $499.99, но не заказ ровно на $500. Пустое поле «До» означает, что верхней границы нет.

Порядок правил и есть приоритет

Список читается сверху вниз, и платёж достаётся первому правилу, чьё условие подошло, — отдельного числового приоритета в интерфейсе больше нет. Переставить правила можно кнопками ↑ и ↓ у каждой строки.

Если кошелёк, на который указывает правило, отключён, при подборе правило пропускается — шанс получает следующее правило по списку. Если такой кошелёк удалить вовсе, правило удаляется вместе с ним.

Если ни одно правило не подошло

Это не отдельный блок в стороне от правил, а подвал того же списка — переключатель «Если ни одно правило не подошло». Два режима:

• «Случайный кошелёк из пула» — режим по умолчанию: платёж уходит на случайный активный кошелёк сети, как было бы без маршрутизации вовсе.
• «Выбранный кошелёк» — все несовпавшие платежи идут на один и тот же кошелёк, который вы укажете рядом.

⚠️ Недоступный кошелёк — отказ в оплате

Если выбранный кошелёк станет недоступен, платёж клиента завершится ошибкой.

Иначе говоря, режим «Выбранный кошелёк» не подстраховывает себя пулом: отключите или удалите назначенный кошелёк — и покупатель, чей платёж не подошёл ни под одно правило, не сможет оплатить вовсе, вместо того чтобы уйти на случайный кошелёк из пула. Держите этот режим включённым, только пока назначенный кошелёк точно активен.

Как проверить, куда ушёл платёж

На карточке платежа, под блоком «Кошелёк QryptoPay», панель показывает, почему платёж попал именно туда:

• если сработало правило — строку вида «Правила при оплате: location = dubai · сумма от $500 до $5000»;
• если платёж ушёл на кошелёк по умолчанию — «Кошелёк выбран по умолчанию»;
• если платёж взят из общего пула или принят до появления этой возможности — строки не будет вовсе.

Это снимок решения на момент платежа, а не текущая настройка правил: измените правила позже — у уже принятых платежей объяснение не изменится.

Что дальше

• Управление кошельками в QryptoPay — балансы, резерв на комиссии, отключение кошелька.
• Интеграция магазина с QryptoPay — как передать metadata, на которую опираются условия по параметру магазина.
• Настройка комиссий для валют в QryptoPay — комиссия считается от той же суммы заказа, что участвует в условии по сумме.