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

Вимоги

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

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

Валюта: індонезійська рупія (IDR). Midtrans списує кошти лише в IDR, тож спосіб оплати пропонується тільки тоді, коли валюта оформлення замовлення — IDR. Конвертації валюти немає. Додайте валюту IDR у System > Localisation > Currencies, якщо її немає у вашому магазині.

Обліковий запис Midtrans: потрібен Server Key з Midtrans Dashboard > Settings > Access Keys — і в sandbox-панелі, і в робочій панелі. Використовується лише Server Key. Client Key для Snap Redirect не потрібен. Самі способи оплати (GoPay, QRIS, віртуальні рахунки та інші) вмикаються у вашому обліковому записі Midtrans.

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

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

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

OpenCart 3

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

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

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

4. Введіть Server Keys і скопіюйте URL сповіщень про оплату в панель Midtrans (див. Налаштування).

5. Увімкніть Enable/Disable і натисніть Save. Перевірте в Sandbox, потім перемкніть Environment на Production.

OpenCart 4

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

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

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

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

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

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

Усі налаштування розташовано на сторінці розширення: Extensions > Extensions > Payments > VibeFox Midtrans Payment Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка попереджає, коли відсутній Server Key вибраного середовища (тоді спосіб оплати приховано на етапі оформлення замовлення), і коли валюта магазину за замовчуванням не IDR, а поки вибрано Sandbox, показує Sandbox mode: payments are simulated, no real money is charged. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Під час збереження Title має містити від 1 до 128 символів, Sort Order має бути цілим числом, Total має бути числом не меншим за 0, а Payment page expiry (minutes) — цілим числом. Якщо значення неправильне, сторінка показує помилку, і нічого не зберігається.

Midtrans

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

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

Description: текст, який покупець бачить на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: Pay securely via Midtrans — GoPay, QRIS, ShopeePay, cards, bank transfer and more. У Sandbox над ним показується рядок SANDBOX MODE: no real money is charged.

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

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

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

Облікові дані API

Скопіюйте Server Key з Midtrans Dashboard > Settings > Access Keys. У розділі є посилання на робочу панель і панель sandbox.

Environment: середовище Midtrans, яке використовують нові платежі. Під час перемикання використовуються ключ і API вибраного середовища. Замовлення зберігають середовище, у якому їх оплачено, для повернень і сповіщень. За замовчуванням: Sandbox.

Sandbox: для тестування, без реальних грошей.

Production: реальні платежі.

Production Server Key: починається з Mid-server-. Тримайте в таємниці.

Sandbox Server Key: починається з SB-Mid-server-.

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

URL сповіщень про оплату

Сповіщення повідомляє вашому магазину, що оплату здійснено. Поле Notification URL показує URL, який потрібно використовувати. На OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_midtrans_payment_gateway/webhook, на OpenCart 4 — https://your-store/index.php?route=extension/wcp_midtrans_payment_gateway/payment/wcp_midtrans_payment_gateway.webhook. Він формується з адреси вітрини вашої інсталяції OpenCart. Скопіюйте URL точно так, як його показують налаштування, і вставте його в Midtrans Dashboard > Settings > Payment > Notification URL — і в sandbox-панелі, і в робочій панелі, які ви використовуєте. URL має бути доступним з інтернету. Якщо відкрити його в браузері, він показує коротке пояснення, тож ви можете перевірити доступність. Кнопка Test notification URL у панелі Midtrans також отримує відповідь.

Кожне сповіщення має містити коректний підпис, створений одним із ваших Server Keys, і середовище ключа має збігатися із середовищем платежу. Сповіщення без коректного підпису відхиляються. Тоді статус повторно запитується через API статусів Midtrans, і лише після цього змінюється замовлення. Розширення обробляє такі статуси транзакцій Midtrans:

settlement, capture (accepted): оплату здійснено. Замовлення позначається оплаченим, коли сума (у цілих рупіях) і валюта збігаються із замовленням.

capture (challenge): платіж карткою, позначений системою виявлення шахрайства Midtrans. Замовлення переходить у статус перевірки, доки ви не схвалите або не відхилите його в панелі Midtrans.

pending: покупець обрав спосіб з відкладеною оплатою (віртуальний рахунок, магазин біля дому, QRIS) або не завершено перевірку картки 3-D Secure. Замовлення отримує статус очікування.

expire, cancel: неоплачена транзакція минула або була скасована. Замовлення в очікуванні отримує статус expired / cancelled, для будь-якого способу оплати. Замовлення без статусу його не отримує: закривається лише спроба, і покупець може оплатити знову.

deny: платіж відхилено. Замовлення в очікуванні отримує статус failed.

failure: платіж не пройшов. Замовлення в очікуванні отримує статус failed.

refund, partial_refund: повернення, оформлене в панелі Midtrans, фіксується в замовленні.

