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 — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.