VibeFox Viva Wallet for OpenCart — Допомога

Вимоги

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

PHP: 8.0 або новіша.

Обліковий запис Viva: обліковий запис мерчанта Viva. Для тестів можна використовувати демо-обліковий запис (demo.vivapayments.com), а для реальних платежів — бойовий (www.vivapayments.com). Кожен обліковий запис має власні дані доступу. Для платежів потрібні дані Smart Checkout (Client ID та Client Secret) і Source Code джерела платежів. Merchant ID та API Key необов'язкові: вони потрібні лише для відповіді на перевірку URL вебхука з боку Viva.

Валюта: EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK або CHF. Валюта, обрана покупцем у магазині, має бути однією з них; в інших валютах спосіб оплати приховується на етапі оформлення.

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

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

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

OpenCart 3

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

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

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

4. Введіть дані демо- та/або бойового облікового запису Viva і налаштуйте джерело платежів та вебхук в обліковому записі Viva (див. Configuration).

5. Увімкніть Enable/Disable і натисніть Save. Здійсніть демо-платіж тестовою карткою Viva, поки увімкнено Test Mode, а потім вимкніть Test Mode, щоб перейти до реальних платежів.

OpenCart 4

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

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

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

4. Введіть ліцензійний ключ, дані доступу Viva, джерело платежів і вебхук так само, як у кроках з 3 до 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях. Відрізняються лише адреси для облікового запису Viva (див. Configuration).

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

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

Усі налаштування розміщено на сторінці розширення: Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка попереджає, якщо в поточному режимі немає Client ID, Client Secret або Source Code (Viva Wallet is hidden at checkout until the Demo Client ID, Client Secret and Source Code are entered., або Live у бойовому режимі), а також якщо валюта магазину за замовчуванням не підтримується. Поки тестовий режим увімкнено, вона показує Test mode is on: payments go to the Viva demo environment. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Під час збереження Title не може бути порожнім і має містити не більше 128 символів (Enter a title for the payment method (at most 128 characters).), Sort Order має бути цілим числом (Sort Order must be a whole number.), Total має бути числом, що дорівнює 0 або більше (Total: enter a number, 0 or greater.), а вибрана географічна зона та статуси замовлень мають існувати; інакше нічого не зберігається, і сторінка показує помилку. Збереження налаштувань видаляє кешовані токени доступу Viva, тож нові дані доступу використовуються одразу.

Viva Wallet

Enable/Disable: Enable Viva Wallet payment gateway вмикає або вимикає спосіб оплати. За замовчуванням: off.

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

Description: текст, який показується покупцю на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: Pay securely with Viva Wallet — cards, Apple Pay, Google Pay and more.

Test Mode: використовує демо-середовище Viva (demo.vivapayments.com). Нові платежі та виклики API використовують дані демо-облікового запису. Реальні кошти не списуються, а на кроці Confirm Order покупці бачать (Test mode: use Viva demo cards, no real money is charged.) За замовчуванням: on. Вимкніть, щоб приймати реальні платежі через бойовий обліковий запис. Уже здійснені платежі й далі перевіряються та повертаються в тому середовищі, де були проведені.

Sort Order: позиція Viva Wallet серед способів оплати під час оформлення. Залиште поле порожнім або введіть ціле число; від'ємні числа дозволені.

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

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

Demo account (test mode) and Live account

Обидва розділи мають однакові поля: один набір для демо-облікового запису, інший для бойового. У своєму обліковому записі Viva відкрийте Settings > API Access і скопіюйте дані Smart Checkout (Client ID, Client Secret), Merchant ID та API Key. Source Code розміщено в Sales > Online payments > Websites / apps.

Client ID (Demo) / Client ID (Live): OAuth 2.0 Client ID Smart Checkout облікового запису. Потрібен для платежів.

Client Secret (Demo) / Client Secret (Live): OAuth 2.0 Client Secret Smart Checkout облікового запису. Потрібен для платежів.

