↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Інтернет-магазин Elbuz CMS
    4. Оплата

    Як приймати оплату monobank в магазині

    10 хв читанняОновлено

    Монобанк еквайринг (Plata by mono) приймає оплату одразу після оформлення: покупець платить карткою будь-якого банку, Apple Pay чи Google Pay на сторінці monobank, а замовлення саме стає оплаченим. Достатньо вписати токен з кабінету monobank у налаштуваннях магазину в Elbuz.

    Коли це знадобиться:

    • Рахунок ФОП чи ТОВ у monobank — гроші з сайту йдуть на нього, статус замовлення змінюється сам.
    • Наявність треба спершу перевірити — холд блокує гроші на картці, списання — коли ви підтвердите.
    • Потрібен склад замовлення в чеку monobank — модуль передає товари, доставку і знижки.

    З чого почати: «Налаштування магазину» → «Оформлення і оплата» → картка monobank → токен і перемикач «Увімкнено».

    Що вміє оплата monobank

    Як підключити еквайринг monobank

    Потрібен рахунок ФОП або ТОВ у monobank з підключеним інтернет-еквайрингом. Умови й комісію повідомляє банк.

    1. Візьміть токен. У кабінеті web.monobank.ua відкрийте «Інтернет-еквайринг» → ключі й скопіюйте токен (X-Token). Він секретний, нікому його не пересилайте.
    2. Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка monobank.
    3. Вставте токен у поле «Токен (X-Token)» блоку «Підключення».
    4. Увімкніть перемикач «Увімкнено» вгорі екрана.
    5. Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
    Розділ «Оформлення і оплата» у вікні «Налаштування магазину» зі списком платіжних модулів
    1Оплата monobank
    2Позначка стану
    1. Рядок модуля — відкриває екран налаштування оплати monobank.
    2. Позначка стану показує, що для оплати ще потрібні ключі; для готового модуля вона показує, чи бачать покупці оплату і чи дійшли останні зміни до магазину.
    Екран «Оплата monobank»: шапка, блок «Підключення» і праворуч «Що ще не налаштовано»
    1Перемикач «Увімкнено»
    2Токен (X-Token)
    3Адреса вебхука
    4Що ще не налаштовано
    5Стан модуля
    1. Перемикач «Увімкнено» — показує monobank покупцям після збереження.
    2. Токен (X-Token) — токен з кабінету monobank: після збереження його не видно, лише позначку, що він заданий.
    3. Адреса вебхука — адреса для повідомлень банку; модуль передає її сам, вписувати її нікуди не треба.
    4. «Що ще не налаштовано» — чого бракує, щоб оплата працювала.
    5. Пілюля стану — стан модуля в магазині.

    Без токена увімкнений модуль не збережеться: під полем буде «Заповніть — без цього модуль не працюватиме». Токен коротший за 20 символів або з пробілами екран не прийме. Після збереження токен не показується — щоб змінити, натисніть «Замінити» і вставте новий.

    У кабінеті monobank нічого вписувати не треба: адресу для повідомлень про оплату модуль передає з кожним рахунком сам. Вона показана в блоці «Підключення» як «Адреса вебхука» — на випадок, якщо банк її попросить.

    Що ще не налаштовано, видно праворуч, у картці «Що ще не налаштовано». Як влаштоване вікно загалом — у статті «Налаштування магазину».

    Що бачить покупець і для яких замовлень

    У списку оплат покупець бачить «Оплата карткою через monobank» з підказкою про Visa, Mastercard, Apple Pay і Google Pay. Після підтвердження замовлення — коротке «Переходимо на сторінку оплати monobank…» і сама сторінка банку.

    • Оплатив — повертається на сторінку успішного замовлення.
    • Не оплатив — повертається в оформлення з «Оплату не завершено. Спробуйте ще раз або оберіть інший спосіб оплати.» і причиною від банку. Кошик і дані зберігаються.
    • Сторінка банку не відкрилась — «Не вдалося відкрити сторінку оплати…» і кнопка «Оплатити», щоб спробувати ще раз.

    Рахунок на оплату діє 24 години. Повторна спроба протягом доби відкриває той самий рахунок, якщо сума замовлення не змінилась.

    Поля блоку «Оплата»

    Блок «Оплата»: спосіб списання, валюта, склад кошика, код товару в чеку
    1Спосіб списання
    2Валюта рахунку
    3Передавати склад кошика
    4Код товару в чеку
    1. Списати гроші одразу чи заблокувати до вашого підтвердження.
    2. У цю валюту перераховується сума замовлення.
    3. Товари, доставка й знижки на сторінці оплати та в чеку monobank.
    4. Яке поле товару піде кодом у чек.
    ПолеЩо робитьТипово
    Спосіб списання«Одразу списати» або «Заблокувати кошти, списати пізніше» (холд)Одразу списати
    Валюта рахунку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Статус, якщо сума оплати не збігається
    1. Оплачено — ставиться, коли покупець заплатив або ви підтвердили холд.
    2. Кошти заблоковано (холд) — гроші заблоковано й чекають підтвердження; поле видно лише для холду.
    3. Повернуто — гроші повернено повністю або холд скасовано.
    4. Статус, якщо сума оплати не збігається — оплачено, але сума замовлення вже інша: замовлення приходить з цим статусом, щоб ви його перевірили.
    ПолеКоли ставитьсяТипово
    ОплаченоПокупець заплатив або ви підтвердили холдВ обробці
    Кошти заблоковано (холд)Гроші заблоковано й чекають вашого підтвердженняОброблено
    ПовернутоГроші повернено повністю або холд скасованоКошти повернено
    Статус, якщо сума оплати не збігаєтьсяПокупець оплатив рахунок, а сума замовлення тим часом зміниласьОчікує

    Коли оплата чи холд ставить замовленню перший статус, покупцю йде звичайний лист про замовлення. Списаний чи знятий холд і повне повернення теж змінюють статус — покупець отримує лист про зміну статусу. Часткове повернення статус не змінює, листа немає.

    Поки monobank не підтвердив оплату, замовлення лишається непідтвердженим і не вважається новим. Не оплатив — замовлення не скасовується: покупець може оплатити його знову.

    Повідомлення банку магазин перевіряє: статус і суму бере з monobank, а не з самого повідомлення.

    Сума оплати не збігається із сумою замовлення

    Так буває, коли покупець після спроби оплати змінив кошик або між рахунком і оплатою змінився курс. Гроші отримано, тому замовлення підтверджується й приходить в Elbuz, але не як оплачене. Воно отримує статус з поля «Статус, якщо сума оплати не збігається».

    Цей статус має відрізнятися від «Оплачено» і «Кошти заблоковано (холд)». Збігається — магазин поставить статус нового замовлення, а якщо й той дорівнює «Оплачено», замовлення лишиться непідтвердженим. Такий збіг праворуч підсвітить «Статус розбіжності суми збігається з «Оплачено» або холдом…».

    У магазинах, налаштованих раніше, «Кошти заблоковано (холд)» може стояти «Очікує» — як і статус розбіжності. Тоді праворуч буде це попередження: оберіть для холду чи розбіжності інший статус.

    Повернення й холд у картці замовлення

    Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «Банківська карта». У його картці є блок «Платіж у monobank». Він показує стан платежу, суму, скільки списано й повернено, скільки ще можна повернути, і всі спроби оплати.

    Кнопки — лише ті, що доступні замовленню зараз:

    КнопкаЩо робитьСтатус після
    Повернути коштиПовертає всю суму або частину: поле суми вже заповнене залишком, для часткового повернення впишіть меншуПовне — «Повернуто», часткове — без змін
    Списати холдСписує заблоковану суму або меншу, якщо частини товару немає«Оплачено»
    Зняти холдСкасовує блокування, гроші повертаються покупцю«Повернуто»
    Оновити статусБере стан платежу з monobank, якщо повідомлення не дійшло. Повтор нічого не дублюєза станом платежу

    Перед кожною операцією з грошима програма питає підтвердження; для повернення й зняття холду — з попередженням «Цю операцію не можна скасувати.». Статус замовлення на сайті змінюється так само, як після повідомлення monobank.

    Магазин не відповів — під повідомленням з'явиться «Повторити»: вона повторює ту саму операцію, і гроші вдруге не рухаються. Нове натискання кнопки — це вже нова операція.

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

    Коли через monobank уже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.

    Як перевірити тестовим платежем

    1. Отримайте тестовий токен на api.monobank.ua — вхід через застосунок monobank. Впишіть його в «Токен (X-Token)» і збережіть.
    2. Оформіть на сайті замовлення на себе, оберіть «Оплата карткою через monobank» і оплатіть. З тестовим токеном гроші не списуються.
    3. Перевірте, що на сторінці банку правильна сума, а замовлення прийшло в Elbuz у «Замовлення покупця» з видом оплати «Банківська карта».
    4. Замініть токен бойовим з кабінету 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)

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно