Bizum to szybkie, bezpieczne i wygodne hiszpańskie rozwiązanie płatnicze, które umożliwia użytkownikom dokonywanie natychmiastowych transakcji bezpośrednio z konta bankowego.

Metoda płatności	Kategoria	Kraj	Waluta	Funkcjonalności	Integracje
Bizum	Online Banking	Hiszpania	EUR	Częściowy zwrot kosztów Zwrot kosztów	API Formularz płatności Wtyczka Prestashop Wtyczka WooCommerce Wtyczka Magento

Bizum to jedna z najpowszechniej używanych metod płatności w Hiszpanii, ciesząca się zaufaniem milionów użytkowników ze względu na jej szybkość, prostotę i bezpieczeństwo. Ułatwia płynne przelewy pieniężne i płatności bezpośrednio za pośrednictwem istniejących kont bankowych użytkowników.

Klienci korzystający z Bizum podają swój numer telefonu komórkowego, otrzymują powiadomienie w aplikacji swojego banku i potwierdzają transakcję. To bardzo bezpieczny sposób, z natychmiastowym powiadomieniem o płatności.

Jak korzystać z Bizum

Ścieżka przebiega w następujący sposób:

1. Na stronie realizacji transakcji sprzedawca wybiera Bizum jako metodę płatności i uruchamia się żądania płatności.
2. Klient zostaje przekierowany na stronę, na której wpisuje numer telefonu Bizum.
3. Klient otrzymuje powiadomienie w swojej aplikacji bankowej z prośbą o potwierdzenie płatności.
4. Klient potwierdza płatność za pośrednictwem aplikacji bankowej.
5. Sprzedawca otrzymuje potwierdzenie płatności.
6. Sprzedawca może wysłać zamówienie/dostarczyć towar do klienta.

Jak to działa

Oto przegląd najważniejszych kroków wymaganych do integracji Bizum.

Oto przegląd najważniejszych kroków wymaganych do integracji Bizum.

Krok 1: Utwórz zamówienie

Krok 2: Uzyskaj link do płatności

Krok 3: Uzyskaj status płatności

Krok 1: Utwórz zamówienie

Pamiętaj, aby zainicjować żądanie zamówienia z Bizum („bizum”) jako wybraną metodą płatności (transaction.paymentMethod) i skonfigurować preferencje językowe klienta w customerInfo.customerLanguage.

Krok 2: Uzyskaj link do płatności

Postępuj zgodnie z poniższymi instrukcjami, aby uzyskać link do płatności, aby przekierować klienta na bezpieczną stronę płatności w celu uwierzytelnienia i autoryzacji płatności.

Należy pamiętać, że poniższe żądanie wymaga nagłówka autoryzacji zawierającego podpis transakcji uzyskany w poprzednim kroku.

Punkty końcowe (Endpoints):

Środowisko	URL	Metoda działania i punkt końcowy (Endpoint)	Opis działania
PROD	api.sibsgateway.com	POST {version-id}/payments/{id}/pbl/payment-link	Przeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności.
TEST	stargate.qly.site[1|2].sibs.pt	POST {version-id}/payments/{id}/pbl/payment-link	Przeprowadzenie transakcji i przekierowanie użytkownika do hosta płatności.

Upewnij się, że zawierasz te niezbędne elementy, jak określono:

Lokalizacja	Element danych	Typ	Stan	Opis
Ścieżka	id	String	Obowiązkowe	Służy do identyfikacji transakcji

Parametry nagłówka:

Lokalizacja	Element danych	Typ	Stan	Opis
Request Header	Content-Type	String	Obowiązkowe	application/json
Request Header	Autoryzacja	String	Obowiązkowe	Podsumowanie autoryzacji

Parametry żądania:

