Description
This plugin integrates the ifthenpay payment gateway with Contact Form 7 to enable seamless payment collection directly from your forms. Payments are processed through a secure pay-by-link system, ensuring that no sensitive card or banking data is stored on your website. After form submission, customers are redirected to a secure ifthenpay payment page where they finalize the transaction. ifthenpay then sends a server-side callback to automatically update the payment status in your entries.
In plain terms you get:
- One-time payments directly from Contact Form 7 forms
- Secure automatic payment confirmations via callback
- Payment entries page to manage and track all transactions
- Revenue dashboard widget with period breakdown
- No card numbers stored on your website
All global settings are configured on the CF7 Integration page. Per-form settings (enable/disable, amount source) are managed inside each form editor.
Key Features
- Full integration with Contact Form 7 forms
- Secure transactions via pay-by-link
- Automatic payment confirmation via server-side callback
- Support for multiple payment methods (cards, wallets, bank transfers)
- Per-form configuration — enable payments and set amount source per form
- Flexible amount — fixed price or read dynamically from any CF7 field
- Payment entries page with filtering, search, bulk actions, and column customization
- Revenue dashboard widget with last 24 h / 7 d / 15 d / 30 d breakdown
- Admin bar shortcut and keyboard shortcut (Ctrl+Shift+F) to Entries page
- Multi-language support (EN, ES, FR, PT)
- Security-first — no card data stored, anti-phishing key validation, HTTPS only
Requirements
- An active ifthenpay merchant account.
- The payment methods you want enabled (our helpdesk team will guide you).
- WordPress 6.5+ and PHP 8.2+, with Contact Form 7 5.9+ installed and activated.
- HTTPS (SSL) enabled on your site.
Form Tag Reference
The [ifthenpay_payment] tag renders the payment button in the form. Place it once where the submit button should appear and remove the default [submit] tag.
Supported options:
- amount:X.XX — (Required) Payment amount in euros. Use . or , as decimal separator.
- “Button text” — (Optional) Custom button label. Default: “Pay with ifthenpay”.
- css:”my-class” — (Optional) Extra CSS class appended to the button element.
- hide:yes — (Optional) Hides the payment method logos displayed above the button.
The tag generator in the form editor builds the tag for you with a visual UI.
External Services
This plugin integrates with the ifthenpay payment platform to process payments for Contact Form 7 submissions. ifthenpay is a third-party service that provides secure payment processing for various methods including cards, wallets, and local bank transfers.
-
Contact Form 7
- What it is and what it is used for: A free form builder plugin used to create contact and payment forms. This plugin extends its capabilities by adding a payment button tag and processing.
-
Gravatar (Automattic)
- What it is and what it is used for: A profile image service used to retrieve and display the sender’s avatar next to their form submission on the plugin’s administration entries page.
- What data is sent and when: An anonymized string created from the user’s email address (also called a hash) is sent to the Gravatar service whenever an administrator views the Single Entry Page.
- Automattic Terms of Service: Terms of Service
- Automattic Privacy Policy: Privacy Policy.
-
ifthenpay Backoffice & Integrations
- What it is and what it is used for: The ifthenpay Backoffice is the merchant dashboard used to manage integrations and payment configurations. The plugin uses the ifthenpay API to generate payment links and validate transactions.
- What data is sent and when:
- During setup: Backoffice Key and Gateway Key for authentication and configuration retrieval.
- During payment processing: Transaction ID, amount, description, enabled payment method accounts, success/error/cancel return URLs, language, and optionally the selected payment method, customer email, customer name, and form field data.
- During callbacks: Payment status, Transaction ID, and payment method (received from ifthenpay).
- Network & VPN Requirements: Outbound HTTPS requests are made to ifthenpay APIs for setup, link generation, and status validation. Servers behind strict firewalls or restrictive outbound VPNs must allowlist the following domains to prevent connection timeouts:
- api.ifthenpay.com
- ifthenpay.com
- End-User License Agreement (EULA): EULA
- Privacy Policy: Privacy Policy
All network requests are performed server-side over HTTPS. Sensitive credentials are stored securely and are not publicly exposed. No raw card or bank details are stored.
License
This plugin is licensed under the GPLv3.
Support
For assistance use the WordPress.org support forum:
Pre-checks before posting:
* Payment method enabled on Gateway Key AND mapped to Integration
* Running current recommended versions of WordPress, PHP & Contact Form 7
Commercial helpdesk available (no direct email required): helpdesk.ifthenpay.com
* ifthenpay support: suporte@ifthenpay.com
* Contact Form 7 docs: contactform7.com/docs
Screenshots










Installation
- Upload the plugin zip via Plugins Add New Upload, or install from WordPress.org and Activate.
- Go to Contact Form 7 Integration ifthenpay Payment Gateway, enter your Backoffice Key, and click Connect.
- Select your Gateway Key, enable payment methods, set a default method, description, and expiry days. Click Save Configuration.
- Open any form, go to the ifthenpay Payment Gateway tab, enable payments, and configure the payment amount (fixed or from a CF7 field).
- Add the [ifthenpay_payment amount:XX.XX] tag to the form body using the tag generator. Remove the default submit button — the payment tag acts as the submit.
FAQ
-
Does this plugin require Contact Form 7?
-
Yes. Contact Form 7 must be installed and active to use this plugin.
Without Contact Form 7, the plugin has no forms to attach payments to and will show an admin notice.
-
Does it support recurring payments?
-
No. This version supports one-time payments via pay-by-link only.
-
Are payment details stored?
-
No. The plugin does not store card numbers or full bank details.
Only the minimal references required for payment matching and status updates are stored: transaction ID, amount, payment method, status, and form data.
-
Which payment methods are supported?
-
Any ifthenpay method attached to your Gateway Key, including Multibanco, MB WAY, Payshop, Credit Card, Cofidis, Google Pay, Apple Pay, and Pix.
-
How does the payment process work?
-
After form submission, customers are redirected to a secure payment page hosted by ifthenpay. Once payment is completed, ifthenpay sends a server-side callback to automatically update the entry status.
-
What happens if a payment fails or is cancelled?
-
The entry is marked as Failed or Cancelled. The payment can be retried by re-submitting the form.
-
Where are payment entries stored?
-
In a custom database table wp_ifthenpay_cf7_entries. View and manage them under Contact Form 7 ifthenpay Entries.
-
When do pending payments expire?
-
A daily cron job runs at 23:59 and marks pending payments older than the configured number of days (default: 3) as expired. You can adjust the expiry period on the Integration settings page.
-
Can the payment amount come from a form field?
-
Yes. In the per-form settings (form editor ifthenpay Payment Gateway tab), set Payment Amount to “Read from CF7 field” and enter the field name whose value holds the amount.
-
Is there a sandbox / test mode?
-
ifthenpay may provide test entities for development and testing purposes. If unavailable, we recommend using a low-value live transaction.
-
How secure is the integration?
-
All requests are encrypted over HTTPS and no sensitive payment data is stored on your website. The callback endpoint validates an anti-phishing key and verifies the payment amount before updating any entry.
-
Why are payment links failing or setup timing out?
-
Your server firewall or VPN may be blocking outbound requests. The plugin must connect to ifthenpay APIs to function. Ensure your network administrator allows outbound HTTPS traffic to ifthenpay domains.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ifthenpay | Payments for Contact Form 7” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “ifthenpay | Payments for Contact Form 7” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- Initial release: Contact Form 7 integration, ifthenpay payments, multi-method support, callback endpoint, entries page, dashboard widget.
