Płatności internetowe monobank (Plata by mono) przyjmują zapłatę od razu po złożeniu zamówienia. Klient płaci kartą dowolnego banku, Apple Pay lub Google Pay na stronie monobank, a zamówienie samo staje się opłacone. Wystarczy wpisać token z panelu monobank w ustawieniach sklepu w Elbuz.
Kiedy to się przyda:
- Masz konto FOP lub TOV w monobank — pieniądze ze strony trafiają na nie, a status zamówienia zmienia się sam.
- Dostępność trzeba najpierw sprawdzić — blokada zamraża pieniądze na karcie, a pobranie następuje, gdy potwierdzisz.
- Na paragonie monobank potrzebny jest skład zamówienia — moduł przekazuje produkty, dostawę i rabaty.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → karta monobank → token i przełącznik „Włączony”.
Co potrafi płatność monobank
- Przyjmować płatność na stronie monobank — karta dowolnego banku, Apple Pay, Google Pay.
- Blokada — pieniądze są blokowane na karcie i pobierane po Twoim potwierdzeniu.
- Samodzielnie ustawiać status zamówienia — opłacone, blokada, zwrócone.
- Przekazywać skład zamówienia — produkty widać na stronie płatności i na paragonie fiskalnym monobank.
- Zwracać pieniądze — całą kwotę lub w częściach.
Jak podłączyć płatności internetowe monobank
Potrzebujesz konta FOP (ukraińska jednoosobowa działalność) lub TOV (ukraińska spółka z o.o.) w monobank z podłączonymi płatnościami internetowymi. Warunki i prowizję podaje bank.
- Pobierz token. W panelu web.monobank.ua otwórz «Інтернет-еквайринг» (płatności internetowe) → klucze i skopiuj token (X-Token). Jest tajny — nikomu go nie przesyłaj.
- Otwórz ekran modułu. „Ustawienia sklepu” → dział „Zamówienie i płatność” → karta monobank.
- Wklej token w pole „Token (X-Token)” w bloku „Połączenie”.
- 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
Moduł „Płatności monobank”2
Znacznik stanu modułu- „Płatności monobank” — otwiera ekran ustawień płatności monobank.
- Znacznik stanu i przełącznik — pokazują, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
1
Przełącznik „Włączony”2
Token (X-Token)3
Adres URL webhooka4
Co jeszcze do skonfigurowania5
Plakietka stanu- Po zapisaniu pokazuje monobank klientom.
- Token z panelu monobank; po zapisaniu widać tylko znacznik, że jest ustawiony.
- Adres powiadomień banku; moduł przekazuje go sam, nic nie trzeba wpisywać.
- Czego jeszcze brakuje, żeby płatności działały.
- Stan modułu w sklepie.
Bez tokenu włączony moduł się nie zapisze: pod polem pojawi się „Wymagane — bez tego moduł nie zadziała”. Tokenu krótszego niż 20 znaków lub ze spacjami ekran nie przyjmie. Po zapisaniu token nie jest pokazywany — aby go zmienić, kliknij „Zamień” i wklej nowy.
W panelu monobank nic nie trzeba wpisywać: adres powiadomień o płatności moduł sam przekazuje z każdym rachunkiem. Jest pokazany w bloku „Połączenie” jako „Adres URL webhooka” — na wypadek, gdyby bank o niego poprosił.
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ń
Na liście płatności klient widzi „Płatność kartą przez monobank” z podpowiedzią o Visa, Mastercard, Apple Pay i Google Pay. Po potwierdzeniu zamówienia — krótkie „Otwieramy stronę płatności monobank…” i sama strona banku.
- Zapłacił — wraca na stronę udanego zamówienia.
- Nie zapłacił — wraca do składania zamówienia z komunikatem „Płatność nie została zrealizowana. Spróbuj ponownie lub wybierz inną metodę płatności.” i przyczyną od banku. Koszyk i dane zostają zachowane.
- Strona banku się nie otworzyła — „Nie udało się otworzyć strony płatności…” i przycisk „Zapłać”, żeby spróbować ponownie.
Rachunek do zapłaty jest ważny 24 godziny. Ponowna próba w ciągu doby otwiera ten sam rachunek, jeśli kwota zamówienia się nie zmieniła.
Pola bloku „Płatność”
1
Tryb pobierania2
Waluta płatności3
Przekazuj zawartość koszyka4
Kod produktu na paragonie- Pobrać pieniądze od razu lub zablokować je do Twojego potwierdzenia.
- Waluta, na którą przeliczana jest kwota zamówienia.
- Produkty, dostawa i rabaty na stronie płatności i na paragonie.
- Które pole produktu trafia na paragon jako kod.
| Pole | Co robi | Domyślnie |
|---|---|---|
| Tryb pobierania | „Pobierz od razu” lub „Zablokuj środki, pobierz później” (blokada) | Pobierz od razu |
| Waluta płatności | UAH, USD lub EUR. Kwota zamówienia jest na nią przeliczana po kursie sklepu. USD i EUR — tylko jeśli bank je dla Ciebie włączył | UAH |
| Przekazuj zawartość koszyka | Skład zamówienia na stronie płatności i na paragonie monobank — co dokładnie idzie | włączone |
| Kod produktu na paragonie | Tylko z zawartością koszyka: model, SKU, ID produktu w sklepie, kod kreskowy UPC lub EAN, ISBN albo kod producenta (MPN) | Model |
| Paragon na e-mail kupującego | monobank wyśle potwierdzenie na e-mail z zamówienia | wyłączone |
Walutę płatności sklep bierze ze swoich walut. Nie ma jej w sklepie — klienci nie zobaczą monobank. Waluty i kursy trafiają do sklepu z okna „Waluty” w Elbuz, jeśli w wierszu waluty zaznaczone są „Aktywność” i „Eksport na stronę”: Kursy walut.
Skład zamówienia na paragonie
Produkty idą w cenie z podatkiem, razem ze zdjęciem. Dostawa i inne dopłaty — osobnymi wierszami, rabaty są rozkładane na produkty. Jeśli pole kodu w produkcie jest puste, zamiast niego pójdzie ID produktu.
Jeśli rabat jest większy, niż da się rozłożyć na produkty, rachunek pójdzie bez składu — samą kwotą. Paragon fiskalny ze składem wystawia monobank, jeśli podłączysz w banku fiskalizację.
Dla jakich zamówień pokazywać
- „Strefa geograficzna” w bloku „Gdzie pokazywać” — płatność tylko dla klientów z adresem dostawy w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Kolejność sortowania” — miejsce na liście płatności, mniejsza liczba stoi wyżej.
- „Tytuł płatności” w zwiniętym bloku „Dodatkowe” — tekst w płatności.
%sjest zamieniane na numer zamówienia. Puste — „Płatność za zamówienie nr” i numer. - „Dziennik zapytań do banku” w tym samym miejscu — zapisuje zapytania do monobank i odpowiedzi banku dla wsparcia. Domyślnie wyłączony, token nie trafia do dziennika.
Własną nazwę, opis i minimalną kwotę produktów w koszyku dla tej metody ustawia wsparcie Elbuz. Poniżej minimalnej kwoty klient widzi metodę jako nieaktywną: „Płatność «…» dostępna od …”.
Blokada i statusy zamówienia
Pobrać od razu czy zablokować
Służy do tego pole „Tryb pobierania” w bloku „Płatność”.
| Tryb pobierania | Co dzieje się z pieniędzmi | Dla kogo |
|---|---|---|
| Pobierz od razu | Są pobierane od razu | Towar jest w magazynie, wysyłka od razu |
| Zablokuj środki, pobierz później | Są blokowane na karcie; pobierane, gdy potwierdzisz blokadę | Towar wysyła dostawca, dostępność trzeba sprawdzić |
Przy blokadzie w bloku „Statusy zamówienia” pojawia się pole „Środki zablokowane”. Jeśli pokrywa się z „Opłacone”, po prawej pojawi się „Statusy «Opłacone» i «Środki zablokowane» 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 monobank. Potwierdzaj blokadę, gdy tylko towar jest dostępny.
Jakie statusy są ustawiane
Status ustawia sam sklep, gdy monobank powiadamia o płatności. Które dokładnie — wybierasz w bloku „Statusy zamówienia” spośród statusów sklepu.
1
Opłacone2
Środki zablokowane3
Zwrócono4
Status, gdy kwota płatności się nie zgadza- Ustawiany, gdy klient zapłacił lub potwierdzono blokadę.
- Pieniądze są zablokowane i czekają na potwierdzenie; pole widać tylko przy blokadzie.
- Pieniądze zwrócono w całości lub blokadę anulowano.
- Zapłacono, ale kwota zamówienia się zmieniła: zamówienie dostaje ten status, żeby można było je sprawdzić.
| Pole | Kiedy jest ustawiany | Domyślnie |
|---|---|---|
| Opłacone | Klient zapłacił lub blokada została potwierdzona | W realizacji |
| Środki zablokowane | Pieniądze są zablokowane i czekają na Twoje potwierdzenie | Przetworzone |
| Zwrócono | Pieniądze zwrócono w całości lub blokadę anulowano | Zwrócono środki |
| Status, gdy kwota płatności się nie zgadza | Klient opłacił rachunek, a kwota zamówienia w międzyczasie się zmieniła | Oczekujące |
Gdy płatność lub blokada nadaje zamówieniu pierwszy status, klient dostaje zwykły e-mail o zamówieniu. Pobrana lub zdjęta blokada i pełny zwrot też zmieniają status — klient dostaje e-mail o zmianie statusu. Częściowy zwrot nie zmienia statusu, e-maila nie ma.
Dopóki monobank nie potwierdzi płatności, zamówienie pozostaje niepotwierdzone i nie jest uznawane za nowe. Klient nie zapłacił — zamówienie nie jest anulowane: może je opłacić ponownie.
Sklep weryfikuje powiadomienia banku: status i kwotę bierze z monobank, a nie z samego powiadomienia.
Kwota płatności nie zgadza się z kwotą zamówienia
Zdarza się to, gdy klient po próbie płatności zmienił koszyk albo między wystawieniem rachunku a płatnością zmienił się kurs. Pieniądze wpłynęły, więc zamówienie jest potwierdzane i trafia do Elbuz, ale nie jako opłacone. Dostaje status z pola „Status, gdy kwota płatności się nie zgadza”.
Ten status musi się różnić od „Opłacone” i „Środki zablokowane”. Jeśli jest taki sam, sklep ustawi status nowego zamówienia, a jeśli i ten jest równy „Opłacone”, zamówienie pozostanie niepotwierdzone. Taką zbieżność podświetli po prawej „Status niezgodności kwoty jest taki sam jak «Opłacone» lub blokada…”.
W sklepach skonfigurowanych wcześniej „Środki zablokowane” może mieć wartość „Oczekujące” — tak samo jak status niezgodności. Wtedy po prawej pojawi się to ostrzeżenie: wybierz dla blokady lub niezgodności inny status.
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 monobank”. Pokazuje stan płatności, kwotę, ile pobrano i zwrócono, ile jeszcze można zwrócić oraz wszystkie próby płatności.
Przyciski — tylko te, które są teraz dostępne dla zamówienia:
| Przycisk | Co robi | Status po operacji |
|---|---|---|
| Zwróć środki | Zwraca całą kwotę lub część: pole kwoty jest już wypełnione pozostałą kwotą, przy częściowym zwrocie wpisz mniejszą | Pełny — „Zwrócono”, częściowy — bez zmian |
| Pobierz blokadę | Pobiera zablokowaną kwotę lub mniejszą, jeśli części towaru nie ma | „Opłacone” |
| Zdejmij blokadę | Anuluje blokadę, pieniądze wracają do klienta | „Zwrócono” |
| Odśwież status | Pobiera stan płatności z monobank, jeśli powiadomienie nie dotarło. Powtórzenie niczego nie dubluje | według stanu płatności |
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 monobank.
Sklep nie odpowiedział — pod komunikatem pojawi się „Powtórz”: powtarza 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ępny dla każdego, kto widzi zamówienie.
Gdy przez monobank 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.
Jak sprawdzić płatnością testową
- Pobierz token testowy na api.monobank.ua — logowanie przez aplikację monobank. Wpisz go w „Token (X-Token)” i zapisz.
- Złóż na stronie zamówienie na siebie, wybierz „Płatność kartą przez monobank” i zapłać. Z tokenem testowym pieniądze nie są pobierane.
- Sprawdź, czy na stronie banku jest właściwa kwota, a zamówienie trafiło do Elbuz do „Zamówienie klienta” ze sposobem płatności „Karta płatnicza”.
- Zamień token na produkcyjny z panelu web.monobank.ua i zapisz.
Scenariusze
Elektronika na zamówienie: pobierać po sprawdzeniu dostępności
„Tryb pobierania” — „Zablokuj środki, pobierz później”. W „Środki zablokowane” wybierz status inny niż w „Opłacone”.
Towar jest — „Pobierz blokadę” w karcie zamówienia. Części nie ma — wpisz mniejszą kwotę. Nie ma nic — „Zdejmij blokadę”, pieniądze zostają odblokowane.
Paragon fiskalny monobank ze składem zamówienia
Włącz „Przekazuj zawartość koszyka”, w „Kod produktu na paragonie” wybierz pole wypełnione we wszystkich produktach, na przykład SKU. Klient widzi listę produktów na stronie płatności, a na paragonie — te same wiersze.
Ceny w dolarach, płatność w hrywnach
„Waluta płatności” — UAH. Sklep przeliczy kwotę po kursie, który przyszedł z okna „Waluty” w Elbuz. Kurs w Elbuz się zaktualizował — kwota w rachunku zmieni się po następnym eksporcie.
Kurs zmienił się między wystawieniem rachunku a płatnością — zamówienie przyjdzie ze statusem niezgodności kwoty: jak to działa.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi monobank przy składaniu zamówienia | Moduł jest wyłączony, token nie jest ustawiony, waluty płatności nie ma w sklepie, adres nie należy do strefy geograficznej lub metoda jest ograniczona w ustawieniach składania zamówienia | Sprawdź „Włączony”, token, „Waluta płatności” i „Strefa geograficzna”. Waluta — w oknie „Waluty” z „Aktywność” i „Eksport na stronę”. Wszystko się zgadza — wsparcie Elbuz sprawdzi składanie zamówienia |
| Klient widzi „Nie udało się otworzyć strony płatności” | Najczęściej błędny token albo płatności internetowe nie są jeszcze aktywne | Wklej token ponownie przez „Zamień”. Nie pomogło — włącz „Dziennik zapytań do banku” w bloku „Dodatkowe”, powtórz płatność i napisz do wsparcia Elbuz |
| Płatność przeszła, a status się nie zmienił | Powiadomienie banku nie dotarło do sklepu | Kliknij „Odśwież status” w karcie zamówienia. Status zaktualizuje się też wtedy, gdy klient wróci do sklepu ze strony banku |
| Opłacone zamówienie trafiło do Elbuz ze statusem niezgodności kwoty, a nie „Opłacone” | Klient zmienił koszyk po próbie płatności albo zmienił się kurs | Porównaj płatność w panelu monobank z kwotą zamówienia i zdecyduj: dopłata, zwrot lub zmiana zamówienia |
| Kwota na stronie banku różni się od ceny na stronie sklepu | Zamówienie jest w innej walucie, kwotę przeliczono na walutę płatności | Sprawdź kurs w oknie „Waluty” w Elbuz i wyeksportuj go do sklepu |
Najczęstsze pytania
Czy to to samo co „Zakup w ratach (monobank)”?
Nie. „Zakup w ratach (monobank)” to osobna metoda płatności w module kredytów, z własnymi ustawieniami (Kredyt i płatność w ratach). Ten moduł przyjmuje pełną płatność lub blokadę.
Co się stanie, jeśli wyłączę moduł?
monobank zniknie ze składania zamówienia. Token i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu. Płatności rozpoczęte przed wyłączeniem zostaną potwierdzone dopiero wtedy, gdy klient wróci z monobank do sklepu.
Czy można wysłać klientowi link do płatności monobank?
Tak, z karty zamówienia w Elbuz. Token do linków ustawia się osobno: Płatność przez link.
Czy klient dostaje e-mail po zwrocie?
Tak, przy pełnym zwrocie: status zmienia się na wybrany w polu „Zwrócono”, a klient dostaje zwykły e-mail o zmianie statusu. Przy częściowym zwrocie status się nie zmienia, e-maila nie ma.
Klient zamknął stronę banku bez zapłaty — gdzie jest to zamówienie?
Pozostaje niepotwierdzone i nie trafia do Elbuz. Rachunek jest ważny 24 godziny: klient może wrócić do koszyka i zapłacić ponownie.
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ść” → karta monobank
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”; zwrot i blokada — uprawnienie „Operacje płatności: zwrot, blokada, kredyt”
- Przygotuj
- konto FOP lub TOV w monobank z płatnościami internetowymi, token (X-Token)
Powiązane tematy
- Jeśli chcesz zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli klient chce opłacić zamówienie przyjęte telefonicznie — Płatność przez link.
- Jeśli kwota w rachunku jest inna przez kurs — Kursy walut.
- Jeśli obok potrzebny jest też LiqPay — Płatność LiqPay w sklepie.
