VibeFox Vindi for OpenCart — Допомога

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіші (перевірено на 4.1.0.3).

PHP: 8.0 або новіша версія.

Валюта: бразильський реал (BRL) має бути налаштований у System > Localisation > Currencies. Vindi виставляє рахунки лише в BRL, тому спосіб оплати показується лише тоді, коли покупець платить у BRL.

Обліковий запис Vindi: потрібен ключ API вашого облікового запису Vindi. Пісочниця Vindi — це окремий тестовий обліковий запис Vindi з власним ключем. Boleto, PIX і BolePix також мають бути увімкнені у вашому обліковому записі Vindi, якщо ви хочете їх пропонувати.

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

Архів для завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп’ютері. Він містить README.txt, пакет для OpenCart 3 wcp_vindi_gateway-oc3-(version).ocmod.zip і пакет для OpenCart 4 wcp_vindi_gateway.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_vindi_gateway-oc3-(version).ocmod.zip. Розширення не має модифікацій OCMOD, тож Extensions > Modifications оновлювати не потрібно. Замість інсталятора можна скопіювати вміст папки upload цього пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і оберіть тип Payments. Знайдіть VibeFox Vindi Gateway і натисніть Install (зелена кнопка +). Вашому адміністратору потрібне право змінювати список платіжних розширень.

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань. Введіть ваш ліцензійний ключ VibeFox у License key у блоці ліцензії у верхній частині сторінки та натисніть Activate (див. розділ «Ліцензійний ключ»).

4. Вставте Sandbox API key і, коли будете готові, Live API key. Оберіть Offered methods.

5. Скопіюйте URL webhook з налаштувань до Vindi (див. розділ «Налаштування»).

6. Увімкніть Enable / Disable і натисніть Save. Перевірте платіж у режимі пісочниці, потім вимкніть Sandbox mode, щоб приймати реальні платежі.

OpenCart 4

1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_vindi_gateway.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, тож перейменований пакет не працює.

2. Пакет з’являється у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.

3. Перейдіть до Extensions > Extensions і оберіть тип Payments. Знайдіть VibeFox Vindi Gateway, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ, API-ключі, способи оплати та webhook так само, як у кроках з 3 до 6 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях. Відрізняється лише URL webhook (див. Сповіщення про платежі (webhook)).

Нове встановлення починається з вимкненим способом оплати та увімкненим режимом пісочниці.

Налаштування

Усі налаштування містяться на сторінці розширення: Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує режим, TEST MODE або LIVE, і попереджає, коли API-ключ поточного режиму порожній (тоді спосіб оплати не показується на оформленні замовлення) або коли валюта магазину за замовчуванням не BRL (тоді спосіб оплати показується лише тоді, коли покупець платить у BRL). Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Під час збереження ключі записуються так, як введені, без пробілів на початку та в кінці. Якщо спосіб оплати не вибрано, зберігається кредитна картка, і сторінка показує Choose at least one payment method — credit card was selected. Порожній Title або назва довша за 128 символів, Sort Order, що не є цілим числом (від’ємні значення дозволені), Total, що не є числом не менше 0, або неіснуючі геозона чи статус замовлення не приймаються: нічого не зберігається, і сторінка показує повідомлення, наприклад Enter a title for the payment method (1 to 128 characters).

Vindi

Enable / Disable: Enable Vindi payments вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яка показується на оформленні замовлення. Вона ж зберігається в замовленні як назва способу оплати. За замовчуванням: Vindi. Обов’язкове поле, не більше 128 символів.

Description: текст, який покупець бачить на кроці Confirm Order над полями оплати. За замовчуванням: Pay by credit card on the secure Vindi page, or by boleto / PIX.

Sort Order: позиція Vindi серед способів оплати на оформленні замовлення. Залиште порожнім або введіть ціле число (від’ємні значення дозволені).

Geo Zone: пропонувати Vindi лише для платіжних адрес у вибраній геозоні. За замовчуванням: All zones. Геозони налаштовуються в System > Localisation > Geo Zones.

Total: сума оформлення замовлення у валюті магазину за замовчуванням, яку має досягти замовлення, перш ніж буде запропоновано Vindi. Залиште порожнім, щоб пропонувати Vindi за будь-якої суми.

