VibeFox PagSeguro for PrestaShop

Обзор

VibeFox PagSeguro Gateway подключает PrestaShop к PagBank (ранее PagSeguro) через PagBank Checkout API. На этапе оплаты покупатель выбирает PagBank; модуль создаёт платёж в PagBank на точную сумму корзины и перенаправляет покупателя на страницу оплаты PagBank. Там он платит способами, включёнными в вашей учётной записи PagBank, например кредитной картой, PIX или boleto, и возвращается в ваш магазин. Платежи принимаются только в бразильских реалах (BRL). Заказ создаётся только после того, как PagBank подтвердит платёж, поэтому незавершённые платежи не оставляют неоплаченных заказов.

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

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

Размещённая страница PagBank: данные карт не попадают на ваш сервер. Имя, e-mail, бразильский номер телефона и CPF/CNPJ покупателя заполняются на странице PagBank, если они есть у магазина.

Оплата засчитывается только после подтверждения PagBank: уведомления и возврат покупателя проверяются по данным API: модуль читает платёж и заказ в PagBank, включая статус, сумму в сентаво и валюту. Уведомления с неверной подписью отклоняются.

Ничего не нужно настраивать в PagBank: URL для уведомлений передаётся с каждым платежом.

Проверка суммы: платёж, сумма или валюта которого не совпадает с корзиной, переводится в статус PagBank payment on hold с примечанием. Учитываются проценты рассрочки, оплаченные покупателем.

Понятные статусы: оплаченные заказы переходят в Payment accepted; созданные PIX или boleto и платежи на проверке — в Awaiting PagBank payment; платежи, отклонённые позже, — в Payment error, а отменённые — в Canceled.

Без двойной оплаты: повторная оплата использует открытый платёж PagBank или деактивирует предыдущий. Повторные уведомления и возвраты покупателя никогда не создают второй заказ и не регистрируют платёж дважды.

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

Возвраты со страницы заказа: полные и частичные возвраты в блоке PagBank payment, до суммы, которую списала PagBank, и только после подтверждения PagBank. Полный возврат переводит заказ в статус Refunded.

Требования

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