IBAN oplata Довідка

QR-код через пряме посилання

QR-код будь-якого посилання на оплату можна отримати як зображення за адресою: допишіть «/qr» у кінець адреси посилання, і замість сторінки оплати відкриється картинка з QR-кодом. Наприклад, для посилання https://ibanoplata.com/iban-qr/<ідентифікатор> зображення лежить за адресою https://ibanoplata.com/iban-qr/<ідентифікатор>/qr. Ні кабінет, ні API-токен для цього не потрібні: адресу можна одразу вставити на сайт, у лист, рахунок чи документ, який формує ваша CRM, а параметри в адресі задають формат, розмір, підпис і рамку.

Коли це потрібно

Пряме посилання на QR зручне, коли посилання створюються автоматично — через API чи інтеграцію — і QR-код має зʼявлятися поруч без ручного завантаження: на сторінці замовлення, у листі з рахунком, у документі для друку. Якщо потрібен QR-код для одного посилання або готова картка з назвою компанії для друку, завантажте його в кабінеті — це описано в статті QR-код і готова картка для друку.

Отримати адресу QR-коду

  1. Візьміть адресу посилання на оплату. У кабінеті — у списку Мої посилання відкрийте меню дій рядка й оберіть Скопіювати посилання; посилання, створене через API, повертається у відповіді на запит створення.
  2. Допишіть у кінець адреси «/qr». Відкрийте отриману адресу в браузері — зʼявиться QR-код у форматі SVG шириною 300 пікселів, у сірій рамці, з підписом «скануйте QR-код для оплати».
  3. Якщо потрібен інший вигляд, допишіть після «/qr» знак «?» і параметри через «&», наприклад: https://ibanoplata.com/iban-qr/<ідентифікатор>/qr?format=png&size=500&showText=false
  4. Вставте адресу туди, де має бути QR-код: у сайт або шаблон листа — як адресу зображення, у документ — як картинку за посиланням.

Зображення створюється заново на кожен запит, тож зберігати його в себе не обовʼязково: адреса працює, доки працює саме посилання.

Параметри зображення

Параметр Значення За замовчуванням Що змінює
format svg або png svg SVG масштабується без втрати якості — для друку й макетів; PNG — звичайна картинка для документів, месенджерів і поштових програм, які не показують SVG
size ціле число пікселів 300 Ширина зображення; з підписом зображення на 60 пікселів вище за ширину
showText true або false true Підпис «скануйте QR-код для оплати» під кодом
showBorder true або false true Сіра рамка із заокругленими кутами і білі поля навколо коду; без рамки код займає майже все зображення

Параметри можна поєднувати в будь-якому порядку. У центрі коду завжди стоїть емблема IBAN oplata.

Що побачить платник

У QR-коді записана адреса сторінки оплати посилання. Платник сканує код камерою телефону і потрапляє на ту саму сторінку, що й за посиланням: бачить отримувача, суму, призначення платежу і кнопку Оплатити. Окремої оплати «за QR» немає — це той самий сценарій, що й оплата за посиланням.

Якщо щось не так