VibeFox Adyen for PrestaShop

Обзор

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

Модуль подходит магазинам, у которых есть учётная запись мерчанта Adyen и которые хотят использовать её способы оплаты без создания платёжной формы на своём сайте. В модуле нет подписок и регулярных платежей, сохранённых карт, полей для карт на сайте (Drop-in или Components) и кнопок списания или отмены в PrestaShop. Списание следует настройкам вашей учётной записи Adyen.

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

Adyen Payment Links: для суммы корзины в валюте корзины создаётся платёжная ссылка в наименьших денежных единицах, которые ожидает Adyen для каждой валюты (без десятичных знаков, например JPY, KRW, IDR; с тремя десятичными знаками, например KWD, BHD).

Оплата отмечается только после подтверждения Adyen: заказ создаётся только по вебхуку AUTHORISATION, подписанному HMAC. Возврат в магазин никогда не создаёт и не оплачивает заказ.

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

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

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

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

Статус заказа на выбор: Payment accepted, Delivered или Adyen payment on hold для ручной проверки после успешной оплаты.

Блок Adyen на странице заказа: референс PSP, платёжная ссылка, учётная запись мерчанта, суммы и история возвратов. Журнал без API-ключей и персональных данных покупателя.

Требования

PrestaShop 8.0–9.x, PHP 8.0 или новее. Учётная запись мерчанта Adyen с API-ключами, Standard webhook с HMAC-ключом и для рабочих платежей — префикс рабочего URL. Лицензионный ключ VibeFox с vibefox.net (один ключ на один домен).