Source Code (Demo) / Source Code (Live): 4-значний код джерела платежів облікового запису. Його Success URL та Failure URL мають вказувати на цей магазин (див. нижче). Потрібен для платежів.

Merchant ID (Demo) / Merchant ID (Live): необов'язково. Використовується лише для відповіді на перевірку URL вебхука з боку Viva.

API Key (Demo) / API Key (Live): необов'язково. Використовується лише для відповіді на перевірку URL вебхука з боку Viva.

Збережені Client Secret та API Key більше не показуються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Clear saved secrets: наприкінці розділу Live account. Позначте збережений секрет і натисніть Save, щоб його видалити. Порожнє поле зберігає збережене значення.

Return URLs and webhook

Addresses for the Viva account: це поле показує три адреси вашого магазину, які потрібно внести в обліковий запис Viva. Вони формуються з адреси вітрини вашої інсталяції OpenCart і в OpenCart 3 мають такий вигляд: https://your-store/index.php?route=extension/payment/wcp_viva_gateway/success&, https://your-store/index.php?route=extension/payment/wcp_viva_gateway/fail& та https://your-store/index.php?route=extension/payment/wcp_viva_gateway/webhook, а в OpenCart 4 — https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.success&, https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.fail& та https://your-store/index.php?route=extension/wcp_viva_gateway/payment/wcp_viva_gateway.webhook. Копіюйте їх точно так, як їх показують налаштування. Символ & наприкінці адрес успіху та невдачі обов'язковий: Viva додає до адреси транзакцію, і без нього OpenCart відповідає сторінкою «не знайдено».

Payment source: в Sales > Online payments > Websites / apps створіть джерело платежів для домену вашого магазину в кожному обліковому записі, який використовуєте. Як Success URL і Failure URL введіть шляхи після домену з адрес успіху та невдачі.

Webhook: в Settings > API Access > Webhooks додайте адресу вебхука для цих подій:

Viva перевіряє URL перед збереженням. Розширення відповідає ключем перевірки вашого облікового запису: воно отримує ключ за допомогою Merchant ID та API Key поточного режиму або використовує ключ, введений нижче. Вебхуки підтверджують платежі, навіть коли покупець закрив браузер. Вебхуки Viva не підписуються, тому розширення ніколи не довіряє самому вебхуку: кожен платіж перевіряється через API Viva, перш ніж замовлення отримає статус. Без вебхука замовлення отримує статус лише тоді, коли покупець повертається до магазину після оплати.

Webhook Verification Key: необов'язково. Залиште порожнім, щоб отримати ключ автоматично за допомогою Merchant ID та API Key поточного режиму, або вставте сюди ключ перевірки вашого облікового запису Viva.

Order statuses

OpenCart створює замовлення на кроці Confirm Order без статусу (відсутнє замовлення). Замовлення отримує статус лише після перевірки платежу Viva. Поля статусів містять ваші статуси замовлень OpenCart.

Order Status After Payment: статус, який отримує оплачене замовлення. Він встановлюється одразу, однією зміною статусу.

Processing Status: статус оплаченого замовлення для Default і Processing. За замовчуванням: Processing.

Complete Status: статус оплаченого замовлення для Completed. За замовчуванням: Complete.

On Hold Status: статус оплаченого замовлення для On Hold, а також замовлення, платіж Viva за яким не відповідає сумі або валюті замовлення (утримується для перевірки, не оплачене; примітка пояснює причину). За замовчуванням: Pending, оскільки в OpenCart немає статусу On hold. Ви можете створити власний статус в System > Localisation > Order Statuses і вибрати його тут.

Cancelled Order Status: отриманий платіж Viva для замовлення в цьому статусі ніколи його не відкриває знову; примітка просить відновити замовлення або повернути платіж. Розширення ніколи не встановлює цей статус. За замовчуванням: Canceled.

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

Advanced Settings

Brand Color: 6-значний шістнадцятковий код кольору для сторінки оплати Viva, наприклад 0000ff. Початковий символ # видаляється. Залиште порожнім для кольору за замовчуванням. Будь-яке інше значення не зберігається: решта налаштувань зберігається, а сторінка показує Brand Color must be a 6-digit HEX code (e.g. 0000ff). The previous value was kept.

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

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