API-ключі

Створіть ключі в панелі Vindi у розділі Settings > API keys: на app.vindi.com.br для робочого режиму та на sandbox-app.vindi.com.br для пісочниці. Робочий режим і пісочниця мають окремі хости та ключі. Кожен платіж запам’ятовує, де був створений його рахунок, тож перевірки, скасування та повернення завжди виконуються в цьому середовищі.

Sandbox mode: створює нові платежі в пісочниці Vindi, використовуючи sandbox-app.vindi.com.br та ключ API пісочниці. Покупці бачать на оформленні замовлення примітку TEST MODE: Vindi sandbox: no real charges. За замовчуванням: увімкнено. Вимкніть, щоб приймати реальні платежі.

Live API key: закритий ключ облікового запису Vindi для робочого режиму. Він надсилається лише до API Vindi.

Sandbox API key: закритий ключ облікового запису пісочниці Vindi.

Збережені ключі ніколи більше не показуються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Щоб видалити збережений ключ, позначте під полем Clear the saved key on save і натисніть Save.

Способи оплати

Offered methods: способи, які покупці можуть обрати. За замовчуванням: кредитна картка. Способи також мають бути увімкнені у вашому обліковому записі Vindi.

Для boleto, PIX і BolePix потрібен CPF або CNPJ покупця, який запитується на оформленні замовлення.

Сповіщення про платежі (webhook)

Webhook повідомляє вашому магазину, що рахунок оплачено, скасовано, відхилено або повернуто. Поле Webhook URL цього розділу показує URL. У OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_vindi_gateway/webhook&token=..., у OpenCart 4 — https://your-store/index.php?route=extension/wcp_vindi_gateway/payment/wcp_vindi_gateway.webhook&token=.... Він формується з адреси вітрини вашої установки OpenCart і містить секретний токен, створений розширенням. Скопіюйте його точно так, як його показують налаштування. У Vindi перейдіть до Settings > Webhooks — і в робочому обліковому записі, і в обліковому записі пісочниці — додайте цей URL і виберіть такі події:

Vindi не підписує свої сповіщення, тому запити з відсутнім або неправильним токеном відхиляються, а кожне сповіщення лише змушує розширення повторно зчитати рахунок через API Vindi, перш ніж зміниться замовлення. URL працює й тоді, коли магазин перебуває в режимі обслуговування (в OpenCart 4 стартова дія розширення пропускає webhook і сторінку статусу оплати). У рахунків Vindi немає URL для повернення, тож без webhook платіж карткою фіксується лише тоді, коли покупець знову підтверджує замовлення з тим самим кошиком (тоді знаходиться оплачений рахунок), а платіж boleto чи PIX — коли покупець знову відкриває замовлення в особистому кабінеті (My Account > Order History).

Замовлення

OpenCart створює замовлення на кроці Confirm Order без статусу (замовлення без статусу). Воно отримує статус лише після того, як Vindi повідомить про рахунок; рахунок завжди перечитується з Vindi. Замовлення з boleto, PIX і BolePix отримують статус очікування, щойно рахунок видано. Кожне поле нижче містить ваші статуси замовлень OpenCart. В OpenCart немає статусу «Утримання», тому статуси очікування та утримання за замовчуванням використовують «Очікування»; примітки до замовлення їх розрізняють. Власні статуси можна створити в System > Localisation > Order Statuses і вибрати тут.

Order Status After Payment: встановлюється після перевіреного платежу Vindi. За замовчуванням: В обробці.

Awaiting Vindi Payment Status: boleto, PIX або BolePix видано на оформленні замовлення; Vindi пізніше підтвердить надходження коштів. Дані платежу додаються до коментаря в історії, який бачить покупець. За замовчуванням: Очікування.

Vindi Payment On Hold Status: рахунок перевіряється у Vindi, оплачений рахунок не відповідає замовленню (валюта, сума, код рахунку або клієнт Vindi), або його оплачено після скасування замовлення. Примітка пояснює причину. За замовчуванням: Очікування.

