VibeFox Yoco for OpenCart

Обзор

VibeFox Yoco Pay Gateway добавляет в OpenCart 3 и OpenCart 4 оплату картами и Instant EFT в южноафриканских рандах (ZAR) через Checkout API Yoco. На последнем шаге оформления заказа покупатель нажимает Confirm Order, переходит на страницу оплаты, размещённую Yoco, оплачивает там и возвращается в ваш магазин. Данные карты никогда не попадают на ваш сайт. OpenCart создаёт заказ до оплаты, но заказ получает статус только после того, как Yoco подтвердит платёж, поэтому неоплаченные попытки остаются отсутствующими заказами.

Расширение подходит южноафриканским магазинам, которые продают в ZAR и имеют аккаунт Yoco с онлайн-платежами. Оно принимает только разовые платежи. В нём нет сохранённых карт, подписок, формы карты на сайте магазина, раздельных авторизации и списания; оно работает только в ZAR, с минимальной суммой заказа R2.00.

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

Размещённая у Yoco оплата: для суммы заказа в центах создаётся платёж Yoco. Повторный запрос после двойного щелчка или тайм-аута получает тот же платёж, а не новый.

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

Вебхуки настраиваются автоматически: при сохранении секретного ключа расширение регистрирует URL вебхука в Yoco для этого режима и сохраняет секрет подписи. Вебхуки без действительной подписи отклоняются.

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

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

Возвраты со страницы заказа: полные и частичные возвраты на вкладке VibeFox Yoco Pay Gateway заказа, на сумму, которую списала Yoco, и с ключом того режима, в котором прошёл платёж. Возвраты, оформленные в портале Yoco, записываются автоматически.

Тестовый и рабочий режимы: отдельные секретные ключи и секреты вебхуков для каждого режима. Ключ с неверным префиксом не сохраняется.

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

Требования

OpenCart 3.0.x (проверено на 3.0.5.0) или OpenCart 4.0.2 и новее (проверено на 4.1.0.3), PHP 8.0 или новее. Один архив содержит пакеты для обеих версий. Включённая в магазине южноафриканская валюта рэнд (ZAR). Аккаунт Yoco с онлайн-платежами и его секретные ключи. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).