Visão Geral
O ambiente Sandbox da KillB permite que você teste sua integração sem processar transações reais ou movimentar fundos reais.
Todas as transações no sandbox usam dinheiro falso. Nenhum fundo real será transferido ou cobrado.
Ambientes
Sandbox (Teste)
Produção (Ao Vivo)
URL Base: https://teste-94u93qnn.uc.gateway.devRecursos:
- Teste com dinheiro falso
- Simule fluxos de pagamento
- Verificação KYC real não é necessária
- Processamento instantâneo de transações
- Funcionalidade completa da API
Use para:
- Desenvolvimento e testes
- Verificação de integração
- Aplicações de demonstração
- Testes CI/CD
URL Base: https://killb.appRecursos:
- Transações com dinheiro real
- Verificação completa KYC/KYB
- Processamento de pagamento real
- Conformidade regulatória
- Suporte de produção
Use para:
- Aplicações ao vivo
- Transações de usuários reais
- Implantações de produção
Passo 1: Obter Credenciais do Sandbox
- Cadastre-se em otc.killb.com
- Navegue até Configurações → Chaves de API
- Crie uma Chave de API Sandbox
- Anote seu email e senha do sandbox
Passo 2: Definir Variáveis de Ambiente
KILLB_ENV=sandbox
KILLB_BASE_URL=https://teste-94u93qnn.uc.gateway.dev
KILLB_EMAIL=[email protected]
KILLB_PASSWORD=sua-senha-sandbox
KILLB_API_KEY=sua-chave-api-sandbox
Passo 3: Autenticar
curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/auth/login \
--header 'Content-Type: application/json' \
--data '{
"email": "[email protected]",
"password": "sua-senha-sandbox"
}'
Recursos de Teste
Endpoints Faker
O Sandbox fornece endpoints especiais para simular eventos de pagamento:
Simule um usuário completando um pagamento fiat (PSE, SPEI, etc.)POST /api/v2/faker/cash-in
{
"rampId": "ramp-id-da-criacao"
}
- Marca o cash-in como concluído
- Aciona o processo de conversão
- Move o ramp para o próximo status
Exemplo:curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/faker/cash-in \
--header 'Authorization: Bearer SEU_TOKEN_DE_ACESSO' \
--header 'Content-Type: application/json' \
--data '{"rampId": "seu-ramp-id"}'
Simule a conclusão da conversão cripto para fiatPOST /api/v2/faker/cash-out
{
"rampId": "ramp-id-da-criacao"
}
- Completa o processo de cash-out
- Marca o ramp como COMPLETED
- Aciona webhooks
Exemplo:curl --request POST \
--url https://teste-94u93qnn.uc.gateway.dev/api/v2/faker/cash-out \
--header 'Authorization: Bearer SEU_TOKEN_DE_ACESSO' \
--header 'Content-Type: application/json' \
--data '{"rampId": "seu-ramp-id"}'
Fluxos de Teste
Teste Completo de On-Ramp
Criar Usuário de Teste
Use qualquer dado com aparência válida - nenhuma verificação real no sandbox{
"firstName": "Teste",
"lastName": "Usuário",
"email": "[email protected]",
"document": { "type": "PASSPORT", "number": "TEST123" }
}
Criar Conta de Carteira
Use qualquer formato de endereço de carteira válido{
"address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
"network": "POLYGON",
"currency": "USDC"
}
Criar Cotação
Obtenha uma cotação de teste com taxas do sandbox
Criar Ramp
Execute a transação ramp
Simular Pagamento
Use /api/v2/faker/cash-in para simular o pagamento do usuário
Verificar Conclusão
Verifique se o status do ramp muda para COMPLETED
Teste Completo de Off-Ramp
Criar Usuário de Teste
O mesmo que o fluxo de on-ramp
Criar Conta Bancária
Use detalhes bancários de teste{
"type": "PSE",
"accountNumber": "1234567890",
"bankCode": "0001"
}
Criar Cotação
Cotação de USDC para COP/MXN
Criar Ramp
Execute o ramp com fonte cripto
Simular Conclusão
Use /api/v2/faker/cash-out para completar o processo
Verificar Status
Confirme que o status é COMPLETED e os webhooks foram disparados
Dados de Teste
Contas Bancárias de Teste (Colômbia)
| Nome do Banco | Código do Banco | Tipo de Conta |
|---|
| Bancolombia | 0001 | poupança, corrente |
| Banco de Bogotá | 0002 | poupança, corrente |
| Davivienda | 0003 | poupança, corrente |
Contas Bancárias de Teste (México)
| Nome do Banco | Código do Banco | Formato CLABE |
|---|
| BBVA | 012 | 012XXXXXXXXXXXXXXXXX |
| Santander | 014 | 014XXXXXXXXXXXXXXXXX |
| Banorte | 072 | 072XXXXXXXXXXXXXXXXX |
Endereços de Carteira de Teste
Polygon (MATIC):
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
Solana:
5FHwkrdxntdK24hgQU8qgBjn35Y1zwhz1GZwCkP4UJnC
Ethereum:
0x71C7656EC7ab88b098defB751B7401B5f6d8976F
Tron:
TXYZopYRdj2D9XRtbG4uXyrFPRw6sM3pjN
Estes são endereços de exemplo para testes. No sandbox, qualquer endereço formatado corretamente funcionará.
Limitações do Sandbox
Esteja ciente destas diferenças entre sandbox e produção:
| Recurso | Sandbox | Produção |
|---|
| Dinheiro real | ❌ Não | ✅ Sim |
| Verificação KYC | ❌ Simulada | ✅ Verificação real |
| Processamento de pagamento | ⚡ Instantâneo | ⏱️ Tempo real |
| Limites de transação | ♾️ Sem limites | ✅ Baseado em KYC |
| Webhooks | ✅ Sim | ✅ Sim |
| Limites de taxa da API | 🔓 Relaxados | 🔒 Aplicados |
Depuração no Sandbox
Habilitar Log Detalhado
const DEBUG = process.env.KILLB_ENV === 'sandbox';
async function makeRequest(endpoint, options) {
if (DEBUG) {
console.log('Requisição:', endpoint, options);
}
const response = await fetch(endpoint, options);
const data = await response.json();
if (DEBUG) {
console.log('Resposta:', data);
}
return data;
}
Monitorar Status do Ramp
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(`Tentativa ${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('Timeout de conclusão do ramp');
}
Mudando para Produção
Quando estiver pronto para ir ao vivo:
Atualizar URL Base
Mude de teste-94u93qnn.uc.gateway.dev para killb.appconst baseUrl = 'https://killb.app';
Usar Credenciais de Produção
Substitua as credenciais do sandbox pelas chaves de API de produção
Remover Chamadas Faker
Remova todas as chamadas aos endpoints /api/v2/faker/*
Implementar KYC Real
Lide com verificação KYC real e uploads de documentos
Adicionar Tratamento de Erros
Implemente tratamento de erros e logs de nível de produção
Habilitar Monitoramento
Configure monitoramento e alertas para sua integração
Lista de Verificação de Testes
Antes de ir para produção, teste estes cenários:
Precisa de Ajuda?
