Bouncer

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:

  1. A Bouncer organization account
  2. 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 Result

Quick 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:

  1. See the verification page with your organization branding
  2. Complete the liveness check (~3-5 seconds)
  3. If needed, scan their ID document
  4. 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 verification
  • false - User failed verification
  • null - Verification still in progress

For production, use Webhooks instead of polling for real-time notifications.

Configuration Options

OptionDescription
age_targetTarget age: 8, 13, 16, 18, 21, 25, or 30
force_kycAlways require ID scan (skip age estimation)
webhook_urlReceive real-time status updates
metadataAttach custom data (e.g., order ID)
expiration_timeSession timeout (60-3600 seconds)

Next Steps

On this page