Screen Fergus booking form spam with reCAPTCHA or Turnstile
Captcha checks each submission with Google reCAPTCHA v3 or Cloudflare Turnstile before Formpiece takes the booking. A submission that fails the check is refused, so nothing is saved and nothing reaches Fergus. Captcha works on every plan.
Before you start
- Save your keys as a credential under Integration Credentials. Pick reCAPTCHA v3 or Turnstile.
- reCAPTCHA needs a site key and a secret key, both from reCAPTCHA v3. Turnstile needs its own site key and secret key. A credential with only one key of a pair is listed as "(incomplete keys)".
Step by step
- Open your form from Forms. On the Settings tab, open Captcha under Form display.
- Turn on Allow captcha.
- Pick your credential from Choose Integration credentials. Each is listed with its provider in brackets, "(reCAPTCHA v3)" or "(Cloudflare Turnstile)".
- Click Save.
The form uses whichever provider the credential belongs to. To change provider, pick a different credential. If a credential holds a complete set of keys for both, reCAPTCHA v3 is used.
Save stays off while Allow captcha is on and no credential is chosen ("Save is off: choose the integration credentials."), or while the credential chosen is missing a key. The page says which key is missing, for example "These credentials have a site key but no secret key.", and adds "Every booking would be refused, so Save is off."
When it goes wrong
Customers see "Captcha verification failed."
Formpiece checked the submission and refused it. A refused submission is not saved, so it does not appear on the Bookings tab and no failed booking email goes out. The cause is one of these:
- The credential was deleted, or no longer holds a complete pair of keys. Pick a credential again and save.
- Google or Cloudflare rejected the token. Check the site key and secret key come from the same setup.
- reCAPTCHA scored the submission below 0.5. The cut-off cannot be changed.
- The booking arrived without a captcha token.
- Google or Cloudflare did not answer within five seconds. Formpiece refuses a submission it could not check.
FAQ
Can several forms use the same credential?
Yes. Any form can pick any captcha credential on the account.