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): четырёхзначный код источника платежей аккаунта. Его 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 и выглядят так: 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 3, а в 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-значный HEX-код цвета для платёжной страницы 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 стартовое действие расширения пропускает webhook и адреса успеха и неудачи.

Расширение принимает только разовые платежи, которые списываются сразу на странице 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 всегда удаляются также событие расширения и его стартовое действие, которое в режиме обслуживания пропускает webhook и адреса возврата. Если Delete Data on Uninstall включено, удаляются остальные настройки шлюза (название, описание, тестовый режим, учётные данные, статус заказа после оплаты, цвет бренда, журналирование) и журнал. Если выключено, они сохраняются для повторной установки. Попытки платежей Viva и возвраты всегда сохраняются, поэтому заказы, оплаченные ранее, можно вернуть и после повторной установки. Существующие заказы сохраняют свои платёжные примечания.

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

Viva Wallet — товарный знак его владельца. Это расширение не связано с Viva Wallet и не одобрено компанией Viva Wallet.