Paid Memberships Pro Add PayPal Express Option at Checkout - Плагин WordPress

Руководство по настройке Paid Memberships Pro Add PayPal Express Option at Checkout для существующего membership-сайта

Paid Memberships Pro Add PayPal Express Option at Checkout решает узкую, но важную задачу: добавляет выбор способа оплаты на странице оформления членства Paid Memberships Pro, чтобы пользователь мог оплатить не только через основной карточный шлюз, но и через PayPal Express. Это руководство не повторяет карточку продукта, а показывает, как понять уместность add-on, как подготовить сайт, как настроить PayPal Express как вторичный вариант, как проверить реальную оплату и что делать, если заказы зависают в промежуточных статусах.

Главный контекст сейчас такой: официальный разработчик помечает PayPal Express как устаревающую интеграцию в PMPro и рекомендует переходить на новый PayPal Gateway Add On. Поэтому материал ниже написан не как универсальная инструкция для нового сайта, а как практическая база знаний для владельца уже работающего WordPress-сайта, где PayPal Express был подключён раньше или где нужно безопасно оценить старую схему перед миграцией.

В тексте будут разобраны два уровня решения. Первый - как работает сам Add PayPal Express Option at Checkout: радио-переключатель на checkout, временное сохранение PayPal Express credentials в настройках PMPro, возврат к основному gateway и проверка блока Choose Your Payment Method. Второй - как не потерять платежи: IPN, статусы заказов, тестовые оплаты, recurring levels, ограничения для новых установок и план перехода на современный PayPal Gateway.

Что именно добавляет этот add-on и почему он не заменяет основной gateway

Paid Memberships Pro обычно использует один активный платёжный шлюз для оформления новых membership-уровней. Add PayPal Express Option at Checkout работает иначе: он не просит владельца сайта полностью перейти на PayPal Express, а показывает дополнительный выбор способа оплаты на публичной странице оформления. Пользователь видит блок выбора, выбирает оплату картой через основной gateway или PayPal Express, после чего проходит соответствующий путь оплаты.

Это важно понимать до установки. Add-on полезен не потому, что он “подключает PayPal вообще”, а потому, что он добавляет PayPal Express как вторичный вариант рядом с основным on-site gateway. Если сайт уже принимает карты через Stripe, Authorize.net или другой поддерживаемый шлюз, владелец может оставить этот поток основным и дать части аудитории PayPal как привычную альтернативу.

Механика при этом остаётся зависимой от Paid Memberships Pro и PayPal Express. PMPro создаёт checkout, membership level, order и связь с пользователем. PayPal Express забирает покупателя на сторону PayPal, принимает решение об оплате и возвращает данные обратно через PayPal IPN. Поэтому успешная настройка - это не только “появилась кнопка PayPal”. Нужно проверить, что заказ получает правильный статус, membership активируется, recurring payment не теряется, а IPN не блокируется защитой сайта.

Где появляется результат для пользователя

Публичный результат виден на странице Membership Checkout. На ней появляется блок выбора метода оплаты, обычно с вариантами вроде оплаты картой и оплаты через PayPal Express. В официальных скриншотах add-on показан как блок выбора payment method, а не как отдельная корзина, отдельный каталог или самостоятельный checkout-конструктор.

Если после установки пользователь не видит выбора, это не всегда означает поломку add-on. Возможны более простые причины: PayPal Express выбран как основной gateway, PayPal Express credentials не были сохранены, checkout смотрится не для платного уровня, страница кешируется, тема переопределяет шаблон checkout или add-on не активирован.

Почему настройка проходит в два шага

Официальная инструкция требует сначала временно выбрать PayPal Express как основной gateway, сохранить его данные, а затем вернуться к своему основному gateway. На первый взгляд это выглядит странно, но логика понятна: Paid Memberships Pro должен получить и сохранить credentials PayPal Express в базе настроек, после чего Add PayPal Express Option at Checkout сможет использовать их как вторичный путь оплаты.

Ключевая проверка: после сохранения PayPal Express нужно вернуть основной gateway обратно. Сам add-on официально работает только когда основной gateway не является PayPal Express.

Кому подходит Paid Memberships Pro Add PayPal Express Option at Checkout, а кому лучше выбрать другой путь

