For the complete documentation index, see llms.txt. This page is also available as Markdown.

BLIK(oneclick)

Overview

BLIK One Click allows merchants to collect the user's 6-digit BLIK authorization code on the merchant side and submit it in the payment request.

After the request is submitted, the user needs to confirm the payment in their banking app to complete the transaction.

Unlike the regular BLIK redirect flow, BLIK One Click requires the merchant to pass the auth_code, user_ip, and user_agent in the payment request.

This endpoint allows you to submit a payin by BLIK One Click in Poland.

After the payment order is created successfully, Pagsmile returns a pay_url. Redirect the user to the pay_url to continue and complete the payment.

BLIK One Click supports real-time payment processing.

BLIK One Click supports partial refund.

The supported amount range is 0.01 to 50000 PLN per transaction. Most issuers may have a limit of 10000 PLN per transaction.

POST https://gateway-test.pagsmile.com/trade/pay

Request Body

Parameter
Type
Required
Constraints
Description

app_id

string

Required

Max length: 32

The merchant application ID assigned by Pagsmile.

out_trade_no

string

Required

Max length: 64

Merchant order number. Must be unique.

method

string

Required

Fixed value: BlikOneClick

Payment method.

order_currency

string

Required

Fixed value: PLN

Payment currency.

order_amount

string

Required

Min: 0.01; max: 50000; most issuers may have a limit of 10000 per transaction

Payment amount.

subject

string

Required

Max length: 128

Payment subject or order title.

content

string

Optional

Max length: 255

Payment content or order description.

timestamp

string

Required

Format: yyyy-MM-dd HH:mm:ss; max length: 19

Request timestamp.

notify_url

string

Required

Valid URL

The URL to receive payment notifications.

buyer_id

string

Required

Max length: 64

Merchant-side user ID.

user_ip

string

Required

Valid IPv4 or IPv6 address

User's IP address.

user_agent

string

Required

Max length: 512

User's browser user agent.

auth_code

string

Required

6 digits

BLIK authorization code provided by the user.

customer.name

string

Required

Max length: 128

Customer's name.

Request Sample

Response Sample

After receiving the pay_url, redirect the user to the pay_url to continue the payment.

Last updated