Ambiente sandbox

El ambiente sandbox de Linka permite probar una integracion sin procesar transacciones reales ni mover fondos reales.

Resumen

Sandbox replica el comportamiento de produccion con datos de prueba y respuestas simuladas. Los endpoints funcionan igual, pero las transacciones no se ejecutan en redes blockchain reales.

Acceso a sandbox

Endpoint API

Sandbox usa una URL base distinta:

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

API keys

Inicia sesion en el dashboard de Linka.
Cambia a Sandbox Mode.
Ve a Developer -> API Keys.
Genera llaves sandbox. Empiezan con sk_test_.

Datos de prueba

Wallets de prueba

Sandbox incluye wallets preconfiguradas con saldos simulados:

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

Tarjetas de prueba

Usa estos numeros para probar pagos:

Exito: 4242 4242 4242 4242
Rechazo: 4000 0000 0000 0002
Fondos insuficientes: 4000 0000 0000 9995

Cuentas bancarias de prueba

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

Simular escenarios

Pagos exitosos

Los pagos en sandbox son exitosos por defecto. Para probar otros escenarios, usa montos especiales:

100.00 - Exito estandar.
200.00 - Retraso simulado de 5 segundos.
300.00 - Requiere verificacion adicional.

Pagos fallidos

Usa estos montos para simular fallas:

400.00 - Fondos insuficientes.
500.00 - Cuenta invalida.
600.00 - Error de red.

Pruebas de webhook

Sandbox envia webhooks automaticos para todos los eventos, con tipos y payloads similares a produccion.

Limitaciones de sandbox

Sin transacciones reales: las operaciones blockchain son simuladas.
Sin dinero real: saldos y transacciones son de prueba.
Limites de uso: similares a produccion.
Retencion de datos: los datos de prueba pueden limpiarse periodicamente.

Checklist antes de produccion

Crear una wallet.
Generar una direccion de deposito.
Iniciar un flujo on-ramp.
Procesar un flujo off-ramp.
Manejar eventos webhook.
Probar escenarios de error.
Validar flujos de cumplimiento.
Probar operaciones multi-moneda.

Pasar a produccion

Cuando estes listo:

Revisa la integracion y el manejo de errores.
Genera llaves de produccion.
Actualiza endpoints a https://api.linka.xyz.
Empieza con montos pequenos.
Monitorea logs y webhooks durante las primeras operaciones.