Skip to content
Menu

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.

Metoda płatnościKategoriaKrajeWalutyFunkcjonalnościIntegracje
BLIKBankowość internetowaPolskaPLNOneClick/Bez kodu
Częściowy zwrot pieniędzy
Zwroty
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.

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 punkt końcowyOpis operacji
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.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ązkowy

Służy do identyfikacji transakcji.

Show more
Parametry nagłówka
Typ zawartości

Ciąg

Obowiązkowy

Aplikacja/json.

Show more
Autoryzacja

Ciąg

Obowiązkowy

Podsumowanie autoryzacji.

Show more
Parametry żądania
Informacja

objekt

Optional

Obiekt definiujący dodatkowe informacje o transakcji.

Show more
deviceInfo

objekt

Optional

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

Show more
przeglądarkaAkceptuj nagłówek

Ciąg <= 40 znaków

Optional

Przeglądarka Accept Header

Show more
przeglądarka JavaEnabled

Ciąg <= 40 znaków

Optional

Przeglądarka Java Enabled.

Show more
browserLanguage

Ciąg <= 40 znaków

Optional

Język Przeglądarki.

Show more
browserColorDepth

Ciąg <= 40 znaków

Optional

Głębia kolorów przeglądarki.

Show more
browserScreenHeight

Ciąg <= 40 znaków

Optional

Wysokość ekranu przeglądarki.

Show more
browserScreenWidth

Ciąg <= 40 znaków

Optional

Szerokość ekranu przeglądarki

Show more
browserTZ

Ciąg <= 40 znaków

Optional

Strefa czasowa przeglądarki

Show more
browserUserAgent

Ciąg <= 40 znaków

Optional

Agent użytkownika przeglądarki.

Show more
systemFamily

Ciąg <= 40 znaków

Optional

Rodzina systemowa

Show more
systemVersion

Ciąg <= 40 znaków

Optional

Wersja systemu.

Show more
systemArchitecture

Ciąg <= 40 znaków

Optional

architektura systemu

Show more
deviceManufacturer

Ciąg <= 40 znaków

Optional

Producent urządzenia.

Show more
deviceModel

Ciąg <= 40 znaków

Optional

Model urządzenia.

Show more
deviceID

Ciąg <= 40 znaków

Optional

Unikalna identyfikacja urządzenia.

Show more
applicationName

Ciąg <=40 znaków

Optional

Nazwa aplikacji.

Show more
applicationVersion

Ciąg <= 40 znaków

Optional

Wersja aplikacji.

Show more
geoLocalization

Ciąg <= 40 znaków

Optional

Geolokalizacja.

Show more
ipAddress

Ciąg <= 40 znaków

Optional

Adres IP.

Show more
customerInfo

objekt

Mandatory

Tablica krotek wartości klucza.

Show more
Klucz

Ciąg

Mandatory

Show more
Wartość

Ciąg

Mandatory

Show more
BLIKcode

Ciąg

Optional

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 bez kodu).

Show more

Oto przykład zakupu BLIKIEM:

Adres URL żądania:
https://stargate.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"
}

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 nośnika, tak jak był używany podczas początkowej realizacji transakcji.

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 CodestatusMsgDescriptionAction
HTTP-200SuccessSuccess responseN/A
HTTP-400Bad RequestThe 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-401UnauthorizedOn 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-403ForbiddenThe 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-405Method Not AllowedThe HTTP Method used is not matching any of the API definitions available.Please check in API Market for the correct HTTP Method.
HTTP-429Too Many RequestsThe API calls rate limit has been exceeded.Please check in API Market for information on the rate limits that apply to the API.
HTTP-500Internal Server ErrorThe 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-503Service UnavailableThe 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.
Przegląd prywatności

Ta strona korzysta z ciasteczek, aby zapewnić Ci najlepszą możliwą obsługę. Informacje o ciasteczkach są przechowywane w przeglądarce i wykonują funkcje takie jak rozpoznawanie Cię po powrocie na naszą stronę internetową i pomaganie naszemu zespołowi w zrozumieniu, które sekcje witryny są dla Ciebie najbardziej interesujące i przydatne.

Ściśle niezbędne ciasteczka

Niezbędne ciasteczka powinny być zawsze włączone, abyśmy mogli zapisać twoje preferencje dotyczące ustawień ciasteczek.