Payment-method icon

BLIK for API only

Add BLIK to an existing API-only integration.

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.

Requirements

Requirement Description
Integration type Make sure that you have an existing API-only integration.

An API-only integration of BLIK works with all versions of Checkout API. For more information, refer to Release notes.

Setup steps Before you begin, add BLIK in your test 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.
  2. Include a field where the shopper can enter the blikCode for their corresponding payment.

In your /paymentMethods request, specify:

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

Adyen provides a logo for BLIK that you can use on your payment form. For more information, refer to Downloading logos.

Make a payment

In your /payments request, specify:

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

The /payments response contains:

  • resultCode: Pending (The shopper must complete the payment in their BLIK app.)
  • action: Use this object to display the waiting screen while the shopper completes the payment in their BLIK app.

Show the waiting screen

  1. Show a waiting screen to the shopper, telling them you are 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:

resultCode Action to take
Pending Show the waiting screen to the shopper, informing them that they have to go to their bank app to complete the payment.
Refused Inform the shopper that the payment is refused, for example, because of incorrect blikCode value.

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

eventCode success field Description Action to take
AUTHORISATION false The transaction failed. Cancel the order and inform the shopper that the payment failed.
AUTHORISATION true The shopper successfully completed the payment. Inform the shopper that the payment has been successful and proceed with the order.

Test and go live

You can test BLIK transactions in the test environment using any 6-digit number that starts with 777 as your blikCode.

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

Refusal reason Amount
ALIAS_DECLINED 288.00
TAS_DECLINED 192.00
USER_DECLINED 144.00
SEC_DECLINED 216.00
SYSTEM_ERROR 264.00
GENERAL_ERROR 360.00
INSUFFICIENT_FUNDS 120.00
TIMEOUT 312.00
LIMIT_EXCEEDED 96.00
USER_TIMEOUT 336.00
ISSUER_DECLINED 9.99

Check the status of BLIK test payments in your Customer Area > Transactions > Payments.

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

See also