Інструкція зі встановлення модуля

Завантажити zip-архів з модулем можна за посиланням – https://github.com/NovaPay

Щоб встановити платіжний модуль необхідно виконати такі кроки:

1. Перехід до розділу розширень: В бічному меню OpenCart перейдіть до розділу Extensions (Розширення).

2. Відкриття інсталятора: Оберіть підпункт Installer.

Open

3. Завантаження файлу: На сторінці Extension Installer натисніть кнопку Upload (синя кнопка з іконкою завантаження у верхньому правому куті).

Open

4. Вибір архіву: У вікні, що з’явиться, виберіть zip-архів модуля (наприклад, Opencard v._.n_novapay v.1.0.0.zip).

Open

5. Підтвердження завантаження: Після завершення операції з'явиться зелене повідомлення: “Success: The extension has been uploaded!”.

Open

6. Запуск встановлення: У блоці “Installed Extensions” (Встановлені розширення) знайдіть рядок із NovaPay Payment. Натисніть кнопку Install (зелена іконка з плюсом) у колонці Action.

Open

7. Дочекайтеся завершення прогрес-бару та появи напису “Success: You have modified extensions!”.

Open

Інтеграція модуля оплати NovaPay

Платіжний модуль NovaPay Payment для CMS OpenCart забезпечує прийом карткових платежів через інтернет-еквайринг NovaPay з підтримкою сценаріїв Hold/Direct, автоматичною синхронізацією статусів замовлень та обробкою postback-повідомлень.

Основні можливості

• Прийом платежів через NovaPay Acquiring;

• Redirect користувача на платіжну сторінку NovaPay;

• Обробка postback;

• Автоматичне створення та оновлення статусів замовлень;

• Скасування/повернення платежів (Void);

• Підтримка сценарію утримання коштів (Hold)/пряме списання (Direct)

• Логування API-запитів.

Налаштування модуля

Щоб змінити налаштування платіжного модулю необхідно виконати такі кроки:

1. Перехід до розділу розширень: В бічному меню OpenCart перейдіть до розділу Extensions (Розширення).

2. Відкриття інсталятора: Оберіть підпункт Installer.

Open

3. Вибір типу розширення: На сторінці Extensions натисніть на поле під заголовком Choose the extension type.

4. Встановіть тип Payments.

Open

5. Перехід до редагування: У блоці Payments знайдіть рядок із Оплата через НоваПей. Натисніть кнопку Edit (синя іконка з олівцем) у колонці Action.

Open

Основні параметри | General configuration

Параметри	Опис

Параметри	Опис
Exstension configuration
Status	Увімкнення або вимкнення плагіна. Якщо встановлено Enable – ввімкнено продуктовий режим
Checkout sort order	Впливає на порядок відображення методів оплати, якщо у клієнта встановлено кілька варіантів
Test/debug configuration
Test Mode	Активує тестовий режим, де будуть створюватись транзакції за тестовими даними. Для прийняття платежів в проді режим повинен бути вимкнений
Log requests/responses (system/storage/logs/novapay_payment.log)	Визначає, чи будуть запити та відповіді до НоваПей зберігатися у вигляді лог-файлів. Рекомендується вмикати у випадках, коли необхідно проаналізувати або діагностувати обробку операції
Merchant configuration
Merchant ID	Ідентифікатор мерчанта NovaPay. Клієнт має ввести значення, отримане після активації в NovaPay. Цей ID є обов’язковим для виконання операцій у продакшн-режимі
Public key	Ключі, які необхідні для підпису запиту з метою безпеки
Private key
Merchant configuration
Hold	Увімкнення або вимкнення холдування коштів
Success URL	Посилання, на яке клієнт може перейти після успішної оплати, натиснувши відповідну кнопку на платіжній сторінці
Failed URL	Посилання, на яке клієнт може перейти після неуспішної оплати, натиснувши відповідну кнопку на платіжній сторінці

Після заповнення всіх полів натисніть Save.

Open

Статуси

У налаштуваннях модуля у вкладці Order status потрібно задати власні статуси замовлень:

Параметр	Стан замовлення	Можливі статуси

