Fastify CAPTCHA Integration
Set up a Fastify CAPTCHA in a route or preHandler hook with a few lines of TypeScript. TrustCaptcha stops bot spam on logins, signups and contact forms, and your schema validation and formbody plugin keep working. EU-hosted, GDPR-compliant, no image puzzles.
Quickstart
How the integration works
1. Create a CAPTCHA
Create a user account or log in with an existing one. Then create a new CAPTCHA or pick an existing one. If you want to try TrustCaptcha first, every plan comes with a 14-day free trial.
The CAPTCHA overview page shows your site key and license key, and you create your API key there. Add your website’s domains to the authorized domains in the CAPTCHA security rules so they can use your CAPTCHA.


2. Add the CAPTCHA widget to your form
Drop the TrustCaptcha widget into the HTML form your Fastify route serves. The widget runs the CAPTCHA in the background and adds a hidden tc-verification-token field on submit, which arrives on request.body like any other input.
<script type="module" src="https://cdn.trustcomponent.com/trustcaptcha/3.0.x/trustcaptcha.esm.min.js"></script>
<form method="post" action="/contact">
<input type="email" name="email" required>
<trustcaptcha-component sitekey="<your_site_key>"></trustcaptcha-component>
<button type="submit">Send</button>
</form>The CAPTCHA widget will then be displayed inside your form:

Need detailed information about the CAPTCHA widget integration?
Our documentation has the full widget reference, including themes, languages and custom design.
Read the documentation
3. Validate the token in your Fastify route
In your Fastify route handler, take the verification token from request.body, look up the result via our Node.js library, and decide whether to accept the request.
First, install our TrustCaptcha Node.js library along with Fastify’s formbody plugin:
npm i fastify @fastify/formbody @trustcomponent/trustcaptcha-nodejsThen validate the token inside your Fastify route and act on the result:
import Fastify from "fastify";
import formbody from "@fastify/formbody";
import { TrustCaptcha } from "@trustcomponent/trustcaptcha-nodejs";
const fastify = Fastify();
await fastify.register(formbody);
fastify.post("/contact", async (request, reply) => {
const body = request.body as Record<string, string>;
const token = body["tc-verification-token"] ?? "";
try {
const result = await TrustCaptcha.getVerificationResult("<your_api_key>", token);
if (!result.verificationPassed || result.score > 0.5) {
return reply.code(400).send("CAPTCHA verification failed.");
}
} catch {
return reply.code(400).send("CAPTCHA verification failed.");
}
// CAPTCHA passed — process the request
return reply.send("Thanks!");
});Need detailed information about the Fastify CAPTCHA integration?
For full step-by-step instructions, including a reusable preHandler hook for projects with several protected routes, please read our documentation.
Read the documentation
Other backend framework instead of Fastify?
If you use a different framework, pick the matching recipe here. If your framework isn’t listed, your software developers can integrate the verification themselves using our documentation or ask our support team for a pre-built integration.
4. Test your integration
TrustCaptcha is now active. Send a test request and check that it goes through.

FAQs
Where does the Fastify CAPTCHA check go?
Do I need a special plugin to receive form submissions?
How do I share the API key and the SDK across routes?
Will Fastify's JSON Schema validation strip the CAPTCHA token?
Can I scope the CAPTCHA hook to a group of routes?
TrustCaptcha blocks spam and bots, not customers. No puzzles, GDPR-compliant, EU-hosted.


Protect your Fastify application with TrustCaptcha in just a few steps!
- EU-hosted & GDPR-compliant
- No puzzles
- Try free for 14 days