Skip to content
Search Articles/

less than a minute read • Updated 8 minutes ago

Set up reCAPTCHA with a custom subdomain

How to create your own Google reCAPTCHA keys and add them to Foxy when your store checkout uses a custom subdomain.

If your store's checkout uses a custom subdomain, you'll need to create your own Google reCAPTCHA keys and add them to Foxy. We strongly recommend doing this — without it, a botnet-based card testing attack could cost you hundreds or thousands of dollars in authorization fees.

Steps

  1. 1

    Go to the Google reCAPTCHA admin area. You'll need to log in with your Google account if you aren't already.

  2. 2

    Enter a label that makes it clear what these keys are for, such as "My Example Store on Foxy". This is just for your own reference.

  3. 3

    Select the reCAPTCHA v2 option, and if given further options, choose the "I'm not a robot" Checkbox option.

  4. 4

    Enter the root domain your Foxy checkout uses. For example, if your checkout is at secure.example.tld, enter example.tld. Agree to Google's terms and submit.

  5. 5

    Google will show you a Site Key and a Secret Key.

  6. 6

    In the Foxy admin, go to Settings > Payments and click on your payment method set.

  7. 7

    Under Fraud protections, click on the Google reCAPTCHA entry (or click Add fraud protection + and select Google reCAPTCHA if it isn't there yet).

  8. 8

    Copy the two keys into the Site Key and Secret Key fields, making sure each key goes into its matching field.

  9. 9

    Close the panel to save your changes.

Test it

To confirm the keys are working, set the Configuration setting to Always enabled and load your checkout — you should see the reCAPTCHA displayed. Run a test transaction if you'd like, then set it back to Enabled by errors when you're done.

Notes

  • For details on the configuration options themselves, see Configure reCAPTCHA on the checkout.

  • If your store uses multiple payment method sets, add the keys to the Google reCAPTCHA entry on each one.

Need Help?

Did this article answer your questions? Need help with anything? Please click below to contact us.