VibeFox PagSeguro for OpenCart

Обзор

VibeFox PagSeguro Gateway подключает OpenCart 3 и OpenCart 4 к Checkout API PagBank (PagSeguro) для магазинов в Бразилии. На последнем шаге оформления заказа покупатель нажимает Confirm Order, переходит на платёжную страницу PagBank и оплачивает способами, включёнными в его учётной записи PagBank, например кредитной картой, PIX или boleto. Оплата принимается только в бразильских реалах (BRL). OpenCart создаёт заказ до оплаты, но заказ получает статус только после того, как PagBank сообщает об оплате, поэтому неоплаченные попытки остаются пропущенными заказами.

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

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

Платёжная страница PagBank: один checkout на сумму заказа в BRL. Платёжная страница истекает через 120 минут.

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

Подписанные уведомления: если PagBank присылает заголовок x-authenticity-token, он проверяется вашим токеном; неверная подпись отклоняется.

Проверка суммы и валюты: списанная сумма (без процентов рассрочки PagBank) и валюта сравниваются с заказом. Расхождение или платёж после отмены переводят заказ в статус проверки с примечанием.

Boleto, PIX и анализ: созданный boleto или PIX, а также платёж на рассмотрении переводят заказ в статус ожидания, пока PagBank не сообщит об оплате.

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

Возвраты со страницы заказа: полные и частичные возвраты во вкладке VibeFox PagSeguro Gateway заказа, в пределах суммы, которую PagBank фактически списал. Возвраты, выполненные в панели PagBank, отображаются в заказе.

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

Требования

OpenCart 3.0.x (проверено на 3.0.5.0) или OpenCart 4.0.2 и новее (проверено на 4.1.0.3), PHP 8.0 или новее. Для загрузки есть один архив с пакетами для обеих версий. Валюта бразильский реал (BRL) в вашем магазине. Учётная запись PagBank с боевым токеном и токеном песочницы для тестов. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).