BLIK is the most popular mobile payment system in Poland and it’s convenient and safe. It enables users to make instant payments using their banking app, entering the BLIK and confirming the transaction with the pin in the banking app.

How to use BLIK

After you create the order and the shopper selects BLIK on your website:

1. The buyer has to enter a secure BLIK code in the payment form;
2. He gets this six-digit code from his baking application and enters it on your checkout page. The BLIK code expires in 120 seconds;
3. Once the shopper chooses Pay, BLIK sends a push notification to their banking app;
4. The shopper must confirm the payment on their banking app within 45 seconds for the payment to go through.

Check here the instructions to perform BLIK without a code.

How it works

Before you start, you should create the order request with BLIK as payment method.

After that, you should make a BLIK purchase as detailed below:

The message below represents the BLIK payment:

Header parameters

Request parameters

Here is an example of a BLIK purchase:

Request URL:

https://stargate-cer.qly.site1.sibs.pt/api/v1/payments/{transactionID}/blik/purchase

Request Headers:

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"
}

For testing purposes, all 6-digit BLIK codes starting with 777 (e.g., 777001) are considered valid. These codes are shared, so if any of them are temporarily invalid, please choose another code sequence starting with 777.

Upon completing the purchase operation, you should receive a pending paymentStatus. 

The message below represents a response that you get from our server.

{
    "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": []
        }
    }
}

To obtain the latest update, it is necessary to subsequently perform a “Get Status” operation.

The Authorization HTTP header is set to the Bearer token as it was used in the initial Checkout.

GET {transactionID}/status

Request URL:

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

Request Headers:

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

A successful technical response comprises of an HTTP-200 status and a returnStatus.statusCode=”000″.

Here are some examples of the possible result codes: