VibeFox Pagar.me for PrestaShop

Обзор

VibeFox Pagar.me Gateway подключает PrestaShop к Pagar.me (Stone) Core API v5 для магазинов в Бразилии. На этапе оплаты покупатель выбирает Pagar.me, переходит на страницу оплаты Pagar.me и платит кредитной картой, PIX, boleto или дебетовой картой. Данные карты никогда не проходят через ваш магазин. Платежи принимаются только в бразильских реалах (BRL). Заказ создаётся только после того, как Pagar.me подтвердит оплату или выставит PIX или boleto, поэтому брошенные платежи не создают неоплаченных заказов.

Модуль подходит бразильским магазинам, которые хотят предлагать основные местные способы оплаты на одной размещённой странице, с возвратами со страницы заказа в PrestaShop. В модуле нет формы для ввода карты в оформлении заказа, сохранённых карт, подписок и регулярных платежей, правил рассрочки, разделённых платежей, платежей картой с только авторизацией и интеграции с Pagar.me Hub.

Основные возможности

Страница оплаты Pagar.me: кредитная карта, PIX, boleto и дебетовая карта. Вы выбираете, какие способы предлагать и сколько дней действует boleto (от 1 до 30).

Оплата только после подтверждения Pagar.me: вебхук и возврат покупателя лишь сообщают магазину, какой заказ Pagar.me нужно проверить. Затем заказ читается через API Pagar.me с вашим секретным ключом.

Проверка суммы и валюты: сумма оплаченных списаний сравнивается с суммой корзины. Расхождение, неполностью оплаченное boleto или платёж после отмены переводят заказ в статус Pagar.me payment on hold с примечанием.

PIX и boleto: выставленный PIX или boleto создаёт заказ в статусе Awaiting Pagar.me payment, пока Pagar.me не подтвердит оплату. Просроченный платёж переводит заказ в статус Payment error.

Безопасные повторные попытки: когда покупатель платит повторно, открытая страница оплаты используется снова или сначала закрывается в Pagar.me. Оплата по более ранней странице по-прежнему сопоставляется с корзиной, а вторая оплата помечается для возврата.

Возвраты со страницы заказа: полные и частичные возвраты платежей картой и PIX в блоке Pagar.me payment, не более суммы, которую Pagar.me фактически списал. Возвраты и чарджбэки, оформленные в Pagar.me, отображаются в заказе.

Тестовый и боевой режимы: отдельные секретные ключи для тестового и боевого режимов. Проверки статуса и возвраты всегда используют ключ того режима, в котором был создан платёж.

Блок Pagar.me на странице заказа: заказ Pagar.me, способ оплаты, статус, оплаченная и возвращённая суммы, история возвратов и примечания Pagar.me к заказу. Необязательный журнал без ключей и данных покупателя.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее. Валюта магазина — бразильский реал (BRL). Учётная запись Pagar.me с тестовым и боевым секретными ключами и вебхуком. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).