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

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

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

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

    Оплата PayU переводить покупця на захищену сторінку PayU: BLIK, переказ зі свого банку, картка, Apple Pay чи Google Pay. Магазин сам дізнається результат і ставить замовленню статус.

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

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

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

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

    Як підключити PayU

    Потрібен договір вашої фірми з PayU і точка оплати типу REST API в кабінеті PayU. Спільних ключів Elbuz не має: модуль працює лише з вашими.

    1. Візьміть чотири ключі в кабінеті PayU (де саме).
    2. Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка PayU.
    3. У блоці «Підключення» вимкніть «Тестовий режим (sandbox)» і впишіть ключі.
    4. У блоці «Оплата» оберіть «Валюта точки оплати» — ту, в якій працює точка в PayU (чому це важливо).
    5. Увімкніть перемикач «Увімкнено» вгорі екрана.
    6. Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
    Розділ «Оформлення і оплата» у вікні «Налаштування магазину» з карткою PayU
    1Картка PayU
    2Перемикач «Увімкнено»
    1. Картка PayU: клік відкриває екран налаштування.
    2. Перемикач — чи бачать покупці цю оплату; значок біля назви — чи заповнено обов'язкові поля і чи дійшли зміни до магазину.
    Екран налаштування PayU: шапка, блок «Підключення» і права колонка зі списком, що ще не налаштовано
    1Перемикач «Увімкнено»
    2Тестовий режим (sandbox)
    3ID точки оплати (POS ID)
    4Другий ключ (MD5)
    5Що ще не налаштовано
    1. Перемикач «Увімкнено» — показує PayU покупцям після збереження.
    2. Тестовий режим — тестові оплати без списання грошей; вимкніть його перед продажами.
    3. ID точки оплати (POS ID) — номер точки оплати з кабінету PayU.
    4. Другий ключ (MD5) — секретний ключ: після збереження його не видно, лише «задано».
    5. Що ще не налаштовано — чого бракує, щоб оплата запрацювала.

    Без тестового режиму увімкнений модуль без усіх чотирьох ключів не збережеться: під порожнім полем буде «Заповніть — без цього модуль не працюватиме». «Другий ключ (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, а модуль працює з однією.

    Блок «Оплата» в екрані PayU: валюта точки оплати і код BLIK
    1Валюта точки оплати
    2Код BLIK в оформленні замовлення
    3Пункт чек-листа про валюту
    1. Валюта точки в PayU: оплату видно лише покупцям із цінами в цій валюті.
    2. Код BLIK прямо в оформленні, лише для PLN.
    3. Валюти точки немає в магазині — покупці PayU не побачать.

    Для яких адрес і на якому місці

    Блок «Де показувати»:

    • «Географічна зона» — оплата лише для покупців з адресою в цій зоні; «Усі зони» — для всіх.
    • «Порядок сортування» — місце в списку оплат, менше число стоїть вище.

    Обмеження за сумою замовлення в модулі немає: PayU видно за будь-якої суми.

    Код BLIK прямо в магазині

    Покупець вписує 6-значний код BLIK в оформленні замовлення і підтверджує оплату в застосунку банку. На сторінку PayU він не переходить.

    1. Попросіть менеджера PayU ввімкнути для вашої точки «Transparent payment with a BLIK authorization code». Без цього PayU відхилить код.
    2. У блоці «Оплата» увімкніть «Код BLIK в оформленні замовлення». Перемикач видно лише при валюті PLN.
    3. Натисніть «Зберегти».

    Покупець бачить поле «Код BLIK», кнопку «Оплатити BLIK» і посилання «Інший спосіб оплати (сторінка PayU)». Після коду — «Підтвердьте оплату в застосунку банку. Чекаємо відповідь…».

    Магазин чекає підтвердження банку близько двох хвилин. Не дочекався — покупець бачить «Банк поки не підтвердив оплату…» і може ввести новий код. Якщо він уже підтвердив оплату в банку, замовлення стане оплаченим саме.

    Невірний, прострочений чи вже використаний код — покупець бачить, що сталося, і бере новий код у застосунку. Сам код магазин передає лише в PayU і ніде не зберігає.

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

    Тестові оплати йдуть у тестове середовище PayU (sandbox), гроші не списуються. «Тестовий режим (sandbox)» типово увімкнено.

    1. Залиште «Тестовий режим (sandbox)» увімкненим і всі чотири ключі порожніми — модуль візьме публічну тестову точку PayU у валюті PLN. Або впишіть ключі свого тестового кабінету PayU.
    2. «Валюта точки оплати» — PLN. Перевірте, що PLN є в магазині (вище).
    3. Увімкніть модуль і збережіть.
    4. Відкрийте сайт у PLN, оформіть замовлення на себе й оберіть «Оплата через PayU». Над переходом буде «Тестовий режим (sandbox PayU): гроші не списуються.»
    5. Оплатіть тестовою карткою або кодом BLIK з документації PayU. Код 777123 — успішна оплата.
    6. Перевірте, що замовлення прийшло в Elbuz зі статусом з поля «Оплачено».

    У тестовому режимі можна вписати або всі чотири ключі, або жодного. Вписано частину — під порожніми полями буде «Потрібні всі чотири ключі — або залиште порожніми всі (тестова точка PayU)».

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

    Що бачить покупець

    В оформленні замовлення спосіб називається «Оплата через PayU» з підказкою «BLIK, онлайн-переказ з вашого банку, картка, Apple Pay, Google Pay…». Після підтвердження — «Переходимо на сторінку оплати PayU…» і сторінка PayU.

    Що сталосяКуди повертається покупець
    ОплативСторінка успішного замовлення
    BLIK чи переказ ще в дорозіТеж сторінка успішного замовлення. Замовлення стане оплаченим, щойно PayU повідомить магазин — зазвичай за хвилину-дві
    Не оплатив і повернувся в магазинОформлення з «Оплату не завершено. Спробуйте ще раз або оберіть інший спосіб оплати.» Кошик зберігається

    Які способи видно на сторінці PayU, вирішує ваш договір з PayU. Сторінка відкривається основною мовою магазину, а не мовою, яку обрав покупець.

    Кожна спроба оплати — окремий платіж у PayU, а замовлення в магазині те саме. Нова спроба скасовує в PayU попередню неоплачену. Якщо стару спробу все ж оплатили на іншу суму, статус не зміниться (нижче).

    Статуси замовлення

    Статус ставить магазин сам, коли PayU повідомляє про оплату. Які саме — обираєте в блоці «Статуси замовлення».

    Блок «Статуси замовлення» в налаштуваннях PayU: чотири поля статусів
    1Оплачено
    2Чекає підтвердження
    3Повернуто
    4Скасовано
    1. Оплачено — статус, який ставиться, коли PayU підтвердив оплату.
    2. Чекає підтвердження — гроші заблоковано на картці покупця, списуються після підтвердження через службу підтримки Elbuz.
    3. Повернуто — статус після повного повернення коштів.
    4. Скасовано — коли оплату, що чекала підтвердження, скасовано: на ваше прохання або 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, чотири ключі, валюта точки в «Валютах»

    Суміжні теми

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

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

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

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

    Зміст статті

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

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