Этот add-on стоит рассматривать очень избирательно. Его сильная сторона - он даёт пользователю выбор на checkout без полной смены основного платёжного шлюза. Его слабая сторона - PayPal Express как gateway уже считается устаревающей интеграцией, а новые сайты могут не иметь технической возможности получить нужные PayPal Express credentials. Поэтому решение зависит не от общего желания “добавить PayPal”, а от текущего состояния сайта.

Подходит для существующего сайта с уже подключённым PayPal Express

Самый логичный сценарий - действующий membership-сайт, где PayPal Express уже был подключён ранее, credentials сохранены, IPN работает, а владелец хочет оставить PayPal для части аудитории, пока новые пользователи или другие уровни идут через основной gateway. В таком случае add-on помогает снизить трение на checkout: участник выбирает знакомый PayPal, а сайт не отказывается от карточного потока.

Подобная схема особенно уместна для сайтов с международной аудиторией, онлайн-курсами, закрытыми сообществами, платными рассылками, ассоциациями и клубами, где часть пользователей доверяет PayPal больше, чем прямому вводу карты на сайте. Но даже здесь стоит сразу планировать будущий переход, потому что старый PayPal Express не должен становиться долгосрочной новой точкой роста.

Не лучший выбор для нового проекта

Если сайт только запускается, лучше смотреть на новый PayPal Gateway Add On или Stripe. По официальным материалам PMPro, PayPal Express переведён в устаревающий режим, а новый PayPal Gateway использует современный подход, автоматическую webhook-настройку и отдельный экран credentials. Для нового сайта попытка строить процесс вокруг PayPal Express может привести к тупику уже на этапе получения API Username, API Password и API Signature.

Практический вывод простой: если у вас нет ранее созданных PayPal Express API credentials, не начинайте проект с этого add-on. Используйте его только если вы обслуживаете уже работающую установку и понимаете, зачем сохраняете старый платёжный путь.

Кому продукт может помешать

Есть ситуации, где дополнительный payment method ухудшает контроль:

• Сайт требует единого gateway для отчётности, бухгалтерии и автоматизации.
• Команда не готова отслеживать разные типы подписок и разные gateway IDs в заказах.
• В checkout уже есть сложные кастомные поля, скидки, custom profile start dates или интеграции, которые нужно проверять для каждого payment path отдельно.
• Публичная часть сайта сильно кешируется, а команда не умеет исключать checkout, account и confirmation pages.
• Нужно принимать новые PayPal-платежи на свежем сайте без старых PayPal Express credentials.

В этих случаях лучше не добавлять дополнительную развилку на checkout, а сначала выбрать один современный gateway, настроить его до конца и проверить весь путь пользователя.

Что проверить перед установкой и включением

Перед установкой add-on полезно пройти короткий технический аудит. Он не должен превращаться в бюрократию, но для платёжного checkout каждая мелочь влияет на деньги, доступ участников и поддержку. Если пропустить этот этап, ошибка может проявиться не в админ-панели, а у реального пользователя после оплаты.

База WordPress и Paid Memberships Pro

Проверьте, что основной Paid Memberships Pro установлен, активен и корректно создаёт paid membership levels. Страница Membership Checkout должна быть назначена в настройках PMPro, а платные уровни должны вести именно на неё. Если базовый checkout не работает без PayPal Express, add-on не исправит проблему.

Также проверьте, что на сайте уже выбран основной gateway, который будет оставаться главным после настройки PayPal Express. Это может быть Stripe или другой gateway, поддерживаемый PMPro. Не начинайте с включения add-on на живом сайте, если основной gateway ещё не прошёл тестовую оплату.

PayPal Business, credentials и IPN

Для PayPal Express нужны PayPal account email, API Username, API Password и API Signature. Кроме того, PayPal должен уметь отправлять IPN на сайт. В документации PMPro IPN URL выглядит как адрес WordPress admin ajax handler: https://yourdomain.com/wp-admin/admin-ajax.php?action=ipnhandler. На реальном сайте домен будет вашим.

Если сайт закрыт HTTP basic authentication, maintenance mode, firewall-правилами или блокировками на уровне хостинга, PayPal может не достучаться до IPN endpoint. Тогда пользователь оплатит, но PMPro не получит сообщение и заказ может остаться в неправильном статусе. Для staging-сайта это особенно важно: PayPal и другие платёжные сервисы должны видеть публичный HTTPS URL.

Страницы, кеш и тема

