Understanding Credits
The free plan includes 100 verification credits per month. This guide explains how credits are tracked, what happens when they run out, and how to manage your usage.
How Credits Work
Credits are consumed per verification attempt, not per visitor session. The cost depends on the verification tier:
- Tier 1 (face liveness attempt): 1 credit
- Tier 2 (document verification attempt): 2 credits
A single visitor may consume multiple credits if they retry verification or if their session escalates from Tier 1 to Tier 2.
Example Scenarios
| Scenario | Credits Used |
|----------|-------------|
| Visitor passes Tier 1 on first try | 1 |
| Visitor fails Tier 1, passes on retry | 2 |
| Visitor passes Tier 1 but escalates to Tier 2, passes document check | 3 |
| Visitor passes Tier 1 but fails Tier 2 document, retries document and passes | 5 |
| Visitor goes directly to Tier 2 (required by region), passes both | 3 |
Monthly Reset
Credits reset on the first of each month (UTC). Unused credits do not roll over to the next month. The counter is based on when the verification attempt occurs, not when the session was started.
What Happens at the Credit Limit
When your monthly credits are exhausted, the behavior depends on your API Failure Behavior setting (found in Settings > Age Verification):
Fail Open (Default)
Visitors are allowed through without verification. Your site remains fully accessible. This is the recommended setting if uptime is more important than strict age-gating.
Fail Closed
Visitors from age-gated regions are redirected to an error page. They cannot access your content until credits reset or you add more credits. This is the recommended setting for regulatory compliance, where allowing unverified visitors is not acceptable.
In-Progress Verifications
If a visitor has already started a verification session when the credit limit is reached, their session is allowed to complete. Credits are only checked when a new session is created. This prevents the confusing experience of a visitor being cut off mid-verification.
Monitoring Your Credits
From the Settings Page
Go to Settings > Age Verification. The status section shows your current credit usage and monthly limit.
From the Free Plan Admin
Go to Settings > Free Plan. The Recent Verifications tab shows each verification session and how many credits it consumed.
Getting More Credits
Credit packs are available for purchase. When you buy a credit pack, the credits are added to your prepaid balance and remain available until used — they do not expire or reset monthly. This is separate from your free plan's 100 monthly credits, which continue to reset on the first of each month.
If your site regularly needs high volumes of verifications, consider upgrading to the Pro plan for unlimited verifications and additional features.
Estimating Your Credit Needs
To estimate how many credits you'll need per month:
- Estimate unique visitors from age-gated regions. This is a fraction of your total traffic — only visitors from regions you've configured.
- Most visitors pass Tier 1 on the first try (1 credit each). Budget about 1.2 credits per visitor to account for retries and escalations.
- If you require Tier 2 for any region, budget about 3 credits per visitor for those regions.
- Verification cookies last across visits. Once a visitor is verified, they won't use credits again until the cookie expires.
For most small to medium sites with standard Tier 1 verification, 100 credits per month covers roughly 80-90 unique verified visitors.
Next Steps
