{"id":10451,"date":"2023-08-29T11:47:22","date_gmt":"2023-08-29T11:47:22","guid":{"rendered":"https:\/\/www.qly.docs.pay.sibs.com\/powiadomienia\/webhooks\/operacje-api\/"},"modified":"2025-03-12T12:19:29","modified_gmt":"2025-03-12T12:19:29","slug":"operacje-api","status":"publish","type":"page","link":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/sibs-gateway-dokumentacja\/powiadomienia\/webhooki\/operacje-api\/","title":{"rendered":"Operacje API"},"content":{"rendered":"<!-- wp:themify-builder\/canvas \/-->\n\n\n<p>W tej sekcji zag\u0142\u0119bimy si\u0119 w operacje webhook API (FULL CODE), obejmuj\u0105ce procesy tworzenia webhook\u00f3w, pobierania listy webhook\u00f3w i aktualizacji webhook\u00f3w, obejmuj\u0105ce r\u00f3\u017cne aspekty, takie jak metoda operacji, punkt ko\u0144cowy (endpoint) i szczeg\u00f3\u0142y \u017c\u0105dania.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Utw\u00f3rz webhook<\/h3>\n\n\n\n<p>W tym segmencie zbadamy proces tworzenia webhook\u00f3w, przedstawiaj\u0105c niezb\u0119dne kroki, parametry i szczeg\u00f3\u0142y uwierzytelniania. <\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Punkty ko\u0144cowe:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Operacje<\/strong><\/th><th><strong>Typ operacji<\/strong><\/th><th><strong>Metoda dzia\u0142ania i punkt ko\u0144cowy<\/strong><\/th><th><strong>Opis operacji<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Tworzenie \u017c\u0105dania Webhook<\/td><td>Po\u0142\u0105czenie<\/td><td><mark style=\"background-color:#d6e9ff\" class=\"has-inline-color\">POST<\/mark> version-id\/acquirers\/{acquirer-id}\/merchants\/{merchant-id}\/terminal\/webhook<\/td><td>Skonfiguruj zas\u00f3b tworzenia elementu Webhook.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Poni\u017csza tabela przedstawia szczeg\u00f3\u0142y wymagane do zainicjowania operacji <strong>Utw\u00f3rz Webhook<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u015acie\u017cka<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acquirer-id<\/mark><\/td><td>Max25NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod nabywcy<\/td><\/tr><tr><td>\u015acie\u017cka<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant-id<\/mark><\/td><td>Max10NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod nabywcy<\/td><\/tr><tr><td>Parametr zapytania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acceptorId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod nabywcy<\/td><\/tr><tr><td>Parametr zapytania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">terminalId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod terminala (Terminal Code)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry nag\u0142\u00f3wka:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Content-Type<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>application\/json<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Autoryzacja<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token okaziciela. Na podstawie uwierzytelniania OAuth2 przeprowadzonego w kroku wst\u0119pnym.<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">x-ibm-client-id<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token identyfikuj\u0105cy organizacj\u0119 klienta. Jest on dostarczany podczas procesu wdra\u017cania i musi by\u0107 u\u017cywany w ka\u017cdym po\u0142\u0105czeniu.<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator \u017c\u0105dania, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105. <\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja u\u017cytkownika odpowiedzialnego za \u017c\u0105danie (wymagana do cel\u00f3w audytu).<\/td><\/tr><tr><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-Organization-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja organizacji odpowiedzialnej za wniosek (wymagana do cel\u00f3w audytu). <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry \u017c\u0105dania:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationConfigurationCode<\/mark><\/td><td>Max35Text<\/td><td>Obowi\u0105zkowe<\/td><td>UUID konfiguracji powiadomienia<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">requestOperationType<\/mark><\/td><td>Max3Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu operacji \u017c\u0105dania<br>Enum:<br>INS &#8211; Wstaw<br>DEL &#8211; Usu\u0144<br>Ustaw za pomoc\u0105 'INS&#8217;.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethods<\/mark><\/td><td>Metody p\u0142atno\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Szereg metod p\u0142atno\u015bci<\/td><\/tr><tr><td>Request Body.paymentMethods<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethodNotificationCode<\/mark><\/td><td>Max15Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia o metodzie p\u0142atno\u015bci<br>Enum:<br>MBWY-&#8217;MB WAY&#8217;<br>CARD-&#8217;Card Payments&#8217;<br>BLIK-&#8217;BLIK&#8217;<br>PYBL-&#8217;Pay By Link &#8211; Blue Media&#8217;<br>XPAY-&#8217;XPAY Payments&#8217;\u00a0<br>BNCT-&#8217;Bancontact&#8217;<br>IDEL-&#8217;Ideal&#8217;<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">channelTypeNotification<\/mark><\/td><td>Typ kana\u0142u Powiadomienie <\/td><td>Obowi\u0105zkowe<\/td><td>Zawiera wszystkie dane zwi\u0105zane z powiadomieniem o typie kana\u0142u.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationType<\/mark><\/td><td>Max5Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia<br>Enum:<br>EMAIL<br>URL<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">warto\u015b\u0107<\/mark><\/td><td>Max2048Text<\/td><td>Obowi\u0105zkowe<\/td><td>Warto\u015b\u0107 powiadomienia (email or URL)<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">bezpiecze\u0144stwo<\/mark><\/td><td>Bezpiecze\u0144stwo<\/td><td>Warunkowy<\/td><td>Obejmuje on wszystkie dane zwi\u0105zane z bezpiecze\u0144stwem.<br>Ta struktura (i wszystkie powi\u0105zane elementy danych) powinna by\u0107 prezentowana tylko wtedy, gdy warto\u015b\u0107 kodu typu powiadomienia to &#8222;URL&#8221;.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">klucz<\/mark><\/td><td>Max32Text (Base64)<\/td><td>Warunkowy<\/td><td>Klucz bezpiecze\u0144stwa (tajny).<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">supportEmail<\/mark><\/td><td>Max256Text<\/td><td>Warunkowy<\/td><td>E-mail wsparcia.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">algorytm<\/mark><\/td><td>Max70Text<\/td><td>Warunkowy<\/td><td>Algorytm<br>Ustawienie 'AES-256-GCM&#8217;.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>W tym miejscu mo\u017cna przejrze\u0107 struktur\u0119 odpowiedzi wynikaj\u0105c\u0105 z operacji <strong> Utw\u00f3rz Webhook<\/strong> :<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Nag\u0142\u00f3wek odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>UUID<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator \u017c\u0105dania, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transactionStatus<\/mark><\/td><td>Status transakcji<\/td><td>Obowi\u0105zkowe<\/td><td>Status transakcji <br>Mo\u017cliwe warto\u015bci to &#8222;ACTC-Accepted Technical Validation&#8221; i &#8222;RJCT-Rejected&#8221;.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi <\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">returnStatus<\/mark><\/td><td>Status zwrotu<\/td><td>Obowi\u0105zkowe<\/td><td><\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusCode<\/mark><\/td><td>Kod wiadomo\u015bci <\/td><td>Obowi\u0105zkowe<\/td><td>&#8222;000&#8221; oznacza sukces. Warto\u015bci r\u00f3\u017cne od &#8222;000&#8221; oznaczaj\u0105 b\u0142\u0119dy.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusMsg<\/mark><\/td><td>Typ wiadomo\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Komunikat o wynikach.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusDescription<\/mark><\/td><td>Max512Text<\/td><td>Obowi\u0105zkowe<\/td><td>Dodatkowy tekst wyja\u015bniaj\u0105cy.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Pobierz list\u0119 webhook\u00f3w<\/h3>\n\n\n\n<p>W tej sekcji przedstawiamy szczeg\u00f3\u0142owe informacje na temat operacji <strong>Pobierz list\u0119 Webhook\u00f3w<\/strong>, obejmuj\u0105ce metod\u0119 operacji, Punkt ko\u0144cowy (Endpoint) i elementy niezb\u0119dne do pobrania listy webhook\u00f3w, wraz ze strukturami \u017c\u0105dania i odpowiedzi API (FULL CODE) w celach informacyjnych.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Operacje<\/strong><\/th><th><strong>Typ operacji<\/strong><\/th><th><strong>Metoda dzia\u0142ania i punkt ko\u0144cowy<\/strong><\/th><th><strong>Opis operacji<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u017b\u0105danie 'Pobierz list\u0119 webhook\u00f3w&#8217;<\/td><td>Po\u0142\u0105czenie<\/td><td><mark style=\"background-color:#d6e9ff\" class=\"has-inline-color\">POST<\/mark> version-id\/webhooks<\/td><td>Pobierz list\u0119 webhook\u00f3w.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Poni\u017csza tabela przedstawia wymagane elementy danych i ich warunki inicjowania \u017c\u0105dania.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry nag\u0142\u00f3wka:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Lokalizacja<\/th><th>Element danych<\/th><th>Typ<\/th><th>Stan<\/th><th>Opis<\/th><\/tr><\/thead><tbody><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Content-Type<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>application\/json <\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Autoryzacja<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token okaziciela. Na podstawie uwierzytelniania OAuth2 przeprowadzonego w kroku wst\u0119pnym.<\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">x-ibm-client-id<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token identyfikuj\u0105cy organizacj\u0119 klienta. Jest on dostarczany podczas procesu wdra\u017cania i musi by\u0107 u\u017cywany w ka\u017cdym po\u0142\u0105czeniu.<\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>UUID<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator \u017c\u0105dania, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105. <\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania <\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja u\u017cytkownika odpowiedzialnego za \u017c\u0105danie (wymagana do cel\u00f3w audytu). <\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-Organization-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja organizacji odpowiedzialnej za wniosek (wymagana do cel\u00f3w audytu). <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry \u017c\u0105dania:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Lokalizacja<\/th><th>Element danych<\/th><th>Typ<\/th><th>Stan<\/th><th>Opis<\/th><\/tr><\/thead><tbody><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acquirerId<\/mark><\/td><td>Max25NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod nabywcy<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchantId<\/mark><\/td><td>Max10NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod sprzedawcy<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acceptorId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod akceptora<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">terminalId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod terminala (Terminal Code)<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Tabela przedstawia oczekiwane elementy odpowiedzi:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Nag\u0142\u00f3wek odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>UUID<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator odpowiedzi, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105. <\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transactionStatus<\/mark><\/td><td>Status transakcji<\/td><td>Obowi\u0105zkowe<\/td><td>Status transakcji <br>Mo\u017cliwe warto\u015bci to &#8222;ACTC-Accepted Technical Validation&#8221; i &#8222;RJCT-Rejected&#8221;.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi <\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">returnStatus<\/mark><\/td><td>Status zwrotu<\/td><td>Obowi\u0105zkowe<\/td><td><\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusCode<\/mark><\/td><td>Status transakcji. <\/td><td>Obowi\u0105zkowe<\/td><td>&#8222;000&#8221; oznacza sukces. Warto\u015bci r\u00f3\u017cne od &#8222;000&#8221; oznaczaj\u0105 b\u0142\u0119dy.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusMsg<\/mark><\/td><td>Typ wiadomo\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Komunikat o wynikach.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusDescription<\/mark><\/td><td>Max512Text<\/td><td>Obowi\u0105zkowe<\/td><td>Dodatkowy tekst wyja\u015bniaj\u0105cy.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">webhooks<\/mark><\/td><td>Tablica webhook\u00f3w<\/td><td>Warunkowy<\/td><td>Lista danych szczeg\u00f3\u0142owych zasobu webhook.<br>Wyst\u0119puje tylko w odpowiedziach pomy\u015blnych.<\/td><\/tr><tr><td>Response Body.webhooks<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">webhook<\/mark><\/td><td>Webhook<\/td><td>Obowi\u0105zkowe<\/td><td>Tablica webhook\u00f3w<\/td><\/tr><tr><td>Response Body.webhooks.webhook<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationConfigurationCode<\/mark><\/td><td>Max36Text<\/td><td>Obowi\u0105zkowe<\/td><td>UUID konfiguracji powiadomienia<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethods<\/mark><\/td><td>metody p\u0142atno\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Szereg metod p\u0142atno\u015bci<\/td><\/tr><tr><td>Response Body.paymentMethods<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethodNotificationCode<\/mark><\/td><td>Max15Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia o metodzie p\u0142atno\u015bci<br>Enum:<br>CARD-&#8217;P\u0142atno\u015bci kart\u0105&#8217;<br>PYBL-&#8217;Pay By Link &#8211; Blue Media&#8217;<br>PLKV-&#8217;Pay By Link &#8211; kevin&#8217;<br>BLIK-&#8217;BLIK&#8217;<br>XPAY-&#8217;XPAY Payments&#8217; <br>BNPL-&#8217;Buy Now Pay Later -Paywerk&#8217;<br>BNCT-&#8217;Bancontact&#8217;<br>IDEL-&#8217;Ideal&#8217;<\/td><\/tr><tr><td>Response Body.webhooks.webhook<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">channelTypeNotification<\/mark><\/td><td>Typ kana\u0142u Powiadomienie <\/td><td>Obowi\u0105zkowe<\/td><td>Zawiera wszystkie dane zwi\u0105zane z powiadomieniem o typie kana\u0142u.<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationType<\/mark><\/td><td>Max5Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia<br>Enum:<br>EMAIL<br>URL<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">warto\u015b\u0107<\/mark><\/td><td>Max2048Text<\/td><td>Obowi\u0105zkowe<\/td><td>Warto\u015b\u0107 powiadomienia (email or URL).<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">bezpiecze\u0144stwo<\/mark><\/td><td>Bezpiecze\u0144stwo<\/td><td>Warunkowy<\/td><td>Obejmuje on wszystkie dane zwi\u0105zane z bezpiecze\u0144stwem.<br>Ta struktura (i wszystkie powi\u0105zane elementy danych) powinna by\u0107 prezentowana tylko wtedy, gdy warto\u015b\u0107 kodu typu powiadomienia to &#8222;URL&#8221;.<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">klucz<\/mark><\/td><td>Max32Text (Base64)<\/td><td>Warunkowy<\/td><td>Klucz bezpiecze\u0144stwa (tajny).<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">supportEmail<\/mark><\/td><td>Max256Text<\/td><td>Warunkowy<\/td><td>E-mail wsparcia.<\/td><\/tr><tr><td>Response Body.webhooks.webhook.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">algorytm<\/mark><\/td><td>Max70Text<\/td><td>Warunkowy<\/td><td>Algorytm.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Aktualizacja webhook\u00f3w<\/h3>\n\n\n\n<p>Tutaj omawiamy metod\u0119 operacji, Punkt ko\u0144cowy (Endpoint) i odpowiednie elementy wymagane do modyfikacji zasobu webhook. Obejmuje to om\u00f3wienie struktur \u017c\u0105da\u0144 i odpowiedzi API (FULL CODE) w celach informacyjnych.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Operacje<\/strong><\/th><th><strong>Typ operacji<\/strong><\/th><th><strong>Metoda dzia\u0142ania i punkt ko\u0144cowy<\/strong><\/th><th><strong>Opis operacji<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u017b\u0105danie aktualizacji Webhook<\/td><td>Po\u0142\u0105czenie<\/td><td><mark style=\"background-color:#d6e9ff\" class=\"has-inline-color\">PUT<\/mark> version-id\/acquirers\/{acquirer-id}\/merchants\/{merchant-id}\/terminal\/webhook<\/td><td>Aktualizacja zasobu Webhook.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Poni\u017csza tabela przedstawia podstawowe elementy niezb\u0119dne do zainicjowania \u017c\u0105dania <strong>Aktualizacja Webhook:<\/strong><\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>\u015acie\u017cka<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acquirer-id<\/mark><\/td><td>Max25NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod nabywcy<\/td><\/tr><tr><td>\u015acie\u017cka<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">merchant-id<\/mark><\/td><td>Max10NumericText<\/td><td>Obowi\u0105zkowe<\/td><td>Kod sprzedawcy<\/td><\/tr><tr><td>Parametr zapytania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">acceptorId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod akceptanta w programie Merchant<\/td><\/tr><tr><td>Parametr zapytania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">terminalId<\/mark><\/td><td>Max10NumericText<\/td><td>Opcjonalnie<\/td><td>Kod terminala (Terminal Code).<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry nag\u0142\u00f3wka:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Content-Type<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>application\/json<\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">Autoryzacja<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token okaziciela. Na podstawie uwierzytelniania OAuth2 przeprowadzonego w kroku wst\u0119pnym.<\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">x-ibm-client-id<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Token identyfikuj\u0105cy organizacj\u0119 klienta. Jest on dostarczany podczas procesu wdra\u017cania i musi by\u0107 u\u017cywany w ka\u017cdym po\u0142\u0105czeniu.<\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>UUID<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator \u017c\u0105dania, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105. <\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja u\u017cytkownika odpowiedzialnego za \u017c\u0105danie (wymagana do cel\u00f3w audytu). <\/td><\/tr><tr><td>Nag\u0142\u00f3wek \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">User-Organization-ID<\/mark><\/td><td>String<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikacja organizacji odpowiedzialnej za wniosek (wymagana do cel\u00f3w audytu). <\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h5 class=\"wp-block-heading\">Parametry \u017c\u0105dania:<\/h5>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Lokalizacja<\/th><th>Element danych<\/th><th>Typ<\/th><th>Stan<\/th><th>Opis<\/th><\/tr><\/thead><tbody><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationConfigurationCode<\/mark><\/td><td>Max35Text<\/td><td>Obowi\u0105zkowe<\/td><td>UUID konfiguracji powiadomienia<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">requestOperationType<\/mark><\/td><td>Max3Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu operacji \u017c\u0105dania<br>Enum:<br>INS &#8211; Wstaw<br>DEL &#8211; Usu\u0144<br>Ustaw za pomoc\u0105 'INS&#8217;.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethods<\/mark><\/td><td>metody p\u0142atno\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Szereg metod p\u0142atno\u015bci<\/td><\/tr><tr><td>Request Body.paymentMethods<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">paymentMethodNotificationCode<\/mark><\/td><td>Max15Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia o metodzie p\u0142atno\u015bci<br>Enum:<br>MBWY-&#8217;MB WAY&#8217;<br>CARD-&#8217;Card Payments&#8217;<br>BLIK-&#8217;BLIK&#8217;<br>PYBL-&#8217;Pay By Link &#8211; Blue Media&#8217;<br>XPAY-&#8217;XPAY Payments&#8217;\u00a0<br>BNCT-&#8217;Bancontact&#8217;<br>IDEL-&#8217;Ideal&#8217;<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">channelTypeNotification<\/mark><\/td><td>Typ kana\u0142u Powiadomienie <\/td><td>Obowi\u0105zkowe<\/td><td>Zawiera wszystkie dane zwi\u0105zane z powiadomieniem o typie kana\u0142u.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">notificationType<\/mark><\/td><td>Max5Text<\/td><td>Obowi\u0105zkowe<\/td><td>Kod typu powiadomienia<br>Enum:<br>EMAIL<br>URL<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">warto\u015b\u0107<\/mark><\/td><td>Max2048Text<\/td><td>Obowi\u0105zkowe<\/td><td>Warto\u015b\u0107 powiadomienia (email or URL)<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">bezpiecze\u0144stwo<\/mark><\/td><td>Bezpiecze\u0144stwo<\/td><td>Warunkowy<\/td><td>Obejmuje on wszystkie dane zwi\u0105zane z bezpiecze\u0144stwem.<br>Ta struktura (i wszystkie powi\u0105zane elementy danych) powinna by\u0107 prezentowana tylko wtedy, gdy warto\u015b\u0107 kodu typu powiadomienia to &#8222;URL&#8221;.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">klucz<\/mark><\/td><td>Max32Text<\/td><td>Warunkowy<\/td><td>Klucz bezpiecze\u0144stwa (tajny).<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">supportEmail<\/mark><\/td><td>Max256Text<\/td><td>Warunkowy<\/td><td>E-mail wsparcia.<\/td><\/tr><tr><td>Tre\u015b\u0107 \u017c\u0105dania.channelTypeNotification.security<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">algorytm<\/mark><\/td><td>Max70Text<\/td><td>Warunkowy<\/td><td>Algorytm<br>Ustawienie 'AES-256-GCM&#8217;.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Tabela przedstawia komponenty odpowiedzi dla operacji <strong>Aktualizacja Webhook<\/strong>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Lokalizacja<\/strong><\/th><th><strong>Element danych<\/strong><\/th><th><strong>Typ<\/strong><\/th><th><strong>Stan<\/strong><\/th><th><strong>Opis<\/strong><\/th><\/tr><\/thead><tbody><tr><td>Nag\u0142\u00f3wek odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">TPP-Request-ID<\/mark><\/td><td>UUID<\/td><td>Obowi\u0105zkowe<\/td><td>Identyfikator \u017c\u0105dania, unikalny dla po\u0142\u0105czenia, okre\u015blony przez stron\u0119 inicjuj\u0105c\u0105.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">transactionStatus<\/mark><\/td><td>Status transakcji<\/td><td>Obowi\u0105zkowe<\/td><td>Status transakcji <br>Mo\u017cliwe warto\u015bci to &#8222;ACTC-Accepted Technical Validation&#8221; i &#8222;RJCT-Rejected&#8221;.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi <\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">returnStatus<\/mark><\/td><td>Status zwrotu<\/td><td>Obowi\u0105zkowe<\/td><td><\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusCode<\/mark><\/td><td>Kod wiadomo\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>&#8222;000&#8221; oznacza sukces. Warto\u015bci r\u00f3\u017cne od &#8222;000&#8221; oznaczaj\u0105 b\u0142\u0119dy.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusMsg<\/mark><\/td><td>Typ wiadomo\u015bci<\/td><td>Obowi\u0105zkowe<\/td><td>Komunikat o wynikach.<\/td><\/tr><tr><td>Tre\u015b\u0107 odpowiedzi.returnStatus<\/td><td><mark style=\"background-color:#e9e9f5\" class=\"has-inline-color\">statusDescription<\/mark><\/td><td>Max512Text<\/td><td>Obowi\u0105zkowe<\/td><td>Dodatkowy tekst wyja\u015bniaj\u0105cy.<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>W tej sekcji zag\u0142\u0119bimy si\u0119 w operacje webhook API (FULL CODE), obejmuj\u0105ce procesy tworzenia webhook\u00f3w, pobierania listy webhook\u00f3w i aktualizacji webhook\u00f3w, obejmuj\u0105ce r\u00f3\u017cne aspekty, takie jak metoda operacji, punkt ko\u0144cowy (endpoint) i szczeg\u00f3\u0142y \u017c\u0105dania. Utw\u00f3rz webhook W tym segmencie zbadamy proces tworzenia webhook\u00f3w, przedstawiaj\u0105c niezb\u0119dne kroki, parametry i szczeg\u00f3\u0142y uwierzytelniania. Punkty ko\u0144cowe: Operacje Typ operacji [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":10428,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_eb_attr":"","footnotes":""},"class_list":["post-10451","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\/10451","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\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/comments?post=10451"}],"version-history":[{"count":5,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10451\/revisions"}],"predecessor-version":[{"id":23155,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10451\/revisions\/23155"}],"up":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/10428"}],"wp:attachment":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/media?parent=10451"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}