Payment Method Details
Prerequisites
- Connect and activate the Stripe integration in PayNext
- Enable BLIK in your Stripe Dashboard under Settings → Payment methods
- Turn on BLIK in your PayNext checkout configuration
How it works
The customer selects BLIK at checkout, opens their banking app to generate a six-digit code, and enters it into the payment form. The bank then sends a push notification to the customer’s phone asking them to authorize the payment inside their banking app. The BLIK code is valid for 2 minutes, and the customer has about 60 seconds to authorize the payment after starting it. If the code expires before authorization, the customer must request a new one and retry. Customers typically approve BLIK payments in under 10 seconds.Payment description in the banking app
You can show your own product or order description in the customer’s banking app when they confirm the BLIK payment. The text comes from your own metadata, so it can differ per payment.1
Map the field on the Stripe integration
In Dashboard → Integrations → your Stripe integration → Metadata mapping, add a field:
- Key: the metadata key you send (for example
product_name) - Value:
description
2
Send the text
Provide the value in customer or subscription metadata of the client session, or set it during processing with the Set Metadata node in a workflow.
The description is limited to 70 characters — longer text is truncated. A Set Metadata node whose key is exactly
description is used as the description without any mapping. Payment-level client-session metadata is not read for this field, so put the value in customer or subscription metadata.Recurring payments
BLIK supports saving a customer’s payment method to charge them again later without asking for a new code each time. Important limits for recurring BLIK:- only PLN is supported for recurring charges
- each off-session recurring charge is capped at 2,000 PLN per charge
- the customer approves both the initial payment and the recurring mandate in the same banking-app step — there is no separate “set up now, pay later” flow in PayNext’s integration
If the customer revokes the mandate
A customer can remove the saved BLIK payment method in their banking app, and a BLIK mandate can also expire. PayNext receives that from Stripe and sets the payment methodstatus to deleted.
A revoked payment method can’t be charged. Renewals stop being attempted—the aborted attempt is recorded as INCOMPLETE with decline_code payment_method_disabled—and the subscription stays past_due for 14 days before it is cancelled with reason dead_instrument. See Dead payment methods.
Each change is reported by customer.payment_method.updated.
Settlement and timing
In the PayNext payment status flow, a BLIK payment staysPENDING while the customer authorizes it in their banking app, then moves to a final status once Stripe confirms the outcome via webhook.
Treat a BLIK payment as complete only once it reaches the succeeded status via webhook. A displayed “check your bank’s app” state is not itself a completed payment.
If the customer doesn’t complete payment
If the BLIK code expires, the authorization window passes, or the customer’s bank declines the payment (for example withcard_issuer_decline on a recurring charge), the payment is marked as failed or incomplete. No charge is taken, and the customer can retry within the same checkout session.
Testing
1
Configure Stripe credentials
Use the correct Stripe environment in your PayNext integration and make sure BLIK is enabled for that account.
2
Create a BLIK payment
Start a BLIK payment via PayNext checkout using PLN for a customer in Poland.
3
Complete customer approval
Enter the six-digit code and authorize the payment in the banking app within the authorization window.
4
Verify the payment
Confirm the payment appears in the PayNext dashboard and that the final status is received via Stripe webhook.
5
Check the incomplete path
Start another payment and let the code expire, or decline it in the banking app. Confirm the payment is marked failed/incomplete and the same checkout session can be retried.
6
Verify recurring behavior
For recurring BLIK, confirm the mandate is set up correctly and that subsequent charges stay within the 2,000 PLN per-charge cap.
Notes
- BLIK does not support manual capture.
- BLIK transactions are always presented in PLN, regardless of where the customer or merchant is based.
- Not all Polish banks support BLIK recurring payments — confirm support before enabling recurring BLIK for a customer segment.
- Recurring off-session charges are capped at 2,000 PLN per charge.