Skip to main content

Dashboard Guide

The SafePassage Dashboard is your central hub for managing API keys, monitoring analytics, and configuring webhooks.

Related Resources

Getting Started​

Access your dashboard at https://portal.safepassageapp.com.

First Time Setup​

  1. Create Account: Sign up with your business email
  2. Verify Email: Check your inbox for verification
  3. Create API Keys: Generate your first key pair for integration

Dashboard Sections​

Overview​

Your dashboard home page shows:

  • Usage Metrics: Verification counts and success rates
  • Quick Actions: Links to Analytics, API Keys, and Billing
  • Account Status: Current plan and usage

Analytics​

View aggregate verification insights and trends:

  • Key Metrics: Total unique sessions, total verifications, conversion rates
  • Verification Trends: Volume and conversion rate over time
  • Time Range: 24 hours, 7 days, 30 days, or custom date range
  • Device Analytics: Usage breakdown by device type with conversion rates
  • Geographic Distribution: Top locations by verification volume
  • Outcome Breakdown: Verified, failed, cancelled, and expired sessions (mutually exclusive; system/session errors are excluded)
  • API Key Filtering: View metrics for specific API keys or key pairs

Analytics focuses on high-level trends and performance metrics. For individual verification records, use the Verifications page.

Verifications​

Browse, search, and filter individual verification sessions.

Search:

  1. Enter an externalUserId or Session ID (UUID)
  2. Click Search to find matching sessions
  3. Leave blank to browse all sessions in the selected range

Filters:

FilterOptions
OutcomeCompleted (Success + Failed), Success only, Failed only
ModeAll, L1, L2
DeviceAll, Desktop, Mobile, Unknown
CountryDynamically populated from your verification data
Time RangeLast 24h, Last 7 days, Last 30 days, Custom
API KeyAll keys, specific key pair, or individual key

Results table:

  • Session ID — Click to copy full ID
  • External User ID — Click to copy (if provided)
  • Timestamp — Date and time of verification
  • Device — Desktop, Mobile, or Unknown
  • Country — User's country (from geolocation)
  • Mode — L1 or L2
  • Outcome — SUCCESS or FAILED

API Keys​

Manage your integration credentials:

  • Publishable Keys (pk_...): For client-side SDK
  • Secret Keys (sk_...): For server-side API
  • Key Pairs: Created together for security

Integration Tools​

Ready-to-use code examples:

  • Frontend Integration: Simple client-side implementation
  • Server-side Integration: Complete backend workflow
  • Multiple Languages: Node.js, Python, PHP examples
  • Framework Support: React, Vue, Angular

Configuration​

Manage your verification settings across four tabs:

Verification​

  • Verification Mode: Choose L1 or L2. See Verification Modes for details.
  • Challenge Age: Age threshold for L1 mode (25-99). Users estimated at or above this age pass without ID.

Domains​

Restrict which domains can use your API keys:

  • Root domains (e.g., example.com) automatically include all subdomains (www.example.com, shop.example.com, etc.)
  • Subdomains (e.g., www.example.com) match exactly—they do not include the root domain
  • Leave empty to accept requests from all domains (default)

Enter domains without https:// or trailing slashes.

Webhooks​

Configure event notifications. See Webhooks for setup.

Emblem​

Enable or disable the Emblem integration for portable age verification accounts.

Billing​

Manage subscription and payments via PayPal:

  • Current Plan: View plan details and usage limits
  • Usage Tracking: Monitor verification counts and overages
  • Payment History: Download invoices and payment records
  • Subscription Management: Upgrade, downgrade, or cancel

Team​

Manage your team with role-based access control:

Roles​

RoleDescription
OwnerFull account access. Can manage billing, delete the account, and assign any role including Owner.
AdminFull product access. Can manage team members and billing, but cannot delete the account or modify Owner roles.
MemberDay-to-day access. Can view analytics, manage API keys, and configure verification settings. Cannot access billing or manage team.
ViewerRead-only access. Can view analytics and reporting data only.

Permissions by Role​

PermissionOwnerAdminMemberViewer
Analytics✓✓✓✓
API Keys✓✓✓—
Configuration✓✓✓—
Billing✓✓——
Invite members✓✓——
Change roles✓✓*——
Delete account✓———

*Admins cannot modify Owner roles.

Managing Members​

  • Invitations: Invite team members by email with a required role selection
  • Role Changes: Owners and Admins can change member roles inline from the team list
  • Activity Tracking: View last active timestamps for all members

Account Settings​

Manage your account:

  • Account Information: View email and role
  • Account Deletion: Secure account removal with confirmations

Key Features​

Webhook Testing​

Test webhook endpoints directly from the dashboard:

  1. Configure webhook URL in Configuration
  2. Select events to receive
  3. Use test button to send sample events
  4. Verify your endpoint receives events correctly

Responsive Design​

The dashboard works on all devices:

  • Mobile-friendly interface
  • Touch-optimized controls
  • Consistent experience across platforms

Getting Help​

Email: support@safepassageapp.com

Include session IDs and error messages for faster support.