Проверка beProtected

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

Настройка правил

Фильтры и их группы настраиваются в личном кабинете bePaid на странице Правила. Они могут применяться как к одному, так и ко всем магазинам торговца.

Ответ

Если проверка beProtected настроена, система bePaid вернет ответ с секцией be_protected_verification со следующими параметрами:

Параметр	Тип	Описание
be_protected_verification	object	Секция с параметрами проверки транзакции сервисом beProtected.
status * обязательный	string	Статус проверки beProtected. Возможные значения: `failed` - Транзакция не прошла проверку. Она не была передана системой в сеть процессинга для списания средств с карты; `successful` - Транзакция прошла проверку.
message * обязательный	string	Сообщение сервиса beProtected. Содержит описание ошибки или причину, по которой проверка сервиса beProtected не пройдена.
limit	object	Секция параметров проверки транзакции на лимиты по сумме и количеству транзакций. Применяется только для оплаты или списания средств.
volume	boolean	`true`, если сумма транзакций превышает максимально допустимый лимит в месяц. Иначе, `false`.
count	boolean	`true`, если количество транзакций превышает максимальное допустимый лимит в месяц. Иначе, `false`.
max	boolean	`true`, если сумма транзакции превышает максимально допустимый лимит на сумму одной транзакции. Иначе, `false`.
current_volume	integer	Сумма успешно обработанных транзакций `оплаты` и `списания средств` в текущем месяце.
current_count	integer	Количество успешно обработанных транзакций `оплаты` и `списания средств` в текущем месяце.
white_black_list	object	Секция проверки по черному списку параметров `number`, `ip` и `email`.
card_number	string	Наличие номер карты покупателя в списке. Возможные значения: `absent` - Номер карты не находится ни в белом, ни в черном списках; `white` - Номер карты находится в белом списке; `black` - Номер карты находится в черном списке.
ip	string	Наличие IP адреса покупателя в списке. Возможные значения: `absent` - IP адрес не находится ни в белом, ни в черном списках; `white` - IP-адрес находится в белом списке; `black` - IP-адрес находится в черном списке.
email	string	Наличие адреса электронной почты покупателя в списках. Возможные значения: `absent` - Адрес электронной почты не находится ни в белом, ни в черном списке; `white` - Адрес электронной почты в белом списке; `black` - Адрес электронной почты находится в черном списке.
rules	object	Секция параметров правил с результатами проверки: группа правил bePaid, группа правил торговца и группа правил магазина. Любая из групп может быть пустой.
bePaid	object	Секция правил проверки, установленных для bePaid.
{rule 1 name}	object	Название Правила 1, как указано при его создании.
{rule 1 condition}	string	Условия Правила 1 с результатом проверки. Возможные значения: `passed` - Проверка пройдена, параметры транзакции не нарушают условий; `reject` - Проверка пройдена, параметры транзакции нарушают условия, транзакция отклонена; `review` - Проверка пройдена, параметры транзакции нарушают условия, транзакция требует дополнительного рассмотрения; `skipped` - Проверка не пройдена, отсутствуют необходимые данные для ее проведения; `error` - Ошибка при обработке правил проверки.
{rule N name}	object	Аналогично описанию Правила 1.
{rule N condition}	string	Аналогично описанию Правила 1.
merchant	object	Секция правил проверки, установленных для торговца в формате `(bePaid internal id)_{merchant name}`, например, `1_John Doe`
{rule 1 name}	string	Название Правила 1, как указано при его создании.
{rule 1 condition}	string	Условия Правила 1 с результатом проверки. Возможные значения: `passed` - Проверка пройдена, параметры транзакции не нарушают условий; `reject` - Проверка пройдена, параметры транзакции нарушают условия, транзакция отклонена; `review` - Проверка пройдена, параметры транзакции нарушают условия, транзакция требует дополнительного рассмотрения; `skipped` - Проверка не пройдена, отсутствуют необходимые данные для ее проведения; `error` - Ошибка при обработке правил проверки.
{rule N name}	object	Аналогично описанию Правила 1.
{rule N condition}	string	Аналогично описанию Правила 1.
shop	object	Секция правил проверки для магазина в формате `{shop_id}_{shop_name}`, например, `123_My Shop`.
{rule 1 name}	string	Название Правила 1, как указано при его создании.
{rule 1 condition}	string	Условия Правила 1 с результатом проверки. Возможные значения: `passed` - Проверка пройдена, параметры транзакции не нарушают условий; `reject` - Проверка пройдена, параметры транзакции нарушают условия, транзакция отклонена; `review` - Проверка пройдена, параметры транзакции нарушают условия, транзакция требует дополнительного рассмотрения; `skipped` - Проверка не пройдена, отсутствуют необходимые данные для ее проведения; `error` - Ошибка при обработке правил проверки.
{rule N name}	Аналогично описанию Правила 1.
{rule N condition}	Аналогично описанию Правила 1.

Пример ответа

{
  "be_protected_verification":{
    "status":"successful",
    "white_black_list":{
      "email":"absent",
      "ip":"absent",
      "card_number":"white"
    },
    "rules":{
      "1_123_My Shop":{
        "more_100_eur" : {"Transaction amount more than 100 AND Transaction currency is EUR": "passed"}
      },
      "1_John Doe":{},
      "bePaid":{}
    }
  }
}

Тестовые данные сервиса beProtected

Чтобы протестировать то, как ваш ресурс обрабатывает ответ сервиса beProtected, в черный список базы данных bePaid внесены cледующие данные:

Параметр транзакции	Значение
number	4111111111111111
ip	127.0.0.127
email	blacklisted@example.com

Если вы совершаете транзакцию оплаты, списания средств, авторизации или выплаты средств c любым из значений таблицы выше, bePaid вернет ответ, содержащий секцию be_protected_verification с вложенной секцией white_black_list.