{"id":10591,"date":"2023-06-14T09:36:04","date_gmt":"2023-06-14T09:36:04","guid":{"rendered":"https:\/\/www.qly.docs.pay.sibs.com\/integrations\/payment-form\/przewodnik-integracji\/"},"modified":"2026-04-09T10:25:49","modified_gmt":"2026-04-09T10:25:49","slug":"przewodnik-integracji","status":"publish","type":"page","link":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/sibs-gateway-dokumentacja\/integracje\/payment-form\/przewodnik-integracji\/","title":{"rendered":"Przewodnik integracji"},"content":{"rendered":"<!-- wp:themify-builder\/canvas \/-->\n\n\n<p>Zintegruj Formularz P\u0142atno\u015bci szybko i zacznij bezpiecznie przyjmowa\u0107 p\u0142atno\u015bci, jednocze\u015bnie utrzymuj\u0105c wra\u017cliwe dane poza swoimi systemami.<\/p>\n\n\n\n<p>Ten przewodnik przeprowadzi Ci\u0119 przez ka\u017cdy etap integracji \u2014 od utworzenia zam\u00f3wienia, przez wygenerowanie Formularza P\u0142atno\u015bci, a\u017c po sprawdzenie statusu transakcji.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Krok 1: Utworzenie zam\u00f3wienia<\/h3>\n\n\n\n<p>Gdy klient jest gotowy do dokonania p\u0142atno\u015bci, rozpocznij od utworzenia zam\u00f3wienia.<\/p>\n\n\n\n<p>Spowoduje to zainicjowanie transakcji oraz zdefiniowanie danych sprzedawcy, klienta i szczeg\u00f3\u0142\u00f3w transakcji wymaganych do przetwarzania p\u0142atno\u015bci.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Dost\u0119pny endpoint (URL):<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Environment<\/th><th>URL<\/th><th>Operation method &amp; Endpoint<\/th><th>Operation description<\/th><\/tr><\/thead><tbody><tr><td>PROD<\/td><td>api.sibsgateway.com<\/td><td>api\/version-id\/payments<\/td><td>Wykonuje \u017c\u0105danie przygotowania danych wymaganych do checkoutu i zwraca Formularz P\u0142atno\u015bci.<\/td><\/tr><tr><td>TEST<\/td><td>stargate.qly.site[1|2].sibs.pt<\/td><td>api\/version-id\/payments<\/td><td>Tworzy transakcj\u0119 w \u015brodowisku testowym.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<style type=\"text\/css\">\n\t#message-box-block_a10fc0b510f0bab002d08fe569ec0ab8 {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_a10fc0b510f0bab002d08fe569ec0ab8\" class=\"block-message-box\">\n\t\t\t\t<\/div>\n\n\n<p>Proces tworzenia zam\u00f3wienia wymaga trzech g\u0142\u00f3wnych krok\u00f3w:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Akcja 1: <\/strong>Zdefiniuj nag\u0142\u00f3wki i dodaj dane sprzedawcy oraz klienta<\/li>\n\n\n\n<li><strong>Akcja 2:<\/strong> Dodaj informacje o transakcji do zam\u00f3wienia<\/li>\n\n\n\n<li><strong>Akcja 3: <\/strong>Skonfiguruj webhooki do aktualizacji transakcji<\/li>\n<\/ul>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Akcja 1: Zdefiniuj nag\u0142\u00f3wki i dodaj dane sprzedawcy oraz klienta<\/strong><\/h5>\n\n\n\n<p>Zdefiniuj nag\u0142\u00f3wki wymagane do uwierzytelnienia oraz przeka\u017c dane sprzedawcy i klienta potrzebne do rozpocz\u0119cia transakcji.<br>Poni\u017cej znajduje si\u0119 pe\u0142ny opis danych wymaganych do utworzenia zam\u00f3wienia.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Parametry nag\u0142\u00f3wka<\/strong><\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Field<\/th><th>Type<\/th><th>Required<\/th><th>Description<\/th><th>Example<\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Content-Type<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Defines the content type of the request.<\/td><td>application\/json<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Authorization<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Bearer token for authentication.<\/td><td>Bearer xxxxxxxx<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<style type=\"text\/css\">\n\t#message-box-block_c87ba21779c1011b48535c8f89f69b8d {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_c87ba21779c1011b48535c8f89f69b8d\" class=\"block-message-box\">\n\t\t\t\t<\/div>\n\n\n<h5 class=\"wp-block-heading\"><strong>Parametry \u017c\u0105dania<\/strong><\/h5>\n\n\n\n<p>Poni\u017csze obiekty definiuj\u0105 dane wymagane do utworzenia zam\u00f3wienia i inicjalizacji Formularza P\u0142atno\u015bci:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Field<\/th><th>Type<\/th><th>Condition<\/th><th>Description<\/th><th>Example<\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant.terminalId<\/mark><\/td><td>numeric (\u226410)<\/td><td>Mandatory<\/td><td>Identyfikator terminala sprzedawcy<\/td><td>47215<br><\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant.channel<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Kana\u0142 u\u017cywany do transakcji<\/td><td>Web<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant.merchantTransactionId<\/mark><\/td><td>string (\u22641000)<\/td><td>Mandatory<\/td><td>Unikalny identyfikator transakcji<\/td><td>ORDER_123<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant.transactionDescription<\/mark><\/td><td>string<br>(\u22644000)<\/td><td>Optional<\/td><td>Opis transakcji<\/td><td>Payment for order #001<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">customer.customerInfo.customerName<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Imi\u0119 i nazwisko klienta<\/td><td>John Doe<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">customer.customerInfo.customerEmail<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Email klienta<\/td><td>john@email.com<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount.value<\/mark><\/td><td>number (double)<\/td><td>Mandatory<\/td><td>Kwota transakcji<\/td><td>50.00<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount.currency<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Waluta (ISO 4217)<\/td><td>EUR<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.paymentMethod<\/mark><\/td><td>array<\/td><td>Mandatory<\/td><td>Metody p\u0142atno\u015bci do wy\u015bwietlenia<\/td><td>[&#8222;CARD&#8221;]<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<style type=\"text\/css\">\n\t#message-box-block_2d040b529689e3c08b4ddf642ca38d5b {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_2d040b529689e3c08b4ddf642ca38d5b\" class=\"block-message-box\">\n\t\t\t\t<\/div>\n\n\n<style type=\"text\/css\">\n\t#message-box-block_b0712571274539824aea2300d515f079 {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_b0712571274539824aea2300d515f079\" class=\"block-message-box\">\n\t\t\t\t\t\t\t\t\t\t\n\t\t\t<div class='row warning' style=\"display: flex;\">\n\t\t\t  <div class='col' style=\"width: 10%; display: flex; align-items: center; justify-content: center;\">\n\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/themes\/themify-ultra-child\/images\/msg_warn.svg\" alt=\"Warning\">\n\t\t\t  <\/div>\n\t\t\t  <div class='col2'>\n\t\t\t\t<p><p><strong data-start=\"257\" data-end=\"267\">UWAGA:<\/strong> Dla zalogowanych u\u017cytkownik\u00f3w pola <strong>CustomerName<\/strong> oraz <strong>CustomerEmail<\/strong> s\u0105 obowi\u0105zkowe. Dzi\u0119ki temu u\u017cytkownik nie b\u0119dzie musia\u0142 ponownie wprowadza\u0107 tych danych w formularzu p\u0142atno\u015bci.<\/p>\n<\/p>\n\t\t\t  <\/div>\n\t\t\t<\/div>\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\t<\/div>\n\n\n<h5 class=\"wp-block-heading\"><strong>Pe\u0142na struktura \u017c\u0105dania (opcjonalna konfiguracja zaawansowana)<\/strong><\/h5>\n\n\n\n<p>API obs\u0142uguje pe\u0142en zestaw p\u00f3l umo\u017cliwiaj\u0105cych <strong>zaawansowan\u0105 konfiguracj\u0119<\/strong>, takich jak szczeg\u00f3\u0142owe dane klienta, informacje o urz\u0105dzeniu, adresy dostawy i rozliczeniowe oraz dodatkowe metadane.<\/p>\n\n\n\n<p>W wi\u0119kszo\u015bci integracji Formularza P\u0142atno\u015bci pola te s\u0105 opcjonalne i powinny by\u0107 u\u017cywane tylko wtedy, gdy jest to wymagane przez potrzeby biznesowe lub regulacyjne.<\/p>\n\n\n\n<p>Aby uzyska\u0107 pe\u0142n\u0105 list\u0119 obs\u0142ugiwanych p\u00f3l i szczeg\u00f3\u0142ow\u0105 specyfikacj\u0119, zapoznaj si\u0119 z <a href=\"https:\/\/www.docs.pay.sibs.com\/integrations\/api\/integration-guide\/\" target=\"_blank\" rel=\"noreferrer noopener\">dokumentacj\u0105 API Server-to-Server.<\/a><\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Akcja 2: Dodaj informacje o transakcji<\/strong><\/h5>\n\n\n\n<p>Ta akcja definiuje sam\u0105 transakcj\u0119, w tym kwot\u0119, metod\u0119 p\u0142atno\u015bci, znacznik czasu oraz inne atrybuty wymagane do prawid\u0142owego przetworzenia p\u0142atno\u015bci.<br>Na tym etapie nale\u017cy uwzgl\u0119dni\u0107 informacje o transakcji w zale\u017cno\u015bci od metod p\u0142atno\u015bci, kt\u00f3re maj\u0105 by\u0107 wy\u015bwietlane w Formularzu P\u0142atno\u015bci.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>transaction (object) \u2013 Mandatory<\/strong><\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Field<\/th><th>Type<\/th><th>Condition<\/th><th>Description<\/th><th>Example<\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Transaction<\/mark><\/td><td>object<\/td><td>Mandatory<\/td><td>Szczeg\u00f3\u0142y transakcji<\/td><td>&#8211;<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.transactionTimeStamp<\/mark><\/td><td>ISODateTime<\/td><td>Mandatory<\/td><td>Znacznik czasu utworzenia transakcji<\/td><td>2026-02-19T15:00:00.000Z<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.description<\/mark><\/td><td>string (&lt;=70)<\/td><td>Mandatory<\/td><td>Kr\u00f3tki opis transakcji<\/td><td>Payment for Order #20260220<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.moto<\/mark><\/td><td>boolean<\/td><td>Mandatory<\/td><td>Czy transakcja jest typu MOTO (Mail Order \/ Telephone Order)<\/td><td>False<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.paymentType<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Typ p\u0142atno\u015bci: \u201cPURS\u201d \u2013 zakup, \u201cAUTH\u201d \u2013 autoryzacja<\/td><td>PURS (Purchase)<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.paymentMethod<\/mark><\/td><td>array<\/td><td>Mandatory<\/td><td>Dost\u0119pne warto\u015bci:<br>&#8222;CARD&#8221; \u2013 Card &#8222;TOKEN&#8221; \u2013 Token &#8222;PAY_BY_LINK&#8221;- Pay by Link <br>&#8222;BLIK&#8221; \u2013 BLIK &#8222;XPAY&#8221; \u2013 xPay &#8222;IDEL&#8221; \u2013 Ideal &#8222;BNCT&#8221; \u2013 Bancontact &#8222;SPDD&#8221; &#8211; SEPA Direct Debit &#8222;CRTB&#8221; &#8211; Cartes Bancaires <br>&#8222;MBWY&#8221; &#8211; &#8222;MB WAY&#8221; <br>&#8222;BIZM&#8221; &#8211; &#8222;Bizum&#8221;<\/td><td>[&#8222;CARD&#8221;,&#8221;BLIK&#8221;,&#8221;TOKEN&#8221;]<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount<\/mark><\/td><td>object<\/td><td>Mandatory<\/td><td>Kwota i waluta transakcji<\/td><td>&#8211;<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>1.2. Kwota (object) \u2013 wymagane<\/strong><\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Field<\/th><th>Type<\/th><th>Condition<\/th><th>Description<\/th><th>Example<\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount<\/mark><\/td><td>object<\/td><td>Mandatory<\/td><td>Kwota i waluta<\/td><td>&#8211;<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount.value<\/mark><\/td><td>double<\/td><td>Mandatory<\/td><td>Kwota transakcji<\/td><td>50.5<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transaction.amount.currency<\/mark><\/td><td>string<\/td><td>Mandatory<\/td><td>Waluta ISO 4217<\/td><td>PLN<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<style type=\"text\/css\">\n\t#message-box-block_f246cbccce5737a9fd896c35af7d1a6a {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_f246cbccce5737a9fd896c35af7d1a6a\" class=\"block-message-box\">\n\t\t\t\t<\/div>\n\n\n<style type=\"text\/css\">\n\t#message-box-block_f145c01099218874c7205db57888ff76 {\n\t\t\/* Add styles that use ACF values here *\/\n\t}\n<\/style>\n\n<div id=\"message-box-block_f145c01099218874c7205db57888ff76\" class=\"block-message-box\">\n\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\n\t\t\t\t<div class='row notification'>\n\t\t\t\t  <div class='col'>\n\t\t\t\t\t\t<img decoding=\"async\" src=\"https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/themes\/themify-ultra-child\/images\/msg_bell.svg\" alt=\"Notification\">\n\t\t\t\t  <\/div>\n\t\t\t  <div class='col2'>\n\t\t\t\t\t<p><p>Sprawd\u017a, jak wykona\u0107 <a href=\"https:\/\/www.docs.pay.sibs.com\/transaction-types\/one-time-purchase\/\" target=\"_blank\" rel=\"noopener\">jednorazow\u0105 p\u0142atno\u015b\u0107<\/a> lub <a href=\"https:\/\/www.docs.pay.sibs.com\/transaction-types\/pre-authorized-capture\/\" target=\"_blank\" rel=\"noopener\">preautoryzacj\u0119<\/a> (z p\u00f3\u017aniejszym przechwyceniem \u015brodk\u00f3w).<\/p>\n<\/p>\n\t\t\t\t  <\/div>\n\t\t\t\t<\/div>\n\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\n\t\t\t\t\t\t<\/div>\n\n\n<h5 class=\"wp-block-heading\"><strong>Akcja 3: Skonfiguruj webhooki do aktualizacji transakcji<\/strong><\/h5>\n\n\n\n<p>W tym kroku skonfigurujesz webhooki, aby automatycznie otrzymywa\u0107 aktualizacje transakcji w czasie rzeczywistym, zapewniaj\u0105c, \u017ce Tw\u00f3j system zawsze posiada aktualny status p\u0142atno\u015bci.<\/p>\n\n\n\n<p>Dzi\u0119ki konfiguracji webhook\u00f3w mo\u017cesz by\u0107 powiadamiany o kluczowych zdarzeniach, takich jak udane p\u0142atno\u015bci, b\u0142\u0119dy czy inne zmiany statusu transakcji, bez konieczno\u015bci ci\u0105g\u0142ego odpytywania API.<\/p>\n\n\n\n<p>Webhooki s\u0105 zalecanym rozwi\u0105zaniem dla integracji produkcyjnych, poniewa\u017c zapewniaj\u0105 aktualizacje w czasie rzeczywistym bez potrzeby wykonywania dodatkowych wywo\u0142a\u0144 API.<\/p>\n\n\n\n<p>Aby dowiedzie\u0107 si\u0119 wi\u0119cej o naszym rozwi\u0105zaniu webhook\u00f3w, kliknij <a href=\"https:\/\/www.docs.pay.sibs.com\/sibs-backoffice\/webhooks\/\" target=\"_blank\" rel=\"noreferrer noopener\">tutaj<\/a>.<\/p>\n\n\n\n<p>Poni\u017cej znajduje si\u0119 przyk\u0142ad utworzenia zam\u00f3wienia:<\/p>\n\n\n\n<div class=\"wp-block-buttons is-layout-flex wp-block-buttons-is-layout-flex\">\n<div class=\"wp-block-button postman\"><a class=\"wp-block-button__link wp-element-button\" href=\"https:\/\/www.postman.com\/warped-star-117264\/workspace\/sibs-v3\/request\/28493802-93d92a5b-3944-42cd-bdf3-1a7a44e94715?ctx=documentation\" target=\"_blank\" rel=\"noreferrer noopener\">Run in Postman<\/a><\/div>\n<\/div>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Pe\u0142ny przyk\u0142ad \u017c\u0105dania (konfiguracja zaawansowana)<\/strong><\/h5>\n\n\n\n<p>Poni\u017cszy przyk\u0142ad przedstawia kompletne \u017c\u0105danie zawieraj\u0105ce pola opcjonalne oraz zaawansowane. W przypadku podstawowej integracji Formularza P\u0142atno\u015bci wymagany jest jedynie podzbi\u00f3r tych p\u00f3l.<\/p>\n\n\n\n<p>Dodatkowe pola, takie jak informacje o urz\u0105dzeniu czy rozszerzone dane, powinny by\u0107 uwzgl\u0119dniane wy\u0142\u0105cznie wtedy, gdy jest to konieczne \u2014 w zale\u017cno\u015bci od potrzeb biznesowych lub wymog\u00f3w regulacyjnych.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;\/> JSON\n{\n  \"merchant\": {\n    \"terminalId\": 47215,\n    \"channel\": \"Web\",\n    \"merchantTransactionId\": \"ORDER_20260309_001\",\n    \"transactionDescription\": \"Payment for order #1001\",\n    \"shopURL\": \"https:\/\/myshop.com\"\n  },\n  \"customer\": {\n    \"customerInfo\": {\n      \"customerName\": \"Jan Kowalski\",\n      \"customerEmail\": \"jan.kowalski@example.com\",\n      \"customerPhone\": \"+48500123456\",\n      \"customerLanguage\": \"pl\"\n    },\n    \"shippingAddress\": {\n      \"street1\": \"Marszalkowska 10\",\n      \"street2\": \"Apartment 5\",\n      \"city\": \"Warsaw\",\n      \"postcode\": \"00-001\",\n      \"countrySubDivision\": \"PL\",\n      \"country\": \"PL\"\n    },\n    \"billingAddressSameAsShippingAddress\": true\n  },\n  \"transaction\": {\n    \"transactionTimestamp\": \"2026-03-09T14:30:00.000Z\",\n    \"description\": \"Order payment\",\n    \"moto\": false,\n    \"paymentType\": \"PURS\",\n    \"paymentMethod\": &#91;\n      \"CARD\",\n      \"BLIK\"\n    ],\n    \"amount\": {\n      \"value\": 50.50,\n      \"currency\": \"EUR\"\n    }\n  },\n  \"info\": {\n    \"deviceInfo\": {\n      \"browserAcceptHeader\": \"text\/html\",\n      \"browserJavaEnabled\": \"true\",\n      \"browserJavascriptEnabled\": \"true\",\n      \"browserLanguage\": \"en-US\",\n      \"browserColorDepth\": \"24\",\n      \"browserScreenHeight\": \"1080\",\n      \"browserScreenWidth\": \"1920\",\n      \"browserTZ\": \"GMT+1\",\n      \"browserUserAgent\": \"Mozilla\/5.0 (Windows NT 10.0; Win64; x64)\",\n      \"systemFamily\": \"Windows\",\n      \"systemVersion\": \"10\",\n      \"systemArchitecture\": \"x64\",\n      \"deviceManufacturer\": \"Dell\",\n      \"deviceModel\": \"XPS 15\",\n      \"deviceID\": \"12345-67890\",\n      \"applicationName\": \"Form:MyShopCheckout\",\n      \"applicationVersion\": \"1.0\",\n      \"geoLocalization\": \"52.2297,21.0122\",\n      \"ipAddress\": \"192.168.1.10\"\n    }\n  },\n  \"extendedInfo\": &#91;\n    {\n      \"key\": \"loyaltyId\",\n      \"value\": \"LTY-998877\"\n    }\n  ]\n}\n<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Krok 2: Utworzenie Formularza P\u0142atno\u015bci<\/strong><\/h3>\n\n\n\n<p>Po utworzeniu zam\u00f3wienia mo\u017cesz wy\u015bwietli\u0107 Formularz P\u0142atno\u015bci na stronie checkout.<\/p>\n\n\n\n<p>Og\u00f3lny przebieg integracji:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Backend tworzy zam\u00f3wienie <\/li>\n\n\n\n<li>Frontend renderuje Formularz P\u0142atno\u015bci na podstawie odpowiedzi <\/li>\n\n\n\n<li>Klient wprowadza dane p\u0142atno\u015bci w bezpieczny spos\u00f3b <\/li>\n\n\n\n<li>SIBS Gateway przetwarza p\u0142atno\u015b\u0107 <\/li>\n\n\n\n<li>Backend pobiera ko\u0144cowy status transakcji<\/li>\n<\/ol>\n\n\n\n<p>Do tego wykorzystasz warto\u015bci <mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transactionID<\/mark> oraz <mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">formContext<\/mark> zwr\u00f3cone w <strong>Kroku 1<\/strong>.<\/p>\n\n\n\n<p>Frontend odpowiada za renderowanie formularza, natomiast SIBS Gateway bezpiecznie obs\u0142uguje dane p\u0142atno\u015bci.<\/p>\n\n\n\n<p>\u017badne wra\u017cliwe dane p\u0142atnicze nie s\u0105 przetwarzane ani przechowywane w Twoich systemach, poniewa\u017c ca\u0142y proces zbierania i przetwarzania danych jest bezpiecznie zarz\u0105dzany przez SIBS Gateway, co pomaga zmniejszy\u0107 zakres PCI i nak\u0142ad pracy zwi\u0105zany ze zgodno\u015bci\u0105.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Renderowanie Formularza P\u0142atno\u015bci<\/strong><\/h5>\n\n\n\n<p>Aby wy\u015bwietli\u0107 Formularz P\u0142atno\u015bci, nale\u017cy doda\u0107 nast\u0119puj\u0105cy kod HTML i JavaScript na stronie checkout oraz uzupe\u0142ni\u0107 wymagane zmienne.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">1. <strong>Do\u0142\u0105cz skrypt Formularza P\u0142atno\u015bci, u\u017cywaj\u0105c transactionID zwr\u00f3conego w Kroku 1:<\/strong><\/h5>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;\/&gt; HTML\n&lt;script src=\"https:\/\/stargate.qly.site1.sibs.pt\/assets\/js\/widget.js?id={transactionID}\"&gt;&lt;\/script&gt;\n<\/code><\/pre>\n\n\n\n<p>Ten skrypt \u0142aduje Formularz P\u0142atno\u015bci i powi\u0105zuje go z wcze\u015bniej utworzon\u0105 transakcj\u0105.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>2. Dodaj kontener Formularza P\u0142atno\u015bci, u\u017cywaj\u0105c formContext i formConfig:<\/strong><\/h5>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;\/&gt; HTML\n&lt;form class=\"paymentSPG\" spg-context=\"{formContext}\" spg-config=\"{formConfig}\"&gt;&lt;\/form&gt;\n<\/code><\/pre>\n\n\n\n<p><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">formContext<\/mark> jest zwracany w odpowiedzi z Kroku 1 i zawiera bezpieczne dane sesji wymagane do inicjalizacji formularza.<br><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">formConfig<\/mark> jest definiowany przez Ciebie i kontroluje spos\u00f3b wy\u015bwietlania oraz dzia\u0142anie Formularza P\u0142atno\u015bci.<\/p>\n\n\n\n<p>Pozwala on kontrolowa\u0107, w jaki spos\u00f3b formularz jest wy\u015bwietlany, w tym:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Kt\u00f3re metody p\u0142atno\u015bci s\u0105 pokazywane<\/li>\n\n\n\n<li>Kwot\u0119 i walut\u0119 transakcji<\/li>\n\n\n\n<li>J\u0119zyk formularza<\/li>\n\n\n\n<li>Zachowanie po dokonaniu p\u0142atno\u015bci (przekierowanie)<\/li>\n<\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;\/&gt; JavaScript\n\nconst CHECKOUT_REQUEST_EXAMPLE = {\n  \"merchant\": {\n    \"terminalId\": 47215,\n    \"channel\": \"web\",\n    \"merchantTransactionId\": \"5351136\"\n  },\n  \"transaction\": {\n    \"transactionTimestamp\": \"2020-05-20T15:41:56.971Z\",\n    \"description\": \"Transaction short description\",\n    \"moto\": false,\n    \"paymentType\": \"AUTH\",\n    \"amount\": {\n      \"value\": 5,\n      \"currency\": \"EUR\"\n    },\n    \"paymentMethod\": &#91;\n      \"REFERENCE\",\n      \"CARD\",\n      \"MBWAY\"\n    ],\n    \"paymentReference\": {\n      \"initialDatetime\": \"2020-05-20T15:41:56.971Z\",\n      \"finalDatetime\": \"2020-12-31T15:41:56.971Z\",\n      \"maxAmount\": { \"value\": 5, \"currency\": \"EUR\" },\n      \"minAmount\": { \"value\": 5, \"currency\": \"EUR\" },\n      \"entity\": \"25100\"\n    }\n  }\n};\n\nconst FORM_CONFIG_EXAMPLE = {\n  \"paymentMethodList\": &#91;\"\"],\n  \"amount\": { \"value\": 2, \"currency\": \"EUR\" },\n  \"language\": \"en\",\n  \"redirectUrl\": \"https:\/\/www.google.com\/\"\n};<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Parametry formConfig<\/strong><\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Parameter<\/th><th>Type<\/th><th>Available values<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethodList<\/mark><\/td><td>string<\/td><td>Multiple<\/td><td>Okre\u015bla metody p\u0142atno\u015bci wy\u015bwietlane w formularzu.<br>Powinno to by\u0107 zgodne z paymentMethodList zwr\u00f3conym w odpowiedzi z Kroku 1, aby zapewni\u0107, \u017ce klientowi wy\u015bwietlane s\u0105 wy\u0142\u0105cznie dost\u0119pne metody p\u0142atno\u015bci..<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">amount<\/mark><\/td><td><\/td><td>&#8211;<\/td><td>Kwota i waluta<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">language<\/mark><\/td><td>string<\/td><td>en, pl, nl, fr, de, cs, pt, ro, es, bg, lt<\/td><td>J\u0119zyk formularza (ISO 639-1 format)<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">redirectUrl<\/mark><\/td><td>string<\/td><td>&#8211;<\/td><td>URL przekierowania po p\u0142atno\u015bci<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Opcjonalna personalizacja<\/strong><\/h5>\n\n\n\n<p>Mo\u017cesz dostosowa\u0107 wygl\u0105d formularza za pomoc\u0105 formStyle.<br>Szczeg\u00f3\u0142y znajdziesz w sekcji dotycz\u0105cej <a href=\"https:\/\/www.docs.pay.sibs.com\/integrations\/payment-form\/customized-form\/\" target=\"_blank\" rel=\"noreferrer noopener\">personalizacji formularza.<\/a><\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Co dzieje si\u0119 po p\u0142atno\u015bci<\/strong><\/h5>\n\n\n\n<p>Po przetworzeniu p\u0142atno\u015bci:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Wy\u015bwietlana jest strona statusu transakcji;<\/li>\n\n\n\n<li>Klient zostaje automatycznie przekierowany na redirectUrl.<\/li>\n<\/ul>\n\n\n\n<p>Zapewnia to p\u0142ynne do\u015bwiadczenie podczas finalizacji zam\u00f3wienia, przy jednoczesnym tym, \u017ce wszystkie wra\u017cliwe dane p\u0142atnicze s\u0105 obs\u0142ugiwane przez SIBS.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Podgl\u0105d Formularza P\u0142atno\u015bci<\/strong><\/h5>\n\n\n\n<p>Poni\u017cej mo\u017cna zobaczy\u0107 Formularz P\u0142atno\u015bci w jego domy\u015blnym uk\u0142adzie, dost\u0119pnym zar\u00f3wno na komputerach, jak i urz\u0105dzeniach mobilnych:<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"3248\" height=\"1824\" src=\"https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL.png\" alt=\"\" class=\"wp-image-20937\" srcset=\"https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL.png 3248w, https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL-300x168.png 300w, https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL-1024x575.png 1024w, https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL-768x431.png 768w, https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL-1536x863.png 1536w, https:\/\/www.qly.docs.pay.sibs.com\/wp-content\/uploads\/2024\/09\/Payment-form-PL-2048x1150.png 2048w\" sizes=\"auto, (max-width: 3248px) 100vw, 3248px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Krok 3: Pobranie statusu p\u0142atno\u015bci<\/strong><\/h3>\n\n\n\n<p>Po zako\u0144czeniu procesu mo\u017cesz pobra\u0107 ko\u0144cowy status transakcji za pomoc\u0105 \u017c\u0105dania GET.<\/p>\n\n\n\n<p>Pozwala to uruchomi\u0107 logik\u0119 biznesow\u0105 (np. realizacj\u0119 zam\u00f3wienia lub powiadomienia), zweryfikowa\u0107 wynik p\u0142atno\u015bci oraz zaktualizowa\u0107 status zam\u00f3wienia.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Szczeg\u00f3\u0142y \u017c\u0105dania<\/strong><\/h5>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;\/&gt; HTTP\n\nGET https:\/\/stargate.qly.site1.sibs.pt\/api\/v1\/payments\/{transactionID}\/status\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\"><strong>Nag\u0142\u00f3wki<\/strong><\/h5>\n\n\n\n<p>Authorization: Bearer &lt;AuthToken&gt;<br>X-IBM-Client-Id: &lt;ClientId&gt;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Zintegruj Formularz P\u0142atno\u015bci szybko i zacznij bezpiecznie przyjmowa\u0107 p\u0142atno\u015bci, jednocze\u015bnie utrzymuj\u0105c wra\u017cliwe dane poza swoimi systemami. Ten przewodnik przeprowadzi Ci\u0119 przez ka\u017cdy etap integracji \u2014 od utworzenia zam\u00f3wienia, przez wygenerowanie Formularza P\u0142atno\u015bci, a\u017c po sprawdzenie statusu transakcji. Krok 1: Utworzenie zam\u00f3wienia Gdy klient jest gotowy do dokonania p\u0142atno\u015bci, rozpocznij od utworzenia zam\u00f3wienia. Spowoduje to zainicjowanie [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":9947,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_eb_attr":"","footnotes":""},"class_list":["post-10591","page","type-page","status-publish","hentry","has-post-title","has-post-date","has-post-category","has-post-tag","has-post-comment","has-post-author",""],"acf":[],"builder_content":"","_links":{"self":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10591","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/comments?post=10591"}],"version-history":[{"count":4,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10591\/revisions"}],"predecessor-version":[{"id":29637,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10591\/revisions\/29637"}],"up":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/9947"}],"wp:attachment":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/media?parent=10591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}