Formidable Stripe - Плагин WordPress

Руководство по настройке Formidable Stripe для платежных форм WordPress

Formidable Stripe нужен не просто для того, чтобы добавить поле оплаты в форму. В реальном проекте он связывает конструктор Formidable Forms, аккаунт Stripe, сумму из полей формы, события оплаты, уведомления и проверку результата в админ-панели WordPress. В этом руководстве разберём именно рабочий сценарий: как подготовить сайт, подключить Stripe, настроить платёжное действие, проверить тестовую оплату, сохранить статус и не потерять заявку из-за ошибки в логике формы.

Материал рассчитан на владельца сайта, администратора WordPress или вебмастера, который уже понимает задачу формы: принять оплату за услугу, регистрацию, пожертвование, подписку, заявку с расчётной стоимостью или доступ к материалу. Здесь нет повторения общей карточки продукта. Вместо этого - практическая инструкция по тому, как пользоваться Formidable Stripe аккуратно и как понять, что платежи проходят корректно.

Сразу важное ограничение: платежные формы нельзя проверять только визуально. Если поле оплаты красиво отображается, это ещё не значит, что сумма уходит в Stripe, статус возвращается в Formidable, а письмо отправляется после успешного платежа. Поэтому руководство строится вокруг цепочки настройка - тестовая отправка - статус платежа - действие после оплаты.

Когда этот плагин действительно решает задачу

Formidable Stripe лучше всего раскрывается там, где нужна не полноценная корзина WooCommerce, а гибкая форма с оплатой. Типичный пример - заявка на консультацию с фиксированной стоимостью, регистрация на событие, донат с произвольной суммой, оплата курса, сервисная заявка с расчётным итогом или подписка, где пользователь выбирает план прямо в форме.

Главная ценность связки Formidable Forms и Stripe в том, что платёж становится частью формы. Пользователь заполняет поля, видит сумму, вводит платёжные данные через Stripe Element, отправляет форму, а администратор получает запись, платёжный статус и может запускать действия после оплаты. Это отличается от простого Payment Link, где форма и платёж часто живут отдельно.

Плагин особенно полезен, если на сайте уже используются Formidable Views, расчётные поля, условная логика, скрытые поля, создание записей или письма по событиям. В такой системе платеж не является отдельной кнопкой. Он становится условием для следующего шага: отправить письмо, опубликовать запись, показать подписку, выдать доступ или сохранить статус в поле.

Подходящие сценарии

• Оплата услуги после заполнения подробной формы заявки.
• Регистрация на мероприятие с разными тарифами, скидками или количеством участников.
• Пожертвование, где сумма выбирается пользователем или рассчитывается из нескольких полей.
• Периодическая подписка на клуб, закрытый раздел, поддержку или обслуживание.
• Форма заказа без корзины, когда WooCommerce избыточен.
• Платная публикация записи, если запись должна переходить из черновика в опубликованный статус только после оплаты.

Когда лучше выбрать другой путь

Если вам нужен полноценный магазин с каталогом товаров, остатками, доставкой, налоговыми зонами, купонами, статусами заказов и личным кабинетом покупателя, чаще удобнее строить процесс на WooCommerce и платёжном шлюзе Stripe для WooCommerce. Если нужна только одна кнопка оплаты без формы, может подойти Stripe Payment Link или отдельный WordPress-плагин для простых Stripe-форм.

Formidable Stripe также может быть лишним, если вся логика оплаты уже реализована во внешнем сервисе. В этом случае добавление ещё одной платежной системы в WordPress увеличит количество точек отказа: форму, Stripe Connect, почту, кэш, защиту, права администратора и обработку статусов.

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

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

Сначала проверьте, что сам Formidable Forms установлен и обновлён, а нужная форма уже существует хотя бы в черновом виде. Затем убедитесь, что сайт работает по HTTPS. Официальная документация Formidable указывает, что для Stripe-форм требуется SSL-соединение, хотя тестирование может выполняться на нешифрованном соединении. Для публичной оплаты полагаться на исключение для теста нельзя.

