Getting Started
Set up your first age verification with Bouncer
Getting Started
This guide will walk you through setting up your first age verification session with Bouncer.
Prerequisites
Before you begin, ensure you have:
- A Bouncer organization account
- An API token (see API Tokens)
Integration Overview
Bouncer uses a simple redirect-based flow:
Your App → Create Session → Redirect User → Bouncer Verification → Redirect Back → Check ResultQuick Start
Step 1: Create a Session
Use the Create Session API to create a new verification session with:
age_target: The minimum age to verify (e.g., 18)redirect_url: Where to send users after verification
Step 2: Redirect User
Redirect your user to the verify_url from the response. The user will:
- See the verification page with your organization branding
- Complete the liveness check (~3-5 seconds)
- If needed, scan their ID document
- Be redirected back to your
redirect_url
Step 3: Check Result
Use the Get Session Status API to check if verification succeeded.
The success field will be:
true- User passed verificationfalse- User failed verificationnull- Verification still in progress
For production, use Webhooks instead of polling for real-time notifications.
Configuration Options
| Option | Description |
|---|---|
age_target | Target age: 8, 13, 16, 18, 21, 25, or 30 |
force_kyc | Always require ID scan (skip age estimation) |
webhook_url | Receive real-time status updates |
metadata | Attach custom data (e.g., order ID) |
expiration_time | Session timeout (60-3600 seconds) |