Перейти до основного вмісту
Версія: 1.0.0

Shopware

Інструкція з підключення платіжного модуля ProcardPay for Shopware​

Ця інструкція допоможе вам швидко налаштувати платіжний шлюз ProcardPay для вашого інтернет-магазину на базі Shopware.

Системні вимоги та підготовка​

Перед початком інсталяції переконайтеся, що ваша система відповідає мінімальним технічним вимогам:

Компонент / ПакетМінімальна версіяРекомендовано / Протестовано
Shopware6.76.7.10.1
PHP8.28.2 або новіша

Встановлення модуля​

  1. Завантажте архів з плагіном.

  2. Розпакуйте його до каталогу плагінів вашого сайту на Shopware. За замовчуванням шлях виглядає так:
    {ваш_домен}/custom/plugins/ProcardPayPayment/{файли_плагіна}

    ```php
    ProcardPayPayment
    ├── src
    ├── vendor
    ├── CHANGELOG.md
    ├── composer.json
    └── README.md
    ```
  3. Увійдіть в адміністративну панель вашого магазину Shopware (зазвичай ваш_домен/admin).

  4. Перейдіть до розділу Розширення->Мої розширення (Extensions->My extensions).

    shopware

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

    shopware

  6. Встановіть плагін, натиснувши кнопку Встановити (Install), а потім активуйте його, натиснувши кнопку Активувати (Activate).

Налаштування платіжного шлюзу​

Після активації плагіна необхідно його налаштувати:

  1. В адміністративній панелі перейдіть до розділу Налаштування->Плагіни (Settings->Plugins).

  2. Знайдіть ProcardPay Payment у списку встановлених плагінів і натисніть кнопку Конфігурація (Configure) або значок олівця.

  3. Введіть необхідні дані з вашого особистого кабінету ProcardPay:

    • Ідентифікатор продавця (Merchant ID);
    • Секретний ключ (Secret key);
    • Системний URL (ProcardPay API URL).

    shopware shopware

  4. Налаштуйте статуси замовлень/транзакцій. Виберіть статус транзакції, який буде встановлюватись для:

    • успішних оплат (approvedOrderStatus);
    • неуспішних оплат (declinedOrderStatus);
    • повернення коштів (refundedOrderStatus).
  5. Збережіть усі внесені зміни в конфігурації плагіна.

Перевірка працездатності (Тест)​

Після фінального збереження параметрів додайте будь-який товар до кошика та пройдіть повний шлях оформлення замовлення, щоб переконатися, що:

  • Валюта та фінальна сума передаються до шлюзу без помилок.

  • Після успішного відкриття форми оплати користувач може взаємодіяти з інтерфейсом картки.

    shopware

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