How to Integrate Cloudflare Turnstile

This guide explains how to set up Cloudflare Turnstile with WP Easy Pay to protect payment forms from bots and automated abuse while keeping the user experience smooth and friction-free.

What Is Cloudflare Turnstile?

Cloudflare Turnstile is a bot-protection service that helps protect websites from spam and automated attacks. It works mostly in the background without requiring users to solve image challenges or check boxes. However, the Turnstile verification may briefly appear on the frontend while the user is being verified. This makes it suitable for payment and checkout forms that require strong security while keeping the user experience smooth and uninterrupted.

When to Use Cloudflare Turnstile

• When you want bot protection without user interaction
• When maintaining a smooth and fast payment flow is important
• When you prefer a privacy-friendly alternative to traditional CAPTCHAs

Step-by-Step Integration Guide

Step 1: Register Your Website for Cloudflare Turnstile

1. Log in to your Cloudflare dashboard.
2. Navigate to Turnstile from the Cloudflare menu.
3. Create a new Turnstile widget by clicking on the “Add widget” button.
4. Enter a widget name to identify your site.

5. Add your website Hostname by clicking on the “Add Hostnames” button.

6. Add a custom hostname or choose from existing hostnames.

7. Click on the checkbox of the added hostname to enable it and select the widget mode.

8. Create the widget.

After creation, Cloudflare will provide:

• Site Key
• Secret Key

Step 2: Copy Turnstile Keys

• Copy the Site Key
• Copy the Secret Key
• Keep both keys secure for use in WP Easy Pay settings.

Step 3: Add Turnstile Keys in WP Easy Pay

1. Log in to your WordPress admin dashboard.

2. Go to WP Easy Pay → Integrations.

3. Open the Captchas section.

4. Select Cloudflare Turnstile as the captcha provider.

5. Paste the Site Key and Secret Key into the respective fields.

6. Save the settings.

Step 4: Verify Turnstile on the Frontend

1. Visit the page that displays the WP Easy Pay payment form.
2. Submit a test payment using the form.
3. During submission, Turnstile may briefly appear while verifying the user.
4. Confirm that the form submits successfully and the payment process continues smoothly without requiring the user to solve any CAPTCHA challenge.

Tips & Troubleshooting

• Form submission blocked?
  Ensure the correct domain is added in the Cloudflare Turnstile settings.
• Keys not validating?
  Double-check that the Site Key and Secret Key are entered correctly.
• Caching issues?
  Clear the site and plugin cache after enabling Turnstile.
• Test before going live
  Always test Turnstile in WP Easy Pay test mode before enabling it on live payment forms.

Summary

Cloudflare Turnstile provides seamless, invisible protection for WP Easy Pay payment forms. It blocks bots and spam without affecting the user experience, making it an excellent choice for modern, high-conversion payment workflows.