Оплата по реквизитам через 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 часа.
Нажмите «Сохранить».
Как это видит покупатель
- Покупатель выбирает способ при оформлении и нажимает «Оформить заказ».
- Магазин показывает страницу «Заказ оформлен»: номер заказа, сумму и под ними подсказку и кнопку «Оплатить».
- По кнопке магазин создаёт ссылку в IBAN oplata и отправляет покупателя на страницу оплаты. На ней — получатель, сумма, назначение платежа, кнопка «Оплатити» и реквизиты, которые можно скопировать.
- Покупатель платит из своего банка. Деньги приходят вам на счёт.
Сразу на 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 об оплате не сообщает. Отметьте оплату вручную, как описано выше.