Перейти к содержанию

Параметры секции smart_routing_verification

Обратитесь в службу технической поддержки, если вы хотите получать полную информацию о прохождении транзакцией правил сервиса Умной Маршрутизации (Smart Routing). По умолчанию, ответы и автоматические уведомления включают только статус прохождения проверки (smart_routing_verification.status).

object
status
string
Статус проверки транзакции правилами сервиса Умной Маршрутизации. Возможные значения:

successful - проверка пройдена;
failed - проверка не пройдена.
object
Секция с детальными данными о проверке транзакции правилами сервиса Умная Маршрутизация.
status
string
Общий статус проверки.

Возможные значения:

rejected - транзакция была отклонена в результате правила типа действие с действием Отклонить, или параметры транзакции находятся в черном списке;
passed - во всех остальных случаях.
object
string
ID шлюза, на который была отправлена транзакция; null - если все доступные шлюзы были исключены в результате проверок.
object_name
string
Имя шлюза, на который была отправлена транзакция.
array
Массив потоков типа объект, по которым проводилась проверка транзакции. Каждый объект содержит следующие параметры:
name
string
Имя потока
system
boolean
Тип правила. true, если правило системное, в противном случае false.
skipped
boolean
Статус выполнения потока. true, если проверка по потоку пропущена, в противном случае false.
array
Массив объектов, каждый из которых соответствует определенному правилу данного потока.
alias
string
Название правила.
state
string
Результат проверки по правилу.
description
string
Описание правила.
error_message
string
Сообщение об ошибке.
error_code
string
Код ошибки.

Возможные значения:

precondition_failed - предусловие не выполнено;
rule_inactive - правило не активно;
rule_unprocessable - правило еще не готово к использованию, например, было только что обновлено, маловероятная ошибка;
allowed_objects_mismatch - в результате проверки по правилу, был выбран шлюз, который к моменту обработки этим правилом уже не был доступен;
data_mismatch - ошибка для агрегационных правил, если транзакция не удовлетворяет условиям правила, то транзакция не участвует в агрегации;
not_enough_data - не хватает данных для проверки условий.
object_defined_via
string
Способ, которым был выбран шлюз для транзакции.

Возможные значения:

allowed objects - по результатам проверок, не был выбран конкретный шлюз, транзакция была отправлена на один из доступных шлюзов, выбранного случайным образом либо по очереди в зависимости от настроек сервиса Умная Маршрутизация;
rule - шлюз был выбран в результате проверки транзакции правилом.
object
Секция с информацией о прохождении правил типа действие.
object
Секция с детальной информации о правилах учетной записи, на уровне которой было создано правило. Названия учетных записей уровней торговца и магазина имеют форматы Merchant_{merchant_id}, Shop_{shop_id} соответственно.
object
Секция с детальной информации о потоке, в рамках которого было создано правило.
{rule_name}
string
Статус проверки транзакции по правилу. Название параметра совпадает с названием правила.

Возможные значения:

passed - проверка выполнена, транзакция не соответствует условиям правила;
skipped - проверка по правилу не выполнена, например, параметр из условия правила имеет значение null, или параметры транзакции в белом списке;
allow - проверка по правилу выполнена, по результатам правила транзакция допущена к последующим проверкам;
skip 3DS - по результатам проверки, для транзакции не будет выполняться верификация 3D-Secure;
notify - по результатам проверки транзакции было выслано уведомление, например, о приближении к пороговому значению лимита;
review - в результате проверки транзакция была помечена как подозрительная, транзакция была добавлена в отчет по подозрительным транзакциям, и, если в настройках магазина был указан anti-fraud email, то на этот адрес было отправлено уведомление;
reject - транзакция была отклонена.
object
Секция со списком действий, которые были применены к транзакции.
array
Массив правил, после проверок по которым было применено действие. Секция каждого правила включает в себя следующие параметры:
alias
string
description
string
Описание правила.
account
string
Учетная запись, для которой было создано правило.
rejected_via
string
Причина отклонения транзакции.
object
Секция черных и белых списков, проверка по которым проводилась по транзакции.
{name of the w/b list}
string
Если параметры транзакции не указаны в списках, то значение параметра с именем соответствующего списка будет not_matched. В противном случае, matched.
Пример секции smart_routing_verification
{
  "smart_routing_verification": {
    "data": {
      "action_rules": {
        "Merchant_318879_Demo": {},
        "Shop_569_Demo_shop": {
          "Force 3D": {
            "Force 3D": "force_3ds"
          },
          "1_rule_MASTERCARD": {
            "1_rule_MASTERCARD": "skipped"
          },
          "Max transaction amount - 10 000 USD": {
            "Max transaction amount - 10 000 USD": "passed"
          }
        }
      },
      "force_3ds": true,
      "matched_actions": {
        "force_3ds": [
          {
            "account": "Shop_569_Demo_shop",
            "alias": "Force 3D",
            "description": "Force 3D"
          }
        ],
        "passed": [
          {
            "account": "Shop_569_Demo_shop",
            "alias": "Max transaction amount - 10 000 USD",
            "description": "Max transaction amount - 10 000 USD"
          }
        ],
        "skipped": [
          {
            "account": "Shop_569_Demo_shop",
            "alias": "1_rule_MASTERCARD",
            "description": "1_rule_MASTERCARD"
          }
        ]
      },
      "object": "1067",
      "object_defined_via": "allowed objects",
      "object_flows": [
        {
          "name": "Shop_5655",
          "rules": [
            {
              "alias": "rule_1",
              "description": "Allow cards from the list",
              "error_code": "rule_inactive",
              "error_message": "Rule is inactive",
              "state": "skipped"
            }
          ],
          "skipped": false,
          "system": false
        },
        {
          "name": "name",
          "rules": [
            {
              "alias": "rule 2",
              "description": "rule 2",
              "state": "not_matched",
              "use_only_these_objects": true
            }
          ],
          "skipped": false,
          "system": false
        }
      ],
      "object_name": "gw_1067",
      "status": "passed",
      "wb_lists": {}
    },
    "status": "successful"
  }
}