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
qrBoolean✅true

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