.. meta:: :description: Конфигурация Routing & Balancing в UI менеджера Payneteasy: маршрутизация транзакций по шлюзам с помощью стратегии, правил балансировки и логики каскадной цепочки. .. _routingandbalancing: Routing & Balancing ################### .. role:: ex .. role:: code .. .. |exclamation| image:: ../_static/images/rbexclamation.png .. |a| image:: ../../../_static/images/rbpic41.png .. |b| image:: ../../../_static/images/rbpic42.png .. |c| image:: ../../../_static/images/rbpic43.png .. .. |d| image:: ../../../_static/images/rbpic44.png .. |e| image:: ../../../_static/images/rbpic452.png .. |f| image:: ../../../_static/images/rbpic46.png .. |g| image:: ../../../_static/images/rbpic472.png .. |h| image:: ../../../_static/images/rbpic48.png .. .. |i| image:: ../../../_static/images/rbpic49.png .. .. |j| image:: ../../../_static/images/rbpic50.png .. .. |k| image:: ../../../_static/gif/gif_sct.gif .. .. |l| image:: ../../../_static/gif/gif_play.gif .. .. |m| image:: ../../../_static/gif/gif_stop.gif .. .. |n| image:: ../../../_static/gif/gif_options.gif .. |o| image:: ../../../_static/images/rbdelete1.png .. |p| image:: ../../../_static/images/rbdelete2.png .. |q| image:: ../../../_static/images/rbcopypaste1.png .. |r| image:: ../../../_static/images/rbcopypaste2.png .. |s| image:: ../../../_static/images/rbcopypaste3.png .. |t| image:: ../../../_static/images/rbrecurring.png .. |u| image:: ../../../_static/images/rbchainstrat.jpg .. .. |v| image:: ../../../_static/gif/addbalancingrow.gif .. .. |w| image:: ../../../_static/gif/deletenode.gif .. .. |x| image:: ../../../_static/gif/creategroup.gif .. |d| image:: ../../../_static/images/ignoreN.png .. |i| image:: ../../../_static/images/ignoreY.png General Information ------------------- The routing & balancing system allows to distribute traffic between payment gates flexibly depending on the defined criteria and customer's transaction data. Traffic can be routed to a specific group of gates/processors and distributed between them in accordance with the specified balancing. The balancing is configured on the system :ex:`Project` level in the :ex:`Routing & Balancing` tab. | Для начала конфигурации необходимо выбрать один из типов маршрутизации: .. image:: ../../../_static/images/rbpic1.png :width: 700 :align: center :alt: Описание: pic1 balancing 2.0 New routing block will be created. Each routing block has it's own ID for easier navigation in big projects. The :ex:`Source Card Type` routing type is taken as an example: .. image:: ../../../_static/images/rbpic2.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 Наведите курсор на название этого блока, чтобы выбрать одно из следующих действий: | |f| — :ex:`Добавить строку маршрутизации` — добавить опции для этого блока: .. image:: ../../../_static/images/gif_sct1.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 Выберите типы карт из предоставленного списка: .. image:: ../../../_static/images/gif_sct2.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | .. image:: ../../../_static/images/gif_sct3.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | | |e| — :ex:`Удалить узел` — выбрать другой блок маршрутизации или балансировки вместо этого. Наведите курсор на любой критерий этого блока, чтобы выбрать одно из следующих действий: | |a| — :ex:`Продолжить маршрутизацию` — выбрать новый блок маршрутизации и продолжить стратегию маршрутизации. | .. image:: ../../../_static/images/gif_play1.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | .. image:: ../../../_static/images/gif_play2.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | | |b| — :ex:`Добавить балансировку` — остановить маршрутизацию и добавить блок балансировки. | .. image:: ../../../_static/images/gif_stop1.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | .. image:: ../../../_static/images/gif_stop2.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | | |c| — включить, отключить или удалить опцию маршрутизации. | .. image:: ../../../_static/images/gif_options1.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | .. image:: ../../../_static/images/gif_options2.png :width: 450 :align: center :alt: Описание: pic2 balancing 2.0 | Опция по умолчанию с именем :ex:`OTHERS` присутствует всегда, она применяется к транзакциям, которые не соответствуют всем остальным созданным опциям. Если созданных вариантов маршрутизации достаточно, нажмите кнопку :ex:`Add balancing` |b|, чтобы добавить один из типов балансировки с платёжными шлюзами. В качестве примера используется :ex:`Баланс по коэффициенту на основе суммы транзакции`: | .. image:: ../../../_static/images/rbpic8.png :width: 700 :align: center :alt: Описание: pic8 balancing 2.0 Blocks are connected by arrows to improve the visual presentation. An arrow is directed from a certain routing option to the block created from it. If the transaction parameters match the specified routing option, it is forwarded further along the arrow. Наведите курсор на название этого блока, чтобы выбрать одно из следующих действий: | |g| — :ex:`Добавить строку балансировки` — добавляет строку с активными полями для указания шлюза: | .. image:: ../../../_static/images/addbalancingrow1.png :width: 450 :align: center :alt: Описание: pic9 balancing 2.0 | .. image:: ../../../_static/images/addbalancingrow2.png :width: 450 :align: center :alt: Описание: pic9 balancing 2.0 | - Платёжный шлюз — самое длинное поле используется для выбора одного из доступных платёжных шлюзов. - Процент вероятности — крайнее левое поле. Этот процент определяет вероятность направления транзакции в данный шлюз. Поле существует только для типов балансировки с указанным коэффициентом. - Три пустых поля внизу используются для переопределения тарифов оплаты. | |e| — :ex:`Удалить узел` — выбрать другой блок маршрутизации или балансировки вместо этого. | .. image:: ../../../_static/images/deletenode1.png :width: 450 :align: center :alt: Описание: pic1 balancing 2.0 .. image:: ../../../_static/images/deletenode2.png :width: 450 :align: center :alt: Описание: pic1 balancing 2.0 | |h| — :ex:`Создать группу` — создать группу балансировки. | .. image:: ../../../_static/images/creategroup1.png :width: 450 :align: center :alt: Описание: pic1 balancing 2.0 Выберите группу балансировки из предоставленного списка: | .. image:: ../../../_static/images/creategroup2.png :width: 450 :align: center :alt: Описание: pic1 balancing 2.0 | .. image:: ../../../_static/images/creategroup3.png :width: 450 :align: center :alt: Описание: pic1 balancing 2.0 | .. image:: ../../../_static/images/rbpic9.png :width: 450 :align: center :alt: Описание: pic9 balancing 2.0 If the transaction meets the created route conditions, it will be forwarded to the balancing block with this payment gate. For more routing criteria, click the :ex:`Add routing row` of the required criterion, then create the subsequent transaction path from it. New block appears to the right of the selected criterion with a new number and routing type name. | В качестве примера используется тип маршрутизации :code:`BIN карты источника`: | .. image:: ../../../_static/images/rbpic10.png :width: 700 :align: center :alt: Описание: pic10 balancing 2.0 | There is already an "OTHERS" default criterion below. As in the first case, click the :ex:`Add routing row` to add the appropriate criterion. Depending on the required routing strategy and the traffic separation level, go on building the routes or finish the route by adding one of the :ex:`Balancing types` and clicking :ex:`Add balancing row` to add the payment gate. The final configuration might look as the following: | .. image:: ../../../_static/images/route2.png :width: 700 :align: center :alt: Описание: pic11 balancing 2.0 | .. note:: См. информацию ниже, чтобы узнать, какие типы :ref:`маршрутизации` и :ref:`балансировки` доступны и какая :ref:`дополнительная конфигурация` может применяться. After the Routing & Balancing configuration is set, enable it by going to the "Project" menu, clicking the "Edit" button and selecting the "Use new balancing" check box at the bottom of the page. To confirm the selection, click "Update". | .. image:: ../../../_static/images/rbpic11new.png :width: 700 :align: center :alt: Описание: pic11 balancing 2.0 Теперь применяется Routing & Balancing, и весь трафик будет проходить через неё. .. _routing_types: Routing Types ------------- В Routing & Balancing используется несколько "типов маршрутизации" для более гибкой настройки маршрутов транзакций. Типы маршрутизации :code:`Routing types` — это фильтры, позволяющие задать разделение трафика. В зависимости от выбранного типа маршрутизации поток транзакций будет проверяться относительно его параметров. В Routing & Balancing такие типы маршрутизации представлены следующим образом: Source Card ^^^^^^^^^^^ 1) Тип маршрутизации :code:`Source Card Type` позволяет сортировать транзакции по типу карты отправителя. Выберите подходящие способы оплаты отправителя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic12.png :width: 400 :align: center :alt: Описание: pic12 balancing 2.0 | 2) The :code:`Card Range` routing type allows to sort transactions by the sender's card BIN value. Specify bin and choose the needed BIN range of the sender and build a further route based on it. Several BIN ranges can be found for the specified BIN value. Select the one with lower priority. There is an option to search cards by their BINs. System can search for up to 500 entered card BINs listed one after another and separated by commas. They can be chosen by pressing the :code:`BINs -` button. .. image:: ../../../_static/images/rbScreenshot_208.png :width: 400 :align: center :alt: Описание: card range balancing 2.0 | .. image:: ../../../_static/images/rbpic63.png :width: 650 :align: center :alt: Выбрать BIN источника balancing 2.0 | .. image:: ../../../_static/images/rbpic65.png :width: 250 :align: center :alt: Выбрать BIN источника balancing 2.0 | 3) The :code:`Source Card Bank` routing type allows to sort transactions by the sender's Issuer Bank name. Select the needed names of sender’s Issuer Banks and build a further route based on them. There is an option to search Banks by their names. System can search for up to 500 entered Bank names listed one after another and separated by commas. They can be chosen by pressing the "By name -" button. .. image:: ../../../_static/images/rbpic14.png :width: 300 :align: center :alt: Описание: pic14 balancing 2.0 | .. image:: ../../../_static/images/rbpic64.png :width: 700 :align: center :alt: Описание: pic64 balancing 2.0 | .. image:: ../../../_static/images/rbpic66.png :width: 300 :align: center :alt: Описание: pic66 balancing 2.0 4) Тип маршрутизации :code:`Source Card Country` позволяет сортировать транзакции по стране карты отправителя. Выберите нужные страны отправителя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic15.png :width: 350 :align: center :alt: Описание: pic15 balancing 2.0 5) Тип маршрутизации :code:`Source Card Credit Source` позволяет сортировать транзакции по типу карты отправителя. Выберите нужные типы карт отправителя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbsccs.png :width: 300 :align: center :alt: Описание: sccs balancing 2.0 Destination Card ^^^^^^^^^^^^^^^^ 1) Тип маршрутизации :code:`Destination Card Type` позволяет сортировать транзакции по типу карты получателя. Выберите нужные типы карт получателя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic17.png :width: 350 :align: center :alt: Описание: pic17 balancing 2.0 | 2) The :code:`Card Range` routing type allows to sort transactions by the receiver’s card BIN value. Specify bin and choose the needed BIN range of the receiver and build a further route based on it. Several BIN ranges can be found for the specified BIN value. Select the one with lower priority. There is an option to search cards by their BINs. System can search for up to 500 entered card BINs listed one after another and separated by commas. They can be chosen by pressing the "BINs -" button. .. image:: ../../../_static/images/rbScreenshot_209.png :width: 350 :align: center :alt: Диапазон карт получателя balancing 2.0 | .. image:: ../../../_static/images/rbpic63.png :width: 700 :align: center :alt: Выбрать BIN получателя balancing 2.0 | .. image:: ../../../_static/images/rbpic65.png :width: 300 :align: center :alt: Выбрать BIN получателя balancing 2.0 | 3) The :code:`Destination Card Bank` routing type allows to sort transactions by the receiver’s Issuer Bank name. Select the needed Issuer Bank names of the receiver and build a further route based on them. There is an option to search Banks by their names. System can search for up to 500 entered Bank names listed one after another and separated by commas. They can be chosen by pressing the "By name -" button. .. image:: ../../../_static/images/rbpic19.png :width: 350 :align: center :alt: Описание: pic19 balancing 2.0 | .. image:: ../../../_static/images/rbpic64.png :width: 700 :align: center :alt: Описание: pic64 balancing 2.0 | .. image:: ../../../_static/images/rbpic66.png :width: 350 :align: center :alt: Описание: pic66 balancing 2.0 | 4) Тип маршрутизации :code:`Destination Card Country` позволяет сортировать транзакции по стране карты получателя. Выберите требуемые страны карт получателя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic20.png :width: 350 :align: center :alt: Описание: pic20 balancing 2.0 | 5) Тип маршрутизации :code:`Destination Card Credit Source` позволяет сортировать транзакции по типу карты получателя. Выберите нужные типы карт получателя и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbdccs.png :width: 350 :align: center :alt: Описание: rccs balancing 2.0 Customer ^^^^^^^^ 1) Тип маршрутизации :code:`Customer Account Number Country` позволяет сортировать транзакции, подключая выбранные страны к одному провайдеру, а остальные — к другому. Этот тип маршрутизации используется для транзакций Payout. Страна и банк определяются по IBAN (International Bank Account Number), сформированному в соответствии с `ISO 13616 `_. .. image:: ../../../_static/images/rb61_upd.png :width: 700 :align: center :alt: Описание: pic61_new balancing 2.0 2) Тип маршрутизации :code:`Customer IP Country` позволяет сортировать транзакции по стране IP-адреса клиента. Выберите страны, IP-адреса которых будут проверяться, и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic22.png :width: 350 :align: center :alt: Описание: pic22 balancing 2.0 3) Тип маршрутизации :code:`Customer IP Range` позволяет сортировать транзакции, значения IP-адресов которых находятся в указанном диапазоне. Укажите подходящий диапазон IP и постройте на его основе дальнейший маршрут. Допускаются IPv4 и IPv6. .. image:: ../../../_static/images/rbpic23.png :width: 350 :align: center :alt: Описание: pic23 balancing 2.0 4) Тип маршрутизации :code:`Customer Billing Country` позволяет сортировать транзакции по стране из платёжного адреса клиента. Выберите нужные страны и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic24.png :width: 350 :align: center :alt: Описание: pic24 balancing 2.0 5) Тип маршрутизации :code:`Лояльность клиента` разделён на :ex:`эндпоинт, проект, торговец, менеджер`. На каждом из этих уровней есть поле :ex:`Количество сессий одобрения возвращающегося клиента`, которое могут задавать для :code:`Менеджеров` пользователи с ролью :code:`Superior`, а для :code:`Проектов`, :code:`Эндпоинтов` и :code:`Торговцев` — пользователи с ролью :code:`Менеджер`. Это значение задаёт количество транзакций, после которого клиент будет считаться «ВОЗВРАЩАЮЩИМСЯ». По умолчанию Клиент определяется по карте. Определение возможно по :ex:`номеру карты, адресу электронной почты, держателю карты и адресу электронной почты, держателю карты и назначению, держателю карты и телефону`. Подсчёт транзакций начинается после изменения определения (для каждого типа определения хранится собственное количество транзакций). Определение клиента задаётся в соответствующем поле :ex:`Определение клиента` на уровне Проекта или Эндпоинта (настройка Эндпоинта имеет приоритет над настройкой Проекта). Summary: - :code:`RETURNING_FOR_MANAGER` — подсчёт одобрений на уровне Manager, определение клиента на уровне Project/Endpoint. - :code:`RETURNING_FOR_MERCHANT` — подсчёт одобрений на уровне Merchant, определение клиента на уровне Project/Endpoint. - :code:`RETURNING_FOR_ENDPOINT` — подсчёт одобрений на уровне Endpoint, определение клиента на уровне Project/Endpoint. - :code:`RETURNING_FOR_PROJECT` — подсчёт одобрений на уровне Project, определение клиента на уровне Project/Endpoint. .. image:: ../../../_static/images/rbpic25.png :width: 350 :align: center :alt: Описание: pic25 balancing 2.0 Логика маршрутизации проверяется последовательно, поэтому транзакция проходит по первому маршруту, удовлетворяющему условию. Например, следующий маршрут сначала проверит лояльность :ex:`merchant`, а затем :ex:`manager`. .. image:: ../../../_static/images/rbpic26.png :width: 350 :align: center :alt: Описание: pic26 balancing 2.0 6) типы маршрутизации :code:`Recurring` и :code:`Non_recurring` позволяют сортировать транзакции в зависимости от того, является ли тип транзакции рекуррентным. .. image:: ../../../_static/images/rbrecurring.png :width: 350 :align: center :alt: Описание: pic28 balancing 2.0 7) Тип маршрутизации по :code:`purpose` позволяет сортировать транзакции по назначению. В каждую строку маршрутизации можно ввести несколько значений назначения. Новые значения добавляются кнопкой Add при редактировании или создании. Назначение ограничено 128 символами. View: .. image:: ../../../_static/images/purpose_valuenew.png :width: 400 :align: center :alt: Описание: purpose value 2.0 Edit: .. image:: ../../../_static/images/purpose_valueedit.png :width: 400 :align: center :alt: Описание: purpose value edit 2.0 8) by :code:`Phone IMEI` (IMEI or International Mobile Equipment Identity) — this is the individual number of the mobile equipment. It is possible to enter more than one IMEI value to each routing row. IMEI limited to 32 symbols. View: .. image:: ../../../_static/images/phone_imeinew.png :width: 400 :align: center :alt: Описание: phone imei 2.0 Edit: .. image:: ../../../_static/images/phone_imeiedit.png :width: 400 :align: center :alt: Описание: phone imei edit 2.0 9) by :code:`Customer Instance` routing type allows to sort transactions based on Customer payment history for the whole instance. Please contact tech Support manager to enable this functionality. Select the Customer type for instance and build a further route based on them. The client is defined as :code:`NEW` or :code:`RETURNING` based on criteria set on the Project level (by default) or Endpoint level (if specified). This option is called :ex:`Client definition`. Definition is possible by :ex:`card number`, :ex:`email`, :ex:`card holder and email`, :ex:`card holder and purpose`, :ex:`card holder and phone`. .. image:: ../../../_static/images/customerinstance.png :width: 400 :align: center :alt: customerinstance 1.0 .. note:: This option should only be used together with internal KYC procedures as it checks for existing payment history and doesn't count any negative activity. 10) by :code:`Customer site url` routing type allows to sort transactions based on customer's site URL. It is possible to enter more than one site url value to each routing row. Site URL is limited to 128 symbols. View: .. image:: ../../../_static/images/site_url_in_routing.png :width: 400 :align: center :alt: routing by site URL Edit: .. image:: ../../../_static/images/add_multiple_site_urls.png :width: 400 :align: center :alt: routing by site URL edit .. note:: The Customer Site URL routing type does not account for formatting differences. The URL in the initial request must exactly match the URL specified in the routing node. Транзакция ^^^^^^^^^^^ 1) Тип маршрутизации :code:`Транзакция Amount` позволяет сортировать транзакции по суммам. Число в квадратной скобке включается в диапазон, а число в круглой скобке не включается. Например, чтобы указать сумму от 0 до 100 (включая 100), используйте [0, 100.01). Транзакции, суммы которых соответствуют указанному диапазону, пройдут через этот критерий маршрутизации. .. image:: ../../../_static/images/rbamount.png :width: 200 :align: center :alt: Описание: amount balancing 2.0 2) Тип маршрутизации :code:`Тип транзакции` позволяет сортировать транзакции по их типу. Выберите нужные типы транзакций и постройте дальнейший маршрут на их основе. .. image:: ../../../_static/images/rbpic27.png :width: 350 :align: center :alt: Описание: pic27 balancing 2.0 3) Тип маршрутизации :code:`Кратность суммы` позволяет сортировать транзакции по их суммам, соответствующим указанным множителям. Добавьте кратность суммы, и транзакция будет маршрутизироваться по наибольшей сумме, кратной ей. Пример: если сумма транзакции равна 1000, а «Кратность суммы» задана как 1000 и 500, транзакция будет направлена на 1000; если сумма транзакции равна 1500 — на 500, а если 2000 — на 1000. .. image:: ../../../_static/images/rbScreenshot_206.png :width: 350 :align: center :alt: Кратность balancing 2.0 4) Тип маршрутизации :code:`Транзакция Time` позволяет сортировать транзакции по времени их создания в системе. Часовой пояс GMT+3. Этот тип сортировки можно использовать для технических перерывов Процессора или в иных случаях, когда для маршрута необходимо время. Например, чтобы задать время с 22:00 до 06:00, установите его так: [22:00:00, 23:59:59], [00:00:00, 06:00:00]. .. image:: ../../../_static/images/rbtransaction_time_route.png :width: 350 :align: center :alt: Описание: time balancing 2.0 5) Тип маршрутизации :code:`День недели` позволяет сортировать транзакции по дню недели. Выберите нужный день недели и часовой пояс для дальнейшего маршрута на их основе. .. image:: ../../../_static/images/dayofweek.png :width: 400 :align: center :alt: Описание: Day of week 2.0 Transfer ^^^^^^^^ 1) Тип маршрутизации :code:`Transfer Direction` позволяет сортировать транзакции Transfer по типам карт или банкам-эмитентам отправителя и получателя. Выберите нужные параметры и постройте на их основе дальнейший маршрут. .. image:: ../../../_static/images/rbpic28.png :width: 500 :align: center :alt: Описание: pic28 balancing 2.0 IP Intelligence ^^^^^^^^^^^^^^^ .. Warning:: If Fraud Service - "MaxMind IP check service" is selected on project level, then regardless of whether "fraud filters" or "routing&balancing" are set up - all requests will be sent to Max Mind. | 1) Тип маршрутизации :code:`Anonymous vpn` позволяет проверить, считается ли IP-адрес Плательщика анонимным VPN по данным MaxMind. :code:`YES` — если условие истинно, :code:`NO` — если ложно. Выберите необходимые параметры и настройте маршрут. .. image:: ../../../_static/images/maxmind/anonymous_vpn.png :width: 450 :align: center :alt: anonymous_vpn 2) Тип маршрутизации :code:`Anonymous IP address` позволяет проверить, считается ли IP-адрес Плательщика анонимным по данным MaxMind. :code:`YES` — если условие истинно, :code:`NO` — если ложно. Выберите необходимые параметры и настройте маршрут. .. image:: ../../../_static/images/maxmind/anonymous_ip_address.png :width: 450 :align: center :alt: anonymous_ip_address 3) Тип маршрутизации :code:`Hosting provider` позволяет проверить, принадлежит ли IP-адрес Плательщика хостинг- или VPN-провайдеру, определённому сервисом MaxMind. :code:`YES` — если условие истинно, :code:`NO` — если условие ложно. Выберите необходимые параметры и настройте дальнейшую маршрутизацию на их основе. .. image:: ../../../_static/images/maxmind/hosting_provider.png :width: 450 :align: center :alt: hosting_provider 4) Тип маршрутизации :code:`Public proxy` позволяет проверить, принадлежит ли IP-адрес Плательщика публичному прокси по данным MaxMind. :code:`YES` — если условие истинно, :code:`NO` — если ложно. Выберите необходимые параметры и настройте маршрут. .. image:: ../../../_static/images/maxmind/public_proxy.png :width: 450 :align: center :alt: public_proxy 5) Тип маршрутизации :code:`Residential proxy` позволяет проверить, принадлежит ли IP-адрес Плательщика хостинг- или VPN-провайдеру, определённому сервисом MaxMind. :code:`YES` — если условие истинно, :code:`NO` — если условие ложно. Выберите необходимые параметры и настройте дальнейшую маршрутизацию на их основе. .. image:: ../../../_static/images/maxmind/residential_proxy.png :width: 450 :align: center :alt: residential_proxy 6) :code:`Tor exit node` routing type allows to check when Payer IP address is Tor exit node considered by MaxMind service. :code:`YES` - if condition is true, :code:`NO` - if condition is false. Select the needed parameters and build a further route based on them. .. image:: ../../../_static/images/maxmind/tor_exit_node.png :width: 450 :align: center :alt: tor_exit_node 7) :code:`Static IP score` routing type allows to check when Payer IP address Static IP score which is considered by MaxMind service is lower or equal to the settled threshold value. Higher values mean a greater static association. For example, many IP addresses with a user type of cellular have a score under one. Broadband IPs that don’t change very often typically have a score above thirty. This indicator can be useful for deciding whether an IP address represents the same user over time. The value ranges from :code:`0` to :code:`99.99`. Select the needed parameters and build a further route based on them. .. image:: ../../../_static/images/maxmind/static_ip_score.png :width: 450 :align: center :alt: static_ip_score 8) Тип маршрутизации :code:`User count` позволяет проверить, превышает ли или равняется ли количество пользователей IP-адреса плательщика, определённое службой MaxMind, заданному пороговому значению. Это оценочное количество пользователей, использовавших IP-адрес/сеть за последние 24 часа. Для IPv4 учитывается отдельный IP-адрес, для IPv6 — сеть /64. Выберите нужные параметры и постройте дальнейший маршрут на их основе. .. image:: ../../../_static/images/maxmind/user_count.png :width: 450 :align: center :alt: user_count .. _balancing_types: Balancing Types --------------- :code:`Balancing type` — это функция, которая позволяет распределять транзакции между платёжными шлюзами в соответствии с настроенными параметрами. .. note:: Шлюз также можно указать непосредственно в конечной точке. Однако он всё равно будет подчиняться стратегии маршрутизации, но будет выбираться для всех транзакций, поступающих из этой конечной точки по данному маршруту. В системе представлены следующие типы балансировки: Balance By Coefficient ^^^^^^^^^^^^^^^^^^^^^^ 1) :code:`Balance by coefficient Based on Tx Amount` позволяет сортировать транзакции по шлюзам в зависимости от суммы и указанного процента вероятности. .. image:: ../../../_static/images/rbpic29.png :width: 350 :align: center :alt: Описание: pic29 balancing 2.0 For example, 3 gates have 20%, 30% and 50% coefficients set for them. In this case, 50% of the first several processed transactions will be forwarded to the gate with the probability of 50%, then the traffic will try to reach the distribution of the amount between the gates in accordance with the specified percentages. If the processed amount on a gate exceeds the amounts on the other gates, the transactions will not be forwarded to the gate with the exceeding amount until the amounts on all the gates become equal to the percentages set for the gates. 2) :code:`Balance by coefficient Based on Tx Count` позволяет сортировать транзакции по шлюзам в зависимости от их количества и указанного процента вероятности. .. image:: ../../../_static/images/rbpic30.png :width: 350 :align: center :alt: Описание: pic30 balancing 2.0 For example, 3 gates have 20%, 30% and 50% coefficients set for them. In this case, 50% of the processed transactions will be forwarded to the gate with the probability of 50%. The transaction amounts are not considered, only their quantity is. Balance Equally ^^^^^^^^^^^^^^^ 1) :code:`Balance equally Based on Tx Amount` позволяет сортировать транзакции по шлюзам в зависимости от суммы с равным процентом вероятности. .. image:: ../../../_static/images/rbpic31.png :width: 350 :align: center :alt: Описание: pic31 balancing 2.0 If there are e.g. 4 gates, "Balance equally on Tx Amount" will set an equal probability percentage of 25% for each gate. The first several transactions can be forwarded to any of them as the percentages are equal, then the traffic will try to reach the equal distribution of the amount between the gates. If the processed amount on a gate exceeds the amounts on the other gates, the transactions will not be forwarded to the gate with the exceeding amount until the amounts on all the gates become equal. 2) :code:`Balance equally Based on Tx Count` позволяет сортировать транзакции по шлюзам в зависимости от количества с равным процентом вероятности. .. image:: ../../../_static/images/rbpic32.png :width: 350 :align: center :alt: Описание: pic32 balancing 2.0 If there are e.g. 4 gates, "Balance equally on Tx Count" will set an equal probability percentage of 25% for each gate. The first several transactions can be forwarded to any of them as the percentages are equal, then the traffic will try to reach the equal distribution between the gates based on the quantity of transactions. Cascading Chain ^^^^^^^^^^^^^^^ 1) Тип :code:`Chain by Coefficient Based on Tx Count` позволяет сортировать транзакции по гейтам с использованием указанного процента вероятности и принципа цепочки. Если входящая транзакция будет отфильтрована или превысит лимиты на некоторых гейтах, алгоритм балансировки исключит эти гейты, а затем сформирует цепочку из оставшихся согласно их коэффициентам. .. image:: ../../../_static/images/rbpic33.png :width: 350 :align: center :alt: Описание: pic33 balancing 2.0 For example, 3 gates have 20%, 30% and 50% coefficients set for them. In this case, the gate with 50% coefficient has the 50% probability of becoming the first gate in the formed chain. If for some reason the first gate in chain was unable to process the transaction, it goes to the next gate in chain. If the second gate was not able to process the transaction as well, it moves on until one of the subsequent gates in chain processes it. The traffic will try to reach the distribution between the gates according to their coefficients based on the quantity of transactions. 2) Тип :code:`Chain by Equivalently Based on Tx Count` позволяет сортировать транзакции по гейтам с использованием принципа цепочки и равного процента вероятности. Если входящая транзакция будет отфильтрована или превысит лимиты на некоторых гейтах, алгоритм балансировки исключит эти гейты, а затем сформирует цепочку из оставшихся на основе равного процента вероятности. .. image:: ../../../_static/images/rbpic34.png :width: 350 :align: center :alt: Описание: pic34 balancing 2.0 If there are e.g. 4 gates, "Chain by equivalently on Tx Count" will set an equal probability percentage of 25% for each gate. In this case, each gate has the 25% probability of becoming the first gate in the formed chain. If for some reason the first gate in chain was unable to process the transaction, it goes to the next gate in chain. If the second gate was not able to process the transaction as well, it moves on until one of the subsequent gates in chain processes it. The traffic will try to reach the equal distribution between the gates based on the quantity of transactions. 3) :code:`Цепочка по последовательности` позволяет сортировать транзакции по принципу каскадной цепочки. .. image:: ../../../_static/images/rbpic35.png :width: 350 :align: center :alt: Описание: pic35 balancing 2.0 Транзакцияs will be processed by gates only in a priority order. If for some reason the first gate in the chain was not able to process the transaction, it moves further along the chain until one of the subsequent gates in chain processes it. The gate priority can be changed in "Chain by Sequence" using drag'n'drop. 4) :code:`Chain by Last Customer Tx Status on Acquirer` позволяет сортировать транзакции по итоговому статусу транзакции и принципу цепочки. .. image:: ../../../_static/images/rbpic59.png :width: 350 :align: center :alt: Описание: pic59 balancing 2.0 Все транзакции Клиента (определяемого по адресу электронной почты) проверяются в рамках конкретного Процессора, а не среди всех; следующая транзакция направляется на Шлюз с последней успешной транзакцией этого Клиента. Если попытка на этом Шлюзе была отклонена, транзакция перемещается дальше по цепочке, пока один из последующих Шлюзов не обработает её. Others ^^^^^^ 1) :code:`First in Sequence` позволяет сортировать транзакции, выбирая для них первый подходящий шлюз. .. image:: ../../../_static/images/rbpic36.png :width: 350 :align: center :alt: Описание: pic36 balancing 2.0 If the incoming transaction is going to be filtered or exceed the limits on certain gates, the “First in Sequence” algorithm excludes these gates and then it sends the transaction to the highest gate of the remaining ones. The gate priority can be changed by dragging it up and down. 2) :code:`First in Sequence by Last Customer Tx Status on Acquirer` позволяет сортировать транзакции по итоговому статусу транзакции. .. image:: ../../../_static/images/rbpic58.png :width: 350 :align: center :alt: Описание: pic58 balancing 2.0 All client(by e-mail) transactions for all projects are checked and the next transaction is routed to the gate with processor of the last successful transaction project-wide. If a transaction is in declined status, gate is moved to the bottom of the sequence and receives lowest priority. Also, all gates belonging to the same processor as the gate on which the rejection status occurred receive low priority. Gate with processor with last approved transaction will be first in sequence, a gate with processor with earlier approves or no approves will be last. 3) :code:`First in Sequence by Last Customer Tx Status on Gate` позволяет сортировать транзакции по итоговому статусу транзакции. .. image:: ../../../_static/images/rbpic60.png :width: 350 :align: center :alt: Описание: pic58 balancing 2.0 All client(by e-mail) transactions are checked and the next transaction is routed to the gate of the last successful transaction project-wide. If a transaction is in declined status, gate is moved to the bottom of the sequence and receives lowest priority. Unlike First in Sequence by Last Customer Tx Status on Acquirer balancing type, the gates belonging to the same processor as the gate on which the declined status occurred do not lose priority and do not fall at the end of the sequence. Gate with last approved transaction will be first in sequence, a gate with earlier approves or no approves will be last. .. _additional_configuration: Additional Configurations ------------------------- Gate Skips ^^^^^^^^^^ Шлюзы в блоке балансировки могут быть пропущены при обработке транзакции в следующих случаях: 1.) Если срабатывает :ref:`ограничение эквайера` на уровне шлюза; 2.) Для параметров цепочки Cascading: если получено сообщение об отклонении, указанное в :ref:`projectchaindetails` или :ref:`projectchainskips`, цепочка будет остановлена; 3.) Если шлюз отключён на уровне шлюза; 4.) Если шлюз отключён в блоке балансировки; 5.) Если шлюз настроен на игнорирование, поскольку он предназначен только для прямой обработки с определённых Endpoints (см. :ref:`ignoring_gates` ниже). .. _ignoring_gates: Ignore Gates For Direct Processing ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |d| |i| :ex:`Игнорирование шлюзов` — игнорирует выбранный шлюз для всего узла. | Если необходимо использовать шлюз только для определённой конечной точки без изменений в маршрутизации, используйте :ex:`Ignoring gates`: тогда этот шлюз будет игнорироваться для остального трафика и использоваться только с указанной конечной точкой. | .. image:: ../../../_static/images/ignoremain.png :width: 450 :align: center :alt: Описание: pic11 balancing 3.0 Rates ^^^^^ :code:`Тарифы` — система платёжных комиссий за услуги всех участников. Система поддерживает таких участников, как: :ex:`Merchant`, :ex:`Reseller`, :ex:`Manager`, :ex:`Dealer`, :ex:`Bank`. In the current model, the fees are incrementally increasing, from the Bank to the Merchant. The following rate plan will count the value of the previous one. Thus, the higher the participant’s level is, the greater his total fee is in the system. The Bank and Dealer rate plans can be set on the gate level. Manager, Reseller, and Merchant rate plans can be set on the project level, with the option to override them on the endpoint level. The presence of some participants in the payment rates model is optional. In Routing & Balancing the Rates can be redefined directly on the gates configuration in balancing blocks. These Rates settings override the ones on project or endpoint level. .. image:: ../../../_static/images/rbpic38.png :width: 350 :align: center :alt: Описание: pic38 balancing 2.0 There are 3 active fields below at the gate’s name, which are responsible for redefining rate plans for Manager, Reseller and Merchant, from left to right respectively. All rate plans can be selected from the dropdown list of already created ones. Copy, Paste, Cut, Delete ^^^^^^^^^^^^^^^^^^^^^^^^ Узлы маршрутизации и балансировки можно удалить вместе со всеми дочерними узлами: .. image:: ../../../_static/images/rbdelete1.png :width: 1000 :align: center :alt: Описание: pic40 balancing 2.0 Каждое удаление требует подтверждения: .. image:: ../../../_static/images/rbdelete2.png :width: 450 :align: center :alt: Описание: pic40 balancing 2.0 Фрагменты дерева балансировки также можно вырезать и вставлять: .. image:: ../../../_static/images/rbcopypaste1.png :width: 1000 :align: center :alt: Описание: pic40 balancing 2.0 Выберите место для вставки вырезанного фрагмента: .. image:: ../../../_static/images/rbcopypaste2.png :width: 350 :align: center :alt: Описание: pic40 balancing 2.0 Результат: .. image:: ../../../_static/images/rbcopypaste3.png :width: 1000 :align: center :alt: Описание: pic40 balancing 2.0 Части дерева балансировки также можно копировать аналогичным образом: Описание: Tap on :ex:`Copy node`. .. image:: ../../../_static/images/rbcopygif1.png :width: 900 :align: center :alt: Описание: pic40 balancing 2.0 Выберите место для вставки скопированного фрагмента: .. image:: ../../../_static/images/rbcopygif2.png :width: 900 :align: center :alt: Описание: pic40 balancing 2.0 Результат: .. image:: ../../../_static/images/rbcopygif3.png :width: 900 :align: center :alt: Описание: pic40 balancing 2.0 Тот же процесс можно повторить для последней части дерева балансировки: .. image:: ../../../_static/images/rbcopygif4.png :width: 900 :align: center :alt: Описание: pic40 balancing 2.0 Результат: .. image:: ../../../_static/images/rbcopygif5.png :width: 900 :align: center :alt: Описание: pic40 balancing 2.0 Import And Export ^^^^^^^^^^^^^^^^^ Можно импортировать и экспортировать дерево балансировки: .. image:: ../../../_static/images/rbimpexp.png :width: 700 :align: center :alt: Описание: pic40 balancing 2.0 Файл дерева балансировки создаётся в формате :code:`xml` и имеет следующую структуру: .. code-block:: none 4947 Recur AUD 8572 1 true 23277 true 8573 true OTHERS 0 true 8573 2 true 23279 true 8574 false 8104 213100 0 23278 true true OTHERS 1 false 8574 3 true 23281 true 8575 false 1825 DEMO BANK 0 23280 true true OTHERS 1 false 8575 4 true 23282 true 8750 true OTHERS 0 false 8750 true 1 0 false