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

Вимоги

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

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

Обліковий запис KOMOJU: потрібні секретний ключ (sk_live_... і, для тестового режиму, sk_test_...) та секретний токен вебхука, створеного в панелі KOMOJU (див. Налаштування). Публічний ключ не потрібен. KOMOJU має мати змогу звертатися до URL вебхука вашого магазину.

Валюта замовлення: JPY, USD, EUR, TWD, KRW, PLN, GBP, HKD, SGD, NZD, AUD, IDR, MYR, PHP, THB, CNY, BRL, CHF, CAD або VND. Для замовлень в інших валютах спосіб оплати приховано.

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

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

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

OpenCart 3

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

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

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

4. У панелі KOMOJU додайте вебхук з URL і подіями, зазначеними в розділі Webhook URL, і скопіюйте його секретний токен (див. Налаштування).

5. Введіть робочий секретний ключ і робочий секретний токен вебхука, а також тестові ключі для пісочниці (sandbox). Увімкніть Enable/Disable і натисніть Save.

OpenCart 4

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

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

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

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

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

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

Усі параметри розташовані на сторінці розширення: Extensions > Extensions > Payments > VibeFox KOMOJU Payment > Edit. Розділи перелічено зліва; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує KOMOJU Sandbox Mode is enabled., поки тестовий режим увімкнено. Вона попереджає, якщо в поточному режимі немає секретного ключа (тоді спосіб оплати приховано на етапі оформлення) або секретного токена вебхука (тоді сповіщення KOMOJU відхиляються, і платежі через konbini та банківський переказ ніколи не підтверджуються), а також якщо KOMOJU не підтримує валюту магазину за замовчуванням (тоді спосіб оплати приховано для замовлень у цій валюті). Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

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

Оплата KOMOJU

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

Title: назва способу оплати, яку бачить покупець на етапі оформлення. Вона також зберігається в замовленні як назва способу оплати. За замовчуванням: KOMOJU Payment. Якщо поле залишити порожнім, використовується назва за замовчуванням. Не більше 128 символів.

Description: текст, який бачить покупець на етапі Confirm Order над кнопкою підтвердження. За замовчуванням: Pay securely on the KOMOJU payment page: credit card, convenience store (konbini), PayPay, bank transfer and other local payment methods.

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

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

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

Робочі API-ключі

Ключі знаходяться в панелі KOMOJU (там є посилання на розділи): секретний ключ — у Settings > API keys, секретний токен вебхука — у Settings > Webhooks (спочатку додайте там URL вебхука з розділу Webhook URL).

Live Secret Key: ваш робочий секретний ключ KOMOJU. Він починається з sk_live_.

Live Webhook Secret Token: секретний токен робочого вебхука. Він використовується для перевірки підпису кожного сповіщення.

Тестовий режим

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

Sandbox Mode: Enable test mode (use the test keys below, no real payments). За замовчуванням: вимкнено. Поки режим увімкнено, на етапі Confirm Order над описом відображається Test mode.

Sandbox Secret Key: ваш тестовий секретний ключ KOMOJU. Він починається з sk_test_.

Sandbox Webhook Secret Token: секретний токен вебхука тестового режиму.

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

URL вебхука

Вебхук повідомляє ваш магазин про платежі, зокрема про відкладені платежі через konbini та банківський переказ. У панелі KOMOJU в розділі Settings > Webhooks додайте URL, який показано в цьому розділі, — і для робочого, і для тестового режиму. На OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_komoju_payment/webhook, на OpenCart 4 — https://your-store/index.php?route=extension/wcp_komoju_payment/payment/wcp_komoju_payment.webhook. Він формується з адреси вітрини вашої інсталяції OpenCart. Скопіюйте URL точно так, як його показують налаштування. Потім скопіюйте секретний токен кожного вебхука в Live Webhook Secret Token або Sandbox Webhook Secret Token.

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

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

Замовлення

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

Order Status After Payment: платіж списано, суму та валюту перевірено. За замовчуванням: Processing.

Awaiting KOMOJU Payment Status: платіж авторизовано: видано документ konbini або виставлено банківський переказ, або платіж очікує захоплення в панелі KOMOJU. За замовчуванням: Pending.

KOMOJU Payment On Hold Status: сплачена сума або валюта відрізняються від замовлення, або платіж надійшов після скасування замовлення. Примітка пояснює причину. За замовчуванням: Pending, оскільки в OpenCart немає статусу On hold.

