Проверка beProtected
beProtected - это сервис проверки платежей по правилам, которые могут быть установлены eComCharge и торговцами по своим предпочтениям для защиты от мошенничества в сфере онлайн платежей. Проверка beProtected предшествует всем остальным проверкам платежей системой eComCharge и эквайерами.
Настройка правил
Фильтры и их группы настраиваются в личном кабинете eComCharge на странице Правила. Они могут применяться как к одному, так и ко всем магазинам торговца.
Ответ
Если проверка beProtected настроена, система eComCharge вернет ответ с секцией 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-адрес находится в черном списке. |
string | Наличие адреса электронной почты покупателя в списках. Возможные значения: absent - Адрес электронной почты не находится ни в белом, ни в черном списке;white - Адрес электронной почты в белом списке;black - Адрес электронной почты находится в черном списке. |
|
rules | object | Секция параметров правил с результатами проверки: группа правил eComCharge, группа правил торговца и группа правил магазина. Любая из групп может быть пустой. |
eComCharge | object | Секция правил проверки, установленных для eComCharge. |
{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 | Секция правил проверки, установленных для торговца в формате (eComCharge 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":{},
"eComCharge":{}
}
}
}
Тестовые данные сервиса beProtected
Чтобы протестировать то, как ваш ресурс обрабатывает ответ сервиса beProtected, в черный список базы данных eComCharge внесены cледующие данные:
Параметр транзакции | Значение |
---|---|
number | 4111111111111111 |
ip | 127.0.0.127 |
blacklisted@example.com |
Если вы совершаете транзакцию оплаты, списания средств, авторизации или выплаты средств c любым из значений таблицы выше, eComCharge вернет ответ, содержащий секцию be_protected_verification
с вложенной секцией white_black_list
.