VibeFox Pagar.me for OpenCart — Допомога

Вимоги

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

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

Currency: бразильський реал (BRL). У магазині має бути валюта BRL (System > Localisation > Currencies), а спосіб оплати відображається лише тоді, коли покупець оформлює замовлення в BRL і сума замовлення більша за нуль.

Pagar.me account: вам потрібні секретні ключі вашого облікового запису Pagar.me: тестовий ключ (sk_test_...) і, для переходу в робочий режим, робочий ключ (sk_...). Вони містяться в панелі Pagar.me у розділі Development > Keys. Використовуються лише секретні ключі; публічний ключ (pk_...) не потрібен. Пропонувати покупцям можна лише ті способи оплати, які увімкнені у вашому обліковому записі Pagar.me.

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

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

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

OpenCart 3

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

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

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

4. Введіть тестовий секретний ключ і, коли перейдете в робочий режим, робочий секретний ключ.

5. Створіть вебхук у панелі Pagar.me з URL, який показано в налаштуваннях (див. розділ Налаштування).

6. Увімкніть Enable / Disable і натисніть Save. Проводьте тестові платежі з увімкненим Test mode, а потім вимкніть його, щоб приймати реальні платежі.

OpenCart 4

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

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

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

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

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

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

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Payments > VibeFox Pagar.me Gateway > Edit. Розділи перелічено ліворуч; кнопка Save під списком зберігає всю сторінку. Над налаштуваннями сторінка показує поточний режим: TEST MODE (платежі створюються з тестовим секретним ключем, реальних списань немає) або LIVE. Вона попереджає, якщо відсутній секретний ключ поточного режиму (тоді спосіб оплати приховано на етапі оформлення), якщо тестовий ключ не починається з sk_test_, якщо робочий ключ не починається з sk_ або є тестовим, а також якщо валюта магазину за замовчуванням не BRL. Без права змінювати розширення сторінка показує налаштування, але не може їх зберегти.

Під час збереження поле Title не може бути порожнім (до 128 символів), Boleto due in (days) має бути цілим числом від 1 до 30, Sort Order має бути цілим числом (від’ємні числа дозволено), Total має бути числом 0 або більше, а геозона та статуси замовлень мають існувати. Якщо значення неправильне, повідомлення вказує на нього, і нічого не зберігається.

Pagar.me

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

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

Description: текст, який покупець бачить на етапі Confirm Order над кнопкою підтвердження. За замовчуванням: Безпечно оплатіть через Pagar.me (кредитна картка, PIX або boleto). Вас буде перенаправлено для завершення оплати.

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

Geo Zone: пропонувати Pagar.me лише для платіжних адрес у вибраній геозоні. За замовчуванням: All zones. Геозони налаштовуються в System > Localisation > Geo Zones. В OpenCart 4, якщо магазин не вимагає платіжної адреси, використовується адреса доставки.

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

Ключі API

Скопіюйте секретні ключі з панелі Pagar.me (у цьому розділі є посилання на неї): Development > Keys. Pagar.me використовує одну адресу API для тестових і робочих платежів; ключ визначає, чи є платіж тестовим або реальним.

Test mode: використовує тестовий секретний ключ, реальних списань немає. Поки режим увімкнено, покупці на етапі Confirm Order бачать напис TEST MODE — Use test credentials. No real charges.. Перевірка статусу та повернення коштів за замовленням завжди використовують ключ того режиму, у якому було створено його платіж. За замовчуванням: увімкнено.

Test secret key: тестовий секретний ключ Pagar.me (sk_test_...). Використовується, поки увімкнено тестовий режим.

Live secret key: робочий секретний ключ Pagar.me (sk_...). Використовується, коли тестовий режим вимкнено. Зберігайте його в таємниці.

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

Сторінка оплати

Способи, які пропонуються на сторінці оплати Pagar.me, кожен із власним перемикачем. Вибирайте лише ті способи, які увімкнені у вашому обліковому записі Pagar.me. Якщо нічого не вибрано, пропонуються кредитна картка, PIX і boleto. За замовчуванням: кредитна картка, PIX і boleto.

Boleto due in (days): кількість днів до терміну оплати boleto, від 1 до 30. За замовчуванням: 3. Інше значення відхиляється під час збереження з повідомленням Boleto due in (days): enter a number from 1 to 30.

Повідомлення про платежі (вебхук)

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

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

