Назад

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

Вимоги

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

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

Валюта магазину: південноафриканський ранд (ZAR) має бути увімкненою валютою в System > Localisation > Currencies. Yoco приймає лише ZAR. Коли покупець платить в іншій валюті, спосіб оплати приховується на оформленні замовлення. Сума замовлення має становити щонайменше R2.00.

Обліковий запис Yoco: обліковий запис Yoco з онлайн-платежами. Потрібні його секретні ключі, які знаходяться в Yoco Business Portal у розділі Selling Online > Payment Gateway. Вводяться лише секретні ключі. Вебхук реєструє розширення, а його секрет підпису заповнюється для вас.

Публічний сайт: Yoco надсилає вебхуки вашому магазину, тому він має бути доступний з інтернету.

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

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

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

OpenCart 3

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

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

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

4. Вставте секретний ключ тестового режиму (sk_test_...) і, коли будете готові, секретний ключ робочого режиму (sk_live_...). Натисніть Save. Вебхук реєструється для кожного режиму, для якого є ключ.

5. Увімкніть Enable/Disable і натисніть Save. Поки ввімкнено Test mode, здійсніть тестовий платіж тестовою карткою Yoco, потім вимкніть Test mode, щоб приймати реальні платежі.

OpenCart 4

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

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

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

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

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

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

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Payments > VibeFox Yoco Pay Gateway > Edit. Розділи перелічені ліворуч; кнопка Save під списком зберігає всю сторінку. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Над налаштуваннями сторінка показує активний режим (Test mode: the test secret key is used, no real money is charged. або Live mode: real payments are accepted.). Вона попереджає, якщо валюта магазину за замовчуванням не ZAR (тоді Yoco пропонується лише коли покупець платить у ZAR, або не пропонується взагалі, якщо жодна валюта ZAR не увімкнена), і якщо в поточному режимі немає секретного ключа, наприклад Enter the test secret key to offer Yoco at checkout (test mode).

Під час збереження Title може мати не більше 128 символів, Sort Order має бути цілим числом (від’ємні дозволені), Total має бути числом, 0 або більше, а геозона та статуси замовлень мають існувати. Інакше нічого не зберігається, і сторінка вказує поле. Потім розширення перевіряє ключі та секрети вебхуків і реєструє вебхуки. Повідомлення про це з’являються над налаштуваннями.

Yoco

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

Title: назва способу оплати, яку покупець бачить під час оформлення замовлення. Вона також зберігається в замовленні як назва способу оплати. За замовчуванням: Card or Instant EFT (Yoco). До 128 символів; якщо поле порожнє, покупці бачать Card or Instant EFT (Yoco).

Description: текст, який показується покупцеві на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: You will be redirected to the secure Yoco page to pay by card or Instant EFT.

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

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

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

API-ключі

Скопіюйте секретні ключі з Yoco Business Portal у розділі Selling Online > Payment Gateway (там є посилання на розділ). Yoco має одну API для обох режимів: ключ визначає, чи є платіж тестовим, чи реальним. Тестовий режим використовує лише тестовий ключ, робочий — лише робочий.

Test mode: використовує секретний ключ тестового режиму. Реальні гроші не списуються; платіть тестовими картками Yoco. За замовчуванням: on. Вимкніть, щоб приймати реальні платежі. Поки його увімкнено, покупці бачать Test mode — use a Yoco test card; no real money is charged. на кроці Confirm Order.

Test secret key: секретний ключ тестового режиму. Починається з sk_test_.

Live secret key: секретний ключ робочого режиму. Починається з sk_live_.

Ключ, який не починається з очікуваного префікса, не зберігається: сторінка показує помилку, наприклад Yoco: the test secret key must start with sk_test_ — the previous value was kept. Інші налаштування зберігаються. Якщо під час реєстрації вебхука Yoco повідомляє, що ключ належить до іншого режиму, сторінка вам про це скаже.

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

Webhooks

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

Для кожного режиму (Test і Live) розділ показує стан вебхука:

registered: розширення зареєструвало вебхук, і показано його ідентифікатор у Yoco. Якщо примітка каже, що він для іншого URL, збережіть налаштування, щоб зареєструвати його знову.
secret entered manually: ви ввели секрет самі. Розширення його не змінює.
not registered: у режиму є ключ, але ще немає вебхука. Збережіть налаштування, щоб його зареєструвати. До того часу платежі підтверджуються лише тоді, коли покупець повертається до магазину.
no secret key: у режиму немає секретного ключа.

