Shopware
Інструкція з підключення платіжного модуля ProcardPay for Shopware
Ця інструкція допоможе вам швидко налаштувати платіжний шлюз ProcardPay для вашого інтернет-магазину на базі Shopware.
Системні вимоги та підготовка
Перед початком інсталяції переконайтеся, що ваша система відповідає мінімальним технічним вимогам:
| Компонент / Пакет | Мінімальна версія | Рекомендовано / Протестовано |
|---|---|---|
| Shopware | 6.7 | 6.7.10.1 |
| PHP | 8.2 | 8.2 або новіша |
Встановлення модуля
Завантажте архів з плагіном.
Розпакуйте його до каталогу плагінів вашого сайту на Shopware. За замовчуванням шлях виглядає так:
{ваш_домен}/custom/plugins/ProcardPayPayment/{файли_плагіна}```php
ProcardPayPayment
├── src
├── vendor
├── CHANGELOG.md
├── composer.json
└── README.md
```Увійдіть в адміністративну панель вашого магазину Shopware (зазвичай
ваш_домен/admin).Перейдіть до розділу Розширення->Мої розширення (Extensions->My extensions).

Знайдіть у списку плагін ProcardPay Payment.

Встановіть плагін, натиснувши кнопку Встановити (Install), а потім активуйте його, натиснувши кнопку Активувати (Activate).
Налаштування платіжного шлюзу
Після активації плагіна необхідно його налаштувати:
В адміністративній панелі перейдіть до розділу Налаштування->Плагіни (Settings->Plugins).
Знайдіть ProcardPay Payment у списку встановлених плагінів і натисніть кнопку Конфігурація (Configure) або значок олівця.
Введіть необхідні дані з вашого особистого кабінету ProcardPay:
- Ідентифікатор продавця (Merchant ID);
- Секретний ключ (Secret key);
- Системний URL (ProcardPay API URL).

Налаштуйте статуси замовлень/транзакцій. Виберіть статус транзакції, який буде встановлюватись для:
- успішних оплат (approvedOrderStatus);
- неуспішних оплат (declinedOrderStatus);
- повернення коштів (refundedOrderStatus).
Збережіть усі внесені зміни в конфігурації плагіна.
Перевірка працездатності (Тест)
Після фінального збереження параметрів додайте будь-який товар до кошика та пройдіть повний шлях оформлення замовлення, щоб переконатися, що:
Валюта та фінальна сума передаються до шлюзу без помилок.
Після успішного відкриття форми оплати користувач може взаємодіяти з інтерфейсом картки.

Модуль повністю готовий до роботи!