↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Jak przygotować księgowemu plik za kwartał i zobaczyć zysk

    Jak przyjmować płatności NovaPay w Elbuz: link, blokada, zwrot

    11 min czytaniaZaktualizowano

    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.

    1. Otwórz wiersz NovaPay ikoną ołówka. Otworzy się formularz „Podłączenie NovaPay”.
    2. W polu „Merchant ID” wpisz numer sprzedawcy z panelu NovaPay.
    3. 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.
    4. Włącz „Aktywność”. Formularz zapisuje się sam, przycisku „Zapisz” nie ma.
    Formularz „Podłączenie NovaPay” z przełącznikami, polami Merchant ID i klucza oraz adresem powiadomień o płatności
    1Skąd wziąć Merchant ID i klucz
    2Tryb testowy
    3Blokada: pobieraj po potwierdzeniu
    4Merchant ID
    5Pole klucza
    6Adres powiadomień o płatności
    1. Podpowiedź u góry — skąd wziąć Merchant ID i prywatny klucz RSA: z panelu NovaPay.
    2. Tryb testowy — środowisko testowe NovaPay, środki nie są pobierane.
    3. Blokada — środki są blokowane na karcie klienta, a pobierasz je Ty.
    4. Merchant ID — numer sprzedawcy z panelu NovaPay.
    5. Pole klucza — klucz jest zapisany i nie jest wyświetlany w oknie.
    6. 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.

    Ścieżka płatności NovaPay: lewa gałąź — bez blokady, prawa — z blokadą; zwrot jest możliwy dopiero po pobraniu środków
    klient zapłacił, blokadawyłączonaklient zapłacił, blokadawłączona„Pobierz blokadę” na całąkwotę lub część„Zdejmij blokadę” lub 29 dnibez pobrania„Zwróć środki” na część„Zwróć środki” na całąkwotęzwrócono resztęOczekujelink wysłanyOpłaconodowód wpłaty i paragon wdokumencieBlokadaśrodki zablokowane, dokument bezpłatnościAnulowanośrodki odblokowaneCzęściowo zwróconodowód wypłatyZwrócono
    • Початок
    • Стан
    • Кінець

    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.

    Blok „Płatność w NovaPay” w zamówieniu klienta ze stanem „Blokada” i przyciskami działań
    1Blokada
    2Kwota
    3Pobierz blokadę
    4Zdejmij blokadę
    5Odśwież status
    1. Plakietka „Blokada” — środki są zablokowane na karcie klienta.
    2. „Kwota” — kwota płatności.
    3. „Pobierz blokadę” — pobranie całej kwoty lub jej części.
    4. „Zdejmij blokadę” — odblokowanie środków klienta.
    5. „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.
    „Zdejmij blokadę” nie da się cofnąć. Blokadę można pobrać tylko raz: po częściowym pobraniu reszta jest już odblokowana klientowi, a pobrane środki wracają tylko przez „Zwróć środki”. Blokadę niepobraną w ciągu 29 dni NovaPay zdejmuje sam.

    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”.
    Zwrotu nie da się cofnąć. NovaPay przyjmuje zwroty do 30 dni od płatności. Paragon zwrotu PRRO nie wystawia się sam — wystaw go z dokumentu (jak wystawić paragon 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

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo