Назад

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

Вимоги

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

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

Валюта замовлення: AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR або USD. Для замовлень в інших валютах спосіб оплати не показується на оформленні замовлення.

Доступ до вашого магазину з інтернету: Tap надсилає результат платежу на вебхук вашого магазину, тому сайт має бути доступний з інтернету. URL вебхука передається з кожним платежем; у панелі Tap нічого налаштовувати не потрібно.

Обліковий запис Tap: вам потрібні API-ключі з вашої панелі Tap (goSell, облікові дані API). Тестові ключі починаються з pk_test_ / sk_test_, бойові — з pk_live_ / sk_live_. Секретний ключ потрібен завжди; публічний ключ — лише для спливаючого вікна оформлення замовлення. Які способи оплати пропонуються (mada, KNET, Benefit та інші) і підтвердження домену для Apple Pay налаштовуються у вашому обліковому записі Tap.

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

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

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

OpenCart 3

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

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

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

4. Введіть ваші тестові та бойові ключі Tap, виберіть дію оплати, тип оформлення замовлення та мову сторінки Tap (див. Налаштування).

5. Увімкніть Enable / Disable і натисніть Save. Перевірте оплату тестовими картками Tap, а потім вимкніть Test mode.

OpenCart 4

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

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

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

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

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

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

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Payments > VibeFox Tap Payments > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує Test mode is on: payments use your Tap test keys and no real money is charged. або Live mode: real payments are accepted. Вона також попереджає, якщо для поточного режиму відсутні ключі (тоді спосіб оплати не показується на оформленні замовлення), і якщо типова валюта магазину не підтримується Tap. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Під час збереження Title не може бути порожнім або довшим за 128 символів, Sort Order має бути цілим числом (від'ємні значення допускаються), Total має бути числом 0 або більше, а статуси замовлень мають існувати; інакше нічого не зберігається. Ключ з неправильним префіксом для свого поля не зберігається: попереднє значення лишається, решта налаштувань зберігається, і з'являється повідомлення на кшталт Test secret key was not saved: a Tap key for this field starts with "sk_test_".. Наприклад, бойовий ключ у тестовому полі відхиляється.

Tap Payments

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

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

Description: текст, який покупець бачить на кроці Confirm Order над кнопкою підтвердження. За замовчуванням: Pay with Visa, Mastercard, mada, KNET, Benefit, Apple Pay or Google Pay.

Sort Order: місце Tap серед способів оплати на оформленні замовлення. Залиште порожнім або введіть ціле число (від'ємні значення допускаються).

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

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

API-ключі Tap

Ваші ключі знаходяться в панелі Tap (goSell, облікові дані API). Розділ містить посилання на документацію розробника Tap.

Test mode: використовує тестові ключі, реальні кошти не списуються. Платежі, перевірки статусу, захоплення та повернення завжди використовують ключі того режиму, у якому було здійснено платіж, тож тестовий платіж і після переходу на бойовий режим перевіряється й повертається тестовим ключем. За замовчуванням: увімкнено. Поки режим увімкнено, покупці бачать Test mode: no real payment will be made. на кроці Confirm Order і на сторінці оплати у спливаючому вікні.

Test publishable key: починається з pk_test_. Потрібен для спливаючого вікна.

Test secret key: починається з sk_test_.

Live publishable key: починається з pk_live_. Потрібен для спливаючого вікна.

Live secret key: починається з sk_live_.

Merchant ID: необов'язково. Ваш ідентифікатор мерчанта Tap; потрібен лише тоді, коли Tap попросив спрямовувати платежі на конкретний обліковий запис мерчанта.

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

Оплата

Payment action: що відбувається з грошима, коли покупець платить.

Charge (capture immediately): платіж списується одразу (за замовчуванням).
Authorize only (capture later from the order): кошти лише резервуються. Замовлення отримує Authorized Status; захопіть його через Capture Tap payment або звільніть кошти через Void Tap authorization на вкладці замовлення.

Checkout type: де покупець платить.

Tap payment page (redirect, recommended): покупець платить на захищеній сторінці, яку розміщує Tap (за замовчуванням).
Tap checkout popup on your site: SDK Tap Checkout відкривається на сторінці оплати магазину. Сторінка оплати Tap лишається доступною як запасний варіант. Потрібен публічний ключ поточного режиму.

Tap page language: мова сторінки оплати Tap і спливаючого вікна: English (за замовчуванням) або Arabic.

Сповіщення про оплату (вебхук)

Tap надсилає результат платежу на URL, який показано в Webhook URL у цьому розділі. В OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_tap_payment_gateway/webhook, в OpenCart 4 — https://your-store/index.php?route=extension/wcp_tap_payment_gateway/payment/wcp_tap_payment_gateway.webhook. Він формується з адреси вітрини вашого встановлення OpenCart. URL передається з кожним платежем, тож у панелі Tap нічого налаштовувати не потрібно. Просто переконайтеся, що він доступний з інтернету (не блокується файрволом чи HTTP-автентифікацією); режим технічного обслуговування його не блокує (в OpenCart 4 стартова дія розширення пропускає і вебхук, і повернення покупця). Кожне сповіщення перевіряється за підписом hashstring (HMAC-SHA256 із секретним ключем режиму, у якому було здійснено платіж). Вебхуки без дійсного підпису відхиляються. Навіть підписане сповіщення саме по собі не вважається достовірним: розширення повторно зчитує платіж через API Tap, перш ніж змінити замовлення. Без робочого вебхука замовлення отримує статус лише тоді, коли покупець повертається до магазину після оплати.

Замовлення

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

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

Authorized Status: Authorize only: кошти зарезервовано, але ще не захоплено. За замовчуванням: Очікує.

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

Voided Status: встановлюється після того, як Void Tap authorization звільнив зарезервовані кошти. За замовчуванням: Скасовано.

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

Додатково

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

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

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

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

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

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

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

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Tap Payments). На кроці Confirm Order покупець бачить ваш опис. OpenCart створює замовлення на цьому кроці, ще без статусу. Потім покупець натискає Confirm Order. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способу оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення замовлення.

Tap payment page: розширення створює списання Tap (або авторизацію в режимі Authorize only) на суму замовлення у валюті замовлення з описом Order # і номером замовлення та перенаправляє покупця на сторінку оплати Tap. Ім'я, адреса електронної пошти та телефон покупця передаються до Tap. Там покупець обирає картку, mada, KNET, Benefit, Apple Pay або Google Pay (як увімкнено у вашому обліковому записі Tap) і сплачує. Якщо Tap не може розпочати платіж, покупець лишається на кроці Confirm Order з повідомленням The Tap payment could not be started. Please try again or choose another payment method., а причина записується в журнал.

Tap checkout popup: покупець переходить на сторінку Tap payment розширення, де відкривається форма оплати Tap. Сторінка також показує посилання Pay on the Tap payment page instead. Якщо вікно закрито, кнопка Pay now відкриває його знову. Якщо форму неможливо завантажити, покупцеві пропонується скористатися сторінкою оплати Tap. Перезавантаження сторінки використовує ту саму спробу оплати.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Tap: розширення повторно зчитує платіж через API Tap ключем режиму платежу, перевіряє, що він стосується цього замовлення і був розпочатий його оформленням, та порівнює суму й валюту із замовленням. Самого лише Tap ID в адресі повернення ніколи недостатньо, щоб змінити замовлення. Вебхук виконує ту саму перевірку у фоновому режимі. Потім замовлення отримує статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням залишків, а покупець бачить сторінку успішного оформлення замовлення OpenCart. В OpenCart 4, коли покупець повертається зі сторінки оплати Tap, коротка проміжна сторінка знову відкриває адресу повернення з вашого магазину, тож кошик і вхід покупця зберігаються. Для авторизованого платежу сторінка також показує Your payment has been authorized. We will process the order as soon as the payment is captured. Для платежу на перевірці — Your payment is being reviewed. We will contact you if anything else is needed.

Якщо Tap ще не підтвердив платіж, коли покупець повертається, сторінка Payment confirmation показує We have not received the payment confirmation from Tap yet. If you completed the payment, the order will be updated automatically in a few minutes — there is no need to pay again. з кнопками Check again і Back to checkout. Вебхук встановлює статус замовлення, щойно він надходить.

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

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

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

Інші повідомлення на оформленні замовлення: Tap does not accept payments in і далі валюта, коли валюта замовлення не підтримується, та The order total must be greater than zero to pay with Tap.

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

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

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

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

Paid Order Status (default Processing): Tap підтвердив захоплений платіж. Примітка показує суму, ID списання Tap (chg_...), спосіб оплати та (у тестовому режимі) позначку тестового платежу.

Authorized Status (default Pending): платіж лише авторизовано і він очікує захоплення або анулювання.

On Hold (Review) Status (default Pending): сплачена сума або валюта не збіглися із замовленням (Tap: amount/currency mismatch — manual review required.), або платіж надійшов після скасування замовлення. Примітка пояснює це. Перевірте замовлення та виконайте його або поверніть платіж.

Voided Status (default Canceled): авторизацію анульовано через Void Tap authorization, тож зарезервовані кошти звільнено.

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

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

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

Вкладка VibeFox Tap Payments

У Sales > Orders відкрийте замовлення, оплачене через Tap. Унизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox Tap Payments показує Tap ID, Authorization і Charge, Mode (позначку Test для тестових платежів), Status платежу та спосіб оплати, Charged / refunded, форму повернення, історію повернень, Payment attempts замовлення та Tap notes. Вкладка показується користувачам, які мають доступ до розширення; захоплення, анулювання та повернення потребують права змінювати розширення (налаштовується в System > Users > User Groups).

Захоплення та анулювання

У режимі Authorize only відкрийте авторизоване замовлення. Capture Tap payment (із сумою замовлення на кнопці) захоплює суму замовлення після запитання Capture the reserved funds of this order through Tap?; після цього замовлення отримує Paid Order Status. Void Tap authorization запитує Release the reserved funds? The order will be canceled., звільняє кошти та встановлює Voided Status. Повторний клік на захоплення протягом 2 хвилин блокується. Якщо Tap відхиляє дію, на вкладці показується помилка, і вона додається до приміток. Ці зміни статусу виконуються без повідомлення покупця і без зміни залишків, як ручна зміна статусу. Якщо авторизацію захоплено безпосередньо в панелі Tap, вебхук позначає замовлення оплаченим; повернення для такого платежу потрібно робити в панелі Tap.

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

На вкладці введіть Amount (підставляється сума, яку ще не повернуто), за бажанням Reason (optional), і натисніть Refund via Tap. Підтвердьте запитання Refund this amount through Tap? This cannot be undone. Повні та часткові повернення підтримуються для захоплених списань Tap. Можна повернути до суми та валюти, які Tap фактично списав, навіть якщо замовлення згодом змінювали. Повернення надсилається із секретним ключем режиму, у якому було здійснено платіж, тож цей ключ має бути налаштований. Повернення, прийняте Tap, додається до історії повернень і приміток разом з ID та статусом повернення Tap. Якщо Tap його відхилив, вкладка показує помилку, і жодне повернення не реєструється. Повне повернення встановлює Refunded Status без повідомлення покупця і без повернення товарів на склад; часткове повернення статус не змінює. Для авторизованого замовлення повернення доступні лише після захоплення авторизації. Замовлення на перевірці після розбіжності суми чи валюти повертається в панелі Tap.

Повернення товарів у Sales > Returns не повертають гроші через Tap. Повернення, зроблені в панелі Tap, у OpenCart не відображаються.

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

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

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

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

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

Tap Payments не з'являється на оформленні замовлення: перевірте, що ліцензія активна, що Enable / Disable увімкнено і що для поточного режиму є секретний ключ (а якщо Checkout type — спливаюче вікно, то й публічний ключ). Перевірте, що валюта замовлення входить до списку AED, BHD, EGP, EUR, GBP, JOD, KWD, OMR, QAR, SAR, USD, що платіжна адреса знаходиться в обраній Geo Zone і що замовлення досягає Total, заданого в налаштуваннях. Сторінка налаштувань показує попередження про відсутні ключі та непідтримувану валюту магазину.

Платіж пройшов, але замовлення лишилося без статусу: вебхук не може достукатися до вашого магазину. Перевірте, що URL, показаний у Webhook URL, доступний з інтернету (без файрвола та HTTP-автентифікації), і увімкніть Debug log, щоб бачити відповіді в полі Log. Замовлення також отримає статус, коли покупець повернеться з Tap.

Webhook answers invalid signature: сповіщення не підписано секретним ключем режиму платежу. Перевірте секретні ключі в налаштуваннях.

Webhook answers gateway not configured: секретний ключ режиму платежу (тестового чи бойового) порожній. Введіть його.

Webhook answers verification failed: не вдалося звернутися до API Tap для перевірки платежу. Tap повторить вебхук пізніше.

Webhook answers order not found: сповіщення вказує на замовлення, для якого в цьому магазині немає спроби платежу Tap.

Webhook answers busy, retry later or order could not be updated, retry later: замовлення в цей самий момент підтверджував інший запит, або не вдалося встановити статус замовлення. Tap повторить вебхук. Причину дивіться в полі Log.

Ключ не зберігається: ключ має починатися з префікса свого поля: pk_test_, sk_test_, pk_live_ або sk_live_.

Покупець бачить The Tap payment could not be started: перегляньте поле Log на сторінці розширення. Там записується неправильний ключ або відхилений запит.

Покупець бачить This payment method is not available: сесія оформлення замовлення більше не відповідає замовленню, або спосіб оплати був вимкнений чи втратив ключі. Покупець перезавантажує оформлення замовлення.

Покупець бачить We could not match this payment to an order: платіж не належить до цього замовлення або не був розпочатий його оформленням. Якщо кошти списано, перевірте платіж у панелі Tap.

Замовлення має статус перевірки: прочитайте примітки на вкладці VibeFox Tap Payments. Сплачена сума або валюта не збіглися із замовленням, або платіж надійшов після скасування замовлення.

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

Для розробників: події OpenCart tap_p_charge_payload, tap_p_supported_currencies і tap_p_currency_decimals дозволяють змінити запит оплати, підтримувані валюти та десяткові знаки валют.

Видалення

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

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

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