VibeFox Kushki for OpenCart

Обзор

VibeFox Kushki Payment добавляет в OpenCart 3 и OpenCart 4 оплату картами через Kushki для магазинов в Эквадоре и Колумбии. На шаге Confirm Order покупатель вводит данные карты в форме Kushki для размещения карт: форма выводится на странице оформления заказа, но предоставляется Kushki. Форма возвращает одноразовый токен, а ваш магазин списывает его на сервере через API Kushki. Номера карт никогда не попадают на ваш сайт. OpenCart создаёт заказ до оплаты, но заказ получает статус только после того, как Kushki одобрит списание, поэтому отклонённые или брошенные платежи остаются заказами без статуса (missing orders).

Расширение подходит магазинам, которые принимают платежи в USD или COP и хотят видеть форму карты на собственной странице оформления заказа, не работая с данными карт. Расширение поддерживает только одноэтапные платежи. Оно не поддерживает частичные возвраты, сохранённые карты, подписки, оплату наличными или банковским переводом (PSE), платежи дебетовыми картами с перенаправлением, а также раздельные авторизацию и списание.

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

Форма карты Kushki для размещения: форма карты Kushki на шаге Confirm Order оформления заказа в OpenCart. Платёж отправляется, как только покупатель нажимает кнопку оплаты внутри формы. Рассрочка (diferido), выбранная в форме, передаётся в списание.

Оплачено только после подтверждения Kushki: статус заказа устанавливается только после того, как Kushki одобряет списание и присваивает номер тикета. Если Kushki сообщает другую сумму или валюту, заказ переводится в статус проверки с примечанием. После этого OpenCart отправляет обычные письма о заказе.

Налог как IVA: сумма и валюта берутся из заказа. Налог на заказ передаётся в Kushki как IVA, позиции без налога — отдельно.

Подписанные вебхуки: необязательные вебхуки подтверждают платёж, ответ API по которому был потерян, и добавляют примечания об отменах (voids) и возвратах, выполненных в Kushki Console. Уведомления без действительной подписи отклоняются.

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

Тестовый и рабочий режимы: отдельные Merchant ID и подписи вебхуков для каждого режима. Возвраты всегда выполняются в том режиме, в котором был совершён платёж.

Полные возвраты со страницы заказа: вкладка VibeFox Kushki Payment заказа возвращает всю сумму, списанную Kushki, и показывает номер тикета, референс, историю возвратов и примечания Kushki.

Собственные статусы заказов и условия OpenCart: выберите статус OpenCart для оплаченного заказа, платежа на проверке, неуспешного платежа, отменённого и возвращённого заказа. Географическая зона, минимальная сумма заказа и порядок сортировки. Журнал без Merchant ID, токенов карт и адресов электронной почты покупателей.

Требования

OpenCart 3.0.x (проверено на 3.0.5.0) или OpenCart 4.0.2 и новее (проверено на 4.1.0.3), PHP 8.0 или новее. Один архив содержит пакеты для обеих версий. Валюта заказа USD или COP. Аккаунт Kushki с публичным и приватным Merchant ID для тестового и рабочего режимов; HTTPS для реальных платежей. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).