Оплата PayPal додає в оформлення кнопки PayPal: гаманець PayPal, Pay Later, картка без акаунта, у ЄС — iDEAL, BLIK, Przelewy24 та інші. Покупець бачить їх після підтвердження замовлення, а магазин сам списує точну суму і ставить статус.
Коли це знадобиться:
- Ви продаєте в ЄС, Велику Британію чи США — покупці звикли платити PayPal.
- Покупець хоче платити частинами — Pay Later, а магазин отримує всю суму одразу.
- У покупця немає акаунта PayPal — він платить карткою у вікні PayPal.
- Треба повернути гроші — кнопкою в картці замовлення в Elbuz, без входу в кабінет PayPal.
З чого почати: «Налаштування магазину» → «Оформлення і оплата» → PayPal → ключі, вебхук і перемикач «Увімкнено».
Що вміє оплата PayPal
- Показувати кнопки PayPal — гаманець, Pay Later, картка, місцеві способи ЄС.
- Перевіряти оплату в sandbox — тестовими акаунтами PayPal, без справжніх грошей.
- Ставити статус замовлення сам — оплачено, очікує, відхилено, повернено.
- Дізнаватися про зміни після оплати — завершення платежу, повернення з кабінету PayPal.
- Повертати гроші з картки замовлення — усю суму чи частину.
Як підключити PayPal
Потрібен бізнес-акаунт PayPal вашої фірми (тип Business, не Personal). Спільних ключів Elbuz не має: модуль працює лише з ключами вашого застосунку PayPal.
- Створіть застосунок PayPal і скопіюйте ключі — де саме.
- Відкрийте екран модуля. «Налаштування магазину» → розділ «Оформлення і оплата» → картка PayPal.
- Впишіть ключі. Тестові — у блок «Ключі sandbox», бойові — у «Ключі live».
- Додайте вебхук у застосунку PayPal і впишіть його «Ідентифікатор вебхука (Webhook ID)» — як.
- Увімкніть перемикач «Увімкнено» вгорі екрана.
- Натисніть «Зберегти». Налаштування одразу йдуть у магазин.
- Перевірте оплату в sandbox і перейдіть на бойовий режим — як.
1
Картка PayPal2
Позначка стану модуля- Картка PayPal — відкриває екран налаштування PayPal.
- Позначка стану — чи бачать покупці цю оплату і чи дійшли останні зміни до магазину.
1
Перемикач «Увімкнено»2
Тестовий режим (sandbox)3
Адреса вебхука4
Події вебхука5
Що ще не налаштовано6
Режим- Перемикач «Увімкнено» — показує PayPal покупцям після збереження.
- Тестовий режим (sandbox): увімкнено — оплати йдуть у тестовий PayPal (sandbox) з ключами sandbox; вимкнено — справжні оплати з ключами live.
- Адреса вебхука — її вставляють у застосунку PayPal → Webhooks → Add Webhook.
- Події вебхука — події, які треба позначити у вебхуку.
- Що ще не налаштовано — чого бракує, щоб оплата працювала.
- Режим — який режим працює зараз.
Без Client ID і Secret поточного режиму увімкнений модуль не збережеться. Як влаштоване вікно загалом — у статті «Налаштування магазину».
PayPal з'являється в оформленні лише для валют, які він приймає: USD, EUR, GBP, PLN, CZK, CHF та інших. Гривні PayPal не приймає, і суми магазин не перераховує. Якщо жодна валюта магазину не підходить, праворуч буде «Жодна валюта магазину не підтримується PayPal — покупці не побачать PayPal».
Валюту додають у «Довідники → Валюти та курси» — активною, з курсом і позначкою «Відображати на сайті». У магазин вона піде з наступним вивантаженням.
Де взяти ключі й Webhook ID
Ключі видає сайт для розробників PayPal — developer.paypal.com, вхід тим самим бізнес-акаунтом.
- Відкрийте Apps & Credentials. Угорі перемикач Sandbox / Live: у кожного режиму свої застосунки і ключі.
- Create App → назва магазину, тип Merchant → збережіть.
- Скопіюйте Client ID у поле «Ідентифікатор клієнта (Client ID)».
- Біля Secret key 1 натисніть Show і скопіюйте його в «Секретний ключ (Secret)».
| Блок на екрані | Ключі якого застосунку | Коли працюють |
|---|---|---|
| Ключі sandbox | Застосунок у режимі Sandbox | Увімкнено «Тестовий режим (sandbox)»: справжніх грошей немає |
| Ключі live | Застосунок у режимі Live | Тестовий режим вимкнено: справжні оплати покупців |
Картка ключів поточного режиму розгорнута і позначена «працює зараз». Обов'язкові лише ключі цього режиму.
1
працює зараз2
Ідентифікатор клієнта (Client ID)3
Секретний ключ (Secret)4
Ідентифікатор вебхука (Webhook ID)5
Ключі live- Пілюля «працює зараз» — ключі цього режиму працюють зараз, лише вони обов'язкові.
- Client ID застосунку PayPal (Apps & Credentials).
- Secret key звідти ж: після збереження не показується, лише позначка, що задано.
- Webhook ID з розділу Webhooks того самого застосунку.
- Згорнута картка — ключі другого режиму, розгортаються кліком.
Секретний ключ після збереження не показується — у полі видно лише «задано». Щоб змінити, натисніть «Замінити» і вставте новий.
Навіщо вебхук і як його додати
Вебхук — повідомлення від PayPal про те, що сталося вже після оплати. Без нього оплата працює, але магазин не дізнається:
- що платіж, який очікував, завершено або відхилено;
- що ви повернули гроші в кабінеті PayPal;
- що покупець оплатив і закрив вкладку, не дочекавшись магазину.
- У блоці «Підключення» скопіюйте «Адреса вебхука» кнопкою «Копіювати».
- На developer.paypal.com: той самий застосунок → Webhooks → Add Webhook. Вставте адресу.
- Позначте події з поля «Події вебхука» — їх можна скопіювати кнопкою «Копіювати всі». Збережіть.
- PayPal покаже Webhook ID — впишіть його в «Ідентифікатор вебхука (Webhook ID)» того самого блоку ключів.
- Повторіть для другого режиму: у Sandbox і Live вебхуки окремі.
Поки Webhook ID поточного режиму порожній, праворуч висить «Немає Webhook ID — не дійдуть події PayPal…».
Кожне повідомлення магазин перевіряє в самого PayPal за Webhook ID, а про платіж ще раз питає PayPal. Підроблене повідомлення замовлення не змінить. Адреса вебхука має бути https:// і не закриватися паролем на сайт чи захистом від ботів.
Як перевірити в sandbox
Sandbox — тестовий PayPal: справжніх грошей немає, договір і фірма не потрібні.
- На developer.paypal.com: Testing Tools → Sandbox Accounts. Там уже є тестовий бізнес-акаунт і тестовий особистий для покупця.
- На екрані модуля «Тестовий режим (sandbox)» увімкнено, у «Ключі sandbox» — ключі й Webhook ID. Збережіть.
- Перемкніть вітрину на валюту PayPal, наприклад EUR, і оформіть замовлення з PayPal.
- Над кнопками буде «Тестовий режим PayPal (sandbox): справжні гроші не списуються.» Увійдіть тестовим особистим акаунтом і сплатіть.
- Замовлення в Elbuz отримає статус з поля «Оплачено». Сам платіж видно в sandbox-кабінеті PayPal.
- Вимкніть «Тестовий режим (sandbox)», заповніть «Ключі live» і збережіть.
Поки тестовий режим увімкнено, праворуч висить «Увімкнено тестовий режим — гроші не списуються. Вимкніть перед продажами».
Після переходу на live магазин сам закриває неоплачені тестові спроби. Тестова оплата в бойовому режимі замовлення оплаченим не зробить.
Які кнопки бачить покупець
Кнопки малює сам PayPal. Блок «Кнопки на сторінці оформлення» обирає їхній вигляд і які способи дозволити. Чи показати спосіб конкретному покупцю, вирішує PayPal: за країною, валютою і сумою.
1
Розташування2
Оплата пізніше частинами (Pay Later)3
Місцеві способи ЄС4
Кнопка картки5
Форма картки на сторінці- Вигляд кнопок: варіанти самого PayPal.
- Покупець платить частинами, магазин отримує всю суму одразу.
- iDEAL, Bancontact, EPS, MyBank для EUR, BLIK і Przelewy24 для PLN.
- Оплата карткою без акаунта PayPal.
- Поля картки прямо в магазині, якщо 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. Які статуси ставити — обираєте в блоці «Статуси замовлення».
1
Оплачено2
Очікує3
Відхилено4
Повернено- Ставиться, коли PayPal списав гроші.
- PayPal притримав платіж, «Оплачено» модуль поставить сам.
- PayPal відхилив платіж, який очікував.
- Після повного повернення.
| Поле | Коли ставиться | Типово |
|---|---|---|
| Оплачено | 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 у магазині
Суміжні теми
- Якщо треба зрозуміти, як працює вікно налаштувань магазину — Налаштування магазину.
- Якщо продаєте в Литву, Латвію чи Естонію — Як приймати оплату Paysera в магазині.
- Якщо треба додати валюту магазину — Валюти та курси.
- Якщо треба обробити оплачене замовлення в Elbuz — Замовлення покупця.