Минимальный чек-лист перед первым запуском

• На сайте активен Formidable Forms, а нужная форма создана в админ-панели.
• У администратора есть доступ к WordPress и к аккаунту Stripe с ролью, которая позволяет подключать аккаунт через Stripe Connect.
• Сайт доступен по HTTPS, а страницы с оплатой не ломаются из-за смешанного содержимого.
• Известно, какая сумма будет списываться: фиксированная, введённая пользователем или рассчитанная формой.
• Понятно, что должно происходить после оплаты: письмо, запись, подписка, публикация, уведомление или показ статуса.
• Есть тестовая страница, закрытая от случайных посетителей, где можно отправить форму без риска для реальных пользователей.

Практическое правило: не подключайте Formidable Stripe сразу на боевой форме, если ещё не решили, где будет храниться статус платежа и какое действие должно сработать после успешной оплаты.

Совместимость с темой, кэшем и защитой

Платёжные формы чувствительны к скриптам. Если тема агрессивно оптимизирует JavaScript, кэш-плагин откладывает скрипты, а защита сайта проверяет POST-запросы слишком жёстко, форма может выглядеть нормально, но не обработать оплату. До тестов отключать всё подряд не нужно. Достаточно заранее знать, где находятся настройки кэша, исключения страниц и журнал ошибок.

Для страницы с оплатой обычно разумно не включать агрессивное объединение, задержку или перенос скриптов, если после этого Stripe Element перестаёт загружаться. Это не значит, что весь сайт должен работать без оптимизации. Оптимизация платежной страницы проверяется отдельно: сначала платеж проходит стабильно, затем постепенно возвращаются улучшения скорости.

Установка, активация и подключение через Stripe Connect

Установка начинается в WordPress, но ключевой этап происходит не в поле с секретными ключами, а в подключении Stripe Connect. По актуальной документации Formidable Stripe использует Stripe Connect, чтобы администратору не приходилось вручную хранить API-ключи в открытом виде внутри сайта. Это снижает риск ошибок при копировании ключей и делает подключение более управляемым.

Общий маршрут такой: установите Formidable Forms, включите Stripe-интеграцию или отдельный Stripe add-on, перейдите в глобальные настройки платежей, откройте вкладку Stripe и нажмите Connect to Stripe. Подключение нужно выполнить отдельно для тестового и рабочего режима. Это удобно: можно сначала прогнать тестовые платежи, затем переключить форму на реальную среду только после проверки.

Как понять, что подключение прошло успешно

После авторизации в Stripe пользователь возвращается на сайт. В настройках Formidable должна появиться отметка состояния подключения. Не ограничивайтесь тем, что кнопка исчезла или страница закрылась. Проверьте именно статус соединения и режим, в котором вы находитесь. Для платежной формы особенно важно не перепутать тестовую и рабочую связку.

1. Откройте Formidable → Global Settings → Payments.
2. Перейдите на вкладку Stripe.
3. Проверьте статус подключения и выбранный режим.
4. Для тестов включите тестовый режим и сохраните настройки.
5. После проверки повторите подключение для рабочего режима, если форма должна принимать реальные платежи.

Документация Formidable отдельно отмечает, что вебхуки при такой интеграции покрываются автоматически и не требуют ручной настройки. Это не отменяет диагностику: если статус оплаты не возвращается, всё равно нужно смотреть журнал Formidable, журнал Stripe и состояние сайта. Но для базового запуска администратору не нужно создавать endpoint вручную.

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

Не вставляйте в форму секретные ключи, не передавайте доступы подрядчикам без необходимости и не храните платёжные данные пользователей в обычных полях формы. Платёжные данные должны обрабатываться Stripe. В Formidable можно хранить запись, сумму, статус, идентификатор платежа и другие служебные сведения, но не полный номер карты.