Membership Checkout, Confirmation, Account, Billing и Order pages лучше исключить из агрессивного кеширования. Визуально кеш может проявляться как “я включил PayPal, но блок выбора не появился”, а технически - как старая версия checkout без актуальных nonce, полей и gateway output. Если используется плагин кеша, CDN или server-side cache, проверьте исключения до теста.

Тема тоже важна. Paid Memberships Pro выводит checkout через свои templates и CSS-классы. Если тема или child theme уже переопределяет PMPro templates, после включения дополнительного payment method нужно проверить, что блок выбора не ломает сетку, не уезжает на мобильном экране и не скрывается CSS-правилом темы.

План отката до включения

Перед изменениями подготовьте простой откат: список активных платёжных настроек, скриншот current payment settings, доступ к админ-панели, возможность отключить add-on и резервную копию базы. Не нужно делать сложную миграцию ради одного теста, но для payment checkout всегда должен быть понятный путь назад.

Установка add-on и первичная проверка в WordPress

Установка похожа на другие add-ons Paid Memberships Pro, но проверка должна быть строже, чем у визуального или контентного расширения. Здесь нельзя ограничиться сообщением Plugin activated, потому что настоящая цель - рабочий payment path.

Установка через Add Ons или загрузку ZIP

Если у вас есть доступ к add-on через админ-панель PMPro, откройте Memberships - Add Ons, найдите Add PayPal Express Option at Checkout и нажмите Install Now. После установки активируйте его через экран плагинов или тот же раздел add-ons. Если файл уже получен отдельно, используйте стандартный путь WordPress: Plugins - Add New - Upload Plugin, загрузите ZIP и нажмите Activate.

После активации не переходите сразу к публичному тесту. Сначала откройте список активных плагинов и убедитесь, что основной Paid Memberships Pro тоже активен. Затем проверьте, что в PMPro существуют paid levels, потому что на бесплатных уровнях блок выбора платежа может не иметь смысла.

Первый осмотр checkout без оплаты

Откройте Membership Checkout page в приватном окне браузера, выберите платный уровень и посмотрите, меняется ли форма. На этом этапе не нужно нажимать оплату. Задача - увидеть, что checkout загружается без ошибок, форма не ломается визуально, а рядом с основным способом оплаты появляется выбор PayPal Express.

Если вы видите только старый checkout, проверьте три вещи: add-on активен, PayPal Express credentials были сохранены по официальной двухшаговой схеме, основной gateway не равен PayPal Express. Если все три условия выполнены, очистите кеш и проверьте страницу без входа в админ-панель.

Подробная настройка: как сохранить PayPal Express и вернуть основной gateway

Это главный раздел руководства, потому что именно здесь чаще всего ошибаются. Add-on требует настроить PayPal Express как будто он основной gateway, но затем вернуть сайт к основному gateway. Если забыть второй шаг, логика add-on ломается: PayPal Express становится не дополнительным вариантом, а главным способом оплаты, и официальный источник прямо предупреждает, что add-on работает только когда primary gateway не PayPal Express.

Шаг 1. Временно выберите PayPal Express

Откройте Memberships - Settings - Payments. В глобальных настройках временно выберите PayPal Express как Payment Gateway. Затем откройте настройки gateway и внесите данные PayPal Express: PayPal account email, API Username, API Password и API Signature. Сохраните настройки.

Зачем это нужно: PMPro должен записать PayPal Express credentials в свои настройки. Без этого add-on не сможет использовать PayPal Express как secondary option, даже если сам add-on активирован. Не вводите произвольные данные и не оставляйте старые тестовые значения в live environment.

Что выбрать для среды

Если вы на staging-сайте, используйте sandbox credentials и Sandbox/Testing, если соответствующая среда доступна для gateway. Если вы проверяете live-сайт, не переводите работающий checkout в sandbox в часы реальных оплат: это меняет режим для всего сайта. Для live-проверки официальный подход PMPro допускает маленькую реальную оплату через discount code, если нужен тест именно боевого gateway.

Шаг 2. Верните основной gateway

На той же странице верните Payment Gateway к основному варианту сайта. Это может быть Stripe или другой рабочий gateway. Снова нажмите Save Settings. Теперь PayPal Express credentials остаются сохранёнными, но основной checkout возвращается к вашему обычному способу оплаты.

