Sandbox Environment

Overview

The Yativo Crypto Sandbox is an isolated testing environment that mirrors the production API. All wallets and transactions in sandbox run on testnets only — no real funds are ever involved.

Sandbox URL

https://crypto-sandbox.yativo.com/api/v1/

Production URL

https://crypto-api.yativo.com/api/v1/

Quick Start — Use the Shared Sandbox Account

To get started immediately without registering, use the shared sandbox API key below. It’s public and pre-populated with accounts, wallets, customers, and a webhook so you can explore every endpoint right away.

This is a shared public account for exploration only. Do not store sensitive data here. For real integration testing, create your own sandbox account with a private API key.

Step 1 — Generate a Bearer Token

For quick documentation testing, use the long-lived docs token (valid 1 year):

curl -X GET 'https://crypto-sandbox.yativo.com/api/v1/sandbox/docs-token'

This returns a bearer token you can use immediately in the API playground above — no API key or secret needed.

Alternative — Generate a standard 60-minute token

curl -X POST 'https://crypto-sandbox.yativo.com/api/v1/auth/token' \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "yativo_e072b3ef7e30fcb420183aa86ddd8452abd28a9ac8f5d04d",
    "api_secret": "df8da4d6b855c7e89bd3b4216dd0a1f4b30de1963c9bff0dcd666b15a0f836a5"
  }'

You’ll get back an access_token. The docs token is valid for 1 year; the standard token lasts 60 minutes (call /auth/token again to refresh).

Step 2 — Start calling the API

curl -X GET 'https://crypto-sandbox.yativo.com/api/v1/accounts/get-accounts' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

The shared sandbox account is pre-populated with:

Resource	Details
Accounts	1 account — “Sandbox Main”
Assets	USDC (SOL testnet) at address `GY1EZGdpiJNyx2BSKq8rfTDRe5K8Bb6Cf2Bn1pdmE2o1`
Customers	2 customers — alice@example.com, bob@example.com
Webhooks	1 active webhook
Agentic Wallets	1 test wallet with connector
Payment Gateway	Simulated checkout available

The shared sandbox credentials above can also be used in the API playground on every API reference page in these docs. The docs default to the sandbox base URL — just paste your Bearer token and try any endpoint.

Create Your Own Sandbox Account

For private integration testing with dedicated credentials:

Register at crypto.yativo.com/sign-up
Log in and go to Developer → API Keys
Create an API key — it works against both sandbox and production (just change the base URL)
Use POST /auth/token with your credentials against https://crypto-sandbox.yativo.com/api/v1/

Sandbox vs Production

Feature	Sandbox	Production
Base URL	`https://crypto-sandbox.yativo.com/api/v1/`	`https://crypto-api.yativo.com/api/v1/`
API Keys	Same keys work on both	Same
Wallets	Testnet only — no real value	Mainnet, real funds
Blockchains	Testnets (Solana Devnet, Sepolia, etc.)	Mainnets
Swap rates	Simulated	Live market rates
IBAN	Testnet IBAN (no real banking)	Live EUR IBAN
Card program	Test-mode card provider with simulated transactions	Live card issuer
Payment Gateway	Simulated payments via sandbox endpoint	Live on-chain payments
Agentic Wallets	Testnet wallets with simulated transactions	Real wallets, real funds
Data	Isolated from production	Live data

All crypto wallets created in sandbox are on testnet chains. Addresses generated will never hold real funds. Testnet tokens can be obtained from each chain’s faucet.

Supported Testnet Chains

Network	Testnet Used
Solana	Devnet
Ethereum / Base	Sepolia
Gnosis	Chiado
Polygon	Amoy
BNB Chain	BSC Testnet

Sandbox Limitations

Yativo Card KYC: Uses a test-mode KYC and card provider. Transactions are simulated.
IBAN bank transfers: Cannot receive transfers from real banks — testnet only.
Swap rates: Simulated, not live market prices.
Email OTPs: Delivered to real email addresses, same as production.
Payment Gateway: Use the sandbox simulation endpoint to trigger payment confirmation.
Agentic Wallets: Testnet chains only. Use the simulation endpoint to generate mock agent transactions.

Sandbox Simulation Endpoints

These endpoints are only available in the sandbox environment and let you simulate events that normally require on-chain activity:

Endpoint	Description
`POST /sandbox/simulate-card-spend`	Simulate a card purchase
`POST /sandbox/generate-card-history`	Generate mock card transaction history
`POST /sandbox/simulate-gateway-payment`	Mark a gateway payment as paid
`POST /sandbox/simulate-agentic-transaction`	Create a mock agent transaction

Environment Variable Pattern

We recommend switching environments with a single variable change:

.env.sandbox

YATIVO_API_KEY=yativo_e072b3ef7e30fcb420183aa86ddd8452abd28a9ac8f5d04d
YATIVO_API_SECRET=df8da4d6b855c7e89bd3b4216dd0a1f4b30de1963c9bff0dcd666b15a0f836a5
YATIVO_BASE_URL=https://crypto-sandbox.yativo.com/api

.env.production

YATIVO_API_KEY=your_production_api_key
YATIVO_API_SECRET=your_production_api_secret
YATIVO_BASE_URL=https://crypto-api.yativo.com/api

Your integration code doesn’t change — only the environment variables.

Overview

Wallets & Assets

Transactions

Yativo Card

Payment Gateway

Agentic Wallets

IBAN

Automation

Compliance

B2B

Developer Tools

Tutorials

SDKs

Browser Extensions (Coming Soon)

Sandbox

Sandbox Environment

Overview

Sandbox URL

Production URL

Quick Start — Use the Shared Sandbox Account

Step 1 — Generate a Bearer Token

Step 2 — Start calling the API

Create Your Own Sandbox Account

Sandbox vs Production

Supported Testnet Chains

Sandbox Limitations

Sandbox Simulation Endpoints

Environment Variable Pattern

​Overview

Sandbox URL

Production URL

​Quick Start — Use the Shared Sandbox Account

​Step 1 — Generate a Bearer Token

​Step 2 — Start calling the API

​Create Your Own Sandbox Account

​Sandbox vs Production

​Supported Testnet Chains

​Sandbox Limitations

​Sandbox Simulation Endpoints

​Environment Variable Pattern

Overview

Quick Start — Use the Shared Sandbox Account

Step 1 — Generate a Bearer Token

Step 2 — Start calling the API

Create Your Own Sandbox Account

Sandbox vs Production

Supported Testnet Chains

Sandbox Limitations

Sandbox Simulation Endpoints

Environment Variable Pattern