Płatność RozetkaPay działa prosto z formularza zamówienia: klient przechodzi na stronę RozetkaPay, płaci kartą, Apple Pay lub Google Pay, a zamówienie samo staje się opłacone. W ustawieniach sklepu w Elbuz wystarczy wpisać login i hasło od RozetkaPay.
Kiedy to się przyda:
- Potrzebna jest płatność kartą na stronie — status zamówienia zmienia się sam.
- Umowy jeszcze nie ma, a chcesz sprawdzić — tryb testowy działa z publicznymi kluczami testowymi RozetkaPay.
- Towar wysyła dostawca — płatność dwuetapowa blokuje pieniądze, a pobierasz je przyciskiem w zamówieniu.
- Klient zwrócił towar — zwrot wykonuje się z karty zamówienia w Elbuz.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → karta RozetkaPay → login, hasło i „Włączony”.
Co potrafi płatność RozetkaPay
- Przyjmuje płatności — karty Visa i Mastercard, Apple Pay, Google Pay na stronie RozetkaPay.
- Tryb testowy — płatność kartą testową bez umowy i bez pieniędzy.
- Blokada środków — pieniądze są blokowane i pobierane po Twoim potwierdzeniu.
- Zwraca pieniądze i zarządza blokadą — przyciskami w karcie zamówienia w Elbuz.
- Sama sprawdza klucze — po zapisaniu na ekranie widać, czy RozetkaPay je przyjmuje.
Jak podłączyć RozetkaPay
Potrzebujesz umowy z RozetkaPay (rejestracja — business.rozetkapay.com). Po podłączeniu RozetkaPay przysyła login i hasło do API. Nie ma e-maila — poproś wsparcie RozetkaPay o login i hasło do integracji.
- Otwórz ekran modułu. „Ustawienia sklepu” → „Zamówienie i płatność” → karta RozetkaPay.
- Wyłącz „Tryb testowy” w bloku „Połączenie”. Domyślnie jest włączony.
- Wpisz „Login” i „Hasło” z e-maila od RozetkaPay.
- Włącz przełącznik „Włączony” u góry ekranu i kliknij „Zapisz”.
1
Przełącznik „Włączony”2
Przełącznik trybu testowego3
Pole loginu4
Znacznik trybu- „Włączony” — po zapisaniu pokazuje RozetkaPay klientom.
- „Tryb testowy” — klucze testowe i płatności bez prawdziwych pieniędzy; wyłącz przed sprzedażą.
- „Login” — login wydany przez RozetkaPay; widoczne pola należą do bieżącego trybu.
- Znacznik trybu — pokazuje, w jakim trybie płatność działa w tej chwili.
W ciągu kilku minut sklep sam zapyta RozetkaPay, czy klucze pasują. W bloku „Połączenie” pojawi się wiersz „Klucze RozetkaPay działają” lub „RozetkaPay nie przyjmuje kluczy” z datą sprawdzenia i przyczyną.
W trybie testowym — „Klucze testowe RozetkaPay działają” lub „RozetkaPay nie przyjmuje kluczy testowych”. Nie ma wiersza — moduł jest wyłączony albo dla bieżących ustawień nie było jeszcze sprawdzenia.
Każdy tryb ma własne klucze: widać parę włączonego trybu. Hasło po zapisaniu nie jest pokazywane. Bez loginu i hasła bieżącego trybu włączony moduł się nie zapisze.
Płatność jest przyjmowana tylko w hrywnach. Ceny w innej walucie są przeliczane po kursie hrywny w sklepie. Nie ma hrywny wśród walut sklepu — RozetkaPay nie pojawi się w formularzu zamówienia.
„Adres powiadomień” na ekranie jest tylko informacyjny: moduł sam przekazuje go RozetkaPay z każdą płatnością, w panelu RozetkaPay nie trzeba niczego wpisywać.
Jak sprawdzić płatnością testową
- Włącz „Tryb testowy”. W „Login testowy” i „Hasło testowe” wklej klucze z dokumentacji RozetkaPay: docs.rozetkapay.com → Sandbox → Credentials, wiersz Hosted checkout.
- Włącz „Włączony” i zapisz. Dopóki tryb testowy jest włączony, po prawej widać „Włączony tryb testowy — pieniądze nie są pobierane. Wyłącz przed sprzedażą”.
- Złóż zamówienie na stronie, wybierz „Płatność kartą przez RozetkaPay” i zapłać kartą testową z dokumentacji RozetkaPay.
- W historii zamówienia pojawi się „RozetkaPay: opłacono … [TEST]”.
- Wyłącz „Tryb testowy”, wpisz klucze produkcyjne i zapisz.
Klucze i karty testowe zna każdy. Dopóki tryb testowy jest włączony, zamówienie można „opłacić” bez pieniędzy. Wyłącz go przed sprzedażą.
Po wyłączeniu trybu testowego płatności testowe nie zmieniają już zamówienia, a operacje na nich w karcie zamówienia nie są wykonywane.
Co widzi klient
- Przy składaniu zamówienia — metoda „Płatność kartą przez RozetkaPay” z podpowiedzią o Visa, Mastercard, Apple Pay i Google Pay.
- Po potwierdzeniu — „Przechodzimy na stronę płatności RozetkaPay…” i strona płatności w języku strony sklepu: ukraińskim, polskim lub angielskim. Z wersji rosyjskiej — po ukraińsku, z innych — po angielsku.
- Zapłacił — wraca na stronę złożonego zamówienia.
- Nie zapłacił i wrócił ze strony płatności — trafia do formularza zamówienia z komunikatem. Koszyk zostaje zachowany, można zapłacić ponownie lub wybrać inną metodę.
Ponowna próba płatności nie tworzy nowego zamówienia. W panelu RozetkaPay próby jednego zamówienia mają numery „123”, „123-2”, „123-3”; testowe — „123-t…”.
Blok „Gdzie pokazywać” ogranicza, komu widać RozetkaPay: „Strefa geograficzna” (domyślnie „Wszystkie strefy”) i „Kolejność” — miejsce na liście płatności.
Blokada i statusy zamówienia
| Płatność dwuetapowa | Co z pieniędzmi | Dla kogo |
|---|---|---|
| Wyłączona (domyślnie) | Pobierane od razu | Towar jest w magazynie, wysyłka od razu |
| Włączona | Blokowane na karcie; pobierasz je lub zdejmujesz blokadę przyciskiem w zamówieniu | Towar wysyła dostawca, trzeba sprawdzić dostępność |
Status nadaje sam sklep, gdy RozetkaPay powiadamia o zdarzeniu. Jakie dokładnie — wybierasz w bloku „Statusy zamówienia” spośród statusów strony.
| Pole | Kiedy jest nadawany |
|---|---|
| Opłacone | Płatność przeszła lub blokadę pobrano. Płatność testowa też |
| Środki zablokowane | Pieniądze są zablokowane i czekają na potwierdzenie. Pole jest widoczne tylko przy włączonej płatności dwuetapowej |
| Zwrócono | Pełny zwrot lub zdjęta blokada. „Nie zmieniaj” — status zostaje, w historii pojawia się wpis |
Częściowy zwrot nie zmienia statusu — tylko wpis w historii „RozetkaPay: częściowy zwrot, łącznie zwrócono …”.
Dopóki klient nie zapłaci, zamówienie pozostaje niepotwierdzone i nie jest uznawane za nowe.
„Opłacone” lub blokada są nadawane tylko wtedy, gdy kwota płatności jest równa obecnej kwocie zamówienia. W przeciwnym razie w historii pojawi się „RozetkaPay: opłacono …, a kwota zamówienia wynosi teraz … Status nie został zmieniony — sprawdź płatność w panelu RozetkaPay.”
Zwrot i blokada 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 RozetkaPay”: stan płatności, kwota, ile pobrano i zwrócono, ile jeszcze można zwrócić, oraz wszystkie próby płatności z numerem w RozetkaPay.
Widać tylko przyciski dostępne teraz dla zamówienia:
| Przycisk | Co robi |
|---|---|
| Zwróć środki | Zwraca klientowi całą kwotę lub część: pole kwoty jest już wypełnione pozostałą kwotą, przy częściowym zwrocie wpisz mniejszą |
| Pobierz blokadę | Pobiera zablokowaną kwotę albo mniejszą, jeśli części towaru brakuje. Resztę blokady RozetkaPay zwraca klientowi |
| Zdejmij blokadę | Anuluje blokadę, pieniądze wracają do klienta |
| Odśwież status | Pobiera stan płatności z RozetkaPay, jeśli powiadomienie nie dotarło |
Przed każdą operacją na pieniądzach program prosi o potwierdzenie; przy zwrocie i zdjęciu blokady — z ostrzeżeniem „Tej operacji nie można cofnąć.”. Status zamówienia na stronie zmienia się tak samo jak po powiadomieniu RozetkaPay, a w historii zamówienia w Elbuz pojawia się wpis z wynikiem.
Gdy sklep nie odpowie, pod komunikatem pojawi się „Powtórz”: powtarza on tę samą operację, a pieniądze nie są przesuwane drugi raz. Ponowne kliknięcie przycisku to już nowa operacja.
Zwracać pieniądze i zarządzać blokadą 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.
Scenariusze
AGD z magazynu dostawcy
Włącz „Płatność dwuetapowa”. Pieniądze klienta są zablokowane, dopóki dostawca nie potwierdzi dostępności. Towar jest — „Pobierz blokadę”, nie ma — „Zdejmij blokadę”, a klient nie czeka tygodniami na zwrot.
Elektronika: część zamówienia się skończyła
Przy płatności dwuetapowej kliknij „Pobierz blokadę” i wpisz kwotę za to, co wysyłasz. Resztę blokady RozetkaPay sam zwraca klientowi.
Odzież z częstymi zwrotami
Wyłącz płatność dwuetapową: klient płaci od razu. Zwrócił jedną rzecz — „Zwróć środki” na kwotę tej rzeczy, status zamówienia się nie zmieni.
Sklep sprzedaje także w Polsce
Ogranicz RozetkaPay „Strefą geograficzną” „Ukraina”. Polscy klienci widzą swoje metody płatności, a RozetkaPay — tylko zamówienia w hrywnach na Ukrainie.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi RozetkaPay w formularzu zamówienia | Moduł jest wyłączony, brak kluczy bieżącego trybu, adres jest poza „Strefą geograficzną” albo wśród walut sklepu nie ma hrywny | Sprawdź „Włączony”, klucze, „Strefę geograficzną” i waluty sklepu, potem „Zapisz” |
| „RozetkaPay nie przyjmuje kluczy” lub „…kluczy testowych” | Klucze skopiowano nie w całości lub nie dla tego trybu: testowe działają tylko w trybie testowym, produkcyjne — bez niego | Wklej login i hasło jeszcze raz, bez spacji, i zapisz. Wynik — po kilku minutach |
| Płatność przeszła, a status się nie zmienił | Powiadomienie RozetkaPay nie dotarło, na przykład strona jest bez HTTPS | Kliknij „Odśwież status” w karcie zamówienia. Status zaktualizuje się też wtedy, gdy klient wróci na stronę |
| „RozetkaPay: opłacono …, a kwota zamówienia wynosi teraz …” | Klient opłacił starą próbę, a potem zmienił koszyk | Sprawdź płatność w panelu RozetkaPay i zdecyduj: dopłata, zwrot czy zmiana zamówienia |
| Operacja na płatności testowej nie jest wykonywana | Tryb testowy jest już wyłączony | Płatności testowe istnieją tylko w trybie testowym; nie ma w nich prawdziwych pieniędzy |
Najczęstsze pytania
Czy można przyjmować płatności w euro lub dolarach?
Nie, RozetkaPay przyjmuje tylko hrywny. Kwota zamówienia w innej walucie jest przeliczana po kursie hrywny w sklepie.
Czy trzeba coś wpisywać w panelu RozetkaPay?
Nie. Adres powiadomień moduł sam przekazuje z każdą płatnością.
Co się stanie, jeśli wyłączę moduł?
RozetkaPay zniknie z formularza zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Czy klient dostaje e-mail po zwrocie?
Tak, jeśli status zmienia się na wybrany w polu „Zwrócono”: klient dostaje zwykły e-mail o zmianie statusu. Przy częściowym zwrocie i „Nie zmieniaj” e-maila nie ma — tylko wpis w historii zamówienia.
Klient dwa razy kliknął „Zapłać” — będą dwie płatności?
Nie. Dopóki strona płatności jest aktywna, ponowna próba otwiera tę samą; nowa próba dostaje własny numer i nie tworzy nowego zamówienia.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → RozetkaPay
- Inne wejścia
- karta zamówienia klienta — blok „Płatność w RozetkaPay”
- Uprawnienia
- okno „Ustawienia sklepu”; dla zwrotów i blokady — „Operacje płatności: zwrot, blokada, kredyt”
- Przygotuj
- umowę z RozetkaPay, login i hasło do API, hrywnę wśród walut sklepu
Powiązane tematy
- Jeśli trzeba zrozumieć, jak działa okno ustawień sklepu — Jak skonfigurować sklep i moduły Elbuz CMS w programie.
- Jeśli potrzebna jest przedpłata części kwoty lub paragon fiskalny — Jak przyjmować płatności LiqPay w sklepie.
- Jeśli klient chce dopłacić lub zamówił telefonicznie — Płatność przez link.