Cancelled Payment Status: платіж замовлення в очікуванні сплив або був скасований, наприклад якщо документ konbini не сплачено вчасно. За замовчуванням: Canceled.

Failed Payment Status: платіж замовлення в очікуванні не пройшов. За замовчуванням: Failed.

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

Ви можете створити власні статуси, наприклад Awaiting KOMOJU payment або On hold, у System > Localisation > Order Statuses і вибрати їх тут.

Додатково

Invoice Prefix: префікс номерів замовлень, які надсилаються в KOMOJU. Номер у KOMOJU складається з префікса, номера замовлення OpenCart і короткого випадкового суфікса, наприклад OC-123-A1B2C3. Якщо ви використовуєте кілька магазинів з одним обліковим записом KOMOJU, зробіть префікс унікальним для кожного магазину. За замовчуванням: OC-.

Enable Logging: записує події KOMOJU та виклики API в komoju_p_debug.log.php у папці журналів OpenCart (storage/logs). Файл не можна відкрити через веб. Ключі та дані покупців не записуються. Помилки й попередження записуються завжди. За замовчуванням: вимкнено.

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

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

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

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

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

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

На етапі Payment Method покупець обирає спосіб оплати (за замовчуванням KOMOJU Payment). На етапі Confirm Order покупець бачить ваш опис і примітку You will be redirected to the KOMOJU payment page to complete the payment. OpenCart створює замовлення на цьому етапі, усе ще без статусу. Коли покупець натискає Confirm Order, розширення створює платіжну сесію KOMOJU на суму замовлення у валюті замовлення і перенаправляє покупця на сторінку оплати KOMOJU. Адреса електронної пошти, ім'я, платіжна та адреса доставки, а також товари замовлення передаються в KOMOJU. Сторінка відображається японською, англійською або корейською мовою залежно від мови покупця (для інших мов — англійською). Там покупець обирає спосіб оплати. Доступні методи залежать від вашого облікового запису KOMOJU та валюти замовлення.

На OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення. За замовчуванням OpenCart 4 не запитує платіжну адресу; тоді розширення передає як платіжну адресу адресу доставки.

Після оплати покупець повертається до вашого магазину. Розширення читає платіжну сесію через API KOMOJU з ключем режиму, у якому здійснено платіж. Замовлення позначається оплаченим лише після того, як KOMOJU його підтвердить: через підписаний вебхук або читанням сесії, коли покупець повертається. Потім замовлення отримує свій статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням залишків, а покупець бачить сторінку успішного оформлення замовлення OpenCart з повідомленням Your payment with KOMOJU has been received. Якщо KOMOJU недоступний у цей момент або платіж підтверджено, але ще не застосовано, з'являється сторінка Payment confirmation з повідомленням We could not confirm the payment status with KOMOJU yet. If you completed the payment, your order will be updated automatically in a few minutes. і кнопкою Check again.

Для платежів через konbini та банківський переказ покупець отримує платіжний документ. Замовлення отримує Awaiting KOMOJU Payment Status, а сторінка успіху повідомляє покупцеві, що платіж авторизовано й його потрібно завершити згідно з інструкціями KOMOJU (наприклад, у магазині біля дому або банківським переказом). Замовлення переходить до Order Status After Payment, коли покупець платить і KOMOJU надсилає вебхук. Якщо термін дії документа спливає, замовлення переходить до Cancelled Payment Status.

Якщо платіж не було завершено, покупець повертається до оформлення замовлення з повідомленням The payment was not completed. You can try again or choose another payment method. Якщо замовлення вже було скасовано, повідомлення таке: The KOMOJU payment was not completed and the order has been cancelled. Кошик зберігається. На OpenCart 4 ці повідомлення показуються над сторінкою оформлення. Кожна нова спроба (OpenCart 3 створює нове замовлення щоразу, коли показується етап Confirm Order; OpenCart 4 оновлює замовлення оформлення і оплачує те саме замовлення знову) перевіряє відкриті сесії KOMOJU цього замовлення та інших замовлень того самого кошика: відкрита сесія цього замовлення зі незмінною сумою повторно використовується, інші відкриті сесії скасовуються в KOMOJU, а сесія, оплачена тим часом, підтверджує своє замовлення замість створення нового платежу. Зміна кошика, зокрема нова кількість, вважається новим кошиком, який потребує власної оплати.