Payment Error Status: Vindi відхилив спробу оплати замовлення, яке очікує. Покупець усе ще може оплатити той самий рахунок; пізніший платіж встановлює статус після оплати. За замовчуванням: Невдалий.

Canceled Status: рахунок замовлення, що очікувало, скасовано у Vindi. Коли ви переводите замовлення цього розширення в цей статус, його чинний рахунок Vindi також скасовується. За замовчуванням: Скасовано.

Refunded Status: встановлюється після повного повернення платежу зі сторінки замовлення. За замовчуванням: Повернено.

Додатково

Debug log: записує виклики API та сповіщення у файл wc_vdi_debug.log.php у папці логів OpenCart (storage/logs, в OpenCart 4 — system/storage/logs). Файл не можна відкрити через веб. Помилки та попередження завжди записуються, навіть коли цю опцію вимкнено. Ключі, токен webhook та дані покупців ніколи не записуються. За замовчуванням: вимкнено.

Log: показує розмір і останні записи журналу. Натисніть Clear log, щоб його очистити.

Delete data on uninstall: якщо увімкнено, видалення розширення прибирає налаштування, токен webhook, кеш товарів і журнал. Замовлення та посилання на рахунки Vindi замовлень зберігаються. За замовчуванням: вимкнено.

Імпорт / Експорт

Export: Download JSON зберігає налаштування у файл JSON. API-ключі не експортуються.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування. Збережені API-ключі залишаються.

Оформлення замовлення

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Vindi). На кроці Confirm Order покупець бачить ваш опис. Коли пропонується більше одного способу, блок оплати показує Pay with і вибір з кредитної картки, boleto, PIX або BolePix. Коли пропонуються boleto, PIX або BolePix, у блоці також є поле CPF or CNPJ. Воно обов’язкове, якщо кредитна картка не пропонується; інакше показується Required for boleto and PIX. Поле заповнюється з користувацького поля покупця або з адреси з назвою CPF чи CNPJ, якщо там є дійсний номер. Номер перевіряється за контрольними цифрами. Якщо чогось бракує, покупець бачить Please choose how you want to pay with Vindi., Please enter a valid CPF or CNPJ. або Please enter your CPF or CNPJ — it is required for boleto and PIX. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options; блок оплати з цими полями та кнопка Confirm Order розташовані внизу сторінки оформлення.

Коли покупець натискає Confirm Order, розширення створює для цього кошика клієнта Vindi з платіжної адреси та рахунок Vindi на суму замовлення в один внесок. У Vindi рахунок називається Order # з номером замовлення OpenCart.

Кредитна картка: покупця надсилають на сторінку рахунку Vindi, і він платить там. Замовлення залишається без статусу. У Vindi немає URL для повернення рахунків, тож покупець автоматично не повертається до магазину. Замовлення отримує статус, коли Vindi підтверджує платіж через webhook. Якщо покупець знову підтверджує замовлення з тим самим кошиком, а рахунок уже оплачено, оплачене замовлення підтверджується, і покупець бачить сторінку успіху.

Boleto, PIX і BolePix: рахунок видається одразу, замовлення отримує статус очікування, а покупець потрапляє на сторінку успіху замовлення OpenCart. Там, а також у деталях замовлення в обліковому записі покупця, розділ Payment показує QR-код PIX, код PIX для копіювання та вставлення з кнопкою Copy code і його термін дії, а також кнопку Open boleto. Лист про замовлення та історія замовлень покупця містять код PIX і посилання на boleto. Якщо Vindi не повертає дані boleto або PIX, рахунок скасовується, і покупець бачить помилку.

Замовлення позначається оплаченим лише після підтвердження Vindi: розширення зчитує рахунок з API Vindi і перевіряє валюту, належність рахунку до замовлення (код рахунку та клієнт Vindi) і те, що сплачена сума дорівнює сумі замовлення. Сторінка успіху та сторінка замовлення в обліковому записі покупця повторно перевіряють замовлення, що очікує, через API, щонайбільше раз на 15 секунд. Коли платіж отримано, сторінка успіху показує Your payment with Vindi has been received. Поки платіж не підтверджено, вона показує We are confirming your payment with Vindi. The order will be updated automatically — please do not pay again. Для скасованого замовлення — This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid.

