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

Вимоги

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

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

Валюта магазину: валюта країни вашого облікового запису MercadoPago має бути увімкнена в магазині: ARS (Аргентина), BRL (Бразилія), CLP (Чилі), COP (Колумбія), MXN (Мексика), PEN (Перу) або UYU (Уругвай). MercadoPago списує кошти у валюті облікового запису і не конвертує їх, тому спосіб оплати показується лише покупцям, які платять у цій валюті.

Обліковий запис MercadoPago: потрібен застосунок у панелі розробника MercadoPago (Your integrations > your application > Credentials) з тестовими обліковими даними (починаються з TEST-) і робочими обліковими даними (починаються з APP_USR-): Public Key та Access Token для кожного з них. Для необов'язкової перевірки підпису сповіщень також потрібен секретний підпис із розділу your application > Webhooks.

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

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

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

OpenCart 3

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

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

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

4. Виберіть Account country, введіть тестові та робочі облікові дані і за бажанням налаштуйте сповіщення в застосунку MercadoPago (див. Налаштування). Перевірте, чи увімкнено валюту облікового запису в System > Localisation > Currencies.

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

OpenCart 4

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

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

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

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

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

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

Усі налаштування розташовано на сторінці розширення: Extensions > Extensions > Payments > VibeFox MercadoPago Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує Test mode is on: the TEST- credentials are used and no real money is charged., доки ввімкнено тестовий режим. Вона попереджає, коли відсутній Public Key або Access Token поточного режиму (тоді спосіб оплати приховано на етапі оформлення замовлення), коли валюта магазину за замовчуванням не збігається з валютою вашого облікового запису MercadoPago (тоді спосіб оплати показується лише покупцям, які платять у валюті облікового запису, або приховується, якщо в магазині немає такої увімкненої валюти), і коли облікові дані належать обліковому запису в іншій країні, ніж Account country. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Якщо ви зберігаєте сторінку з порожнім полем Title (або довшим за 128 символів), нічого не зберігається, і сторінка показує Enter a title for the payment method (1 to 128 characters). Будь-яке інше неправильне значення не зберігається і зберігає попереднє значення, з помилкою, яка називає поле і закінчується словами — the previous value was kept. Це стосується облікових даних без очікуваного префікса (TEST- для тестових полів, APP_USR- для робочих полів), значення Maximum installments поза межами 1–24, Sort Order, яке не є цілим числом (Sort Order must be a whole number), Total, яке не є числом не меншим за 0, а також географічної зони або статусу замовлення, яких не існує. Після збереження розширення запитує в MercadoPago, до якої країни належить кожен access token. Якщо токен поточного режиму не можна перевірити, якщо обліковий запис не в підтримуваній країні або якщо країна відрізняється від Account country, з'являється попередження. Тоді розширення використовує країну облікового запису.

MercadoPago

Enable / Disable: Enable MercadoPago card payments вмикає або вимикає спосіб оплати. Спосіб оплати показується на етапі оформлення замовлення лише тоді, коли облікові дані активного режиму заповнені і покупець платить у валюті облікового запису MercadoPago. За замовчуванням: вимкнено.

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

Description: текст, який показується над полями картки на кроці Confirm Order. За замовчуванням: Pay securely with your credit or debit card. Card data is sent directly to MercadoPago.

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

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

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

Обліковий запис MercadoPago

Отримайте облікові дані свого застосунку в панелі розробника MercadoPago: Your integrations > your application > Credentials (на сторінці є посилання туди). Тестові облікові дані починаються з TEST-, робочі — з APP_USR-.

Account country: країна вашого облікового запису MercadoPago. Від неї залежать валюта списання, мова полів картки і те, чи запитується документ власника картки. Покупець має платити в тій самій валюті, наприклад ARS для Аргентини. Під час збереження облікових даних країна звіряється з обліковим записом. За замовчуванням: Argentina (ARS).

Test mode: у тестовому режимі використовуються облікові дані TEST-, і ви платите тестовими картками MercadoPago; на етапі оформлення замовлення показується позначка TEST MODE з текстом Use MercadoPago test cards. No real charges. Вимкніть режим, щоб списувати кошти з реальних карток робочими обліковими даними. Повернення коштів і сповіщення завжди використовують облікові дані того режиму, у якому було здійснено оплату. За замовчуванням: увімкнено.

Test Public Key: починається з TEST-. Використовується в браузері для токенізації картки.

Test Access Token: починається з TEST-. Використовується лише на сервері. Тримайте в таємниці.

Production Public Key: починається з APP_USR-.

Production Access Token: починається з APP_USR-. Використовується лише на сервері. Тримайте в таємниці.

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

Параметри оплати

Maximum installments: найбільша кількість частин (cuotas або parcelas), яку може вибрати покупець, від 1 до 24. 1 = лише одноразова оплата. Обмеження також перевіряється на сервері. За замовчуванням: 1.

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

