VibeFox Square for PrestaShop

Обзор

VibeFox Square Gateway добавляет в PrestaShop оплату банковскими картами (кредитными и дебетовыми) через Square. На шаге оплаты покупатель вводит данные карты в защищённой форме Square, которая отображается под способом оплаты (Square Web Payments SDK). Ваш сервер получает только одноразовый токен и списывает оплату через Square Payments API. Данные карт никогда не попадают в ваш магазин, а заказ создаётся только после подтверждения платежа Square.

Модуль подходит продавцам Square в США, Канаде, Австралии, Японии, Великобритании, Ирландии, Франции и Испании, которые хотят принимать оплату картами на собственной странице оформления заказа. Модуль принимает разовые платежи картами, которые списываются сразу. Он не поддерживает сохранённые карты, подписки, Apple Pay, Google Pay, Cash App Pay, Afterpay и подарочные карты Square, платежи только с авторизацией, а также вебхуки Square.

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

3-D Secure / SCA: проверка покупателя проводится при токенизации карты; в Square передаются сумма корзины, валюта и адрес для выставления счёта.

Оплачено, только когда Square подтверждает: заказ получает статус Payment accepted только при платеже со статусом COMPLETED на сумму корзины, в валюте корзины, с её номером и для той же локации. Любое отклонение переводит заказ в статус Square payment on hold с примечанием.

Без двойных списаний: одна попытка оплаты на корзину одновременно, идемпотентные запросы, а если ответ был потерян, попытка проверяется в Square, а не списывается повторно.

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

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

Блок Square на странице заказа: ID платежа со ссылкой на Square Dashboard, карта, чек, история возвратов и примечания.

Понятные сообщения: покупатели видят короткие сообщения (карта отклонена, неверный CVV, требуется 3-D Secure). Ошибки всегда записываются в журнал, без ключей и данных карт.

Требования

PrestaShop от 8.0 до 9.x, PHP 8.0 или новее. Учётная запись Square с приложением в Square Developer Dashboard (Application ID, Access Token, Location ID). Валюта корзины должна совпадать с валютой вашей локации Square: USD, CAD, AUD, JPY, GBP или EUR. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).