Delete Data on Uninstall: якщо увімкнено, видалення розширення стирає налаштування шлюзу та журнал. Замовлення та їхні платіжні дані (спроби платежів Viva, повернення) ніколи не видаляються. За замовчуванням: off.

Import / Export

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

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

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

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Viva Wallet). На кроці Confirm Order покупець бачить ваш опис і примітку You will be redirected to the secure Viva Wallet payment page (cards, Apple Pay, Google Pay and more). OpenCart створює замовлення на цьому кроці, ще без статусу. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення. Коли покупець натискає Confirm Order, розширення створює платіжне замовлення Viva на суму замовлення у валюті замовлення і перенаправляє покупця на сторінку Smart Checkout Viva з вашим Brand Color, якщо його задано. Там покупець платить одним із способів, увімкнених у вашому обліковому записі Viva. E-mail, ім'я, телефон, країна та мова магазину покупця передаються до Viva. Платіж у Viva відображається як OpenCart # і номер замовлення, а покупцеві описується як Order, номер замовлення, at та назва вашого магазину. Платіжне замовлення Viva спливає через 30 хвилин.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише тоді, коли Viva це підтверджує: розширення повторно зчитує транзакцію через API Viva — і під час повернення покупця, і через вебхук. Далі замовлення отримує статус стандартним способом OpenCart, зі звичайними листами про замовлення та оновленням складських залишків, а покупець бачить сторінку успішного оформлення замовлення OpenCart. Якщо оплату ще не підтверджено, сторінка Payment confirmation показує We are waiting for Viva Wallet to confirm your payment. You will receive an e-mail as soon as it is confirmed. з кнопками Check again та Back to checkout. Кошик зберігається, доки оплату не підтверджено; вебхук встановлює статус замовлення, щойно Viva підтверджує оплату. В OpenCart 4, коли покупець повертається зі сторінки Viva, короткочасна проміжна сторінка знову відкриває адресу повернення з вашого магазину, тож кошик і сесія покупця зберігаються.

Якщо оплата не вдалася або покупець скасував її на сторінці Viva, замовлення залишається без статусу, а кошик зберігається. Покупець повертається до оформлення з повідомленням The Viva Wallet payment was not completed. Please try again or choose another payment method. або The Viva Wallet payment was cancelled. You can try again or choose another payment method. і може оплатити знову. Кожна нова спроба створює нове платіжне замовлення Viva. Один кошик оплачується лише раз: якщо кошик уже оплачено іншим замовленням того самого оформлення, покупець одразу переходить на сторінку успіху. На OpenCart 4 ці повідомлення показуються над сторінкою оформлення. OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order, а OpenCart 4 оновлює замовлення на оформленні. Зміна кошика, зокрема нова кількість, вважається новим кошиком, якому потрібна власна оплата.

OpenCart 4 зберігає замовлення на оформленні, доки не буде показано сторінку успіху. Після невдалої або скасованої оплати покупець оплачує те саме замовлення знову новим платіжним замовленням Viva. Якщо це замовлення тим часом було закрите (наприклад, ви його скасували) або оплачене для кошика, який відтоді змінився, покупця повертають на оформлення з повідомленням This order can no longer be paid. Please confirm your order again., а наступне натискання Confirm Order оплачує нове замовлення.

Якщо Viva не може розпочати оплату, покупець залишається на кроці Confirm Order з повідомленням над кнопкою: Viva Wallet payments are not available at the moment. Please choose another payment method or contact us. (відсутні або неправильні дані доступу) або We could not connect to Viva Wallet. Please try again in a moment or choose another payment method. Технічна причина записується в журнал.

Сторінки повернення показують сторінку успішного оформлення замовлення лише покупцеві, який оплатив. Будь-хто інший, хто відкриє адресу повернення, перенаправляється до історії замовлень або оформлення без деталей замовлення.

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

