Modo Sandbox

¿Qué es?

Una API key sandbox es una clave que empieza con sk_test_ y que, en lugar de consultar el proveedor real, devuelve siempre los mismos datos de prueba (Lionel Messi). Todo lo demás se comporta como una key de producción: la autenticación, el rate limiting, los permisos por scope, la lista de IPs permitidas y la restricción de producto se aplican igual.

Es útil para CI/CD, smoke tests, demos y desarrollos donde no querés gastar créditos contra el proveedor real.

Cómo crear una key sandbox

1. Entrá al Dashboard y andá a API Keys.
2. Click en Crear API Key.
3. Completá el nombre, producto y scopes como con una key normal.
4. Marcá la opción Modo sandbox.
5. Guardá. La key generada tendrá el prefijo sk_test_ y va a aparecer con un badge Sandbox en la tabla.

Diferencias con producción

Comportamiento por endpoint

POST /api/v1/lookup

Devuelve datos de Messi independientemente del CBU o alias que envíes.

curl -X POST "https://www.argenapi.com/api/v1/lookup" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"identifier": "0720480188000003214022", "type": "cbu"}'

{
  "success": true,
  "data": {
    "holders": [
      {
        "tax_id": "20305215929",
        "full_name": "LIONEL ANDRES MESSI",
        "tax_id_type": "CUIT",
        "is_individual": true
      }
    ],
    "account_type": "CA",
    "active": true,
    "currency": "ARS",
    "alias": "lionel.messi10",
    "account": { "scheme": "CBU", "number": "0720480188000003214022" },
    "bank": { "name": "BANCO SANTANDER ARGENTINA S.A.", "code": "072" }
  },
  "credits_remaining": 999999,
  "request_id": "...",
  "sandbox": true
}

POST /api/v1/credit/lookup

Devuelve un informe crediticio completo de Messi para cualquier CUIL o DNI. La estructura es idéntica a producción — mirá el informe modelo para ver todos los campos.

curl -X POST "https://www.argenapi.com/api/v1/credit/lookup" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"cuil": "20305215929"}'

GET /api/v1/balance

Devuelve un saldo sintético de 999999 para cada producto. No refleja el balance real de tu organización.

GET /api/v1/history

Devuelve una página vacía. Las consultas hechas con keys sandbox no se persisten, así que el historial de la org no se ensucia con tráfico de testing.

El campo sandbox

Toda respuesta originada por una key sandbox incluye "sandbox": true en el cuerpo. Lo podés usar como guard en tu app para evitar mostrar datos de prueba como si fueran reales:

const res = await fetch("https://www.argenapi.com/api/v1/lookup", { /* ... */ });
const body = await res.json();

if (body.sandbox) {
  console.warn("Datos sandbox — no usar en flujos productivos");
}

Límites y consideraciones

• • El rate limit configurado en la key (por defecto 60 req/min) aplica también en sandbox. Previene abuso del endpoint de fixtures.
• • Una key sandbox no puede convertirse en live ni viceversa. Si necesitás ambas, creá dos keys.
• • Las keys sandbox cuentan dentro del límite de 10 keys activas por organización.
• • Todas las consultas sandbox devuelven los mismos datos (Lionel Messi). No hay casos de error mockeados todavía — para reproducir errores, usá una key live con identificadores inválidos.