Если кнопка подключения не открывает Stripe или зависает, сначала проверьте, доступен ли серверу исходящий запрос, включён ли cURL и не блокирует ли хостинг связь с сервисами Formidable. Официальная документация связывает такие сбои с сетевыми ограничениями, корпоративным экраном или блокировкой на стороне сервера.

Как собрать форму оплаты без лишней корзины

После подключения Stripe главная работа переносится в саму форму. В редакторе Formidable добавьте поля, которые объясняют пользователю, за что он платит: имя, email, выбор тарифа, количество, комментарий, скрытый служебный статус или расчётную сумму. Затем добавьте Payment field. Документация подчёркивает, что автоматически добавленное поле Payment method обязательно для обработки платежа, поэтому его нельзя удалять или ломать условной логикой.

В Formidable Stripe сумма может быть фиксированной или приходить из поля формы. Если сумма рассчитывается, она должна быть числовой. Ошибка "Please specify an amount for the payment" часто возникает как раз тогда, когда в поле суммы попадают символы валюты, запятые, текст или неправильный shortcode. Поэтому перед подключением платежного действия полезно проверить сумму отдельно: меняется ли итог при выборе опций и остаётся ли он числом.

Поля, которые обычно нужны

• Поле email, потому что оно помогает сопоставлять пользователя, отправлять подтверждение и запускать Stripe Link.
• Поле выбора тарифа или услуги, если сумма зависит от варианта.
• Поле количества, если пользователь может оплатить несколько мест, билетов или единиц услуги.
• Расчётное поле, если сумма складывается из нескольких условий.
• Скрытое поле статуса платежа, если дальше нужно фильтровать записи или показывать результат через View.
• Payment field, который отвечает за платёжный ввод и не должен удаляться после создания Stripe action.

Сумма: фиксированная или расчётная

Фиксированная сумма проще. Она подходит для одной услуги, одного билета, стандартного взноса или оплаты заявки. Расчётная сумма удобнее, если пользователь выбирает план, количество участников, дополнительные опции или произвольный донат. Но расчётная сумма требует больше тестов, особенно если включены Apple Pay, Google Pay, Stripe Link или многостраничная форма.

Для динамических сумм безопаснее делать отдельное видимое поле итога, чтобы пользователь понимал, что будет списано. Если итог скрыт, администратор может не заметить ошибку формулы до первой жалобы. Хорошая форма оплаты всегда отвечает на три вопроса: за что платит пользователь, сколько списывается и что произойдёт после оплаты.

Как проверить расчёт до подключения оплаты

Перед тем как привязывать Stripe action к сумме, отправьте форму без реального платёжного сценария или проверьте её в предварительном просмотре. Меняйте варианты тарифа, количество и дополнительные опции, затем смотрите, остаётся ли итог числом. Если поле показывает красиво оформленную строку вроде "$49.00" или "49 рублей", для пользователя это удобно, но для Amount в платежном действии может понадобиться чистое числовое значение.

Хорошая практика - разделять отображение и служебную сумму. Видимое поле может объяснять пользователю расчёт, а служебное поле передаёт Stripe число без лишних символов. Если такой схемы нет, хотя бы проверьте каждый вариант выбора вручную, особенно крайние случаи: нулевая сумма, скидка, максимальное количество и вариант с несколькими добавленными услугами.

Платёжное действие: сумма, описание, валюта и момент списания

Платёжное действие создаётся в настройках формы: Settings → Actions & Notifications. В разделе электронной коммерции выбирается действие Stripe. Именно это действие связывает поля формы с платежом: задаёт название, описание, сумму, тип платежа, валюту, данные клиента, условную логику и действия после оплаты.

Название действия видно в админ-панели, поэтому не называйте все действия одинаково. Если в форме есть несколько сценариев, используйте понятные внутренние названия: "Разовая оплата консультации", "Подписка клуба", "Донат", "Оплата только картой". Это поможет при диагностике, когда нужно найти payment action ID или понять, какое действие сработало.

