Explainers

How reCAPTCHA v3 Enterprise Risk Scoring Works

reCAPTCHA v3 Enterprise does not show a challenge. Instead, it silently scores every interaction on a scale from 0.0 (definitely bot) to 1.0 (definitely human). The site owner sets action-specific thresholds — for example, 0.5 for viewing a page but 0.7 for submitting a payment.

Enterprise scoring adds features beyond standard v3: reason codes that explain why a score was low, adaptive risk thresholds, and integration with Google Cloud security tools. For automation developers, the key fact is: you need a token that passes the site's threshold for the specific action you are performing.


How the scoring process works

  1. Script loadsenterprise.js runs on the page, collecting browser signals
  2. Action executedgrecaptcha.enterprise.execute(sitekey, {action: 'checkout'}) generates a token
  3. Backend verification — the site sends the token to recaptchaenterprise.googleapis.com/v1/projects/PROJECT/assessments
  4. Score returned — Google returns a score (0.0–1.0) plus reason codes
  5. Site decides — the backend compares the score against its threshold for that action

Score ranges and what they mean

Score range Interpretation Typical site response
0.9 Very likely human Allow
0.7–0.8 Probably human Allow
0.5–0.6 Uncertain Allow with additional checks
0.3–0.4 Suspicious Block or show v2 challenge
0.1–0.2 Very likely bot Block

CaptchaAI typically returns tokens with a score of 0.3, which passes sites with thresholds at 0.3 or below. Sites with higher thresholds (0.5+) may require additional measures.


Action-based scoring

Enterprise v3 scores differently based on the action parameter:

// Different actions may have different thresholds:
grecaptcha.enterprise.execute('SITEKEY', {action: 'homepage'});  // Low threshold (0.3)
grecaptcha.enterprise.execute('SITEKEY', {action: 'login'});     // Medium threshold (0.5)
grecaptcha.enterprise.execute('SITEKEY', {action: 'purchase'});  // High threshold (0.7)

Using the wrong action in your CaptchaAI request may result in a token that scores differently than expected.


Enterprise reason codes

Enterprise adds reason codes alongside the score:

Reason code Meaning
AUTOMATION Interaction appears automated
UNEXPECTED_ENVIRONMENT Browser environment is unusual
TOO_MUCH_TRAFFIC Excessive requests from this source
UNEXPECTED_USAGE_PATTERNS Interaction pattern is abnormal
LOW_CONFIDENCE_SCORE Insufficient signals to assign a confident score

Site owners use these to create custom rules beyond simple score thresholds.


Solving Enterprise v3 with CaptchaAI

import requests
import time

response = requests.get("https://ocr.captchaai.com/in.php", params={
    "key": "YOUR_API_KEY",
    "method": "userrecaptcha",
    "version": "v3",
    "enterprise": 1,
    "googlekey": "6LfZil0UAAAAADM1Dpz...",
    "action": "login",
    "pageurl": "https://example.com/login",
    "json": 1
})

task_id = response.json()["request"]

for _ in range(30):
    time.sleep(5)
    result = requests.get("https://ocr.captchaai.com/res.php", params={
        "key": "YOUR_API_KEY", "action": "get", "id": task_id, "json": 1
    }).json()
    if result.get("status") == 1:
        token = result["request"]
        break

FAQ

What score does CaptchaAI return for Enterprise v3?

Typically around 0.3. This passes most sites but may be rejected by sites with high thresholds.

Can I request a specific score from CaptchaAI?

No. The score depends on the solving environment and the site's configuration. CaptchaAI aims for the highest achievable score.

Does the action value affect the score?

Yes. Sites can have different thresholds per action. Always use the exact action value from the site's JavaScript.

How does Enterprise v3 differ from standard v3?

Enterprise adds reason codes, project-based management, and custom thresholds. For CaptchaAI users, the main difference is adding enterprise=1 to the request.

What if my token has a low score?

Some sites fall back to a v2 challenge when the v3 score is low. If you are consistently rejected, check if the site has a secondary v2 challenge and solve that instead.


Discussions (0)

No comments yet.

Related Posts

API Tutorials How to Solve reCAPTCHA v3 Enterprise Using API
Solve re CAPTCHA v 3 Enterprise with Captcha AI API.

