Sandbox Environment

The Linka Sandbox environment allows you to test your integration without processing real transactions or spending real money.

Overview

The sandbox is a complete replica of our production environment, but with test data and simulated responses. All API endpoints work identically to production, but transactions are not processed on real blockchains.

Accessing the Sandbox

API Endpoint

The sandbox uses a different base URL:

Production: https://api.linka.xyz
Sandbox:    https://sandbox.linka.xyz

API Keys

Log in to your Linka dashboard
Switch to Sandbox Mode (toggle in the top right)
Navigate to Developer → API Keys
Generate sandbox API keys (they start with sk_test_)

Test Data

Test Wallets

The sandbox provides pre-configured test wallets with balances:

{
  "wallet_id": "wal_test_123",
  "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0",
  "balance": "10000.00",
  "currency": "USDC"
}

Test Cards

Use these test card numbers for payment testing:

Success: 4242 4242 4242 4242
Decline: 4000 0000 0000 0002
Insufficient Funds: 4000 0000 0000 9995

Test Bank Accounts

Use these test bank account details:

Mexico (SPEI): 646180157000000004
Chile (TEF): 1234567890
Colombia (ACH): 12345678901234567890

Simulating Scenarios

Successful Payments

All payments in sandbox succeed by default. To test different scenarios, use special test amounts:

100.00 - Standard success
200.00 - Simulated delay (5 seconds)
300.00 - Requires additional verification

Failed Payments

Use these amounts to simulate failures:

400.00 - Insufficient funds
500.00 - Invalid account
600.00 - Network error

Webhook Testing

The sandbox automatically sends webhooks for all events. Your webhook endpoint will receive:

Instant notifications for all events
Test event types for all scenarios
Realistic event payloads matching production

Sandbox Limitations

The sandbox environment has some limitations:

No real blockchain transactions: All blockchain operations are simulated
No real money: All balances and transactions are test data
Rate limits: Same as production (1000 requests/minute)
Data retention: Test data is cleared periodically

Testing Checklist

Before moving to production, test these scenarios:

Create a wallet
Generate a deposit address
Initiate an on-ramp payment
Process an off-ramp payment
Handle webhook events
Test error scenarios
Verify compliance flows
Test multi-currency operations

Switching to Production

When you're ready to go live:

Review your integration - Ensure all error handling is in place
Generate production keys - Create new API keys in production mode
Update your endpoints - Change base URL to https://api.linka.xyz
Test with small amounts - Start with minimal transactions
Monitor closely - Watch logs and webhooks for any issues