Не пропускайте этот шаг. Если PayPal Express останется primary gateway, вы не тестируете сценарий Add PayPal Express Option at Checkout. Вы просто переводите весь сайт на PayPal Express, а add-on не выполняет свою главную роль - показывать дополнительный выбор.

Шаг 3. Настройте IPN в PayPal

В PayPal Business account откройте настройки Website Payments и Instant Payment Notification. Вставьте IPN URL вашего сайта, который PMPro использует для обработки сообщений PayPal. Обычно это адрес вида https://yourdomain.com/wp-admin/admin-ajax.php?action=ipnhandler. После сохранения убедитесь, что IPN включён.

IPN особенно важен для recurring payments. Когда подписка создана, последующие платежи обрабатываются на стороне gateway, а сайт получает уведомления. Если IPN не проходит, в PMPro могут не создаваться новые recurring orders, а администратор будет видеть расхождение между PayPal и Memberships - Orders.

Шаг 4. Проверьте confirmation step

В документации PMPro для PayPal Express отдельно упоминается настройка, которая помогает избежать заказов в статусе Review. Перейдите в Memberships - Settings - Payments, откройте настройки PayPal Express и найдите параметр, связанный с пропуском дополнительного подтверждения после PayPal Express. Если ваш checkout застревает в Review, включение Skip the extra confirmation after PayPal Express может убрать лишний шаг возврата.

Смысл настройки такой: часть пользователей после PayPal возвращается на сайт, но не завершает финальное подтверждение. Тогда PMPro видит неполный процесс. Пропуск дополнительного подтверждения снижает риск, что человек оплатил, но не дошёл до последнего клика на сайте.

Шаг 5. Зафиксируйте рабочую конфигурацию

После настройки запишите для себя не сами секреты, а схему: основной gateway, среда, PayPal Express как secondary option, IPN включён, checkout pages исключены из кеша, тестовые уровни проверены. Секреты PayPal не нужно передавать в заметки, тикеты, скриншоты или внешние инструменты.

Мини-итог: правильная конфигурация выглядит так - основной gateway остаётся вашим главным способом оплаты, PayPal Express credentials сохранены, на checkout появился блок выбора, IPN доступен, а заказы после теста переходят в ожидаемый статус.

Как устроен выбор способа оплаты на checkout

Публичная часть add-on выглядит проще, чем внутренняя настройка. Пользователь не видит временный выбор PayPal Express в админ-панели и не знает о сохранённых credentials. Он видит обычный checkout PMPro и блок выбора payment method. Это место важно не только технически, но и с точки зрения доверия: если варианты подписаны непонятно, часть пользователей может решить, что карта недоступна или что PayPal обязателен.

Что должен увидеть участник

На платном membership level пользователь должен увидеть форму с информацией об уровне, account information, billing или payment area и выбором между основным payment method и PayPal Express. В официальных скриншотах add-on показывает вариант без логотипов и вариант с логотипами. Это подтверждает, что основной интерфейс - именно выбор способа оплаты, а не отдельная страница PayPal внутри WordPress.

Если checkout оформлен через тему или page builder, проверьте читаемость блока выбора на desktop и mobile. Радио-переключатель должен быть виден до финальной отправки формы, а подпись PayPal не должна сливаться с соседними полями. Пользователь должен понять, что выбор меняет путь оплаты, а не просто декоративную кнопку.

Что зависит от PayPal, а не от add-on

PayPal может показывать разные способы оплаты внутри своей hosted payment page. Для one-time payments иногда доступен guest checkout без PayPal account, но его показ зависит от условий PayPal: страны, устройства, cookies, безопасности, email и других факторов. Для subscriptions PayPal account обычно требуется, хотя оплату можно финансировать привязанной картой или банковским счётом.

Поэтому в статье на сайте не стоит обещать, что любой пользователь всегда оплатит PayPal Express без аккаунта PayPal. Корректнее объяснять так: checkout даёт вариант PayPal Express, а доступные способы внутри PayPal определяет PayPal. Это снижает количество спорных обращений в поддержку.

Почему логотипы и подписи лучше проверять осторожно

PMPro публиковал code recipe для добавления credit card и PayPal logos к блоку выбора payment method. Но связанные gist-материалы помечают часть CSS как legacy для старых шаблонов PMPro. Поэтому безопасный подход такой: используйте официальную актуальную статью как ориентир, но не копируйте старый CSS вслепую на современную установку.