Вебхук не потребує пароля чи підпису. Його вмісту ніколи не довіряють: магазин бере з нього лише ID замовлення Pagar.me і зчитує це замовлення з API Pagar.me, використовуючи ключ того режиму, у якому його створено. Повідомлення щодо замовлень Pagar.me, створених не цим магазином, ігноруються. Без вебхука PIX і boleto, оплачені пізніше, підтверджуються лише тоді, коли покупець повертається в магазин.

Замовлення

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

Order Status After Payment: статус, який встановлюється після перевіреної оплати через Pagar.me. За замовчуванням: В обробці.

Awaiting Pagar.me Payment Status: виставлено код PIX або boleto, або платіж карткою перебуває на перевірці; Pagar.me підтверджує надходження коштів пізніше. За замовчуванням: Очікування.

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

Payment Failed Status: оплата замовлення в очікуванні не вдалася, була скасована або прострочилася. Якщо Pagar.me пізніше повідомить про оплату, замовлення отримає статус після оплати. За замовчуванням: Помилка.

Cancelled Order Status: статус, який ваш магазин використовує для скасованих замовлень. Розширення його не встановлює: платіж Pagar.me, що надійшов після цього, переводить замовлення в статус перевірки. За замовчуванням: Скасовано.

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

Додатково

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

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

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

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

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

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

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

На етапі Payment Method покупець обирає спосіб оплати (за замовчуванням Pagar.me). На етапі Confirm Order покупець бачить ваш опис і примітку You will be redirected to the Pagar.me payment page to pay by credit card, PIX, boleto or debit card. OpenCart створює замовлення на цьому етапі, все ще без статусу. В OpenCart 4 покупець обирає спосіб оплати кнопкою Choose у блоці способів оплати, у вікні Payment method options, і натискає Confirm Order внизу сторінки оформлення. Коли покупець натискає Confirm Order, розширення створює замовлення Pagar.me на суму замовлення в BRL і надсилає покупця на сторінку оплати Pagar.me. Рядки замовлення з податками, доставкою та іншими надбавками передаються як товарні позиції; якщо в замовленні є знижка (купон, ваучер, бонусні бали) або рядки не сходяться із загальною сумою, для всієї суми передається один рядок Order # з номером замовлення. Потрібна дійсна адреса e-mail.

Ім’я та e-mail покупця передаються в Pagar.me. CPF або CNPJ (11 або 14 цифр) береться з власного поля покупця чи платіжної адреси, назва якого містить CPF або CNPJ; в OpenCart такого поля за замовчуванням немає, тож додайте його в Customers > Custom Fields, якщо хочете передавати. В OpenCart 4, якщо магазин не вимагає платіжної адреси, використовуються адреса доставки та її власні поля. Також передається бразильський номер мобільного телефону. Платіжна адреса передається лише для бразильської адреси з 8-значним CEP і штатом. Якщо CPF або CNPJ немає, покупець вводить його на сторінці Pagar.me.

Після оплати покупець повертається до вашого магазину. Замовлення позначається оплаченим лише після підтвердження Pagar.me: магазин зчитує замовлення Pagar.me з API, і сплачена сума та валюта мають збігатися із замовленням. Далі замовлення отримує статус стандартним для OpenCart способом, зі звичайними листами про замовлення та оновленням залишків, а покупець бачить сторінку успішного оформлення замовлення OpenCart. Виставлений, але ще не оплачений PIX або boleto переводить замовлення в статус очікування, і сторінка також показує Your Pagar.me payment is awaiting confirmation (PIX / boleto). The order will be confirmed as soon as Pagar.me reports the payment. Для замовлення в статусі перевірки показується We are confirming your payment with Pagar.me. The order will be updated automatically — please do not pay again. Кожне наступне повернення знову зчитує замовлення Pagar.me, тому PIX або boleto, оплачений за цей час, застосовується, навіть якщо вебхук не надійшов.

