Płatność LiqPay działa bezpośrednio przy składaniu zamówienia: klient płaci kartą, Apple Pay lub Google Pay, a zamówienie samo staje się opłacone. Wystarczy wpisać dwa klucze z panelu LiqPay w ustawieniach sklepu w Elbuz.
Kiedy to się przyda:
- Potrzebujesz płatności kartą na stronie — pieniądze trafiają na Twoje konto, a status zmienia się sam.
- Towar wysyła dostawca — blokada zamraża pieniądze, a pobranie następuje, gdy potwierdzisz zamówienie.
- Drogi sprzęt jest zamawiany i nieodbierany — przedpłata pobiera online tylko część kwoty.
- Potrzebny jest paragon fiskalny — wystawia go programowa kasa LiqPay (PRRO) i wysyła klientowi e-mailem.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → LiqPay → klucze i przełącznik „Włączony”.
Co potrafi płatność LiqPay
- Przyjmować płatność na stronie składania zamówienia — karta, Apple Pay, Google Pay, Privat24, portfel LiqPay, kod QR.
- Blokada — pieniądze są blokowane na karcie i pobierane po Twoim potwierdzeniu.
- Samodzielnie ustawiać status zamówienia — opłacone, blokada, potwierdzone, zwrócone, anulowane.
- Pobierać przedpłatę — procent lub stałą kwotę, reszta przy odbiorze.
- Przyjmować pieniądze na drugie konto — osobna metoda płatności z innymi kluczami.
- Wystawiać paragon fiskalny przez kasę LiqPay.
Jak podłączyć LiqPay
Potrzebujesz umowy z LiqPay jako FOP (ukraińska jednoosobowa działalność) lub firma i sklepu utworzonego w panelu LiqPay. Dopóki LiqPay nie aktywuje sklepu, przechodzą tylko płatności testowe.
- Pobierz klucze. W panelu LiqPay dla firm (liqpay.ua) otwórz ustawienia swojego sklepu: są tam klucz publiczny i prywatny. Prywatny jest tajny — nikomu go nie przesyłaj.
- Otwórz ekran modułu. „Ustawienia sklepu” → dział „Zamówienie i płatność” → karta LiqPay.
- Wpisz klucze w bloku „Połączenie”: „Klucz publiczny” i „Klucz prywatny”.
- Włącz przełącznik „Włączony” u góry ekranu.
- Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu: na dole pojawi się „Zapisano i zastosowano w sklepie”.
1
Wiersz LiqPay2
Znacznik stanu modułu- Wiersz LiqPay — otwiera ekran ustawień LiqPay.
- Znacznik stanu obok nazwy — pokazuje, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
1
Przełącznik „Włączony”2
Klucz publiczny3
Klucz prywatny4
Co jeszcze do skonfigurowania5
Stan modułu- Po zapisaniu pokazuje LiqPay klientom.
- Klucz publiczny z Twojego panelu LiqPay.
- Klucz tajny: po zapisaniu widać tylko znacznik „ustawiony”, nigdy sam klucz.
- Czego jeszcze brakuje, żeby płatność działała.
- Stan modułu w sklepie.
Waluta płatności musi być wśród walut sklepu, a dla zamówień w złotych lub funtach — także hrywna. Inaczej LiqPay nie pojawi się przy składaniu zamówienia.
Bez kluczy włączony moduł się nie zapisze: pod polem pojawi się „Wymagane — bez tego moduł nie zadziała”. Klucz prywatny po zapisaniu nie jest pokazywany — w polu widać tylko, że klucz jest ustawiony. Aby zmienić klucz, wpisz nowy.
W panelu LiqPay nic nie trzeba wpisywać: adres powiadomień o płatności moduł sam przekazuje z każdą płatnością.
Czego jeszcze brakuje, widać po prawej, w karcie „Co jeszcze do skonfigurowania”. Jak działa samo okno — w artykule „Ustawienia sklepu”.
Co widzi klient i dla jakich zamówień
Klient wybiera LiqPay spośród metod płatności, potwierdza zamówienie i klika „Zapłać”. Po płatności widzi krótką stronę „Sprawdzamy status płatności...”, a potem zwykłą stronę udanego zamówienia.
Gdy płatność się nie powiedzie, klient widzi „Błąd płatności” z przyciskiem „Kontynuuj”: może spróbować ponownie albo wybrać inną metodę.
Wygląd płatności ustawia blok „Jak płaci klient”:
| Pole | Co robi | Domyślnie |
|---|---|---|
| Nazwa metody płatności | Nazwa na liście płatności, osobno dla każdego języka | „LiqPay (karta, Apple Pay, Google Pay)” |
| Czym można zapłacić | Karta płatnicza, Portfel LiqPay, Privat24, Apple Pay, Google Pay, Kod QR | nic nie zaznaczono — wszystko, co LiqPay udostępnia Twojemu sklepowi |
| Gdzie otwierać płatność | „Strona LiqPay” — klient przechodzi na stronę LiqPay i wraca; „Widżet na stronie” — formularz płatności na Twojej stronie | Strona LiqPay |
| Wygląd widżetu | Tylko dla widżetu: „Zwykły”, „Wbudowany w stronę” lub „Wyskakujące okno” | Zwykły |
| Waluta płatności | „Jak w zamówieniu” albo hrywny, dolary lub euro. Zamówienie w innej walucie (złote, funty) jest płacone w hrywnach po kursie sklepu | Jak w zamówieniu |
| Język strony płatności | „Jak język strony” — angielski dla angielskiej wersji strony, dla pozostałych — ukraiński; albo „Ukraiński” lub „Angielski” | Jak język strony |
Dla jakich zamówień pokazywać
Blok „Gdzie pokazywać” ogranicza, kto widzi LiqPay:
- „Minimalna kwota zamówienia” i „Maksymalna kwota zamówienia” — granice kwoty,
0— bez ograniczenia. Gdy maksymalna jest mniejsza od minimalnej, ekran nie pozwoli zapisać. - „Strefa geograficzna” — płatność tylko dla klientów z adresem w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Miejsce na liście płatności” — mniejsza liczba stoi wyżej.
Blokada i statusy zamówienia
Pobrać od razu czy zablokować
Służy do tego pole „Kiedy pobrać pieniądze” w bloku „Jak płaci klient”.
| Kiedy pobrać pieniądze | Co dzieje się z pieniędzmi | Dla kogo |
|---|---|---|
| Od razu | Są pobierane od razu | Towar jest w magazynie, wysyłka od razu |
| Po Twoim potwierdzeniu (blokada) | Są blokowane na karcie; pobierane, gdy potwierdzisz płatność | Towar wysyła dostawca, dostępność trzeba sprawdzić |
Przy blokadzie w bloku „Statusy zamówienia” pojawiają się „Środki zablokowane (blokada)” i „Blokada potwierdzona”. Domyślnie są tam „Przetworzone” i „W realizacji”.
W sklepach skonfigurowanych wcześniej może być ustawione „Nie zmieniaj” — wtedy po prawej pojawi się „Nie ustawiono statusów «Blokada» i «Potwierdzone» — po blokadzie zamówienie zostanie bez statusu”. Wybierz statusy (poniżej).
Jeśli „Środki zablokowane (blokada)” jest takie samo jak „Opłacone”, po prawej pojawi się „Statusy «Opłacone» i «Blokada» są takie same — blokady nie da się odróżnić od płatności”.
Blokada trwa ograniczony czas: potem bank sam ją zdejmuje, a pieniądze wracają do klienta. Dokładny termin — w warunkach LiqPay. Potwierdzaj blokadę, gdy tylko towar jest dostępny.
Jakie statusy są ustawiane
Status ustawia sam sklep, gdy LiqPay powiadamia o zdarzeniu. Które dokładnie — wybierasz w bloku „Statusy zamówienia”. Domyślnie „Oczekuje na płatność” to „Oczekujące”, „Opłacone” — „W realizacji”, „Płatność nieudana” — „Anulowane”.
1
Opłacone2
Płatność nieudana3
Środki zablokowane (blokada)4
Środki zwrócone- Ustawiany, gdy płatność przeszła; płatności testowe też go dostają.
- Płatność nie została potwierdzona, więc zamówienie jest anulowane.
- Pieniądze są zablokowane na karcie i czekają na Twoje potwierdzenie.
- Pieniądze zwrócono klientowi.
| Pole | Kiedy jest ustawiany |
|---|---|
| Oczekuje na płatność | Przedpłata wniesiona, reszta przy odbiorze. Moduł uznaje takie zamówienie za jeszcze nieopłacone |
| Opłacone | Klient zapłacił pełną kwotę. Płatność testowa też |
| Płatność nieudana | Klient wrócił z płatności, a LiqPay jej nie potwierdził (moduł czeka około 20 sekund) |
| Środki zablokowane (blokada) | Pieniądze są zablokowane i czekają na Twoje potwierdzenie. Ten sam status — gdy bank czeka na kod potwierdzenia od klienta |
| Blokada potwierdzona | Potwierdzono blokadę, pieniądze zostały pobrane |
| Środki zwrócone | Pieniądze zwrócono klientowi |
Pola blokady są widoczne tylko wtedy, gdy „Kiedy pobrać pieniądze” to „Po Twoim potwierdzeniu (blokada)”. Dla nich i dla „Środki zwrócone” można wybrać „Nie zmieniaj”: wtedy zamówienie zostaje bez zmian. „Blokada potwierdzona” i „Środki zwrócone” są ustawiane, gdy LiqPay powiadomi sklep o operacji.
Dopóki LiqPay nie potwierdzi płatności, zamówienie pozostaje niepotwierdzone i nie jest uznawane za nowe. Status płatności jest ustawiany tylko wtedy, gdy kwota i waluta płatności są równe bieżącej kwocie zamówienia.
Przedpłata i drugie konto
To dwie osobne metody płatności obok zwykłego LiqPay: „LiqPay (przedpłata)” i „LiqPay (dodatkowy)”. Obie działają tylko przy skonfigurowanym głównym LiqPay.
Ich ekrany pojawiają się w dziale „Zamówienie i płatność”, gdy metoda jest zainstalowana w sklepie. Nie ma ekranu — metodę podłącza wsparcie Elbuz.
Przedpłata części kwoty
Klient płaci online część, resztę przy odbiorze. Nad przyciskiem płatności widzi na przykład „Przedpłata 10%: 1500 UAH” i „Pozostała kwota: 13500 UAH”.
- „Jak liczyć przedpłatę” — „Procent zamówienia” lub „Stała kwota”. „Wysokość przedpłaty” — procent (od 0,01 do 100) lub kwota w walucie bazowej sklepu.
- „Minimalna przedpłata” i „Maksymalna przedpłata” — granice przedpłaty. 10% z 500 UAH to 50 UAH, a przy minimalnej przedpłacie 200 klient zapłaci 200 UAH. Przedpłata nigdy nie przekracza kwoty zamówienia. Granice też podaje się w walucie bazowej sklepu; jeśli klient płaci w innej, moduł przeliczy je po kursie sklepu.
- „Minimalna kwota zamówienia” i „Maksymalna kwota zamówienia” — dla jakich zamówień pokazywać metodę.
0— dla wszystkich.
Po opłaceniu przedpłaty zamówienie dostaje status z pola „Oczekuje na płatność” głównego modułu. Klucze, waluta i statusy też są brane z głównego LiqPay. Przedpłata nie tworzy paragonu.
Identyfikator takiej transakcji w panelu LiqPay kończy się na _prepay: dla zamówienia 123 będzie to 123_prepay.
Drugie konto: „LiqPay (dodatkowy)”
Jeszcze jedna metoda płatności LiqPay z własnymi polami „Klucz publiczny” i „Klucz prywatny”. Pieniądze za takie zamówienia trafiają do innego sklepu w LiqPay — na przykład drugiego FOP-a lub partnera.
Osobno ustawia się tylko klucze, nazwę (dla każdego języka, puste — „LiqPay (dodatkowy)”), „Strefa geograficzna” i miejsce na liście płatności. Walutę, język, metody, typ płatności, statusy, fiskalizację i granice kwoty bierze z głównego.
Paragon fiskalny przez programową kasę LiqPay
Jeśli w LiqPay podłączona jest programowa kasa (PRRO — ukraińska programowa kasa fiskalna), sklep przekazuje skład zamówienia razem z płatnością. LiqPay wystawia paragon fiskalny i wysyła go klientowi na e-mail z zamówienia.
- Podłącz kasę w panelu LiqPay i dodaj do niej wszystkie produkty, które sprzedajesz. Każdy dostanie własny ID LiqPay (liczbę).
- Jeśli dostawa jest płatna, dodaj w kasie także dostawę jako produkt: panel LiqPay → РРО → Каса → Товари (RRO → Kasa → Produkty).
- W bloku „Paragony fiskalne” włącz „Wystawiaj paragony fiskalne”. Pod nim pojawi się pole „ID dostawy w kasie LiqPay” — wpisz w nie ID dostawy i kliknij „Zapisz”.
- Wyślij do wsparcia Elbuz listę „produkt (nazwa lub kod produktu) — ID LiqPay”. Wsparcie powiąże produkty sklepu z kasą. Może też wyeksportować Ci listę produktów, żeby wystarczyło dopisać ID.
1
Wystawiaj paragony fiskalne2
ID dostawy w kasie LiqPay- Włącza paragony fiskalne przez programową kasę LiqPay; pole ID dostawy pojawia się po włączeniu.
- ID dostawy dodanej w kasie LiqPay jako produkt; 0 oznacza, że płatna dostawa nie trafi na paragon.
Paragon jest wystawiany tylko wtedy, gdy w tabeli są wszystkie produkty zamówienia. Brakuje jednego — płatność przejdzie, ale paragonu nie będzie. Nowy produkt od razu dodawaj w kasie LiqPay i przekazuj jego ID do wsparcia.
Kwota paragonu jest równa kwocie płatności. Dostawa idzie osobnym wierszem, a rabaty — kupon, punkty, karta podarunkowa — są rozkładane na produkty co do grosza.
Paragon będzie tylko na produkty, bez dostawy i rabatów, w dwóch przypadkach:
- dostawa jest płatna, a „ID dostawy w kasie LiqPay” to
0; - w zamówieniu są inne kwoty, na przykład podatek lub narzut za metodę płatności.
W pierwszym przypadku po prawej na ekranie pojawi się „Paragony fiskalne są włączone, ale «ID dostawy w kasie LiqPay» nie jest ustawione — płatna dostawa nie trafi na paragon”.
Kasa w samym Elbuz (Vchasno.Kasa, Checkbox) wystawia paragony za płatność przez link i ręcznie: Kasy PRRO w Elbuz.
Zwrot, potwierdzenie blokady, dopłata
Potwierdzenie blokady, zwrot całej kwoty lub części, podgląd danych płatności — przez wsparcie Elbuz: podaj numer zamówienia i co zrobić. Zwrot przy blokadzie oznacza jej zdjęcie. Gdy LiqPay powiadomi sklep o operacji, zamówienie dostanie status z pola „Blokada potwierdzona” lub „Środki zwrócone”.
Dopłacić resztę po przedpłacie albo opłacić zamówienie przyjęte telefonicznie klient może przez link. Tworzy się go w karcie zamówienia w Elbuz przyciskiem „Link do płatności” — na nieopłaconą kwotę. Więcej: Płatność przez link.
Zamówienie ze strony trafia do dokumentów „Zamówienie klienta” w Elbuz. Sposób płatności — „Karta płatnicza” dla głównego LiqPay i „Płatność LiqPay” dla przedpłaty i dodatkowego. Gdy przez główny LiqPay były już zamówienia, nagłówek ekranu pokazuje je za 30 dni: liczbę, kwotę, średnią wartość zamówienia i udział anulowanych lub zwróconych.
Jak sprawdzić płatnością testową
- Pobierz w panelu LiqPay klucze testowe — zaczynają się od
sandbox_. Wpisz je w bloku „Połączenie” i zapisz. - Złóż na stronie zamówienie na siebie, wybierz LiqPay i zapłać kartą testową z dokumentacji LiqPay. Pieniądze nie są pobierane.
- Sprawdź, czy zamówienie dostało status z pola „Opłacone” i trafiło do Elbuz.
- Zamień klucze na produkcyjne i zapisz.
Płatność testowa też ustawia status opłaconego zamówienia. Przed uruchomieniem upewnij się w panelu LiqPay, że sklep jest aktywny, a w module są klucze produkcyjne.
Scenariusze
Elektronika: pobierać dopiero po sprawdzeniu dostępności
„Kiedy pobrać pieniądze” — „Po Twoim potwierdzeniu (blokada)”. Statusy blokady zostaw domyślne albo wybierz własne, aby „Środki zablokowane (blokada)” nie pokrywało się z „Opłacone”.
Towar jest w magazynie — potwierdź blokadę przez wsparcie. Towaru nie ma — blokadę zdejmuje się zwrotem i pieniądze zostają odblokowane.
AGD: drobne — w całości, duże — z przedpłatą
W głównym LiqPay „Maksymalna kwota zamówienia” — 15000. W „LiqPay (przedpłata)” „Minimalna kwota zamówienia” — 15000, „Jak liczyć przedpłatę” — „Stała kwota”, „Wysokość przedpłaty” — 500. Za czajnik klient płaci w całości, za lodówkę — 500 UAH z góry, resztę przy dostawie.
Kawa z telefonu: płatność jednym dotknięciem
„Czym można zapłacić” — Apple Pay, Google Pay i Karta płatnicza. „Gdzie otwierać płatność” — „Widżet na stronie”, „Wygląd widżetu” — „Wbudowany w stronę”. Formularz płatności otwiera się na Twojej stronie, bez przechodzenia na inną.
Produkty i usługi na różnych FOP-ach
Główny LiqPay — klucze pierwszego FOP-a, nazwa „Kartą: produkty”. „LiqPay (dodatkowy)” — klucze drugiego, nazwa „Kartą: usługi”. Klient wybiera sam, a pieniądze trafiają na właściwe konto.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi LiqPay przy składaniu zamówienia | Moduł jest wyłączony, klucze nie są ustawione, kwota jest poza granicami, adres nie należy do strefy lub waluty płatności nie ma wśród walut sklepu | Sprawdź „Włączony”, klucze, „Minimalna kwota zamówienia”, „Maksymalna kwota zamówienia”, „Strefa geograficzna” i „Waluta płatności”, potem „Zapisz” |
| Płatność przeszła, a status się nie zmienił | Klucze w module nie zgadzają się z panelem LiqPay albo statusy nie są wybrane | Wklej klucze jeszcze raz, sprawdź blok „Statusy zamówienia”. Nie pomogło — wsparcie Elbuz sprawdzi dziennik zapytań |
| W panelu LiqPay płatność jest udana, a zamówienie w Elbuz nie ma statusu płatności | Kwota lub waluta płatności nie jest równa kwocie zamówienia: klient opłacił stary formularz, a potem zmienił koszyk, albo zapłacił inną metodą | Porównaj kwotę płatności w panelu LiqPay z kwotą zamówienia i zdecyduj: dopłata, zwrot lub zmiana zamówienia. Nie jest jasne — wsparcie Elbuz sprawdzi dziennik zapytań |
| Płatność przeszła, a paragonu nie ma | Jednego z produktów nie ma w tabeli kasy albo ID LiqPay się nie zgadza | Podaj wsparciu Elbuz numer zamówienia: sprawdzi tabelę i dziennik |
| „Sklep nie przyjął ustawień” lub „Sklep nie przyjął części wartości — zobacz zaznaczone pola” | Sklep nie odpowiedział albo odrzucił poszczególne pola | Popraw zaznaczone pola i zapisz. Jeśli żadne pole nie jest zaznaczone, zmiany pójdą z następnym eksportem |
Najczęstsze pytania
Czy klient może wybrać między pełną płatnością a przedpłatą?
Tak, jeśli obie metody są włączone, a kwota zamówienia mieści się w granicach obu.
Co się stanie, jeśli wyłączę moduł?
LiqPay zniknie ze składania zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Dlaczego nieopłaconego zamówienia nie ma na liście?
Dopóki LiqPay nie potwierdzi płatności, zamówienie jest niepotwierdzone. Jeśli klient wrócił bez zapłaty, zamówienie dostaje status z pola „Płatność nieudana”.
Czy płatność działa, jeśli strona jest zabezpieczona hasłem?
Powiadomienia LiqPay do takiej strony nie dotrą. Moduł sam sprawdzi płatność, gdy klient wróci z LiqPay, ale pewniej jest, gdy strona jest otwarta.
Na liście „Strefa geograficzna” nie ma potrzebnej strefy — co zrobić?
Strefę, na przykład „Ukraina”, tworzy wsparcie Elbuz. Potem wybierz ją w bloku „Gdzie pokazywać”.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → LiqPay
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”
- Przygotuj
- umowę z LiqPay, sklep w panelu LiqPay, klucz publiczny i prywatny
Powiązane tematy
- Jeśli chcesz zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli klient chce dopłacić resztę albo zamówił telefonicznie — Płatność przez link.
- Jeśli paragony wystawiasz kasą w Elbuz — Kasy PRRO w Elbuz.
