QR-код через пряме посилання
- Доступно на всіх тарифах, включно з Безкоштовним
QR-код будь-якого посилання на оплату можна отримати як зображення за адресою: допишіть «/qr» у кінець адреси посилання, і замість сторінки оплати відкриється картинка з QR-кодом. Наприклад, для посилання https://ibanoplata.com/iban-qr/<ідентифікатор> зображення лежить за адресою https://ibanoplata.com/iban-qr/<ідентифікатор>/qr. Ні кабінет, ні API-токен для цього не потрібні: адресу можна одразу вставити на сайт, у лист, рахунок чи документ, який формує ваша CRM, а параметри в адресі задають формат, розмір, підпис і рамку.
Коли це потрібно
Пряме посилання на QR зручне, коли посилання створюються автоматично — через API чи інтеграцію — і QR-код має зʼявлятися поруч без ручного завантаження: на сторінці замовлення, у листі з рахунком, у документі для друку. Якщо потрібен QR-код для одного посилання або готова картка з назвою компанії для друку, завантажте його в кабінеті — це описано в статті QR-код і готова картка для друку.
Отримати адресу QR-коду
- Візьміть адресу посилання на оплату. У кабінеті — у списку Мої посилання відкрийте меню дій рядка й оберіть Скопіювати посилання; посилання, створене через API, повертається у відповіді на запит створення.
- Допишіть у кінець адреси «/qr». Відкрийте отриману адресу в браузері — зʼявиться QR-код у форматі SVG шириною 300 пікселів, у сірій рамці, з підписом «скануйте QR-код для оплати».
- Якщо потрібен інший вигляд, допишіть після «/qr» знак «?» і параметри через «&», наприклад:
https://ibanoplata.com/iban-qr/<ідентифікатор>/qr?format=png&size=500&showText=false - Вставте адресу туди, де має бути QR-код: у сайт або шаблон листа — як адресу зображення, у документ — як картинку за посиланням.
Зображення створюється заново на кожен запит, тож зберігати його в себе не обовʼязково: адреса працює, доки працює саме посилання.
Параметри зображення
| Параметр | Значення | За замовчуванням | Що змінює |
|---|---|---|---|
format |
svg або png |
svg |
SVG масштабується без втрати якості — для друку й макетів; PNG — звичайна картинка для документів, месенджерів і поштових програм, які не показують SVG |
size |
ціле число пікселів | 300 |
Ширина зображення; з підписом зображення на 60 пікселів вище за ширину |
showText |
true або false |
true |
Підпис «скануйте QR-код для оплати» під кодом |
showBorder |
true або false |
true |
Сіра рамка із заокругленими кутами і білі поля навколо коду; без рамки код займає майже все зображення |
Параметри можна поєднувати в будь-якому порядку. У центрі коду завжди стоїть емблема IBAN oplata.
Що побачить платник
У QR-коді записана адреса сторінки оплати посилання. Платник сканує код камерою телефону і потрапляє на ту саму сторінку, що й за посиланням: бачить отримувача, суму, призначення платежу і кнопку Оплатити. Окремої оплати «за QR» немає — це той самий сценарій, що й оплата за посиланням.
Якщо щось не так
- Замість QR-коду зображення не показується або відкривається текст помилки. QR-код створюється лише для посилання, яке зараз можна оплатити. Його немає, якщо посилання видалене, його термін дії минув, реквізити в ньому призупинені, або якщо це посилання з відкритою сумою чи з запитом даних платника, а тариф цієї можливості вже не дає. Перевірте посилання у списку Мої посилання і статус реквізитів на сторінці Мої реквізити.
- Адреса з «/qr» не відкриває зображення. Пряме посилання на QR працює лише для адрес виду
https://ibanoplata.com/iban-qr/<ідентифікатор>. Переконайтеся, що «/qr» стоїть одразу після ідентифікатора, а параметри — після знака «?». - QR-код погано сканується. Зображення замале для друку або екрана — збільште
sizeчи візьміть формат SVG. На темному тлі лишайте рамку: без неї навколо коду майже немає білого поля, і камера може його не розпізнати. - Поштова програма не показує QR-код. Частина поштових програм не відображає SVG. Додайте до адреси
format=png.