Overview
The Yativo Crypto Sandbox is an isolated testing environment that mirrors the production API. Use the sandbox to build, test, and validate your integration without using real funds or affecting live accounts.Sandbox URL
https://crypto-sandbox.yativo.com/api/Production URL
https://crypto-api.yativo.com/api/What Is the Sandbox?
The sandbox is a testnet-based environment where:- No real funds are used — all tokens are testnet tokens with no monetary value
- All API endpoints mirror production — same request/response formats
- Credentials are separate — sandbox credentials do not work in production and vice versa
- Testnet blockchains are used — transactions are broadcast to testnets, not mainnet
Getting Sandbox Credentials
To get sandbox API credentials:- Register for a Yativo developer account at https://yativo.com/developers.
- Navigate to the Sandbox section of your developer dashboard.
- Generate a sandbox API key.
- Use the sandbox API key only with the sandbox base URL:
https://crypto-sandbox.yativo.com/api/.
Sandbox credentials and production credentials are entirely separate. You will have different API keys for each environment. Never use a production API key against the sandbox, or vice versa.
Supported Testnet Chains
The sandbox mirrors the production chain support, using their testnet equivalents:| Network | Testnet | Supported Tokens |
|---|---|---|
| Ethereum | Sepolia | USDC (testnet), ETH (testnet) |
| Solana | Solana Devnet | USDC (devnet), SOL (devnet) |
| Polygon | Polygon Mumbai (Amoy) | USDC (testnet), MATIC (testnet) |
| BNB Chain | BSC Testnet | USDC (testnet), BNB (testnet) |
| Avalanche | Fuji (C-Chain) | USDC (testnet), AVAX (testnet) |
Testnet tokens can be obtained from the respective blockchain testnets’ faucets. These tokens have no real-world value.
Sandbox Limitations
Understanding what the sandbox can and cannot do helps you plan your testing approach: What works in the sandbox:- Authentication (register, login, OTP verification)
- Wallet creation and management
- Viewing testnet balances
- Simulating transactions with testnet tokens
- Testing swap endpoints
- Testing IBAN onboarding flow
- Webhook delivery testing
The Yativo Card feature does not have a sandbox environment. Card endpoints (
/yativo-card/...) are not available in the sandbox. When building card integrations, refer to the mock response examples in the Cards sandbox documentation to understand expected response shapes, then test directly in production with real KYC-verified accounts.- Swap rates in the sandbox are simulated and do not reflect real market prices
- IBAN transfers cannot be sent from real banks to the sandbox IBAN
- Some third-party integrations may behave differently in the testnet environment
Testing Flow
A typical development workflow using the sandbox:Authenticate
Register and log in using the sandbox authentication endpoints. See Sandbox Authentication.
Create a wallet
Create a test wallet and add testnet assets. See Sandbox Wallets.
Test transactions
Send test transactions using testnet tokens. See Sandbox Transactions.
Test swaps
Try token swaps and verify the swap flow. See Sandbox Swaps.
Review Card mock responses
Study the mock card responses to prepare your card integration for production. See Cards in Sandbox.
Environment Variable Pattern
We recommend using environment variables to switch between sandbox and production:.env.sandbox
.env.production
Support
If you encounter issues with the sandbox environment, contact developer-support@yativo.com with:- Your sandbox API key (prefix only, not the full key)
- The endpoint you are calling
- The request body and response you received
- A timestamp of when the issue occurred