Интеграция Contact form 7 и Юкасса

CF7 YooKassa Pro — инструкция по установке и настройке

1) Назначение плагина

Плагин связывает Contact Form 7 с платежной системой YooKassa:

- после отправки формы создается платеж в YooKassa;
- пользователь автоматически уходит на страницу оплаты;
- статус платежа обновляется через webhook;
- в админке WordPress доступна история платежей, фильтры, экспорт CSV и повторная оплата.

2) Требования

- WordPress 6.1+
- PHP 7.4+
- Установленный и активный Contact Form 7
- Аккаунт в YooKassa с доступом к API (Shop ID + Секретный ключ)

Официальная документация API:  
[https://yookassa.ru/developers](https://yookassa.ru/developers)  
Быстрый старт:  
[https://yookassa.ru/developers/payment-acceptance/getting-started/quick-start](https://yookassa.ru/developers/payment-acceptance/getting-started/quick-start)

3) Установка

1. Скопируйте папку плагина в wp-content/plugins/.
2. Активируйте плагин в WordPress: Плагины -> CF7 YooKassa Pro.
3. Убедитесь, что активирован Contact Form 7.

4) Глобальная настройка плагина

Путь: Contact Form 7 -> YooKassa

Заполните:

- Shop ID — идентификатор магазина в YooKassa
- Секретный ключ — API-ключ магазина
- Секрет webhook — строка защиты входящих уведомлений

Ниже будет показан:

- Webhook URL — его нужно вставить в настройки уведомлений YooKassa.

Важно: если изменили Секрет webhook, обязательно обновите URL в личном кабинете YooKassa.

5) Настройка оплаты для конкретной формы CF7

Откройте форму: Contact Form 7 -> (нужная форма) -> вкладка YooKassa

Параметры:

- Включить YooKassa для этой формы  
  Активирует создание платежа после отправки формы.

- Название платежа  
  Служебное имя для удобства в истории плагина.

- Валюта  
  Трехбуквенный код (обычно RUB).

- Режим суммы
  - Фиксированная — берется число из поля Фиксированная сумма
  - Из поля формы — сумма читается из поля CF7 (имя задается в Имя поля суммы)

- Фиксированная сумма  
  Пример: 1990.00

- Имя поля суммы  
  Имя тега CF7 без скобок, пример: amount

- Имя поля Email  
  Имя email-поля CF7 для сохранения в истории платежей

- Шаблон описания  
  Поддерживает подстановку полей формы:  
  Оплата заявки {your-name} от {your-phone}

- URL после успешной оплаты  
  Страница возврата клиента после оплаты.

- URL после отмены  
  Страница, куда отправить клиента при отмене/ошибке.

Сохраните форму после изменения параметров.

6) Как работает сценарий оплаты

1. Пользователь отправляет форму CF7.
2. Плагин создает платеж через API YooKassa.
3. Пользователь перенаправляется на confirmation_url.
4. YooKassa отправляет webhook об изменении статуса платежа.
5. Плагин обновляет статус в БД и показывает страницу результата.

7) История платежей

Путь: Contact Form 7 -> Платежи YooKassa

Доступно:

- таблица платежей;
- фильтры по статусу/форме/дате/поиску;
- экспорт CSV;
- кнопка Повторить оплату для неуспешных/незавершенных платежей.

8) Рекомендации по запуску в продакшене

1. Сначала проверьте все в тестовом режиме YooKassa.
2. Убедитесь, что webhook реально приходит и меняет статус.
3. Проверьте обе ветки возврата: успешная оплата и отмена.
4. После теста переключите на боевые ключи магазина.

9) Частые проблемы

- После отправки формы нет редиректа на оплату  
  Проверьте, что оплата включена в настройках формы и заполнены глобальные ключи API.

- Статусы не обновляются  
  Проверьте корректность Webhook URL и Секрет webhook.

- Сумма 0 или неверная  
  Проверьте Режим суммы и имя поля суммы в CF7.

10) Безопасность

- Храните Секретный ключ и Секрет webhook только у администраторов сайта.
- Не публикуйте URL webhook в открытых источниках.
- Регулярно проверяйте историю платежей и серверные логи.