↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak przyjmować płatności monobank w sklepie

    6 min czytaniaZaktualizowano

    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

    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.

    1. 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.
    2. Otwórz ekran modułu. „Ustawienia sklepu” → dział „Zamówienie i płatność” → karta monobank.
    3. Wklej token w pole „Token (X-Token)” w bloku „Połączenie”.
    4. Włącz przełącznik „Włączony” u góry ekranu.
    5. Kliknij „Zapisz”. Ustawienia od razu trafiają do sklepu: na dole pojawi się „Zapisano i zastosowano w sklepie”.
    Dział „Zamówienie i płatność” w „Ustawieniach sklepu” z modułem „Płatności monobank” na liście
    1Moduł „Płatności monobank”
    2Znacznik stanu modułu
    1. „Płatności monobank” — otwiera ekran ustawień płatności monobank.
    2. Znacznik stanu i przełącznik — pokazują, czy klienci widzą tę metodę płatności i czy ostatnie zmiany dotarły do sklepu.
    Ekran „Płatności monobank”, blok „Połączenie”
    1Przełącznik „Włączony”
    2Token (X-Token)
    3Adres URL webhooka
    4Co jeszcze do skonfigurowania
    5Plakietka stanu
    1. Po zapisaniu pokazuje monobank klientom.
    2. Token z panelu monobank; po zapisaniu widać tylko znacznik, że jest ustawiony.
    3. Adres powiadomień banku; moduł przekazuje go sam, nic nie trzeba wpisywać.
    4. Czego jeszcze brakuje, żeby płatności działały.
    5. 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ść”

    Blok „Płatność” na ekranie monobank
    1Tryb pobierania
    2Waluta płatności
    3Przekazuj zawartość koszyka
    4Kod produktu na paragonie
    1. Pobrać pieniądze od razu lub zablokować je do Twojego potwierdzenia.
    2. Waluta, na którą przeliczana jest kwota zamówienia.
    3. Produkty, dostawa i rabaty na stronie płatności i na paragonie.
    4. Które pole produktu trafia na paragon jako kod.
    PoleCo robiDomyślnie
    Tryb pobierania„Pobierz od razu” lub „Zablokuj środki, pobierz później” (blokada)Pobierz od razu
    Waluta płatnościUAH, 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ść koszykaSkład zamówienia na stronie płatności i na paragonie monobank — co dokładnie idziewłączone
    Kod produktu na paragonieTylko 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ącegomonobank wyśle potwierdzenie na e-mail z zamówieniawyłą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. %s jest 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 pobieraniaCo dzieje się z pieniędzmiDla kogo
    Pobierz od razuSą pobierane od razuTowar jest w magazynie, wysyłka od razu
    Zablokuj środki, pobierz późniejSą 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.

    Blok „Statusy zamówienia” z czterema polami statusów
    1Opłacone
    2Środki zablokowane
    3Zwrócono
    4Status, gdy kwota płatności się nie zgadza
    1. Ustawiany, gdy klient zapłacił lub potwierdzono blokadę.
    2. Pieniądze są zablokowane i czekają na potwierdzenie; pole widać tylko przy blokadzie.
    3. Pieniądze zwrócono w całości lub blokadę anulowano.
    4. Zapłacono, ale kwota zamówienia się zmieniła: zamówienie dostaje ten status, żeby można było je sprawdzić.
    PoleKiedy jest ustawianyDomyślnie
    OpłaconeKlient zapłacił lub blokada została potwierdzonaW realizacji
    Środki zablokowanePieniądze są zablokowane i czekają na Twoje potwierdzeniePrzetworzone
    ZwróconoPieniądze zwrócono w całości lub blokadę anulowanoZwrócono środki
    Status, gdy kwota płatności się nie zgadzaKlient opłacił rachunek, a kwota zamówienia w międzyczasie się zmieniłaOczekują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:

    PrzyciskCo robiStatus po operacji
    Zwróć środkiZwraca 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ż statusPobiera stan płatności z monobank, jeśli powiadomienie nie dotarło. Powtórzenie niczego nie dublujewedł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ą

    1. Pobierz token testowy na api.monobank.ua — logowanie przez aplikację monobank. Wpisz go w „Token (X-Token)” i zapisz.
    2. Złóż na stronie zamówienie na siebie, wybierz „Płatność kartą przez monobank” i zapłać. Z tokenem testowym pieniądze nie są pobierane.
    3. 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”.
    4. 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 widziszDlaczego tak jestCo 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

    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