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

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

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

Что делает бесплатная версия

Всё настраивается на одной странице: WooCommerce → Konduto. Вписываете приватный ключ из портала Konduto (он хранится зашифрованным и больше не показывается) и нажимаете «Check connection»: Konduto говорит, принял ли он ключ. Ключ с префиксом T относится к тестовой среде, P — к боевой. Префикс номера заказа нужен, потому что Konduto принимает номер только один раз на аккаунт: магазину и тестовой копии с тем же аккаунтом задайте разные префиксы. Для каждого способа оплаты задаётся тип платежа для Konduto: Pix, boleto, кредитная или дебетовая карта, перевод, ваучер или баланс. Автоматически модуль угадывает тип по способу оплаты, при необходимости вы выбираете его сами. WooCommerce не хранит BIN и последние цифры карты, поэтому платёж картой уходит без них; если Konduto отказывает из-за данных карты, заказ отправляется повторно без блока платежа.

На экране заказа есть блок «Konduto antifraud». Кнопка «Send to Konduto for analysis» отправляет покупателя (имя, e-mail, телефон, CPF/CNPJ), адреса выставления счёта и доставки, товары корзины, суммы, IP и тип платежа. CPF/CNPJ, номер дома и район модуль читает из полей, которые создают плагины бразильских полей оформления (например, наш Brazilian Checkout Fields). В ответ блок показывает рекомендацию, балл, статус Konduto и сработавшие правила; то же записывается в заметки заказа. Повторная отправка того же заказа невозможна: кнопка становится «Refresh the analysis» и подтягивает свежий статус, например после решения аналитика в Konduto. Статус заказа WooCommerce в бесплатной версии не меняется. Вместо сырых ошибок API вы видите понятные сообщения: ключ не принят, не хватает поля («/customer/tax_id»), Konduto недоступен.

Что добавляет Pro

Автоматический анализ. Заказ уходит в Konduto сам, когда он оформлен или когда оплачен (статус «Processing»), в фоне через Action Scheduler; если Konduto недоступен, отправка повторяется до трёх раз. Действие по рекомендации. «Review» ставит заказ на удержание, «Decline» ставит на удержание или отменяет (отмена не возвращает уже принятую оплату: это написано в настройке). Неоплаченный заказ с Pix или boleto модуль не трогает, пока не придёт оплата; тогда он ждёт на удержании вместо перехода в «Processing». Вебхук Konduto. Когда аналитик Konduto одобряет или отклоняет заказ, заказ следует за ним: возвращается в свой статус или отменяется. Каждое уведомление проверяется подписью HMAC. Адрес вебхука показан в настройках, его нужно передать поддержке Konduto. Ваше решение обратно в Konduto. Одобрить, отклонить или пометить как мошенничество (chargeback) с комментарием можно с экрана заказа; отменённые заказы и неудачные платежи сообщаются Konduto, чтобы модель на них училась. Неудачные платежи можно отправлять без анализа (Konduto считает только проанализированные заказы). Скрипт на витрине. Скрипт Konduto, теги страниц и идентификатор посетителя в каждом заказе: поведенческие данные, которые Konduto ценит больше всего. Чёрный, белый список и список проверки. E-mail, CPF/CNPJ, телефон или IP из заказа добавляются одним кликом, а любое значение можно внести или убрать со страницы отчёта. Список заказов и отчёт. В списке заказов появляется колонка Konduto с рекомендацией и баллом и массовое действие «Send to Konduto for analysis». Страница отчёта показывает 30 дней по рекомендациям, заказы на проверку и отклонённые, списки и журнал всех вызовов Konduto. Обновления с catcode.com.ua.

Что стоит знать заранее

• Нужен собственный аккаунт Konduto: публичный и приватный ключи из портала Konduto. Договор и доступы выдаёт Konduto; модуль этого не делает.
• Анализ платный со стороны Konduto по вашему договору. Модуль, его бесплатная версия и Pro не включают стоимость анализа. Автоматическая отправка (Pro) отправляет каждый заказ, поэтому выберите, когда именно: при оформлении или после оплаты.
• Konduto требует документ покупателя. Если в магазине нет поля CPF/CNPJ, анализ возвращает отказ по полю «/customer/tax_id»: добавьте поле оформления, например Brazilian Checkout Fields.
• Отмена заказа по рекомендации «Decline» не возвращает деньги, которые уже приняла платёжная система: возврат делается в заказе или в платёжном сервисе.
• Удержание оплаченных заказов опирается на то, что платёжный плагин завершает оплату стандартным способом WooCommerce. Платёж, который сразу ставит «Completed» (например, для виртуальных товаров), модуль не удерживает.
• Скрипт Konduto на витрине (Pro) собирает данные о просмотре страниц и устройстве посетителя; упомяните Konduto в политике конфиденциальности и уведомите покупателей в соответствии с LGPD.
• Вебхуку нужен сайт, доступный из интернета по HTTPS, и адрес, переданный поддержке Konduto. Без вебхука вы всё равно видите решение аналитика после кнопки «Refresh the analysis».
• Если одним аккаунтом Konduto пользуются магазин и его тестовая копия, задайте им разные префиксы номера заказа: Konduto принимает один номер только раз.

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

1. Возьмите в портале Konduto приватный (и публичный, если включаете скрипт) ключ.
2. В WooCommerce → Konduto вставьте приватный ключ и нажмите «Check connection».
3. Посмотрите, как способы оплаты передаются в Konduto (Pix, boleto, карта), и сохраните.
4. Откройте заказ и нажмите «Send to Konduto for analysis»: появятся балл и рекомендация.
5. В Pro выберите режим автоматической отправки и действия по рекомендации, передайте адрес вебхука поддержке Konduto.

Под капотом

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

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

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → Konduto: вставьте приватный ключ, «Check connection».
3. Проверьте тип платежа для способов оплаты и сохраните.
4. Для Pro: запустите пробный период или вставьте ключ лицензии в разделе «Licence».

Модуля пока нет на wordpress.org: бесплатная версия и Pro — один архив с этой страницы. Без ключа он работает как бесплатная версия.