Płatność Paysera przenosi klienta na bezpieczną stronę Paysera: karta, jego bank, Apple Pay, Google Pay lub portfel Paysera. Sklep sam poznaje wynik i nadaje zamówieniu status.
Kiedy to się przyda:
- Sprzedajesz na Litwę, Łotwę, do Estonii lub innych krajów UE — klient płaci przez bank swojego kraju.
- Klient płaci przelewem bankowym — w Checkout Classic zamówienie czeka na pieniądze w „Oczekuje na płatność” i samo staje się opłacone.
- Klient zmienił koszyk po przejściu do płatności — płatność innej kwoty nie zmieni statusu na „Opłacone”.
- Trzeba zwrócić część pieniędzy — w Checkout Modern to przycisk w karcie zamówienia Elbuz.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → Paysera → wersja API, klucze i przełącznik „Włączony”.
Co potrafi płatność Paysera
- Przyjmuje płatność na stronie Paysera — karta, bank klienta, Apple Pay, Google Pay, portfel Paysera.
- Działa przez Checkout Classic lub Modern — przełącznik wersji i klucze właśnie dla niej.
- Pozwala sprawdzić płatnością testową — pieniądze nie są pobierane.
- Sama nadaje status zamówieniu — opłacone, pieniądze w drodze, zwrócone.
- Zwraca całą kwotę lub jej część — w Checkout Modern, przyciskiem w karcie zamówienia Elbuz.
Jak podłączyć Paysera
Potrzebujesz umowy Twojej firmy z Paysera, zamówionej usługi przyjmowania płatności online i projektu dla Twojej strony w panelu Paysera. Dopóki Paysera nie zatwierdzi projektu, przechodzą tylko płatności testowe.
- Wybierz wersję. Checkout Classic działa we wszystkich krajach Paysera. Modern — tylko tam, gdzie Paysera już go udostępniła (poniżej).
- Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta Paysera.
- W bloku „Połączenie” wybierz „Wersja API Paysera”. Poniżej zostaną pola kluczy tylko dla tej wersji.
- Wpisz klucze z panelu Paysera. Dla Classic — „ID projektu” i „Hasło projektu”, dla Modern — „ID klienta (Client ID)” i „Sekret klienta (Client Secret)”.
- 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 Paysera2
Znacznik stanu3
Przycisk konfiguracji- Wiersz modułu płatności Paysera.
- Pokazuje, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
- Otwiera ekran konfiguracji Paysera.
1
Przełącznik „Włączony”2
Wersja API Paysera3
Tryb testowy4
ID projektu5
Hasło projektu6
Co jeszcze do skonfigurowania- Po zapisaniu pokazuje Paysera klientom.
- Checkout Classic lub Modern: poniżej zostają klucze tylko wybranej wersji.
- Płatności testowe bez pobierania pieniędzy (tylko Classic).
- Numer projektu z panelu Paysera.
- Tajne hasło projektu: po zapisaniu nie jest pokazywane, widać tylko, że jest ustawione.
- Czego jeszcze brakuje, żeby płatność działała.
Hasło projektu i Client Secret po zapisaniu nie są pokazywane — w polu widać tylko, że są ustawione. Aby je zmienić, kliknij „Zastąp” i wpisz nowe. Bez kluczy wybranej wersji włączony moduł się nie zapisze.
W panelu Paysera nie trzeba wpisywać adresu powiadomień o płatności: moduł przekazuje go z każdą płatnością. Na ekranie dla informacji widać adres wybranej wersji: „Adres powiadomień Classic” lub „Adres powiadomień Modern”.
Jeśli Paysera prosi o potwierdzenie, że strona jest Twoja (metatag verify-paysera), wstaw metatag na stronę samodzielnie: jak wstawić kod usługi na stronę. Jak działa okno w ogóle — w artykule „Ustawienia sklepu”.
Checkout Classic czy Modern
Paysera ma dwie wersje połączenia. Przełącznik „Wersja API Paysera” wybiera, przez którą z nich idzie płatność. Domyślnie — Classic.
| Wersja | Klucze | Gdzie działa | Zwroty |
|---|---|---|---|
| Checkout Classic | ID projektu i hasło projektu | Wszystkie kraje Paysera | Tylko w panelu Paysera |
| Checkout Modern | Client ID i Client Secret projektu | Obecnie Litwa, Łotwa, Estonia, Bułgaria, Kosowo, Macedonia Północna | Cała kwota lub część — w karcie zamówienia Elbuz |
Skąd wziąć klucze Classic
- „ID projektu” — panel Paysera → „Projekty i działalność”: numer obok nazwy projektu. Tylko cyfry, do 11 znaków.
- „Hasło projektu” — Twój projekt → „Ogólne ustawienia projektu”. Podpisuje się nim każdą płatność. Co najmniej 6 znaków, bez spacji.
Skąd wziąć klucze Modern
Panel Paysera → Checkout → Twój projekt → Integrations → API credentials: tam są Client ID i Client Secret. Nie ma tej sekcji w Twoim kraju — zostań przy Classic.
Przycisk „Regenerate credentials” w Paysera od razu unieważnia stary Client Secret. Potem wpisz nowy w sklepie, inaczej płatności przestaną działać.
1
Wersja API Paysera2
ID klienta3
Sekret klienta4
Adres powiadomień Modern- Wybrany jest Checkout Modern, więc zostają tylko pola ID i sekretu klienta.
- Client ID z Integrations → API credentials w panelu Paysera.
- Client Secret z tego samego miejsca; po „Regenerate credentials” w Paysera wpisz tu nowy.
- Moduł sam wysyła ten adres; nie trzeba go wpisywać w Paysera.
Wersję można zmienić w każdej chwili. Nie wpływa to na już przyjęte płatności, nowe idą przez wybraną wersję.
Jak sprawdzić płatnością testową
Płatność testowa przechodzi przez stronę testową Paysera, pieniądze nie są pobierane. Działa też przed zatwierdzeniem projektu.
Checkout Classic
- W panelu Paysera: projekt → „Ogólne ustawienia projektu” → zezwól na płatności testowe.
- Na ekranie modułu zostaw włączony „Tryb testowy”, wpisz klucze, włącz moduł i zapisz.
- Złóż zamówienie na siebie i wybierz Paysera. Przed przejściem pojawi się „Tryb testowy Paysera: pieniądze nie są pobierane.”
- Potwierdź płatność na stronie testowej. Zamówienie trafi do Elbuz ze statusem z pola „Opłacone”.
- Wyłącz „Tryb testowy” i zapisz.
Dopóki tryb testowy jest włączony, po prawej stronie ekranu widać „Włączony tryb testowy — pieniądze nie są pobierane. Wyłącz przed sprzedażą”. Gdy jest wyłączony, płatność testowa nie oznaczy zamówienia jako opłaconego — tak fałszywej płatności nie da się podać za prawdziwą.
Checkout Modern
Przełącznika „Tryb testowy” dla Modern na ekranie nie ma. Tryb testowy włącza się w samym projekcie Paysera: Merchant Portal → projekt → ⋮ → Enable Test Mode. Karty testowe — w pomocy Paysera dla programistów.
Co widzi klient i dla jakich zamówień
Przy składaniu zamówienia metoda nazywa się „Paysera: karta, bank, Apple Pay, Google Pay”. Po potwierdzeniu klient widzi „Przechodzimy na stronę płatności Paysera…” i trafia na stronę Paysera.
| Co się stało | Dokąd wraca klient |
|---|---|
| Zapłacił | Strona „Twoje zamówienie zostało przyjęte!” |
| Anulował płatność | Składanie zamówienia z komunikatem „Płatność anulowano. Możesz zapłacić ponownie lub wybrać inną metodę płatności.” Koszyk zostaje zachowany |
| Nie dokończył płatności | Składanie zamówienia z komunikatem „Płatność nie została zakończona…”: można spróbować ponownie lub wybrać inną metodę |
Jakie metody płatności są widoczne na stronie Paysera, zależy od Twojej umowy z Paysera i kraju klienta. Kwota idzie w walucie zamówienia. Czy Twój projekt przyjmuje tę walutę, sprawdź w Paysera.
Język strony to główny język sklepu, jeśli Paysera go obsługuje, a nie język wybrany przez klienta. Classic zna rosyjski, niemiecki, polski, litewski, łotewski, estoński i bułgarski, Modern — litewski. Dla pozostałych, także dla ukraińskiego, — angielski.
Dla jakich zamówień pokazywać
Blok „Gdzie pokazywać” ogranicza, komu Paysera jest widoczna:
- „Strefa geograficzna” — płatność tylko dla klientów z adresem w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Minimalna kwota zamówienia” — Paysera pojawia się od tej kwoty w głównej walucie sklepu. Puste lub
0— zawsze. Kwoty maksymalnej nie ma. - „Kolejność sortowania” — miejsce na liście płatności, mniejsza liczba jest wyżej.
Statusy zamówienia
Status nadaje sam sklep, gdy Paysera powiadamia o płatności. Jakie dokładnie — wybierasz w bloku „Statusy zamówienia”.
1
Opłacone2
Oczekuje na płatność3
Zwrócone- Nadawany, gdy Paysera potwierdzi płatność pełnej kwoty.
- Pieniądze są jeszcze w drodze (przelew bankowy) albo klient wrócił przed potwierdzeniem.
- Nadawany po pełnym zwrocie w Checkout Modern.
| Pole | Kiedy jest nadawany | Domyślnie |
|---|---|---|
| Opłacone | Paysera potwierdziła płatność pełnej kwoty zamówienia. Klient dostaje zwykły e-mail o zamówieniu | „W realizacji” |
| Oczekuje na płatność | Klient zapłacił przelewem bankowym, pieniądze są jeszcze w drodze (Classic). Albo klient wrócił z Paysera przed potwierdzeniem | „Oczekujące” |
| Zwrócone | Klientowi zwrócono całą kwotę (tylko Modern) | „Zwrócono środki” |
Dopóki klient nie zapłaci, zamówienie pozostaje niepotwierdzone. Ponowna próba płatności nie tworzy dodatkowego zamówienia.
Zamówienie z przelewem w drodze ma status z pola „Oczekuje na płatność” — nie wysyłaj go. Gdy Paysera potwierdzi wpływ pieniędzy, moduł sam ustawi „Opłacone”.
Jeśli „Opłacone” i „Oczekuje na płatność” są takie same, po prawej pojawi się „Statusy „Opłacone” i „Oczekuje na płatność” są takie same — przelewu w drodze nie odróżnisz od płatności”. Wybierz różne.
Kiedy status się nie zmienia
- Inna kwota. Klient zmienił koszyk po przejściu do płatności i zapłacił starą kwotę. Płatność widać w panelu Paysera: uzgodnij z klientem dopłatę albo zwróć pieniądze.
- Druga płatność. Klient zapłacił za już opłacone zamówienie. Nadmiarową płatność widać w panelu Paysera — zwróć ją.
- Płatność testowa w trybie produkcyjnym (Classic). „Tryb testowy” jest wyłączony — płatność testowa zostaje odrzucona.
- Fałszywe powiadomienie. Moduł sprawdza podpis Paysera, kwotę i walutę, a w Classic — także numer projektu. Obce powiadomienie nie zmieni zamówienia.
Zwrot pieniędzy w karcie zamówienia
Zamówienie ze strony trafia do dokumentów „Zamówienie klienta” w Elbuz ze sposobem płatności „Karta płatnicza”. W jego karcie jest blok „Płatność w Paysera”: stan płatności, kwota, ile pobrano i zwrócono. Tam też widać, ile jeszcze można zwrócić, oraz wszystkie próby płatności z numerem w Paysera.
| Wersja | Jak zwrócić | Co stanie się z zamówieniem |
|---|---|---|
| Checkout Modern | Przyciskiem „Zwróć środki” w bloku „Płatność w Paysera”. Można zwrócić całą kwotę lub część, kilka razy, ale nie więcej, niż zostało | Częściowy — status bez zmian, zwróconą kwotę widać w bloku. Pełny — status z pola „Zwrócone” |
| Checkout Classic | Tylko w panelu Paysera: blok w karcie tylko pokazuje płatność, przycisków nie ma | Status zmień samodzielnie |
W Checkout Modern widać tylko przyciski dostępne teraz dla zamówienia:
| Przycisk | Co robi |
|---|---|
| Zwróć środki | Zwraca klientowi całą kwotę lub jej część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę |
| Odśwież status | Pobiera stan płatności z Paysera, jeśli powiadomienie nie dotarło |
Paysera realizuje zwrot przez kilka minut: kwota w drodze nie wlicza się już do „Do zwrotu”. Sklep nie wysyła klientowi e-maila o zwrocie.
Przed zwrotem program prosi o potwierdzenie z ostrzeżeniem „Tej operacji nie można cofnąć.”. Status zamówienia zmienia się tak samo jak po powiadomieniu Paysera, a w historii zamówienia pojawia się wpis z wynikiem.
Gdy sklep nie odpowie, program napisze „Nie wiadomo, czy operacja przeszła…” i pokaże „Powtórz”. Powtarza on tę samą operację: pieniądze nie zostaną przesunięte drugi raz. Ponowne kliknięcie przycisku to już nowa operacja.
Zwracać pieniądze może tylko użytkownik z uprawnieniem „Operacje płatności: zwrot, blokada, kredyt” — domyślnie właściciel. „Odśwież status” jest dostępne dla każdego, kto widzi zamówienie.
Gdy przez Paysera były już zamówienia, nagłówek ekranu modułu pokazuje je za 30 dni: liczbę, kwotę, średnią wartość zamówienia i udział anulowanych lub zwróconych.
Scenariusze
AGD: klienci z Litwy płacą przez swój bank
Zawrzyj umowę z Paysera, wpisz „ID projektu” i „Hasło projektu”. „Kolejność sortowania” — 1, żeby Paysera była pierwsza. Klient widzi na stronie Paysera banki swojego kraju, a pralka sama staje się opłacona.
Drogi telewizor opłacony przelewem bankowym
Sklep działa na Checkout Classic. W „Oczekuje na płatność” wybierz status, przy którym magazyn nie wysyła. Telewizor nie wyjedzie, dopóki moduł nie ustawi „Opłacone” — a stanie się to, gdy tylko Paysera potwierdzi wpływ pieniędzy.
Kwiaty: drobne zamówienia — gotówką
Prowizja Paysera zjada marżę na drobnych zamówieniach. „Minimalna kwota zamówienia” — 20: Paysera pojawia się przy składaniu zamówienia dopiero od 20 w głównej walucie sklepu.
Ekspres do kawy z filiżankami: zwrot tylko za filiżanki
Sklep działa na Checkout Modern. Klient zwraca filiżanki z zestawu — w karcie zamówienia kliknij „Zwróć środki” i wpisz wartość filiżanek. Paysera zwróci część, status pozostanie opłacony, panelu Paysera nie trzeba otwierać.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi Paysera przy składaniu zamówienia | Moduł jest wyłączony, brak kluczy wybranej wersji, kwota jest mniejsza od minimalnej albo adres jest poza strefą geograficzną | Sprawdź „Włączony”, klucze, „Minimalna kwota zamówienia” i „Strefa geograficzna”, potem „Zapisz” |
| Classic: Paysera pokazuje błąd zamiast strony płatności | Błędne ID projektu lub hasło, projekt nie jest jeszcze zatwierdzony albo płatności testowe w projekcie nie są dozwolone | Wklej klucze z panelu jeszcze raz. Do testu zezwól na płatności testowe w projekcie Paysera |
| Modern: klient widzi „Nie udało się otworzyć strony płatności” | Błędne Client ID lub Client Secret albo wygenerowano je ponownie w Paysera | Wpisz aktualne klucze z Integrations → API credentials i zapisz |
| Płatność przeszła, a status się nie zmienił | Powiadomienia Paysera nie docierają: strona jest zamknięta hasłem lub ochroną przed botami | Odblokuj dla Paysera adres powiadomień z bloku „Połączenie”. W Modern kliknij „Odśwież status” w karcie tego zamówienia w Elbuz. Nie pomogło — wsparcie Elbuz sprawdzi dziennik modułu |
| Classic: płatność testowa nie oznaczyła zamówienia jako opłaconego | „Tryb testowy” w module jest wyłączony | Na czas sprawdzenia włącz go, po sprawdzeniu wyłącz |
| „Sklep nie przyjął ustawień” lub „Sklep nie przyjął części wartości — zobacz zaznaczone pola” | Sklep nie odpowiedział albo odrzucił niektóre pola | Popraw zaznaczone pola i zapisz. Jeśli pola nie są zaznaczone, zmiany pójdą z następnym eksportem |
Najczęstsze pytania
Czy Paysera można podłączyć w sklepie z Ukrainy?
Moduł działa z każdym projektem Paysera. Czy Paysera zawrze umowę z Twoją firmą i jakie metody płatności udostępni, decyduje Paysera.
Co się stanie, jeśli wyłączę moduł?
Paysera zniknie z formularza zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Czy można wysłać klientowi link do płatności Paysera z Elbuz?
Nie. Link do płatności z karty zamówienia działa z innymi usługami: Płatność przez link.
Na liście „Strefa geograficzna” nie ma potrzebnej strefy — co zrobić?
Strefę, na przykład „Litwa”, tworzy wsparcie Elbuz. Potem wybierz ją w bloku „Gdzie pokazywać”.
Czy to to samo co Paysera Delivery?
Nie. Paysera Delivery (automaty paczkowe i kurierzy) to osobny moduł sekcji „Dostawa” z własnymi ustawieniami.
Jak zwrócić pieniądze klientowi?
W Checkout Modern otwórz zamówienie w Elbuz i w bloku „Płatność w Paysera” kliknij „Zwróć środki”. W Checkout Classic zwróć pieniądze w panelu Paysera i samodzielnie zmień status zamówienia. Sklep nie wysyła klientowi e-maila o zwrocie.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → Paysera
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”; zwroty — uprawnienie „Operacje płatności: zwrot, blokada, kredyt”
- Przygotuj
- umowę z Paysera, projekt w panelu Paysera, klucze wybranej wersji
Powiązane tematy
- Jeśli trzeba zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli sprzedajesz także na Ukrainie — Jak przyjmować płatności LiqPay w sklepie.
- Jeśli trzeba obsłużyć opłacone zamówienie w Elbuz — Zamówienie klienta.
