VibeFox PayPal for WooCommerce — Допомога

Вимоги

WordPress: 6.0 або новіша версія.

WooCommerce: 7.0 або новіша, встановлений і активний. Без нього плагін не активується.

PHP: 8.0 або новіша версія.

HTTPS: для платежів у робочому режимі ваш сайт має використовувати HTTPS.

Обліковий запис PayPal: бізнес-обліковий запис PayPal з застосунком REST API у PayPal Developer Dashboard. Потрібні Client ID та Secret застосунку. Застосунки для sandbox і для робочого режиму мають різні облікові дані. Вебхук не потрібен: плагін підтверджує кожен платіж на вашому сервері, поки покупець перебуває на оформленні замовлення.

Валюта: одна з валют, які підтримує PayPal: AUD, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, ILS, JPY, MXN, MYR, NOK, NZD, PHP, PLN, SEK, SGD, THB, TWD або USD.

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

1. У WordPress перейдіть до Plugins > Add New > Upload Plugin, виберіть ZIP-файл плагіна та натисніть Install Now. Також можна завантажити папку wcp_paypal_gateway до /wp-content/plugins/ через FTP.

2. Натисніть Activate.

3. У PayPal Developer Dashboard створіть застосунок REST API (для sandbox та/або робочого режиму) і скопіюйте його Client ID та Secret.

4. Відкрийте налаштування: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage або натисніть Settings під назвою плагіна на сторінці Plugins.

5. Введіть ліцензійний ключ VibeFox у блок ліцензії у верхній частині сторінки та натисніть Activate.

6. Введіть облікові дані режиму, який використовуєте, виберіть Capture або Authorize, увімкніть Enable/Disable і збережіть.

7. Перевірте роботу з тестовим покупцем PayPal у sandbox, потім вимкніть Sandbox mode і введіть облікові дані робочого режиму.

Налаштування

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > PayPal (Smart Buttons). Над полями сторінка попереджає, коли спосіб оплати увімкнено, але Client ID або Secret вибраного режиму порожні, а також коли PayPal не підтримує валюту магазину. В обох випадках спосіб оплати приховується на оформленні замовлення. У списку способів оплати PayPal показує позначку Test mode у sandbox і позначається як такий, що потребує налаштування, доки не заповнені облікові дані вибраного режиму.

Загальні

Enable/Disable: Enable PayPal Gateway вмикає або вимикає спосіб оплати. За замовчуванням: off.

Title: назва способу оплати, яку бачать покупці на оформленні замовлення. За замовчуванням: PayPal.

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay with your PayPal account or a card via PayPal.

Облікові дані API

Створіть застосунок REST API у PayPal Developer Dashboard і скопіюйте його Client ID та Secret. У розділі є посилання на застосунки sandbox і застосунки робочого режиму. Показуються лише поля вибраного режиму.

Sandbox mode: Enable sandbox (test) mode. Платежі надсилаються до sandbox PayPal з обліковими даними sandbox; реальні гроші не переказуються. За замовчуванням: on. Вимкніть, щоб приймати реальні платежі.

Sandbox Client ID: Client ID вашого застосунку REST API для sandbox.

Sandbox Secret: Secret вашого застосунку REST API для sandbox.

Live Client ID: Client ID вашого застосунку REST API для робочого режиму.

Live Secret: Secret вашого застосунку REST API для робочого режиму.

Оплата

Payment action: що відбувається, коли покупець схвалює платіж. За замовчуванням: Capture.

Capture: покупця одразу оплачують, а замовлення переходить у статус «Обробляється».

Authorize: кошти лише резервуються, а замовлення переходить на утримання. Захопіть або анулюйте платіж на екрані замовлення через меню Order actions. Авторизації PayPal можна захопити протягом 29 днів.

Додатково

Debug log: Log API requests (errors are always logged). Записи зберігаються в WooCommerce > Status > Logs з джерелом wcp_paypal_gateway. Облікові дані та дані покупців ніколи не записуються в журнал. За замовчуванням: off.

