Payer Resolution
The server resolves the payer in this order (first match wins):- x402 receipt — Pay-per-use when credits are exhausted
- Sponsor grant — App-sponsored verifications (
X-Sponsor-Grantheader) - Gate billing — Gate creator pays
- Signature — User self-pay (wallet-signed request)
- No payer — Public demo cap (limited free usage)
Payer identity is never trusted from the request body. It is validated via cryptographic signature or receipt.
Credit Pricing
Verification Request
- Base: 1 credit (gate check)
- Verifier costs: Vary by verifier (see catalog)
- Persistence: +2 credits (if
persist=true) - IPFS: +20 credits (if
ipfs=trueorpin=true) - Extra chains: +10 credits per additional chain
Gate Check
- Base: 1 credit
- Extra verifiers: +1 credit per additional verifier
- Public demo cap: Free up to 50 results (no payer required)
Status Check
- Cost: Free (0 credits)
Payment Methods
Sponsor Grants
Apps can sponsor verifications for their users.- Header:
X-Sponsor-Grant: <jwt> - Use case: Onboarding where the app covers verification cost
User Self-Pay
Users pay with their own credit balance via signed requests.x402 (Pay-Per-Use)
When credits are exhausted, the API returns402 Payment Required with a quote. The client can pay via crypto and retry with the receipt.
- Header:
PAYMENT-SIGNATURE: <receipt> - Use case: One-off usage without pre-loading credits
x402 Pay-Per-Use
Full guide: quote, pay, retry with receipt.
Credit Packages
| Package | Credits | Price | Use Case |
|---|---|---|---|
| Public | 1,000/month | Free | Testing and proof creation |
| Pro | 50,000/month | $99.99/month | Production apps |
| Enterprise | Custom | Contact | High-volume, custom SLAs |
Pro Upgrade
- Price: $99.99/month
- Credits: 50,000 per month
- Checkout: Card payment via Hub (Profile → Credits → Upgrade)
- Top-ups: Separate from subscription; managed in Credits tab
Hub
Upgrade from Profile → Credits.
Public vs Private
- Public proofs: Anyone can check via
/api/v1/proofs/check(no auth required) - Private proofs: Owner-only access; requires authenticated session or owner signature