{"id":24950,"date":"2026-08-06T06:51:58","date_gmt":"2026-08-06T06:51:58","guid":{"rendered":"https:\/\/capskip.com\/?p=24950"},"modified":"2026-08-06T06:51:58","modified_gmt":"2026-08-06T06:51:58","slug":"recaptcha-v3-enterprise-csharp","status":"publish","type":"post","link":"https:\/\/capskip.com\/zh\/recaptcha-v3-enterprise-csharp\/","title":{"rendered":"\u5982\u4f55\u5728 C# \u4e2d\u8bc6\u522b reCAPTCHA v3 Enterprise\uff08.NET SDK\uff09"},"content":{"rendered":"

Solving reCAPTCHA v3 Enterprise in C# uses the same method as every other reCAPTCHA type. There is no RecaptchaEnterpriseAsync<\/code>. You call RecaptchaAsync<\/code> and pass two flags: version<\/code> set to v3<\/code>, and enterprise<\/code> set to 1<\/code>. Miss either one and you get a token for a different product, which the site will reject.<\/p>\n

Here is the full call, what the action<\/code> option actually does, and how to tell which variant you’re looking at.<\/p>\n

Version and enterprise are independent flags<\/h2>\n

This trips up almost everyone the first time. Enterprise isn’t a fourth version of reCAPTCHA. It’s a different Google product tier that runs both v2 and v3, so the two settings form a genuine 2×2.<\/p>\n\n\n\n\n\n\n\n\n
What the site runs<\/th>\nOptions you pass<\/th>\n<\/tr>\n<\/thead>\n
reCAPTCHA v2 checkbox<\/td>\nnone<\/td>\n<\/tr>\n
reCAPTCHA v2 Enterprise<\/td>\nenterprise = 1<\/code><\/td>\n<\/tr>\n
reCAPTCHA v3<\/td>\nversion = \"v3\"<\/code><\/td>\n<\/tr>\n
reCAPTCHA v3 Enterprise<\/td>\nversion = \"v3\"<\/code> and enterprise = 1<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Passing enterprise = 1<\/code> on its own gets you a v2 Enterprise solve, and it will fail on a v3 page. That’s the single most common cause of a token that comes back fine and then gets rejected.<\/p>\n

How to tell if a page is Enterprise<\/h2>\n

Open the page source and look at which object the script calls. Standard reCAPTCHA uses grecaptcha<\/code>. Enterprise uses grecaptcha.enterprise<\/code>.<\/p>\n

\/\/ Enterprise pages call grecaptcha.enterprise, not grecaptcha.\n\/\/ The action name you need is right here in execute().\ngrecaptcha.enterprise.ready(function () {\n  grecaptcha.enterprise.execute("YOUR_SITEKEY", { action: "login" })\n    .then(function (token) {\n      \/\/ token gets posted with the form\n    });\n});<\/pre>\n
Two more tells: the script tag loads \/recaptcha\/enterprise.js<\/code> instead of \/recaptcha\/api.js<\/code>, and Enterprise sitekeys usually start with 6L<\/code> just like standard ones, so the key itself tells you nothing. Trust the script, not the key.<\/p>\n
Setup<\/h2>\n
CapSkip runs on your own machine, so start the app before any of this works, then install the SDK from NuGet:<\/p>\n
# .NET Standard 2.0, so .NET Framework 4.6.1+, Core 2.0+\n# and every modern .NET release are all supported.\ndotnet add package CapSkip<\/pre>\n
Point the client at the port shown in the app:<\/p>\n
using CapSkip;\n\nvar solver = new CapSkipClient(\n    apiKey: "capskip",        \/\/ any string when key validation is off\n    host: "127.0.0.1",\n    port: 8080,\n    recaptchaTimeout: 300);   \/\/ seconds; v3 rarely gets near this<\/pre>\n
The v3 Enterprise call<\/h2>\n
Everything beyond the sitekey and URL goes in an options dictionary:<\/p>\n
using System.Collections.Generic;\nusing CapSkip;\n\nvar result = await solver.RecaptchaAsync(\n    "YOUR_SITEKEY",\n    "https:\/\/example.com\/page-with-recaptcha",\n    new Dictionary<string, object?>\n    {\n        ["version"]    = "v3",\n        ["enterprise"] = 1,\n        ["action"]     = "login",   \/\/ match the page exactly\n    });\n\nConsole.WriteLine(result.Code);   \/\/ g-recaptcha-response token<\/pre>\n
The signature is RecaptchaAsync(string sitekey, string url, Dictionary<string, object?>? options = null)<\/code>. The dictionary is nullable-valued, so object?<\/code> matters if your project has nullable reference types switched on.<\/p>\n
What the action option actually does<\/h2>\n
action<\/code> is v3-only. On a v2 page it does nothing.<\/p>\n
It’s the label the page passes to grecaptcha.enterprise.execute()<\/code>. Google scores each action separately, and the site’s backend usually checks that the action in the verification response matches what it expected. If the page says login<\/code> and you solve with the default, your token is valid and still gets thrown out. Copy the string verbatim, including case. Google restricts actions to alphanumerics, slashes and underscores, so there’s nothing exotic to escape.<\/p>\n
Getting it wrong is quiet. Nothing errors, because nothing went wrong on the solving side. You just get a token the endpoint refuses.<\/p>\n
There is no minimum-score option<\/h3>\n
Worth stating plainly, because some solving APIs advertise one: you don’t ask CapSkip for a token at a particular score. The score is Google’s judgement, produced when your target site verifies the token, and no parameter on the solve request sets a floor for it. If you’ve seen a min_score<\/code> field elsewhere and gone looking for the equivalent here, that’s why you can’t find it.<\/p>\n
Submitting the token<\/h2>\n
The token goes into the field the page posts, which is normally g-recaptcha-response<\/code>:<\/p>\n
using System.Net.Http;\n\nusing var http = new HttpClient();\n\nvar form = new FormUrlEncodedContent(new[]\n{\n    new KeyValuePair<string, string>(\n        "g-recaptcha-response", result.Code),\n    new KeyValuePair<string, string>("username", "demo"),\n});\n\nvar response = await http.PostAsync(\n    "https:\/\/example.com\/login", form);<\/pre>\n
One thing you don’t need here: result.UserAgent<\/code>. It’s populated for Turnstile only, and it’s null for every reCAPTCHA solve. If you’ve copied a helper from Turnstile code, strip that header out rather than sending a null.<\/p>\n
reCAPTCHA tokens are also short-lived. Google expires them after two minutes, so solve at the moment you’re ready to submit, not at the top of a long workflow.<\/p>\n
What about v2 Enterprise?<\/h2>\n
Same method, different options. Drop version<\/code> and action<\/code>, and add datas<\/code> if Google handed the page a data-s<\/code> value:<\/p>\n
var v2 = await solver.RecaptchaAsync(sitekey, pageUrl,\n    new Dictionary<string, object?>\n    {\n        ["enterprise"] = 1,\n        ["datas"]      = "YOUR_DATA_S_VALUE",\n    });<\/pre>\n
data-s<\/code> shows up on Google’s own properties and almost nowhere else. If you can’t find one in the page, you don’t need it.<\/p>\n
Handling failures<\/h2>\n
Every SDK exception derives from CapSkipError<\/code>. There’s one .NET trap worth knowing before you write the catch blocks.<\/p>\n
using System;\nusing CapSkip;\n\ntry\n{\n    var result = await solver.RecaptchaAsync(sitekey, pageUrl, options);\n}\ncatch (CapSkip.ValidationException) { \/* bad parameters *\/ }\ncatch (NetworkException)            { \/* CapSkip is not running *\/ }\ncatch (ApiException)                { \/* API returned an error *\/ }\ncatch (CapSkip.TimeoutException)    { \/* exceeded recaptchaTimeout *\/ }\ncatch (CapSkipError)                { \/* anything else from the SDK *\/ }<\/pre>\n
TimeoutException<\/code> and ValidationException<\/code> exist in both System<\/code> and CapSkip<\/code>. With both namespaces imported, an unqualified catch resolves to the System<\/code> type and quietly never fires. Qualify them, or catch CapSkipError<\/code> and inspect it.<\/p>\n
Common errors<\/h2>\n\n\n\n\n\n\n\n\n
Code<\/th>\nCause<\/th>\nFix<\/th>\n<\/tr>\n<\/thead>\n
ERROR_GOOGLEKEY<\/code><\/td>\nSitekey is empty or malformed<\/td>\nRe-read it from the live page, not from a cached copy<\/td>\n<\/tr>\n
ERROR_PAGEURL<\/code><\/td>\nURL missing or not a full absolute URL<\/td>\nInclude the scheme, and use the page the widget is on<\/td>\n<\/tr>\n
ERROR_BAD_PARAMETERS<\/code><\/td>\nAn option value is the wrong type<\/td>\nCheck enterprise<\/code> is the number 1, not the string “1”<\/td>\n<\/tr>\n
ERROR_CAPTCHA_UNSOLVABLE<\/code><\/td>\nThe solve could not be completed<\/td>\nConfirm the version flags match the page, then add a proxy on the same network path<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
The full parameter list for every type is in the API documentation<\/a>.<\/p>\n
Frequently asked questions<\/h2>\n
\n\n
Is there a separate method for Enterprise?<\/h3>\n<\/summary>\n
No. RecaptchaAsync<\/code> handles all four combinations. Enterprise is a flag in the options dictionary, and it works alongside version<\/code> rather than replacing it.<\/p>\n<\/details>\n
\n\n
What happens if I get the action name wrong?<\/h3>\n<\/summary>\n
You get a perfectly valid token that the site refuses. Google returns the action alongside the score during verification, and most backends compare it to what they expected. There’s no error from the solver, because nothing went wrong on the solving side.<\/p>\n<\/details>\n
\n\n
Do I need a proxy for v3 Enterprise?<\/h3>\n<\/summary>\n
Only when the site is geo-sensitive or the score depends on the requesting IP. Pass [\"proxy\"] = new Proxy(\"HTTPS\", \"user:pass@1.2.3.4:3128\")<\/code> in the same options dictionary. Proxies are supported for reCAPTCHA, Turnstile and GeeTest, but not for image CAPTCHAs.<\/p>\n<\/details>\n
\n\n
Can I solve several pages at once?<\/h3>\n<\/summary>\n
Yes. Every method returns a Task<\/code>, so await Task.WhenAll(...)<\/code> is all you need. The SDK exports AsyncCapSkip<\/code> too, but in .NET it’s just an alias of CapSkipClient<\/code>, kept so code ported from the Python SDK still compiles. It adds nothing.<\/p>\n<\/details>\n
Summary<\/h2>\n
One method, two flags. Set version<\/code> to v3<\/code> and enterprise<\/code> to 1<\/code>, copy the action<\/code> off the page exactly, then submit result.Code<\/code> within two minutes. There’s no score to tune, so if a token is refused, check the action and the flags first.<\/p>\n
The rest of the .NET surface is on the C# CAPTCHA solver<\/a> page, Enterprise support<\/a> covers the other languages, and reCAPTCHA v3 solving<\/a> goes deeper on scoring. CapSkip is a local captcha solver<\/a>, so every one of these solves happens on your own machine.<\/p>\n","protected":false},"excerpt":{"rendered":"
Enterprise \u4e0d\u662f\u4e00\u4e2a\u5355\u72ec\u7684\u65b9\u6cd5\u3002\u5b83\u662f\u540c\u4e00\u4e2a\u8c03\u7528\u4e0a\u7684\u4e00\u4e2a\u6807\u5fd7\uff0c\u4e0e version \u548c action \u540d\u79f0\u5e76\u5217\u3002\u8fd9\u91cc\u7528 C# \u8bf4\u660e\u6bcf\u4e00\u9879\u7684\u4f5c\u7528\u3002<\/p>","protected":false},"author":1,"featured_media":24955,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"rank_math_title":"Solve reCAPTCHA v3 Enterprise in C# | CapSkip","rank_math_description":"reCAPTCHA v3 Enterprise in C# is one call with two flags and an action name. Here is the exact .NET code, and the mistake that gets your token rejected.","rank_math_focus_keyword":"recaptcha v3 enterprise in c#","footnotes":""},"categories":[70],"tags":[],"class_list":["post-24950","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-captcha"],"_links":{"self":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24950","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/comments?post=24950"}],"version-history":[{"count":2,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24950\/revisions"}],"predecessor-version":[{"id":24956,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/posts\/24950\/revisions\/24956"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media\/24955"}],"wp:attachment":[{"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/media?parent=24950"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/categories?post=24950"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/capskip.com\/zh\/wp-json\/wp\/v2\/tags?post=24950"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}