Important

You are browsing documentation for version 5.1 of OroCommerce, supported until March 2026. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure CAPTCHA Settings per Organization 

Note

This feature is available as of OroCommerce version 5.1.9.

CAPTCHA, which stands for Completely Automated Public Turing test to tell Computers and Humans Apart, is a type of challenge-response test used to verify whether the user is human. CAPTCHAs are crucial for maintaining the integrity, security, and usability of online systems. They ensure that interactions and transactions on websites are legitimate and performed by real users, protecting against malicious activities.

In OroCommerce, you can configure CAPTCHA on global, organization, and website levels using any of the tree supported service: Google reCAPTCHA, hCAPTCHA and Cloudflare Turnstile.

To configure CAPTCHA settings per organization:

  1. Navigate to System > User Management > Organizations in the main menu.

  2. For the necessary organization, hover over the More Options menu at the end of the row and click to start editing the configuration.

  3. Click System Configuration > Integrations > CAPTCHA Settings in the menu to the left.

    CAPTCHA configuration settings on the organization level

    To override the global configuration settings, clear the Use System option next to the required option.

  4. In the General section, you have the following options:

    • Enable CAPTCHA Protection — Enable or disable the CAPTCHA protection feature for the OroCommerce application.

    • CAPTCHA Service — Select the CAPTCHA service for the storefront. Available options are Google reCAPTCHA, hCAPTCHA and Cloudflare Turnstile.

    • Protect Forms — Select which forms to enable the CAPTCHA protection for. Developers can add protection for custom forms via the DI Tag. For more information on how to do it, see FormBundle documentation.

  5. In the Google reCAPTCHA section, provide the following information:

    • Site Key — Provide a site key generated in the Google admin console.

    • Secret Key — Provide a secret key generated in the Google admin console.

    • Minimal Allowed Score — Google reCAPTCHA v3 returns a score based on which you can take variable action in the context of your site. For example, 1.0 is very likely a good interaction, 0.0 is very likely a bot.

    For more information on these options, please refer to the Google reCapture documentation.

  6. In the hCaptcha section, provide the following information:

    • Site Key — Provide a site key generated in the hCapture account.

    • Secret Key — Provide a secret key generated in the hCapture account.

    For more information on these options and how to create an hCapture account, please refer to the hCapture documentation.

  7. In the Cloudflare Turnstile, provide the following information:

    • Site Key — Provide a site key to invoke Turnstile on your site generated in the settings of your Turnstile widget in your Cloudflare account.

    • Secret Key — Provide a secret key to connect to the Cloudflare Turnstile server generated in the settings of your Turnstile widget in your Cloudflare account.

    For more information on these options, please refer to the Cloudflare Turnstile documentation.

  8. Click Save Settings.