BLIK for API only

Accept BLIK payments using our APIs, and build your own payment form to have full control over the look and feel of your checkout page.

Before you begin

These instructions explain how to add BLIK to your existing API-only integration. The API-only integration works the same way for all payment methods. If you haven't done this integration yet, refer to our API-only integration guide.

Before starting your BLIK integration:

1. Make sure that you have set up your back end implementation.
2. Add BLIK in your Customer Area.

Build your payment form for BLIK

To show BLIK in your payment form, you need to:

1. Show BLIK as an available payment method.

   We provide a BLIK logo which you can use on your payment form. For more information, refer to Downloading logos.

2. Include a field where the shopper can enter the blikCode for their corresponding payment.

In your /paymentMethods request, specify:

• countryCode: PL
• amount.currency: PLN
• amount.value: The value of the payment, in minor units.
• channel: Specify Web, iOS, or Android.

You can find the required fields in the object with type blik.

Make a payment

In your /payments request, specify:

• paymentMethod.type: blik

• paymentMethod.blikCode: The blikCode that the shopper entered.

  curl Ruby PHP Python NodeJS

  curl Ruby PHP Python NodeJS

  curl https://checkout-test.adyen.com/v68/payments \
  -H "x-API-key: YOUR_X-API-KEY" \
  -H "content-type: application/json" \
  -d '{
    "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
    "reference":"YOUR_ORDER_NUMBER",
    "amount":{
      "currency":"PLN",
      "value":1000
    },
    "paymentMethod":{
      "type":"blik",
      "blikCode":"777987"
    },
    "countryCode" : "PL"
  }'

  # Set your X-API-KEY with the API key from the Customer Area.
  adyen = Adyen::Client.new
  adyen.api_key = "YOUR_X-API-KEY"
   
  response = adyen.checkout.payments({
    :amount => {
      :currency => "PLN",
      :value => 1000
    },
    :reference => "YOUR_ORDER_NUMBER",
    :paymentMethod => {
      :type => "blik",
      :blikCode => "777987"
    },
    :merchantAccount => "YOUR_MERCHANT_ACCOUNT"
  })

  // Set your X-API-KEY with the API key from the Customer Area.
  $client = new \Adyen\Client();
  $client->setXApiKey("YOUR_X-API-KEY");
  $service = new \Adyen\Service\Checkout($client);
  
  $params = array(
    "amount" => array(
      "currency" => "PLN",
      "value" => 1000
    ),
    "reference" => "YOUR_ORDER_NUMBER",
    "paymentMethod" => array(
      "type" => "blik",
      "blikCode" => "777987"
    ),
    "countryCode" => "PL",
    "merchantAccount" => "YOUR_MERCHANT_ACCOUNT"
  );
  $result = $service->payments($params);

  #Set your X-API-KEY with the API key from the Customer Area.
  adyen = Adyen.Adyen()
  adyen.client.xapikey = 'YOUR_X-API-KEY'
  
  result = adyen.checkout.payments({
     'amount': {
        'value': 1000,
        'currency': 'PLN'
     },
     'reference': 'YOUR_ORDER_NUMBER',
     'paymentMethod': {
        'type': 'blik',
        'blikCode': '777987'
     },
     'merchantAccount': 'YOUR_MERCHANT_ACCOUNT'
  })

  // Set your X-API-KEY with the API key from the Customer Area.
  const {Client, Config, CheckoutAPI} = require('@adyen/api-library');
  const config = new Config();
  // Set your X-API-KEY with the API key from the Customer Area.
  config.apiKey = '[API_KEY]';
  config.merchantAccount = '[YOUR_MERCHANT_ACCOUNT]';
  const client = new Client({ config });
  client.setEnvironment("TEST");
  const checkout = new CheckoutAPI(client);
  checkout.payments({
      amount: { currency: "PLN", value: 1000 },
      paymentMethod: {
          type: 'blik',
          blikCode: '777987'
      },
      reference: "YOUR_ORDER_NUMBER",
      countryCode: "PL",
      merchantAccount: config.merchantAccount
  }).then(res => res);

  https://docs.adyen.com/payment-methods/blik/api-only#api-only-payments

  The /payments response contains:

  • resultCode: Pending, means the shopper needs to complete the payment in their BLIK app.
  • action.type: await, means you need to wait for the webhook to know the payment outcome.
  /payments response

    {
        "resultCode": "Pending",
        "action": {
            "paymentData": "Ab02b4c0!BQABAg...",
            "paymentMethodType": "blik",
            "type": "await"
        },
        "paymentData": "Ab02b4c0!BQABAg..."
    }.
    }

  https://docs.adyen.com/payment-methods/blik/api-only#-payments-response

Show the waiting screen

1. Show a waiting screen to the shopper, telling them you're waiting for them to complete the payment.
2. Check your webhooks to see the payment result. We send you an AUTHORISATION webhook after the shopper completes the payment in their BLIK app.
3. Once you receive the webhook, redirect them to your website, and present the payment result.

Present the payment result

Use the resultCode that you received in the /payments response to inform your shopper of the payment status.

The resultCode values you can receive for payments made through BLIK are:

Wait for webhooks to know the outcome of the payment. The webhooks you can receive for BLIK are:

Test and go live

To test BLIK, you can use any 6-digit blikCode that starts with 777.

You can test different refused payment result scenarios by using the following amounts in your /payments request:

You can check the status of BLIK test payments in your Customer Area > Transactions > Payments.

Before you can accept live BLIK payments, you need to add BLIK in your live Customer Area.

See also