VibeFox OpenPay for OpenCart — Допомога
Вимоги
OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 і новіші (перевірено на 4.1.0.3).
PHP: 8.0 або новіша.
HTTPS: ваш магазин має працювати через HTTPS, оскільки форма картки розміщена на сторінці оформлення замовлення.
OpenPay account: обліковий запис OpenPay з Мексики, Колумбії або Перу. Вам потрібні його Merchant ID, приватний ключ (sk_...) і публічний ключ (pk_...). Панелі пісочниці та бойового режиму мають різні Merchant ID і ключі, а розширення зберігає їх окремо.
Currency: покупець має платити у валюті, яку приймає країна вашого облікового запису: Мексика — MXN або USD, Колумбія — COP або USD, Перу — PEN або USD. Для інших валют спосіб оплати на сторінці оформлення замовлення не відображається.
VibeFox license key: придбається на vibefox.net. Один ключ працює для одного домену.
Картку введено на вашій сторінці оформлення замовлення, але її зчитує та токенізує у браузері openpay.js. Поля картки не мають імені й ніколи не надсилаються на ваш сервер. Оскільки форма картки розміщена на вашій сторінці, ваша зона відповідальності за PCI DSS — SAQ A-EP; уточніть це у свого еквайєра.
Встановлення
Архів для завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 wcp_openpay_gateway-oc3-(version).ocmod.zip і пакет для OpenCart 4 wcp_openpay_gateway.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.
OpenCart 3
1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_openpay_gateway-oc3-(version).ocmod.zip. Розширення не містить змін OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість інсталятора можна скопіювати вміст папки upload з цього пакета в кореневу папку вашого магазину.
2. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox OpenPay Gateway і натисніть Install (зелена кнопка +). Вашому адміністратору потрібне право змінювати список платіжних розширень.
3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань. Вставте ліцензійний ключ VibeFox у поле License key у блоці ліцензії у верхній частині сторінки та натисніть Activate (див. Ліцензійний ключ).
4. Оберіть Account country і введіть ключі пісочниці та бойові ключі (див. Налаштування).
5. Рекомендовано: додайте URL вебхука в панелі OpenPay (див. Налаштування).
6. Увімкніть Enable / Disable і натисніть Save. Перевірте оплату тестовими картками пісочниці OpenPay, а потім вимкніть Sandbox mode, щоб приймати справжні платежі. Зберігайте ключі пісочниці, доки можете ще повертати кошти за замовленнями з пісочниці.
OpenCart 4
1. В адмін-панелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл wcp_openpay_gateway.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з імені файлу, і перейменований пакет не працює.
2. Пакет з'являється у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.
3. Перейдіть до Extensions > Extensions і виберіть тип Payments. Знайдіть VibeFox OpenPay Gateway, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).
4. Введіть ліцензійний ключ, ключі OpenPay і вебхук так само, як у кроках з 3 до 6 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях. Відрізняється лише URL вебхука (див. Вебхук).
Нова інсталяція починається з вимкненим способом оплати та увімкненим режимом пісочниці.
Налаштування
Усі налаштування розташовано на сторінці розширення: Extensions > Extensions > Payments > VibeFox OpenPay Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка попереджає, коли ключі поточного режиму неповні (тоді спосіб оплати приховується на сторінці оформлення замовлення) і коли валюта за замовчуванням вашого магазину не приймається обраною країною облікового запису, а поки ввімкнено режим пісочниці, показує Sandbox mode is enabled — no real charges are made. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.
Під час збереження ключі перевіряються. Merchant ID може містити лише літери та цифри, приватний ключ має починатися з sk_, а публічний — з pk_. Некоректне значення не зберігається: лишається попереднє значення і з'являється помилка, наприклад Sandbox: The private key must start with sk_. Те саме стосується Sort Order, якщо це не ціле число (Sort Order must be a whole number — the previous value was kept.), і Total, якщо це не число, що дорівнює 0 або більше. Інші поля зберігаються. Якщо спосіб оплати увімкнено, але ключі поточного режиму неповні, ви також побачите повідомлення, що шлюз залишається прихованим на сторінці оформлення замовлення. Порожній Title або назва довша за 128 символів відхиляється з повідомленням Enter a title for the payment method (1 to 128 characters)., і тоді нічого не зберігається.
OpenPay
Enable / Disable: Enable OpenPay card payments вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.
Title: назва способу оплати, яку бачать покупці на сторінці оформлення замовлення. Вона також зберігається в замовленні як назва способу оплати. За замовчуванням: Credit or debit card (OpenPay). Обов'язкове поле, до 128 символів.
Description: текст, що відображається над формою картки на кроці Confirm Order. За замовчуванням: Pay securely with your credit or debit card. Ваш банк може попросити підтвердити платіж (3D Secure).
Sort Order: місце OpenPay серед способів оплати на сторінці оформлення замовлення. Залиште поле порожнім або введіть ціле число (від'ємні числа дозволені).
Geo Zone: пропонувати OpenPay лише для платіжних адрес у вибраній географічній зоні. За замовчуванням: All zones. Географічні зони налаштовуються в System > Localisation > Geo Zones. В OpenCart 4, якщо магазин не запитує платіжну адресу, використовується адреса доставки.
Total: сума кошика в валюті за замовчуванням магазину, яку має досягти замовлення, перш ніж буде запропоновано OpenPay. Залиште поле порожнім, щоб пропонувати OpenPay за будь-якої суми.
Обліковий запис OpenPay
Merchant ID, приватний ключ (sk_) і публічний ключ (pk_) містяться у вашій панелі OpenPay в розділі Settings (Configuración). У цьому розділі є посилання на панелі пісочниці та бойового режиму для Мексики, Колумбії та Перу.
Account country: країна вашого облікового запису OpenPay. Вона визначає API OpenPay, бібліотеку openpay.js цієї країни та прийнятні валюти. За замовчуванням: Mexico.
Sandbox mode: використовує пісочницю OpenPay (тестові ключі, без справжніх списань) і перемикає на пісочницю як ключі, так і API. Поки режим увімкнено, на сторінці оформлення замовлення відображається значок SANDBOX MODE. За замовчуванням: увімкнено. Вимкніть його, щоб приймати справжні платежі.
Sandbox Merchant ID: Merchant ID з панелі пісочниці, Settings (Configuración), API-ключі.
Sandbox Private Key: приватний ключ пісочниці. Починається з sk_. Використовується лише на сервері; нікому його не передавайте.
Sandbox Public Key: публічний ключ пісочниці. Починається з pk_. openpay.js використовує його в браузері для токенізації картки.
Live Merchant ID: Merchant ID з панелі бойового режиму, Settings (Configuración), API-ключі.
Live Private Key: приватний бойовий ключ (sk_...).
Live Public Key: публічний бойовий ключ (pk_...).
Збережені приватні ключі більше ніколи не відображаються. Поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Щоб видалити збережений приватний ключ, позначте Clear the saved key on save під полем і натисніть Save.
Webhook
Вебхук не є обов'язковим, але рекомендований. Він підтверджує платежі, коли покупець не повертається зі сторінки 3D Secure, наприклад після закриття браузера. У панелі OpenPay перейдіть до Settings > Webhooks і додайте URL, який показано в полі Webhook URL у цьому розділі. В OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_openpay_gateway/webhook, в OpenCart 4 — https://your-store/index.php?route=extension/wcp_openpay_gateway/payment/wcp_openpay_gateway.webhook. Він формується з адреси вітрини вашої інсталяції OpenCart. Скопіюйте його точно так, як його показують налаштування. Додайте вебхук у панель кожного режиму, яким користуєтеся (пісочниця та бойовий режим).
Коли ви додаєте вебхук, OpenPay надсилає на цей URL код підтвердження. Код з'являється в цьому розділі з датою надходження, щоб ви могли підтвердити вебхук у панелі OpenPay. Доти розділ показує No verification code received yet.
Розширення обробляє такі події:
OpenPay не підписує вебхуки, тому розширення ніколи не довіряє самому повідомленню. Воно використовує його лише для того, щоб знайти списання, а потім зчитує списання через API OpenPay з приватним ключем того режиму та тієї країни облікового запису, у яких було здійснено оплату. Повідомлення про списання, яке цей магазин не створював, ігнорується. Вебхук працює й тоді, коли магазин перебуває в режимі обслуговування: OpenCart 3 пропускає запити платіжних розширень, а в OpenCart 4 розширення додає стартову дію, яка пропускає вебхук і повернення покупця з 3D Secure.
Замовлення
OpenCart створює замовлення на кроці Confirm Order без статусу (відсутнє замовлення). Замовлення отримує статус лише після того, як OpenPay підтвердив списання. Відхилена картка або невдала перевірка 3D Secure залишають замовлення без статусу, примітка пояснює причину, і покупець може оплатити знову. Кожне поле нижче перелічує ваші статуси замовлень OpenCart; власні статуси можна створити в System > Localisation > Order Statuses.
Order Status After Payment: OpenPay підтвердив списання, а його сума та валюта збігаються із замовленням. За замовчуванням: Processing.
Awaiting OpenPay Payment: списання триває (ще не захоплено); вебхук пізніше завершить його або позначить як невдале. За замовчуванням: Pending.
OpenPay Payment On Hold: OpenPay списав іншу суму або валюту, ніж у замовленні, або списання було завершено після того, як замовлення вже скасували. За замовчуванням: Pending.
Payment Error Status: списання для замовлення, що очікує на OpenPay, або призупиненого замовлення не вдалося, було скасовано або прострочено. За замовчуванням: Failed.
Refunded Status: списання повністю повернено зі сторінки замовлення. Часткові повернення лише додають примітку. За замовчуванням: Refunded.
Додатково
Debug log: записує етапи оплати у wc_opy_debug.log.php у папці логів OpenCart (storage/logs). Файл не можна відкрити через веб, а після досягнення 5 МБ його переміщують до wc_opy_debug.old.log.php. Помилки та попередження записуються навіть тоді, коли опцію вимкнено. Ключі, дані картки та дані покупців ніколи не записуються. За замовчуванням: вимкнено.
Log: показує розмір журналу та його останні записи. Натисніть Clear log, щоб очистити його.
Delete data on uninstall: якщо увімкнено, під час видалення розширення буде вилучено налаштування шлюзу, збережений код підтвердження вебхука та журнал. Записи списань OpenPay за замовленнями належать до історії платежів і завжди зберігаються, тож замовлення можна буде повернути й після повторного встановлення. За замовчуванням: вимкнено.
Імпорт / експорт
Export: Download JSON зберігає налаштування у файл JSON. Приватні ключі не експортуються.
Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування. Збережені приватні ключі залишаються.
Оформлення замовлення
На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Credit or debit card (OpenPay)). На кроці Confirm Order покупець бачить ваш опис і форму картки: Cardholder name, Card number, Expiry (MM/YY) і Card code (CVV). У режимі пісочниці форма показує SANDBOX MODE — Test environment. No real charges will be made. OpenCart створює замовлення на цьому кроці, все ще без статусу. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options; форма картки розміщена в розділі підтвердження внизу сторінки оформлення замовлення, над Confirm Order. Коли покупець натискає Confirm Order, openpay.js перетворює картку на одноразовий токен у браузері, а бібліотека антифроду додає ідентифікатор сесії пристрою. Лише ці два значення надсилаються до вашого магазину. Неповна форма показує Please fill in all card fields. під формою.
Після цього розширення створює списання з 3D Secure на суму замовлення у валюті замовлення і надсилає покупця на сторінку 3D Secure його банку, яку надає OpenPay. Кожна спроба отримує власний номер замовлення OpenPay. Описом списання є Order #, номер замовлення та назва вашого магазину. Ім'я, e-mail і телефон покупця з платіжної адреси передаються до OpenPay; обліковий запис покупця в OpenPay не створюється.
Коли покупець повертається, розширення зчитує списання через API OpenPay. Замовлення позначається оплаченим лише після підтвердження OpenPay: списання має належати цьому замовленню, бути завершеним і точно збігатися із сумою та валютою замовлення. Далі замовлення отримує статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням запасів, а покупець бачить сторінку успішного оформлення замовлення OpenCart з повідомленням Your card payment has been received. Якщо OpenPay повідомляє, що списання триває, замовлення отримує статус Awaiting OpenPay Payment, а сторінка показує We are confirming your card payment with OpenPay. The order will be updated automatically — please do not pay again. Якщо результат ще невідомий, сторінка Payment confirmation показує той самий текст із кнопкою Check again і кнопкою Back to checkout; вебхук встановлює статус замовлення, щойно надходить. Якщо списання, що триває, пізніше не вдається, сторінка успіху показує Your OpenPay card payment was not completed. Please contact us about this order.
Якщо картку відхилено або 3D Secure не пройдено, замовлення залишається без статусу, додається примітка, а покупець повертається до оформлення з повідомленням The card payment was not completed (declined or 3-D Secure failed). Please try again or use another card. Кошик зберігається. В OpenCart 4 це повідомлення показується над сторінкою оформлення замовлення. OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order; OpenCart 4 зберігає одне замовлення для оформлення і оновлює його, тож покупець знову оплачує те саме замовлення з новою спробою. Перед новою спробою розширення перевіряє попереднє списання з кошика: якщо його насправді оплачено, це замовлення отримує статус без другого списання; якщо воно ще триває, покупець бачить A previous payment for this order is still being processed. Please do not pay again — the order will be updated automatically.; якщо його стан не можна перевірити, нове списання не здійснюється, і покупець бачить We could not confirm the status of your previous payment attempt. Please try again in a few minutes. Кошик, який уже оплачено, ніколи не списується знову.
В OpenCart 4 замовлення зберігається на етапі оформлення доти, доки не буде показано сторінку успішного оформлення замовлення. Якщо це замовлення тим часом було закрито (наприклад, його списання не вдалося після очікування оплати, або ви його скасували чи повернули), покупця повертають до оформлення з повідомленням This order can no longer be paid. Please reload the checkout page and confirm the order again., а наступне натискання Confirm Order оплачує нове замовлення. Якщо це замовлення вже має статус, а в кошику тепер інші товари або кількості, покупця також повертають до оформлення, і новий кошик отримує нове замовлення.
Відхилені картки отримують зрозуміле повідомлення, наприклад The card has insufficient funds. Please use another card., The card has expired. Please use another card. або The security code (CVV) is not valid. Please check it and try again. Технічні помилки OpenPay покупцям ніколи не показуються; вони потрапляють до журналу та приміток замовлення.
Спосіб оплати приховується на сторінці оформлення замовлення, якщо його вимкнено, якщо ключі поточного режиму неповні або якщо покупець платить у валюті, яку країна облікового запису не приймає.
Розширення приймає лише оплату картками зі списанням одразу. Воно не підтримує збережені картки, підписки, розстрочку без відсотків (MSI) чи оплату частинами, оплату бонусними балами картки, готівку, платежі SPEI, PSE або CoDi, а також окремі авторизацію та захоплення.
Замовлення та повернення коштів
Статуси замовлень
No status (missing order): покупець перебуває на сторінці 3D Secure, не завершив оплату або картку було відхилено. У Sales > Orders такі замовлення показуються лише з фільтром Order Status, встановленим на Missing Orders.
В OpenCart 4 неоплачене замовлення з оформлення може отримати статус Voided, який OpenCart 4 встановлює, коли покупець повертається до кроку Confirm Order. Розширення вважає таке замовлення замовленням без статусу, а пізніший платіж все одно його підтверджує.
Order Status After Payment (default Processing): оплату підтверджено. Примітка показує ідентифікатор списання OpenPay та режим (бойовий або пісочниця).
Awaiting OpenPay Payment (default Pending): OpenPay повідомляє, що списання триває (ще не захоплено). Замовлення переходить до Order Status After Payment, коли списання завершено, або до Payment Error Status, якщо воно не вдалося.
OpenPay Payment On Hold (default Pending): OpenPay повідомляє про завершене списання з іншою сумою або валютою, ніж у замовленні (замовлення не позначається оплаченим, примітка показує різницю), або про платіж, який надійшов за замовленням, що вже було скасовано чи повернуто. Перевірте замовлення та виконайте його або поверніть платіж.
Payment Error Status (default Failed): списання, що триває, не вдалося, було скасовано або прострочено.
Refunded Status (default Refunded): списання повністю повернено через розширення.
Якщо для замовлення або кошика, який уже оплачено, надходить друге завершене списання, замовлення не змінюється. Примітка, що починається з OpenPay WARNING, на оплаченому замовленні просить вас повернути дублікат у панелі OpenPay.
Примітки — це записи в History замовлення, які покупець не бачить.
Вкладка VibeFox OpenPay Gateway
У Sales > Orders відкрийте замовлення, оплачене через OpenPay. Унизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox OpenPay Gateway показує ідентифікатор списання, його статус, середовище та країну облікового запису з міткою Sandbox для платежів із пісочниці, суми Charged / order, суму повернення, форму повернення коштів, історію повернень і OpenPay notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.
Повернення коштів
Для облікових записів із Мексики та Перу: на вкладці введіть Amount (підставляється сума, яку ще не повернуто), за бажанням Reason (optional), і натисніть Refund via OpenPay. Підтвердьте запитання Refund this amount through OpenPay? This cannot be undone. Підтримуються повні та часткові повернення, але не більше суми, яку списав OpenPay. Вам потрібне право змінювати розширення (встановлюється в System > Users > User Groups). Повернення надсилається з ключами того режиму та тієї країни облікового запису, у яких було здійснено списання, тож ключі цього режиму мають бути заповнені. Якщо OpenPay не приймає повернення, вкладка показує помилку, наприклад OpenPay refund failed: ..., і повернення не реєструється. Успішне повернення додається до історії повернень і приміток разом із ідентифікатором повернення OpenPay. Повне повернення переводить замовлення в Refunded Status без повідомлення покупця і без повернення товарів на склад, як і ручна зміна статусу. Часткове повернення статус не змінює. Повернення доступні після підтвердження платежу OpenPay; замовлення, призупинене через розбіжність суми, через розширення не повертається.
OpenPay Колумбія не підтримує повернення коштів за картками через API, як і офіційні інтеграції OpenPay. Для колумбійських списань вкладка не пропонує форму повернення і пояснює причину; поверніть списання в панелі OpenPay.
Повернення товарів у Sales > Returns не повертають гроші через OpenPay.
Повернення коштів та оскарження платежів (chargebacks), зроблені в панелі OpenPay, надходять через вебхук і один раз додаються до приміток. Статус замовлення автоматично не змінюється. За потреби оновіть його вручну.
Ліцензійний ключ
Розширення працює з ліцензійним ключем VibeFox, отриманим на vibefox.net. Блок ліцензії License — VibeFox OpenPay Gateway — перший блок на сторінці Extensions > Extensions > Payments > VibeFox OpenPay Gateway > Edit, над налаштуваннями. Вставте ключ у License key і натисніть Activate. Після цього блок показує ключ у замаскованому вигляді, статус (наприклад, дату, до якої ліцензія чинна, і ваш домен), а також кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, та Remove key, щоб вилучити ключ із цього магазину. Нижче розташовано рядок Product: opencart-payment-openpay і посилання 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.
Без активного ключа OpenPay не показується покупцям на сторінці оформлення замовлення. Якщо оплату все ж розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратор, який увійшов до адмін-панелі у тому самому браузері, усе ще бачить спосіб оплати в магазині з позначкою (unlicensed — visible to admins only), тож ви можете налаштувати й перевірити розширення до придбання ключа. В OpenCart 4 цей попередній перегляд недоступний: магазин не бачить входу адміністратора, тож без активного ключа спосіб оплати приховано для всіх. Після того як ви один раз відкриєте сторінку Edit, на Dashboard адмін-панелі з'явиться нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються: уже розпочаті платежі й далі підтверджуються, а повернення працюють.
Коли ліцензія спливає, розширення продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється знову, коли ви відкриваєте Dashboard або сторінку Edit адмін-панелі: щодня протягом перших 14 днів після введення ключа, а потім щотижня. Cron-завдання не потрібне. Під час видалення розширення ключ ліцензії та статус ліцензії завжди вилучаються.
Усунення несправностей
OpenPay не з'являється на сторінці оформлення замовлення: перевірте, що ліцензія активна, що Enable / Disable увімкнено і що в поточному режимі є всі три ключі: ключі пісочниці в режимі пісочниці, бойові ключі в бойовому режимі. Перевірте, що покупець платить у валюті, яку приймає Account country (Мексика: MXN, USD; Колумбія: COP, USD; Перу: PEN, USD). Сторінка налаштувань показує попередження в кожному з цих випадків. Також перевірте, що платіжна адреса входить до вибраної Geo Zone і що замовлення досягає Total, заданого в налаштуваннях.
Оплату пройдено, але замовлення залишається без статусу: покупець не повернувся зі сторінки 3D Secure, а вебхук не працює. Перевірте, що URL вебхука додано в панелі OpenPay того режиму, яким ви користуєтеся, точно так, як його показують налаштування, з переліченими вище подіями. Перевірте, що ключі того режиму, у якому відбулася оплата, заповнені: без них вебхук відповідає not configured, і OpenPay повторює спробу пізніше. Замовлення також отримає статус, коли покупець повернеться до магазину або спробує знову оплатити той самий кошик.
Вебхук відповідає ignored (unknown order): списання створено не цим магазином, наприклад це списання іншого магазину на тому самому обліковому записі OpenPay. Нічого не змінюється.
Вебхук відповідає verification failed: не вдалося звернутися до API OpenPay, щоб прочитати списання. OpenPay повторює вебхук.
Вебхук відповідає busy: кошик у цей самий момент оновлював інший запит, або не вдалося встановити статус замовлення. OpenPay повторює вебхук. Увімкніть Debug log, щоб побачити причину.
URL вебхука в браузері показує invalid body: це нормально. URL приймає лише повідомлення від OpenPay.
Покупець бачить The secure card form could not be loaded: openpay.js або бібліотека антифроду OpenPay не завантажилися в браузері, або не вдалося створити ідентифікатор сесії пристрою. Попросіть покупця оновити сторінку та повторити спробу.
Покупець бачить The payment could not be processed right now: OpenPay відхилив запит або не відповів. Причину наведено в журналі та в примітках до замовлення. Типова причина — неправильний Merchant ID або приватний ключ. Якщо OpenPay не відповів, перевірте списання в панелі OpenPay, перш ніж покупець оплатить знову.
Покупець бачить This test card cannot be used for real payments: була використана тестова картка пісочниці, коли режим пісочниці вимкнено.
Покупець бачить Billing email is required for OpenPay: у замовленні немає коректної адреси електронної пошти.
Замовлення має статус OpenPay Payment On Hold після оплати: прочитайте OpenPay notes на вкладці (див. Статуси замовлень), а потім виконайте замовлення або поверніть платіж.
Повернення не вдається з повідомленням про режим: замовлення було оплачено в режимі пісочниці або в бойовому режимі, а ключі цього режиму не встановлено. Введіть їх і повторіть спробу.
Повернення не вдається з повідомленням The order is being updated right now: вебхук або інший запит у цей самий момент оновлював замовлення. Спробуйте ще раз трохи пізніше.
Видалення
Перейдіть до Extensions > Extensions, виберіть тип Payments і натисніть Uninstall (червона кнопка −) поруч із VibeFox OpenPay Gateway. Ліцензійний ключ і статус ліцензії цього розширення завжди вилучаються. OpenCart завжди видаляє власні налаштування розширення: Enable / Disable, Sort Order, Geo Zone, Total і статуси замовлень у розділі Orders, які повертаються до значень за замовчуванням під час повторного встановлення. Також видаляється подія OpenCart цього розширення (в OpenCart 4 також його події та стартова дія, яка пропускає вебхук і повернення з 3D Secure в режимі обслуговування). Якщо ввімкнено Delete data on uninstall, вилучаються інші налаштування шлюзу (назва, опис, країна облікового запису, режим пісочниці, ключі, журналювання), збережений код підтвердження вебхука та журнал. Якщо опцію вимкнено, вони зберігаються для пізнішого повторного встановлення. Записи списань і повернень OpenPay завжди зберігаються, тож раніше оплачені замовлення можна буде повернути й після повторного встановлення. Наявні замовлення зберігають свої примітки щодо оплати.
В OpenCart 4, щоб також видалити файли розширення, після цього перейдіть до Extensions > Installer і натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox OpenPay Gateway у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.
OpenPay є торговельною маркою її правовласника. Це розширення не пов'язане з OpenPay і не схвалене OpenPay.