Если нужно улучшить визуальную читаемость, начните с минимального CSS в Appearance - Customize - Additional CSS или в child theme, протестируйте checkout на staging и убедитесь, что radio inputs остаются доступными. Не скрывайте нативные поля и не делайте PayPal визуально единственным очевидным вариантом, если карточная оплата остаётся основной.

Практичные сценарии применения для разных membership-сайтов

У add-on нет десятков режимов, но он меняет важную точку пути пользователя - момент оплаты. Поэтому практические сценарии лучше описывать не как “включите PayPal”, а как разные решения для сайтов с разной аудиторией и разной моделью подписки.

Онлайн-курс с международной аудиторией

Для образовательного сайта основной gateway может быть удобен для карт, Apple Pay или локальных способов оплаты, а PayPal Express - для пользователей, которые уже привыкли платить через PayPal. В этом сценарии настройка должна проверяться на двух типах уровней: one-time доступ к курсу и recurring subscription, если курс продаётся как ежемесячное членство.

Ожидаемый результат: ученик выбирает PayPal, оплачивает, возвращается на confirmation page и получает доступ к закрытым урокам. Быстрая проверка - открыть Memberships - Orders, найти заказ, убедиться в gateway, статусе и membership level, затем зайти тестовым пользователем в закрытый урок.

Ассоциация или клуб с ежегодными взносами

Для ассоциаций PayPal часто важен как привычный способ оплаты взноса, особенно если часть участников не хочет вводить карту на сайте. Здесь нужно отдельно проверить renewal logic. Если годовой уровень создаёт recurring subscription, повторные платежи будут зависеть от PayPal и IPN, а не от ручного действия администратора.

Ожидаемый результат: первичный заказ успешен, subscription ID виден в заказе или gateway information, а IPN не блокируется. Если участник оплатил, но доступ не активировался, сначала проверяйте order status и gateway messages, а не права доступа к контенту.

Платная рассылка или закрытое сообщество

Для контентного продукта с низким порогом входа добавление PayPal Express может снизить сомнения пользователя в момент оплаты. Но здесь особенно важна простота checkout. Если на странице слишком много кастомных полей, upsell-блоков и визуальных элементов, дополнительный payment method может запутать пользователя.

Практическая проверка - пройти checkout как новый пользователь без входа в админ-панель и оценить, понятно ли, где выбирается PayPal, где создаётся account, где пользователь принимает условия и куда он попадает после оплаты. Если путь требует объяснений в отдельном письме, checkout стоит упростить.

Сайт с миграцией на новый PayPal Gateway

Для сайта, где уже есть старые PayPal Express subscriptions, add-on может оставаться частью переходного периода. Новые checkouts постепенно переводятся на современный PayPal Gateway или Stripe, а старые PayPal Express подписки продолжают обрабатываться через старую систему до тех пор, пока владелец не переведёт участников на новый payment path.

Здесь важно не обещать автоматическую миграцию старых подписок. Официальные материалы PMPro объясняют, что PayPal Express subscriptions и новые PayPal subscriptions построены на разных системах. Поэтому практическая задача администратора - разделить старые и новые потоки, вести учёт gateway в заказах и заранее продумать коммуникацию с участниками.

Практический пример: добавить PayPal Express как второй вариант для платного уровня

Ниже пример для сайта, где основной gateway уже настроен и работает, а PayPal Express credentials были созданы раньше. Цель - дать пользователю выбор на checkout и проверить, что PayPal-путь не ломает membership-доступ.

Цель

Получить checkout, где новый участник выбирает между оплатой через основной gateway и PayPal Express. После оплаты заказ должен появиться в PMPro, member level должен активироваться, а пользователь должен попасть на confirmation page или получить понятное сообщение о результате.

Подготовка

• Paid Memberships Pro установлен, активен и уже обслуживает хотя бы один paid level.
• Основной gateway настроен и прошёл тестовую покупку.
• PayPal Express credentials доступны и соответствуют нужной среде.
• Checkout page не кешируется и доступна по HTTPS.
• Есть discount code для маленькой live-проверки, если sandbox не подходит.

Шаги

