README

Protect websites and apps against bots and spam with a privacy-first, EU-hosted CAPTCHA solution.

⚠️ DEPRECATED
This package has been renamed and is now maintained as trustcomponent/trustcaptcha-php (version 2.0.0 or above). Please update your composer.json!

What is TrustCaptcha?

TrustCaptcha combines proof-of-work, an AI bot-score and custom security rules to stop automated bot abuse — without image marking or puzzles

Key perks:

• Privacy-friendly & GDPR-compliant – data processed exclusively in Europe
• No visual challenges – users never label images or solve quizzes
• Fully themable widget – matches any brand and design and improves your user flow
• Conversion-safe – near-zero user drop-off compared to legacy CAPTCHAs

Read the full TrustCaptcha product overview for technical details and the security concept.

Get started

1. Create an account: sign up / sign in.
2. Choose a CAPTCHA: pick an existing one or create a new one.
3. Embed the widget: implement the TrustCaptcha widget into your website or app.
4. Validate result: validate the CAPTCHA verification result in your backend.

Need a walkthrough? See the PHP integration guide.

Short example

Here you can see a short code example of a possible integration. Please refer to our provided documentation for complete and up-to-date integration instructions.

Installing the library

npm i @trustcaptcha/trustcaptcha-nodejs

Fetching and handling the result

// Retrieving the verification result
let verificationResult = await CaptchaManager.getVerificationResult("<your_secret_key>", verificationToken);

// Do something with the verification result
if (!verificationResult.verificationPassed || verificationResult.score > 0.5) {
    console.log("Verification failed, or bot score is higher than 0.5 – this could indicate a bot.");
}

Installing the library

composer require trustcaptcha/trustcaptcha-php

Fetching and handling the result

// Retrieving the verification result
$verificationResult = null;
try {
  $verificationResult = CaptchaManager::getVerificationResult("<your_secret_key>", "<verification_token_from_your_client>");
} catch (Exception $e) {
  // Fetch verification result failed - handle error
}

// Do something with the verification result
if (!verificationResult.verificationPassed || verificationResult.score > 0.5) {
    console.log("Verification failed, or bot score is higher than 0.5 – this could indicate a bot.");
}

Other pre-built integrations

TrustCaptcha ships ready-made integrations for popular stacks:

• Platforms like WordPress, Joomla, CraftCMS or Keycloak
• Frontends like JavaScript, Angular, React or Vue.js
• Backends like Node.js, PHP, Python, Java, Ruby, Rust, Go or DotNet
• Mobile Applications like iOS, Android, React Native or Flutter

Discover all our pre-built Integrations on our website.

Get support

Questions? We will be happy to help!

• Email: mail@trustcomponent.com
• Contact form: reach the support team