Назад

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

Вимоги

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

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

Обліковий запис Worldline: обліковий запис мерчанта Worldline Direct (раніше Ingenico Direct). Тестовий і робочий облікові записи окремі й мають різні дані доступу. Для кожного облікового запису потрібні Merchant ID (ваш PSPID), API Key ID із Secret API Key та ключ вебхука з його секретом. Усе це створюється в Worldline Merchant Portal (див. розділ «Налаштування»).

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

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

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

OpenCart 3

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

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

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

4. Введіть тестові дані доступу, натисніть Save, а потім Test credentials.

5. Додайте URL вебхука в Merchant Portal тестового облікового запису та введіть ключ і секрет вебхука (див. розділ «Налаштування»).

6. Увімкніть Enable/Disable, збережіть і зробіть тестовий платіж. Потім введіть робочі дані доступу, повторіть налаштування вебхука у робочому обліковому записі, натисніть Live credentials і вимкніть Test Mode.

OpenCart 4

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

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

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

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

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

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

Усі налаштування розміщено на сторінці розширення: Extensions > Extensions > Payments > VibeFox Worldline Gateway > Edit. Розділи перелічені ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка попереджає, якщо дані доступу поточного режиму (Merchant ID, API Key ID, Secret API Key) заповнені не повністю, — тоді спосіб оплати прихований на оформленні. Поки тестовий режим увімкнено, відображається Test mode is on (pre-production environment): no real money is charged. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

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

Worldline (Ingenico)

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

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

Description: текст, який покупець бачить на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: Pay securely via Worldline.

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

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

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

Worldline Direct API

Дані доступу беруться в Worldline Merchant Portal тестового та робочого облікових записів. Ваш PSPID — це Merchant ID. У розділі Developer > Payment API створюються API Key ID і Secret API Key, у розділі Developer > Webhooks — ключ і секрет вебхука. У цьому розділі є посилання на обидва портали та документацію Worldline.

Test Mode: перемикає одночасно адресу API і дані доступу. Тестовий режим використовує передпродуктивне середовище і тестові дані доступу, робочий режим — продуктивне середовище і робочі дані доступу. За замовчуванням: увімкнено. Вимкніть, щоб приймати реальні платежі. Поки тестовий режим увімкнено, покупці бачать на кроці Confirm Order повідомлення Test mode — no real money is charged.

Тестовий обліковий запис (передпродуктивне середовище)

Test Merchant ID (PSPID): PSPID вашого тестового облікового запису.

Test API Key ID: API Key ID, створений у Developer > Payment API тестового облікового запису.

Test Secret API Key: Secret API Key, що належить цьому API Key ID.

Test Webhook Key ID: необов'язково. Якщо вказано, приймаються лише вебхуки, надіслані з цим ключем.

Test Webhook Secret: секрет вебхука тестового облікового запису. Він використовується для перевірки підпису кожного вебхука.

Робочий обліковий запис (продуктивне середовище)

Live Merchant ID (PSPID): PSPID вашого робочого облікового запису.

Live API Key ID: API Key ID, створений у Developer > Payment API робочого облікового запису.

Live Secret API Key: Secret API Key, що належить цьому API Key ID.

Live Webhook Key ID: необов'язково. Якщо вказано, приймаються лише вебхуки, надіслані з цим ключем.

Live Webhook Secret: секрет вебхука робочого облікового запису.

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

Check credentials: кнопки Test credentials і Live credentials перевіряють збережені дані доступу кожного облікового запису тестовим викликом до Worldline. Спершу збережіть зміни. Відповідь з'являється під кнопками, наприклад Test credentials: connection successful., API credentials are not configured. або текст помилки від Worldline.

Вебхуки

Вебхук повідомляє ваш магазин про платежі навіть тоді, коли покупець не повертається до магазину, наприклад після закриття браузера або коли платіж підтверджується пізніше. У Merchant Portal відкрийте Developer > Webhooks тестового облікового запису та додайте URL, який показано в цьому розділі в полі Endpoint URL. В OpenCart 3 він має такий вигляд: https://your-store/index.php?route=extension/payment/wcp_worldline_gateway/webhook, в OpenCart 4 — https://your-store/index.php?route=extension/wcp_worldline_gateway/payment/wcp_worldline_gateway.webhook. Він формується з адреси вітрини вашої інсталяції OpenCart. Скопіюйте URL точно так, як його показують налаштування: він має відповідати без перенаправлень і бути доступним з інтернету. Далі введіть ID ключа вебхука та секрет у поля Test Webhook Key ID і Test Webhook Secret. Зробіть те саме в робочому обліковому записі, з робочими полями.

