Sistema de créditos

Argenapi usa un sistema de créditos prepagos. Comprás un pack de créditos y cada consulta consume 1 crédito.

Créditos por producto

Cada producto tiene su propio balance de créditos. Los créditos de CBU e Informes no se comparten ni son intercambiables.

Producto	Balance independiente	Ejemplo
`CBU`	Sí	Comprar 100 créditos CBU no afecta el saldo de Informes
`Informes`	Sí	Comprar 10 créditos Informes no afecta el saldo de CBU

¿Qué consume crédito? — CBU

Escenario	Consume crédito	Detalle
`Consulta exitosa`	Sí ✓	La consulta devuelve datos del titular
`CBU/Alias no encontrado (PA006)`	Sí ✓	El upstream procesó la consulta
`Error de sistema (GE500/GE403)`	No ✗	Se reembolsa automáticamente

¿Qué consume crédito? — Informes

Escenario	Consume crédito	Detalle
`Consulta exitosa (código 0)`	Sí ✓	Informe completo devuelto
`Persona no encontrada (código 370)`	Sí ✓	El proveedor procesó la consulta
`Duplicados (código 380)`	Sí ✓	Se devuelve data parcial
`Error de red / timeout`	No ✗	Se reembolsa automáticamente

El código 370 (persona no encontrada) consume crédito porque el proveedor upstream cobra la consulta. Verificá el CUIL antes de consultar.

Consultar saldo

GET/api/v1/balance—Devuelve el saldo de créditos de todos los productos

Este endpoint devuelve un array con el saldo por cada producto que la organización tenga activo.

Request

curl https://argenapi.com/api/v1/balance \
  -H "Authorization: Bearer TU_API_KEY"

Response 200

{
  "balances": [
    {
      "productSlug": "cbu-lookup",
      "productName": "Consulta Titular CBU",
      "balance": 87,
      "totalPurchased": 100,
      "totalConsumed": 13
    },
    {
      "productSlug": "buro-lookup",
      "productName": "Informe Crediticio",
      "balance": 45,
      "totalPurchased": 50,
      "totalConsumed": 5
    }
  ]
}

Error por créditos insuficientes

Si intentás hacer una consulta sin créditos, recibís un error 402:

402 Payment Required

{
  "success": false,
  "error_code": "INSUFFICIENT_CREDITS",
  "error_message": "Créditos insuficientes",
  "credits_remaining": 0,
  "request_id": "abc123..."
}