Монобанк еквайринг (Plata by mono) приймає оплату одразу після оформлення: покупець платить карткою будь-якого банку, Apple Pay чи Google Pay на сторінці monobank, а замовлення саме стає оплаченим. Достатньо вписати токен з кабінету monobank у налаштуваннях магазину в Elbuz.
Коли це знадобиться:
- Рахунок ФОП чи ТОВ у monobank — гроші з сайту йдуть на нього, статус замовлення змінюється сам.
- Наявність треба спершу перевірити — холд блокує гроші на картці, списання — коли ви підтвердите.
- Потрібен склад замовлення в чеку monobank — модуль передає товари, доставку і знижки.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → картка monobank → токен і перемикач «Увімкнено».
Що вміє оплата monobank
- Приймати оплату на сторінці monobank — картка будь-якого банку, Apple Pay, Google Pay.
- Холд — гроші блокуються на картці, списуються після вашого підтвердження.
- Ставити статус замовлення сам — оплачено, холд, повернено.
- Передавати склад замовлення — товари видно на сторінці оплати й у фіскальному чеку monobank.
- Повертати гроші — усю суму або частинами.
Як підключити еквайринг monobank
Потрібен рахунок ФОП або ТОВ у monobank з підключеним інтернет-еквайрингом. Умови й комісію повідомляє банк.
- Візьміть токен. У кабінеті web.monobank.ua відкрийте «Інтернет-еквайринг» → ключі й скопіюйте токен (X-Token). Він секретний, нікому його не пересилайте.
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка monobank.
- Вставте токен у поле «Токен (X-Token)» блоку «Підключення».
- Увімкніть перемикач «Увімкнено» вгорі екрана.
- Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
1
Оплата monobank2
Позначка стану- Рядок модуля — відкриває екран налаштування оплати monobank.
- Позначка стану показує, що для оплати ще потрібні ключі; для готового модуля вона показує, чи бачать покупці оплату і чи дійшли останні зміни до магазину.
1
Перемикач «Увімкнено»2
Токен (X-Token)3
Адреса вебхука4
Що ще не налаштовано5
Стан модуля- Перемикач «Увімкнено» — показує monobank покупцям після збереження.
- Токен (X-Token) — токен з кабінету monobank: після збереження його не видно, лише позначку, що він заданий.
- Адреса вебхука — адреса для повідомлень банку; модуль передає її сам, вписувати її нікуди не треба.
- «Що ще не налаштовано» — чого бракує, щоб оплата працювала.
- Пілюля стану — стан модуля в магазині.
Без токена увімкнений модуль не збережеться: під полем буде «Заповніть — без цього модуль не працюватиме». Токен коротший за 20 символів або з пробілами екран не прийме. Після збереження токен не показується — щоб змінити, натисніть «Замінити» і вставте новий.
У кабінеті monobank нічого вписувати не треба: адресу для повідомлень про оплату модуль передає з кожним рахунком сам. Вона показана в блоці «Підключення» як «Адреса вебхука» — на випадок, якщо банк її попросить.
Що ще не налаштовано, видно праворуч, у картці «Що ще не налаштовано». Як влаштоване вікно загалом — у статті «Налаштування магазину».
Що бачить покупець і для яких замовлень
У списку оплат покупець бачить «Оплата карткою через monobank» з підказкою про Visa, Mastercard, Apple Pay і Google Pay. Після підтвердження замовлення — коротке «Переходимо на сторінку оплати monobank…» і сама сторінка банку.
- Оплатив — повертається на сторінку успішного замовлення.
- Не оплатив — повертається в оформлення з «Оплату не завершено. Спробуйте ще раз або оберіть інший спосіб оплати.» і причиною від банку. Кошик і дані зберігаються.
- Сторінка банку не відкрилась — «Не вдалося відкрити сторінку оплати…» і кнопка «Оплатити», щоб спробувати ще раз.
Рахунок на оплату діє 24 години. Повторна спроба протягом доби відкриває той самий рахунок, якщо сума замовлення не змінилась.
Поля блоку «Оплата»
1
Спосіб списання2
Валюта рахунку3
Передавати склад кошика4
Код товару в чеку- Списати гроші одразу чи заблокувати до вашого підтвердження.
- У цю валюту перераховується сума замовлення.
- Товари, доставка й знижки на сторінці оплати та в чеку monobank.
- Яке поле товару піде кодом у чек.
| Поле | Що робить | Типово |
|---|---|---|
| Спосіб списання | «Одразу списати» або «Заблокувати кошти, списати пізніше» (холд) | Одразу списати |
| Валюта рахунку | UAH, USD або EUR. Сума замовлення перераховується в неї за курсом магазину. USD і EUR — лише якщо їх увімкнув вам банк | UAH |
| Передавати склад кошика | Склад замовлення на сторінці оплати та в чеку monobank — що саме йде | увімкнено |
| Код товару в чеку | Лише зі складом кошика: модель, артикул, ID товару в магазині, штрихкод UPC чи EAN, ISBN або код виробника | Модель |
| Квитанція на email покупця | monobank надішле квитанцію на email із замовлення | вимкнено |
Валюту рахунку магазин бере зі своїх валют. Немає її в магазині — покупці не побачать monobank. Валюти й курси приходять у магазин з вікна «Валюти» в Elbuz, якщо в рядку валюти стоять «Активність» і «Вивантаження на сайт»: Курси валют.
Склад замовлення в чеку
Товари йдуть за ціною з податком, разом із фото. Доставка й інші доплати — окремими рядками, знижки розносяться по товарах. Порожнє поле коду в товару — замість нього піде ID товару.
Якщо знижка більша, ніж можна рознести по товарах, рахунок піде без складу — лише сумою. Фіскальний чек зі складом видає monobank, якщо ви підключили в банку фіскалізацію.
Для яких замовлень показувати
- «Географічна зона» у блоці «Де показувати» — оплата лише для покупців з адресою доставки в цій зоні; «Усі зони» — для всіх.
- «Порядок сортування» — місце в списку оплат, менше число стоїть вище.
- «Призначення платежу» у згорнутому блоці «Додатково» — текст у платежі.
%sзамінюється номером замовлення. Порожньо — «Оплата замовлення №» і номер. - «Журнал запитів до банку» там само — записує запити до monobank і відповіді банку для служби підтримки. Типово вимкнено, токен у журнал не потрапляє.
Свою назву, опис і мінімальну суму товарів у кошику для способу задає служба підтримки Elbuz. Нижче мінімальної суми покупець бачить спосіб неактивним: «Оплата «…» доступна від …».
Холд і статуси замовлення
Списати одразу чи заблокувати
Це поле «Спосіб списання» в блоці «Оплата».
| Спосіб списання | Що з грошима | Кому підходить |
|---|---|---|
| Одразу списати | Списуються одразу | Товар на складі, відправка одразу |
| Заблокувати кошти, списати пізніше | Блокуються на картці; списуються, коли ви підтвердите холд | Товар везе постачальник, наявність треба перевірити |
Для холду в блоці «Статуси замовлення» з'являється поле «Кошти заблоковано (холд)». Якщо воно збігається з «Оплачено», праворуч буде «Статуси «Оплачено» і «Кошти заблоковано» однакові — холд не відрізнити від оплати».
Холд живе обмежений час: потім банк сам знімає блокування, і гроші повертаються покупцю. Точний термін — в умовах monobank. Підтверджуйте холд, щойно товар є.
Які статуси ставляться
Статус ставить магазин сам, коли monobank повідомляє про оплату. Які саме — обираєте в блоці «Статуси замовлення» зі статусів магазину.
1
Оплачено2
Кошти заблоковано (холд)3
Повернуто4
Статус, якщо сума оплати не збігається- Оплачено — ставиться, коли покупець заплатив або ви підтвердили холд.
- Кошти заблоковано (холд) — гроші заблоковано й чекають підтвердження; поле видно лише для холду.
- Повернуто — гроші повернено повністю або холд скасовано.
- Статус, якщо сума оплати не збігається — оплачено, але сума замовлення вже інша: замовлення приходить з цим статусом, щоб ви його перевірили.
| Поле | Коли ставиться | Типово |
|---|---|---|
| Оплачено | Покупець заплатив або ви підтвердили холд | В обробці |
| Кошти заблоковано (холд) | Гроші заблоковано й чекають вашого підтвердження | Оброблено |
| Повернуто | Гроші повернено повністю або холд скасовано | Кошти повернено |
| Статус, якщо сума оплати не збігається | Покупець оплатив рахунок, а сума замовлення тим часом змінилась | Очікує |
Коли оплата чи холд ставить замовленню перший статус, покупцю йде звичайний лист про замовлення. Списаний чи знятий холд і повне повернення теж змінюють статус — покупець отримує лист про зміну статусу. Часткове повернення статус не змінює, листа немає.
Поки monobank не підтвердив оплату, замовлення лишається непідтвердженим і не вважається новим. Не оплатив — замовлення не скасовується: покупець може оплатити його знову.
Повідомлення банку магазин перевіряє: статус і суму бере з monobank, а не з самого повідомлення.
Сума оплати не збігається із сумою замовлення
Так буває, коли покупець після спроби оплати змінив кошик або між рахунком і оплатою змінився курс. Гроші отримано, тому замовлення підтверджується й приходить в Elbuz, але не як оплачене. Воно отримує статус з поля «Статус, якщо сума оплати не збігається».
Цей статус має відрізнятися від «Оплачено» і «Кошти заблоковано (холд)». Збігається — магазин поставить статус нового замовлення, а якщо й той дорівнює «Оплачено», замовлення лишиться непідтвердженим. Такий збіг праворуч підсвітить «Статус розбіжності суми збігається з «Оплачено» або холдом…».
У магазинах, налаштованих раніше, «Кошти заблоковано (холд)» може стояти «Очікує» — як і статус розбіжності. Тоді праворуч буде це попередження: оберіть для холду чи розбіжності інший статус.
Повернення й холд у картці замовлення
Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «Банківська карта». У його картці є блок «Платіж у monobank». Він показує стан платежу, суму, скільки списано й повернено, скільки ще можна повернути, і всі спроби оплати.
Кнопки — лише ті, що доступні замовленню зараз:
| Кнопка | Що робить | Статус після |
|---|---|---|
| Повернути кошти | Повертає всю суму або частину: поле суми вже заповнене залишком, для часткового повернення впишіть меншу | Повне — «Повернуто», часткове — без змін |
| Списати холд | Списує заблоковану суму або меншу, якщо частини товару немає | «Оплачено» |
| Зняти холд | Скасовує блокування, гроші повертаються покупцю | «Повернуто» |
| Оновити статус | Бере стан платежу з monobank, якщо повідомлення не дійшло. Повтор нічого не дублює | за станом платежу |
Перед кожною операцією з грошима програма питає підтвердження; для повернення й зняття холду — з попередженням «Цю операцію не можна скасувати.». Статус замовлення на сайті змінюється так само, як після повідомлення monobank.
Магазин не відповів — під повідомленням з'явиться «Повторити»: вона повторює ту саму операцію, і гроші вдруге не рухаються. Нове натискання кнопки — це вже нова операція.
Повертати гроші й керувати холдом може лише користувач із правом «Операції оплати: повернення, холд, кредит» — типово власник. «Оновити статус» доступне всім, хто бачить замовлення.
Коли через monobank уже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.
Як перевірити тестовим платежем
- Отримайте тестовий токен на api.monobank.ua — вхід через застосунок monobank. Впишіть його в «Токен (X-Token)» і збережіть.
- Оформіть на сайті замовлення на себе, оберіть «Оплата карткою через monobank» і оплатіть. З тестовим токеном гроші не списуються.
- Перевірте, що на сторінці банку правильна сума, а замовлення прийшло в Elbuz у «Замовлення покупця» з видом оплати «Банківська карта».
- Замініть токен бойовим з кабінету web.monobank.ua і збережіть.
Сценарії
Електроніка під замовлення: списувати після перевірки наявності
«Спосіб списання» — «Заблокувати кошти, списати пізніше». У «Кошти заблоковано (холд)» оберіть статус, відмінний від «Оплачено».
Товар є — «Списати холд» у картці замовлення. Частини немає — впишіть меншу суму. Немає нічого — «Зняти холд», гроші розблоковуються.
Фіскальний чек monobank зі складом замовлення
Увімкніть «Передавати склад кошика», у «Код товару в чеку» оберіть поле, яке заповнене в усіх товарах, наприклад артикул. Покупець бачить список товарів на сторінці оплати, а в чеку — ті самі рядки.
Ціни в доларах, оплата в гривнях
«Валюта рахунку» — UAH. Магазин перерахує суму за курсом, що прийшов з вікна «Валюти» Elbuz. Курс у Elbuz оновився — сума в рахунку зміниться після наступного вивантаження.
Курс змінився між створенням рахунку й оплатою — замовлення прийде зі статусом розбіжності суми: як це працює.
Що робити, коли оплата не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець не бачить monobank при оформленні | Модуль вимкнено, токен не задано, валюти рахунку немає в магазині, адреса не в гео-зоні або спосіб обмежено в налаштуваннях оформлення замовлення | Перевірте «Увімкнено», токен, «Валюта рахунку» і «Географічна зона». Валюта — у вікні «Валюти» з «Активність» і «Вивантаження на сайт». Усе так — підтримка Elbuz перевірить оформлення замовлення |
| Покупець бачить «Не вдалося відкрити сторінку оплати» | Найчастіше неправильний токен або еквайринг ще не активовано | Вставте токен ще раз через «Замінити». Не допомогло — увімкніть «Журнал запитів до банку» в блоці «Додатково», повторіть оплату й напишіть підтримці Elbuz |
| Оплата пройшла, а статус не змінився | Повідомлення банку не дійшло до магазину | Натисніть «Оновити статус» у картці замовлення. Статус оновиться й тоді, коли покупець повернеться в магазин зі сторінки банку |
| Оплачене замовлення прийшло в Elbuz зі статусом розбіжності суми, а не «Оплачено» | Покупець змінив кошик після спроби оплати або змінився курс | Порівняйте платіж у кабінеті monobank із сумою замовлення і вирішіть: доплата, повернення або зміна замовлення |
| Сума на сторінці банку відрізняється від ціни на сайті | Замовлення в іншій валюті, сума перерахована у валюту рахунку | Перевірте курс у вікні «Валюти» Elbuz і вивантажте його в магазин |
Часті запитання
Це те саме, що «Покупка частинами» monobank?
Ні. «Покупка частинами» — окремий спосіб оплати в модулі кредитів, зі своїми налаштуваннями (Кредит і оплата частинами). Цей модуль приймає повну оплату або холд.
Що буде, якщо вимкнути модуль?
monobank зникне з оформлення замовлення. Токен і налаштування зберігаються: увімкнете знову — усе на місці. Оплати, розпочаті до вимкнення, підтвердяться, лише коли покупець повернеться з monobank у магазин.
Чи можна надіслати покупцю посилання на оплату monobank?
Так, з картки замовлення в Elbuz. Токен для посилань задається окремо: Оплата за посиланням.
Чи отримує покупець лист після повернення?
Так, при повному поверненні: статус змінюється на обраний у полі «Повернуто», і покупець отримує звичайний лист про зміну статусу. При частковому поверненні статус не змінюється, листа немає.
Покупець закрив сторінку банку, не оплативши, — де це замовлення?
Воно лишається непідтвердженим і в Elbuz не приходить. Рахунок діє 24 години: покупець може повернутися в кошик і оплатити знову.
У списку «Географічна зона» немає потрібної зони — що робити?
Зону, наприклад «Україна», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → картка monobank
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»; повернення й холд — право «Операції оплати: повернення, холд, кредит»
- Підготувати
- рахунок ФОП чи ТОВ у monobank з інтернет-еквайрингом, токен (X-Token)
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо покупець хоче оплатити замовлення, прийняте телефоном — Оплата за посиланням.
- Якщо сума в рахунку не та через курс — Курси валют.
- Якщо поруч потрібен ще й LiqPay — Оплата LiqPay в магазині.
