In this article, we have tried to answer all the key questions. The first step in solving the task is to determine which protection system is being used. To do this, you can refer to the list of popular captchas and anti-bot protection systems, where you will find visual examples and key indicators that help you quickly understand what you are dealing with.
If you discover that your site uses Prosopo Procaptcha, the next step is to study its properties and operation in more detail. In this article, you can also review the instructions on how to integrate Prosopo Procaptcha so that you fully understand how it functions on your site. This will help you not only understand the current protection, but also properly plan its maintenance.
How to solve Procaptcha via CapMonster Cloud
When testing forms that include Prosopo Procaptcha, you often need to verify that the captcha works and is integrated correctly.
You can verify the captcha embedded on your site manually.
- Open the form page and make sure the captcha renders.
- Try submitting the form without solving it — the server should return an error.
- After a successful solution, the form must be submitted without issues.
For automatic solving you can use tools like CapMonster Cloud, which accepts captcha parameters, processes them on its servers, and returns a ready-to-use token. Insert this token into the form to pass the check without user interaction.
Working with CapMonster Cloud via API typically involves the following steps:
Creating a task
Sending an API requesttype - ProsopoTask
websiteURL - Full URL of the captcha page;
websiteKey - Value of the siteKey parameter found on the page.
https://api.capmonster.cloud/createTask
{
"clientKey": "API_KEY",
"task": {
"type": "ProsopoTask",
"websiteURL": "https://www.example.com",
"websiteKey": "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV"
}
}
{
"errorId":0,
"taskId":407533072
}
Receiving the resulthttps://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId":0,
"status":"ready",
"solution": {
"token": "0x00016c68747470733a2f2f70726f6e6f6465332e70726f736f706f2e696fc0354550516f4d5a454463354c704e376774784d4d7a5950547a4136..."
}
}
Placing the token on the page
async function sendTokenToSite(token) {
// Form URL or endpoint where the token should be sent
const formURL = "https://example..com/en/your-form-endpoint";
// Example form data
const formData = {
email: "example@example.com",
password: "yourpassword",
"procaptcha-response": token // Procaptcha token
};
try {
const response = await fetch(formURL, {
method: "POST",
headers: {
"Content-Type": "application/json", // или 'application/x-www-form-urlencoded' depending on the website
},
body: JSON.stringify(formData),
});
const result = await response.text(); // or response.json() if the server returns JSON
console.log("Server response:", result);
} catch (err) {
console.error("Error sending token:", err);
}
}
// Main function
async function solveAndSend() {
const client = CapMonsterCloudClientFactory.Create(
new ClientOptions({ clientKey: API_KEY })
);
const prosopoRequest = new ProsopoRequest({
websiteURL: "https://example.com/en/",
websiteKey: "5EZU3LG31uzq1Mwi8inwqxmfvFDpj7VzwDnZwj4Q3syyxBwV"
});
const balance = await client.getBalance();
console.log("Balance:", balance);
const result = await client.Solve(prosopoRequest);
console.log("Captcha solution:", result);
// Send token to the website
await sendTokenToSite(result.solution); // result.solution contains the Procaptcha token
}
solveAndSend().catch(console.error);
1. Obtain keys (sitekey and secret key)
- 1) Go to Prosopo Portal.
- 2) Go to Site Management
- 3) Click Reveal — two keys will appear:
- sitekey — public, used on the client side.
- secret key — private, use only on the server.
2. Add your domain
- 1) Go to Account → Domains.
- 2) Ensure your domain is listed.
- 3) If testing locally — add localhost.
- 4) Remove localhost before production.
3. Add Procaptcha script
Place the tag in <head>
<script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>>4. Option 1: Implicit rendering (automatic) — EASIER
Add a container where the captcha will appear automatically:
<div class="procaptcha" data-sitekey="your_site_key"></div>Usually placed inside the form.
Example full form<html>
<head>
<title>Procaptcha Demo</title>
<script type="module" src="https://js.prosopo.io/js/procaptcha.bundle.js" async defer></script>
</head>
<body>
<form action="" method="POST">
<input type="text" name="email" placeholder="Email" />
<input type="password" name="password" placeholder="Password" />
<div class="procaptcha" data-sitekey="your_site_key"></div>
<br />
<input type="submit" value="Submit" />
</form>
</body>
</html>After successful captcha verification, a hidden parameter will be added:
5. Option 2: Explicit rendering (manual) — MORE CONTROL
HTML example
<html>
<head>
<script
type="module"
id="procaptcha-script"
src="https://js.prosopo.io/js/procaptcha.bundle.js"
async
defer
></script>
</head>
<body>
<div id="procaptcha-container"></div>
</body>
</html>
document.getElementById('procaptcha-script').addEventListener('load', function () {
function onCaptchaVerified(output) {
console.log('Captcha verified, output: ' + JSON.stringify(output))
}
const captchaContainer = document.getElementById('procaptcha-container')
window.procaptcha.render(captchaContainer, {
siteKey: 'YOUR_SITE_KEY',
theme: 'dark',
callback: onCaptchaVerified,
})
})6. Set captcha type (optional)
Can be explicitly selected:
- frictionless (default)
- pow
- image
For example:
<div class="procaptcha"
data-sitekey="your_site_key"
data-captcha-type="pow">
</div>7. Mandatory: server-side token verification
After rendering the captcha, the server must verify the response. Verification is done via API:
https://api.prosopo.io/siteverifyRequest contents:
{
"secret": "your_secret_key",
"token": "PROCAPTCHA-RESPONSE"
}8. Server-side verification in PHP
Example code:
<?php
function verifyToken($token) {
$url = 'https://api.prosopo.io/siteverify';
$data = json_encode(["secret" => "your_secret_key", "token" => $token]);
$options = [
'http' => [
'header' => "Content-Type: application/json\r\n",
'method' => 'POST',
'content' => $data,
],
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result, true);
return $response["verified"] ?? false;
}
?>What is considered successful verification?
If the Procaptcha server returns:
{
"verified": true
}— Captcha passed, protected action can be performed (e.g., register a user).
Supported captchas
reCAPTCHA v2reCAPTCHA v3reCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
FriendlyIf you’ve taken over a website that already has a captcha or another protection system installed, but you don’t have access to the code, don’t worry! It’s quite easy to identify which technology is being used. To verify that everything works correctly, you can use the CapMonster Cloud recognition service in an isolated test environment to make sure that the token processing mechanism and the validation logic are functioning properly.
In the case of Prosopo Procaptcha, it’s enough to detect the system, observe its behavior, and confirm that the protection is working correctly. In this article, we showed how to identify Prosopo Procaptcha and where to find instructions on how to integrate or reconfigure it, so you can confidently maintain the protection and keep its operation under control.
Frequently Asked Questions about Prosopo Procaptcha
