{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Wprowadzenie - Płatności Online","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":"wprowadzenie---płatności-online","__idx":0},"children":["Wprowadzenie - Płatności Online"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Witaj w module Płatności Online! Ten poradnik przeprowadzi Cię przez najważniejsze kroki niezbędne do rozpoczęcia"," ","przyjmowania wpłat za pomocą naszego API. W ciągu kilku minut wygenerujesz swoją pierwszą transakcję."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-wymagania-wstępne","__idx":1},"children":["1. Wymagania wstępne"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Zanim wyślesz pierwsze żądanie do API, musisz przygotować dwie rzeczy w Panelu Klienta SimPay:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Rejestracja usługi:"]}," Przejdź do Panelu Klienta i dodaj nową usługę dla Płatności Online. Po jej utworzeniu"," ","otrzymasz unikalny identyfikator usługi (np. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e65c7519"]},"), który będzie wymagany przy generowaniu każdej transakcji ("," ","podasz go w adresie URL)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Klucz API (Bearer Token):"]}," Uwierzytelnianie w naszym API odbywa się za pomocą tokenów. Swój klucz API znajdziesz"," ","po zalogowaniu do panelu, w zakładce ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Moje Konto > Klucze API"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Tryb testowy"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aby testować płatności bez używania prawdziwych pieniędzy i rzeczywistego obciążania kont, po prostu ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["włącz \"Tryb"," ","testowy\""]}," w ustawieniach swojej konkretnej usługi w Panelu Klienta."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-podstawy-komunikacji-z-api","__idx":2},"children":["2. Podstawy komunikacji z API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nasze API zostało zaprojektowane w duchu REST i komunikuje się wyłącznie w formacie ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Każde żądanie wysyłane do serwerów SimPay musi bezwzględnie zawierać zabezpieczenie w postaci tokenu oraz odpowiednie"," ","nagłówki HTTP. Brak nagłówka ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type"]}," może skutkować odrzuceniem żądania."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer TWÓJ_KLUCZ_API\nAccept: application/json\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-wygenerowanie-pierwszej-transakcji","__idx":3},"children":["3. Wygenerowanie pierwszej transakcji"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Aby utworzyć nową transakcję płatniczą i wygenerować link dla klienta, wyślij żądanie ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," na endpoint"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/payment/{serviceId}/transactions"]},", podmieniając ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{serviceId}"]}," na identyfikator Twojej usługi."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"przykładowe-żądanie-request","__idx":4},"children":["Przykładowe żądanie (Request)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poniżej znajduje się najprostsze możliwe zapytanie. Według specyfikacji, jedynym absolutnie wymaganym polem w ciele"," ","żądania jest kwota (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},")."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /payment/e65c7519/transactions HTTP/1.1\nHost: api.simpay.pl\nAuthorization: Bearer TWÓJ_KLUCZ_API\nAccept: application/json\nContent-Type: application/json\n\n{\n  \"amount\": 100.00,\n  \"currency\": \"PLN\"\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chcesz przesłać więcej danych?"]}," Możesz opcjonalnie podać adres e-mail klienta, ograniczyć dostępne kanały płatności"," ","lub wymusić konkretny język bramki. Pełną listę i strukturę wszystkich obsługiwanych parametrów znajdziesz w naszym *"," ","*",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis"},"children":["API Reference"]},"**."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"przykładowa-odpowiedź-response","__idx":5},"children":["Przykładowa odpowiedź (Response)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["W przypadku pomyślnego utworzenia transakcji, serwer zwróci status ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HTTP 200 OK"]}," oraz obiekt JSON zawierający"," ","identyfikator transakcji oraz ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]}," – adres, na który powinieneś przekierować kupującego."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": true,\n  \"data\": {\n    \"transactionId\": \"1d87a1b3-18f8-4146-bcb1-c0c9f293b04f\",\n    \"redirectUrl\": \"https://pay.simpay.pl/1d87a1b3-18f8-4146-bcb1-c0c9f293b04f\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Co teraz?"]}," Przekieruj przeglądarkę swojego klienta na adres podany w polu ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirectUrl"]},". Klient opłaci zamówienie"," ","na naszej bramce, a my zajmiemy się resztą!"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-co-dalej","__idx":6},"children":["4. Co dalej?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Udało Ci się wygenerować pierwszą transakcję! Aby zbudować kompletną i w pełni zautomatyzowaną integrację e-commerce,"," ","zapoznaj się z poniższymi tematami:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/notifications/payment"},"children":["Powiadomienia IPN (Webhooki)"]}]}," – absolutny wymóg! Dowiedz się, jak Twój serwer ma"," ","automatycznie dowiadywać się o tym, że klient faktycznie opłacił zamówienie, aby wydać mu towar."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/directchannel"},"children":["Płatności z pominięciem bramki (directChannel)"]}]}," – sprawdź, jak zaimplementować"," ","White-Label Checkout i podnieść konwersję w sklepie."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["👉 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/payment/statuses"},"children":["Lista statusów transakcji"]}]}," – poznaj pełny cykl życia płatności."]}]},"headings":[{"value":"Wprowadzenie - Płatności Online","id":"wprowadzenie---płatności-online","depth":1},{"value":"1. Wymagania wstępne","id":"1-wymagania-wstępne","depth":2},{"value":"2. Podstawy komunikacji z API","id":"2-podstawy-komunikacji-z-api","depth":2},{"value":"3. Wygenerowanie pierwszej transakcji","id":"3-wygenerowanie-pierwszej-transakcji","depth":2},{"value":"Przykładowe żądanie (Request)","id":"przykładowe-żądanie-request","depth":3},{"value":"Przykładowa odpowiedź (Response)","id":"przykładowa-odpowiedź-response","depth":3},{"value":"4. Co dalej?","id":"4-co-dalej","depth":2}],"frontmatter":{"seo":{"title":"Wprowadzenie - Płatności Online"}},"lastModified":"2026-04-22T16:48:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/payment","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}