Integration of Contact form 7 and Yukassa

CF7 YooKassa Pro — installation and configuration instructions

1) Purpose of the plugin

The plugin connects Contact Form 7 with the YooKassa payment system:

- after sending the form, a payment is created in Yandex.Checkout;
- the user automatically goes to the payment page;
- payment status is updated via webhook;
- payment history, filters, CSV export and repeat payment are available in the WordPress admin panel.

2) Requirements

- WordPress 6.1+
- PHP 7.4+
- Installed and active Contact Form 7
- A YooKassa account with API access (Shop ID + The secret key)

Official API Documentation:  
[https://yookassa.ru/developers](https://yookassa.ru/developers)  
Quick start:  
[https://yookassa.ru/developers/payment-acceptance/getting-started/quick-start](https://yookassa.ru/developers/payment-acceptance/getting-started/quick-start)

3) Installation

1. Copy the plugin folder to wp-content/plugins/.
2. Activate the plugin in WordPress: Plugins -> CF7 YooKassa Pro.
3. Make sure that Contact Form 7 is activated.

4) Global plug-in configuration

Path: Contact Form 7 -> YooKassa

Fill in the form:

- Shop ID — the store's identifier in Yandex.Checkout
- Secret key — The store's API key
- Webhook secret — incoming notification protection line

The following will be shown:

- Webhook URL — you need to insert it into the settings of yourkassa notifications.

Important: if you have changed the webhook Secret, be sure to update the URL in your personal account at Yandex.Checkout.

5) Payment setup for a specific CF7 form

Open the form: Contact Form 7 -> (required form) -> the YooKassa tab

Parameters:

- Enable YooKassa for this form  
  Activates the creation of a payment after sending the form.

- Name of the payment  
  Service name for convenience in the history of the plugin.

- Currency  
  Three-letter code (usually RUB).

- Amount mode
  - Fixed — a number is taken from the Fixed Amount field
  - From the form field — the amount is read from the CF7 field (the name is entered in the Name of the amount field)

- Fixed amount  
  Example: 1990.00

- Name of the amount field  
  CF7 tag name without parentheses, example: amount

- Name of the Email field  
  The name of the CF7 email field to save in the payment history

- Description template  
  Supports substitution of form fields:
Payment for {your-name} application from {your-phone}

- URL after successful payment  
  The customer's refund page after payment.

- URL after cancellation  
  The page where to send the client in case of cancellation or error.

Save the form after changing the parameters.

6) How the payment scenario works

1. The user submits the CF7 form.
2. The plugin creates a payment via the YooKassa API.
3. The user is redirected to confirmation_url.
4. YooKassa sends a webhook about the payment status change.
5. The plugin updates the status in the database and shows the result page.

7) Payment history

Path: Contact Form 7 -> YooKassa Payments

Available:

- payment table;
- filters by status/form/date/search;
- export CSV;
- Repeat payment button for unsuccessful/incomplete payments.

8) Recommendations for launching in production

1. First, check everything in the YooKassa test mode.
2. Make sure that the webhook actually arrives and changes its status.
3. Check both refund branches: successful payment and cancellation.
4. After the test, switch to the combat keys of the store.

9) Frequent problems

- There is no redirect for payment after sending the form.  
  Make sure that payment is enabled in the form settings and the global API keys are filled in.

- Statuses are not updated  
  Check the correctness of the Webhook URL and the Secret of the webhook.

- The amount is 0 or incorrect  
  Check the Amount Mode and the name of the amount field in CF7.

10) Security

- Keep the Secret Key and the Secret of the webhook only with the site administrators.
- Do not publish the webhook URL in open sources.
- Check your payment history and server logs regularly.

Support

If you have any questions or problems, please contact the author.

Alex Osmanov
🌐Website: https://pluginhub.pro
📧 Email: support@pluginhub.pro
💬 Telegram: @alexosmanov_ru