Оплата карткою зазвичай одразу отримує остаточну відповідь. Платежі, які MercadoPago утримує на перевірці (в обробці або очікуванні), завершуються сповіщеннями від MercadoPago. Розширення передає URL сповіщення з кожним платежем, якщо ваш магазин має публічну адресу (не localhost і не домен .local або .test). Його також можна додати в your application > Webhooks для події Payments. URL показано в полі Notification URL у цьому розділі. На OpenCart 3 він має вигляд https://your-store/index.php?route=extension/payment/wcp_mercadopago_gateway/webhook&source_news=webhooks, на OpenCart 4 — https://your-store/index.php?route=extension/wcp_mercadopago_gateway/payment/wcp_mercadopago_gateway.webhook&source_news=webhooks. Він формується з адреси вітрини вашої інсталяції OpenCart. Скопіюйте URL точно так, як його показують налаштування.

Сповіщенню ніколи не довіряють без перевірки. Розширення повторно запитує платіж через API MercadoPago з access token того середовища, в якому було здійснено оплату, і прив'язує його до спроби оплати вашого магазину. Без сповіщень замовлення на перевірці залишаються в Awaiting MercadoPago Status, доки ви не оновите їх вручну.

Розширення обробляє такі статуси платежів MercadoPago:

Webhook secret signature: необов'язково. Секретний підпис, показаний у your application > Webhooks. Якщо його задано, сповіщення без коректної x-signature відхиляються (HTTP 401).

Замовлення

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

Order Status After Payment: MercadoPago схвалив платіж, і його сума та валюта збігаються із замовленням. За замовчуванням: Обробляється.

Awaiting MercadoPago Status: платіж на перевірці в MercadoPago (в обробці або очікуванні); сповіщення завершує замовлення. За замовчуванням: Очікує оплати.

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

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

Cancelled Status: замовлення в цьому статусі (або в статусі повернення) закрите: пізнє схвалення MercadoPago лише додає примітку. За замовчуванням: Скасовано.

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

Додатково

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

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

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

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

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

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

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

На кроці Payment Method покупець обирає спосіб оплати (за замовчуванням Credit or debit card (MercadoPago)). OpenCart створює замовлення на кроці Confirm Order, все ще без статусу. Там покупець бачить ваш опис і заповнює поля картки: Card number, Expiry (MM/YY), Security code та Cardholder name. Залежно від країни та картки покупець також обирає Document type і вводить Document number, вибирає Card issuer і кількість Installments. Варіанти розстрочки та відсотки надає MercadoPago для суми замовлення.

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

Коли покупець натискає Confirm Order, MercadoPago перетворює картку на одноразовий токен, а ваш магазин створює платіж на сервері на суму замовлення у валюті замовлення. E-mail і ім'я покупця, а також документ передаються до MercadoPago; платіж відображається як Order #, номер замовлення і назва вашого магазину. Суми в CLP і COP списуються без десяткових знаків.

Схвалений платіж встановлює статус замовлення стандартним способом OpenCart, зі звичайними листами про замовлення та оновленням запасів; кошик очищується, і покупець бачить сторінку успішного оформлення замовлення OpenCart. Платіж на перевірці встановлює Awaiting MercadoPago Status, а сторінка також показує MercadoPago is reviewing your payment. Your order will be updated automatically as soon as MercadoPago confirms it. Замовлення в статусі перевірки показує Your payment is being reviewed. We will update your order as soon as the review is complete.

Відхилена картка залишає замовлення без статусу. Покупець залишається на кроці Confirm Order з коротким поясненням, наприклад Your card has insufficient funds. Please use another card or payment method. або Please check the security code of your card. Покупець може виправити дані або скористатися іншою карткою; для кожної спроби створюється новий токен картки. Якщо даних картки бракує, з'являється Please fill in all card fields.

Якщо MercadoPago не відповідає, покупець бачить We could not confirm your payment with MercadoPago. Please wait a minute before trying again — if the payment went through, your order will be updated automatically. Наступна спроба спочатку перевіряє платіж, щоб картку не списали двічі. Другий клік, поки кошик оплачується, показує This order is already being paid. Please wait a moment and check your e-mail before trying again. OpenCart 3 створює нове замовлення щоразу, коли показується крок Confirm Order, OpenCart 4 зберігає одне замовлення для оформлення, і після відхиленої картки покупець оплачує те саме замовлення. В будь-якому разі кошик із оплаченим або очікуваним замовленням ніколи не списується повторно; покупця переспрямовують на сторінку успіху.

На OpenCart 4 замовлення зберігається в оформленні, доки не буде показано сторінку успіху. Якщо замовлення тим часом закрили без оплати (наприклад, ви його скасували), із замовлення не списують кошти, а покупець бачить Your previous order was cancelled without a payment. Please reload the checkout page and confirm the order again — the payment will be made with a new order. Якщо це замовлення вже розміщено, а кошик відтоді змінився, повідомлення таке: Your previous order has already been placed. Your cart has changed since — please reload the checkout page and confirm the order again to pay for the current cart with a new order. Зміна кошика, зокрема нова кількість, вважається новим кошиком, який потребує власної оплати.

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

