BankApp Payment Suite — оплата за реквізитами з QR для OpenCart

BankApp Payment Suite — повна оплата, передоплата та оплата залишку за реквізитами з QR для OpenCart

BankApp Payment Suite — комплект платіжних модулів для OpenCart та ocStore, який дозволяє приймати оплату банківським переказом за реквізитами: повну суму замовлення, фіксовану або відсоткову передоплату, а також залишок після передоплати.

Після оформлення замовлення покупець бачить готові реквізити, суму та призначення платежу, може скопіювати дані, відкрити платіж у банківському застосунку за посиланням або відсканувати QR-код. Модуль також формує PDF-інвойси, додає посилання на рахунки до замовлення та дозволяє адміністратору надсилати їх клієнту електронною поштою.

Що входить до комплекту

• Повна оплата за реквізитами з QR — окремий спосіб оплати всієї суми замовлення
• Передоплата за реквізитами з QR — окремий спосіб оплати фіксованої суми або відсотка від замовлення
• Оплата залишку — окремий PDF-рахунок і шаблон листа для остаточного розрахунку після передоплати
• mPDF Runtime — окремий архів бібліотеки для формування PDF, який установлюється один раз і не дублюється в оновленнях платіжного модуля

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

• Два незалежні способи оплати з окремими налаштуваннями
• Повна оплата замовлення банківським переказом
• Передоплата фіксованою сумою
• Передоплата у відсотках від суми замовлення
• Автоматичний розрахунок суми передоплати та залишку
• QR-код із реквізитами, сумою та призначенням платежу
• Універсальне посилання для відкриття платежу в банківському застосунку
• Адаптивний блок оплати на сторінці успішного оформлення замовлення
• Копіювання окремих реквізитів або всіх платіжних даних
• Генерація PDF-інвойсів через mPDF
• Окремі шаблони рахунків для повної оплати, передоплати та залишку
• QR-код безпосередньо у PDF-інвойсі
• Посилання на інвойси в адміністративній частині та особистому кабінеті покупця
• Надсилання PDF-інвойсу клієнту з адміністративної частини
• Підписані посилання на PDF, доступні клієнту без авторизації
• Редаговані HTML-шаблони PDF та листів через Summernote
• Мультимовні призначення платежу, примітки, інвойси та листи
• Локалізація українською, російською та англійською мовами

Повна оплата замовлення

Спосіб Повна оплата за реквізитами з QR виставляє до оплати всю суму замовлення. Після підтвердження замовлення покупець отримує:

• назву отримувача платежу
• ІПН або ЄДРПОУ
• рахунок IBAN
• суму до сплати
• призначення платежу з номером замовлення
• QR-код та кнопку відкриття платежу
• посилання для завантаження PDF-інвойсу

Передоплата фіксованою сумою або у відсотках

Модуль передоплати дозволяє вибрати один із двох способів розрахунку:

• Фіксована сума — наприклад, 500 грн незалежно від загальної вартості замовлення
• Відсоток від замовлення — наприклад, 10%, 20% або 50% від повної суми

Якщо фіксована передоплата перевищує суму замовлення, до сплати буде виставлено не більше повної суми замовлення. На сторінці успішного замовлення та в інвойсі відображаються повна сума, передоплата і залишок.

Рахунок на оплату залишку

Якщо після передоплати клієнт вирішив сплатити решту суми, адміністратор може сформувати окремий рахунок на оплату залишку.

• Окреме призначення платежу для залишку
• Окремий HTML-шаблон PDF
• Окрема тема та HTML-шаблон листа
• QR-код із правильною сумою залишку
• Відображення повної суми, передоплати та залишку до сплати

Блок оплати на сторінці успішного замовлення

Платіжний блок виводиться тільки для того способу оплати, який покупець вибрав під час оформлення замовлення. Для інших способів оплати реквізити та QR-код не показуються.

Блок адаптований для комп’ютерів і мобільних пристроїв та містить:

• суму до сплати
• усі банківські реквізити
• кнопки копіювання
• QR-код, вирівняний по центру
• кнопку відкриття платежу в банківському застосунку
• посилання на PDF-інвойс
• додаткову примітку для покупця
• телефони та email для зв’язку

QR-код та банківські застосунки

Модуль формує платіжний QR-код із даними отримувача, IBAN, сумою та призначенням платежу. Покупець може відсканувати його безпосередньо з банківського застосунку на мобільному пристрої чи комп’ютері.

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

PDF-інвойси

PDF формується бібліотекою mPDF на основі HTML-шаблону, заданого в налаштуваннях модуля.

• Окремі шаблони для повної оплати, передоплати та залишку
• Редагування через вбудований редактор Summernote
• Підстановка даних магазину, замовлення, покупця, оплати та доставки
• Додавання логотипа магазину
• Додавання контактних телефонів та email
• Додавання QR-коду з відповідною сумою платежу
• Коректне відображення кирилиці
• Готовий PDF для завантаження, друку або надсилання клієнту