Lokalizacja	Element danych	Typ	Stan	Opis
Treść żądania	userAcceptanceIndicator	Wartość logiczna	Obowiązkowe	Wskazuje, czy użytkownik zaakceptował Regulamin w celu kontynuowania płatności.
Treść żądania	gatewayId	String	Obowiązkowe	Identyfikator kanału płatności dla kanału, którego klient zamierza użyć do dokonania płatności. Warość: 'ideal’ – iDEAL;
Treść żądania	info	Info	Obowiązkowe	Obiekt definiujący dodatkowe informacje o transakcji.
Rządanie Body.info	deviceInfo	DeviceInfo	Opcjonalne	Obiekt definiujący informacje o urządzeniu klienta.
Request Body.info.deviceInfo	browserAcceptHeader	ciąg	Opcjonalne	Browser Accept Header
Request Body.info.deviceInfo	browserJavaEnabled	ciąg	Opcjonalne	Browser Java Enabled
Request Body.info.deviceInfo	browserLanguage	ciąg	Opcjonalne	browser Language
Request Body.info.deviceInfo	browserColorDepth	ciąg	Opcjonalne	browser Color Depth
Request Body.info.deviceInfo	browserScreenHeight	ciąg	Opcjonalne	browser Screen Height
Request Body.info.deviceInfo	browserScreenWidth	ciąg	Opcjonalne	browser Screen Width
Request Body.info.deviceInfo	browserTZ	ciąg	Opcjonalne	Browser Time Zone
Request Body.info.deviceInfo	browserUserAgent	ciąg	Opcjonalne	Browser User Agent
Request Body.info.deviceInfo	systemFamily	ciąg	Opcjonalne	System Family
Request Body.info.deviceInfo	systemVersion	ciąg	Opcjonalne	System Version
Request Body.info.deviceInfo	systemArchitecture	ciąg	Opcjonalne	System Architecture
Request Body.info.deviceInfo	deviceManufacturer	ciąg	Opcjonalne	Device Manufacturer
Request Body.info.deviceInfo	deviceModel	ciąg	Opcjonalne	Device Model
Request Body.info.deviceInfo	deviceID	ciąg	Opcjonalne	Device Unique Identification
Request Body.info.deviceInfo	applicationName	ciąg	Opcjonalne	Application Name
Request Body.info.deviceInfo	applicationVersion	ciąg	Opcjonalne	Application Version
Request Body.info.deviceInfo	geoLocalization	ciąg	Opcjonalne	Geolocation
Request Body.info.deviceInfo	ipAddress	ciąg	Opcjonalne	Adres IP
Treść żądania	customerInfo	CustomerInfo	Opcjonalne	Key Value tuple array.
Request Body.customerInfo	klucz	ciąg	Obowiązkowe	Używane do podania „customerName”, „customerEmail”.
Request Body.customerInfo	wartość	ciąg	Obowiązkowe	Używane do podania „customerName”, „customerEmail”.
Treść żądania	kupiec	Handlowiec	Opcjonalne	Merchant Data
Żądanie Body.merchant	merchantURL	ciąg	Opcjonalne	Adres URL sklepu sprzedawcy do przekierowania.
Rządanie Body.info	accountInfo	AccountInfo	Opcjonalne	Dane związane z kontem Ma zastosowanie, gdy gatewayId jest „idealny
Request Body.info.accountInfo	holderName	Max100Text	Opcjonalne	Nazwa posiadacza konta. Format UTF-8 .
Request Body.info.accountInfo	customerCountry	Kod kraju Klienta	Opcjonalne	Kod kraju Klienta. Alpha2

Jak uzyskać link do płatności:

Poniżej przykład żądania:

"userAcceptanceIndicator": true,
    "gatewayId": "bizum",
    "info": {
        "deviceInfo": {
            "browserAcceptHeader": "application/json, text/plain, */*",
            "browserJavaEnabled": "false",
            "browserLanguage": "en",
            "browserColorDepth": "24",
            "browserScreenHeight": "1080",
            "browserScreenWidth": "1920",
            "browserTZ": "-60",
            "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/106.0.0.0 Safari/537.36",
            "geoLocalization": "Lat: 38.7350528 | Long: -9.2143616",
            "systemFamily": "Windows",
            "systemVersion": "Windows",
            "deviceID": "498bfd4c3a3645b38667a7037b616c18",
            "applicationName": "Chrome",
            "applicationVersion": "106"
        },
        "customerInfo": [
            {
                "key": "customerName",
                "value": "Test Name"
            },
            {
                "key": "customerEmail",
                "value": "email@provider.com"
            }
            {
                "key": "customerPhone",
                "value": "34#700000000"
            }
        ],
        "accountInfo": {
            "holderName": "Test Name",
            "customerCountry": "ES"
        }
    },
    "merchant": {
        "merchantURL": https://egadget2.azurewebsites.net/#/returns?id={{transactionId}}
    }
}

Po pomyślnym zakończeniu operacji otrzymywany jest „pending” paymentStatus.

Użytkownik jest następnie przekierowywany do środowiska potwierdzenia płatności, a następnie płynnie powraca do adresu URL sprzedawcy.

Krok 3: Uzyskaj status płatności

Możesz wykonać operację „Uzyskaj Status”, aby sprawdzić status w dowolnym momencie.

Nagłówek HTTP Authorization jest ustawiony na token Bearer, który został użyty w początkowym Checkoucie.

GET {transactionID}/status

Adres URL żądania:

https://stargate.qly.site1.sibs.pt/api/v1/payments/{transactionID}/status

Nagłówki żądań:

Authorization: ‘Bearer <AuthToken>’
X-IBM-Client-Id: ‘<ClientId>’
Content-Type: application/json

Pomyślna odpowiedź techniczna składa się ze statusu HTTP-200 i returnStatus.statusCode=”000″.

Oto kilka przykładów możliwych kodów wyników:

Result Code	statusMsg	Description	Action
HTTP-200	Success	Success response	N/A
HTTP-400	Bad Request	The JSON payload is not matching the API definition or some mandatory HTTP headers are missing.	Please check in API Market for the correct syntax.
HTTP-401	Unauthorized	On the Authorization, Bearer token is invalid/expired or not associated with the Terminal used.	Please check in SIBS Backoffice under the Credentials if the token is valid and create a new one if needed.
HTTP-403	Forbidden	The ClientID set on the X-IBM-Client-Id HTTP header is not valid or does not possess a valid subscription to the API.	Please check in SIBS Backoffice under the SPG APP 2.0 if the ClientID is correct. If the problem persists contact SIBS Gateway support for a ClientID reset.
HTTP-405	Method Not Allowed	The HTTP Method used is not matching any of the API definitions available.	Please check in API Market for the correct HTTP Method.
HTTP-429	Too Many Requests	The API calls rate limit has been exceeded.	Please check in API Market for information on the rate limits that apply to the API.
HTTP-500	Internal Server Error	The API call has failed… and its most likely on our side.	You should retry the operation, and if the problem persists contact SIBS Gateway support for assistance.
HTTP-503	Service Unavailable	The API call is not currently available. Usually we are always on, but short availability issues may occur during scheduled maintenance.	You should wait and try again later.