{"id":22363,"date":"2025-01-08T09:53:27","date_gmt":"2025-01-08T09:53:27","guid":{"rendered":"https:\/\/www.qly.docs.pay.sibs.com\/metody-platnosci\/inne\/bizum\/"},"modified":"2026-03-09T10:53:22","modified_gmt":"2026-03-09T10:53:22","slug":"bizum","status":"publish","type":"page","link":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/sibs-gateway-dokumentacja\/metody-platnosci\/inne\/bizum\/","title":{"rendered":"Bizum"},"content":{"rendered":"\n\n\n
\"\"<\/figure>\n\n\n\n

Bizum to szybkie, bezpieczne i wygodne hiszpa\u0144skie rozwi\u0105zanie p\u0142atnicze, kt\u00f3re umo\u017cliwia u\u017cytkownikom dokonywanie natychmiastowych transakcji bezpo\u015brednio z konta bankowego.<\/p>\n\n\n\n

Metoda p\u0142atno\u015bci<\/th>Kategoria<\/th>Kraj<\/th>Waluta<\/th>Funkcjonalno\u015bci<\/th>Integracje<\/th><\/tr><\/thead>
Bizum<\/td>Online Banking<\/td>Hiszpania<\/td>EUR<\/td>Cz\u0119\u015bciowy zwrot koszt\u00f3w
Zwrot koszt\u00f3w<\/td>		API
Formularz p\u0142atno\u015bci
Wtyczka Prestashop
Wtyczka WooCommerce
Wtyczka Magento<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Bizum to jedna z najpowszechniej u\u017cywanych metod p\u0142atno\u015bci w Hiszpanii, ciesz\u0105ca si\u0119 zaufaniem milion\u00f3w u\u017cytkownik\u00f3w ze wzgl\u0119du na jej szybko\u015b\u0107, prostot\u0119 i bezpiecze\u0144stwo. U\u0142atwia p\u0142ynne przelewy pieni\u0119\u017cne i p\u0142atno\u015bci bezpo\u015brednio za po\u015brednictwem istniej\u0105cych kont bankowych u\u017cytkownik\u00f3w.<\/p>\n\n\n\n

Klienci korzystaj\u0105cy z Bizum podaj\u0105 sw\u00f3j numer telefonu kom\u00f3rkowego, otrzymuj\u0105 powiadomienie w aplikacji swojego banku i potwierdzaj\u0105 transakcj\u0119. To bardzo bezpieczny spos\u00f3b, z natychmiastowym powiadomieniem o p\u0142atno\u015bci.<\/p>\n\n\n\n

Jak korzysta\u0107 z Bizum<\/h3>\n\n\n\n

\u015acie\u017cka przebiega w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n\n\n\n

    \n
  1. Na stronie realizacji transakcji sprzedawca wybiera Bizum jako metod\u0119 p\u0142atno\u015bci i uruchamia si\u0119 \u017c\u0105dania p\u0142atno\u015bci.<\/li>\n\n\n\n
  2. Klient zostaje przekierowany na stron\u0119, na kt\u00f3rej wpisuje numer telefonu Bizum.<\/li>\n\n\n\n
  3. Klient otrzymuje powiadomienie w swojej aplikacji bankowej z pro\u015bb\u0105 o potwierdzenie p\u0142atno\u015bci.<\/li>\n\n\n\n
  4. Klient potwierdza p\u0142atno\u015b\u0107 za po\u015brednictwem aplikacji bankowej.<\/li>\n\n\n\n
  5. Sprzedawca otrzymuje potwierdzenie p\u0142atno\u015bci.<\/li>\n\n\n\n
  6. Sprzedawca mo\u017ce wys\u0142a\u0107 zam\u00f3wienie\/dostarczy\u0107 towar do klienta.<\/li>\n<\/ol>\n\n\n\n

    Jak to dzia\u0142a<\/h3>\n\n\n\n

    Oto przegl\u0105d najwa\u017cniejszych krok\u00f3w wymaganych do integracji Bizum.<\/p>\n\n\n\n

    Oto przegl\u0105d najwa\u017cniejszych krok\u00f3w wymaganych do integracji Bizum.<\/p>\n\n\n\n

    Krok 1: Utw\u00f3rz zam\u00f3wienie<\/a><\/h6>\n\n\n\n
    Krok 2: Uzyskaj link do p\u0142atno\u015bci<\/a><\/h6>\n\n\n\n
    Krok 3: Uzyskaj status p\u0142atno\u015bci<\/a><\/h6>\n\n\n\n
    Krok 1: Utw\u00f3rz zam\u00f3wienie<\/h5>\n\n\n\n

    Pami\u0119taj, aby zainicjowa\u0107 \u017c\u0105danie zam\u00f3wienia<\/a> z Bizum („bizum”) jako wybran\u0105 metod\u0105 p\u0142atno\u015bci (transaction.paymentMethod<\/mark>) i skonfigurowa\u0107 preferencje j\u0119zykowe klienta w customerInfo.customerLanguage<\/mark>.<\/p>\n\n\n\n

    \n
    Uruchom w Postmanie<\/a><\/div>\n<\/div>\n\n\n\n
    Krok 2: Uzyskaj link do p\u0142atno\u015bci<\/h5>\n\n\n\n

    Post\u0119puj zgodnie z poni\u017cszymi instrukcjami, aby uzyska\u0107 link do p\u0142atno\u015bci, aby przekierowa\u0107 klienta na bezpieczn\u0105 stron\u0119 p\u0142atno\u015bci w celu uwierzytelnienia i autoryzacji p\u0142atno\u015bci.<\/p>\n\n\n\n

    Nale\u017cy pami\u0119ta\u0107, \u017ce poni\u017csze \u017c\u0105danie wymaga nag\u0142\u00f3wka autoryzacji zawieraj\u0105cego podpis transakcji<\/mark> uzyskany w poprzednim kroku.<\/p>\n\n\n\n

    Punkty ko\u0144cowe (Endpoints):<\/h6>\n\n\n\n
    \u015arodowisko<\/th>URL<\/th>Metoda dzia\u0142ania i punkt ko\u0144cowy (Endpoint)<\/th>Opis dzia\u0142ania<\/th><\/tr><\/thead>
    PROD<\/td>api.sibsgateway.com<\/td>POST {version-id}\/payments\/{id}\/pbl\/payment-link<\/td>Przeprowadzenie transakcji i przekierowanie u\u017cytkownika do hosta p\u0142atno\u015bci.<\/td><\/tr>
    TEST<\/td>stargate.qly.site[1|2].sibs.pt<\/td>POST {version-id}\/payments\/{id}\/pbl\/payment-link<\/td>Przeprowadzenie transakcji i przekierowanie u\u017cytkownika do hosta p\u0142atno\u015bci.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Upewnij si\u0119, \u017ce zawierasz te niezb\u0119dne elementy, jak okre\u015blono:<\/p>\n\n\n\n

    Lokalizacja<\/strong><\/th>Element danych<\/strong><\/th>Typ<\/strong><\/th>Stan<\/strong><\/th>Opis<\/strong><\/th><\/tr><\/thead>
    \u015acie\u017cka<\/td>id<\/td>String<\/td>Obowi\u0105zkowe<\/td>S\u0142u\u017cy do identyfikacji transakcji<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Parametry nag\u0142\u00f3wka:<\/h6>\n\n\n\n
    Lokalizacja<\/strong><\/th>Element danych<\/strong><\/th>Typ<\/strong><\/th>Stan<\/strong><\/th>Opis<\/strong><\/th><\/tr><\/thead>
    Request Header<\/td>Content-Type<\/td>String<\/td>Obowi\u0105zkowe<\/td>application\/json<\/td><\/tr>
    Request Header<\/td>Autoryzacja<\/td>String<\/td>Obowi\u0105zkowe<\/td>Podsumowanie autoryzacji<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
    Parametry \u017c\u0105dania:<\/h6>\n\n\n\n
    Lokalizacja<\/strong><\/th>Element danych<\/strong><\/th>Typ<\/strong><\/th>Stan<\/strong><\/th>Opis<\/strong><\/th><\/tr><\/thead>
    Tre\u015b\u0107 \u017c\u0105dania<\/td>userAcceptanceIndicator<\/td>Warto\u015b\u0107 logiczna<\/td>Obowi\u0105zkowe<\/td>Wskazuje, czy u\u017cytkownik zaakceptowa\u0142 Regulamin w celu kontynuowania p\u0142atno\u015bci.<\/td><\/tr>
    Tre\u015b\u0107 \u017c\u0105dania<\/td>gatewayId<\/td>String<\/td>Obowi\u0105zkowe<\/td>Identyfikator kana\u0142u p\u0142atno\u015bci dla kana\u0142u, kt\u00f3rego klient zamierza u\u017cy\u0107 do dokonania p\u0142atno\u015bci.
    Waro\u015b\u0107: 'ideal’ – iDEAL;<\/td><\/tr>
    Tre\u015b\u0107 \u017c\u0105dania<\/td>info<\/td>Info<\/td>Obowi\u0105zkowe<\/td>Obiekt definiuj\u0105cy dodatkowe informacje o transakcji.<\/td><\/tr>
    Rz\u0105danie Body.info<\/td>deviceInfo<\/td>DeviceInfo<\/td>Opcjonalne<\/td>Obiekt definiuj\u0105cy informacje o urz\u0105dzeniu klienta.<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserAcceptHeader<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Browser Accept Header<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserJavaEnabled<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Browser Java Enabled<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserLanguage<\/td>ci\u0105g<\/td>Opcjonalne<\/td>browser Language<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserColorDepth<\/td>ci\u0105g<\/td>Opcjonalne<\/td>browser Color Depth<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserScreenHeight<\/td>ci\u0105g<\/td>Opcjonalne<\/td>browser Screen Height<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserScreenWidth<\/td>ci\u0105g<\/td>Opcjonalne<\/td>browser Screen Width<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserTZ<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Browser Time Zone<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>browserUserAgent<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Browser User Agent<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>systemFamily<\/td>ci\u0105g<\/td>Opcjonalne<\/td>System Family<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>systemVersion<\/td>ci\u0105g<\/td>Opcjonalne<\/td>System Version<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>systemArchitecture<\/td>ci\u0105g<\/td>Opcjonalne<\/td>System Architecture<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>deviceManufacturer<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Device Manufacturer<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>deviceModel<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Device Model<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>deviceID<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Device Unique Identification<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>applicationName<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Application Name<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>applicationVersion<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Application Version<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>geoLocalization<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Geolocation<\/td><\/tr>
    Request Body.info.deviceInfo<\/td>ipAddress<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Adres IP<\/td><\/tr>
    Tre\u015b\u0107 \u017c\u0105dania<\/td>customerInfo<\/td>CustomerInfo<\/td>Opcjonalne<\/td>Key Value tuple array.<\/td><\/tr>
    Request Body.customerInfo<\/td>klucz<\/td>ci\u0105g<\/td>Obowi\u0105zkowe<\/td>U\u017cywane do podania „customerName”, „customerEmail”.<\/td><\/tr>
    Request Body.customerInfo<\/td>warto\u015b\u0107<\/td>ci\u0105g<\/td>Obowi\u0105zkowe<\/td>U\u017cywane do podania „customerName”, „customerEmail”.<\/td><\/tr>
    Tre\u015b\u0107 \u017c\u0105dania<\/td>kupiec<\/td>Handlowiec<\/td>Opcjonalne<\/td>Merchant Data<\/td><\/tr>
    \u017b\u0105danie Body.merchant<\/td>merchantURL<\/td>ci\u0105g<\/td>Opcjonalne<\/td>Adres URL sklepu sprzedawcy do przekierowania.<\/td><\/tr>
    Rz\u0105danie Body.info<\/td>accountInfo<\/td>AccountInfo<\/td>Opcjonalne<\/td>Dane zwi\u0105zane z kontem
    Ma zastosowanie, gdy gatewayId jest „idealny<\/td><\/tr>
    Request Body.info.accountInfo<\/td>holderName<\/td>Max100Text<\/td>Opcjonalne<\/td>Nazwa posiadacza konta. Format UTF-8 . <\/td><\/tr>
    Request Body.info.accountInfo<\/td>customerCountry<\/td>Kod kraju Klienta<\/td>Opcjonalne<\/td>Kod kraju Klienta. Alpha2<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    Jak uzyska\u0107 link do p\u0142atno\u015bci:<\/p>\n\n\n\n

    \n
    Uruchom w Postmanie<\/a><\/div>\n<\/div>\n\n\n\n

    Poni\u017cej przyk\u0142ad \u017c\u0105dania:<\/p>\n\n\n\n

    \"userAcceptanceIndicator\"<\/mark>: true<\/mark>,\n    \"gatewayId\"<\/mark>: \"bizum\"<\/mark>,\n    \"info\"<\/mark>: {\n        \"deviceInfo\"<\/mark>: {\n            \"browserAcceptHeader\"<\/mark>: \"application\/json, text\/plain, *\/*\"<\/mark>,\n            \"browserJavaEnabled\"<\/mark>: \"false\"<\/mark>,\n            \"browserLanguage\"<\/mark>: \"en\"<\/mark>,\n            \"browserColorDepth\"<\/mark>: \"24\"<\/mark>,\n            \"browserScreenHeight\"<\/mark>: \"1080\"<\/mark>,\n            \"browserScreenWidth\"<\/mark>: \"1920\",<\/mark>\n            \"browserTZ\"<\/mark>: \"-60\"<\/mark>,\n            \"browserUserAgent\"<\/mark>: \"Mozilla\/5.0 (Windows NT 10.0; WOW64) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/106.0.0.0 Safari\/537.36\"<\/mark>,\n            \"geoLocalization\"<\/mark>: \"Lat: 38.7350528 | Long: -9.2143616\"<\/mark>,\n            \"systemFamily\"<\/mark>: \"Windows\"<\/mark>,\n            \"systemVersion\"<\/mark>: \"Windows\"<\/mark>,\n            \"deviceID\"<\/mark>: \"498bfd4c3a3645b38667a7037b616c18\"<\/mark>,\n            \"applicationName\"<\/mark>: \"Chrome\"<\/mark>,\n            \"applicationVersion\"<\/mark>: \"106\"<\/mark>\n        },\n        \"customerInfo\"<\/mark>: [\n            {\n                \"key\"<\/mark>: \"customerName\"<\/mark>,\n                \"value\"<\/mark>: \"Test Name\"<\/mark>\n            },\n            {\n                \"key\"<\/mark>: \"customerEmail\"<\/mark>,\n                \"value\"<\/mark>: \"email@provider.com\"<\/mark>\n            }\n            {\n                \"key\"<\/mark>: \"customerPhone\"<\/mark>,\n                \"value\"<\/mark>: \"34#700000000\"<\/mark>\n            }\n        ],\n        \"accountInfo\"<\/mark>: {\n            \"holderName\"<\/mark>: \"Test Name\"<\/mark>,\n            \"customerCountry\"<\/mark>: \"ES\"<\/mark>\n        }\n    },\n    \"merchant\"<\/mark>: {\n        \"merchantURL\"<\/mark>: https:\/\/egadget2.azurewebsites.net\/#\/returns?id={{transactionId}}<\/mark>\n    }\n}<\/code><\/pre>\n\n\n\n
    Po pomy\u015blnym zako\u0144czeniu operacji otrzymywany jest „pending” paymentStatus<\/mark>.<\/p>\n\n\n\n
    U\u017cytkownik jest nast\u0119pnie przekierowywany do \u015brodowiska potwierdzenia p\u0142atno\u015bci, a nast\u0119pnie p\u0142ynnie powraca do adresu URL sprzedawcy.<\/p>\n\n\n\n
    Krok 3: Uzyskaj status p\u0142atno\u015bci<\/h5>\n\n\n\n
    Mo\u017cesz wykona\u0107 operacj\u0119 „Uzyskaj Status”, aby sprawdzi\u0107 status w dowolnym momencie.<\/p>\n\n\n\n
    Nag\u0142\u00f3wek HTTP Authorization jest ustawiony na token Bearer, kt\u00f3ry zosta\u0142 u\u017cyty w pocz\u0105tkowym Checkoucie.<\/p>\n\n\n\n
    GET<\/mark> {transactionID}\/status<\/code><\/pre>\n\n\n\n
    \n
    Uruchom w Postmanie<\/a><\/div>\n<\/div>\n\n\n\n
    Adres URL \u017c\u0105dania:<\/h6>\n\n\n\n
    https://stargate.qly.site1.sibs.pt\/api\/v1\/payments\/{transactionID}\/status<\/code><\/pre>\n\n\n\n
    Nag\u0142\u00f3wki \u017c\u0105da\u0144:<\/h6>\n\n\n\n
    Authorization: \u2018Bearer <AuthToken>\u2019\nX-IBM-Client-Id: \u2018<ClientId>\u2019\nContent-Type: application\/json<\/code><\/pre>\n\n\n\n
    Pomy\u015blna odpowied\u017a techniczna sk\u0142ada si\u0119 ze statusu HTTP-200 i returnStatus.statusCode=\u201d000\u2033.<\/p>\n\n\n\n
    Oto kilka przyk\u0142ad\u00f3w mo\u017cliwych kod\u00f3w wynik\u00f3w:<\/p>\n\n\n\n
    Result Code<\/strong><\/th>statusMsg<\/strong><\/th>Description<\/strong><\/th>Action<\/strong><\/th><\/tr><\/thead>
    HTTP-200<\/td>Success<\/td>Success response<\/td>N\/A<\/td><\/tr>
    HTTP-400<\/td>Bad Request<\/td>The JSON payload is not matching the API definition or some mandatory HTTP headers are missing.<\/td>Please check in API Market for the correct syntax.<\/td><\/tr>
    HTTP-401<\/td>Unauthorized<\/td>On the Authorization, Bearer token is invalid\/expired or not associated with the Terminal used.<\/td>Please check in SIBS Backoffice under the Credentials if the token is valid and create a new one if needed.<\/td><\/tr>
    HTTP-403<\/td>Forbidden<\/td>The ClientID<\/mark> set on the X-IBM-Client-Id<\/mark> HTTP header is not valid or does not possess a valid subscription to the API.<\/td>Please check in SIBS Backoffice under the SPG APP 2.0 if the ClientID<\/mark> is correct. If the problem persists contact SIBS Gateway support for a ClientID<\/mark> reset.<\/td><\/tr>
    HTTP-405<\/td>Method Not Allowed<\/td>The HTTP Method used is not matching any of the API definitions available.<\/td>Please check in API Market for the correct HTTP Method.<\/td><\/tr>
    HTTP-429<\/td>Too Many Requests<\/td>The API calls rate limit has been exceeded.<\/td>Please check in API Market for information on the rate limits that apply to the API.<\/td><\/tr>
    HTTP-500<\/td>Internal Server Error<\/td>The API call has failed… and its most likely on our side.<\/td>You should retry the operation, and if the problem persists contact SIBS Gateway support for assistance.<\/td><\/tr>
    HTTP-503<\/td>Service Unavailable<\/td>The API call is not currently available. Usually we are always on, but short availability issues may occur during scheduled maintenance.<\/td>You should wait and try again later.<\/td><\/tr><\/tbody><\/table><\/figure>\n","protected":false},"excerpt":{"rendered":"
    Bizum to szybkie, bezpieczne i wygodne hiszpa\u0144skie rozwi\u0105zanie p\u0142atnicze, kt\u00f3re umo\u017cliwia u\u017cytkownikom dokonywanie natychmiastowych transakcji bezpo\u015brednio z konta bankowego. Metoda p\u0142atno\u015bci Kategoria Kraj Waluta Funkcjonalno\u015bci Integracje Bizum Online Banking Hiszpania EUR Cz\u0119\u015bciowy zwrot koszt\u00f3wZwrot koszt\u00f3w APIFormularz p\u0142atno\u015bciWtyczka PrestashopWtyczka WooCommerceWtyczka Magento Bizum to jedna z najpowszechniej u\u017cywanych metod p\u0142atno\u015bci w Hiszpanii, ciesz\u0105ca si\u0119 zaufaniem milion\u00f3w u\u017cytkownik\u00f3w […]<\/p>\n","protected":false},"author":3,"featured_media":0,"parent":9950,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"_eb_attr":"","footnotes":""},"class_list":["post-22363","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\/22363","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\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/comments?post=22363"}],"version-history":[{"count":5,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/22363\/revisions"}],"predecessor-version":[{"id":27777,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/22363\/revisions\/27777"}],"up":[{"embeddable":true,"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/pages\/9950"}],"wp:attachment":[{"href":"https:\/\/www.qly.docs.pay.sibs.com\/pl\/wp-json\/wp\/v2\/media?parent=22363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}