Без URL сповіщення замовлення підтверджується лише тоді, коли покупець повертається до магазину після оплати, а відкладений платіж, здійснений пізніше, не видно до повернення покупця.

Налаштування оплати

Midtrans списує кошти лише в IDR, а суми надсилаються в цілих рупіях. Якщо позиції замовлення не сходяться з округленим підсумком, до Midtrans надсилається рядок Rounding adjustment.

Payment page expiry (minutes): скільки часу має покупець на оплату (сторінка Snap, віртуальний рахунок тощо). Залиште порожнім або 0 для значення Midtrans за замовчуванням.

Order ID prefix: додається до номера, який надсилається до Midtrans, щоб кілька магазинів могли використовувати один обліковий запис Midtrans. Номер — це ID замовлення OpenCart з позначкою часу, наприклад OC-123-1700000000. Дозволені лише літери, цифри та символи - _ . ~, до 20 знаків; інші символи видаляються під час збереження. Сповіщення інших магазинів ігноруються. За замовчуванням: OC-.

Замовлення

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

Status after payment: статус після підтвердженої оплати. За замовчуванням: Обробляється. Виберіть завершений статус, щоб позначати оплачені замовлення як виконані, або свій статус перевірки, щоб вручну перевіряти кожне оплачене замовлення.

Awaiting Midtrans payment status: Midtrans повідомляє pending: видано віртуальний рахунок, код магазину біля дому або QRIS, або не завершено перевірку картки 3-D Secure. За замовчуванням: Очікує оплати.

Midtrans payment on hold status: платіж потребує вашої перевірки (див. Статуси замовлень). За замовчуванням: Очікує оплати, бо в OpenCart немає статусу On hold. Ви можете створити власний статус у System > Localisation > Order Statuses і вибрати його тут.

Payment failed status: Midtrans повідомляє deny або failure для замовлення в очікуванні. За замовчуванням: Невдалий.

Payment expired / cancelled status: очікувана транзакція замовлення в очікуванні минула або була скасована. Коли ви самі переводите неоплачене замовлення Midtrans у цей статус, його очікувана транзакція Midtrans (наприклад, виданий віртуальний рахунок) анулюється, щоб її вже не можна було оплатити. За замовчуванням: Скасовано.

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

Додатково

Debug log: записує виклики API і сповіщення у файл midtrans_p_debug.log.php у папці логів OpenCart (storage/logs). Відкрити файл через веб неможливо. Помилки завжди записуються. Ключі та дані покупців ніколи не записуються. За замовчуванням: вимкнено.

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

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

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

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

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

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

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Midtrans). На кроці Confirm Order покупець бачить ваш опис і примітку You will be redirected to the Midtrans payment page (GoPay, QRIS, ShopeePay, cards, bank transfer and more). OpenCart створює замовлення на цьому кроці, все ще без статусу. Коли покупець натискає Confirm Order, розширення створює транзакцію Midtrans Snap на суму замовлення в цілих рупіях, з позиціями замовлення, доставкою, знижками, податком і платіжними та адресними даними покупця, і надсилає покупця на сторінку оплати Midtrans. Там покупець обирає будь-який спосіб, увімкнений у вашому обліковому записі Midtrans. На OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення.

Після оплати покупець повертається до вашого магазину. Посилання повернення ніколи не позначає замовлення оплаченим: замовлення позначається оплаченим лише після підтвердження Midtrans — підписаним сповіщенням або запитом до API статусів Midtrans, коли покупець повертається. Тоді замовлення отримує статус стандартним способом OpenCart, зі звичайними листами про замовлення та оновленням запасів, а покупець бачить сторінку успішного оформлення замовлення OpenCart. Для відкладеної оплати сторінка також показує We are waiting for Midtrans to confirm your payment. If you chose a bank transfer, virtual account or convenience store, please complete the payment using the instructions from Midtrans. You will receive an e-mail once the payment is confirmed. Якщо Midtrans недоступний, коли покупець повертається, з'являється сторінка Payment confirmation з текстом We are confirming your payment with Midtrans. The order will be updated automatically — please do not pay again., кнопкою Check again і кнопкою Back to checkout.

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

OpenCart 4 зберігає замовлення в оформленні, доки не буде показано сторінку успіху. Якщо замовлення тим часом закрили без оплати (наприклад, платіж відхилено, строк минув або ви скасували замовлення), покупця повертають до оформлення з повідомленням Your previous order was cancelled without a payment. Please confirm the order again to pay with a new order., а наступне натискання Confirm Order оплачує нове замовлення. Якщо це замовлення вже розміщено, а кошик відтоді змінився, повідомлення таке: Your previous order #(number) has already been placed. Your cart has changed: please confirm the new order to pay for it. Зміна кошика, зокрема нова кількість, вважається новим кошиком, який потребує власної оплати. Якщо оплату замовлення було відхилено або строк минув уже після того, як кошик було очищено (наприклад, після оплати через віртуальний рахунок), покупець бачить The Midtrans payment of order #(number) was declined or has expired, so the order will not be shipped. To buy these items, please place a new order.

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

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

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

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

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

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