Якщо покупець повертається, не оплативши, він потрапляє назад на етап оформлення з повідомленням The Pagar.me payment was not completed. You can try again or choose another payment method. Якщо платіж відхилено або скасовано, повідомлення таке: The Pagar.me payment was declined or canceled. You can try again or choose another payment method. Кошик зберігається. В OpenCart 4 ці повідомлення показуються над сторінкою оформлення. Якщо замовлення вже має статус, а його платіж не вдався або прострочився, повідомлення таке: The Pagar.me payment of your order was declined, canceled or has expired. Please place a new order or contact us. Якщо кошик уже порожній (наприклад, замовлення вже дійшло до сторінки успіху до того, як прострочився його PIX або boleto), на етапі оформлення нічого оплачувати: сторінка Payment confirmation повідомляє The Pagar.me payment of order #N was not completed (declined, canceled or expired), so the order will not be shipped. To buy these items, please place a new order. з кнопкою Continue. Якщо з Pagar.me не вдалося зв’язатися, сторінка Payment confirmation просить покупця не платити повторно і пропонує Check again та Back to checkout.

OpenCart 3 створює нове замовлення щоразу, коли показується етап Confirm Order. OpenCart 4 зберігає одне замовлення для оформлення й оновлює його, тому після незавершеної або відхиленої оплати покупець платить за те саме замовлення знову. Перед новим платежем розширення перевіряє попередні спроби для того самого кошика: якщо одна з них оплачена або її PIX чи boleto очікує оплати, покупець переходить на сторінку успіху без нового платежу. Відкрита сторінка оплати Pagar.me того самого замовлення повторно використовується, якщо сума та режим збігаються; інші відкриті сторінки спершу закриваються в Pagar.me. Якщо друге замовлення Pagar.me з цього кошика все ж буде оплачено, воно не застосовується, а примітка до оплаченого замовлення просить вас повернути дублікат.

OpenCart 4 зберігає замовлення для оформлення, доки не відобразиться сторінка успіху. Якщо за цей час це замовлення було закрито (наприклад, його PIX або boleto прострочився, платіж не вдався або ви скасували чи повернули його), Confirm Order повертає покупця до оформлення з повідомленням Your previous order was cancelled or its payment failed. Please confirm the order again., або, якщо замовлення було оплачено до того, як ви його закрили, з повідомленням This order was closed by the store, so it will not be shipped. Your cart is kept: confirm the order again to pay. Наступне натискання Confirm Order оплачує нове замовлення. Коли покупець повертається з Pagar.me до замовлення, яке було оплачено, а потім закрито вами, він бачить те саме повідомлення на етапі оформлення або, якщо кошик уже порожній, сторінку з Order #(номер) was closed by the store, so it will not be shipped. To buy these items, please place a new order. Якщо замовлення оформлення вже має статус, а в кошику тепер інші товари або кількості, покупця повертають до оформлення, і новий кошик отримує нове замовлення.

Якщо Pagar.me не може розпочати платіж, покупець залишається на етапі Confirm Order з коротким повідомленням, наприклад Could not connect to Pagar.me. Please try again in a moment., або з повідомленням Pagar.me про неправильні платіжні дані. Технічна причина записується в журнал.

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

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

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

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

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

В OpenCart 4 неоплачене замовлення з оформлення може отримати статус Voided, який OpenCart 4 встановлює, коли покупець повертається на етап Confirm Order. Розширення вважає таке замовлення замовленням без статусу, і пізніша оплата все одно його підтверджує.

Order Status After Payment (default Processing): оплату підтверджено. Примітка показує ID замовлення Pagar.me (or_...) та спосіб оплати.

Awaiting Pagar.me Payment Status (default Pending): виставлено PIX або boleto (або платіж карткою перебуває на перевірці), і він очікує оплати. Замовлення переходить у Order Status After Payment, коли Pagar.me підтверджує оплату.

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

Payment Failed Status (default Failed): оплата замовлення в очікуванні чи на утриманні не вдалася, або його замовлення Pagar.me було скасовано чи воно прострочилося (наприклад, неоплачене boleto). Якщо Pagar.me пізніше повідомить про платіж, замовлення все одно перейде в Order Status After Payment.

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

Кожен статус Pagar.me застосовується один раз, тож повторні вебхуки чи повернення покупця не додають приміток і платежів. Примітки — це записи в History замовлення, які покупець не бачить.

Вкладка VibeFox Pagar.me Gateway

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

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