Поки платіж не підтверджено, сторінка успіху та сторінка замовлення в обліковому записі покупця (для замовлення, що очікує або утримується) також показують кнопку Check payment status. Вона перевіряє останній рахунок Vindi замовлення. Підтверджене або таке, що очікує, замовлення повертає на сторінку успіху з його платіжними даними. Якщо рахунок ще не оплачено, розділ Payment каже Your payment has not been completed yet. If you have already paid, the order is confirmed as soon as Vindi reports the payment — please do not pay again. і має кнопки Pay at Vindi, Check again та Back to checkout.

OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order, а OpenCart 4 оновлює замовлення на оформленні, тож розширення оплачує кожен кошик лише раз. Якщо інше замовлення того самого кошика вже оплачено, очікує оплати boleto або PIX чи утримується, покупець переходить на сторінку успіху, і новий рахунок не видається. Нова спроба для того самого замовлення повторно використовує його чинний рахунок Vindi, якщо спосіб, сума та середовище ті самі. Інакше попередній рахунок скасовується у Vindi, перш ніж буде створено новий, тож покупець не може двічі оплатити той самий кошик. Зміна кошика, зокрема нова кількість, вважається новим кошиком, якому потрібна власна оплата.

OpenCart 4 зберігає замовлення на оформленні, доки не буде показано сторінку успіху. Після відхиленої оплати карткою або скасованого рахунку покупець оплачує те саме замовлення знову. Якщо це замовлення тим часом закрили без оплати, покупця повертають на оформлення, і наступне натискання Confirm Order оплачує нове замовлення: для скасованого замовлення показується This order was cancelled and its Vindi bill can no longer be paid. Please contact us if you have already paid., для невдалого — Your Vindi payment attempt was rejected. You can try again below. В OpenCart 4 повідомлення сторінки статусу Payment, які повертають до оформлення, показуються над сторінкою оформлення.

Якщо Vindi не може розпочати платіж, покупець залишається на кроці Confirm Order з коротким повідомленням над кнопкою, наприклад щоб перевірити CPF / CNPJ, платіжну адресу (для boleto обов’язкові вулиця, індекс, місто та штат), e-mail чи номер телефону, або що Vindi тимчасово недоступний. Технічна причина записується в журнал.

Розширення приймає разові платежі одним внеском. Воно не підтримує підписки чи регулярні списання, збережені картки, розстрочку та форму для карток на вашому сайті: картка завжди вводиться на сторінці Vindi. Номер будинку та район не входять до адреси OpenCart, тож до Vindi не передаються.

Замовлення та повернення коштів

Статуси замовлень

Немає статусу (замовлення без статусу): розпочато платіж карткою, і Vindi його ще не підтвердив. У Sales > Orders такі замовлення показуються лише з фільтром Order Status, встановленим на Missing Orders. У OpenCart 4.1 такому замовленню також може бути присвоєно статус Voided, який OpenCart встановлює, коли крок підтвердження показується знову; розширення вважає його замовленням без статусу.

Awaiting Vindi Payment Status (за замовчуванням Очікування): платіж boleto, PIX або BolePix очікує. Замовлення переходить до Order Status After Payment, коли Vindi повідомляє, що рахунок оплачено.

Order Status After Payment (за замовчуванням В обробці): платіж підтверджено. Замовлення отримує статус звичайним для OpenCart способом, зі звичайними листами про замовлення та оновленням залишків. Примітка показує рахунок Vindi, суму та середовище.

Vindi Payment On Hold Status (за замовчуванням Очікування): рахунок Vindi перевіряється, оплачений рахунок не відповідає замовленню (валюта, сума, код рахунку або клієнт Vindi), або рахунок оплачено після скасування замовлення. Примітка пояснює це. Перевірте замовлення та залишки, потім виконайте замовлення або поверніть платіж.

Payment Error Status (за замовчуванням Невдалий): Vindi відхилив спробу оплати замовлення, що очікує. Примітка показує причину від еквайра, якщо вона є. Покупець усе ще може оплатити той самий рахунок, а пізніший платіж переводить замовлення до Order Status After Payment.

