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

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

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

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

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

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

    • Ви продаєте в Литву, Латвію, Естонію чи інші країни ЄС — покупець платить через банк своєї країни.
    • Покупець платить банківським переказом — у Checkout Classic замовлення чекає грошей в «Очікує оплати» і стає оплаченим саме.
    • Покупець змінив кошик після переходу на оплату — оплата іншої суми не стане «Оплачено».
    • Треба повернути частину грошей — у Checkout Modern це кнопка в картці замовлення Elbuz.

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

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

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

    Потрібен договір вашої фірми з Paysera, замовлена послуга прийому онлайн-платежів і проєкт для вашого сайту в кабінеті Paysera. Поки Paysera не затвердив проєкт, проходять лише тестові оплати.

    1. Оберіть версію. Checkout Classic працює в усіх країнах Paysera. Modern — лише там, де Paysera вже його відкрив (нижче).
    2. Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка Paysera.
    3. У блоці «Підключення» оберіть «Версія API Paysera». Нижче лишаться поля ключів саме цієї версії.
    4. Впишіть ключі з кабінету Paysera. Для Classic — «ID проєкту» і «Пароль проєкту», для Modern — «Ідентифікатор клієнта (Client ID)» і «Секрет клієнта (Client Secret)».
    5. Увімкніть перемикач «Увімкнено» вгорі екрана.
    6. Натисніть «Зберегти». Налаштування одразу йдуть у магазин: внизу з'явиться «Збережено й застосовано в магазині».
    Розділ «Оформлення і оплата» в налаштуваннях магазину: список модулів оплати з рядком Paysera
    1Paysera
    2Позначка стану
    3Налаштувати
    1. Рядок модуля оплати Paysera.
    2. Чи бачать покупці цю оплату і чи дійшли останні зміни до магазину.
    3. Відкриває екран налаштування Paysera.
    Екран налаштування Paysera: шапка, блок «Підключення» і права колонка зі станом
    1Увімкнено
    2Версія API Paysera
    3Тестовий режим
    4ID проєкту
    5Пароль проєкту
    6Що ще не налаштовано
    1. Показує Paysera покупцям після збереження.
    2. Checkout Classic чи Modern: нижче лишаються ключі обраної версії.
    3. Тестові оплати без списання грошей (лише Classic).
    4. Номер проєкту з кабінету Paysera.
    5. Секретний пароль проєкту: після збереження його не видно, лише позначку, що задано.
    6. Чого бракує, щоб оплата працювала.

    Пароль проєкту і Client Secret після збереження не показуються — у полі видно лише, що їх задано. Щоб змінити, натисніть «Замінити» і впишіть новий. Без ключів обраної версії увімкнений модуль не збережеться.

    У кабінеті Paysera адресу для повідомлень про оплату вписувати не треба: модуль передає її з кожною оплатою. На екрані довідково показано адресу обраної версії: «Адреса повідомлень Classic» чи «Адреса повідомлень Modern».

    Якщо Paysera просить підтвердити, що сайт ваш (метатег verify-paysera), вставте метатег на сайт самі: як вставити код сервісу на сайт. Як влаштоване вікно загалом — у статті «Налаштування магазину».

    Checkout Classic чи Modern

    Paysera має дві версії підключення. Перемикач «Версія API Paysera» обирає, через яку з них іде оплата. Типово — Classic.

    ВерсіяКлючіДе працюєПовернення
    Checkout ClassicID проєкту і пароль проєктуУсі країни PayseraЛише в кабінеті Paysera
    Checkout ModernClient 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. Після неї впишіть новий у магазин, інакше оплати зупиняться.

    Блок «Підключення» з обраною версією Checkout Modern і полями Client ID та Client Secret
    1Версія API Paysera
    2Ідентифікатор клієнта (Client ID)
    3Секрет клієнта (Client Secret)
    4Адреса повідомлень Modern
    1. Обрано Checkout Modern.
    2. Client ID з розділу Integrations → API credentials кабінету Paysera.
    3. Client Secret звідти ж; після «Regenerate credentials» у Paysera впишіть новий.
    4. Модуль передає цю адресу сам, у кабінеті Paysera її вписувати не треба.

    Перемикати версію можна будь-коли. Уже прийняті оплати це не зачіпає, нові йдуть через обрану версію.

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

    Тестова оплата проходить через тестову сторінку Paysera, гроші не списуються. Працює і до затвердження проєкту.

    Checkout Classic

    1. У кабінеті Paysera: проєкт → «Загальні налаштування проєкту» → дозвольте тестові платежі.
    2. На екрані модуля залиште «Тестовий режим» увімкненим, впишіть ключі, увімкніть модуль і збережіть.
    3. Оформіть замовлення на себе й оберіть Paysera. Над переходом буде «Тестовий режим Paysera: гроші не списуються.»
    4. Підтвердьте оплату на тестовій сторінці. Замовлення прийде в Elbuz зі статусом з поля «Оплачено».
    5. Вимкніть «Тестовий режим» і збережіть.

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

    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Повернуто
    1. Ставиться, коли Paysera підтвердив оплату повної суми.
    2. Гроші ще в дорозі (банківський переказ) або покупець повернувся раніше за підтвердження.
    3. Після повного повернення в 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, ключі обраної версії

    Суміжні теми

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

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

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

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

    Зміст статті

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

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