Розширення автоматично відповідає на перевірочний запит кінцевої точки Worldline. Воно обробляє події платежів (зміни статусу платежів) і події повернень (зміни статусу повернень). Інші події приймаються та ігноруються. Вебхуки без дійсного підпису відхиляються. Подія має бути підписана секретом того облікового запису, у якому було здійснено платіж, тож тестовий вебхук ніколи не підтверджує робочий платіж. Вебхук також ігнорується, якщо надійшов з іншого Merchant ID, ніж у облікового запису, секретом якого він підписаний. Без вебхука замовлення підтверджується лише тоді, коли покупець повертається до магазину після оплати.

Сторінка оплати та замовлення

Payment page template: необов'язкова назва шаблону розміщеної сторінки оплати (варіанта), завантаженого в Merchant Portal, наприклад SimplifiedCustomPaymentPage. Залиште порожнім для стандартної сторінки Worldline.

Order Status After Payment: який статус присвоює списаний платіж. Платежі завжди запитуються як прямий продаж (авторизація та списання).

Payment accepted (processing): замовлення отримує Paid Order Status (за замовчуванням).
Delivered (completed): замовлення отримує Complete Order Status.

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

Paid Order Status: статус після списаного платежу з Payment accepted (processing). За замовчуванням: Processing.

Complete Order Status: статус після списаного платежу з Delivered (completed). За замовчуванням: Complete.

Awaiting Capture Status: платіж авторизовано або запитано списання; вебхук списання позначає замовлення як оплачене. За замовчуванням: Pending.

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

Payment Error Status: Worldline відхилив або скасував платіж замовлення, яке очікувало списання. За замовчуванням: Failed.

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

Додатково

Logging: записує всі запити до API та вебхуки у файл wlg_debug.log.php у папці журналів OpenCart (storage/logs). Файл не можна відкрити через веб; при досягненні 5 МБ його переносять до wlg_debug.old.log.php. Помилки та попередження записуються завжди, навіть коли цю опцію вимкнено. Ключі, дані карток і персональні дані маскуються. За замовчуванням: вимкнено.

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

Delete Data: якщо увімкнено, під час видалення розширення видаляються налаштування шлюзу та журнал. Транзакції й повернення Worldline завжди зберігаються, бо вони потрібні наявним замовленням для повернень. За замовчуванням: вимкнено.

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

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

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

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

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Worldline). На кроці Confirm Order покупець бачить ваш опис. OpenCart створює замовлення на цьому кроці, ще без статусу. Коли покупець натискає Confirm Order, розширення створює розміщену сторінку оплати Worldline на суму замовлення у валюті замовлення і надсилає покупця на платіжну сторінку Worldline. Там покупець сплачує карткою, цифровим гаманцем або іншим способом оплати, увімкненим у вашому обліковому записі Worldline. Ім'я для рахунку, адреса, електронна пошта та телефон передаються до Worldline, а платіжна сторінка відкривається мовою покупця, якщо Worldline її підтримує. Кожна спроба оплати отримує власне посилання, що складається з номера замовлення та випадкової частини. На OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення.

Після оплати покупець повертається до вашого магазину. Розширення звіряє повернення із збереженою спробою та на сервері зчитує статус платежу в Worldline. Замовлення позначається як оплачене лише після підтвердження Worldline: цією перевіркою статусу або підписаним вебхуком. Далі замовлення отримує статус стандартним способом OpenCart, зі звичайними листами про замовлення та оновленням складу, а покупець бачить стандартну сторінку успішного оформлення OpenCart з повідомленням Your payment with Worldline has been received. Якщо платіж авторизовано, але ще не списано, сторінка показує Your payment is authorized. The order is confirmed as soon as Worldline confirms the capture. Якщо платіж такого замовлення не вдався, сторінка показує Your Worldline payment was not completed. Please contact us about this order.

Якщо платіж не було завершено, замовлення не отримує статусу, кошик зберігається, а покупець повертається до оформлення з повідомленням:

Cancelled or left the payment page: The payment was not completed on the Worldline page. You can try again or choose another payment method.
Declined: Your payment was declined. Please try again or choose another payment method.

Якщо статус ще не вдалося перевірити, сторінка Payment confirmation показує We could not confirm your payment yet. If you completed the payment, please do not pay again — you will receive a confirmation as soon as Worldline confirms it. з кнопками Check again і Back to checkout. Вебхук встановлює статус замовлення, щойно він надходить.

На OpenCart 4 ці повідомлення показуються над сторінкою оформлення.

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

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

Якщо Worldline не може розпочати платіж, покупець залишається на кроці Confirm Order з повідомленням Payment error: Could not create checkout session. Please try again. над кнопкою. Причина записується в журнал. Якщо дані доступу поточного режиму відсутні, покупець бачить This payment method is not available at the moment. Please choose another payment method.

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

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

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

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

Без статусу (відсутнє замовлення): покупця перенаправлено до Worldline, і він не сплатив, або Worldline ще не підтвердив платіж. У Sales > Orders такі замовлення показуються лише з фільтром Order Status, встановленим на Missing Orders.

