Getting Started
Set up your first age verification with Bouncer
Getting Started
This guide will help you set up your first age verification session with Bouncer.
Prerequisites
Before you begin, make sure you have:
- A Bouncer organization account
If you don't have an account yet, register or log in to the Bouncer Portal. - An API token (see API Tokens)
Integration Overview
Bouncer provides a simple, redirect-based age verification 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 start a new verification session. Provide:
age_target: The minimum age to verify (e.g., 18)redirect_url: Where the user goes after completing verification
Step 2: Redirect User
Redirect your user to the verify_url returned in the API response. The user will:
- See your organization's branded verification page
- Complete a quick liveness check (~3-5 seconds)
- If required, scan their ID document
- Be sent back to your
redirect_url
Step 3: Check Result
Use the Get Session Status API to check if the verification succeeded.
The success field will be:
true— User passed verificationfalse— User failed verificationnull— Verification still in progress
For production, use Webhooks for real-time notifications instead of polling.
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) |