Skip to content

BLIK

BLIK to najpopularniejszy system płatności mobilnych w Polsce, wygodny i bezpieczny. Umożliwia dokonanie płatności natychmiastowych za pomocą aplikacji bankowej, wprowadzenie BLIK i potwierdzenie transakcji pinem w aplikacji bankowej.

Opcja płatnościKategoriaKrajeWalutyFunkcjonalnościIntegracje
BLIKBankowość internetowaPolskaPLNOneClick/Bez kodu
Częściowy zwrot kosztów
Zwroty kosztów
Anulowanie
Wirtualny Terminal
API
Formularz Płatności
Wtyczka Prestashop
Wtyczka WooCommerce
Wtyczka Magento

Jak korzystać z BLIKa

Po złożeniu zamówienia i wybraniu przez Klienta BLIKa na Twojej stronie:

  1. Kupujący musi w formularzu płatności podać bezpieczny kod BLIK;
  2. Otrzymuje ten sześciocyfrowy kod z aplikacji bankowej i wprowadza go na stronie płatności. Kod BLIK traci ważność za 120 sekund;
  3. Gdy kupujący wybierze opcję Zapłać, BLIK wysyła powiadomienie push do aplikacji bankowej;
  4. Aby płatność została zrealizowana, kupujący musi potwierdzić płatność w aplikacji bankowej w ciągu 45 sekund.
Notification

Sprawdź, jak korzystać z BLIKA bez kodu.

Jak to działa

Zanim zaczniesz, powinieneś utworzyć zlecenie zamówienia z BLIKiem jako metodą płatności.

Następnie należy dokonać zakupu BLIKiem zgodnie z poniższym opisem:

ŚrodowiskoURLMetoda działania i endpointyOpis działania
PRODapi.sibsgateway.comPOST
api/v1/payments/:transactionId/blik/purchase
Wykonaj przekierowanie klienta do systemu płatności BLIK w celu pobrania kodu klienta i potwierdzenia płatności.
TESTstargate-cer.qly.site[1|2].sibs.ptPOST
api/v1/payments/:transactionId/blik/purchase
Wykonaj przekierowanie klienta do systemu płatności BLIK w celu pobrania kodu klienta i potwierdzenia płatności.

Poniższy komunikat przedstawia płatność BLIK:

Identyfikator ścieżki

ciąg

Obowiązkowe

Służy do identyfikacji transakcji.

Show more
Parametry nagłówka
Typ zawartości

ciąg

Obowiązkowe

Aplikacja/json.

Show more
Autoryzacja

ciąg

Obowiązkowe

Podsumowanie autoryzacji.

Show more
Parametry zapytania
Info

objekt

Obowiązkowe

Obiekt definiujący dodatkowe informacje o transakcji.

Show more
deviceInfo

objekt

Obowiązkowe

Obiekt definiujący informacje o urządzeniu klienta.
Nie występuje, jeżeli przedmiot został wysłany w trakcie tworzenia zamówienia.

Show more
browserAcceptHeader

Ciąg <= 40 znaków

Opcionalnie

Browser Accept Header

Show more
browserJavaEnabled

Ciąg <= 40 znaków

Opcionalnie

Przeglądarka z włączoną obsługą Java

Show more
browserLanguage

Ciąg <= 40 znaków

Obowiązkowe

Język Przeglądarki.

Show more
browserColorDepth

Ciąg <= 40 znaków

Obowiązkowe

Głębia kolorów przeglądarki.

Show more
browserScreenHeight

Ciąg <= 40 znaków

Obowiązkowe

Wysokość ekranu przeglądarki.

Show more
browserScreenWidth

Ciąg <= 40 znaków

Obowiązkowe

Szerokość ekranu przeglądarki

Show more
browserTZ

Ciąg <= 40 znaków

Obowiązkowe

Strefa czasowa przeglądarki

Show more
browserUserAgent

Ciąg <= 40 znaków

Obowiązkowe

Agent użytkownika przeglądarki.

Show more
systemFamily