Canceled Status (за замовчуванням Скасовано): рахунок замовлення, що очікує, скасовано у Vindi. Коли ви переводите замовлення в OpenCart у цей статус, його чинний рахунок Vindi також скасовується, і його більше не можна оплатити. Якщо це неможливо, примітка просить вас скасувати рахунок у панелі Vindi.

Refunded Status (за замовчуванням Повернено): платіж повністю повернуто через розширення.

Якщо другий рахунок оплачено для замовлення, яке вже оплачено, або для іншого замовлення вже оплаченого кошика, замовлення не змінюється. Примітка до оплаченого замовлення просить вас повернути один платіж у Vindi. Примітки — це записи в History замовлення, яких покупець не бачить.

Вкладка VibeFox Vindi Gateway

У Sales > Orders відкрийте замовлення, оплачене через Vindi. Внизу сторінки замовлення, поруч із History та Additional, вкладка VibeFox Vindi Gateway показує Vindi bill, Charge, середовище (з позначкою Sandbox для платежів пісочниці), Payment method, Status, суми Paid / refunded, форму повернення, історію повернень, усі Bills of this cart та Vindi notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

Повернення коштів

На вкладці VibeFox Vindi Gateway введіть Amount (підставляється сума, яку ще не повернуто), за бажанням Reason (optional), і натисніть Refund via Vindi. Підтвердіть питання Refund this amount through Vindi? This cannot be undone. Підтримуються повні та часткові повернення платежів карткою та PIX. Потрібне право змінювати розширення (задається в System > Users > User Groups). Повернення обмежені сумою, яку Vindi фактично списав, тож після розбіжності можна повернути максимум те, що сплатив покупець, а не суму замовлення. Повернення надсилається в середовищі платежу (робочий режим або пісочниця), тому ключ API цього середовища має бути заповнений.

Повне повернення також скасовує рахунок у Vindi і переводить замовлення в Refunded Status без повідомлення покупцеві та без повернення товарів на склад, як при ручній зміні статусу. Часткове повернення статус не змінює. Успішне повернення додається до історії повернень і приміток разом зі списанням Vindi та статусом. Якщо Vindi або еквайр відхиляє повернення, вкладка показує помилку, і повернення не записується. Повернення доступні, коли Vindi повідомив, що рахунок оплачено.

Vindi не може повертати платежі boleto. Вкладка показує Vindi cannot refund boleto payments. Return the money to the customer by bank transfer and record the refund manually.

Повернення товарів у Sales > Returns не надсилає гроші через Vindi. Повернення, зроблені в панелі Vindi, надходять через webhook charge_refunded і додаються до приміток. Статус замовлення автоматично не змінюється. За потреби оновіть його вручну.

Ліцензійний ключ

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Vindi Gateway — це перший блок на сторінці Extensions > Extensions > Payments > VibeFox Vindi Gateway > Edit, над налаштуваннями. Введіть ключ у License key і натисніть Activate. Після цього блок показує замаскований ключ, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб вилучити ключ із цього магазину. Нижче є рядок Product: opencart-payment-vindi і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адмін-панелі (включено англійську та російську).

Якщо ключ не прийнято, блок пояснює причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on з датою. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, розширення продовжує працювати з останнім відомим статусом.

Один ключ працює на одному домені: адреса магазину з конфігурації OpenCart. Вилучення ключа з магазину не звільняє його слот домену. Звільніть слот у своєму обліковому записі vibefox.net.

Без активного ключа Vindi не показується покупцям на оформленні замовлення. Якщо платіж усе ж розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратор, який увійшов в адмін-панель у тому самому браузері, усе ще бачить спосіб оплати в магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати та перевірити розширення до купівлі ключа. В OpenCart 4 цей попередній перегляд недоступний: магазин не бачить входу в адмін-панель, тож без активного ключа спосіб оплати приховано для всіх. Після того як ви один раз відкрили сторінку Edit, на сторінці Dashboard адмін-панелі з’являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються: рахунки, які вже створено, як і раніше підтверджуються webhook Vindi, а повернення працюють.

