Zacznij akceptować płatności za pomocą Bancontact, najpopularniejszej metody płatności online w Belgii, utrzymując pozycję lidera na rynku zarówno w transakcjach internetowych, jak i osobistych.

Aby dokonać płatności za pomocą Bancontact, klienci są kierowani do witryny internetowej lub aplikacji mobilnej w celu autoryzacji. Wprowadzają dane swojej karty lub skanują kod QR, a następnie autoryzują płatność.

Następnie wracają na Twoją stronę internetową i natychmiast powiadamiają Cię o powodzeniu lub niepowodzeniu płatności.

Metoda płatności	Kategoria	Kraj	Waluta	Funkcjonalności	Integracje
Bancontact	Karty	Belgia	EUR	Częściowy zwrot pieniędzy Zwroty Anulowanie	API Formularz płatności Wtyczka Prestashop Wtyczka WooCommerce Wtyczka Magento

Jak korzystać z Bancontact

Przepływ pracy przebiega w następujący sposób:

1. Na stronie sprzedawcy klient wybiera Bancontact.
2. Klient zostaje przekierowany na stronę płatności Bancontact, gdzie ma możliwość wprowadzenia numeru PAN lub zeskanowania kodu QR.
3. Kończą płatność:
   a. Jeśli konsument zdecyduje się na wprowadzenie numeru PAN, zostanie przekierowany do banku wydającego w celu uwierzytelnienia 3DS.
   b. Jeśli konsument zeskanuje kod QR, potwierdza płatność w aplikacji Bancontact.
4. Konsument zostaje przekierowany na stronę internetową sprzedawcy.
5. Sprzedawca otrzymuje potwierdzenie płatności.
6. Następnie sprzedawca może wysłać zamówienie/dostarczyć towar konsumentowi.

Jak to działa

Poniżej znajdziesz najważniejsze kroki wymagane do integracji metody płatności Bancontact.

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 utworzyć żądanie zamówienia z Bancontact („BNCT”) jako wybraną metodą płatności (transaction.paymentMethod) i ustawić preferencje językowe klienta w CustomerInfo.customerLanguage.

Krok 2: Uzyskaj Link do płatności

Przejdź do linku do płatności opisanego poniżej, 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:

Środowisko	URL	Metoda działania i punkt końcowy	Opis operacji
PROD	api.sibsgateway.com	POST {version-id}/payments/{id}/pbl/payment-link	Wykonaj transakcję i przekieruj użytkownika do Hosta płatności.
TEST	stargate.qly.site[1|2].sibs.pt	POST {version-id}/payments/{id}/pbl/payment-link	Wykonaj transakcję i przekieruj użytkownika do Hosta płatności.

Upewnij się, że uwzględniłeś następujące istotne elementy zgodnie ze specyfikacją:

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

Parametry nagłówka:

Lokalizacja	Element danych	Typ	Stan	Opis
Nagłówek żądania	Typ zawartości	Ciąg	Obowiązkowy	aplikacja/json
Nagłówek żądania	Upoważnienie	Ciąg	Obowiązkowy	Podsumowanie autoryzacji

Parametry żądania:

Lokalizacja	Element danych	Typ	Stan	Opis
Treść żądania	userAcceptanceIndicator	Wartość logiczna	Obowiązkowy	Wskazuje, czy użytkownik zaakceptował Regulamin, aby kontynuować płatność.
Treść żądania	gatewayId	Ciąg	Obowiązkowy	Kanał płatności Identyfikator kanału, którego Klient będzie używał do dokonywania płatności. Wartość: 'bcmc’ – Bancontact;
Treść żądania	informacja	Informacja	Obowiązkowy	Obiekt definiujący dodatkowe informacje o transakcji.
Poproś o Body.info	deviceInfo	Informacje o urządzeniu	Opcjonalny	Obiekt definiujący informacje o urządzeniu klienta.
Poproś o Body.info.deviceInfo	browserAcceptHeader	ciąg	Opcjonalny	Nagłówek akceptacji przeglądarki
Poproś o Body.info.deviceInfo	browserJavaEnabled	ciąg	Opcjonalny	Przeglądarka Java włączona
Poproś o Body.info.deviceInfo	browserLanguage	ciąg	Opcjonalny	Język przeglądarki
Poproś o Body.info.deviceInfo	browserColorDepth	ciąg	Opcjonalny	Głębia kolorów przeglądarki
Poproś o Body.info.deviceInfo	browserScreenHeight	ciąg	Opcjonalny	Wysokość ekranu przeglądarki
Poproś o Body.info.deviceInfo	browserScreenWidth	ciąg	Opcjonalny	Szerokość ekranu przeglądarki
Poproś o Body.info.deviceInfo	browserTZ	ciąg	Opcjonalny	Strefa czasowa przeglądarki
Poproś o Body.info.deviceInfo	browserUserAgent	ciąg	Opcjonalny	Agent użytkownika przeglądarki
Poproś o Body.info.deviceInfo	systemFamily	ciąg	Opcjonalny	Rodzina systemowa
Poproś o Body.info.deviceInfo	systemVersion	ciąg	Opcjonalny	Wersja systemu
Poproś o Body.info.deviceInfo	systemArchitecture	ciąg	Opcjonalny	architektura systemu
Poproś o Body.info.deviceInfo	deviceManufacturer	ciąg	Opcjonalny	Producent urządzenia
Poproś o Body.info.deviceInfo	deviceModel	ciąg	Opcjonalny	Model urządzenia
Poproś o Body.info.deviceInfo	deviceID	ciąg	Opcjonalny	Unikalna identyfikacja urządzenia
Poproś o Body.info.deviceInfo	applicationName	ciąg	Opcjonalny	Nazwa aplikacji
Poproś o Body.info.deviceInfo	applicationVersion	ciąg	Opcjonalny	Wersja aplikacji
Poproś o Body.info.deviceInfo	geoLocalization	ciąg	Opcjonalny	Geolokalizacja
Poproś o Body.info.deviceInfo	ipAddress	ciąg	Opcjonalny	Adres IP
Treść żądania	customerInfo	Informacja dla klientow	Opcjonalny	Tablica krotności wartości klucza.
Poproś o Body.customerInfo	klucz	ciąg	Obowiązkowy	Używane do podawania „nazwy klienta”, „e-maila klienta”.
Poproś o Body.customerInfo	wartość	ciąg	Obowiązkowy	Używane do podawania „nazwy klienta”, „e-maila klienta”.
Treść żądania	sprzedawca	Sprzedawca	Opcjonalny	Dane sprzedawcy
Zapytanie o Body.merchant	merchantURL	ciąg	Obowiązkowy	Adres URL sklepu sprzedawcy do przekierowania.
Zapytanie o Body.merchant	appToAppURL	ciąg	Opcjonalny	Niestandardowy adres URL aplikacji do przekierowania klienta z powrotem do aplikacji, co spowodowało płatność. Ma zastosowanie, gdy identyfikator bramy to „bcmc”. Zastępuje adres URL sprzedawcy dla przepływów mobilnych.
Poproś o Body.info	accountInfo	Informacje o koncie	Opcjonalny	Dane związane z kontem. Ma zastosowanie, gdy identyfikator bramy to „bcmc”
Poproś o Body.info.accountInfo	holderName	Max100Text	Opcjonalny	Nazwa właściciela konta. Format UTF-8 .
Poproś o Body.info.accountInfo	customerCountry	Kod kraju	Opcjonalny	Kod kraju klienta. Alpha2

Oto przykładowy sposób uzyskania linku do płatności:

{
    "userAcceptanceIndicator": true,
    "gatewayId": "bcmc",
    "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": {
        "appToAppURL": https://egadget2.azurewebsites.net/#/returns?id={{transactionId}},
        "merchantURL": https://egadget2.azurewebsites.net/#/returns?id={{transactionId}}
    }
}

Po pomyślnym zakończeniu operacji otrzymany zostanie status płatności „oczekujący”.

Użytkownik zostaje następnie przekierowany do środowiska potwierdzenia płatności, po czym bezproblemowo powróci do adresu URL sprzedawcy.

Krok 3: Uzyskaj status płatności

W dowolnym momencie możesz wykonać operację „Pobierz status”, aby sprawdzić status.

Nagłówek HTTP autoryzacji jest ustawiony na token nośnika, tak jak był używany podczas początkowej realizacji transakcji.

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:

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.