{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Płatności bezpośrednie (directChannel)","description":"Znajdziesz tutaj wszystkie niezbędne informacje dotyczące integracji i obsługi systemu płatności SimPay.pl","siteUrl":"https://docs.simpay.pl","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"płatności-bezpośrednie-directchannel","__idx":0},"children":["Płatności bezpośrednie (directChannel)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Mechanizm kanałów bezpośrednich (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]},") pozwala na ominięcie standardowego ekranu wyboru metody płatności na"," ","bramce SimPay. Używając tej funkcji, możesz zaimplementować własny widok wyboru banku, portfela lub metody płatności ("," ","tzw. white-label checkout) bezpośrednio w swoim sklepie, a następnie przekierować klienta prosto do logowania w jego"," ","banku lub aplikacji."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przepływ-płatności-flow","__idx":1},"children":["Przepływ płatności (Flow)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniższy diagram przedstawia kroki, jakie zachodzą od momentu wyboru metody płatności przez kupującego, aż po"," ","potwierdzenie wpłaty."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n autonumber\n actor K as Kupujący\n participant S as Twój Sklep\n participant SP as SimPay\n participant B as Bank / Operator\n K ->> S: Wybiera metodę (np. BLIK) na stronie sklepu\n S ->> SP: POST /transactions (z directChannel i danymi klienta)\n SP -->> S: Odpowiedź z adresem przekierowania (redirectUrl)\n S ->> K: Przekierowanie przeglądarki na redirectUrl\n K ->> B: Logowanie w banku i autoryzacja płatności\n B -->> SP: Wewnętrzne potwierdzenie zasilenia środków\n SP ->> S: Asynchroniczny Webhook (IPN): transaction_paid\n B ->> K: Przekierowanie powrotne klienta do sklepu\n S ->> K: Wyświetlenie strony z podziękowaniem i wydanie towaru\n","diagramHtml":"","diagramHtmlDark":""},"children":["sequenceDiagram\n autonumber\n actor K as Kupujący\n participant S as Twój Sklep\n participant SP as SimPay\n participant B as Bank / Operator\n K ->> S: Wybiera metodę (np. BLIK) na stronie sklepu\n S ->> SP: POST /transactions (z directChannel i danymi klienta)\n SP -->> S: Odpowiedź z adresem przekierowania (redirectUrl)\n S ->> K: Przekierowanie przeglądarki na redirectUrl\n K ->> B: Logowanie w banku i autoryzacja płatności\n B -->> SP: Wewnętrzne potwierdzenie zasilenia środków\n SP ->> S: Asynchroniczny Webhook (IPN): transaction_paid\n B ->> K: Przekierowanie powrotne klienta do sklepu\n S ->> K: Wyświetlenie strony z podziękowaniem i wydanie towaru\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Krótkie omówienie najważniejszych kroków:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Kroki 2-3:"]}," Twój system odpytuje nasze API o nową transakcję, podając identyfikator kanału. SimPay natychmiast"," ","generuje dedykowany link do płatności (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Krok 4:"]}," Twoim zadaniem jest przekierowanie klienta na otrzymany link. W tym momencie klient opuszcza Twoją stronę."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Krok 7:"]}," To tutaj dzieje się najważniejsza logika biznesowa. Po udanej płatności SimPay wysyła Webhooka. Wtedy"," ","powinieneś zmienić status zamówienia w swojej bazie danych."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"podgląd-wygenerowanej-transakcji-z-directchannel-dla-directchannel--blik","__idx":2},"children":["Podgląd wygenerowanej transakcji z directChannel dla directChannel = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik"]}]},{"$$mdtype":"Tag","name":"video","attributes":{"width":"100%","controls":"controls"},"children":[{"$$mdtype":"Tag","name":"source","attributes":{"src":"/assets/directchannel_showcase.b89020006c894ec422890747a6408d2d01b4704e10031353fbf12e10bf026d35.6bb1adc7.mp4","type":"video/mp4"},"children":[]},"\n Przeglądarka nie obsługuje odtwarzacza wideo.\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dzięki ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]}," ekran bramki SimPay pojawia się tylko na ułamek sekundy. Klient pozostaje w ekosystemie Twojego"," ","sklepu, co gwarantuje pełną spójność procesu zakupowego. Ten płynny przepływ (tzw. seamless experience) eliminuje"," ","rozpraszacze i zauważalnie podnosi wskaźnik konwersji zrealizowanych płatności."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"wymagania-techniczne","__idx":3},"children":["Wymagania techniczne"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aby poprawnie zainicjować transakcję z użyciem kanału bezpośredniego, standardowe żądanie wysyłane na endpoint"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payment/{serviceId}/transactions"]}," musi zostać rozszerzone o dodatkowe dane kupującego. Są one niezbędne do prawidłowego procesowania"," ","płatności oraz poprawnego działania systemów bezpieczeństwa (antyfraudowych)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Podczas tworzenia takiej transakcji ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["musisz"]}," przekazać poniższe obiekty i pola w ciele żądania (body):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]}]}," – identyfikator wybranej metody płatności (np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blik"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mbank"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypo"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.countryCode"]}]}," – dwuliterowy kod kraju klienta. Zwróć uwagę, aby był on odpowiedni dla ustawionej waluty"," ","transakcji (np. dla PLN będzie to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PL"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.ip"]}]}," – adres IP kupującego inicjującego transakcję."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.email"]}]}," – adres e-mail kupującego."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["antifraud.useragent"]}]}," – dokładna wartość nagłówka ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["User-Agent"]}," z przeglądarki klienta."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"przykładowe-żądanie-api","__idx":4},"children":["Przykładowe żądanie (API)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniżej znajduje się kompletny, przykładowy payload w formacie JSON dla utworzenia transakcji bezpośredniej z"," ","wykorzystaniem kanału BLIK."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"amount\": 100.00,\n \"currency\": \"PLN\",\n \"directChannel\": \"blik\",\n \"control\": \"Zamówienie nr 12345\",\n \"customer\": {\n \"email\": \"jan.kowalski@example.com\",\n \"countryCode\": \"PL\",\n \"ip\": \"192.168.1.1\"\n },\n \"antifraud\": {\n \"useragent\": \"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ważne:"]}," Przekazanie błędnych danych (np. statycznego adresu IP Twojego serwera zamiast IP klienta) lub brak"," ","nagłówka ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["User-Agent"]}," w obiekcie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["antifraud"]}," może skutkować odrzuceniem transakcji przez systemy bezpieczeństwa"," ","dostawców płatności."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"gdzie-szukać-wartości-dla-directchannel-","__idx":5},"children":["Gdzie szukać wartości dla ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["directChannel"]},"?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Pełną listę obsługiwanych identyfikatorów kanałów wraz z dopuszczalnymi walutami i obsługą zwrotów znajdziesz w"," ","zestawieniu metod płatności:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/methods"},"children":["Przejdź do: Lista metod płatności"]}]}]}]},"headings":[{"value":"Płatności bezpośrednie (directChannel)","id":"płatności-bezpośrednie-directchannel","depth":1},{"value":"Przepływ płatności (Flow)","id":"przepływ-płatności-flow","depth":2},{"value":"Podgląd wygenerowanej transakcji z directChannel dla directChannel = blik","id":"podgląd-wygenerowanej-transakcji-z-directchannel-dla-directchannel--blik","depth":2},{"value":"Wymagania techniczne","id":"wymagania-techniczne","depth":2},{"value":"Przykładowe żądanie (API)","id":"przykładowe-żądanie-api","depth":2},{"value":"Gdzie szukać wartości dla directChannel ?","id":"gdzie-szukać-wartości-dla-directchannel-","depth":2}],"frontmatter":{"seo":{"title":"Płatności bezpośrednie (directChannel)"}},"lastModified":"2026-04-21T22:29:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payment/directchannel","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}