Ключевые параметры действия

Когда использовать условную логику

Условная логика нужна, если платежное действие должно запускаться не всегда. Например, пользователь выбирает "Оплатить картой" или "Оплатить наличными". В этом случае не стоит прятать Payment method field сложной логикой без понимания последствий. Надёжнее настроить условие на самом Stripe action: действие выполняется только при выборе оплаты картой.

Если в форме несколько платёжных планов, каждое действие должно иметь своё условие. Иначе можно получить два списания или запуск неверного сценария. Одна форма может быть сложной, но каждое платёжное действие должно иметь ясное условие запуска.

Момент обработки записи

В настройках Stripe есть выбор, когда обрабатывать разовые платежи: до создания записи или после её создания. Для некоторых условных сценариев документация Formidable рекомендует вариант after entry is created. Практический смысл такой: если форма опирается на данные записи, статус, условные действия или последующую обработку, важно понимать, в какой момент запись уже существует.

Не меняйте эту настройку ради эксперимента на рабочей форме. Сначала повторите сценарий на тестовой форме: отправка, платёж, запись в Formidable, статус в Payments, email после успешной оплаты. Если при смене порядка обработки пропадает письмо или запись, верните предыдущую настройку и разберите цепочку событий.

Что считать безопасным откатом

Безопасный откат - это не удаление Stripe action на рабочей форме в разгар тестов. Сначала сохраните текущую конфигурацию, затем изменяйте один параметр: момент обработки, сумму, условие запуска или After Payment. Если тест ухудшился, верните только этот параметр. Такой подход особенно важен для форм с несколькими тарифами, потому что исправление одной ветки может незаметно сломать другую.

Если форма уже принимает реальные заявки, лучше создать копию формы и страницы. В копии можно проверить новый порядок обработки, новую сумму или Link, не рискуя текущими платежами. После успешного теста переносите изменения в основную форму по списку, а не вручную на память.

Recurring, Stripe Link и дополнительные способы оплаты

Formidable Stripe поддерживает не только разовые платежи. В документации описаны recurring-платежи, trial period, recurring payment limit, Stripe Link, дополнительные платежные методы, а также ручной захват платежа для сценариев, где списание нужно завершить позже. Эти возможности полезны, но они требуют более строгой проверки, чем простая разовая оплата.

Recurring-сценарий применяют для клубов, подписок, обслуживания, регулярных пожертвований или доступа к закрытому разделу. В настройке нужно выбрать тип платежа, период повторения и, при необходимости, ограничение количества списаний. Если форма связана с доступом пользователя, обязательно решите, как он будет видеть статус подписки и как сможет обновить карту.

Stripe Link

Stripe Link ускоряет повторную оплату за счёт сохранённых платёжных данных в сети Link. В Formidable его можно включить в Stripe action вместе с дополнительными платежными методами. Документация предупреждает, что Link action не совместим с другими Stripe actions в одной форме, поэтому для Link не стоит строить форму с несколькими параллельными Stripe-действиями.

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

Ручной захват платежа

В некоторых задачах платёж сначала авторизуют, а списывают позже. Это подходит для бронирований, заявок на услугу после проверки, предзаказов или ситуаций, где администратор должен подтвердить готовность выполнить заказ. В Formidable такая функция относится к расширенным возможностям. После авторизации платеж появляется со статусом, который нужно вручную довести до завершения.

Этот режим нельзя включать "на всякий случай". Если команда не проверяет авторизованные платежи регулярно, деньги могут не быть списаны вовремя. В форме, письмах и внутреннем процессе должно быть ясно, кто и когда выполняет захват.

Практический пример: оплата консультации с подтверждением после платежа

