Оплата PayU переводить покупця на захищену сторінку PayU: BLIK, переказ зі свого банку, картка, Apple Pay чи Google Pay. Магазин сам дізнається результат і ставить замовленню статус.
Коли це знадобиться:
- Ви продаєте в Польщу — покупці платять BLIK і переказом зі свого банку, як звикли.
- Покупець не хоче йти з сайту — код BLIK вписується прямо в оформленні замовлення.
- Товар треба спершу перевірити — гроші чекають вашого підтвердження і лише потім списуються.
- Треба повернути частину грошей — PayU повертає частину, статус лишається оплаченим.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → PayU → чотири ключі й перемикач «Увімкнено».
Що вміє оплата PayU
- Приймати оплату на сторінці PayU — BLIK, переказ банку, картка, Apple Pay, Google Pay.
- Приймати код BLIK в оформленні — без переходу на сторінку PayU.
- Перевіряти в тестовому режимі — гроші не списуються, ключі можна не вписувати.
- Ставити статус замовлення сам — оплачено, чекає підтвердження, повернуто, скасовано.
- Списувати гроші після вашого підтвердження і повертати всю суму чи частину — кнопками в картці замовлення.
Як підключити PayU
Потрібен договір вашої фірми з PayU і точка оплати типу REST API в кабінеті PayU. Спільних ключів Elbuz не має: модуль працює лише з вашими.
- Візьміть чотири ключі в кабінеті PayU (де саме).
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка PayU.
- У блоці «Підключення» вимкніть «Тестовий режим (sandbox)» і впишіть ключі.
- У блоці «Оплата» оберіть «Валюта точки оплати» — ту, в якій працює точка в PayU (чому це важливо).
- Увімкніть перемикач «Увімкнено» вгорі екрана.
- Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
1
Картка PayU2
Перемикач «Увімкнено»- Картка PayU: клік відкриває екран налаштування.
- Перемикач — чи бачать покупці цю оплату; значок біля назви — чи заповнено обов'язкові поля і чи дійшли зміни до магазину.
1
Перемикач «Увімкнено»2
Тестовий режим (sandbox)3
ID точки оплати (POS ID)4
Другий ключ (MD5)5
Що ще не налаштовано- Перемикач «Увімкнено» — показує PayU покупцям після збереження.
- Тестовий режим — тестові оплати без списання грошей; вимкніть його перед продажами.
- ID точки оплати (POS ID) — номер точки оплати з кабінету PayU.
- Другий ключ (MD5) — секретний ключ: після збереження його не видно, лише «задано».
- Що ще не налаштовано — чого бракує, щоб оплата запрацювала.
Без тестового режиму увімкнений модуль без усіх чотирьох ключів не збережеться: під порожнім полем буде «Заповніть — без цього модуль не працюватиме». «Другий ключ (MD5)» і «Секрет клієнта OAuth (client_secret)» після збереження не показуються — видно лише «задано». Щоб змінити, натисніть «Замінити».
У кабінеті PayU адресу для повідомлень про оплату вписувати не треба: модуль передає її з кожною оплатою. На екрані вона показана довідково — «Адреса сповіщень». Якщо сайт захищено Cloudflare чи паролем, ця адреса має лишатися відкритою.
Як влаштоване вікно загалом — у статті «Налаштування магазину».
Де взяти ключі в кабінеті PayU
Кабінет PayU (panel.payu.pl) польською. Шлях: «Płatności elektroniczne» → «Moje sklepy» → ваш магазин → «Punkty płatności» → точка «REST API (Checkout)» → «Klucze konfiguracji». Немає такої точки — створіть: «Dodaj punkt płatności».
| Поле в Elbuz | Що скопіювати в кабінеті PayU |
|---|---|
| ID точки оплати (POS ID) | Id punktu płatności (pos_id) |
| Другий ключ (MD5) | Drugi klucz (MD5) — ним магазин перевіряє підпис кожного повідомлення PayU |
| Ідентифікатор клієнта OAuth (client_id) | Protokół OAuth — client_id, зазвичай те саме число, що й POS ID |
| Секрет клієнта OAuth (client_secret) | Protokół OAuth — client_secret |
Копіюйте кнопкою в кабінеті, без пробілів на початку й у кінці.
Валюта точки оплати: кому PayU видно
Точка оплати PayU працює в одній валюті, найчастіше PLN. Суми модуль не перераховує. Тому PayU з'являється в оформленні, лише коли покупець бачить ціни у валюті точки.
- «Валюта точки оплати» — PLN, EUR, USD, GBP, CZK, HUF, RON, BGN, CHF, DKK, NOK або SEK. Типово PLN.
- Покупець має бачити ціни в цій валюті. У вікні «Валюти» в Elbuz у рядку PLN потрібна «Активність». Якщо PLN не основна валюта Elbuz, потрібні ще «Відображати на сайті» і курс: Курси валют.
- Немає валюти в магазині — праворуч буде «Валюти PLN немає в магазині — покупці не побачать цей спосіб оплати».
Точка в PLN, а покупець перемкнув сайт на EUR, — PayU він не побачить. Для двох валют потрібні дві точки в PayU, а модуль працює з однією.
1
Валюта точки оплати2
Код BLIK в оформленні замовлення3
Пункт чек-листа про валюту- Валюта точки в PayU: оплату видно лише покупцям із цінами в цій валюті.
- Код BLIK прямо в оформленні, лише для PLN.
- Валюти точки немає в магазині — покупці PayU не побачать.
Для яких адрес і на якому місці
Блок «Де показувати»:
- «Географічна зона» — оплата лише для покупців з адресою в цій зоні; «Усі зони» — для всіх.
- «Порядок сортування» — місце в списку оплат, менше число стоїть вище.
Обмеження за сумою замовлення в модулі немає: PayU видно за будь-якої суми.
Код BLIK прямо в магазині
Покупець вписує 6-значний код BLIK в оформленні замовлення і підтверджує оплату в застосунку банку. На сторінку PayU він не переходить.
- Попросіть менеджера PayU ввімкнути для вашої точки «Transparent payment with a BLIK authorization code». Без цього PayU відхилить код.
- У блоці «Оплата» увімкніть «Код BLIK в оформленні замовлення». Перемикач видно лише при валюті PLN.
- Натисніть «Зберегти».
Покупець бачить поле «Код BLIK», кнопку «Оплатити BLIK» і посилання «Інший спосіб оплати (сторінка PayU)». Після коду — «Підтвердьте оплату в застосунку банку. Чекаємо відповідь…».
Магазин чекає підтвердження банку близько двох хвилин. Не дочекався — покупець бачить «Банк поки не підтвердив оплату…» і може ввести новий код. Якщо він уже підтвердив оплату в банку, замовлення стане оплаченим саме.
Невірний, прострочений чи вже використаний код — покупець бачить, що сталося, і бере новий код у застосунку. Сам код магазин передає лише в PayU і ніде не зберігає.
Як перевірити в тестовому режимі
Тестові оплати йдуть у тестове середовище PayU (sandbox), гроші не списуються. «Тестовий режим (sandbox)» типово увімкнено.
- Залиште «Тестовий режим (sandbox)» увімкненим і всі чотири ключі порожніми — модуль візьме публічну тестову точку PayU у валюті PLN. Або впишіть ключі свого тестового кабінету PayU.
- «Валюта точки оплати» — PLN. Перевірте, що PLN є в магазині (вище).
- Увімкніть модуль і збережіть.
- Відкрийте сайт у PLN, оформіть замовлення на себе й оберіть «Оплата через PayU». Над переходом буде «Тестовий режим (sandbox PayU): гроші не списуються.»
- Оплатіть тестовою карткою або кодом BLIK з документації PayU. Код
777123— успішна оплата. - Перевірте, що замовлення прийшло в Elbuz зі статусом з поля «Оплачено».
У тестовому режимі можна вписати або всі чотири ключі, або жодного. Вписано частину — під порожніми полями буде «Потрібні всі чотири ключі — або залиште порожніми всі (тестова точка PayU)».
Перед продажами вимкніть «Тестовий режим (sandbox)» і впишіть бойові ключі: публічні тестові ключі знає будь-хто. Поки режим увімкнено, праворуч висить «Увімкнено тестовий режим — гроші не списуються. Вимкніть перед продажами».
Що бачить покупець
В оформленні замовлення спосіб називається «Оплата через PayU» з підказкою «BLIK, онлайн-переказ з вашого банку, картка, Apple Pay, Google Pay…». Після підтвердження — «Переходимо на сторінку оплати PayU…» і сторінка PayU.
| Що сталося | Куди повертається покупець |
|---|---|
| Оплатив | Сторінка успішного замовлення |
| BLIK чи переказ ще в дорозі | Теж сторінка успішного замовлення. Замовлення стане оплаченим, щойно PayU повідомить магазин — зазвичай за хвилину-дві |
| Не оплатив і повернувся в магазин | Оформлення з «Оплату не завершено. Спробуйте ще раз або оберіть інший спосіб оплати.» Кошик зберігається |
Які способи видно на сторінці PayU, вирішує ваш договір з PayU. Сторінка відкривається основною мовою магазину, а не мовою, яку обрав покупець.
Кожна спроба оплати — окремий платіж у PayU, а замовлення в магазині те саме. Нова спроба скасовує в PayU попередню неоплачену. Якщо стару спробу все ж оплатили на іншу суму, статус не зміниться (нижче).
Статуси замовлення
Статус ставить магазин сам, коли PayU повідомляє про оплату. Які саме — обираєте в блоці «Статуси замовлення».
1
Оплачено2
Чекає підтвердження3
Повернуто4
Скасовано- Оплачено — статус, який ставиться, коли PayU підтвердив оплату.
- Чекає підтвердження — гроші заблоковано на картці покупця, списуються після підтвердження через службу підтримки Elbuz.
- Повернуто — статус після повного повернення коштів.
- Скасовано — коли оплату, що чекала підтвердження, скасовано: на ваше прохання або PayU сам через кілька днів.
| Поле | Коли ставиться | Типово |
|---|---|---|
| Оплачено | PayU підтвердив оплату. Покупцю йде звичайний лист про замовлення | «В обробці» |
| Чекає підтвердження | У точці PayU вимкнено автоматичне прийняття платежів: гроші заблоковано й списуються після підтвердження. Лист покупцю не йде | «Очікує» |
| Повернуто | Покупцю повернули всю суму | «Кошти повернено» |
| Скасовано | Оплату, що чекала підтвердження, скасовано: гроші повертаються покупцю | «Скасовано» |
Поки покупець не заплатив, замовлення лишається непідтвердженим і не вважається новим. Повторна спроба оплати не створює зайвого замовлення.
Коли статус не змінюється
- Сума не та. Покупець змінив кошик після переходу на оплату і сплатив стару суму. У кабінеті PayU оплата є, а замовлення в Elbuz лишається з колишнім статусом. Звірте суму й за потреби поверніть оплату (як).
- Підроблене повідомлення. Магазин перевіряє підпис другим ключем, а потім сам перепитує PayU: точку, номер спроби, суму й валюту. Чуже повідомлення замовлення не змінить.
- PayU не відповів на перевірку. Магазин нічого не змінює, а PayU повторює повідомлення пізніше.
Підтвердження, скасування і повернення в картці замовлення
Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «Банківська карта». У його картці є блок «Платіж у PayU»: стан платежу, сума, списано, повернено й скільки ще можна повернути. Нижче — усі спроби оплати.
Кнопки — лише ті, що доступні замовленню зараз:
| Кнопка | Коли є | Що робить |
|---|---|---|
| Повернути кошти | Оплату завершено, і ще є що повертати | Повертає всю суму або частину, кілька разів. Поле суми вже заповнене залишком: щоб повернути все, лишіть запропоновану суму |
| Списати холд | Оплата чекає підтвердження | Списує гроші, статус з поля «Оплачено». Лише всю суму: частину PayU не списує |
| Зняти холд | Оплата чекає підтвердження | Скасовує платіж, гроші повертаються покупцю. Статус з поля «Скасовано» |
| Оновити статус | Завжди | Бере стан платежу з PayU, якщо повідомлення не дійшло |
Перед кожною операцією з грошима програма питає підтвердження; для повернення й зняття холду — з попередженням «Цю операцію не можна скасувати.». Статус замовлення змінюється так само, як після повідомлення PayU.
PayU проводить повернення кілька хвилин: «Повернуто» в блоці зміниться, коли воно завершиться. Після повного повернення — статус з поля «Повернуто», після часткового статус той самий. Покупцю лист про повернення не йде.
Магазин не відповів — з'явиться «Невідомо, чи пройшла операція. Натисніть «Повторити» — гроші вдруге не рухнуться». «Повторити» повторює ту саму операцію, а нове натискання кнопки — це вже нова операція.
Повертати гроші й керувати холдом може лише користувач із правом «Операції оплати: повернення, холд, кредит» — типово власник. «Оновити статус» доступне всім, хто бачить замовлення.
Не списали холд — PayU сам скасує платіж через кілька днів, строк залежить від способу оплати, і гроші повернуться покупцю. Стежте за замовленнями зі статусом з поля «Чекає підтвердження».
Повернення можна зробити й у кабінеті PayU — дія «Refund» у списку транзакцій.
Коли через PayU вже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.
Сценарії
Побутова техніка: холодильник дорожчий за ліміт картки
Попросіть PayU відкрити у вашій точці BLIK і швидкі перекази. Покупець холодильника за 6 000 zł платить переказом зі свого банку, ліміт картки не заважає. Замовлення стає оплаченим саме.
Електроніка: списувати лише після перевірки наявності
У кабінеті PayU вимкніть для точки автоматичне прийняття платежів (польською «autoodbiór»). У «Чекає підтвердження» оберіть статус, за яким склад перевіряє наявність.
Товар є — натисніть «Списати холд» у картці замовлення; немає — «Зняти холд», і гроші повернуться покупцю. Зволікати не варто: за кілька днів PayU скасує непідтверджену оплату сам.
Одяг: замовили три розміри, лишили один
Покупець повертає дві куртки з трьох. У картці замовлення натисніть «Повернути кошти» і впишіть суму двох курток, наприклад 598.00. PayU поверне частину, статус лишиться оплаченим, а повернену суму видно в блоці «Платіж у PayU».
Кава: продаж у єврозону
Попросіть PayU відкрити точку в EUR і впишіть її ключі. «Валюта точки оплати» — EUR, у вікні «Валюти» увімкніть EUR для сайту. Покупці з цінами в євро платять без перерахунку, а сума в PayU точно дорівнює сумі замовлення.
Косметика з телефона: оплата без переходу на інший сайт
Точка в PLN, PayU увімкнув BLIK кодом. Увімкніть «Код BLIK в оформленні замовлення». Покупець вписує код з банківського застосунку, підтверджує оплату — і одразу бачить успішне замовлення.
Що робити, коли оплата не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець не бачить PayU при оформленні | Модуль вимкнено, немає ключів (і тестовий режим вимкнено), покупець бачить ціни в іншій валюті або адреса не в гео-зоні | Перевірте «Увімкнено», ключі, «Валюта точки оплати» і «Географічна зона», потім «Зберегти» |
| Покупець бачить «Не вдалося відкрити сторінку оплати» | Помилка в ключах або точка PayU працює в іншій валюті | Вставте ключі з кабінету ще раз, звірте валюту точки. Не допомогло — підтримка Elbuz увімкне журнал запитів і подивиться відповідь PayU |
| Код BLIK щоразу відхиляється | PayU не ввімкнув для точки оплату кодом BLIK | Попросіть менеджера PayU ввімкнути «Transparent payment with a BLIK authorization code» |
| Оплата пройшла, а статус не змінився | Повідомлення PayU не доходять: сайт без HTTPS або адресу сповіщень закрито захистом чи паролем | Натисніть «Оновити статус» у картці замовлення. Потім відкрийте «Адреса сповіщень» з блоку «Підключення» |
| Повне повернення прийнято, а статус замовлення не змінився | PayU ще виконує повернення | Зачекайте кілька хвилин: статус зміниться, щойно PayU завершить повернення |
| «Магазин не прийняв налаштування» або «Магазин не прийняв частину значень — див. позначені поля» | Магазин не відповів або відхилив окремі поля | Виправте позначені поля і збережіть. Якщо полів не позначено, зміни підуть із наступним вивантаженням |
Часті запитання
Чи можна підключити PayU магазину з України?
Модуль працює з будь-якою точкою оплати PayU. Чи укладе PayU договір з вашою фірмою і які способи відкриє, вирішує PayU.
Що буде, якщо вимкнути модуль?
PayU зникне з оформлення замовлення. Ключі й налаштування зберігаються: увімкнете знову — усе на місці.
Чи можна надіслати покупцю посилання на оплату PayU з Elbuz?
Ні. Посилання на оплату з картки замовлення працює з іншими сервісами: Оплата за посиланням.
Як підтвердити оплату, що чекає підтвердження?
У картці замовлення в Elbuz натисніть «Списати холд» у блоці «Платіж у PayU». Списується лише вся сума: частину PayU не списує.
У списку «Географічна зона» немає потрібної зони — що робити?
Зону, наприклад «Польща», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».
Як змінити назву «Оплата через PayU» в оформленні?
На екрані модуля назви немає. Її змінює служба підтримки Elbuz.
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → PayU
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»
- Підготувати
- договір з PayU, точка REST API, чотири ключі, валюта точки в «Валютах»
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо валюти точки немає в магазині — Курси валют.
- Якщо продаєте і в країни Балтії — Як приймати оплату Paysera в магазині.
- Якщо треба обробити оплачене замовлення в Elbuz — Замовлення покупця.