Розширення обробляє ці події (їх також перелічено в цьому розділі):

payment.succeeded: платіж здійснено. Розширення запитує в Yoco платіж, перш ніж встановити статус замовлення.
refund.succeeded: повернення завершено — оформлено з OpenCart або в порталі Yoco.
refund.failed: повернення не вдалося. До замовлення додається примітка.

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

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

Live webhook secret: заповнюється автоматично під час реєстрації вебхука. Очистьте його і збережіть, щоб зареєструвати вебхук знову.

Секрет вебхука має мати вигляд whsec_, після якого йде текст у base64. Будь-яке інше значення не зберігається, і лишається попереднє. Очищення секрету вебхука та збереження реєструє вебхук знову.

Замовлення

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

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

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

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

Додатково

Debug log: записує запити та вебхуки Yoco у файл yoco_p_debug.log.php у папці журналів OpenCart (storage/logs, в OpenCart 4 — system/storage/logs). Файл не можна відкрити з веб-браузера, а при досягненні 5 МБ його переміщують до yoco_p_debug.old.log.php. Помилки та попередження — наприклад, невдалі запити до Yoco і відхилені вебхуки — записуються завжди. Ключі, секрети вебхуків та адреси електронної пошти маскуються. За замовчуванням: off.

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

Delete data: якщо увімкнено, видалення розширення прибирає налаштування шлюзу, журнал і вебхуки, які розширення зареєструвало в Yoco. Дані замовлень (ідентифікатори платежів і чекаутів Yoco, повернення) завжди зберігаються, бо потрібні для повернень. За замовчуванням: off.

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

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

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

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

Спосіб оплати показується, коли покупець платить у ZAR і сума замовлення становить щонайменше R2.00. На кроці Payment Method покупець його обирає (за замовчуванням Card or Instant EFT (Yoco)). На кроці Confirm Order покупець бачить ваш опис. OpenCart створює замовлення на цьому кроці, ще без статусу. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення. Коли покупець натискає Confirm Order, розширення створює платіж Yoco на суму замовлення в центах і надсилає покупця на сторінку оплати Yoco, де він платить карткою або Instant EFT.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Yoco: розширення запитує платіж у Yoco, коли покупець повертається, і знову, коли надходить підписаний вебхук. Потім замовлення отримує статус стандартним для OpenCart способом, із звичайними листами про замовлення та оновленням складу, а покупець бачить сторінку успішного оформлення замовлення OpenCart з повідомленням Your payment with Yoco has been received. Якщо Yoco ще не підтвердив платіж, коли покупець повертається, сторінка Payment confirmation показує We are waiting for Yoco to confirm your payment. The order will be updated automatically — please do not pay again. з кнопками Check again і Back to checkout; вебхук встановлює статус замовлення, щойно він надходить. В OpenCart 4, коли покупець повертається зі сторінки Yoco, коротка проміжна сторінка знову відкриває адресу повернення з вашого магазину, тож кошик і вхід покупця зберігаються.

Якщо покупець скасовує оплату на сторінці Yoco, він повертається до оформлення замовлення з повідомленням The Yoco payment was cancelled. Your cart is saved — you can pay again or choose another payment method. Якщо платіж не вдався, повідомлення таке: The Yoco payment was not successful. Please try again or choose another payment method., і до замовлення додається примітка. Кошик зберігається. На OpenCart 4 ці повідомлення показуються над сторінкою оформлення.

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

OpenCart 4 зберігає замовлення на оформленні, доки не буде показано сторінку успіху, тож після скасованої або невдалої оплати покупець оплачує те саме замовлення знову. Якщо це замовлення було закрито без оплати (наприклад, ви його скасували), покупець повертається до оформлення з повідомленням Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., а наступне натискання Confirm Order оплачує нове замовлення.

Якщо Yoco не може розпочати оплату, покупець залишається на кроці Confirm Order з повідомленням Yoco could not start the payment. Please try again in a moment or choose another payment method. над кнопкою, а причина записується в журнал і примітки до замовлення. Замовлення менше R2.00 отримує Yoco requires an order total of at least R2.00.

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

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

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

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

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

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

On Hold Status (за замовчуванням Pending): Yoco повідомив про суму або валюту, що відрізняються від суми замовлення, наприклад тому що кошик змінили в іншій вкладці після початку оплати. Примітка це пояснює, а покупець бачить We received your payment and are reviewing it. We will contact you if anything else is needed. Перевірте платіж перед відправленням. Якщо покупець потім сплатить правильну суму новою спробою, замовлення переходить у Paid Order Status.

