Konduto Antifraud для OpenCart — антифрод-анализ заказов для Бразилии

Konduto Antifraud для OpenCart 4.x, 3.x и 2.3 отправляет заказы магазина на анализ в Konduto, бразильский антифрод-сервис, и показывает ответ в самом заказе: балл риска от 0 до 1, рекомендацию (одобрить, проверить вручную или отклонить), сработавшие правила и списки, место и устройство покупателя. Модуль сделан для магазинов, которые продают в Бразилии: CPF/CNPJ покупателя, адрес с CEP, реалы, Pix, boleto и карты. Интерфейс модуля — English и português (pt-BR).

Неофициальный модуль. Konduto — торговая марка её владельца; это независимая интеграция от CatCode, а не продукт Konduto. Сам анализ заказов платный со стороны Konduto: нужен ваш аккаунт и договор с Konduto, а тарифы и условия устанавливает Konduto, не модуль.

Что видит покупатель

Ничего нового: оформление заказа не меняется, и покупатель не ждёт ответа Konduto. Заказ уходит на анализ уже после того, как покупателю показана страница «заказ принят» (на сервере с PHP-FPM; без него — при следующем открытии админки, вызове платёжки или запросе cron). Скрипт Konduto на витрине, который видит, как покупатель ходил по магазину (Pro), включается в настройках; уведомление покупателей о нём по LGPD — дело магазина.

Что получает админ

Extensions → Extensions → Modules → Konduto Antifraud: вкладки «Connection», «Order data», «Automation», «Konduto lists» и «Licence». На «Connection» вписываете приватный ключ из портала Konduto: он хранится зашифрованным и не показывается снова, а кнопка «Check the key» проверяет, принял ли его Konduto. Префикс ключа показывает среду: T — тестовая, P — боевая. Префикс номера заказа нужен, потому что Konduto принимает номер только один раз на аккаунт: каждому магазину или тестовой копии с тем же аккаунтом дайте свой префикс.

На вкладке «Order data» выбираете, откуда брать CPF/CNPJ покупателя: из дополнительного поля оформления или вместе с нашим модулем Brazilian Checkout Fields (документ, номер дома, район). Имя, e-mail, телефон, IP, адреса, товары и суммы идут из самого заказа. Для каждого способа оплаты задаётся тип платежа для Konduto: Pix и boleto модуль распознаёт по коду способа, карту (кредит или дебет) выбираете сами. OpenCart не хранит BIN и последние цифры карты, поэтому карточный платёж уходит со статусом; если Konduto отказывает, заказ отправляется повторно без блока платежа.

В заказе появляется панель «Konduto antifraud». Кнопка «Analyse with Konduto» отправляет заказ, в ответ панель показывает балл, рекомендацию, статус Konduto, сработавшие правила или списки, место и устройство, а в истории заказа остаётся строка. Повторное нажатие ничего не дублирует: модуль сообщает, что заказ уже проанализирован. «Refresh from Konduto» подтягивает свежий статус. Ошибка сети, ошибка 5xx или лимит запросов Konduto не теряют заказ: модуль повторяет отправку, а если ответ потерялся по дороге, берёт результат запросом, а не создаёт дубль.

Pro: автоматический анализ. Заказ уходит в Konduto при оформлении или когда достигает выбранных статусов (например, после подтверждённой оплаты); способы оплаты, которым анализ не нужен (например, cod), исключаются списком. По рекомендации можно менять статус: одобрить, на проверку, отклонить; по умолчанию статус сохраняется, и смена происходит только если никто не менял его вручную, пока шёл анализ. Решения аналитиков Konduto приходят вебхуком с проверкой подписи и переводят заказ, ожидавший проверки, в статус одобрения или отклонения. Решения магазина возвращаются в Konduto: завершённый заказ как одобренный, отменённый как отменённый, возврат платежа как мошенничество, или вручную из панели.

Списки и перечень (Pro). Чёрный, белый список и список проверки Konduto ведутся из админки (e-mail, телефон, IP, CPF/CNPJ и другие значения), а в заказе есть кнопки быстрой блокировки e-mail, CPF/CNPJ, IP и телефона покупателя. Отдельная страница Sales → Konduto antifraud показывает проанализированные заказы с фильтрами (на проверку, отклонённые, одобренные, ожидают, ошибка), сводку за 30 дней и кнопку, которая ставит в очередь недавние заказы, которых Konduto ещё не видел (их статус не меняется).

Как это работает, шаг за шагом

1. Устанавливаете архив для своей версии OpenCart и включаете модуль.
2. В портале Konduto берёте публичный и приватный ключи, вписываете их в настройках и нажимаете «Check the key».
3. На вкладке «Order data» указываете поле CPF/CNPJ и тип платежа для способов оплаты.
4. Открываете заказ и нажимаете «Analyse with Konduto»: в панели появляются балл и рекомендация.
5. В Pro включаете автоматический анализ, выбираете статусы по рекомендации и передаёте адрес уведомлений поддержке Konduto.
6. Решения магазина и аналитиков Konduto синхронизируются в обе стороны.

Что под капотом

• Konduto API v1: заказ отправляется на api.konduto.com/v1/orders, авторизация приватным ключом, ответ читается из балла, рекомендации, правил, списков, места и устройства.
• Приватный ключ хранится зашифрованным; запросы не выводят его ни в журнал, ни на страницу.
• Сбои Konduto (сеть, 5xx, лимит запросов) не теряют заказ: отправка повторяется с паузами, а заказ, который Konduto уже сохранил, подтягивается запросом, без дубля.
• Вебхук проверяется подписью HMAC-SHA256 по приватному ключу; неверная подпись отклоняется, без изменений в заказе.
• Модуль работает через события OpenCart, ядро не меняет; обновление сохраняет настройки.
• Язык модуля: English и português (pt-BR).

Как установить

1. Extensions → Installer: загрузите архив для своей версии, не переименовывая (OpenCart 4: cc_konduto.ocmod.zip, 3.x: cc_konduto-oc3.ocmod.zip, 2.3: cc_konduto-oc23.ocmod.zip).
2. Для 3.x и 2.3: Extensions → Modifications → Refresh.
3. Extensions → Extensions → Modules → Konduto Antifraud: установите и откройте настройки.
4. Впишите приватный ключ и нажмите «Check the key».
5. На вкладке «Order data» укажите поле CPF/CNPJ.
6. Для Pro: вставьте ключ или запустите триал на вкладке «Licence».