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 приложения. Приложения для песочницы и для рабочего режима имеют разные учётные данные. Вебхук не нужен: плагин подтверждает каждый платёж на вашем сервере, пока покупатель находится на оформлении заказа.

Валюта: одна из валют, которые поддерживает 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 (для песочницы и/или рабочего режима) и скопируйте его Client ID и Secret.

4. Откройте настройки: WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage или нажмите Settings под названием плагина на странице Plugins.

5. Введите лицензионный ключ VibeFox в блоке лицензии в верхней части страницы и нажмите Activate.

6. Введите учётные данные режима, который вы используете, выберите Capture или Authorize, включите Enable/Disable и сохраните настройки.

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

Настройка

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

Общие

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 mode: Enable sandbox (test) mode. Платежи отправляются в песочницу PayPal с учётными данными песочницы; реальные деньги не переводятся. По умолчанию: on. Снимите отметку, чтобы принимать реальные платежи.

Sandbox Client ID: Client ID вашего приложения REST API для песочницы.

Sandbox Secret: Secret вашего приложения REST API для песочницы.

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. В режиме песочницы на оформлении заказа отображается сообщение: Режим песочницы: оплатите с тестового аккаунта покупателя PayPal, реальные деньги не списываются. Нажатие на кнопку создаёт на вашем сервере заказ PayPal на сумму корзины (или на сумму заказа на странице Pay for order). Сумма всегда рассчитывается на сервере, никогда в браузере.

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

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

Если PayPal не отвечает во время списания, покупатель видит сообщение Мы пока не можем подтвердить ваш платёж PayPal. Попробуйте ещё раз через минуту — с вас не спишут деньги дважды. Повторная попытка использует то же подтверждение, и если PayPal уже завершил предыдущую попытку, используется этот платёж, а новое подтверждение не списывается.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице 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 (песочница или рабочий режим).

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, в которой был произведён платёж (песочницу или рабочий режим), поэтому учётные данные этой среды должны быть заданы. Причина передаётся 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.