Delete data on uninstall: Delete the gateway settings when the plugin is deleted. Платіжні дані замовлень (ідентифікатори PayPal у замовленнях) завжди зберігаються. За замовчуванням: off.

Оформлення замовлення

Коли покупець обирає PayPal (за замовчуванням PayPal), кнопка PayPal замінює Place order. У режимі sandbox на оформленні замовлення відображається Режим sandbox: сплатіть з тестового облікового запису покупця PayPal; реальні кошти не списуються. Натискання кнопки створює на вашому сервері замовлення PayPal на суму кошика (або на суму замовлення на сторінці Pay for order). Сума завжди обчислюється на сервері, ніколи в браузері.

Покупець підтверджує платіж у вікні PayPal за допомогою облікового запису PayPal або іншого джерела фінансування, яке пропонує PayPal. Після цього на оформленні замовлення з'являється Платіж PayPal схвалено. Завершуємо оформлення замовлення…, і замовлення надсилається. Ваш сервер зчитує замовлення PayPal та перевіряє, що воно схвалене, створене під час цього оформлення, не використовується іншим замовленням, а його сума й валюта відповідають замовленню. Лише тоді платіж захоплюється (або авторизується), і покупець потрапляє на сторінку отримання замовлення.

Якщо сума кошика змінилася після схвалення, нічого не захоплюється. Покупець бачить Сума замовлення змінилася після того, як ви схвалили платіж у PayPal. Натисніть кнопку PayPal ще раз, щоб схвалити нову суму. Якщо бракує поля оформлення, схвалення зберігається: після виправлення покупець натискає Place order, щоб завершити оплату. Якщо PayPal відхиляє платіж, покупцеві пропонують натиснути кнопку PayPal та обрати інший спосіб оплати. Якщо покупець закриває вікно PayPal, на оформленні замовлення з'являється Ви скасували платіж PayPal.

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

Спосіб оплати працює в класичному оформленні замовлення, у блоці Checkout і на сторінці Pay for order. Скрипт PayPal завантажується у власному просторі імен, тому не конфліктує з іншим плагіном PayPal на сторінці. Він сумісний із High-Performance Order Storage (HPOS) у WooCommerce.

У плагіна немає вебхуків PayPal, повідомлень Pay Later, полів для картки, налаштувань Venmo, Apple Pay, Google Pay чи Fastlane, збережених способів оплати або підписок, а також кнопок на сторінках товарів і кошика. Використовується адреса доставки, введена на оформленні замовлення WooCommerce, а не адреса з PayPal.

Замовлення та повернення коштів

Order statuses

Pending payment: замовлення створено, але платіж ще не захоплено, наприклад після невідомої відповіді PayPal.

Processing: захоплення завершено. Замовлення, що містять лише віртуальні товари для завантаження, переходять у статус «Виконано», типовий для WooCommerce. Примітка до замовлення показує суму, замовлення PayPal і захоплення. Ідентифікатор транзакції — це ідентифікатор захоплення PayPal; на екрані замовлення він посилається на платіж у вашому обліковому записі PayPal (sandbox або робочий режим).

On hold: платіж авторизовано і він очікує на захоплення (платіжна дія Authorize); або захоплення має статус PENDING у PayPal, наприклад на перевірці платежу; або сплачена сума чи валюта відрізняються від замовлення; або платіж не вдалося прочитати у відповіді PayPal. Примітка до замовлення пояснює причину.

Failed: PayPal відхилив захоплення або авторизацію.

Cancelled: авторизацію анульовано за допомогою Void PayPal authorization.

Дії із замовленням

Відкрийте замовлення, оберіть дію в Order actions і натисніть стрілку.

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

Void PayPal authorization: знімає резерв коштів і скасовує замовлення.

Check PayPal payment status: повторно зчитує захоплення зі статусом PENDING. COMPLETED переводить замовлення у статус «Обробляється», DECLINED або FAILED — у статус «Невдало». Захоплення на іншу суму чи валюту залишає замовлення на утриманні з приміткою про невідповідність.

