Sandbox / Testnet
AdPriva provides a sandbox environment and testnet so developers, publishers and advertisers can test integrations before moving to production.
This lets you validate tag installation, proof flows, API calls and settlement logic in a safe, risk-free environment.
Why Use the Sandbox
- Safe Testing → No financial settlements; rewards use test stablecoins.
- Faster Iteration → Debug proofs, dashboards and APIs without live impact.
- Team Onboarding → Perfect for demos, workshops and evaluations.
What’s Included
- Test Publisher Accounts → Register sites/apps instantly, no approvals.
- Test Advertiser Accounts → Launch campaigns with dummy budgets.
- Sandbox Tag / SDK → Generates fake but verifiable proofs.
- Testnet Explorer → Inspect ViewProofs, ClickProofs and ConversionProofs.
- Stablecoin Faucet → Simulated payouts (not real crypto).
- API Access → Same endpoints and proof formats as production (/proofs, /verify, /snapshots) under the sandbox namespace.
Getting Started
- Sign Up → Request a sandbox developer account.
- Obtain Keys → Generate API keys (prefixed with test_…).
- Integrate Tag/SDK → Add sandbox Tag/SDK into your staging site or app.
- Run Test Campaigns → Upload dummy creatives and allocate test budgets.
- Validate Proofs → Check receipts in the Testnet Explorer.
- Migrate to Production → Swap sandbox-api.adpriva.com for api.adpriva.com and update keys.
API Base URLs
# Sandbox / Testnet
https://sandbox-api.adpriva.com/v1
# Production
https://api.adpriva.com/v1
Limitations
- Rewards use test stablecoins only (no real payouts).
- Proofs are valid in sandbox but not anchored on mainnet.
- Logs reset periodically for clean testing.
- Campaign scale limited → sandbox not for benchmarking.
The Sandbox/Testnet is your playground for experimentation making migration to production seamless, fast and risk-free.
{% @mermaid/diagram content="flowchart LR
A\[Sandbox Account] --> B\[Generate test\_ API Keys]
B --> C\[Integrate Sandbox Tag/SDK]
C --> D\[Run Test Campaigns]
D --> E\[Validate Proofs in Testnet Explorer]
E --> F\[Migrate to Production: swap API base + keys]
F --> G\[Live Campaigns with Stablecoin Settlement]" %}