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».