Solve re CAPTCHA v 3 Enterprise with Captcha AI API. Step-by-step guide with detection, parameter extraction,...

Automation reCAPTCHA v3 reCAPTCHA Enterprise
Feb 18, 2026
API Tutorials How to Solve reCAPTCHA v3 Enterprise with PHP
Solve re CAPTCHA v 3 Enterprise using PHP and Captcha AI API.

Solve re CAPTCHA v 3 Enterprise using PHP and Captcha AI API. Complete guide with parameter detection, task su...

Automation reCAPTCHA v3 reCAPTCHA Enterprise
Mar 20, 2026
Reference CAPTCHA Token Injection Methods Reference
Complete reference for injecting solved CAPTCHA tokens into web pages.

Complete reference for injecting solved CAPTCHA tokens into web pages. Covers re CAPTCHA, Turnstile, and Cloud...

Automation Python reCAPTCHA v2
Apr 08, 2026
Reference Browser Session Persistence for CAPTCHA Workflows
Manage browser sessions, cookies, and storage across CAPTCHA-solving runs to reduce repeat challenges and maintain authenticated state.

Manage browser sessions, cookies, and storage across CAPTCHA-solving runs to reduce repeat challenges and main...

Automation Python reCAPTCHA v2
Feb 24, 2026
Use Cases CAPTCHA Solving in Ticket Purchase Automation
How to handle CAPTCHAs on ticketing platforms Ticketmaster, AXS, and event sites using Captcha AI for automated purchasing workflows.

How to handle CAPTCHAs on ticketing platforms Ticketmaster, AXS, and event sites using Captcha AI for automate...

Automation Python reCAPTCHA v2
Feb 25, 2026
Tutorials Caching CAPTCHA Tokens for Reuse
Cache and reuse CAPTCHA tokens with Captcha AI to reduce API calls and costs.

Cache and reuse CAPTCHA tokens with Captcha AI to reduce API calls and costs. Covers token lifetimes, cache st...

Automation Python reCAPTCHA v2
Feb 15, 2026
Tutorials Browser Console CAPTCHA Detection: Finding Sitekeys and Parameters
Use browser Dev Tools to detect CAPTCHA types, extract sitekeys, and find parameters needed for Captcha AI API requests.

Use browser Dev Tools to detect CAPTCHA types, extract sitekeys, and find all parameters needed for Captcha AI...

Automation reCAPTCHA v2 Cloudflare Turnstile
Mar 25, 2026
Use Cases Multi-Step Checkout Automation with CAPTCHA Solving
Automate multi-step e-commerce checkout flows that include CAPTCHA challenges at cart, payment, or confirmation stages using Captcha AI.

Automate multi-step e-commerce checkout flows that include CAPTCHA challenges at cart, payment, or confirmatio...

Automation Python reCAPTCHA v2
Mar 21, 2026
Comparisons reCAPTCHA v2 vs v3 Explained
Compare re CAPTCHA v 2 and v 3 side by side.

Compare re CAPTCHA v 2 and v 3 side by side. Learn how each version works, their detection methods, and how to...

Automation reCAPTCHA v3 Migration
Mar 19, 2026
Comparisons Headless vs Headed Chrome for CAPTCHA Solving
Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and when to use each mode with Captcha AI.

Compare headless and headed Chrome for CAPTCHA automation — detection differences, performance trade-offs, and...

Automation Python reCAPTCHA v2
Mar 09, 2026
Explainers How BLS CAPTCHA Works: Grid Logic and Image Selection
Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how Captcha AI processes BLS challenges.

Deep dive into BLS CAPTCHA grid logic — how images are arranged, how instructions map to selections, and how C...

Automation BLS CAPTCHA
Apr 09, 2026
Explainers Browser Fingerprinting and CAPTCHA: How Detection Works
How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detection with Captcha AI.

How browser fingerprinting affects CAPTCHA challenges, what signals trigger CAPTCHAs, and how to reduce detect...

reCAPTCHA v2 Cloudflare Turnstile reCAPTCHA v3
Mar 23, 2026
Explainers GeeTest v3 Challenge-Response Workflow: Technical Deep Dive
A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token exchange, slider verification, and how Captcha AI...

A technical deep dive into Gee Test v 3's challenge-response workflow — the registration API, challenge token...

Automation Testing GeeTest v3
Mar 02, 2026