Ciąg <= 40 znaków

Obowiązkowe

Rodzina systemowa

Show more
systemVersion

Ciąg <= 40 znaków

Obowiązkowe

Wesja systemu.

Show more
systemArchitecture

Ciąg <= 40 znaków

Obowiązkowe

architektura systemu

Show more
deviceManufacturer

Ciąg <= 40 znaków

Obowiązkowe

Producent urządzenia.

Show more
deviceModel

Ciąg <= 40 znaków

Obowiązkowe

Model urządzenia.

Show more
deviceID

Ciąg <= 40 znaków

Obowiązkowe

Unikalny identyfikator urządzenia

Show more
applicationName

Ciąg <=40 znaków

Obowiązkowe

Nazwa aplikacji.

Show more
applicationVersion

Ciąg <= 40 znaków

Obowiązkowe

Wersja aplikacji.

Show more
geoLocalization

Ciąg <= 40 znaków

Obowiązkowe

Geolokalizacja.

Show more
ipAddress

Ciąg <= 40 znaków

Obowiązkowe

Adres IP.

Show more
customerInfo

objekt

Obowiązkowe

Tablica krotek wartości klucza.

Show more
Klucz

Ciąg

Obowiązkowe

Show more
Wartość

Ciąg

Obowiązkowe

Show more
BLIKcode

Ciąg

Opcionalnie

Kod BLIKA. Z 6-cyfrowym wzorem. Obowiązkowe przy zakupie BLIKIEM. Nie występuje, jeżeli w żądaniu podana jest wartość tokena (dla Zakupu BLIK One Click).

Show more

Oto przykład zakupu BLIKiem:

Adres URL żądania:
https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/blik/purchase
Nagłówki żądań:
Authorization: Digest {transactionSignature}
X-IBM-Client-Id: b4480347-9fc8-4790-b359-100a99c60ea3
Content-Type: application/json
{
    "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; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4430.93 Safari/537.36"
        },
        "customerInfo": [
            {
                "key": "customerName",
                "value": "Test Name"
            },
            {
                "key": "customerEmail",
                "value": "email@provider.com"
            }
        ]
    },
    "merchant": {
        "merchantURL": "https://www.pay.sibs.com/eng/documentation/sibs-gateway-3//integration/server-to-server/blik/"
    },
    "BLIKCode": "777001"
}
Notification

Do celów testowych wszystkie 6-cyfrowe kody BLIK zaczynające się od 777 (np. 777001) są ważne. Kody są współdzielone, więc jeśli któryś z nich jest tymczasowo nieważny, wybierz inną sekwencję zaczynającą się od 777.

Po zakończeniu operacji zakupu powinieneś otrzymać status oczekującej płatności.

Poniższa wiadomość stanowi odpowiedź otrzymaną od naszego serwera.

{
    "transactionID": "83GdUDUv2ykTTJUzsB9G",
    "execution": {
        "startTime": "2023-06-20T09:20:02.862Z",
        "endTime": "2023-06-20T09:20:05.048Z"
    },
    "paymentStatus": "Pending",
    "returnStatus": {
        "statusCode": "000",
        "statusMsg": "Success",
        "statusDescription": "Success"
    },
    "actionResponse": {
        "data": {
            "params": []
        }
    }
}

Aby uzyskać najnowszą aktualizację, należy następnie wykonać operację „Pobierz status”.

Nagłówek HTTP autoryzacji jest ustawiony na token okaziciela, 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:

Kod wynikustatusMsgOpisAkcja
HTTP-200SukcesOdpowiedź powodzeniaNie dotyczy
HTTP-400Zł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-401NieautoryzowanyW 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-403ZabronionyIdentyfikator 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-405Niedozwolona metodaZastosowana metoda HTTP nie jest zgodna z żadną dostępną definicją API.Sprawdź w API Market poprawną metodę HTTP.
HTTP-429Zbyt 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-500Wewnętrzny błąd serweraWywoł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-503serwis niedostępnyWywoł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.