VibeFox Square for OpenCart

Обзор

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

Расширение подходит продавцам Square, которые хотят принимать оплату картами на собственной странице оформления заказа, в валюте своей локации Square: USD, CAD, AUD, JPY, GBP или EUR. Расширение принимает разовые платежи картами, которые списываются сразу. Оно не поддерживает сохранённые карты, подписки, Apple Pay, Google Pay, Cash App Pay, Afterpay и подарочные карты Square, платежи только с авторизацией и вебхуки Square.

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

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

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

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

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

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

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

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

Условия OpenCart: собственные статусы заказов, гео-зона, минимальная сумма заказа и порядок сортировки.

Требования

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