Getting Started

This guide will help you set up your first age verification session with Bouncer.

Prerequisites

Before you begin, make sure you have:

1. A Bouncer organization account
   If you don't have an account yet, ask your Bouncer contact, then log in to the Bouncer dashboard.
2. 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 (on success) → Check Result

Quick 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 a successful verification

Step 2: Redirect User

Redirect your user to the verify_url in the response data object (e.g. response.data.verify_url). The user will:

1. See your organization's branded verification page
2. Complete a face scan, which includes a liveness check and an age estimate
3. If required, scan their ID document
4. If the verification succeeds, be sent back to your redirect_url: straight away, after a short countdown, or when they click Continue, depending on your organization's Industry setting. After a failure there is no redirect.

Step 3: Check Result

Use the Get Session Status API to check if the verification succeeded.

The success field will be:

• true: User passed verification. This result is final
• false: User failed verification. Before expires_at it is not final: the user can still retry with an ID document
• null: Verification still in progress, or abandoned: there is no expired status, so once expires_at has passed, allow a short grace period for a scan already under way, then treat the session as not verified

Configuration Options

Next Steps