1. Установите и активируйте Paid Memberships Pro Add PayPal Express Option at Checkout.
2. Откройте Memberships - Settings - Payments и временно выберите PayPal Express как Payment Gateway.
3. Введите PayPal account email, API Username, API Password и API Signature, затем нажмите Save Settings.
4. Верните основной gateway сайта в поле Payment Gateway и снова сохраните настройки.
5. Настройте IPN в PayPal и убедитесь, что endpoint PMPro доступен извне.
6. Откройте checkout в приватном окне, выберите платный level и убедитесь, что появился блок выбора payment method.
7. Пройдите оплату через PayPal Express на маленькую сумму или в sandbox, если тестовая среда настроена корректно.
8. Проверьте Memberships - Orders, профиль тестового пользователя и доступ к закрытой странице.

Проверка результата

Рабочий результат состоит из нескольких признаков, а не из одного “платёж прошёл”. На публичной стороне пользователь должен увидеть confirmation page или понятное завершение checkout. В админ-панели PMPro должен появиться order со статусом, gateway information и transaction ID. В профиле пользователя должен быть нужный membership level. В закрытом контенте доступ должен соответствовать уровню.

Если one-time level работает, но recurring level вызывает сомнения, проведите отдельную проверку subscription flow. Не отменяйте тестовую подписку сразу после первого платежа, если ваша цель - убедиться, что recurring notification приходит корректно. В официальных рекомендациях PMPro recurring payment проверяется отдельно, потому что он зависит от gateway notifications.

Нюанс, который чаще всего мешает

Самая распространённая ошибка - считать появление PayPal на checkout финальным успехом. На самом деле это только визуальный этап. Для платежного add-on финальный успех - это совпадение трёх вещей: заказ в PMPro, подтверждение в PayPal и активный membership-доступ у пользователя.

Проверка заказов, IPN и recurring payments после запуска

После включения add-on администратору нужно научиться читать результат в PMPro. Это несложно, но важно знать, где смотреть. PMPro создаёт orders для checkout и recurring payments, а в заказе можно увидеть gateway, environment, transaction IDs, payment method и status. Эти поля помогают отличить проблему checkout от проблемы IPN, PayPal или доступа к контенту.

Какие статусы смотреть первыми

Откройте Memberships - Orders. Для успешного checkout ожидается статус Success. Статус Review часто связан с PayPal Express offsite checkout, когда пользователь вернулся с PayPal, но не завершил подтверждение на сайте. Статус Token или отсутствие recurring order может указывать на проблему с уведомлениями gateway или незавершённым процессом.

Не редактируйте заказы вручную как первый способ исправления. Сначала выясните причину: был ли платёж в PayPal, дошёл ли IPN, не блокировал ли сайт gateway request, не была ли включена sandbox-среда на живом сайте, не ушёл ли пользователь с confirmation step.

Как сверять PayPal и PMPro

Для каждого спорного заказа полезно сверить четыре точки:

• В PayPal есть платеж или subscription.
• В PMPro есть order с тем же пользователем и уровнем.
• В order details указан gateway и transaction ID.
• Пользователь получил правильный membership level и доступ к закрытому контенту.

Если PayPal показывает оплату, а PMPro молчит, фокус смещается к IPN, доступности сайта и логам. Если PMPro создал order, но доступ не появился, проверяйте membership level, статус заказа и возможные customizations, которые меняют поведение checkout.

Почему recurring payments живут на стороне gateway

В PMPro recurring payment не создаётся как новый ручной запрос с сайта каждый месяц. Подписка создаётся на стороне gateway, а затем gateway сообщает сайту о событиях через webhook или IPN. Это хорошая архитектура, потому что сайт не хранит чувствительные платёжные данные и не должен инициировать каждый повторный платёж сам.

Но у такой архитектуры есть последствие: если PayPal IPN не проходит, recurring payment может быть оплачен в PayPal, но не отразиться как новый order в PMPro. Поэтому IPN-доступность и проверка orders после первого recurring event важнее косметики checkout.

Безопасные улучшения и аварийное отключение PayPal-опции

Для этого add-on не стоит придумывать сложные доработки. Платёжный checkout - не место для экспериментального JavaScript, скрытых полей и агрессивных CSS-хаков. Но есть два безопасных направления: аккуратная визуальная проверка блока payment method и временное отключение PayPal option через документированный PMPro filter, если нужно быстро убрать PayPal Express с checkout без деактивации всей связанной конфигурации.

Минимальная визуальная доработка без риска для логики

