Developer Guides
Sandbox Testing
Every partner account ships with sandbox keys backed by Solana devnet. Test everything end-to-end before flipping to live.
Get sandbox keys
Open the Partner Dashboard → API Keys, and copy your sk_test_… key.
Fund a test wallet
- Create a sandbox Vaulty wallet on devnet.
- Use the Solana devnet faucet or `solana airdrop 2` to get test SOL.
- Request test USDC from the dashboard faucet (one-click).
Run end-to-end checks
- Create a payment via SDK or API and approve it in the sandbox wallet.
- Verify the redirect lands on your success URL.
- Verify the webhook arrives and your signature check passes.
- Simulate failures: insufficient_funds, user_rejected, timeout.
Going live
When tests pass, swap sk_test_… for sk_live_… and set env to "live". Nothing else changes.