Інвойси в адміністративній частині

На сторінці перегляду замовлення адміністратор бачить доступні типи рахунків, якщо відповідний модуль увімкнений:

• рахунок повної оплати
• рахунок передоплати
• рахунок на оплату залишку

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

Надсилання інвойсу клієнту

Адміністратор може надіслати потрібний рахунок прямо зі сторінки замовлення.

• Вибір типу інвойсу перед надсиланням
• Email покупця автоматично підставляється із замовлення
• Адресу можна змінити перед надсиланням
• Підтримуються замовлення зареєстрованих покупців і гостей
• PDF додається до листа вкладенням
• До листа можна додати підписане посилання на інвойс

Інвойси в особистому кабінеті

Зареєстрований покупець може відкрити PDF-інвойс зі сторінки інформації про своє замовлення. Для замовлення з передоплатою додатково доступний рахунок на оплату залишку.

Шаблони листів

Для кожної мови магазину можна окремо налаштувати тему та HTML-вміст листа. Модуль підтримує різні шаблони для:

• повної оплати
• передоплати
• оплати залишку

У лист можна додати дані замовлення, покупця, магазину, платіжні реквізити, суму, контактні дані та кнопку переходу до PDF-інвойсу.

Змінні для шаблонів

У налаштуваннях під редакторами відображається список доступних змінних. Натискання на змінну копіює її в буфер обміну.

Мультимовність

Для кожної встановленої мови магазину можна окремо налаштувати:

• призначення платежу
• примітку на сторінці успішного замовлення
• HTML-шаблон PDF-інвойсу
• тему листа
• HTML-шаблон листа
• призначення платежу, PDF та лист для оплати залишку

Інтерфейс і стандартні тексти модуля локалізовано українською, російською та англійською мовами.

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

Налаштування розділені на зручні вкладки:

• Основні налаштування — отримувач, ІПН/ЄДРПОУ, IBAN, контакти, призначення платежу, статус, геозона та порядок сортування
• PDF-інвойс — мультимовні HTML-шаблони рахунків
• Лист з інвойсом — мультимовні теми та HTML-шаблони листів

Для передоплати додатково налаштовуються спосіб розрахунку, фіксована сума або відсоток, а також окремі шаблони для оплати залишку.

Робота через OCMOD

Інтеграція зі сторінкою успішного замовлення, переглядом замовлення в адміністративній частині та особистим кабінетом виконується через OCMOD. Модуль не потребує ручного редагування системних файлів OpenCart.

Сумісність

• OpenCart 3.x
• ocStore 3.x
• PHP 7.3–8.3
• Українська, російська та англійська локалізації

Системні вимоги

• Установлений OpenCart або ocStore 3.x
• PHP 7.3–8.3
• Установлений окремий пакет mPDF Runtime для PDF-інвойсів
• Налаштована пошта OpenCart для надсилання інвойсів
• Доступ сервера до зовнішнього HTTPS-посилання bank.gov.ua для відкриття платежу
• Стандартні PHP-розширення, необхідні для роботи mPDF

Важливі обмеження

• Модуль працює як банківський переказ за реквізитами та не є сервісом інтернет-еквайрингу
• QR-код і платіжне посилання передають реквізити, суму та призначення платежу, але не списують кошти без підтвердження клієнта в банку
• Автоматичний callback від банку та автоматична перевірка факту оплати не передбачені
• Статус замовлення після фактичного надходження коштів адміністратор змінює вручну
• Можливість відкрити й правильно заповнити платіж залежить від підтримки стандарту конкретним банківським застосунком
• Для надсилання листів повинна бути правильно налаштована пошта магазину

Встановлення

1. Завантажте архів bankapp_mpdf_v_1_0_oc3.ocmod.zip через розділ Розширення → Встановлення розширень
2. Завантажте архів bankapp_payment_v_1_0_oc3.ocmod.zip
3. Перейдіть до розділу Розширення → Модифікатори та оновіть кеш модифікаторів
4. Перейдіть до розділу Розширення → Розширення
5. У типі розширень виберіть Оплата
6. Установіть потрібні способи: повну оплату та/або передоплату
7. Заповніть отримувача, ІПН/ЄДРПОУ, IBAN, контакти та призначення платежу
8. Для передоплати виберіть фіксовану суму або відсоток
9. За потреби налаштуйте HTML-шаблони PDF та листів
10. Виберіть статус замовлення, геозону, порядок сортування та увімкніть модулі
11. Збережіть налаштування та перевірте оформлення тестового замовлення

Ліцензія

Одна ліцензія поширюється на один домен і його піддомени.