↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak przyjmować płatności Paysera w sklepie

    6 min czytaniaZaktualizowano

    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

    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.

    1. Wybierz wersję. Checkout Classic działa we wszystkich krajach Paysera. Modern — tylko tam, gdzie Paysera już go udostępniła (poniżej).
    2. Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta Paysera.
    3. W bloku „Połączenie” wybierz „Wersja API Paysera”. Poniżej zostaną pola kluczy tylko dla tej wersji.
    4. Wpisz klucze z panelu Paysera. Dla Classic — „ID projektu” i „Hasło projektu”, dla Modern — „ID klienta (Client ID)” i „Sekret klienta (Client Secret)”.
    5. Włącz przełącznik „Włączony” u góry ekranu.
    6. Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu: na dole pojawi się „Zapisano i zastosowano w sklepie”.
    Sekcja „Zamówienie i płatność” z listą modułów płatności, w tym Paysera
    1Wiersz Paysera
    2Znacznik stanu
    3Przycisk konfiguracji
    1. Wiersz modułu płatności Paysera.
    2. Pokazuje, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
    3. Otwiera ekran konfiguracji Paysera.
    Okno konfiguracji Paysera, zmaksymalizowane, z blokiem „Połączenie” i prawą kolumną stanu
    1Przełącznik „Włączony”
    2Wersja API Paysera
    3Tryb testowy
    4ID projektu
    5Hasło projektu
    6Co jeszcze do skonfigurowania
    1. Po zapisaniu pokazuje Paysera klientom.
    2. Checkout Classic lub Modern: poniżej zostają klucze tylko wybranej wersji.
    3. Płatności testowe bez pobierania pieniędzy (tylko Classic).
    4. Numer projektu z panelu Paysera.
    5. Tajne hasło projektu: po zapisaniu nie jest pokazywane, widać tylko, że jest ustawione.
    6. 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.

    WersjaKluczeGdzie działaZwroty
    Checkout ClassicID projektu i hasło projektuWszystkie kraje PayseraTylko w panelu Paysera
    Checkout ModernClient ID i Client Secret projektuObecnie Litwa, Łotwa, Estonia, Bułgaria, Kosowo, Macedonia PółnocnaCał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ć.

    Blok „Połączenie” ekranu Paysera z wybranym Checkout Modern
    1Wersja API Paysera
    2ID klienta
    3Sekret klienta
    4Adres powiadomień Modern
    1. Wybrany jest Checkout Modern, więc zostają tylko pola ID i sekretu klienta.
    2. Client ID z Integrations → API credentials w panelu Paysera.
    3. Client Secret z tego samego miejsca; po „Regenerate credentials” w Paysera wpisz tu nowy.
    4. 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

    1. W panelu Paysera: projekt → „Ogólne ustawienia projektu” → zezwól na płatności testowe.
    2. Na ekranie modułu zostaw włączony „Tryb testowy”, wpisz klucze, włącz moduł i zapisz.
    3. Złóż zamówienie na siebie i wybierz Paysera. Przed przejściem pojawi się „Tryb testowy Paysera: pieniądze nie są pobierane.”
    4. Potwierdź płatność na stronie testowej. Zamówienie trafi do Elbuz ze statusem z pola „Opłacone”.
    5. 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łoDoką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ściSkł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”.

    Blok „Statusy zamówienia” z polami „Opłacone”, „Oczekuje na płatność” i „Zwrócone”
    1Opłacone
    2Oczekuje na płatność
    3Zwrócone
    1. Nadawany, gdy Paysera potwierdzi płatność pełnej kwoty.
    2. Pieniądze są jeszcze w drodze (przelew bankowy) albo klient wrócił przed potwierdzeniem.
    3. Nadawany po pełnym zwrocie w Checkout Modern.
    PoleKiedy jest nadawanyDomyślnie
    OpłaconePaysera 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óconeKlientowi 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.

    WersjaJak zwrócićCo stanie się z zamówieniem
    Checkout ModernPrzyciskiem „Zwróć środki” w bloku „Płatność w Paysera”. Można zwrócić całą kwotę lub część, kilka razy, ale nie więcej, niż zostałoCzęściowy — status bez zmian, zwróconą kwotę widać w bloku. Pełny — status z pola „Zwrócone”
    Checkout ClassicTylko w panelu Paysera: blok w karcie tylko pokazuje płatność, przycisków nie maStatus zmień samodzielnie

    W Checkout Modern widać tylko przyciski dostępne teraz dla zamówienia:

    PrzyciskCo robi
    Zwróć środkiZwraca klientowi całą kwotę lub jej część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę
    Odśwież statusPobiera 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 widziszDlaczego tak jestCo 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

    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