NovaPay для OpenCart — оплата карткою через інтернет-еквайринг

NovaPay Acquiring — модуль інтернет-еквайрингу NovaPay для OpenCart 2.3, 3.x і 4.x. Покупець оплачує карткою на захищеній сторінці NovaPay, а магазин отримує підписане сповіщення (постбек) і сам переводить замовлення в оплачені — без ручної звірки виписки.

Базова версія — безкоштовна. Приймання оплати, перевірка підпису постбека і реконсиляція статусу при поверненні покупця працюють без ключа. Pro-функції (двоетапна оплата з блокуванням коштів, журнал платежів, повернення й звірка статусу з адмінки) розблоковуються ліцензійним ключем — купити нижче.

Живе демо

Модуль можна помацати руками до покупки — окремий демо-магазин на кожну версію: OpenCart 4.x, OpenCart 3.x, OpenCart 2.3. Демо працюють у пісочниці NovaPay: реальні гроші не рухаються.

Як це працює

На кроці оплати покупець тисне «Оплатити карткою» — модуль відкриває платіжну сесію NovaPay і веде його на сторінку оплати з сумою й кошиком вашого замовлення. Після оплати NovaPay надсилає постбек, підписаний своїм ключем; модуль перевіряє підпис, звіряє суму із замовленням і ставить статус «Оплачено». Якщо постбек не долетів (фаєрвол, техроботи) — статус підтягується, щойно покупець повертається в магазин, або кнопкою «Звірити» в журналі.

Що входить у безкоштовну версію

• Оплата карткою на захищеній сторінці NovaPay — кошик і сума передаються в сесію повністю.
• Перевірка підпису постбека публічним ключем NovaPay: чужий запит не переведе замовлення в оплачені.
• Захист від недоплати — сума з NovaPay звіряється з сумою замовлення, менша сума не проводиться як оплата.
• Реконсиляція при поверненні покупця: статус тягнеться з NovaPay, а не вгадується.
• Пісочниця api-qecom для налаштування й перевірка ключів однією кнопкою.
• Окремі статуси замовлення під очікування оплати, оплату, відмову і повернення.
• Українська та англійська локалізація адмінки й вітрини.

Що додає Pro

• Двоетапна оплата (hold). Гроші блокуються на картці й списуються автоматично, коли ви переводите замовлення в оплачений статус — зручно, якщо товар ще треба зібрати або перевірити наявність.
• Журнал платежів. Усі платежі NovaPay одним списком: сума, повернення, статус сесії й статус замовлення, замаскована картка, ідентифікатор операції.
• Повернення коштів з адмінки — повне й часткове, без походу в кабінет NovaPay.
• «Звірити» — підтягнути поточний стан сесії з NovaPay для конкретного замовлення, коли постбек загубився.

Що потрібно для роботи

Договір інтернет-еквайрингу з NovaPay: вони видають merchant ID і приймають вашу публічну частину ключа, а свій публічний ключ дають вам для перевірки постбеків. Ключі бойові й тестові — різні. Модуль приймає оплату лише у гривні: якщо кошик у іншій валюті, метод оплати просто не показується, щоб не списати не ту суму.

Установка

OpenCart 4.x — Розширення → Встановлення розширень → завантажити zip, потім Розширення → Оплата → NovaPay → «Встановити» і «Редагувати». OpenCart 3.x — так само через Розширення → Встановлення розширень. OpenCart 2.3 — штатний інсталятор вимагає увімкненого FTP, тож простіше розпакувати вміст upload/ у корінь магазину, а потім Розширення → Оплата → NovaPay → «Встановити».

Питання й відповіді

Чи можна почати без ліцензії? Так. Приймання оплат і підтвердження постбеком працюють у безкоштовній версії без обмежень за оборотом і кількістю замовлень.

Ліцензію треба продовжувати? Ні. Для OpenCart ліцензія назавжди: одна оплата, і Pro-функції лишаються з вами. Закінчується лише 7-денний тріал — після нього Pro вимикається, а безкоштовна версія працює далі.

Один ключ на три версії OpenCart? Так, ліцензія спільна для збірок під 2.3, 3.x і 4.x — активацій дві, тобто бойовий магазин плюс тестовий.

Чому замовлення лишається в «очікує оплати»? Найчастіше не долітає постбек. Перевірте, що URL постбека з налаштувань відкритий назовні (фаєрвол, Cloudflare, basic-auth) і що вставлено саме публічний ключ NovaPay — без нього сповіщення відхиляються навмисно.

Навіщо це магазину

NovaPay — це еквайринг від Нової Пошти, і для магазину, який і так возить НП, це найкоротший шлях: один контрагент на доставку й оплату, одна звірка, один менеджер на тому боці.

Технічно ж це звичайний платіжний шлюз, і всі його ризики теж звичайні: постбек може не дійти, покупець може закрити вкладку на сторінці банку, а замовлення має закритись коректно в обох випадках.

Скільки коштує

Ліцензія Pro — 990 грн, на один домен. Ліцензія назавжди: оплачуєте один раз, без щорічних платежів.

Безкоштовна версія при цьому не обмежена ні часом, ні кількістю платежів: приймання оплати, перевірка підпису й реконсиляція працюють без ключа.

Що під капотом

Підпис постбека перевіряється до того, як модуль щось зробить із замовленням — це не опція. Далі статус не береться зі слів постбека: модуль звіряє його запитом до NovaPay і тільки тоді переводить замовлення.

Саме тому замовлення закривається навіть тоді, коли постбек загубився дорогою, а повторний постбек не створює дубль.

Ядро OpenCart не патчиться — усе через штатні події, тож оновлення магазину модуль не затирає.

Історія версій

1.0.0 — приймання оплати карткою через NovaPay, перевірка підпису постбека, реконсиляція статусу з банком; у Pro — двоетапна оплата з блокуванням коштів (hold), журнал платежів і повернення з адмінки.