VibeFox Culqi for PrestaShop

Обзор

VibeFox Culqi Payment добавляет в PrestaShop Culqi — платёжный сервис Перу. На этапе оплаты покупатель платит картой или через Yape во всплывающем окне Culqi Checkout и не покидает ваш магазин. Данные карты вводятся в окне Culqi и никогда не попадают на ваш сервер. Затем ваш сервер создаёт списание через Culqi Charges API, а заказ создаётся только после подтверждения списания Culqi, поэтому отклонённые или брошенные платежи не создают неоплаченных заказов.

Модуль подходит магазинам в Перу, которые продают в перуанских солях (PEN) или долларах США (USD) и имеют учётную запись Culqi. Модуль принимает только разовые платежи картой и через Yape. В нём нет кодов PagoEfectivo и CIP, банковского приложения, агентов, кошельков и Cuotéalo, нет сохранённых карт, подписок и платежей в рассрочку, нет вебхуков Culqi и нет раздельной авторизации и списания.

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

Всплывающее окно Culqi Checkout: карты (Visa, Mastercard, American Express, Diners Club) и, по желанию, Yape в окне на странице оформления заказа.

3-D Secure: если банк требует проверку, Culqi 3-D Secure открывается автоматически, и списание завершается после аутентификации.

Оплата только после подтверждения Culqi: заказ создаётся, когда Culqi отвечает об успешном списании, а сумма и валюта списания сравниваются с корзиной. При несовпадении заказ переводится в статус Culqi payment on hold с примечанием.

Без двойных списаний: корзина, по которой уже есть заказ или списание Culqi, никогда не списывается повторно — даже после двойного нажатия, второй вкладки или повторной попытки.

Понятные отказы: покупатель видит сообщение от Culqi и может попробовать другую карту. Код отказа записывается в журнал модуля.

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

Возвраты со страницы заказа: полные и частичные возвраты в блоке Culqi payment заказа, не более суммы, фактически списанной Culqi. Полный возврат переводит заказ в статус Refunded.

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

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее. Валюта магазина PEN или USD. Учётная запись Culqi с публичным и секретным API-ключами. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).