Podłączenie systemu płatności NovaPay
NovaPay (Nova Group) to system płatności i usługa internet acquiringu, która pozwala przyjmować płatności online kartą i popularnymi metodami bezpośrednio w Twoim sklepie na BooStore. Integracja jest już wbudowana w platformę: wystarczy uzyskać dostęp od NovaPay i dodać klucze w ustawieniach metody — a metoda płatności pojawi się w formularzu zamówienia.
📄 Spis treści
Czym jest NovaPay i kiedy go podłączyć
NovaPay to internet acquiring od Nova Group, ściśle zintegrowany z ekosystemem Nova Poshta. System płatności obsługuje karty Visa, Mastercard i Prostir, a także Apple Pay, Google Pay oraz przycisk szybkiej płatności NovaPay.
💳 Niska prowizja
Prowizja systemu płatności wynosi 0–1,3%. Przy płatności kartą NovaPay prowizja wynosi 0%.
Krok po kroku podłączenie NovaPay
Aby podłączyć system płatności, skontaktuj się z NovaPay (Nova Group), aby uzyskać dostęp do internet acquiringu. Po podłączeniu otrzymasz dane do integracji.
- Skontaktuj się z NovaPay (Nova Group) i uzyskaj dostęp do internet acquiringu.
- Otrzymaj prywatny klucz RSA merchanta (PEM) oraz klucz publiczny NovaPay (PEM).
- W Panelu Administracyjnym przejdź do „Sklep” → „Systemy płatności” i kliknij „Dodaj metodę płatności”.
- Wybierz NovaPay. Pole
Konto / Merchant IDmożna zostawić puste — nic nie trzeba wpisywać. - Zapisz dane kontaktowe metody, a następnie kliknij przycisk ustawień (ikonę zębatki).
- W oknie podaj prywatny klucz RSA merchanta (PEM) oraz klucz publiczny NovaPay (PEM, do webhooka).
- Podaj adres środowiska: testowe —
https://api-qecom.novapay.ua, produkcyjne —https://api-ecom.novapay.ua. - Zapisz metodę — po wypełnieniu będzie dostępna w formularzu zamówienia.
https://api-qecom.novapay.ua, a po testach przełączyć się na produkcyjny https://api-ecom.novapay.ua.
Ustawienia metody płatności (przycisk ustawień)
Wszystkie dodatkowe możliwości NovaPay są zarządzane przez przycisk ustawień metody płatności. Poniżej główne parametry.
| Parametr | Wartość |
|---|---|
| Typ płatności | zwykłe obciążenie (debit) lub hold (hold: blokada + finalizacja/anulowanie; hold do 29 dni) |
| Tryb | acquiring (v1/session) lub checkout (v1/checkout/session, z tworzeniem ekspresowej listy przewozowej TTN) |
| TTN / ekspresowa list przewozowy | none — nie tworzyć; existing — podchwycić list przewozowy Nova Poshta z zamówienia; create — utworzyć list przewozowy NovaPay |
| Sposoby płatności | card, apple_pay, google_pay, wallet (identifier) |
| PRRO | obsługiwane (products w add-payment) |
| Waluta | tylko UAH |
| Subskrypcja | nieobsługiwana |
Możliwości NovaPay
💳 Sposoby płatności
Karty Visa, Mastercard i Prostir, Apple Pay, Google Pay oraz przycisk szybkiej płatności NovaPay.
⏸️ Typ płatności
Zwykłe obciążenie (debit) lub hold (hold): blokada środków z finalizacją lub anulowaniem. Hold — do 29 dni.
⚙️ Tryb pracy
acquiring (v1/session) lub checkout (v1/checkout/session) — z tworzeniem ekspresowej listy przewozowej TTN.
📦 TTN / ekspresowa list przewozowy
none — nie tworzyć, existing — podchwycić list przewozowy Nova Poshta z zamówienia, create — utworzyć list przewozowy NovaPay.
🧾 PRRO
Obsługiwane: skład zamówienia jest przekazywany w products w add-payment.
💰 Prowizja
0–1,3%. Przy płatności kartą NovaPay — 0%.
💵 Waluta
Tylko UAH.
🔁 Subskrypcja
Nieobsługiwana.
Anulowanie płatności, hold i ekspresowa list przewozowy
Dla NovaPay zrealizowano anulowanie płatności (void/refund) w statystykach sprzedaży, a także obsługę holdu (complete-hold / void).
- Anulowanie i zwrot — dostępne bezpośrednio w statystykach sprzedaży; informacja o anulowaniu jest zapisywana w zamówieniu.
- Hold — środki są blokowane na karcie klienta, następnie możesz potwierdzić obciążenie (complete-hold) lub je anulować (void). Hold jest przechowywany do 29 dni.
- Ekspresowa list przewozowy — integracja z TTN Nova Poshta: można podchwycić istniejący list przewozowy z zamówienia lub utworzyć nowy list przewozowy NovaPay.
Wbudowane w BooStore
System płatności NovaPay jest już wbudowany w platformę — nie jest potrzebna osobna usługa ani ręczna konfiguracja kodu. Wystarczy:
- Uzyskać dostęp do internet acquiringu od NovaPay (Nova Group).
- Dodać metodę płatności i podać klucz RSA oraz klucz publiczny NovaPay w ustawieniach.
- Wybrać typ płatności, tryb, ekspresową list przewozowy i sposoby płatności w ustawieniach.
❓ Najczęściej zadawane pytania o podłączenie NovaPay
Odpowiedzi na popularne pytania o podłączenie i możliwości systemu płatności NovaPay na BooStore.
Jak podłączyć system płatności NovaPay?
Skontaktuj się z NovaPay (Nova Group), aby uzyskać dostęp do internet acquiringu, otrzymaj prywatny klucz RSA merchanta (PEM) i klucz publiczny NovaPay (PEM). Następnie w „Sklep” → „Systemy płatności” dodaj metodę NovaPay — pole „Konto / Merchant ID” można zostawić puste — i podaj oba klucze w ustawieniach (przycisk zębatki).
Jakie sposoby płatności obsługuje NovaPay?
Karty Visa, Mastercard i Prostir, Apple Pay, Google Pay oraz przycisk szybkiej płatności NovaPay. W ustawieniach wybiera się je jako card, apple_pay, google_pay, wallet.
Jaka jest prowizja NovaPay?
Prowizja wynosi 0–1,3%. Przy płatności kartą NovaPay prowizja wynosi 0%.
Czym jest hold i jak długo trwa?
Hold to blokada środków na karcie klienta zamiast natychmiastowego obciążenia. Następnie możesz sfinalizować obciążenie (complete-hold) lub je anulować (void). Hold jest przechowywany do 29 dni.
Jakie tryby pracy są dostępne?
Dwa tryby: acquiring (v1/session) i checkout (v1/checkout/session). Tryb checkout dodatkowo pozwala tworzyć ekspresową listę przewozową TTN.
Czym jest ekspresowa list przewozowy i jakie są warianty?
Ekspresowa list przewozowy to obsługa TTN Nova Poshta. Dostępne warianty: none (nie tworzyć), existing (podchwycić list przewozowy z zamówienia) i create (utworzyć list przewozowy NovaPay).
Czy PRRO jest obsługiwane i w jakiej walucie są rozliczenia?
PRRO jest obsługiwane — skład zamówienia jest przekazywany w products w add-payment. Rozliczenia prowadzone są tylko w UAH. Subskrypcja i płatności cykliczne nie są obsługiwane.
Czy dostępne jest anulowanie i zwrot płatności?
Tak. Dla NovaPay zrealizowano anulowanie płatności (void/refund) w statystykach sprzedaży, a także hold (complete-hold/void) i integrację z ekspresową listą przewozowym.