Bouncer

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:

  1. A Bouncer organization account
    If you don't have an account yet, register or log in to the Bouncer Portal.
  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 → 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 completing verification

Step 2: Redirect User

Redirect your user to the verify_url returned in the API response. The user will:

  1. See your organization's branded verification page
  2. Complete a quick liveness check (~3-5 seconds)
  3. If required, scan their ID document
  4. 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 verification
  • false — User failed verification
  • null — Verification still in progress

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

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