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 расширение добавляет стартовое действие, которое пропускает вебхук и возврат покупателя из 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.