Get Started in 5 Minutes
Follow these steps to integrate ECURTIY human verification into your website.
Step 1: Create an Account
Start by creating a free ECURTIY account. The free plan includes:
- 1,000 verifications per month
- 1 site registration
- Full API access
- Basic analytics
Step 2: Add Your Site
After logging in, go to the Sites section and click "Add New Site":
- 1Enter your site name
A friendly name to identify your site
- 2Add your domain
e.g., example.com (without https://)
- 3Choose widget mode
Checkbox, Slider, or Auto
- 4Copy your API keys
Site Key (public) and Secret Key (private)
Your API Keys:
eck_live_xxxxxxxx...ecs_live_xxxxxxxx...Step 3: Add the Widget
Add the widget to your HTML form:
<form action="/submit" method="POST">
<!-- Your form fields -->
<input type="email" name="email" required />
<!-- ECURTIY widget -->
<div id="ecurtiy-widget"></div>
<button type="submit">Submit</button>
</form>
<!-- Add before closing </body> tag -->
<script
src="https://your-domain.com/widget/ecurtiy.js"
data-site-key="eck_live_your_site_key"
async defer>
</script>The widget will automatically block form submission until verification is complete.
Step 4: Validate Server-Side
Always validate the verification token on your server before processing the form:
// Node.js example
app.post('/submit', async (req, res) => {
const { 'ecurtiy-token': token, email } = req.body;
// Validate the token
const response = await fetch('https://your-domain.com/api/validate', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
token,
secretKey: process.env.ECURTIY_SECRET_KEY
})
});
const { success, data } = await response.json();
if (!success || !data.passed) {
return res.status(400).json({ error: 'Verification failed' });
}
// Optionally check risk score
if (data.riskScore > 0.5) {
// Flag for manual review
}
// Process the form submission
// ...
});Important:
Never trust client-side verification alone. Always validate tokens server-side using your secret key.
Testing Your Integration
Test your integration before going live:
- 1Load your page
Verify the widget appears correctly
- 2Complete verification
Click the checkbox or slide to verify
- 3Submit the form
Verify the token is sent to your server
- 4Check server logs
Confirm validation succeeds
- 5View analytics
Check the dashboard for verification data