Рассмотрим рабочий пример, который легко адаптировать под услугу, регистрацию, аудит сайта или платный разбор. Цель - создать форму, где пользователь выбирает тип консультации, видит итоговую сумму, оплачивает через Stripe, а администратор получает письмо только после успешной оплаты. Это полезнее, чем отправлять уведомление сразу после создания записи, потому что незавершённая оплата не должна запускать рабочий процесс.

Цель

Нужно получить форму "Оплата консультации": имя, email, выбор формата, итоговая сумма, поле оплаты и скрытый статус платежа. После успешной оплаты в записи сохраняется статус, а администратор получает письмо с деталями заявки. Если платеж не прошёл, письмо о готовой заявке не отправляется.

Подготовка

• Formidable Forms установлен и подключён к Stripe в тестовом режиме.
• Создана тестовая страница, где опубликована форма.
• В форме есть варианты услуги: короткая консультация, расширенный разбор, срочная заявка.
• Сумма рассчитывается формой или задаётся в Stripe action через выбранное поле.

Шаги настройки

1. Создайте новую форму или откройте существующую форму заявки.
2. Добавьте поля Name, Email, выбор формата консультации и поле итоговой суммы.
3. Добавьте скрытое поле "Статус платежа", чтобы сохранять значение после оплаты.
4. Добавьте Payment field и сохраните форму.
5. Откройте Settings → Actions & Notifications и добавьте Stripe action.
6. В поле Amount укажите расчётное поле или фиксированную сумму.
7. В After Payment добавьте правило: когда статус платежа Completed, записать в скрытое поле значение completed.
8. Создайте email action для администратора и настройте его на событие успешной оплаты, если эта опция доступна в вашей конфигурации.
9. Опубликуйте форму на тестовой странице и выполните тестовую отправку.

Проверка

После отправки формы откройте Formidable → Payments. В тестовой записи должен быть виден платеж, режим теста, сумма и статус. Затем откройте саму запись формы и проверьте скрытое поле статуса. Если email отправляется после успешного платежа, убедитесь, что письмо не уходит при незавершённой оплате.

Ожидаемый результат: запись создана, тестовый платеж появился в списке Formidable Payments, сумма совпадает с формой, статус обновился, а рабочее письмо отправилось только после подтверждения оплаты.

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

Если вы добавили условную логику на Payment method field или удалили автоматически созданное поле, Stripe может не получить нужные данные. В таком случае в логах может появиться статус requires_payment_method или платеж просто не будет создан. Исправление обычно начинается не со Stripe, а с восстановления поля оплаты и повторного создания Stripe action.

Как проверить результат перед публикацией формы

Проверка Formidable Stripe должна идти в двух местах: в пользовательской форме и в админ-панели. Пользовательская часть показывает, что форма видна, поле оплаты загружается, сумма понятна, а сообщение после отправки не вводит в заблуждение. Админ-панель показывает, что Formidable создал запись, Stripe обработал платеж, статус вернулся, а последующие действия сработали в нужный момент.

Тестовая оплата

В тестовом режиме Stripe можно использовать тестовые карты из официальной документации Stripe. Formidable также описывает базовый тестовый сценарий с номером 4242 4242 4242 4242, будущей датой и любым CVC. Не используйте реальные карты в тестовом режиме и не проверяйте рабочую форму на случайных посетителях.

1. Включите тестовый режим в настройках Stripe для Formidable.
2. Откройте страницу формы как обычный пользователь.
3. Заполните поля так, чтобы сумма была больше минимального тестового значения.
4. Введите тестовую карту и отправьте форму.
5. Проверьте запись в Formidable Entries.
6. Проверьте платеж в Formidable → Payments.
7. Проверьте событие или платеж в Stripe Dashboard.

Что считать успешной проверкой

Успех - это не только сообщение "форма отправлена". Успешная проверка означает, что сумма не изменилась, статус платежа понятен, нужные письма отправлены после оплаты, а лишние действия не запустились. Если у формы есть подписка, проверьте ещё и отображение подписки для пользователя, shortcode [frm-subscriptions], View-фильтр или ссылку на Stripe Customer Portal, если вы используете её для обновления карты.

