Integration · 7 min read

hCaptcha integration guide

hCaptcha connects supported security & fraud prevention workflows to LucidCP. Use this checklist to configure, link and validate the module before production traffic.

Verified against the current LucidCP interface
Site Settings screen used to configure hCaptcha in LucidCP
Step 1 — Open Site Settings in the English admin workspace and select hCaptcha.
Modules & Gateways screen used to connect hCaptcha in LucidCP
Step 2 — Map the saved hCaptcha connection to the relevant workflow from Modules & Gateways.
01

Procedure

Step-by-step

  1. 01

    Prepare the provider account

    Confirm that your hCaptcha account is active and create the site key, secret or policy values supplied by the security provider. Use a test or sandbox environment when the provider offers one.

    hCaptcha configuration in the real LucidCP interface
    Step 1 of 7 · Confirm that the security integration is available in Modules & Gateways.Select the preview to inspect the full-resolution interface.
  2. 02

    Open the configuration area

    Go to Admin → Site Settings → Security and select hCaptcha.

    hCaptcha configuration in the real LucidCP interface
    Step 2 of 7 · Open Site Settings → Security to reach the relevant protection controls.Select the preview to inspect the full-resolution interface.
  3. 03

    Enter and protect credentials

    Copy values exactly, keep TLS verification enabled and never place production secrets in screenshots, tickets or browser-side code.

    hCaptcha configuration in the real LucidCP interface
    Step 3 of 7 · Enter the provider keys or policy values on the real LucidCP settings screen.Select the preview to inspect the full-resolution interface.
  4. 04

    Test the connection

    Use LucidCP’s connection test where available. Resolve authentication, network or permission errors before linking the integration.

    hCaptcha configuration in the real LucidCP interface
    Step 4 of 7 · Review thresholds, challenge behaviour and connection status before saving.Select the preview to inspect the full-resolution interface.
  5. 05

    Connect the workflow

    Associate login, registration or checkout risk checks. Save the configuration and re-open it to verify the selected mapping.

    hCaptcha configuration in the real LucidCP interface
    Step 5 of 7 · Enable the integration for the login, registration or order flow that needs it.Select the preview to inspect the full-resolution interface.
  6. 06

    Run acceptance checks

    Perform allowed, challenged and rejected test scenarios. Confirm both the LucidCP record and the provider-side result.

    hCaptcha configuration in the real LucidCP interface
    Step 6 of 7 · Verify the protected customer flow with a controlled test account.Select the preview to inspect the full-resolution interface.
  7. 07

    Monitor after launch

    Review activity logs, module queue, failed jobs and provider logs during the first production transactions.

    hCaptcha configuration in the real LucidCP interface
    Step 7 of 7 · Monitor security decisions and related activity after launch.Select the preview to inspect the full-resolution interface.
02

Checklist

Best practices

  • Start with the smallest API permission set and expand only when a documented action requires it.
  • Rotate provider credentials regularly and immediately after a suspected leak.
03

Reference

Module details

Integration
hCaptcha
Category
Security & Fraud Prevention
Availability
Included with licence
Was this guide helpful?Need more detail? Tell the support team which step you reached.
Contact support

Get Started

Choose your plan, get your license, and complete setup in minutes.

View Pricing

Hi! Need help with plans, installation, or licensing?

Help Center Open a Support Ticket Integrations