Документація

Оплата за реквізитами через IBAN oplata

Як підключити IBAN oplata: токен, реквізити одержувача, налаштування способу оплати, як позначити оплату й чому посилання закривається само.

На цій сторінці

IBAN oplata — сервіс, який робить із ваших реквізитів сторінку оплати. Покупець відкриває її, бачить суму та одержувача, обирає свій банк, і переказ відкривається в банківському застосунку вже заповненим. Можна й відсканувати QR-код. Гроші надходять просто на ваш рахунок, без еквайрингу та його комісії.

Доповнення «IBAN oplata» додає такий спосіб в оформлення замовлення. Після оформлення покупець бачить сторінку «Замовлення оформлено» з кнопкою «Сплатити». Після натискання кнопки магазин створює в IBAN oplata посилання на суму замовлення й відправляє покупця на нього.

Що важливо знати заздалегідь

IBAN oplata не повідомляє магазин, що гроші надійшли. Ні запиту «чи сплачено», ні сповіщення про оплату в API сервісу немає. Тому замовлення лишається зі статусом оплати «Очікує оплати», доки ви не позначите оплату самі (як це зробити — нижче, у розділі «Як позначити оплату»).

Крім того:

  • Приймаються лише замовлення в гривні. Замовлення в іншій валюті на сторінку оплати не йде.
  • Рахунок одержувача — український IBAN (UA і 27 цифр).
  • Працювати з API IBAN oplata можна лише на тарифі «Преміум».
  • Магазину потрібен налаштований рядок планувальника: посилання закриваються у фоні, див. Обслуговування.

Крок 1. Токен у кабінеті IBAN oplata

Зареєструйтеся на ibanoplata.com і підключіть тариф «Преміум». У меню кабінету відкрийте «API Токен» і створіть токен. Скопіюйте його повністю.

Якщо пізніше ви перегенеруєте токен, старий IBAN oplata тримає робочим ще 12 годин. За цей час вставте новий токен у налаштування способу оплати (крок 3). Якщо видалити токен у кабінеті, оплата через магазин зупиниться одразу.

Крок 2. Реквізити одержувача в магазині

Посилання на оплату магазин збирає з реквізитів продавця. Відкрийте «Налаштування» → «Друковані форми», профіль реквізитів, і перевірте три поля:

  • «Повна назва» — наприклад, «ФОП Іваненко Іван Іванович». Це ім’я покупець побачить як одержувача. IBAN oplata приймає не більше 70 знаків: довшу назву магазин обріже й попередить про це в списку способів оплати.
  • «Податковий номер» — код ЄДРПОУ (8 цифр) або ІПН (10 цифр).
  • «Рахунок IBAN» — починається з UA. Пробіли можна лишити, магазин прибере їх сам.

Якщо хоча б одного з цих полів немає або номер не тієї довжини, магазин посилання не створює, і покупець на оплату не потрапить (докладніше — у розділі «Часті проблеми»).

Якщо вітрин кілька й у кожної свій продавець, у кожної вітрини може бути свій профіль реквізитів.

Крок 3. Спосіб оплати

Встановіть доповнення «IBAN oplata» в розділі «Налаштування» → «Платформа» → «Встановлення та оновлення».

Відкрийте «Налаштування» → «Оплата і доставка», натисніть «плюс» біля списку «Оплата» і в полі «Платіжна система» оберіть IBAN oplata. У «Назва для покупця» напишіть те, що покупець побачить під час оформлення, наприклад «Оплата за реквізитами». У блоці «Де працює» позначте вітрини.

