Skip to main content

QR code checkout URL

Our services enable you to create a URL link for a hosted checkout presented as a QR code, catering to the convenience of your customers. Additionally, you have the option to convert an already existing URL link to a checkout into a QR code.

QR code generation:

To generate a URL link for the checkout page as a QR code, include the following query parameter in the standard POST request used for one-step payments (one-step split payments) or two-step payments (two-step split payments):

ParameterTypeRequiredDescription
qrBooleantrue

Request example:

$ curl -i "https://api.finline.io/api/v1/payment?qr=true" \
-H "Content-Type: application/json" \
-H "X-API-AUTH: CPAY ${API_KEY}:${API_SECRET}" \
-H "X-API-KEY: ${ENDPOINTS_KEY}" \
-X POST -d '{
"pos_id": "${POS_ID}",
"mode": "hosted",
"method": "purchase",
"amount": 1,
"currency": "UAH",
"description": "description_1",
"order_id": "123",
"order_3ds_bypass": "always",
"server_url": "https://callback.blackhole.com/callback",
"result_url": "https://example.com/result",
"payload": "sale=true"

Upon making the request, you will receive a URL link to a web page containing a QR code

Response example:

{
"qr_link": "https://api.finline.io/api/v1/checkout/baf1592f-d7e8-4c28-9b86-43499bc54904/qr"
}

Converting checkout URL into QR code

Converting a checkout link into a QR code can be achieved manually by replacing the '.../form' ending with the '.../qr' one in the URL

Example:

Example