Paid Order Status або Complete Order Status (за замовчуванням Processing або Complete): платіж списано. Статус відповідає Order Status After Payment. Примітка показує суму, ID платежу Worldline і спосіб підтвердження (підписаний вебхук або перевірка статусу).

Awaiting Capture Status (за замовчуванням Pending): Worldline повідомляє, що платіж авторизовано або списання запитано, але ще не виконано. Замовлення переходить до оплаченого статусу, коли вебхук підтверджує списання. Якщо примітка каже, що платіж не списано, спишіть його в Worldline Merchant Portal.

On Hold (Review) Status (за замовчуванням Pending): платіж не відповідає замовленню, наприклад суми або валюти відрізняються, або платіж належить до іншої спроби. Примітка показує оплачену суму, суму замовлення і посилання. Перевірте замовлення та виконайте його або поверніть платіж.

Payment Error Status (за замовчуванням Failed): Worldline відхилив або скасував платіж замовлення, яке очікувало списання.

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

Якщо платіж надходить для скасованого або поверненого замовлення, замовлення не відновлюється. Примітка просить вас скасувати або повернути платіж у Worldline Merchant Portal чи відновити замовлення вручну. Покупець, що повернувся, бачить Your payment was received after this order had been cancelled. Please contact us — we will restore the order or refund the payment. Якщо надходить другий платіж для вже оплаченого замовлення або для іншого замовлення вже оплаченого кошика, замовлення не змінюється. Примітка в оплаченому замовленні просить повернути другий платіж у Worldline Merchant Portal.

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

Вкладка VibeFox Worldline Gateway

У Sales > Orders відкрийте замовлення, оплачене через Worldline. Унизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox Worldline Gateway показує блок Worldline payment: Payment ID, Merchant reference, Hosted checkout, Status спроби, Amount charged / refunded, позначку Test environment для тестових платежів, форму повернення, історію повернень і Payment notes замовлення. Вкладку показують користувачам, які мають доступ до розширення.

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

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

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

Зміни статусу повернень надходять від Worldline вебхуком, оновлюють історію повернень і додаються до приміток. Повернення, здійснені в Merchant Portal, не змінюють статус замовлення; за потреби оновіть його вручну.

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

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

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

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

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

Worldline не з'являється на оформленні: перевірте, що ліцензію активовано, Enable/Disable увімкнено і в поточному режимі заповнено Merchant ID, API Key ID і Secret API Key: тестові поля в тестовому режимі, робочі поля в робочому. Сторінка налаштувань показує попередження, якщо їх бракує. Перевірте також, що платіжна адреса входить до вибраної Geo Zone і що замовлення досягає налаштованого Total.

Платіж пройшов, але замовлення лишається без статусу: вебхук не працює. У Merchant Portal облікового запису, який ви використовуєте (тестового чи робочого), перевірте, що кінцева точка існує і що її URL точно збігається з показаним у Endpoint URL, без перенаправлень. Перевірте, що секрет вебхука цього облікового запису внесено в потрібне поле (Test Webhook Secret або Live Webhook Secret), а поле ID ключа вебхука порожнє або збігається з ключем. Замовлення також отримає статус, коли покупець повернеться до магазину після оплати.

Webhook answers Webhook secret not configured: жоден із секретів вебхука не заданий. Введіть секрет вебхука в налаштуваннях. Worldline повторить вебхук.

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

Webhook answers Missing signature, Empty body або Invalid JSON: запит прийшов не від Worldline у очікуваному вигляді, або проксі чи перенаправлення його змінили. Перевірте, що URL відповідає без перенаправлень.

Webhook answers Ignored: вебхук надійшов з іншого Merchant ID, ніж вказаний у налаштуваннях цього режиму. Перевірте Test Merchant ID (PSPID) або Live Merchant ID (PSPID).

Webhook answers Retry later: замовлення в цей момент підтверджував інший запит, або не вдалося встановити статус замовлення. Worldline повторить вебхук. Причину дивіться в полі Log.

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

Test credentials або Live credentials показує помилку: спершу збережіть налаштування, потім перевірте, що Merchant ID, API Key ID і Secret API Key походять з одного облікового запису, а тестові значення введено в тестові поля, а робочі — у робочі.

Покупець бачить помилку після Confirm Order: дивіться поле Log на сторінці розширення. Помилки записуються в журнал, навіть коли Logging вимкнено. Щоб побачити всі деталі запитів, увімкніть Logging і спробуйте знову.

Тестові платежі не підтверджують робочий платіж: тестові та робочі платежі розділено. Перемкніть Test Mode на потрібний режим і використовуйте дані доступу та вебхук цього облікового запису.

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

У вкладці немає форми повернення: вкладка вказує причину: немає списаного платежу Worldline, платіж повністю повернено, ваша група користувачів не має права змінювати розширення, або не задано дані доступу середовища платежу.

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

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

Видалення

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

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

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