Перейти до основного вмісту

URL-посилання на hosted-чекаут у вигляді QR-коду

Наші сервіси дозволяють генерувати URL-посилання на hosted-чекаут у вигляді зручного для ваших клієнтів QR-коду, а також перетворювати вже існуюче URL-посилання на чекаути у QR-код.

Генерація QR-коду:​

Для генерації URL-посилання на платіжну сторінку у вигляді QR-коду, до звичайного POST-запиту, характерного для hosted одностадійних (одностадійних спліт-плетажів) чи двостадійних платежів (двостадійних спліт-платежів) необхідно додати query-параметр:

ParameterTypeRequiredDescription
qrBoolean✅true

Приклад запиту:

$ 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"

У відповідь на запит буде отримано URL-посиланням на вебсторінку з QR-кодом.

Приклад відповіді:

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

Перетворення посилання на чекаут у QR-код​

Перетворення URL-посилання на hosted-чекаут у QR-код можна провести вручну шляхом простої заміни в посиланні закінчення з “.../form” на “.../qr”.

Приклад:

Приклад