На OpenCart 4 замовлення зберігається в оформленні, доки не буде показано сторінку успіху. Якщо це замовлення тим часом закрили (наприклад, документ konbini прострочився, платіж не вдався або ви його скасували), покупця повертають до оформлення з повідомленням Your previous order was cancelled or its payment failed. Please confirm the order again. Якщо замовлення вже розміщено, а в кошику тепер інші товари, повідомлення таке: Your previous order has already been placed for other cart contents. Please confirm the order of your current cart again. В обох випадках наступне натискання Confirm Order оплачує нове замовлення з кошика.

Якщо KOMOJU не може розпочати платіж, покупець залишається на етапі Confirm Order з коротким повідомленням над кнопкою, наприклад KOMOJU could not accept this payment: з причиною, KOMOJU payments are temporarily unavailable. Please choose another payment method or contact us. або Payment error: Could not connect to KOMOJU. Please try again in a moment. Технічна причина записується в журнал.

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

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

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

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

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

Order Status After Payment (default Processing): KOMOJU підтвердив платіж. Примітка показує ідентифікатор платежу KOMOJU, спосіб оплати та спосіб підтвердження (вебхук або повернення покупця).

Awaiting KOMOJU Payment Status (default Pending): документ konbini або банківський переказ видано і він очікує оплати, або платіж очікує захоплення в панелі KOMOJU.

KOMOJU Payment On Hold Status (default Pending): KOMOJU повідомив про суму або валюту, що відрізняються від суми замовлення, або платіж захоплено після того, як замовлення було скасовано. Примітка пояснює це. Перевірте замовлення та виконайте його або поверніть платіж.

Cancelled Payment Status (default Canceled): термін дії платіжного документа минув або платіж скасовано.

Failed Payment Status (default Failed): платіж замовлення в очікуванні не пройшов.

Refunded Status (default Refunded): платіж повністю повернуто — зі сторінки замовлення або в панелі KOMOJU.

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

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

Вкладка VibeFox KOMOJU Payment

У Sales > Orders відкрийте замовлення, оплачене через KOMOJU. Унизу сторінки замовлення, поруч із History та Additional, вкладка VibeFox KOMOJU Payment показує ідентифікатор платежу KOMOJU (з посиланням на платіж у панелі KOMOJU) з міткою Test mode для тестових платежів, спосіб оплати, сесію, номер замовлення в KOMOJU, статус, суми Paid / refunded, форму повернення коштів, історію повернень (з OpenCart або з панелі KOMOJU) та KOMOJU notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

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

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

Для платежів, які KOMOJU конвертував в іншу валюту (наприклад, konbini в JPY для замовлення в EUR), з OpenCart можливе лише повне повернення. Часткові повернення робіть у панелі KOMOJU.

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

Повернення, зроблені в панелі KOMOJU, надходять через вебхук і додаються до історії повернень з приміткою. Коли повертається весь платіж, замовлення переходить до Refunded Status. Часткові повернення, зроблені в панелі для платежів, конвертованих в іншу валюту, лише позначаються в замовленні: внесіть відповідну суму в OpenCart вручну.

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

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

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

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

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

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

Оплату проведено, але замовлення залишається без статусу: вебхук не працює. У панелі KOMOJU перевірте, що вебхук існує для режиму, який ви використовуєте, що його URL точно збігається з вказаним у розділі Webhook URL, і що події вибрано. Перевірте, що його секретний токен введено в потрібне поле (Live Webhook Secret Token або Sandbox Webhook Secret Token), і перегляньте поле Log на сторінці розширення. Платежі картками підтверджуються й тоді, коли покупець повертається до магазину, але платежі через konbini та банківський переказ підтверджуються лише вебхуком.

Вебхук відповідає Failed to verify KOMOJU webhook signature.: секретний токен відсутній або належить іншому вебхуку. KOMOJU повторить сповіщення.

Вебхук відповідає Mode mismatch, ignored.: вебхук підписано секретним токеном іншого режиму, ніж той, у якому було здійснено платіж. Використовуйте окремі вебхуки та токени для робочого і тестового режимів і перевірте, що вони не переплутані.

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

Вебхук відповідає Order is busy, retry later. або Temporary error, retry later.: замовлення оновлював інший запит, або платіж не вдалося обробити в цей момент. KOMOJU повторить сповіщення. Причину наведено в журналі.

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

Замовлення перебуває в статусі очікування або утримання: прочитайте KOMOJU notes на вкладці замовлення. Документ очікує оплати, платіж очікує захоплення в панелі KOMOJU, сума або валюта не збіглися, або платіж надійшов після скасування замовлення.

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

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

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

Видалення

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

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

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