У блоці «Налаштування способу» заповніть поля:

  • «API-токен» — токен із кроку 1. Після збереження він приховується, а порожнє поле під час наступного збереження збережений токен не стирає.
  • «На чиї реквізити приймати оплату» — за замовчуванням стоїть «Реквізити вітрини, де оформлено замовлення»: кожна вітрина приймає гроші на свій профіль із кроку 2. Якщо обрати конкретний профіль, усі вітрини, де працює цей спосіб, прийматимуть оплату на нього.
  • «Призначення платежу» — текст, який покупець побачить у своєму банку, а ви — у виписці. Замість {number} магазин підставить номер замовлення. За замовчуванням: «Оплата за замовлення № {number}». IBAN oplata приймає не більше 140 знаків. Якщо текст довший, магазин скорочує ваш текст, а номер замовлення лишає повністю, щоб платіж у виписці можна було зіставити із замовленням.
  • «Посилання діє, годин» — за замовчуванням 72. Коли строк мине, сплатити за посиланням уже не вийде. 0 — посилання діє без обмеження. Порожнє поле або від’ємне число магазин вважає за 72 години.

Натисніть «Зберегти».

Як це бачить покупець

  1. Покупець обирає спосіб під час оформлення й натискає «Оформити замовлення».
  2. Магазин показує сторінку «Замовлення оформлено»: номер замовлення, суму й під ними підказку та кнопку «Сплатити».
  3. Після натискання кнопки магазин створює посилання в IBAN oplata й відправляє покупця на сторінку оплати. На ній — одержувач, сума, призначення платежу, кнопка «Оплатити» та реквізити, які можна скопіювати.
  4. Покупець платить зі свого банку. Гроші надходять вам на рахунок.

Одразу на IBAN oplata магазин покупця не відправляє, бо повернутися звідти в магазин не можна. Так покупець встигає побачити підтвердження й номер замовлення, а аналітика магазину отримує покупку. Посилання створюється лише після натискання кнопки, тому замовлення, які так і не почали сплачувати, посилань тарифу не витрачають.

Кнопку магазин ставить сам у місце для доповнень на сторінці «Замовлення оформлено», яке є в усіх штатних темах. Вигляд кнопки задають стилі оформлення замовлення вашої теми. Якщо у своїй темі ви це місце прибрали, кнопки не буде, і сплатити покупець зможе лише зі сторінки оплати замовлення: з особистого кабінету або за посиланням на оплату.

Сторінка «Замовлення оформлено» показується один раз. Якщо покупець пішов з неї, не сплативши, повернутися до оплати він може з особистого кабінету або за посиланням на оплату в листі. У стандартному листі про нове замовлення такого посилання немає. Щоб воно там було, додайте в лист змінну «Посилання на оплату замовлення» в розділі «Налаштування» → «Сповіщення» → «Сповіщення».

Замовлення, яке ви створили в панелі або яке покупець оформив в один клік, сторінку «Замовлення оформлено» не показує, і кнопки «Сплатити» в покупця не буде. Надішліть йому посилання на оплату: для цього в замовленні є готовий шаблон повідомлення «Посилання на оплату». Покупець, який увійшов в особистий кабінет, знайде кнопку оплати й там.

Якщо покупець повернувся до оплати пізніше, він натискає «Сплатити» в особистому кабінеті або відкриває посилання на оплату, і магазин показує сторінку оплати замовлення. Її кнопка «Перейти до оплати» веде на те саме посилання IBAN oplata. Нове створюється, лише якщо змінилася сума до сплати, ви змінили реквізити (рахунок, назву чи податковий номер), до кінця строку старого лишилося менше пів години або магазин закрив попереднє посилання (про це нижче). Так покупець не отримує кількох посилань на одне замовлення, а ви не витрачаєте посилання тарифу.

У кабінеті IBAN oplata в кожного посилання в примітці стоїть номер замовлення: за ним видно, до якого замовлення воно належить.

Як позначити оплату

Побачили гроші у виписці — відкрийте замовлення в розділі «Замовлення» і в полі «Статус оплати» оберіть «Оплачено». Далі все як за будь-якої іншої оплати: лист покупцеві й чек, якщо каса налаштована видавати його під час оплати цим способом.

Коли посилання закривається само