Если блок выбора payment method плохо читается в вашей теме, начните с проверки стандартных классов и официальной статьи PMPro о логотипах на checkout. Из-за изменений шаблонов старые CSS-recipes могут не подходить современным версиям PMPro, поэтому используйте их как источник идеи, а не как обязательный код для копирования. Лучший порядок такой: staging, backup, минимальный CSS, проверка desktop/mobile, тест checkout.

Не скрывайте radio input через display: none, не заменяйте submit-кнопки на кастомный скрипт и не делайте PayPal визуально единственным крупным вариантом. Платёжный выбор должен оставаться доступным для клавиатуры и screen readers.

Временный kill switch через официальный filter

PMPro документирует filter pmpro_include_payment_option_for_paypal, который управляет включением PayPal option. Такой snippet можно использовать как временный аварийный выключатель, если PayPal Express начал давать сбои, а основной gateway продолжает работать. Добавляйте его через Code Snippets или небольшой customizations plugin, не в файлы ядра PMPro и не в обновляемую тему.

add_filter( 'pmpro_include_payment_option_for_paypal', '__return_false' );

После включения snippet откройте checkout в приватном окне и убедитесь, что вариант PayPal Express исчез, а основной gateway продолжает оформлять paid level. Чтобы откатить изменение, отключите snippet и очистите кеш checkout. Этот код не чинит PayPal и не мигрирует подписки, он только временно убирает option с формы.

Когда использовать: если PayPal Express вызывает сбои у новых пользователей, но вы не хотите трогать существующие gateway credentials до полноценной диагностики или миграции.

Как планировать переход на новый PayPal Gateway или Stripe

Раздел о миграции нужен не потому, что add-on бесполезен, а потому что его базовая технология устаревает. Для действующих сайтов это не обязательно означает немедленную остановку. Официальные материалы PMPro говорят, что уже подключённые PayPal Express подписки могут продолжать работать, пока PayPal поддерживает старый API. Но новые подключения и долгосрочная стратегия должны смотреть в сторону современного PayPal Gateway или Stripe.

Разделите старые и новые платежные потоки

Сначала составьте карту: какие участники платят через PayPal Express, какие через основной gateway, какие уровни one-time, какие recurring. В PMPro для этого помогают orders, gateway fields и transaction IDs. Не смешивайте миграцию с редизайном checkout, изменением цен и массовыми правками уровней. Чем меньше переменных, тем легче понять, что пошло не так.

Не обещайте автоматическую миграцию подписок

PayPal Express subscriptions и подписки нового PayPal Gateway построены на разных системах PayPal. Поэтому нельзя просто переключить gateway и ожидать, что старые recurring subscriptions переедут незаметно. Часть участников может продолжить платить через старый PayPal Express, а новые checkout будут проходить через новый gateway. Если нужно перевести участника, обычно требуется новый checkout или согласованный сценарий смены payment method.

Проверьте Stripe как основной вариант

PMPro отдельно рекомендует Stripe для многих membership-сайтов, особенно там, где recurring subscriptions являются ядром бизнеса. Если аудитория не требует PayPal как обязательный вариант, основной gateway через Stripe может быть проще для поддержки и диагностики. Но это не универсальный ответ: регион, валюта, привычки аудитории и бухгалтерские процессы тоже важны.

Сделайте переход через тестовый уровень

Перед массовым изменением создайте тестовый membership level или используйте низкую live-сумму с discount code. Проверьте новый gateway от начала до конца: checkout, confirmation page, order, email, member access, cancellation path, recurring event. Только после этого убирайте старый PayPal Express option для новых пользователей.

Почему PayPal Express не появляется или заказ зависает: диагностика по симптомам

Проблемы с этим add-on обычно делятся на две группы. Первая - визуальная: блок выбора не появился, PayPal не виден, оформление сломалось. Вторая - платёжная: пользователь оплатил, но заказ не завершился, membership не активировался или recurring order не появился. Диагностику лучше вести от простого к сложному.

Блок Choose Your Payment Method не появился

Симптом: checkout выглядит как раньше, PayPal Express не предлагается. Возможная причина - add-on не активирован, PayPal Express credentials не сохранены, PayPal Express оставлен primary gateway или checkout page отдаётся из кеша.

