VibeFox Conekta for PrestaShop

Обзор

VibeFox Conekta Gateway добавляет в PrestaShop оплату через Conekta (Мексика). На этапе оплаты покупатель выбирает Conekta, переходит на защищённую платёжную страницу Conekta и платит кредитной или дебетовой картой, наличными в OXXO и других магазинах, банковским переводом SPEI или через BNPL — в зависимости от того, что вы разрешили. Затем покупатель возвращается в ваш магазин. Данные карты никогда не попадают на ваш сайт. Заказ создаётся только после того, как Conekta подтвердит платёж или выдаст референс для OXXO или SPEI, поэтому незавершённые платежи не оставляют неоплаченных заказов.

Модуль подходит мексиканским магазинам, которые продают в MXN или USD и хотят принимать карты и наличные одним способом оплаты через учётную запись Conekta. Модуль поддерживает только разовые платежи. На странице оформления заказа нет формы карты, нет сохранённых карт, подписок, предавторизации и списания, а также помесячной рассрочки (MSI). Возвраты и чарджбэки, оформленные в панели Conekta, отображаются только в примечании к заказу и не регистрируются автоматически.

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

Платёжная страница Conekta: создаётся заказ Conekta на сумму корзины в валюте корзины. Наличные, SPEI и BNPL предлагаются для корзин в MXN; корзины в USD принимают только карты.

Оплата отмечается только после подтверждения Conekta: и вебхук, и возврат покупателя лишь инициируют чтение заказа через API Conekta с вашим приватным ключом. Ничему из уведомления или из URL возврата не доверяется.

Проверка суммы и валюты: сумма в центах и валюта сверяются с корзиной. Любое расхождение, а также платёж в тестовом режиме, полученный, когда магазин работает в рабочем режиме, переводит заказ в статус Conekta payment on hold для проверки.

OXXO и SPEI: когда покупатель получает платёжный референс, заказ создаётся в статусе Awaiting Conekta payment и переходит в Payment accepted, когда Conekta сообщает о платеже.

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

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

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

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

Требования

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