Магазин видаляє посилання в IBAN oplata, і сплатити за ним уже не можна:

  • ви скасували або видалили замовлення — щоб покупець не переказав гроші за те, чого вже не буде;
  • ви позначили оплату — щоб покупець, відкривши посилання ще раз, не сплатив удруге. Якщо ви обрали «Оплачено частково», нового посилання магазин не видає: скільки грошей уже надійшло, йому невідомо, а посилання на всю суму змусило б покупця переплатити. Кнопка оплати відповість покупцеві «Частину суми за цим замовленням уже отримано. Зв’яжіться з нами, і ми підкажемо, скільки лишилося сплатити». Про залишок домовтеся з покупцем самі. Посилання закривається й за будь-якої іншої зміни статусу оплати, наприклад на «Повернення»;
  • ви змінили суму замовлення або змінили спосіб оплати — щоб покупець не переказав колишню суму. Нове посилання він отримає, коли знову натисне кнопку оплати.

Покупець, який відкрив закрите посилання, побачить в IBAN oplata: «На жаль, це посилання для оплати більше недоступне». Посилання закривається у фоні через чергу задач, тому магазину потрібен налаштований рядок планувальника, див. Обслуговування. Якщо IBAN oplata в цей момент недоступний, магазин повторить спробу ще кілька разів протягом півтори години. Якщо закрити посилання так і не вдалося, в історії замовлення з’явиться запис про це: видаліть таке посилання в кабінеті IBAN oplata самі, знайти його можна за номером замовлення в примітці.

Часті проблеми

У списку способів оплати біля способу IBAN oplata стоїть попередження. Магазин сам перевіряє, чи зможе спосіб створити посилання, і називає, що заважає: не задано API-токен, спосіб увімкнено на вітрині, яка продає не в гривні, обрані реквізити видалено або в реквізитах, на які спосіб приймає оплату (обраних у ньому чи реквізитах вітрини, де він працює), не заповнено «Повна назва», «Податковий номер» не з 8 чи 10 цифр, «Рахунок IBAN» не починається з UA. Вітрини, на яких спосіб вимкнено, магазин не перевіряє. Доки попередження не зникне, покупці названої вітрини на сторінку оплати не потраплять. Виняток — задовга «Повна назва»: сплатити вона не заважає, покупець просто побачить її обрізаною.

Правильність самого токена магазин заздалегідь не перевіряє. Якщо токен неправильний, попередження не буде, а причина з’явиться в журналі під час першої спроби оплати (див. нижче).

Покупець натиснув «Сплатити», але на сторінку оплати не потрапив. Над кнопкою він прочитав: «Оплата за реквізитами зараз недоступна. Ми отримали ваше замовлення й зв’яжемося з вами, щоб допомогти з оплатою». Замовлення при цьому створене. Зв’яжіться з покупцем самі. Причину магазин пише в «Налаштування» → «Система» → «Журнали»:

  • «IBAN oplata: не задан ключ API» — у налаштуваннях способу порожнє поле «API-токен».
  • «IBAN oplata: реквизиты не годятся для ссылки» — поруч сказано, якого поля з кроку 2 бракує і в якому профілі.
  • «IBAN oplata: ссылка на оплату не создана» з поясненням «IBAN oplata не прийняв токен: токен неправильний або закінчився тариф «Преміум»» — токен видалений або перегенерований понад 12 годин тому, або закінчився тариф.
  • «IBAN oplata: ссылка на оплату не создана» з поясненням «IBAN oplata не відповідає» — сервіс був недоступний. Покупець може повторити оплату пізніше тією самою кнопкою.

Записи журналу магазин пише російською, а пояснення до них — мовою сторінки, з якої покупець переходив до оплати.

Замість кнопки «Сплатити» покупець бачить «Через IBAN oplata можна сплатити лише замовлення в гривні. Зв’яжіться з нами, і ми допоможемо з оплатою». Замовлення оформлене в іншій валюті, і посилання на нього магазин не створює. Увімкніть цей спосіб лише на вітринах, які продають у гривні: про таку вітрину магазин попереджає в списку способів оплати.

Замовлення сплачене, а в магазині «Очікує оплати». Так і має бути: IBAN oplata про оплату не повідомляє. Позначте оплату вручну, як описано вище.

Оновлено 12 жовтня 2026