Awaiting Midtrans payment status (за замовчуванням Очікує оплати): покупець обрав спосіб з відкладеною оплатою або розпочав платіж карткою, який не завершено. Коли Midtrans повідомляє про платіж, замовлення переходить до Status after payment.

Status after payment (за замовчуванням Обробляється): платіж підтверджено. Примітка показує спосіб оплати, ID замовлення Midtrans і транзакцію.

Midtrans payment on hold status (за замовчуванням Очікує оплати): платіж карткою на перевірці системи шахрайства (challenge, гроші ще не зафіксовано), сплачена сума або валюта не збігаються із замовленням (замовлення не позначається оплаченим), або надійшов платіж для скасованого замовлення (замовлення автоматично не відкривається знову). Примітка пояснює це. Перевірте замовлення, потім виконайте його або поверніть платіж.

Payment expired / cancelled status (за замовчуванням Скасовано): неоплачена транзакція замовлення в очікуванні минула або була скасована.

Payment failed status (за замовчуванням Невдалий): платіж не пройшов, або платіж карткою, що перебував на перевірці, відхилено.

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

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

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

Вкладка VibeFox Midtrans Payment Gateway

У Sales > Orders відкрийте замовлення, оплачене через Midtrans. Внизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox Midtrans Payment Gateway показує Midtrans order ID, Transaction ID (із посиланням на транзакцію в панелі Midtrans середовища платежу) з позначкою Sandbox для тестових платежів, Payment method, Status, суми Paid / refunded, форму повернення, історію повернень і Midtrans notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

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

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

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

Повернення, оформлені в панелі Midtrans, надходять через сповіщення і автоматично додаються до історії повернень із причиною Refunded in the Midtrans dashboard. Якщо весь платіж повернуто там, замовлення отримує Refunded status.

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

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

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

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

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

Midtrans не з'являється на етапі оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable/Disable і чи вказаний Server Key для вибраного Environment. Перевірте, чи валюта оформлення — IDR, чи адреса оплати входить до вибраної Geo Zone і чи замовлення досягає Total, заданого в налаштуваннях. Сторінка налаштувань показує попередження, коли ключ відсутній або валюта магазину не IDR.

Платіж пройшов, але замовлення залишається без статусу: сповіщення не працює. Перевірте, чи URL сповіщень про оплату задано в панелі Midtrans того середовища, яке ви використовуєте (sandbox або production), чи він точно збігається з URL з Notification URL і чи він доступний: відкрийте його в браузері, він покаже коротке пояснення. Увімкніть Debug log, щоб бачити сповіщення. Замовлення також отримує статус, коли покупець повертається до магазину після оплати.

Сповіщення відповідає Invalid signature: сповіщення не було підписано вашим Sandbox або Production Server Key. Перевірте, чи ключі в налаштуваннях належать тому самому обліковому запису Midtrans, що й панель, яка надсилає сповіщення.

Сповіщення відповідає Server key not configured: Server Key не задано. Введіть його в налаштуваннях; Midtrans повторить сповіщення.

Сповіщення відповідає Order not found — ignored: ID замовлення Midtrans видано не цим магазином, наприклад іншим магазином на тому самому обліковому записі Midtrans. Призначте кожному магазину окремий Order ID prefix.

Сповіщення відповідає Environment mismatch — ignored: сповіщення підписано ключем іншого середовища, ніж те, у якому здійснено платіж.

Сповіщення відповідає Verification failed, please retry: API статусів Midtrans був недоступний. Midtrans повторить сповіщення.

Сповіщення відповідає Busy, please retry: кошик у цей момент оновлював інший запит, або не вдалося встановити статус замовлення. Midtrans повторить сповіщення. Причину дивіться в журналі.

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

Покупець бачить помилку після Confirm Order: перегляньте поле Log на сторінці розширення; помилки завжди записуються. Неправильний Server Key дає повідомлення про тимчасову недоступність платежів Midtrans. Midtrans only supports payments in IDR (Indonesian Rupiah). Please choose another payment method. означає, що замовлення не в IDR. This payment method is not available. означає, що сеанс оформлення більше не відповідає замовленню, або що спосіб оплати було вимкнено в цей час: покупцеві потрібно перезавантажити оформлення.

Покупець повертається до оформлення з Payment verification failed.: посилання повернення було неповним або не належить до замовлення. Замовлення все одно отримає статус із сповіщення.

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

Повернення не виконується: спосіб оплати або стан транзакції не дозволяє повернення через API; поверніть кошти в панелі Midtrans, і повернення автоматично зафіксується в замовленні.

Для розробників: перед створенням транзакції Snap розширення викликає подію OpenCart midtrans_p_snap_payload з даними запиту та замовленням; ID замовлення і суму змінити не можна.

Видалення

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

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

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