Повернення коштів

Відкрийте замовлення, натисніть Refund, введіть суму і натисніть Refund via PayPal (на кнопці відображається назва вашого способу оплати). Підтримуються повні та часткові повернення. Повернення надсилається до того середовища PayPal, в якому було здійснено платіж (sandbox або робочого), тому облікові дані цього середовища мають бути налаштовані. Причина передається PayPal як примітка для покупця. Якщо PayPal не приймає повернення, WooCommerce показує помилку, і повернення не реєструється. Успішне повернення додається до приміток замовлення з ідентифікатором і статусом повернення PayPal; повернення зі статусом PENDING PayPal завершує пізніше.

Платіж, який лише авторизовано, повернути не можна: натомість використовуйте Void PayPal authorization. Повернення, суперечки та скасування, здійснені в обліковому записі PayPal, не синхронізуються з WooCommerce.

Ліцензійний ключ

Плагін працює з ліцензійним ключем VibeFox із vibefox.net. Блок ліцензії розташований угорі сторінки WooCommerce > Settings > Payments > PayPal (Smart Buttons). Вставте ключ у поле License key і натисніть Activate. Блок показує статус, наприклад дату, до якої ліцензія активна, та ваш домен. Використовуйте Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб видалити його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис vibefox.net.

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє місце для домену: звільніть його у своєму обліковому записі vibefox.net.

Без активного ключа PayPal не показується покупцям на оформленні замовлення. Якщо платіж все одно розпочато, покупець бачить This payment method is not available. Please choose another one. Адміністратори магазину, які ввійшли в систему, усе ще бачать спосіб оплати з позначкою (unlicensed — visible to admins only), щоб можна було налаштувати та протестувати плагін до покупки ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Існуючі замовлення не зачіпаються: повернення та дії із замовленнями працюють далі.

Коли термін дії ліцензії спливає, плагін продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється у фоновому режимі.

Усунення несправностей

PayPal не з'являється на оформленні замовлення: перевірте, що ліцензія активна, увімкнено Enable/Disable, заповнені Client ID і Secret вибраного режиму, валюта магазину підтримується PayPal і сума кошика більша за нуль. Сторінка налаштувань показує попередження, коли проблема в облікових даних або валюті. Розширення браузера, яке блокує www.paypal.com, також приховує кнопку.

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

PayPal зараз недоступний: облікові дані неправильні або належать до іншого режиму. Скопіюйте Client ID і Secret правильного застосунку ще раз.

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

Замовлення на утриманні після оплати: прочитайте примітку до замовлення. Платіж було авторизовано (захопіть його через Capture PayPal payment), захоплення має статус PENDING у PayPal (пізніше використайте Check PayPal payment status), або сплачена сума чи валюта не збіглися із замовленням.

Захоплення авторизації не вдається: авторизація може бути старшою за 29 днів або вже анульованою. Примітка до замовлення показує помилку PayPal.

Повернення не вдається: у замовлення немає захоплення PayPal (лише авторизація), або бракує облікових даних того середовища, в якому здійснено платіж. Розробники можуть змінити список валют фільтром wc_plg_supported_currencies.

Блок ліцензії показує помилку: дотримуйтеся повідомлення в блоці. Наприклад, якщо ключ уже використовується на іншому домені, звільніть місце у своєму обліковому записі vibefox.net і натисніть Check now. Якщо адреса сайту змінилася, натисніть Check now, щоб активувати ключ для нового домену. Якщо сервер ліцензій недоступний, плагін продовжує працювати з останнім відомим статусом.

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть його на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу та кешовані токени доступу PayPal видаляються, лише якщо була увімкнена опція Delete data on uninstall. Інакше вони зберігаються для повторного встановлення. Існуючі замовлення зберігають свої платіжні примітки, ідентифікатори транзакцій і ідентифікатори PayPal.

PayPal є торговельною маркою її власника. Цей плагін не пов'язаний із PayPal і не схвалений PayPal.