На вкладці VibeFox Pagar.me Gateway введіть Amount (сума, яку ще не повернуто, заповнюється автоматично), за бажанням Reason (optional), і натисніть Refund via Pagar.me. Підтвердіть запитання Refund this amount through Pagar.me? This cannot be undone. Підтримуються повні та часткові повернення платежів карткою та PIX. Вам потрібне право змінювати розширення (встановлюється в System > Users > User Groups). Можна повернути суму не більше тієї, яку Pagar.me фактично списав; тож після розбіжності сум межею є сума, сплачена покупцем, а не загальна сума замовлення. Повернення надсилається з ключем того режиму, у якому було здійснено платіж, тому секретний ключ цього режиму має бути налаштований. Повернення фіксується лише тоді, коли Pagar.me його підтверджує; інакше вкладка показує помилку, наприклад Pagar.me refused the refund: ... або Pagar.me did not confirm the refund, і повернення не фіксується. Успішне повернення додається до історії повернень і приміток разом з ID списання. Повне повернення переводить замовлення в Refunded Status без повідомлення покупця і без повернення товарів на склад, як і ручна зміна статусу. Часткове повернення статус не змінює. Повернення доступні, щойно Pagar.me повідомив про платіж.

Платежі boleto можна повернути лише на банківський рахунок покупця. Поверніть їх у панелі Pagar.me, а потім вручну зафіксуйте повернення в OpenCart. Повернення товарів у Sales > Returns не повертають гроші через Pagar.me.

Повне повернення або скасування, виконане в панелі Pagar.me, надходить через вебхук, переводить замовлення в Refunded Status і додає примітку. Чарджбек додає примітку і переводить оплачене замовлення в статус перевірки.

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

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

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

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

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

Pagar.me does not appear at checkout: перевірте, що ліцензія активна, що Enable / Disable увімкнено, що секретний ключ поточного режиму встановлено (Test secret key у тестовому режимі, Live secret key у робочому режимі) і що покупець оформлює замовлення в BRL. Сторінка налаштувань показує попередження, якщо ключ відсутній. Також перевірте, що платіжна адреса належить до вибраної Geo Zone і що сума замовлення досягає Total, встановленої в налаштуваннях.

The payment went through, but the order stays without a status or in the awaiting status: вебхук не працює. У панелі Pagar.me перевірте, що вебхук існує для облікового запису та режиму, які ви використовуєте, що його URL точно відповідає тому, що показано в Webhook URL, і що вибрано перелічені вище події. Замовлення також перевіряється щоразу, коли покупець повертається в магазин.

The webhook answers verification failed, retry later: магазин не зміг зчитати замовлення Pagar.me з API, наприклад тому що ключ цього режиму відсутній або API не відповіло. Pagar.me повторює вебхук.

The webhook answers busy: кошик у цей самий момент обробляв інший запит, або не вдалося встановити статус замовлення. Pagar.me повторює вебхук. Увімкніть Debug log, щоб побачити причину.

The webhook answers unknown order: замовлення Pagar.me створено не цим магазином, наприклад замовлення іншого магазину на тому самому обліковому записі. Нічого не змінюється.

The webhook answers invalid payload or invalid order id: запит не є повідомленням Pagar.me. Нічого не змінюється.

The customer sees Pagar.me payments are not available right now: секретний ключ неправильний або відсутній. Перевірте ключ поточного режиму.

The customer sees Pagar.me could not start the payment: Pagar.me відхилив платіжні дані, наприклад CPF у власному полі. Повідомлення вказує на проблему; повна причина є в журналі.

The customer sees A valid billing email is required for Pagar.me.: e-mail замовлення недійсний.

The customer sees Pagar.me only supports payments in Brazilian Real (BRL).: оформлення замовлення відбувається в іншій валюті.

The customer sees This order already has a Pagar.me payment that the store has to review: попередній платіж із цього кошика потребує вашої перевірки. Перегляньте панель Pagar.me і журнал.

Order is in the review status after payment: прочитайте примітки на вкладці VibeFox Pagar.me Gateway (див. розділ Статуси замовлень), а потім виконайте замовлення або поверніть кошти.

No refund form in the tab: вкладка пояснює причину: платіж ще не повідомлено, його повністю повернуто, ваша група користувачів не має права змінювати розширення або секретний ключ режиму платежу не встановлено.

Refund fails for a boleto: платежі boleto не можна повернути через API. Поверніть кошти в панелі Pagar.me і зафіксуйте повернення вручну.

Для розробників: перед надсиланням замовлення Pagar.me розширення викликає подію OpenCart wc_pgm_order_data з тілом запиту та замовленням. Сума платежу має залишатися рівною сумі замовлення.

Видалення

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

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

Pagar.me є товарним знаком його власника. Це розширення не пов’язане з Pagar.me і не схвалене компанією Pagar.me.