Если форма использует несколько payment actions, проверяйте каждый путь отдельно. Разовый платёж, подписка, trial, Link и оплата наличными - это разные сценарии. Один успешный тест не доказывает, что остальные ветки формы работают правильно.

После оплаты: письма, статусы, Views и безопасные автоматизации

Самая сильная часть Formidable Stripe - действия после оплаты. Именно здесь форма превращается из платёжного поля в рабочий процесс: письмо отправляется после успешной оплаты, запись публикуется только после завершения платежа, статус сохраняется в скрытом поле, а пользователь видит свои подписки через View или shortcode.

Официальная документация Formidable описывает разные события: successful payment, failed payment, processing payment, canceled subscription, refunded payment и другие статусы. Это позволяет не отправлять подтверждение слишком рано. Например, при некоторых методах оплаты статус может быть processing, и форма должна честно сообщать, что платёж отправлен, но ещё не завершён.

Сохранение статуса в поле

Скрытое поле статуса - простой и полезный приём. Оно помогает фильтровать записи, показывать пользователю результат через View и запускать дополнительные действия. В настройке After Payment можно записать в поле значение при статусе Completed, а при необходимости добавить значения для refunded или canceled. Это особенно полезно, если редактору сайта нужно видеть состояние заявки без перехода в Stripe.

Письма после платежа

Для платёжной формы письмо "заявка принята" лучше привязывать не к созданию записи, а к событию успешной оплаты. Иначе администратор может начать работу по заявке, которую пользователь не оплатил. Для recurring-платежей логика ещё тоньше: успешное продление, неудачное списание и отмена подписки могут требовать разных писем.

Безопасный developer-snippet для внутреннего уведомления

Если вам нужен небольшой технический контроль, можно использовать документированный hook frm_payment_status_complete. Ниже пример для разработчика: он отправляет внутреннее письмо администратору только по конкретному payment action ID. Вставляйте его через Code Snippets или дочернюю тему. Не меняйте ядро WordPress, Formidable Forms или Formidable Stripe.

add_action( 'frm_payment_status_complete', 'site_notify_paid_formidable_entry' );

function site_notify_paid_formidable_entry( $atts ) {
    $target_action_id = 450; // Замените на ID нужного Stripe action.

    if ( empty( $atts['payment'] ) || $target_action_id !== (int) $atts['payment']->action_id ) {
        return;
    }

    if ( 'complete' !== $atts['payment']->status ) {
        return;
    }

    wp_mail(
        get_option( 'admin_email' ),
        'Formidable payment complete',
        'Payment completed for entry ID: ' . (int) $atts['payment']->item_id
    );
}

Проверьте snippet только в тестовом режиме: отправьте форму, убедитесь, что письмо пришло один раз, затем проверьте другой payment action и убедитесь, что он не запускает это уведомление. Откат простой: отключите snippet в Code Snippets или удалите код из дочерней темы. Если вы не уверены в action ID, найдите его в настройках Stripe action, как описано в документации Formidable.

Кодовые доработки не нужны большинству сайтов. Если задача решается через настройку email action, After Payment и скрытые поля, лучше не добавлять PHP. Snippet полезен только там, где внутренний процесс требует точечной автоматизации.

Платёжные методы, суммы и ограничения, которые нельзя игнорировать

Stripe поддерживает много способов оплаты, но доступность конкретного метода зависит от страны, валюты, продукта Stripe и типа платежа. Formidable Stripe может показывать дополнительные способы оплаты и Link, однако это не означает, что любой метод подходит для recurring-платежа или для вашей аудитории. Stripe в своей документации отдельно разделяет поддержку по продуктам и сценариям.

