BLIK for Payment Setup API

Last updated: May 13, 2026

To accept BLIK payments, you must:

Create a payment setup.
Confirm the payment.
Redirect the customer to BLIK.

When integrating with BLIK, you must follow their UX guidelines. This compliance is a requirement for onboarding. If you do not follow these guidelines, we cannot approve you for production.

Call the Create a payment setup endpoint.

Information

Your base URL's {prefix} value is unique to your account and environment. To learn how to retrieve your base URLs for the sandbox and production environments, see API endpoints.

post

https://{prefix}.api.checkout.com/payments/setups


1{
2  "amount": 1099,
3  "currency": "PLN",
4  "reference": "ORDER_01234",
5  "processing_channel_id": "pc_wzjki6hw5puepb5fnvqlizj2e4",
6  "payment_methods": {
7    "blik": {
8      "partner_code": "333994"
9    }
10  },
11  "settings": {
12    "success_url": "https://example.com/payments/success",
13    "failure_url": "https://example.com/payments/failure"
14  }
15}

In the request body, provide the following:

Field	Description
`amount` number	The payment amount, in the minor currency unit. Minimum: 1 Maximum: 5000000 Required
`currency` string	Three-letter ISO 4217 currency code. Supported value: `PLN` Required
`payment_methods.blik.partner_code` string	The six-digit BLIK code the customer entered on your checkout page. Format: `^[0-9]{6}$` Required
`processing_channel_id` string	The processing channel's unique identifier. Required
`reference` string	A unique reference for the payment. Max length: 35 Required
`settings.failure_url` string	The URL to redirect the customer to if the payment fails. Format: URI Max length: 1024 Required
`settings.success_url` string	The URL to redirect the customer to if the payment succeeds. Format: URI Max length: 1024 Required
`description` string	A description of the payment. Max length: 100
`order.shipping.address.country` string	The two-letter ISO country code of the shipping address.


1{
2  "id": "set_rcmepwrchqab2wsergcafvijfy",
3  "processing_channel_id": "pc_wzjki6hw5puepb5fnvqlizj2e4",
4  "amount": 1099,
5  "currency": "PLN",
6  "payment_type": "Regular",
7  "reference": "ORDER_01234",
8  "description": "BLIK payment",
9  "payment_methods": {
10    "blik": {
11      "status": "ready",
12      "flags": []
13    }
14  },
15  "available_payment_methods": [
16    "blik"
17  ],
18  "settings": {
19    "success_url": "https://example.com/payments/success",
20    "failure_url": "https://example.com/payments/failure"
21  }
22}

The response returns a payment_methods object, which contains the payment methods enabled on your account.

Providing all required fields sets the payment_methods.blik object to a ready status.

Confirm the payment by calling the Confirm a payment setup endpoint and provide:

The payment setup id as the {id} path parameter.
blik as the {payment_method_name} path parameter.

post

https://{prefix}.api.checkout.com/payments/setups/{id}/confirm/blik

If you receive a 202 Accepted response with a payment id value and the status field set to Pending, your request was successful.


1{
2  "id": "pay_jwvjl5tin54ubn7x2stvmunske",
3  "status": "Pending",
4  "reference": "ORDER_01234",
5  "payment_type": "Regular",
6  "processing": {
7    "partner_payment_id": "88294496710"
8  }
9}

The customer confirms the payment using their online banking app. They are then redirected back to your settings.success_url or settings.failure_url.

Confirmation of a BLIK payment is communicated through webhooks. All payments are labeled as Pending until you receive a payment_captured webhook, indicating a successful transaction.

If the customer does not complete the payment, it expires and you receive a payment_expired webhook within five minutes. If the customer cancels their payment, you also receive a payment_expired webhook.

BLIK for Payment Setup API

Create a payment setup

Information

Request example

Response example

Confirm the payment

Request example

Response example

Redirect the customer