Elbuz tworzy link do płatności za fakturę lub zamówienie przez płatności internetowe NovaPay dla firm (ukraiński operator płatności). Środki klienta można pobrać od razu albo najpierw zablokować i pobrać po skompletowaniu; zwrot robisz z karty dokumentu.
Kiedy to się przyda:
- Klienci płacą kartą przez link — dokument sam dostaje płatność, dowód wpłaty i paragon.
- Towaru może zabraknąć w magazynie — z blokadą pobierasz tylko kwotę za skompletowane pozycje.
- Zamówienie anulowano przed wysyłką — „Zdejmij blokadę” i środki wracają do dyspozycji klienta.
- Klient zwrócił towar — „Zwróć środki” z dokumentu, bez logowania do panelu NovaPay.
Od czego zacząć: wpisz Merchant ID i klucz NovaPay, a potem w fakturze kliknij „Link do płatności”.
Co potrafi NovaPay w Elbuz
- Podłączenie w dwie minuty — Merchant ID i klucz prywatny z panelu NovaPay, tryb testowy do sprawdzenia.
- Link z karty dokumentu — na nieopłaconą kwotę faktury lub zamówienia klienta, e-mailem albo w komunikatorze.
- Płatność sama trafia do dokumentu — status, dowód wpłaty i paragon PRRO z formą płatności „NovaPay”.
- Blokada — środki klienta są blokowane, a Ty pobierasz całą kwotę lub jej część po skompletowaniu albo zdejmujesz blokadę.
- Zwrot — cała kwota lub jej część, z dowodem wypłaty w dokumencie.
Jak podłączyć NovaPay
Elbuz działa w ramach Twojej umowy o płatności internetowe z NovaPay: środki wpływają bezpośrednio na Twój rachunek. Do podłączenia potrzebne są dwie wartości z panelu NovaPay dla firm, sekcja Acquiring: Merchant ID i prywatny klucz RSA sprzedawcy.
Gdzie: Ustawienia systemu → „Inne ustawienia” → „Usługi zewnętrzne i integracje” → grupa „Płatność” → wiersz NovaPay.
- Otwórz wiersz NovaPay ikoną ołówka. Otworzy się formularz „Podłączenie NovaPay”.
- W polu „Merchant ID” wpisz numer sprzedawcy z panelu NovaPay.
- W polu „Klucz prywatny sprzedawcy (PEM)” wklej cały klucz — od
-----BEGIN PRIVATE KEY-----do-----END PRIVATE KEY-----. Jeśli klucz wkleił się w jednej linii, bez podziałów wierszy, to też zadziała. - Włącz „Aktywność”. Formularz zapisuje się sam, przycisku „Zapisz” nie ma.
1
Skąd wziąć Merchant ID i klucz2
Tryb testowy3
Blokada: pobieraj po potwierdzeniu4
Merchant ID5
Pole klucza6
Adres powiadomień o płatności- Podpowiedź u góry — skąd wziąć Merchant ID i prywatny klucz RSA: z panelu NovaPay.
- Tryb testowy — środowisko testowe NovaPay, środki nie są pobierane.
- Blokada — środki są blokowane na karcie klienta, a pobierasz je Ty.
- Merchant ID — numer sprzedawcy z panelu NovaPay.
- Pole klucza — klucz jest zapisany i nie jest wyświetlany w oknie.
- Adres powiadomień o płatności — nie trzeba go wpisywać w panelu NovaPay.
Kluczem Elbuz podpisuje każde zapytanie do NovaPay. Po zapisaniu w polu widać tylko „Klucz zapisany. Aby go zmienić, wklej nowy”, a puste pole nie kasuje starego klucza.
Klucz, którego nie da się odczytać, nie jest zapisywany: formularz pokaże „Nie można odczytać klucza: wklej cały klucz prywatny sprzedawcy…” i zachowa poprzedni. Jeśli zapisany klucz stał się nieprawidłowy albo brakuje kluczy, w formularzu pojawi się czerwony komunikat, a w „Link do płatności” NovaPay będzie szary z dopiskiem „klucze nie są skonfigurowane”.
Klucza publicznego NovaPay ani adresu powiadomień o płatności nie trzeba wpisywać: adres Elbuz przekazuje razem z każdym linkiem.
Tryb testowy
„Tryb testowy” przełącza usługę na środowisko testowe NovaPay, środki nie są pobierane. Wpisz Merchant ID 2 i klucz testowy z dokumentacji NovaPay (sekcja Authentication) — tam są też karty testowe.
Przejdź całą ścieżkę na zamówieniu testowym. Potem wyłącz „Tryb testowy” i wpisz produkcyjne Merchant ID i klucz.
Przełącznik blokady
„Blokada: pobieraj po potwierdzeniu” jest domyślnie wyłączona: płatność jest pobierana od razu i zapisywana w dokumencie. Gdy ją włączysz, środki są blokowane na karcie, a pobierasz je Ty przyciskiem w dokumencie (jak to działa).
Przełącznik działa na linki utworzone po jego zmianie.
Jak utworzyć link NovaPay
Link tworzy się tak samo jak dla innych usług: karta faktury lub zamówienia klienta → „Link do płatności” → w polu „Usługa płatności” wybierz NovaPay → „Utwórz link”. Dalej — „Wyślij e-mailem” albo „Kopiuj” (więcej o linku i e-mailu).
NovaPay ma dwa warunki, których nie ma w innych usługach:
- Tylko hrywny. Dokument w innej walucie nie dostanie linku: „NovaPay: currency … is not supported (UAH)”.
- Telefon klienta jest obowiązkowy — wymaga tego NovaPay. Elbuz sprawdza po kolei telefon z dokumentu, telefon płatnika i telefony kontrahenta, bierze pierwszy ukraiński numer i sprowadza go do postaci +380XXXXXXXXX. Zagraniczny numer w dokumencie nie przeszkadza, jeśli kontrahent ma też ukraiński.
Link tworzy się na nieopłaconą kwotę dokumentu. Klient na stronie NovaPay widzi jeden wiersz „<typ dokumentu> nr …” na całą kwotę. Status usługi w dokumencie to „Oczekuje na płatność”, a w karcie pojawia się blok „Płatność w NovaPay” ze stanem „Oczekuje”.
Blok działa z ostatnim linkiem dokumentu. Przed utworzeniem nowego linku Elbuz sprawdza poprzedni:
- nieopłacony — Elbuz unieważnia go w NovaPay i stary link u klienta przestaje działać;
- z blokadą — nowy nie powstanie, dopóki blokada nie zostanie pobrana lub zdjęta (komunikat);
- opłacony — zostaje bez zmian, a nowy link jest na pozostałą kwotę. Zwrotu za poprzednią płatność z bloku już nie zrobisz, tylko w panelu NovaPay;
- NovaPay nie odpowiedział — nowy też nie powstanie, żeby klient nie zapłacił dwa razy. Spróbuj ponownie.
Co trafia do dokumentu po płatności
NovaPay powiadamia Elbuz o płatności. Elbuz nie ufa samemu powiadomieniu: bierze z niego tylko numer płatności i sam pyta NovaPay o stan, używając Twojego klucza. Dlatego płatności nie da się podrobić, a powtórne powiadomienie nie podwaja kwoty.
Bez blokady po płatności dokument dostaje:
- status płatności „Opłacono”, a jeśli zapłacono nie wszystko — „Przedpłata”;
- sposób płatności „Karta płatnicza”, a w bloku „Płatność w NovaPay” — stan „Opłacono” i numer transakcji NovaPay;
- zatwierdzony „Dowód wpłaty (KP)” na otrzymaną kwotę z numerem transakcji w opisie;
- paragon fiskalny, jeśli w kasie PRRO (ukraińskiej programowej kasie fiskalnej) włączono „Paragon przy płatności przez link”. Forma płatności na paragonie to „NovaPay”, a nie „Płatność internetowa” (paragon przy płatności przez link).
Z blokadą po płatności dokument dostaje tylko stan „Blokada”. Kwota płatności, dowód wpłaty i paragon pojawiają się po „Pobierz blokadę”, bo do tego momentu środki nadal należą do klienta.
- Початок
- Стан
- Кінець
Jak pobrać lub zdjąć blokadę
Blokada to środki zablokowane na karcie klienta: pobrać je może tylko sprzedawca. Dzięki temu nie bierzesz pieniędzy za towar, którego może zabraknąć, i nie musisz potem robić zwrotu.
Gdzie: karta dokumentu → blok „Płatność w NovaPay”. Blok pojawia się, gdy do dokumentu utworzono link NovaPay.
1
Blokada2
Kwota3
Pobierz blokadę4
Zdejmij blokadę5
Odśwież status- Plakietka „Blokada” — środki są zablokowane na karcie klienta.
- „Kwota” — kwota płatności.
- „Pobierz blokadę” — pobranie całej kwoty lub jej części.
- „Zdejmij blokadę” — odblokowanie środków klienta.
- „Odśwież status” — pobranie stanu z NovaPay.
- „Pobierz blokadę” — Elbuz pyta o kwotę: domyślnie cała zablokowana, można wpisać mniejszą. Po pobraniu płatność zapisuje się w dokumencie tak samo jak bez blokady: status, dowód wpłaty i paragon na pobraną kwotę. Różnicę NovaPay sam odblokowuje klientowi.
- „Zdejmij blokadę” — środki są odblokowywane na karcie klienta, stan zmienia się na „Anulowano”. Do dokumentu nic się nie zapisuje, dowodów kasowych nie ma.
- „Odśwież status” — pyta NovaPay o stan. Jeśli klient zapłacił, a powiadomienie nie dotarło do Elbuz, płatność się zapisze.
Jeśli po częściowym pobraniu zamówienie się zmniejszyło, popraw skład dokumentu: płatność zapisuje się na pobraną kwotę, a kwota dokumentu zostaje taka, jaka była.
Jak zwrócić środki klientowi
Przycisk „Zwróć środki” pojawia się w bloku „Płatność w NovaPay”, gdy płatność jest opłacona lub blokada pobrana i jest co zwracać. Elbuz pyta o kwotę: domyślnie wszystko, co można zwrócić, ale możesz wpisać mniej. Kolejny zwrot dotyczy pozostałej kwoty.
Po zwrocie:
- powstaje zatwierdzony „Dowód wypłaty (KW)” na kwotę zwrotu, powiązany z dokumentem;
- „Zapłacono” w dokumencie zmniejsza się o tę kwotę;
- status płatności dokumentu to „Zwrócono częściowo” albo „Zwrócono”, jeśli zwrócono wszystko; w bloku — „Częściowo zwrócono” lub „Zwrócono”, wiersz „Zwrócono”, a dopóki jest co zwracać — „Do zwrotu”.
Zwrot zrobiony w panelu NovaPay z pominięciem Elbuz nie jest zapisywany dowodem kasowym: blok pokaże stan „Zwrócono”, ale dowód i kwotę dokumentu popraw ręcznie.
Każda operacja pieniężna zostawia wiersz w historii dokumentu, na przykład „Zwróć środki: 500,00 UAH, NovaPay — wykonano” albo „… — błąd (…)”. Jeśli połączenie zerwie się w trakcie operacji, Elbuz zaproponuje „Powtórz”, a powtórzenie nie przesunie pieniędzy drugi raz (wyjaśnienie).
Co zrobić, gdy link lub płatność się nie udały
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| „NovaPay: the buyer phone (+380XXXXXXXXX) is required — fill in the phone in the document” | Ani w dokumencie, ani u płatnika, ani u kontrahenta nie ma ukraińskiego numeru | Wpisz telefon klienta w dokumencie i utwórz link ponownie (warunki NovaPay) |
| „NovaPay: currency … is not supported (UAH)” | Dokument nie jest w hrywnach | Wybierz inną usługę dla tego dokumentu (usługi i waluty) |
| NovaPay nie ma na liście „Usługa płatności” albo jest szary z dopiskiem „klucze nie są skonfigurowane” | Wyłączona „Aktywność”. Szary wiersz „klucze nie są skonfigurowane” — nie wpisano Merchant ID albo zapisanego klucza nie da się odczytać | Otwórz formularz „Podłączenie NovaPay”: czerwony komunikat podpowie, czego brakuje; wklej ponownie cały klucz (podłączenie) |
| „Poprzedni link NovaPay opłacono z blokadą. Najpierw pobierz lub zdejmij blokadę…” | Klient już opłacił poprzedni link, środki są zablokowane | Pobierz lub zdejmij blokadę w bloku „Płatność w NovaPay”, a potem utwórz nowy link (blokada) |
| „Nie udało się zamknąć poprzedniego linku NovaPay, więc nowego nie utworzono…” | NovaPay nie odpowiedział, gdy Elbuz unieważniał stary link | Utwórz link jeszcze raz trochę później (link) |
| Klient zapłacił, a dokument jest bez płatności | Włączona jest blokada albo powiadomienie NovaPay nie dotarło | Sprawdź stan w bloku „Płatność w NovaPay”: „Blokada” — pobierz blokadę, w przeciwnym razie kliknij „Odśwież status” |
| „Nie wiadomo, czy operacja przeszła. Kliknij «Powtórz» — pieniądze nie zostaną przesunięte drugi raz” | Połączenie zerwało się podczas pobierania lub zwrotu | Kliknij „Powtórz” albo „Odśwież status” — powtórzenie nie przesuwa pieniędzy drugi raz (zwrot) |
Scenariusze
Przedpłata kartą za fakturę
Co zrobić. Blokada wyłączona. W fakturze na 1 200 UAH z telefonem klienta kliknij „Link do płatności”, wybierz NovaPay i wyślij link w komunikatorze.
Efekt. Po płatności faktura ma status „Opłacono”, obok jest zatwierdzony dowód wpłaty, a przy włączonym przełączniku kasy — paragon z formą płatności „NovaPay”.
Części zamówienia zabrakło w magazynie
Co zrobić. Blokada włączona, klient opłacił zamówienie na trzy produkty za 2 400 UAH — stan „Blokada”. Znalazły się dwa produkty za 1 600 UAH: „Pobierz blokadę”, kwota 1 600, i usuń trzeci produkt z zamówienia.
Efekt. W dokumencie jest płatność 1 600 UAH z dowodem wpłaty i paragonem, a 800 UAH NovaPay odblokuje klientowi.
Zamówienie anulowano przed wysyłką
Co zrobić. Stan „Blokada” → „Zdejmij blokadę”.
Efekt. Stan „Anulowano”, środki odblokowane na karcie klienta, bez dowodów kasowych i paragonów.
Klient zwrócił część towaru
Co zrobić. Zapłacono 1 600 UAH, zwrócono towar za 500 UAH: „Zwróć środki”, kwota 500.
Efekt. Dowód wypłaty na 500 UAH, zapłacono 1 100 UAH, status „Zwrócono częściowo”. Paragon zwrotu wystaw z dokumentu ręcznie.
Najczęstsze pytania
Czy pieniądze klienta przechodzą przez Elbuz?
Nie. Pracujesz na własnej umowie z NovaPay i własnym kluczem — środki trafiają bezpośrednio na Twój rachunek.
Czy „Bezpieczny zakup” NovaPay działa z dostawą?
Nie. Blokada w Elbuz nie jest powiązana z dostawą, a listy przewozowe Nova Poshta tworzy moduł dostawy Twoim kluczem (Nova Poshta).
Czy blokada i zwroty są w LiqPay lub monobank?
Nie, spośród linków do płatności blokadę i zwrot z karty dokumentu obsługuje tylko NovaPay. W innych usługach zwrot robi się w ich panelu.
Powiadomienie o płatności przyszło dwa razy. Czy kwota się nie podwoi?
Nie. Każda transakcja zapisuje się w dokumencie raz.
Dlaczego menedżer nie widzi przycisków „Pobierz blokadę” i „Zwróć środki”?
Przyciski operacji pieniężnych są dostępne z uprawnieniem „Operacje płatności: zwrot, blokada, kredyt” okna dokumentów. Domyślnie mają je tylko administratorzy; blok i „Odśwież status” widzą wszyscy z dostępem do dokumentów.
Czy można zmienić kwotę już utworzonego linku?
Nie. Popraw dokument i utwórz nowy link — będzie na nową pozostałą kwotę, a stary nieopłacony Elbuz unieważni w NovaPay.
Gdzie to jest i kto ma dostęp
- Menu
- faktura lub zamówienie klienta: przycisk „Link do płatności”, blok „Płatność w NovaPay”
- Podłączenie
- ustawienia usług zewnętrznych, usługa płatności NovaPay
- Uprawnienia
- pobranie i zdjęcie blokady oraz zwrot — „Operacje płatności: zwrot, blokada, kredyt”
- Przygotuj
- umowę o płatności internetowe z NovaPay, Merchant ID i klucz prywatny; telefon klienta w dokumencie
Powiązane tematy
- Jeśli potrzebujesz innych usług płatności albo e-maila z linkiem — Jak wysłać klientowi link do płatności za fakturę.
- Jeśli do płatności i zwrotów potrzebne są paragony fiskalne — paragony PRRO.
- Jeśli chcesz zobaczyć, ile klient jest jeszcze winien z uwzględnieniem płatności i zwrotów — Zadłużenie klienta i płatności.
- Jeśli zamówienie po pobraniu blokady trzeba wysłać z magazynu Nova Poshta — Nova Poshta Fulfillment.
