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

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

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

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

    Оплата PayPal додає в оформлення кнопки PayPal: гаманець PayPal, Pay Later, картка без акаунта, у ЄС — iDEAL, BLIK, Przelewy24 та інші. Покупець бачить їх після підтвердження замовлення, а магазин сам списує точну суму і ставить статус.

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

    • Ви продаєте в ЄС, Велику Британію чи США — покупці звикли платити PayPal.
    • Покупець хоче платити частинами — Pay Later, а магазин отримує всю суму одразу.
    • У покупця немає акаунта PayPal — він платить карткою у вікні PayPal.
    • Треба повернути гроші — кнопкою в картці замовлення в Elbuz, без входу в кабінет PayPal.

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

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

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

    Потрібен бізнес-акаунт PayPal вашої фірми (тип Business, не Personal). Спільних ключів Elbuz не має: модуль працює лише з ключами вашого застосунку PayPal.

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

    Без Client ID і Secret поточного режиму увімкнений модуль не збережеться. Як влаштоване вікно загалом — у статті «Налаштування магазину».

    PayPal з'являється в оформленні лише для валют, які він приймає: USD, EUR, GBP, PLN, CZK, CHF та інших. Гривні PayPal не приймає, і суми магазин не перераховує. Якщо жодна валюта магазину не підходить, праворуч буде «Жодна валюта магазину не підтримується PayPal — покупці не побачать PayPal».

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

    Де взяти ключі й Webhook ID

    Ключі видає сайт для розробників PayPal — developer.paypal.com, вхід тим самим бізнес-акаунтом.

    1. Відкрийте Apps & Credentials. Угорі перемикач Sandbox / Live: у кожного режиму свої застосунки і ключі.
    2. Create App → назва магазину, тип Merchant → збережіть.
    3. Скопіюйте Client ID у поле «Ідентифікатор клієнта (Client ID)».
    4. Біля Secret key 1 натисніть Show і скопіюйте його в «Секретний ключ (Secret)».
    Блок на екраніКлючі якого застосункуКоли працюють
    Ключі sandboxЗастосунок у режимі SandboxУвімкнено «Тестовий режим (sandbox)»: справжніх грошей немає
    Ключі liveЗастосунок у режимі LiveТестовий режим вимкнено: справжні оплати покупців

    Картка ключів поточного режиму розгорнута і позначена «працює зараз». Обов'язкові лише ключі цього режиму.

    Картки «Ключі sandbox» (розгорнута) і «Ключі live» (згорнута)
    1працює зараз
    2Ідентифікатор клієнта (Client ID)
    3Секретний ключ (Secret)
    4Ідентифікатор вебхука (Webhook ID)
    5Ключі live
    1. Пілюля «працює зараз» — ключі цього режиму працюють зараз, лише вони обов'язкові.
    2. Client ID застосунку PayPal (Apps & Credentials).
    3. Secret key звідти ж: після збереження не показується, лише позначка, що задано.
    4. Webhook ID з розділу Webhooks того самого застосунку.
    5. Згорнута картка — ключі другого режиму, розгортаються кліком.

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

    Навіщо вебхук і як його додати

    Вебхук — повідомлення від PayPal про те, що сталося вже після оплати. Без нього оплата працює, але магазин не дізнається:

    • що платіж, який очікував, завершено або відхилено;
    • що ви повернули гроші в кабінеті PayPal;
    • що покупець оплатив і закрив вкладку, не дочекавшись магазину.
    1. У блоці «Підключення» скопіюйте «Адреса вебхука» кнопкою «Копіювати».
    2. На developer.paypal.com: той самий застосунок → Webhooks → Add Webhook. Вставте адресу.
    3. Позначте події з поля «Події вебхука» — їх можна скопіювати кнопкою «Копіювати всі». Збережіть.
    4. PayPal покаже Webhook ID — впишіть його в «Ідентифікатор вебхука (Webhook ID)» того самого блоку ключів.
    5. Повторіть для другого режиму: у Sandbox і Live вебхуки окремі.

    Поки Webhook ID поточного режиму порожній, праворуч висить «Немає Webhook ID — не дійдуть події PayPal…».

    Кожне повідомлення магазин перевіряє в самого PayPal за Webhook ID, а про платіж ще раз питає PayPal. Підроблене повідомлення замовлення не змінить. Адреса вебхука має бути https:// і не закриватися паролем на сайт чи захистом від ботів.

    Як перевірити в sandbox

    Sandbox — тестовий PayPal: справжніх грошей немає, договір і фірма не потрібні.

    1. На developer.paypal.com: Testing Tools → Sandbox Accounts. Там уже є тестовий бізнес-акаунт і тестовий особистий для покупця.
    2. На екрані модуля «Тестовий режим (sandbox)» увімкнено, у «Ключі sandbox» — ключі й Webhook ID. Збережіть.
    3. Перемкніть вітрину на валюту PayPal, наприклад EUR, і оформіть замовлення з PayPal.
    4. Над кнопками буде «Тестовий режим PayPal (sandbox): справжні гроші не списуються.» Увійдіть тестовим особистим акаунтом і сплатіть.
    5. Замовлення в Elbuz отримає статус з поля «Оплачено». Сам платіж видно в sandbox-кабінеті PayPal.
    6. Вимкніть «Тестовий режим (sandbox)», заповніть «Ключі live» і збережіть.

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

    Після переходу на live магазин сам закриває неоплачені тестові спроби. Тестова оплата в бойовому режимі замовлення оплаченим не зробить.

    Які кнопки бачить покупець

    Кнопки малює сам PayPal. Блок «Кнопки на сторінці оформлення» обирає їхній вигляд і які способи дозволити. Чи показати спосіб конкретному покупцю, вирішує PayPal: за країною, валютою і сумою.

    Блок «Кнопки на сторінці оформлення» у налаштуваннях PayPal
    1Розташування
    2Оплата пізніше частинами (Pay Later)
    3Місцеві способи ЄС
    4Кнопка картки
    5Форма картки на сторінці
    1. Вигляд кнопок: варіанти самого PayPal.
    2. Покупець платить частинами, магазин отримує всю суму одразу.
    3. iDEAL, Bancontact, EPS, MyBank для EUR, BLIK і Przelewy24 для PLN.
    4. Оплата карткою без акаунта PayPal.
    5. Поля картки прямо в магазині, якщо PayPal відкрив Advanced Credit and Debit Card Payments.
    ПолеЩо даєТипово
    Оплата пізніше частинами (Pay Later)Покупець платить PayPal частинами, магазин отримує всю суму одразу. Є лише в країнах, де PayPal це пропонує, наприклад UK, DE, FR, ES, IT, USУвімкнено
    Місцеві способи ЄСОкремі кнопки місцевих способів: у євро — iDEAL, Bancontact, EPS, MyBank; у злотих — BLIK і Przelewy24Увімкнено
    Кнопка картки«Debit or Credit Card»: оплата карткою без акаунта PayPal, без окремого договоруУвімкнено
    Форма картки на сторінціПоля картки прямо в магазині, з 3-D Secure, коли вимагає банк. Потрібні Advanced Credit and Debit Card Payments у вашому акаунті PayPal. Без них форма не з'явиться, кнопка картки лишитьсяВимкнено

    «Розташування», «Колір», «Форма» і «Напис на кнопці» — варіанти самого PayPal. Вертикально — усі способи один під одним, горизонтально — дві кнопки поруч.

    Мова кнопок — основна мова магазину: англійська, польська, німецька, французька, іспанська, італійська чи російська. Української в PayPal немає — для неї кнопки англійською.

    Як платить покупець і для яких замовлень

    В оформленні спосіб називається «PayPal». Після підтвердження замовлення з'являються кнопки, покупець обирає спосіб і платить у вікні PayPal.

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

    Суму платежу рахує магазин: це поточна сума замовлення у валюті, яку обрав покупець. Для гаманця і Pay Later PayPal не питає адресу доставки — вона вже є в замовленні.

    Для яких замовлень показувати

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

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

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

    Блок «Статуси замовлення» у налаштуваннях PayPal
    1Оплачено
    2Очікує
    3Відхилено
    4Повернено
    1. Ставиться, коли PayPal списав гроші.
    2. PayPal притримав платіж, «Оплачено» модуль поставить сам.
    3. PayPal відхилив платіж, який очікував.
    4. Після повного повернення.
    ПолеКоли ставитьсяТипово
    ОплаченоPayPal списав гроші. Покупцю йде звичайний лист про замовлення«В обробці»
    ОчікуєPayPal прийняв платіж, але притримав: eCheck, перевірка, місцевий спосіб із пізнім підтвердженням«Очікує»
    ВідхиленоPayPal відхилив платіж, який очікував«Відхилено»
    ПоверненоПокупцю повернули всю суму«Кошти повернено»

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

    Коли статус не змінюється

    • Сума не та. Кошик змінили саме в момент оплати. Гроші в кабінеті PayPal є, а замовлення не оплачене: поверніть оплату або допродайте різницю.
    • Друга оплата. Замовлення вже оплачене, а в кабінеті PayPal два платежі за нього: поверніть зайвий.
    • Тестова оплата в бойовому режимі. Платіж із sandbox замовлення оплаченим не зробить.

    Повернення й статус платежу в картці замовлення

    Замовлення з сайту приходить у документи «Замовлення покупця» в Elbuz з видом оплати «PayPal». У його картці є блок «Платіж у PayPal»: стан платежу, сума, списано, повернено й скільки ще можна повернути. Нижче — усі спроби оплати.

    Кнопки — лише ті, що доступні замовленню зараз:

    КнопкаЩо робить
    Повернути коштиПовертає покупцю всю суму або частину. Поле суми вже заповнене залишком: щоб повернути все, лишіть запропоновану суму
    Оновити статусБере стан платежу з PayPal, якщо вебхук не дійшов

    Перед поверненням програма питає підтвердження з попередженням «Цю операцію не можна скасувати.». Статус замовлення змінюється так само, як після повідомлення PayPal.

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

    Магазин не відповів — з'явиться «Невідомо, чи пройшла операція. Натисніть «Повторити» — гроші вдруге не рухнуться». «Повторити» повторює ту саму операцію, а нове натискання «Повернути кошти» — це вже нове повернення.

    Повертати гроші може лише користувач із правом «Операції оплати: повернення, холд, кредит» — типово власник. «Оновити статус» доступне всім, хто бачить замовлення.

    Повернути можна й у кабінеті PayPal: платіж → Refund, уся сума чи частина. Замовлення дізнається про це через вебхук, якщо Webhook ID заповнено.

    Коли через PayPal вже були замовлення, шапка екрана модуля показує їх за 30 днів: кількість, суму, середній чек і частку скасованих чи повернених.

    Сценарії

    Побутова техніка: пральна машина частинами в Німеччині

    Пральна машина коштує 900 €, покупець не готовий платити все одразу. Увімкніть EUR у валютах, лиште «Оплата пізніше частинами (Pay Later)», «Розташування» — вертикально. Покупець обирає Pay Later, і замовлення стає оплаченим саме.

    Електроніка: ноутбук без акаунта PayPal

    Покупець не хоче заводити PayPal. «Кнопка картки» лишається увімкненою — під PayPal буде «Debit or Credit Card». Якщо PayPal відкрив вам Advanced Credit and Debit Card Payments, увімкніть «Форма картки на сторінці».

    Навушники в Нідерланди, Бельгію і Польщу

    Там звикли до iDEAL, Bancontact і BLIK. Увімкніть «Місцеві способи ЄС» і валюти EUR та PLN. Нідерландський покупець бачить iDEAL, бельгійський — Bancontact, польський у злотих — BLIK і Przelewy24.

    Одяг: повернути гроші за один розмір

    Покупець замовив куртку у двох розмірах і один повертає. У картці замовлення натисніть «Повернути кошти» і впишіть ціну однієї куртки. Статус замовлення лишиться оплаченим, повернення видно в блоці «Платіж у PayPal».

    Сувеніри: PayPal лише за кордон і від 30 $

    У «Геозона» оберіть зону з потрібними країнами. «Мінімальна сума замовлення» — 30 $, перераховані в основну валюту магазину. PayPal бачать лише іноземні покупці з кошиком від цієї суми.

    Що робити, коли оплата не працює

    Що ви бачитеЧому такЩо зробити
    Покупець не бачить PayPal при оформленні Модуль вимкнено, немає ключів поточного режиму, ціни у валюті, якої PayPal не приймає (наприклад, гривні), сума менша за мінімальну або адреса не в геозоні Перевірте «Увімкнено», ключі, валюту вітрини, «Мінімальна сума замовлення» і «Геозона»
    Спосіб є, а кнопки не з'являються Блокувальник реклами в покупця або помилка в Client ID Вставте Client ID ще раз. Перевірте з іншого браузера
    Покупець бачить «Не вдалося почати оплату PayPal» Ключі з іншого режиму (Sandbox замість Live) або від іншого застосунку Впишіть ключі застосунку саме того режиму, що працює зараз
    Платіж «Очікує» і не змінюється Вебхук не доходить: немає Webhook ID, інша адреса, бракує подій або адресу закрито захистом сайту Натисніть «Оновити статус» у картці замовлення. Потім перевірте вебхук у застосунку PayPal за блоком «Підключення»
    Немає Pay Later чи місцевого способу PayPal показує їх лише для певних країн, валют і сум Перевірте, що перемикач увімкнено. Решта — за PayPal
    «Магазин не прийняв налаштування» або «Магазин не прийняв частину значень — див. позначені поля» Магазин не відповів або відхилив окремі поля Виправте позначені поля і збережіть. Якщо полів не позначено, зміни підуть із наступним вивантаженням

    Часті запитання

    Чи можна приймати PayPal магазину з України?

    Модуль працює з будь-яким бізнес-акаунтом PayPal, а умови акаунта визначає PayPal. Ціни на вітрині мають бути в доларах, євро чи іншій валюті PayPal: гривні він не приймає.

    Що буде, якщо вимкнути модуль?

    PayPal зникне з оформлення замовлення. Ключі й налаштування зберігаються: увімкнете знову — усе на місці.

    Чи можна надіслати покупцю посилання на оплату PayPal з Elbuz?

    Ні. Посилання на оплату з картки замовлення працює з іншими сервісами: Оплата за посиланням.

    Як повернути покупцю гроші за PayPal?

    У картці замовлення в Elbuz натисніть «Повернути кошти» в блоці «Платіж у PayPal». Лист про повернення покупцю не йде.

    У списку «Геозона» немає потрібної зони — що робити?

    Зону, наприклад «Країни ЄС», створює служба підтримки Elbuz. Потім оберіть її в блоці «Де показувати».

    Чи можна змінити назву способу в оформленні?

    Так, через службу підтримки Elbuz. На екрані модуля такого поля немає.

    Де це і хто має доступ

    Меню
    Довідники → Операції → Налаштування магазину → «Оформлення і оплата» → PayPal
    Право доступу
    вікно «Налаштування магазину» в «Правах груп»
    Підготувати
    бізнес-акаунт PayPal, застосунки Sandbox і Live, валюта PayPal у магазині

    Суміжні теми

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

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

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

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

    Зміст статті

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

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