Оплата LiqPay працює прямо на оформленні: покупець платить карткою, Apple Pay чи Google Pay, а замовлення саме стає оплаченим. Достатньо вписати два ключі з кабінету LiqPay у налаштуваннях магазину в Elbuz.
Коли це знадобиться:
- Потрібна оплата карткою на сайті — гроші йдуть на ваш рахунок, статус змінюється сам.
- Товар везе постачальник — холд блокує гроші, списання — коли ви підтвердите замовлення.
- Дорогу техніку замовляють і не викуповують — передоплата бере онлайн лише частину суми.
- Потрібен фіскальний чек — його видає програмна каса LiqPay (ПРРО) і надсилає покупцю на email.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → LiqPay → ключі й перемикач «Увімкнено».
Що вміє оплата LiqPay
- Приймати оплату на сторінці оформлення — картка, Apple Pay, Google Pay, Приват24, гаманець LiqPay, QR-код.
- Холд — гроші блокуються на картці, списуються після вашого підтвердження.
- Ставити статус замовлення сам — оплачено, холд, підтверджено, повернено, скасовано.
- Брати передоплату — відсоток чи фіксовану суму, решта при отриманні.
- Приймати гроші на другий рахунок — окремий спосіб оплати з іншими ключами.
- Видавати фіскальний чек через касу LiqPay.
Як підключити LiqPay
Потрібен договір з LiqPay як ФОП або компанія і створений у кабінеті LiqPay магазин. Поки LiqPay не активував магазин, проходять лише тестові платежі.
- Візьміть ключі. У кабінеті LiqPay для бізнесу (liqpay.ua) відкрийте налаштування свого магазину: там публічний і приватний ключі. Приватний — секретний, нікому його не пересилайте.
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка LiqPay.
- Впишіть ключі у блок «Підключення»: «Публічний ключ» і «Приватний ключ».
- Увімкніть перемикач «Увімкнено» вгорі екрана.
- Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
1
Рядок LiqPay2
Стан модуля- Рядок LiqPay — відкриває екран налаштування LiqPay.
- Позначка стану показує, чи бачать покупці цю оплату і чи дійшли останні зміни до магазину.
1
Перемикач «Увімкнено»2
Публічний ключ3
Приватний ключ4
Що ще не налаштовано5
Стан модуля- Перемикач показує LiqPay покупцям після збереження.
- Відкритий ключ з кабінету LiqPay.
- Секретний ключ: після збереження його не видно, лише позначку, що задано.
- Чого бракує, щоб оплата працювала.
- Стан модуля в магазині.
Валюта платежу має бути серед валют магазину, а для замовлень у злотих чи фунтах — гривня. Інакше LiqPay на оформленні не показується.
Без ключів увімкнений модуль не збережеться: під полем буде «Заповніть — без цього модуль не працюватиме». Приватний ключ після збереження не показується — у полі видно лише, що ключ задано. Щоб змінити ключ, впишіть новий.
У кабінеті LiqPay нічого вписувати не треба: адресу для повідомлень про оплату модуль передає з кожним платежем сам.
Що ще не налаштовано, видно праворуч, у картці «Що ще не налаштовано». Як влаштоване вікно загалом — у статті «Налаштування магазину».
Що бачить покупець і для яких замовлень
Покупець обирає LiqPay серед способів оплати, підтверджує замовлення і натискає «Оплатити». Після оплати — коротка сторінка «Перевірка статусу оплати...», потім звичайна сторінка успішного замовлення.
Оплата не пройшла — покупець бачить «Помилка оплати» з кнопкою «Продовжити»: можна спробувати ще раз або обрати інший спосіб.
Вигляд оплати задає блок «Як платить покупець»:
| Поле | Що робить | Типово |
|---|---|---|
| Назва способу оплати | Назва в списку оплат, окремо для кожної мови | «LiqPay (картка, Apple Pay, Google Pay)» |
| Чим можна заплатити | Банківська картка, LiqPay гаманець, Приват24, Apple Pay, Google Pay, QR-код | нічого не позначено — усе, що LiqPay дає вашому магазину |
| Де відкривати оплату | «Сторінка LiqPay» — покупець переходить на сайт LiqPay і повертається; «Віджет на сайті» — форма оплати на вашій сторінці | Сторінка LiqPay |
| Вигляд віджета | Лише для віджета: «Звичайний», «Вбудований у сторінку» або «Спливаюче вікно» | Звичайний |
| Валюта платежу | «Як у замовленні» або гривні, долари чи євро. Замовлення в іншій валюті (злоті, фунти) оплачується в гривнях за курсом магазину | Як у замовленні |
| Мова сторінки оплати | «Як мова сайту» — англійська для англійської версії сайту, для решти — українська; або «Українська» чи «Англійська» | Як мова сайту |
Для яких замовлень показувати
Блок «Де показувати» обмежує, кому LiqPay видно:
- «Мінімальна сума замовлення» і «Максимальна сума замовлення» — межі суми,
0— без обмеження. Максимальна менша за мінімальну — екран не дасть зберегти. - «Географічна зона» — оплата лише для покупців з адресою в цій зоні; «Усі зони» — для всіх.
- «Місце в списку оплат» — менше число стоїть вище.
Холд і статуси замовлення
Списати одразу чи заблокувати
Це поле «Коли списувати гроші» в блоці «Як платить покупець».
| Коли списувати гроші | Що з грошима | Кому підходить |
|---|---|---|
| Одразу | Списуються одразу | Товар на складі, відправка одразу |
| Після вашого підтвердження (холд) | Блокуються на картці; списуються, коли ви підтвердите платіж | Товар везе постачальник, наявність треба перевірити |
Для холду в блоці «Статуси замовлення» з'являються «Гроші заблоковано (холд)» і «Холд підтверджено». Типово там «Оброблено» і «В обробці».
У магазинах, налаштованих раніше, може стояти «Не змінювати» — тоді праворуч буде «Не задано статуси «Холд» і «Підтверджено» — після холду замовлення залишиться без статусу». Оберіть статуси (нижче).
Якщо «Гроші заблоковано (холд)» збігається з «Оплачено», праворуч з'явиться «Статуси «Оплачено» і «Холд» однакові — холд не відрізнити від оплати».
Холд живе обмежений час: потім банк сам знімає блокування, і гроші повертаються покупцю. Точний термін — в умовах LiqPay. Підтверджуйте холд, щойно товар є.
Які статуси ставляться
Статус ставить магазин сам, коли LiqPay повідомляє про подію. Які саме — обираєте в блоці «Статуси замовлення». Типово «Очікує оплати» — це «Очікує», «Оплачено» — «В обробці», «Оплата не пройшла» — «Скасовано».
1
Оплачено2
Оплата не пройшла3
Гроші заблоковано (холд)4
Гроші повернено- Ставиться, коли платіж пройшов, і для тестових платежів.
- Оплата не підтвердилась, замовлення скасовується.
- Гроші заблоковано й чекають підтвердження.
- Гроші повернено покупцю.
| Поле | Коли ставиться |
|---|---|
| Очікує оплати | Передоплату внесено, решта — при отриманні. Таке замовлення модуль вважає ще не оплаченим |
| Оплачено | Покупець заплатив повну суму. Тестовий платіж теж |
| Оплата не пройшла | Покупець повернувся з оплати, а LiqPay так і не підтвердив платіж (модуль чекає близько 20 секунд) |
| Гроші заблоковано (холд) | Гроші заблоковано й чекають вашого підтвердження. Той самий статус — коли банк чекає від покупця код підтвердження |
| Холд підтверджено | Ви підтвердили холд, гроші списано |
| Гроші повернено | Гроші повернено покупцю |
Поля холду видно, лише коли «Коли списувати гроші» — «Після вашого підтвердження (холд)». Для них і для «Гроші повернено» можна обрати «Не змінювати»: тоді замовлення лишається як було. «Холд підтверджено» і «Гроші повернено» ставляться, коли LiqPay повідомить магазин про операцію.
Поки LiqPay не підтвердив оплату, замовлення лишається непідтвердженим і не вважається новим. Статус оплати ставиться, лише якщо сума й валюта платежу дорівнюють теперішній сумі замовлення.
Передоплата і другий рахунок
Це два окремі способи оплати поруч зі звичайним LiqPay: «LiqPay — передоплата» і «LiqPay — додатковий». Обидва працюють лише при налаштованому основному LiqPay.
Їхні екрани з'являються в розділі «Оформлення і оплата», коли спосіб установлено в магазині. Немає екрана — спосіб підключає служба підтримки Elbuz.
Передоплата частини суми
Покупець платить онлайн частину, решту — при отриманні. Над кнопкою оплати він бачить, наприклад, «Передоплата 10%: 1500 UAH» і «Залишок до сплати: 13500 UAH».
- «Як рахувати передоплату» — «Відсоток від замовлення» або «Фіксована сума». «Розмір передоплати» — відсоток (від 0,01 до 100) або сума в основній валюті магазину.
- «Мінімальна передоплата» і «Максимальна передоплата» — межі передоплати. 10 % від 500 ₴ — це 50 ₴, а з мінімальною передоплатою 200 покупець заплатить 200 ₴. Більше за суму замовлення передоплата не буває. Межі — теж в основній валюті магазину; якщо покупець платить в іншій, модуль перерахує за курсом магазину.
- «Мінімальна сума замовлення» і «Максимальна сума замовлення» — для яких замовлень показувати спосіб.
0— для всіх.
Після оплати передоплати замовлення отримує статус з поля «Очікує оплати» основного модуля. Ключі, валюта й статуси теж беруться з основного LiqPay. Чек передоплата не формує.
У кабінеті LiqPay платіж іде під номером замовлення з _prepay: замовлення 123 — платіж 123_prepay.
Другий рахунок: «LiqPay — додатковий»
Ще один спосіб оплати LiqPay зі своїми «Публічний ключ» і «Приватний ключ». Гроші за такі замовлення йдуть на інший магазин у LiqPay — наприклад, другого ФОПа чи партнера.
Окремо задаються лише ключі, назва (для кожної мови, порожньо — «LiqPay (Додатковий)»), «Географічна зона» і місце в списку оплат. Валюту, мову, методи, тип платежу, статуси, фіскалізацію і межі суми він бере з основного.
Фіскальний чек через програмну касу LiqPay
Якщо в LiqPay підключено програмну касу (ПРРО), магазин передає склад замовлення разом з оплатою. LiqPay видає фіскальний чек і надсилає його покупцю на email із замовлення.
- Підключіть касу в кабінеті LiqPay і заведіть у ній усі товари, які продаєте. Кожен отримає свій ID LiqPay (число).
- Якщо доставка платна, заведіть у касі й доставку як товар: кабінет LiqPay → РРО → Каса → Товари.
- У блоці «Фіскальні чеки» увімкніть «Видавати фіскальні чеки». Під ним з'явиться поле «ID доставки в касі LiqPay» — впишіть у нього ID доставки і натисніть «Зберегти».
- Надішліть службі підтримки Elbuz список «товар (назва або артикул) — ID LiqPay». Вона зв'яже товари магазину з касою. Може й вивантажити вам список товарів, щоб ви лише дописали ID.
1
Перемикач фіскальних чеків2
ID доставки в касі LiqPay- Вмикає фіскальні чеки через програмну касу LiqPay; після ввімкнення з'являється поле для ID доставки.
- ID доставки, заведеної в касі LiqPay як товар; 0 — платна доставка не потрапить у чек.
Чек видається, лише якщо в таблиці є всі товари замовлення. Бракує одного — оплата пройде, а чека не буде. Новий товар одразу заводьте в касі LiqPay і передавайте його ID підтримці.
Сума чека дорівнює сумі оплати. Доставка йде окремим рядком, а знижки — купон, бонуси, подарунковий сертифікат — розносяться по товарах до копійки.
Чек буде лише на товари, без доставки й знижок, у двох випадках:
- доставка платна, а «ID доставки в касі LiqPay» —
0; - у замовленні є інші суми, наприклад податок чи націнка за спосіб оплати.
Для першого випадку праворуч на екрані з'явиться «Фіскальні чеки ввімкнено, а «ID доставки в касі LiqPay» не задано — платна доставка не потрапить у чек».
Каса в самому Elbuz (Вчасно.Каса, Checkbox) видає чеки на оплату за посиланням і вручну: Каси ПРРО в Elbuz.
Повернення, підтвердження холду, доплата
Підтвердити холд, повернути всю суму чи частину, подивитися дані платежу — через службу підтримки Elbuz: напишіть номер замовлення і що зробити. Повернення холду — це зняття блокування. Коли LiqPay повідомить магазин про операцію, замовлення отримає статус з поля «Холд підтверджено» чи «Гроші повернено».
Доплатити решту після передоплати або оплатити замовлення, прийняте телефоном, покупець може за посиланням. Його створюють у картці замовлення в Elbuz кнопкою «Посилання на оплату» — на неоплачену суму. Детальніше: Оплата за посиланням.
Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz. Вид оплати — «Банківська карта» для основного LiqPay і «Оплата LiqPay» для передоплати й додаткового. Коли через основний LiqPay уже були замовлення, шапка екрана показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.
Як перевірити тестовим платежем
- Візьміть у кабінеті LiqPay тестові ключі — вони починаються з
sandbox_. Впишіть їх у блок «Підключення» і збережіть. - Оформіть на сайті замовлення на себе, оберіть LiqPay і оплатіть тестовою карткою з документації LiqPay. Гроші не списуються.
- Перевірте, що замовлення отримало статус з поля «Оплачено» і прийшло в Elbuz.
- Замініть ключі бойовими і збережіть.
Тестовий платіж теж ставить статус оплаченого. Перед запуском переконайтеся в кабінеті LiqPay, що магазин активний і в модулі стоять бойові ключі.
Сценарії
Електроніка: списувати лише після перевірки наявності
«Коли списувати гроші» — «Після вашого підтвердження (холд)». Статуси холду лишіть типові або оберіть свої, аби «Гроші заблоковано (холд)» не збігався з «Оплачено».
Товар на складі — підтвердіть холд через підтримку. Товару немає — холд знімають поверненням, і гроші розблоковуються.
Побутова техніка: дрібне — повністю, велике — передоплата
В основному LiqPay «Максимальна сума замовлення» — 15000. У «LiqPay — передоплата» «Мінімальна сума замовлення» — 15000, «Як рахувати передоплату» — «Фіксована сума», «Розмір передоплати» — 500. Чайник покупець оплачує повністю, за холодильник — 500 ₴ наперед, решту при доставці.
Кава з телефона: оплата в один дотик
«Чим можна заплатити» — Apple Pay, Google Pay і Банківська картка. «Де відкривати оплату» — «Віджет на сайті», «Вигляд віджета» — «Вбудований у сторінку». Форма оплати відкривається на вашій сторінці, без переходу на інший сайт.
Товари й послуги на різних ФОПах
Основний LiqPay — ключі першого ФОПа, назва «Карткою: товари». «LiqPay — додатковий» — ключі другого, назва «Карткою: послуги». Покупець обирає сам, гроші надходять на потрібний рахунок.
Що робити, коли оплата не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець не бачить LiqPay при оформленні | Модуль вимкнено, не задано ключі, сума поза межами, адреса не в зоні або валюти платежу немає серед валют магазину | Перевірте «Увімкнено», ключі, «Мінімальна сума замовлення», «Максимальна сума замовлення», «Географічна зона» і «Валюта платежу», потім «Зберегти» |
| Оплата пройшла, а статус не змінився | Ключі в модулі не збігаються з кабінетом LiqPay або статуси не обрано | Вставте ключі ще раз, перевірте блок «Статуси замовлення». Не допомогло — підтримка Elbuz подивиться журнал запитів |
| У кабінеті LiqPay платіж успішний, а замовлення в Elbuz без статусу оплати | Сума чи валюта платежу не дорівнює сумі замовлення: покупець оплатив стару форму, а потім змінив кошик, або оплатив іншим способом | Порівняйте суму платежу в кабінеті LiqPay із сумою замовлення і вирішіть: доплата, повернення або зміна замовлення. Не зрозуміло — служба підтримки Elbuz подивиться журнал запитів |
| Оплата пройшла, а чека немає | Одного з товарів немає в таблиці каси або ID LiqPay не збігається | Напишіть підтримці Elbuz номер замовлення: вона перевірить таблицю і журнал |
| «Магазин не прийняв налаштування» або «Магазин не прийняв частину значень — див. позначені поля» | Магазин не відповів або відхилив окремі поля | Виправте позначені поля і збережіть. Якщо полів не позначено, зміни підуть із наступним вивантаженням |
Часті запитання
Чи може покупець обрати між повною оплатою і передоплатою?
Так, якщо увімкнено обидва способи і сума замовлення підходить під межі обох.
Що буде, якщо вимкнути модуль?
LiqPay зникне з оформлення замовлення. Ключі й налаштування зберігаються: увімкнете знову — усе на місці.
Чому неоплаченого замовлення немає в списку?
Поки LiqPay не підтвердив оплату, замовлення непідтверджене. Якщо покупець повернувся, не заплативши, воно отримує статус з поля «Оплата не пройшла».
Чи працює оплата, якщо сайт закритий паролем?
Повідомлення LiqPay до такого сайту не дійдуть. Модуль перевірить оплату сам, коли покупець повернеться з LiqPay, але надійніше, коли сайт відкритий.
У списку «Географічна зона» немає потрібної зони — що робити?
Зону, наприклад «Україна», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → LiqPay
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»
- Підготувати
- договір з LiqPay, магазин у кабінеті LiqPay, публічний і приватний ключі
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо покупець хоче доплатити решту або замовив телефоном — Оплата за посиланням.
- Якщо чеки видаєте касою в Elbuz — Каси ПРРО в Elbuz.
