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.

Opcja płatności	Kategoria	Kraj	Waluta	Cechy	Integracje
Bizum	Bankowość internetowa	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.

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-cer.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	Obowiązkowe	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

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
            }
        ],
        "accountInfo": {
            "holderName": "Test Name",
            "customerCountry": "BE"
        }
    },
    "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-cer.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:

Kod wyniku	statusMsg	Opis	Akcja
HTTP-200	Sukces	Odpowiedź powodzenia	Nie dotyczy
HTTP-400	Zła prośba	Ładunek JSON nie jest zgodny z definicją API lub brakuje niektórych obowiązkowych nagłówków HTTP.	Sprawdź w API Market poprawną składnię.
HTTP-401	Nieautoryzowany	W przypadku Autoryzacji token okaziciela jest nieprawidłowy/wygasł lub nie jest powiązany z używanym terminalem.	Sprawdź w SIBS Backoffice w sekcji Poświadczenia, czy token jest ważny i w razie potrzeby utwórz nowy.
HTTP-403	Zabroniony	Identyfikator klienta ustawiony w nagłówku HTTP X-IBM-Client-Id jest nieprawidłowy lub nie posiada prawidłowej subskrypcji interfejsu API.	Sprawdź w SIBS Backoffice w SPG APP 2.0, czy ClientID jest poprawny. Jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu zresetowania ClientID.
HTTP-405	Niedozwolona metoda	Zastosowana metoda HTTP nie jest zgodna z żadną dostępną definicją API.	Sprawdź w API Market poprawną metodę HTTP.
HTTP-429	Zbyt dużo zapytań	Przekroczono limit szybkości wywołań API.	Informacje na temat limitów stawek mających zastosowanie do API można znaleźć w API Market.
HTTP-500	Wewnętrzny błąd serwera	Wywołanie API nie powiodło się… i najprawdopodobniej jest to po naszej stronie.	Powinieneś ponowić operację, a jeśli problem będzie się powtarzał, skontaktuj się z pomocą techniczną SIBS Gateway w celu uzyskania pomocy.
HTTP-503	serwis niedostępny	Wywołanie API nie jest obecnie dostępne. Zwykle jesteśmy zawsze aktywni, ale podczas planowej konserwacji mogą wystąpić krótkie problemy z dostępnością.	Powinieneś poczekać i spróbować ponownie później.