Refunded Status (за замовчуванням Refunded): повернення досягли оплаченої суми.

Якщо надходить платіж для замовлення з іншим статусом, наприклад скасованого або повернутого, замовлення не змінюється. Примітка просить повернути платіж у порталі Yoco або вручну відновити замовлення. Покупець бачить Your payment was received after the order had been cancelled. Please contact us — do not pay again.

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

Примітки — це записи в History замовлення, які покупець не бачить. Вони починаються зі слова Yoco.

Вкладка VibeFox Yoco Pay Gateway

У Sales > Orders відкрийте замовлення, оплачене через Yoco. Внизу сторінки замовлення, поруч із History та Additional, вкладка VibeFox Yoco Pay Gateway показує Checkout ID, Payment ID, Mode (з позначкою Test для тестових платежів), Status, суми Paid / refunded, форму повернення, таблицю Yoco checkouts of this order, історію Refunds і Yoco notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

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

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

Успішне повернення додається до історії повернень і приміток з ідентифікатором повернення Yoco. Коли повернення досягають оплаченої суми, замовлення отримує Refunded Status без сповіщення покупця і без повернення товарів на склад; часткове повернення статус не змінює. Якщо Yoco відхиляє повернення, вкладка показує Yoco refused the refund: з причиною, і повернення не записується. Якщо Yoco повідомляє, що повернення очікує, вкладка це вказує. Не повторюйте його: воно буде записано, коли Yoco підтвердить його вебхуком. Повернення доступні для замовлень, оплачених через чекаут Yoco. Замовлення в On Hold Status не має підтвердженого платежу для повернення; поверніть його в порталі Yoco.

Повернення товарів у Sales > Returns не повертають гроші через Yoco.

Повернення, оформлені в порталі Yoco, надходять через вебхук refund.succeeded і записуються в історію повернень та примітки. Коли вони досягають оплаченої суми, замовлення отримує Refunded Status. Повернення, більше за суму, що залишилася до повернення, не записується, і примітка просить перевірити замовлення. Невдале повернення додає примітку, що гроші покупцеві не повернуто.

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

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

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

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

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

Yoco не з’являється під час оформлення замовлення: переконайтеся, що ліцензія активна, Enable/Disable увімкнено, а в поточному режимі є секретний ключ: Test secret key у тестовому режимі, Live secret key у робочому. Покупець має платити в ZAR, а сума замовлення — становити щонайменше R2.00. Сторінка налаштувань показує попередження, якщо ключ відсутній або валюта магазину не ZAR. Також перевірте, що платіжна адреса входить до вибраної Geo Zone і що сума замовлення досягає Total, заданого в налаштуваннях.

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

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

Вебхуки відхиляються: відхилені вебхуки записуються в журнал. webhook secret not configured означає, що жоден секрет вебхука не задано. invalid signature означає, що секрет належить до іншої реєстрації або режиму. timestamp outside the tolerance означає, що годинник сервера неправильний: підписи приймаються в межах 5 хвилин від серверного часу. checkout not completed yet — retry і could not confirm the checkout with Yoco — retry тимчасові; Yoco надішле вебхук повторно.

URL вебхука в браузері показує лише POST: це нормально. URL приймає лише запити від Yoco.

Помилка збереження The secret key must start with sk_test_ / sk_live_: ключ вставлено в неправильне поле. Тестовий ключ починається з sk_test_, робочий — з sk_live_. Попереднє значення збережено.

Покупець бачить помилку після Confirm Order: перегляньте поле Log на сторінці розширення. Yoco is not available at the moment. Please choose another payment method. означає, що в поточному режимі немає секретного ключа.

Покупцеві повідомляють, що платіж потрібно перевірити: спробу оплачено з іншою сумою або після скасування замовлення. Прочитайте примітки на вкладці VibeFox Yoco Pay Gateway і виконайте замовлення або поверніть платіж у порталі Yoco.

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

Повернення не виконується з повідомленням No answer from Yoco: в OpenCart нічого не записано. Якщо Yoco все ж обробив повернення, повторіть те саме повернення: його не буде виконано двічі.

Для розробників: перед створенням платежу Yoco розширення викликає подію OpenCart yoco_p_checkout_payload з даними запиту та замовленням, щоб інше розширення могло доповнити запит.

Видалення

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

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

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