Что проверить: список активных plugins, Memberships - Settings - Payments, текущий primary gateway, наличие paid level, приватное окно браузера и исключения checkout из кеша. Исправление: повторить двухшаговую настройку, вернуть основной gateway, очистить кеш и снова открыть checkout как новый пользователь.

Пользователь возвращается с PayPal, но заказ остаётся в Review

Симптом: в PayPal есть попытка оплаты или пользователь говорит, что завершил PayPal step, но PMPro показывает Review. Для PayPal Express это часто связано с дополнительным confirmation step после возврата на сайт.

Что проверить: настройки PayPal Express в PMPro, наличие опции Skip the extra confirmation after PayPal Express, order details, поведение checkout в приватном окне. Исправление: включить пропуск лишнего подтверждения, сохранить настройки и провести новый тест. Если заказ уже спорный, сначала сверить PayPal transaction, а не менять статус вслепую.

Оплата есть в PayPal, но recurring order не появился в PMPro

Симптом: gateway списал повторный платёж, но в Memberships - Orders нет нового order. Вероятная причина - IPN не дошёл до сайта или был заблокирован защитой, maintenance mode, firewall, basic authentication или недоступным HTTPS.

Что проверить: IPN URL в PayPal, доступность admin-ajax.php?action=ipnhandler, логи хостинга, security plugin, maintenance mode, публичность staging URL. Исправление: открыть gateway notifications для PayPal, убрать блокировку на время теста, сверить IP ranges по документации PayPal и повторить тест. Если сайт закрыт паролем на уровне сервера, настройка исключений должна быть аккуратной и согласованной с хостингом.

Guest checkout в PayPal не показывается

Симптом: пользователь ожидал оплату картой без PayPal account, но PayPal просит войти. Это не всегда ошибка PMPro. PayPal сам решает, когда показывать guest checkout, а для subscriptions PayPal account обычно требуется.

Что проверить: one-time или recurring level, страна и среда теста, настройки PayPal Business, поведение в другом браузере. Исправление: не обещать guest checkout как гарантированный сценарий, использовать основной card gateway для пользователей без PayPal account и описать PayPal как дополнительный вариант, а не единственную карточную оплату.

Checkout выглядит сломанным после добавления логотипов

Симптом: radio buttons уехали, логотипы перекрывают текст, на мобильном блок выбора становится нечитаемым. Вероятная причина - старый CSS recipe, конфликт с темой или переопределённый PMPro template.

Что проверить: custom CSS, child theme, template overrides, PMPro template version notes, мобильный вид. Исправление: отключить CSS, вернуть стандартный блок выбора, затем добавить минимальные правки заново. Если стили не критичны, лучше оставить стандартный checkout, чем рисковать платёжной формой.

После включения sandbox реальные оплаты перестали работать

Симптом: пользователи не могут оформить реальные платежи, хотя администратор “просто тестировал”. Причина - gateway environment меняется для всего сайта. Если живой сайт переведён в Sandbox/Testing, реальные checkout могут перестать проходить.

Что проверить: Gateway Environment в PMPro, время изменения, жалобы пользователей, последние orders. Исправление: вернуть Live/Production, сохранить настройки, очистить кеш и провести минимальный live test. На будущее тестировать sandbox на staging или в off-hours.

Когда стоит использовать Paid Memberships Pro Add PayPal Express Option at Checkout

Этот продукт будет удачным выбором, если у вас уже есть работающий Paid Memberships Pro сайт, основной gateway настроен, PayPal Express credentials были созданы раньше, а аудитории действительно нужен PayPal как дополнительный способ оплаты. В таком сценарии add-on помогает сохранить привычный payment path для части пользователей, не переводя весь checkout на старый PayPal Express.

Если вы запускаете новый сайт, планируете долгосрочную поддержку или только выбираете PayPal-интеграцию, разумнее смотреть на новый PayPal Gateway или Stripe. PayPal Express можно оставить как переходный слой для существующих участников, но не стоит строить вокруг него новую архитектуру.

Перед тем как скачать последнюю версию Paid Memberships Pro Add PayPal Express Option at Checkout, проверьте три вещи: у вас есть реальная причина сохранять PayPal Express, основной gateway уже работает, а команда готова тестировать checkout не только визуально, но и через orders, IPN и membership access. Если эти условия выполнены, add-on можно безопасно проверить на staging или через маленькую live-оплату и затем принять решение по запуску.