Розширення приймає лише разові платежі, які списуються одразу на сторінці Viva. Немає попередньої авторизації та списання, розстрочки, збережених карток, підписок, Viva Native Checkout (полів картки на вашій сторінці) чи POS-терміналів. Коли покупець починає нову спробу, старе неоплачене платіжне замовлення Viva не скасовується; Viva дає йому спливти через 30 хвилин.

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

Order statuses

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

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

On Hold Status після розбіжності (за замовчуванням Pending): Viva повідомила суму або валюту, що відрізняються від суми замовлення. Замовлення не позначається оплаченим, а примітка Viva Wallet payment held for review вказує причину. Порівняйте платіж у панелі Viva із замовленням і виконайте його або поверніть кошти вручну. Якщо згодом для того самого замовлення надійде відповідний платіж, замовлення перейде в оплачений статус.

Платіж, що надійшов для замовлення в статусі Cancelled Order Status або Refunded Status, не змінює статус замовлення; примітка просить відновити замовлення або повернути платіж у панелі Viva. Якщо для вже оплаченого замовлення або для іншого замовлення вже оплаченого кошика надходить другий платіж, замовлення не змінюється; примітка до оплаченого замовлення просить повернути дублікат у панелі Viva.

Примітки — це записи в History замовлення, які покупець не бачить. Зміни статусу самі по собі не повідомляють покупця; OpenCart надсилає звичайний лист про замовлення, коли оплачене замовлення вперше отримує статус.

VibeFox Viva Wallet Gateway tab

У Sales > Orders відкрийте замовлення, оплачене через Viva Wallet. Унизу сторінки замовлення, поруч із History та Additional, вкладка VibeFox Viva Wallet Gateway показує Viva order code, Transaction ID з позначкою Demo для демо-платежів, Environment / Source Code, Viva status, суми Paid / refunded, форму повернення, історію повернень, Viva payment attempts замовлення (якщо спроб було кілька) та Viva Wallet notes замовлення. Вкладку показують користувачам, які мають доступ до розширення.

Refunds

На вкладці VibeFox Viva Wallet Gateway введіть Amount (підставляється сума, яку ще не повернуто), за бажанням Reason (optional), і натисніть Refund via Viva Wallet. Підтвердіть запитання Refund this amount via Viva Wallet? This cannot be undone. Повні та часткові повернення підтримуються для замовлень із підтвердженим платежем Viva. Потрібне право змінювати розширення (задається в System > Users > User Groups). Можна повернути до суми, яку Viva списала за платіж, навіть якщо замовлення змінювали пізніше. Повернення надсилається в обліковий запис, де було проведено платіж (демо або бойовий), у валюті платежу, тому мають бути введені Client ID та Client Secret цього облікового запису. Якщо Viva не приймає повернення, вкладка показує помилку, і повернення не фіксується. Успішне повернення додається до історії повернень і приміток разом із транзакцією повернення Viva. Повне повернення встановлює статус Refunded Status без повідомлення покупця та без повернення товарів на склад, як і зміна статусу вручну. Часткове повернення статус не змінює. Замовлення, утримане для перевірки після розбіжності, не має підтвердженого платежу й не може бути повернене з вкладки.

Повернення товарів у Sales > Returns не повертають гроші через Viva. Повернення, зроблені в панелі Viva, не імпортуються. За потреби оновіть замовлення вручну.

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

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Viva Wallet Gateway є першим блоком на сторінці Extensions > Extensions > Payments > VibeFox Viva Wallet Gateway > Edit, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче є рядок Product: opencart-payment-viva і посилання 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.

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

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

Вирішення проблем

Viva Wallet не з'являється під час оформлення: переконайтеся, що ліцензія активна, Enable/Disable увімкнено, а поточний режим має свої Client ID, Client Secret і Source Code (поля Demo у тестовому режимі, поля Live у бойовому). Валюта, вибрана в магазині, має бути однією з EUR, GBP, PLN, RON, BGN, CZK, HUF, DKK, SEK, NOK або CHF. Також перевірте, що платіжна адреса входить до вибраної Geo Zone, і що замовлення досягає Total, встановленого в налаштуваннях. Сторінка налаштувань показує попередження, якщо дані доступу відсутні.