Для администратора это означает простую вещь: если вы включаете дополнительные методы оплаты, тестируйте не только карту. Проверяйте, как ведёт себя форма с кошельками, банковскими методами, redirect-сценариями и processing-статусами, если они доступны в вашем аккаунте. Некоторые методы не завершаются мгновенно, а значит письма и статусы должны учитывать промежуточное состояние.

Динамическая сумма и кошельки

В документации Formidable описан отдельный случай: при динамически рассчитанной сумме и активном Stripe Link у Apple Pay или Google Pay может появляться неверная сумма. В качестве обходного пути предлагается многостраничная форма с page break между суммой и Payment field, чтобы Link и платёжное поле инициализировались после расчёта итога. Это хороший пример того, почему сложную форму нельзя проверять одним быстрым кликом.

Хранение платёжных данных

Чувствительные данные карты не должны храниться в обычных полях формы. Formidable указывает, что при Stripe-интеграции ввод платёжных данных размещается в iframe Stripe, а Stripe обрабатывает compliance-часть. В Formidable остаются записи, платежи, статусы и служебные идентификаторы. Для администратора это значит: не добавляйте поля "номер карты" вручную и не просите пользователя отправлять платёжные данные через обычные текстовые поля.

Ошибки Formidable Stripe и диагностика платежей

Проблемы с платежами часто выглядят одинаково: пользователь жалуется, что форма не прошла, администратор видит запись без оплаты, Stripe показывает незавершённый intent, а письма уходят не в тот момент. Диагностику лучше вести по симптомам, а не по догадкам. Ниже - самые характерные случаи для Formidable Stripe и платежных форм WordPress.

Stripe Token is missing

Симптом: форма сообщает, что Stripe Token отсутствует, или платеж не создаётся. Возможные причины: в форме нет Payment field, неверно подключён Stripe, на странице несколько платежных форм, другой Stripe-плагин конфликтует со скриптами, Formidable или add-on устарели.

Проверьте наличие Payment field, статус подключения Stripe, обновления плагинов и количество платежных форм на странице. Если на одной странице несколько форм со Stripe, временно оставьте одну и повторите тест. Если установлен ещё один плагин, который подключает Stripe Elements, проверьте конфликт на копии сайта или в безопасном режиме.

No such plan

Симптом: recurring-платёж не проходит, Stripe сообщает, что план не найден. Документация Formidable связывает это с ситуацией, когда настройки формы создавались в одном Stripe-аккаунте или режиме, а затем аккаунт был изменён. Вернитесь в настройки Stripe action, сохраните их повторно и сделайте небольшое изменение, чтобы плагин заново создал план в текущем аккаунте.

No such customer

Симптом: logged-in пользователь, который уже платил раньше, получает ошибку о несуществующем customer. Причина может быть в смене Stripe-аккаунта или удалении customer в Stripe. В большинстве случаев следующая попытка может пройти после отвязки старого customer ID, но вмешиваться в пользовательские метаданные должен только разработчик или опытный администратор.

requires_payment_method в Stripe logs

Симптом: в Stripe logs видно, что PaymentIntent требует payment method. Частая причина - автоматически добавленное Payment Method field удалено, изменено или скрыто условной логикой. Исправление: удалите повреждённую связку Payment field и Stripe action на тестовой копии, создайте её заново и не ставьте условную логику на служебное поле, если не понимаете последствия.

Сумма не передаётся или появляется ошибка Amount

Симптом: форма просит указать сумму или списывает не то значение. Проверьте, что Amount в Stripe action получает число, а не строку с символом валюты, запятой или текстом. Если сумма берётся из поля с separate values, используйте значение, а не подпись варианта. После исправления выполните тесты для каждого тарифного пути.

Нет платежей в Formidable Payments

Симптом: форма отправляется, но платежи не появляются в Formidable → Payments. Проверьте, не удалено ли Payment method field, не стоит ли условная логика в неправильном месте, не блокирует ли сервер создание таблицы платежей и нет ли ошибок в журнале wp-content/plugins/formidable-stripe/formidable-payments/log/results.log.

