VibeFox Helcim for PrestaShop

Обзор

VibeFox Helcim Gateway добавляет в PrestaShop оплату кредитными картами через Helcim Payment API. Покупатель вводит данные карты на шаге оплаты при оформлении заказа, ваш сервер отправляет их в Helcim, и заказ создаётся по ответу Helcim в том же запросе. Принимаются карты Visa, Mastercard, American Express, Discover и UnionPay в CAD или USD.

Модуль подходит продавцам в Канаде и США с учётной записью Helcim, которым нужна форма ввода карты прямо на странице оформления заказа. Данные карты проходят через ваш веб-сервер, поэтому магазину требуются HTTPS и хостинг, соответствующий стандарту PCI DSS (SAQ D). В модуле нет сохранённых карт, подписок, банковских платежей или ACH, Apple Pay, Google Pay и 3-D Secure, а также нет вебхуков Helcim: списания, возвраты и отмены, выполненные в панели управления Helcim, не отражаются в PrestaShop.

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

Форма карты при оформлении заказа: номер карты, срок действия, CVC и имя держателя карты, проверяемые перед отправкой (контрольная сумма номера карты, срок действия не в прошлом, длина CVC).

Покупка или предварительная авторизация: мгновенное списание средств с карты либо только их удержание с последующим списанием через Capture payment в блоке Helcim на странице заказа.

Заказ создаётся только после одобрения: заказ создаётся только после того, как Helcim одобрит транзакцию. Отклонённая карта не создаёт заказ. Если одобренные сумма или валюта не совпадают с корзиной, заказ переводится в статус Helcim payment on hold с примечанием.

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

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

Рабочие и тестовые токены: раздельные API-токены для вашей рабочей и тестовой учётных записей Helcim. Для списаний и возвратов всегда используется та учётная запись, в которой был оплачен заказ.

Блок Helcim на странице заказа: ID транзакции, тип карты и последние 4 цифры, одобренная сумма, история возвратов и примечания модуля. Журнал ошибок без номеров карт, CVC, токенов и персональных данных.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее. Учётная запись мерчанта Helcim (Канада или США) и API-токен. HTTPS в вашем магазине и хостинг, соответствующий PCI DSS. Лицензионный ключ VibeFox с vibefox.net (один ключ на домен).