Оплату виконано, але замовлення залишається без статусу: вебхук не працює. У Viva перевірте, що вебхук існує в обліковому записі, яким ви користуєтесь (демо або бойовий), що його URL точно збігається з показаним у налаштуваннях і що вибрано Transaction Payment Created. Перевірте, що Client ID і Client Secret облікового запису цього платежу ще введені: розширення потребує їх для перевірки платежу. Увімкніть Debug Logging і перегляньте поле Log. Замовлення також отримує статус, коли покупець повертається до магазину після оплати.

Покупець повертається на сторінку «не знайдено»: Success URL або Failure URL джерела платежів не закінчується на &. Скопіюйте шляхи точно так, як їх показують налаштування.

Viva не може перевірити URL вебхука: введіть Merchant ID та API Key поточного режиму (або сам ключ перевірки в Webhook Verification Key), збережіть і повторно перевірте в Viva. Щоб перевірити вебхук іншого облікового запису, спочатку перемкніть Test Mode або введіть ключ цього облікового запису.

Вебхук відповідає помилкою: Viva показує відповідь вашого магазину та повторює невдалі вебхуки. verification_failed (HTTP 500) означає, що не вдалося звернутися до API Viva для перевірки платежу або встановити статус замовлення. busy (HTTP 503) означає, що замовлення в цей момент обробляв інший запит. transaction_not_found (HTTP 404) означає, що транзакції немає в обліковому записі цього платежу, наприклад через неправильні дані доступу. Події щодо платежів інших магазинів у тому самому обліковому записі Viva отримують відповідь ignored.

Покупець бачить помилку після Confirm Order: перегляньте поле Log на сторінці розширення. Неправильний Client ID або Client Secret дає повідомлення, що платежі Viva Wallet недоступні. Якщо Viva недоступна або відхиляє платіжне замовлення, наприклад тому що Source Code належить іншому обліковому запису, покупець отримує повідомлення, що магазин не зміг підключитися до Viva Wallet. This payment method is not available. означає, що сесія оформлення більше не відповідає замовленню: покупець перезавантажує оформлення.

Покупець повертається й бачить We could not find your order. If you were charged, please contact us.: код платіжного замовлення Viva в адресі повернення не є платежем цього магазину, наприклад тому що джерело платежів іншого магазину вказує сюди. Перевірте Success URL і Failure URL джерела платежів.

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

На вкладці немає форми повернення: вкладка пояснює причину: у замовлення немає підтвердженого платежу Viva (Transaction ID not found. Cannot process refund.), його повністю повернено, відсутні дані доступу облікового запису платежу, або ваша група користувачів не має права змінювати розширення.

Повернення не вдається з повідомленням This payment was made in the Viva demo (or live) environment: не введено Client ID і Client Secret облікового запису, в якому було здійснено платіж. Введіть їх і повторіть спробу. Інші помилки повернення показують повідомлення Viva.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Payments і натисніть Uninstall (червона кнопка −) поруч із VibeFox Viva Wallet Gateway. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди видаляє власні налаштування розширення: Enable/Disable, Sort Order, Geo Zone, Total і поля статусів розділу Order statuses, які повертаються до значень за замовчуванням під час повторного встановлення. Кешовані токени доступу Viva та ключі вебхуків завжди видаляються. На OpenCart 4 завжди видаляється також подія розширення та його стартова дія, яка пропускає вебхук і адреси повернення в режимі обслуговування. Якщо Delete Data on Uninstall увімкнено, видаляються решта налаштувань шлюзу (назва, опис, тестовий режим, дані доступу, статус замовлення після оплати, колір бренду, журналювання) та журнал. Якщо вимкнено, вони зберігаються для наступного повторного встановлення. Спроби платежів Viva та повернення завжди зберігаються, тож замовлення, оплачені раніше, можна повернути й після повторного встановлення. Наявні замовлення зберігають свої платіжні примітки.

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

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