Connect to Stripe не работает

Симптом: кнопка подключения не открывает Stripe или запрос зависает. Проверьте cURL, исходящие соединения сервера и возможную блокировку связи с formidableforms.com. Если сайт находится за корпоративной защитой или строгим хостинг-фильтром, понадобится помощь хостинга или поддержки Formidable.

Неверная сумма в Apple Pay или Google Pay

Симптом: при динамической сумме кошелёк показывает условную или неправильную сумму. Для такой ситуации Formidable рекомендует вынести Payment field на следующую страницу многостраничной формы после расчёта суммы. После изменения обязательно проверьте каждый вариант тарифа и сохраните прежний вариант формы как резервную копию.

Мини-порядок диагностики без хаоса

Если ошибка непонятна, не начинайте с переустановки плагина. Сначала определите, где оборвалась цепочка: форма загрузилась, запись создана, Payment field присутствует, intent появился в Stripe, статус вернулся в Formidable, письмо ушло. Такая последовательность быстрее показывает реальную точку отказа.

Дальше меняйте только один слой. Если не загружается поле оплаты, смотрите скрипты, тему, кэш и конфликт Stripe-плагинов. Если поле есть, но статус не возвращается, смотрите Formidable Payments, Stripe Dashboard и журналы. Если статус есть, но письмо не пришло, проверяйте trigger email action и SMTP. Одна проверка - один слой системы, иначе легко получить новый симптом и потерять исходную причину.

Когда откатывать настройку: если после изменения платежного действия исчезли платежи, перестали обновляться статусы или форма начала отправляться без оплаты, верните предыдущую рабочую конфигурацию и повторяйте тесты по одному изменению.

Безопасная публикация на рабочем сайте

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

Порядок публикации

1. Сделайте резервную копию формы или экспорт конфигурации, если это предусмотрено вашим рабочим процессом.
2. Проверьте, что тестовая форма не индексируется и не доступна случайным пользователям.
3. Подключите рабочий Stripe-режим и проверьте статус соединения.
4. Выключите тестовый режим только после того, как все поля, суммы и уведомления проверены.
5. Опубликуйте форму на нужной странице и проверьте её как обычный посетитель.
6. Проверьте запись, платеж и email после первого контролируемого рабочего платежа.

Если на сайте есть кэш, исключите страницу оплаты из самых агрессивных правил. Не обязательно отключать кэш всего сайта. Достаточно убедиться, что скрипты Stripe и Formidable не ломаются, а пользователю не показывается устаревшее состояние формы.

В этот момент уместно перейти к блоку скачивания и получить установочный файл, если вы ещё не добавили плагин в тестовую среду: скачать установочный файл. Сначала протестируйте его на копии сайта, затем переносите проверенную конфигурацию в рабочую форму.

Когда Formidable Stripe будет удачным выбором

Formidable Stripe стоит использовать, если платеж должен быть встроен в форму, а не жить отдельно от заявки. Его сильная сторона - связка суммы, полей, условной логики, статуса оплаты, писем, подписок и последующих действий. Именно поэтому он хорошо подходит для сервисных заявок, регистраций, донатов, расчётных форм и membership-сценариев без лишней корзины.

Перед рабочим запуском проверьте три вещи: форма создаёт корректную запись, Stripe получает правильную сумму, а Formidable возвращает понятный платежный статус. Если эти три точки работают, уже можно настраивать письма, Views, публикацию записей и дополнительные сценарии. Если хотя бы одна точка нестабильна, не маскируйте проблему красивым сообщением после отправки формы.

Хорошая платежная форма не заставляет пользователя гадать, за что он платит, и не заставляет администратора вручную искать, прошёл ли платеж. Formidable Stripe помогает собрать такой процесс, если настройка сделана последовательно: подготовка, подключение, действие, тест, статус, диагностика и только потом публикация.