BLIK via Checkout.com

Accept BLIK payments from customers in Poland with Checkout.com as the payment service provider (PSP). The customer enters their BLIK code at checkout and approves the payment in their banking app. The customer stays on your checkout, with no redirect.

Supported workflows

Workflow	Supported
Payrails SDK	✔
Payrails API	✔
Delayed / Manual Capture	✖
Instant Capture	✔
Cancel / Void	✖
Refund / Reverse	✔
Save Instruments	✖
Merchant Initiated Transaction (MIT)	✖

Before you begin

Complete these steps before you send your first BLIK payment through Checkout.com:

Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
Ask Checkout.com support to enable BLIK on your Checkout.com account.
In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select BLIK under Payment methods, and save.
Add BLIK as a payment option in your workflow.

Request fields for Checkout.com

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`meta.shopperInput.blikCode`	Required	The six-digit code from the customer’s banking app. Payrails rejects a missing code and any value that isn’t exactly six digits.
`amount.currency`	Required	BLIK payments are in `PLN`.
`meta.customer.name`, `meta.customer.lastName`	Optional	Sent to Checkout.com as the customer name.
`meta.customer.email`	Optional	Sent to Checkout.com as the customer email.

Authorize a BLIK payment

Call authorize a payment with blik as the paymentMethodCode.

Authorize request

{
  "amount": {
    "value": "50.00",
    "currency": "PLN"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "blik",
      "amount": {
        "value": "50.00",
        "currency": "PLN"
      }
    }
  ],
  "meta": {
    "shopperInput": {
      "blikCode": "123456"
    },
    "customer": {
      "email": "anna.kowalska@example.com",
      "name": "Anna",
      "lastName": "Kowalska"
    }
  }
}

The response is pending, with no redirect. The payment stays pending until the customer approves it in their banking app. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Checkout.com handles BLIK

Payrails processes BLIK through the Checkout.com Payment Setup API, and sends the code to Checkout.com as the partner code.
Checkout.com sends the final result as a webhook notification after the customer approves or declines in the banking app.
Checkout.com accepts references of up to 35 characters for BLIK. Payrails shortens the merchant reference to 35 characters on the payment and on refunds.
Each BLIK payment is a new customer-initiated payment.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a BLIK payment

How Checkout.com handles BLIK

​Supported workflows

​Before you begin

​Request fields for Checkout.com

​Authorize a BLIK payment

​How Checkout.com handles BLIK

Supported workflows

Before you begin

Request fields for Checkout.com

Authorize a BLIK payment

How Checkout.com handles BLIK