Параметр	Стан замовлення	Можливі статуси
Payment Create	При створенні платежу	Canceled Canceled Reversal Chargeback Complete Denied Expired Failed Pending Processed Processing Refunded Reversed Shipped Voided
Payment Expired	Після закінчення терміну платежу
Payment Processing	При обробці платежу
Payment Holded	При утриманні платежу
Payment Paid	При успішній оплаті
Payment Failed	При невдалій оплаті
Payment Voided	При анулюванні платежу

Після зміни налаштувань статусів натисніть Save.

Open

Синхронізація статусів

1. Після оплати, холду або зміни статусу NovaPay надсилає відповідь (postback) до адмін-панелі Opencart.

2. Статус замовлення в адмін-панелі Opencart оновлюється відповідно до стану платежу в NovaPay.

3. Усі зміни відображаються в історії замовлень.

4. Якщо статус змінюється в адмін-панелі Opencart, платіжний модуль NovaPay виконує відповідну операцію в системі еквайрингу.

Open

 

Флоу оплати користувачем на сторінці Checkout

1. Клієнт додає товари у кошик та переходить до сторінки Checkout.

Open

2. На екрані Checkout користувач вводить контактну та платіжну інформацію (ім’я, адресу, телефон, поштовий індекс).

Open

3. Модуль додає NovaPay до доступних методів оплати.

Open

4. Після підтвердження замовлення клієнт перенаправляється на сторінку NovaPay, де виконується оплата.

Open

5. Транзакція обробляється на стороні еквайрингу NovaPay. Після завершення NovaPay надсилає postback до адмін-панелі Opencart, і статус замовлення оновлюється автоматично.

Процес роботи зовнішнього еквайрингу та платіжного модуля NovaPay

Нижче описано послідовність взаємодії між клієнтом, модулем, та системою NovaPay під час створення і виконання платіжної сесії.

1. Клієнт відправляє запит. Клієнт формує запит до NovaPay, передаючи тіло запиту (body) та згенерований підпис.

2. Пошук мерчанта. На стороні NovaPay за параметром merchant_id визначається мерчант, який ініціював запит.

3. Отримання публічного ключа. У профілі мерчанта зберігається публічний ключ, який був переданий ним під час створення. Цей ключ використовується для перевірки підписів запитів.

4. Перевірка підпису. NovaPay за допомогою публічного ключа перевіряє, чи відповідає накладений підпис тілу запиту (body).

5. Створення платіжної сесії. Якщо запит успішно пройшов перевірку – створюється нова платіжна сесія.

6. Повернення ID сесії. У відповіді NovaPay повертає ID створеної сесії, який використовується для подальших дій.

7. Запит Payment від клієнта. Клієнт надсилає до NovaPay запит Payment, який ініціює створення нової операції.

8. Створення операцій у NovaPay. На стороні NovaPay кожен Payment створює окрему сутність операції.
   Наприклад:

• клієнт додає кілька товарів у кошик;

• кожен товар – це окремий Payment;

• для кожного Payment створюється окрема транзакція, але списання відбувається одним платежем у рамках однієї платіжної сесії.

Усі запити клієнта підписуються та перевіряються через публічний ключ мерчанта.

9. Відповідь на Payment. NovaPay повертає у відповіді: ID операції, посилання для відкриття фрейму оплати.

10. Redirect після останнього Payment. Після створення останнього платежу клієнт виконує redirect на отримане посилання платіжної сторінки.

11. Відкриття платіжної сторінки. Відкривається платіжна сторінка NovaPay, де користувач може ввести платіжні дані.

12. Введення даних карти. Клієнт вводить дані картки або обирає оплату через Apple Pay / Google Pay, після чого натискає кнопку “Сплатити”.

13. Обробка запиту на бекенді NovaPay. Фронтенд передає дані картки на бекенд NovaPay. Після цього сесія переходить у статус paid.

14. Оновлення операцій Payment. У всіх створених операціях оновлюється статус на paid.

15. Надсилання postback до адмін-панелі Opencart. NovaPay надсилає postback-запит із новим статусом платежу (paid). Адмін-панель Opencart отримує оновлення і змінює статус замовлення у системі мерчанта.