Коли ліцензія закінчується, розширення продовжує працювати, але оновлення та підтримка потребують продовження. Статус автоматично перевіряється знову, коли ви відкриваєте Dashboard адмін-панелі або сторінку Edit: раз на добу протягом перших 14 днів після введення ключа, а потім раз на тиждень. Cron-завдання не потрібне. Видалення розширення завжди вилучає ліцензійний ключ і статус ліцензії.

Усунення несправностей

Vindi не з’являється на оформленні замовлення: перевірте, що ліцензія активна, Enable / Disable увімкнено, покупець платить у BRL, принаймні один спосіб вибрано в Offered methods, і в поточному режимі є ключ API: Sandbox API key у режимі пісочниці, Live API key у робочому режимі. Сторінка налаштувань показує попередження, якщо ключ відсутній або валюта магазину не BRL. Також перевірте, що платіжна адреса належить до вибраної Geo Zone, і що замовлення досягає Total, заданого в налаштуваннях.

Платіж пройшов, але замовлення залишилося без статусу або в статусі очікування: webhook не працює. У Vindi перевірте, що webhook існує в обліковому записі, який ви використовуєте (робочому або пісочниці), що його URL точно збігається з показаним у налаштуваннях, включно з токеном, і що вибрано всі чотири події.

Webhook відповідає Forbidden: токен в URL відсутній або неправильний. Скопіюйте URL з налаштувань ще раз.

Webhook відповідає Verification failed, retry later: рахунок не вдалося прочитати через API Vindi (наприклад, ключ API цього середовища видалено), кошик у той самий момент оновлював інший запит, або не вдалося встановити статус замовлення. Vindi надішле сповіщення повторно. Журнал показує причину.

URL webhook у браузері показує Method not allowed: це нормально. URL приймає лише запити від Vindi.

Покупець бачить This payment method is temporarily unavailable: Vindi відхилив ключ API. Перевірте ключ поточного режиму.

Покупець бачить помилку після Confirm Order: перегляньте поле Log на сторінці розширення. Помилки записуються, навіть коли Debug log вимкнено. Для boleto платіжна адреса має містити вулицю, індекс, місто та штат.

Замовлення в статусі утримання: прочитайте примітки на вкладці VibeFox Vindi Gateway (див. Статуси замовлень), потім виконайте замовлення або поверніть платіж.

Старі замовлення пісочниці після переходу на робочий режим: кожен платіж зберігає середовище свого рахунку. Перевірки, скасування та повернення замовлень пісочниці продовжують використовувати ключ пісочниці, доки він залишається в налаштуваннях.

Повернення не проходить: прочитайте повідомлення. Платежі boleto не можна повернути через Vindi, і має бути заповнений ключ API середовища платежу. Без права змінювати розширення вкладка показує You do not have permission to refund orders (modify this extension).

Для розробників: до створення клієнта та рахунку Vindi розширення запускає події OpenCart wc_vdi_customer_request і wc_vdi_bill_request з даними запиту та замовленням.

Видалення

Перейдіть до Extensions > Extensions, оберіть тип Payments і натисніть Uninstall (червона кнопка −) поруч із VibeFox Vindi Gateway. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди видаляє власні налаштування розширення: Enable / Disable, Sort Order, Geo Zone, Total та статуси замовлень розділу Orders, які під час повторного встановлення повертаються до значень за замовчуванням. Також видаляються події OpenCart розширення (в OpenCart 4 також стартова дія, яка пропускає webhook і сторінку статусу оплати в режимі обслуговування). Якщо Delete data on uninstall увімкнено, видаляються інші налаштування (назва, опис, режим пісочниці, API-ключі, способи оплати, журналювання), токен webhook, кеш товарів і журнал. Якщо вимкнено, вони зберігаються для повторного встановлення. Рахунки Vindi та повернення замовлень завжди зберігаються, тож замовлення, оплачені раніше, можна повернути й після повторного встановлення. Наявні замовлення зберігають свої примітки про платежі.

В OpenCart 4, щоб видалити також файли розширення, після видалення перейдіть до Extensions > Installer і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox Vindi Gateway у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

Vindi є торговельною маркою її власника. Це розширення не пов’язане з Vindi і не схвалене нею.