Оплата Paysera переводить покупця на захищену сторінку Paysera: картка, свій банк, Apple Pay, Google Pay чи гаманець Paysera. Магазин сам дізнається результат і ставить замовленню статус.
Коли це знадобиться:
- Ви продаєте в Литву, Латвію, Естонію чи інші країни ЄС — покупець платить через банк своєї країни.
- Покупець платить банківським переказом — у Checkout Classic замовлення чекає грошей в «Очікує оплати» і стає оплаченим саме.
- Покупець змінив кошик після переходу на оплату — оплата іншої суми не стане «Оплачено».
- Треба повернути частину грошей — у Checkout Modern це кнопка в картці замовлення Elbuz.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → Paysera → версія API, ключі й перемикач «Увімкнено».
Що вміє оплата Paysera
- Приймати оплату на сторінці Paysera — картка, банк покупця, Apple Pay, Google Pay, гаманець Paysera.
- Працювати через Checkout Classic або Modern — перемикач версії і ключі саме для неї.
- Перевіряти тестовою оплатою — гроші не списуються.
- Ставити статус замовлення сам — оплачено, гроші в дорозі, повернуто.
- Повертати всю суму чи частину — у Checkout Modern, кнопкою в картці замовлення Elbuz.
Як підключити Paysera
Потрібен договір вашої фірми з Paysera, замовлена послуга прийому онлайн-платежів і проєкт для вашого сайту в кабінеті Paysera. Поки Paysera не затвердив проєкт, проходять лише тестові оплати.
- Оберіть версію. Checkout Classic працює в усіх країнах Paysera. Modern — лише там, де Paysera вже його відкрив (нижче).
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка Paysera.
- У блоці «Підключення» оберіть «Версія API Paysera». Нижче лишаться поля ключів саме цієї версії.
- Впишіть ключі з кабінету Paysera. Для Classic — «ID проєкту» і «Пароль проєкту», для Modern — «Ідентифікатор клієнта (Client ID)» і «Секрет клієнта (Client Secret)».
- Увімкніть перемикач «Увімкнено» вгорі екрана.
- Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
1
Paysera2
Позначка стану3
Налаштувати- Рядок модуля оплати Paysera.
- Чи бачать покупці цю оплату і чи дійшли останні зміни до магазину.
- Відкриває екран налаштування Paysera.
1
Увімкнено2
Версія API Paysera3
Тестовий режим4
ID проєкту5
Пароль проєкту6
Що ще не налаштовано- Показує Paysera покупцям після збереження.
- Checkout Classic чи Modern: нижче лишаються ключі обраної версії.
- Тестові оплати без списання грошей (лише Classic).
- Номер проєкту з кабінету Paysera.
- Секретний пароль проєкту: після збереження його не видно, лише позначку, що задано.
- Чого бракує, щоб оплата працювала.
Пароль проєкту і Client Secret після збереження не показуються — у полі видно лише, що їх задано. Щоб змінити, натисніть «Замінити» і впишіть новий. Без ключів обраної версії увімкнений модуль не збережеться.
У кабінеті Paysera адресу для повідомлень про оплату вписувати не треба: модуль передає її з кожною оплатою. На екрані довідково показано адресу обраної версії: «Адреса повідомлень Classic» чи «Адреса повідомлень Modern».
Якщо Paysera просить підтвердити, що сайт ваш (метатег verify-paysera), вставте метатег на сайт самі: як вставити код сервісу на сайт. Як влаштоване вікно загалом — у статті «Налаштування магазину».
Checkout Classic чи Modern
Paysera має дві версії підключення. Перемикач «Версія API Paysera» обирає, через яку з них іде оплата. Типово — Classic.
| Версія | Ключі | Де працює | Повернення |
|---|---|---|---|
| Checkout Classic | ID проєкту і пароль проєкту | Усі країни Paysera | Лише в кабінеті Paysera |
| Checkout Modern | Client ID і Client Secret проєкту | Зараз Литва, Латвія, Естонія, Болгарія, Косово, Північна Македонія | Уся сума чи частина — у картці замовлення Elbuz |
Де взяти ключі Classic
- «ID проєкту» — кабінет Paysera → «Проєкти та діяльність»: номер поруч із назвою проєкту. Лише цифри, до 11 знаків.
- «Пароль проєкту» — ваш проєкт → «Загальні налаштування проєкту». Ним підписується кожна оплата. Щонайменше 6 символів, без пробілів.
Де взяти ключі Modern
Кабінет Paysera → Checkout → ваш проєкт → Integrations → API credentials: там Client ID і Client Secret. Немає цього розділу у вашій країні — лишайтеся на Classic.
Кнопка «Regenerate credentials» у Paysera одразу скасовує старий Client Secret. Після неї впишіть новий у магазин, інакше оплати зупиняться.
1
Версія API Paysera2
Ідентифікатор клієнта (Client ID)3
Секрет клієнта (Client Secret)4
Адреса повідомлень Modern- Обрано Checkout Modern.
- Client ID з розділу Integrations → API credentials кабінету Paysera.
- Client Secret звідти ж; після «Regenerate credentials» у Paysera впишіть новий.
- Модуль передає цю адресу сам, у кабінеті Paysera її вписувати не треба.
Перемикати версію можна будь-коли. Уже прийняті оплати це не зачіпає, нові йдуть через обрану версію.
Як перевірити тестовою оплатою
Тестова оплата проходить через тестову сторінку Paysera, гроші не списуються. Працює і до затвердження проєкту.
Checkout Classic
- У кабінеті Paysera: проєкт → «Загальні налаштування проєкту» → дозвольте тестові платежі.
- На екрані модуля залиште «Тестовий режим» увімкненим, впишіть ключі, увімкніть модуль і збережіть.
- Оформіть замовлення на себе й оберіть Paysera. Над переходом буде «Тестовий режим Paysera: гроші не списуються.»
- Підтвердьте оплату на тестовій сторінці. Замовлення прийде в Elbuz зі статусом з поля «Оплачено».
- Вимкніть «Тестовий режим» і збережіть.
Поки тестовий режим увімкнено, праворуч на екрані висить «Увімкнено тестовий режим — гроші не списуються. Вимкніть перед продажами». Коли його вимкнено, тестова оплата замовлення оплаченим не зробить — так підроблену оплату не видати за справжню.
Checkout Modern
Перемикача «Тестовий режим» для Modern на екрані немає. Тестовий режим вмикається в самому проєкті Paysera: Merchant Portal → проєкт → ⋮ → Enable Test Mode. Тестові картки — у довідці Paysera для розробників.
Що бачить покупець і для яких замовлень
В оформленні замовлення спосіб називається «Paysera: картка, банк, Apple Pay, Google Pay». Після підтвердження покупець бачить «Переходимо на сторінку оплати Paysera…» і потрапляє на сторінку Paysera.
| Що сталося | Куди повертається покупець |
|---|---|
| Оплатив | Сторінка «Ваше замовлення сформоване» |
| Скасував оплату | Оформлення з «Оплату скасовано. Можна сплатити ще раз або обрати інший спосіб оплати.» Кошик зберігається |
| Не завершив оплату | Оформлення з «Оплату не завершено…»: можна спробувати ще раз або обрати інший спосіб |
Які способи оплати видно на сторінці Paysera, вирішують ваш договір з Paysera і країна покупця. Сума йде у валюті замовлення. Чи приймає ваш проєкт цю валюту, уточніть у Paysera.
Мова сторінки — основна мова магазину, якщо її підтримує Paysera, а не мова, яку обрав покупець. Classic знає російську, німецьку, польську, литовську, латиську, естонську й болгарську, Modern — литовську. Для решти, і для української теж, — англійська.
Для яких замовлень показувати
Блок «Де показувати» обмежує, кому Paysera видно:
- «Географічна зона» — оплата лише для покупців з адресою в цій зоні; «Усі зони» — для всіх.
- «Мінімальна сума замовлення» — Paysera з'являється від цієї суми в основній валюті магазину. Порожньо або
0— завжди. Максимальної суми немає. - «Порядок сортування» — місце в списку оплат, менше число стоїть вище.
Статуси замовлення
Статус ставить магазин сам, коли Paysera повідомляє про оплату. Які саме — обираєте в блоці «Статуси замовлення».
1
Оплачено2
Очікує оплати3
Повернуто- Ставиться, коли Paysera підтвердив оплату повної суми.
- Гроші ще в дорозі (банківський переказ) або покупець повернувся раніше за підтвердження.
- Після повного повернення в Checkout Modern.
| Поле | Коли ставиться | Типово |
|---|---|---|
| Оплачено | Paysera підтвердив оплату повної суми замовлення. Покупцю йде звичайний лист про замовлення | «В обробці» |
| Очікує оплати | Покупець заплатив банківським переказом, гроші ще в дорозі (Classic). Або покупець повернувся з Paysera раніше за підтвердження | «Очікує» |
| Повернуто | Покупцю повернули всю суму (лише Modern) | «Кошти повернено» |
Поки покупець не заплатив, замовлення лишається непідтвердженим. Повторна спроба оплати не створює зайвого замовлення.
Замовлення з переказом у дорозі стоїть у статусі з поля «Очікує оплати» — не відвантажуйте його. Коли Paysera підтвердить гроші, модуль сам поставить «Оплачено».
Якщо «Оплачено» і «Очікує оплати» однакові, праворуч з'явиться «Статуси «Оплачено» і «Очікує оплати» однакові — переказ у дорозі не відрізнити від оплати». Оберіть різні.
Коли статус не змінюється
- Сума не та. Покупець змінив кошик після переходу на оплату і сплатив стару суму. Оплату видно в кабінеті Paysera: домовтеся з покупцем про доплату або поверніть гроші.
- Друга оплата. Покупець заплатив за вже оплачене замовлення. Зайву оплату видно в кабінеті Paysera — поверніть її.
- Тестова оплата в робочому режимі (Classic). «Тестовий режим» вимкнено — тестова оплата відхиляється.
- Підроблене повідомлення. Модуль перевіряє підпис Paysera, суму й валюту, а в Classic — ще й номер проєкту. Чуже повідомлення замовлення не змінить.
Повернення грошей у картці замовлення
Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «Банківська карта». У його картці є блок «Платіж у Paysera»: стан платежу, сума, скільки списано й повернено. Там же — скільки ще можна повернути і всі спроби оплати з номером у Paysera.
| Версія | Як повернути | Що буде із замовленням |
|---|---|---|
| Checkout Modern | Кнопкою «Повернути кошти» в блоці «Платіж у Paysera». Можна всю суму чи частину, кілька разів, але не більше, ніж лишилось | Часткове — статус той самий, повернену суму видно в блоці. Повне — статус з поля «Повернуто» |
| Checkout Classic | Лише в кабінеті Paysera: блок у картці лише показує платіж, кнопок немає | Статус змініть самі |
У Checkout Modern кнопки — лише ті, що доступні замовленню зараз:
| Кнопка | Що робить |
|---|---|
| Повернути кошти | Повертає покупцю всю суму або частину. Поле суми вже заповнене залишком: щоб повернути все, лишіть запропоновану суму |
| Оновити статус | Бере стан платежу з Paysera, якщо повідомлення не дійшло |
Paysera проводить повернення кілька хвилин: сума в дорозі вже не входить у «Можна повернути». Покупцю лист про повернення магазин не надсилає.
Перед поверненням програма питає підтвердження з попередженням «Цю операцію не можна скасувати.». Статус замовлення змінюється так само, як після повідомлення Paysera, а в історії замовлення з'являється запис з результатом.
Магазин не відповів — програма напише «Невідомо, чи пройшла операція…» і покаже «Повторити». Вона повторює ту саму операцію: гроші вдруге не рухнуться. Нове натискання кнопки — це вже нова операція.
Повертати гроші може лише користувач із правом «Операції оплати: повернення, холд, кредит» — типово власник. «Оновити статус» доступне всім, хто бачить замовлення.
Коли через Paysera вже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.
Сценарії
Побутова техніка: покупці з Литви платять через свій банк
Укладіть договір з Paysera, впишіть «ID проєкту» і «Пароль проєкту». «Порядок сортування» — 1, щоб Paysera стояв першим. Покупець бачить на сторінці Paysera банки своєї країни, і пральна машина стає оплаченою сама.
Дорогий телевізор оплачено банківським переказом
Магазин працює на Checkout Classic. У «Очікує оплати» оберіть статус, за яким склад не відвантажує. Телевізор не поїде, доки модуль не поставить «Оплачено» — а це станеться, щойно Paysera підтвердить гроші.
Квіти: дрібні замовлення — готівкою
Комісія Paysera з'їдає маржу на дрібних замовленнях. «Мінімальна сума замовлення» — 20: Paysera з'являється в оформленні лише від 20 в основній валюті магазину.
Кавомашина з чашками: повернути лише чашки
Магазин працює на Checkout Modern. Покупець повертає чашки з комплекту — у картці замовлення натисніть «Повернути кошти» і впишіть вартість чашок. Paysera поверне частину, статус лишиться оплаченим, кабінет Paysera відкривати не треба.
Що робити, коли оплата не працює
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| Покупець не бачить Paysera при оформленні | Модуль вимкнено, немає ключів обраної версії, сума менша за мінімальну або адреса не в гео-зоні | Перевірте «Увімкнено», ключі, «Мінімальна сума замовлення» і «Географічна зона», потім «Зберегти» |
| Classic: Paysera показує помилку замість сторінки оплати | Неправильні ID проєкту чи пароль, проєкт ще не затверджено або тестові платежі в проєкті не дозволено | Вставте ключі з кабінету ще раз. Для тесту дозвольте тестові платежі в проєкті Paysera |
| Modern: покупець бачить «Не вдалося відкрити сторінку оплати» | Неправильні Client ID чи Client Secret, або їх перегенерували в Paysera | Впишіть актуальні ключі з Integrations → API credentials і збережіть |
| Оплата пройшла, а статус не змінився | Повідомлення Paysera не доходять: сайт закрито паролем або захистом від ботів | Відкрийте для Paysera адресу повідомлень з блоку «Підключення». У Modern для цього замовлення натисніть «Оновити статус» у його картці в Elbuz. Не допомогло — підтримка Elbuz подивиться журнал модуля |
| Classic: тестова оплата не зробила замовлення оплаченим | «Тестовий режим» у модулі вимкнено | Для перевірки увімкніть його, після перевірки вимкніть |
| «Магазин не прийняв налаштування» або «Магазин не прийняв частину значень — див. позначені поля» | Магазин не відповів або відхилив окремі поля | Виправте позначені поля і збережіть. Якщо полів не позначено, зміни підуть із наступним вивантаженням |
Часті запитання
Чи можна підключити Paysera магазину з України?
Модуль працює з будь-яким проєктом Paysera. Чи укладе Paysera договір з вашою фірмою і які способи оплати відкриє, вирішує Paysera.
Що буде, якщо вимкнути модуль?
Paysera зникне з оформлення замовлення. Ключі й налаштування зберігаються: увімкнете знову — усе на місці.
Чи можна надіслати покупцю посилання на оплату Paysera з Elbuz?
Ні. Посилання на оплату з картки замовлення працює з іншими сервісами: Оплата за посиланням.
У списку «Географічна зона» немає потрібної зони — що робити?
Зону, наприклад «Литва», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».
Це те саме, що доставка Paysera?
Ні. Доставка Paysera (поштомати й кур'єри) — окремий модуль розділу «Доставка», зі своїми налаштуваннями.
Як повернути гроші покупцю?
У Checkout Modern відкрийте замовлення в Elbuz і в блоці «Платіж у Paysera» натисніть «Повернути кошти». У Checkout Classic поверніть гроші в кабінеті Paysera і змініть статус замовлення самі. Лист про повернення покупцю магазин не надсилає.
Де це і хто має доступ
- Меню
- Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → Paysera
- Право доступу
- вікно «Налаштування магазину» в «Правах груп»; повернення — право «Операції оплати: повернення, холд, кредит»
- Підготувати
- договір з Paysera, проєкт у кабінеті Paysera, ключі обраної версії
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо продаєте і в Україні — Як приймати оплату LiqPay в магазині.
- Якщо треба обробити оплачене замовлення в Elbuz — Замовлення покупця.
