Overview
The KillB Sandbox environment allows you to test your integration without processing real transactions or moving actual funds.
All sandbox transactions use fake money. No real funds will be transferred or charged.
Environments
Sandbox (Testing)
Production (Live)
Base URL: https://teste-94u93qnn.uc.gateway.devFeatures:
- Test with fake money
- Simulate payment flows
- No real KYC verification required
- Instant transaction processing
- Full API functionality
Use for:
- Development and testing
- Integration verification
- Demo applications
- CI/CD testing
Base URL: https://killb.appFeatures:
- Real money transactions
- Full KYC/KYB verification
- Actual payment processing
- Regulatory compliance
- Production support
Use for:
- Live applications
- Real user transactions
- Production deployments
Getting Started with Sandbox
Step 1: Get Sandbox Credentials
- Sign up at otc.killb.com
- Navigate to Settings → API Keys
- Create a Sandbox API Key
- Note your sandbox email and password
Step 2: Set Environment Variables
KILLB_ENV=sandbox
KILLB_BASE_URL=https://teste-94u93qnn.uc.gateway.dev
KILLB_EMAIL=[email protected]
KILLB_PASSWORD=your-sandbox-password
KILLB_API_KEY=your-sandbox-api-key
Step 3: Authenticate
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/auth/login \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"password": "your-sandbox-password"
}'
Testing Features
Faker Endpoints
Sandbox provides special endpoints to simulate payment events:
Simulate a user completing a fiat payment (PSE, SPEI, etc.)POST /api/v2/faker/cash-in
{
"rampId": "ramp-id-from-creation"
}
- Marks the cash-in as completed
- Triggers conversion process
- Moves ramp to next status
Example:curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/faker/cash-in \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"rampId": "your-ramp-id"}'
Simulate completion of crypto-to-fiat conversionPOST /api/v2/faker/cash-out
{
"rampId": "ramp-id-from-creation"
}
- Completes the cash-out process
- Marks ramp as COMPLETED
- Triggers webhooks
Example:curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/faker/cash-out \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data '{"rampId": "your-ramp-id"}'
Testing Workflows
Complete On-Ramp Test
Create Test User
Use any valid-looking data - no real verification in sandbox{
"firstName": "Test",
"lastName": "User",
"email": "[email protected]",
"document": { "type": "PASSPORT", "number": "TEST123" }
}
Create Wallet Account
Use any valid wallet address format{
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"network": "POLYGON",
"currency": "USDC"
}
Create Quotation
Get a test quote with sandbox rates
Create Ramp
Execute the ramp transaction
Simulate Payment
Use /api/v2/faker/cash-in to simulate user payment
Verify Completion
Check ramp status moves to COMPLETED
Complete Off-Ramp Test
Create Test User
Same as on-ramp flow
Create Bank Account
Use test bank details{
"type": "PSE",
"accountNumber": "1234567890",
"bankCode": "0001"
}
Create Quotation
Quote from USDC to COP/MXN
Create Ramp
Execute the ramp with crypto source
Simulate Completion
Use /api/v2/faker/cash-out to complete the process
Verify Status
Confirm status is COMPLETED and webhooks fired
Test Data
Test Bank Accounts (Colombia)
| Bank Name | Bank Code | Account Type |
|---|
| Bancolombia | 0001 | savings, checking |
| Banco de Bogotá | 0002 | savings, checking |
| Davivienda | 0003 | savings, checking |
Test Bank Accounts (Mexico)
| Bank Name | Bank Code | CLABE Format |
|---|
| BBVA | 012 | 012XXXXXXXXXXXXXXXXX |
| Santander | 014 | 014XXXXXXXXXXXXXXXXX |
| Banorte | 072 | 072XXXXXXXXXXXXXXXXX |
Test Wallet Addresses
Polygon (MATIC):
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
Solana:
5FHwkrdxntdK24hgQU8qgBjn35Y1zwhz1GZwCkP4UJnC
Ethereum:
0x71C7656EC7ab88b098defB751B7401B5f6d8976F
Tron:
TXYZopYRdj2D9XRtbG4uXyrFPRw6sM3pjN
These are example addresses for testing. In sandbox, any validly-formatted address will work.
Sandbox Limitations
Be aware of these differences between sandbox and production:
| Feature | Sandbox | Production |
|---|
| Real money | ❌ No | ✅ Yes |
| KYC verification | ❌ Simulated | ✅ Real verification |
| Payment processing | ⚡ Instant | ⏱️ Real timing |
| Transaction limits | ♾️ No limits | ✅ Based on KYC |
| Webhooks | ✅ Yes | ✅ Yes |
| API rate limits | 🔓 Relaxed | 🔒 Enforced |
Debugging in Sandbox
Enable Verbose Logging
const DEBUG = process.env.KILLB_ENV === 'sandbox';
async function makeRequest(endpoint, options) {
if (DEBUG) {
console.log('Request:', endpoint, options);
}
const response = await fetch(endpoint, options);
const data = await response.json();
if (DEBUG) {
console.log('Response:', data);
}
return data;
}
Monitor Ramp Status
async function waitForRampCompletion(rampId, maxAttempts = 30) {
for (let i = 0; i < maxAttempts; i++) {
const ramp = await fetch(`/api/v2/ramps/${rampId}`, {
headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());
console.log(`Attempt ${i + 1}: Status = ${ramp.status}`);
if (ramp.status === 'COMPLETED') {
return ramp;
}
if (['FAILED', 'CANCELED', 'REJECTED'].includes(ramp.status)) {
throw new Error(`Ramp ${ramp.status}: ${ramp.details}`);
}
await new Promise(resolve => setTimeout(resolve, 2000));
}
throw new Error('Ramp completion timeout');
}
Switching to Production
When you’re ready to go live:
Update Base URL
Change from teste-94u93qnn.uc.gateway.dev to killb.appconst baseUrl = 'https://killb.app';
Use Production Credentials
Replace sandbox credentials with production API keys
Remove Faker Calls
Remove all calls to /api/v2/faker/* endpoints
Implement Real KYC
Handle actual KYC verification and document uploads
Add Error Handling
Implement production-grade error handling and logging
Enable Monitoring
Set up monitoring and alerting for your integration
Testing Checklist
Before going to production, test these scenarios:
Need Help?