Розширення приймає лише кредитні та дебетові картки. У ньому немає переходу на Checkout Pro, гаманця MercadoPago чи оплати з рахунку, готівкових платежів (Rapipago, OXXO, boleto та інших), Pix, PSE або Yape, збережених карток чи підписок, окремої авторизації та списання, перевірки 3-D Secure і конвертації валюти.

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

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

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

Order Status After Payment (за замовчуванням Обробляється): MercadoPago схвалив платіж, а сума і валюта збігаються із замовленням. Примітка показує ID платежу, середовище і кількість частин.

Awaiting MercadoPago Status (за замовчуванням Очікує оплати): платіж на перевірці (в обробці або очікуванні) і чекає на сповіщення MercadoPago. Замовлення переходить до Order Status After Payment, коли MercadoPago його схвалює.

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

Payment Failed Status (за замовчуванням Невдалий): платіж на перевірці відхилено або скасовано. Примітка показує статус і його деталі.

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

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

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

Вкладка VibeFox MercadoPago Gateway

У Sales > Orders відкрийте замовлення, оплачене через MercadoPago. Внизу сторінки замовлення, поруч із History і Additional, вкладка VibeFox MercadoPago Gateway показує Payment ID, Status платежу, Environment (позначку Test для тестових платежів), Installments, суми Charged / order, суму Refunded, форму повернення, історію повернень і MercadoPago notes замовлення. Вкладка показується користувачам, які мають доступ до розширення.

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

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

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

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

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

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

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

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

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

MercadoPago не з'являється на етапі оформлення замовлення: перевірте, чи ліцензія активна, чи увімкнено Enable / Disable і чи має поточний режим обидва облікові дані з правильним префіксом: ключі TEST- у тестовому режимі, ключі APP_USR- у робочому. Перевірте, чи покупець платить у валюті вашого облікового запису MercadoPago (валюта має бути увімкнена в магазині), чи адреса оплати входить до вибраної Geo Zone і чи замовлення досягає Total, заданого в налаштуваннях. Сторінка налаштувань показує, чого бракує.

Платіж пройшов, але замовлення залишається в Awaiting MercadoPago Status: сповіщення не надійшло. Розширення надсилає URL сповіщення лише тоді, коли ваш магазин має публічну адресу (не localhost і не домен .local або .test). Додайте URL з Notification URL у your application > Webhooks з подією Payments. Якщо задано Webhook secret signature, перевірте, що це секрет того самого застосунку. Панель MercadoPago показує відповідь вашого магазину на кожне сповіщення.

Сповіщення відповідає invalid signature: секретний підпис належить іншому застосунку, або в сповіщенні немає коректної x-signature. Скопіюйте секрет ще раз або залиште поле порожнім.

Сповіщення відповідає no credentials for test або no credentials for live: access token середовища, у якому було здійснено платіж, не задано. Введіть його; MercadoPago повторить сповіщення.

Сповіщення відповідає not for this store: платіж не належить до спроби оплати цього магазину. Жодне замовлення не змінюється.

Сповіщення відповідає order busy або payment could not be read: замовлення в цей момент оновлював інший запит, або MercadoPago був недоступний. MercadoPago автоматично повторить сповіщення.

Облікові дані не зберігаються: помилка must start with означає, що значення має неправильний префікс для цього поля. Тестові поля приймають облікові дані TEST-, робочі — APP_USR-.

Покупець бачить «This payment method is not configured correctly. Please choose another payment method or contact the store.»: облікові дані поточного режиму відсутні, мають неправильний префікс або були відхилені MercadoPago. Перевірте їх на сторінці налаштувань.

Покупець бачить «MercadoPago cannot process payments in»: валюта замовлення не збігається з валютою вашого облікового запису MercadoPago. MercadoPago не конвертує валюти.

Захищена форма картки не завантажується: покупець бачить The secure card form could not be loaded. Please reload the page or choose another payment method. Перевірте Public Key поточного режиму.

Покупець бачить «Your session has expired. Please reload the page and try again.»: форма картки більше не належить сеансу оформлення замовлення покупця. Покупець перезавантажує сторінку оформлення.

Покупець бачить «Your payment was received, but the order could not be completed automatically»: MercadoPago прийняв платіж, але OpenCart не зміг встановити статус замовлення. Перегляньте поле Log на сторінці розширення: помилки завжди записуються. Покупцеві пропонується не платити знову; наступна спроба оплати або наступне сповіщення для кошика встановлює статус без нового списання.

Замовлення після оплати в статусі перевірки: прочитайте MercadoPago notes на вкладці замовлення (див. Статуси замовлень), потім виконайте замовлення або поверніть платіж.

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

Повернення не виконується з повідомленням MercadoPago did not answer the refund request: перевірте платіж у панелі MercadoPago перед повторною спробою.

Видалення

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

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

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