Compra de créditos

Los créditos son la unidad de consumo de la Scoring API de vario. Al registrarte recibes 250 créditos de bienvenida. Cuando los agotes, puedes recargar eligiendo el monto en USD que quieras cargar.

ℹ

vario no almacena ni retiene el texto analizado. Cada llamada al endpoint de análisis es stateless e independiente.

Precio y equivalencias

$0,150 USD por crédito.

Modo	Créditos por llamada	Costo por llamada
`screening`	1 crédito	$0,150
`fast`	2 créditos	$0,300
`full`	3 créditos	$0,450

Opciones de recarga (top-up por monto)

Elige cuánto quieres cargar; los créditos se calculan automáticamente.

ID opción	Monto USD	Créditos	Llamadas `screening`	Llamadas `fast`	Llamadas `full`
`top75`	$75	500	500	250	166
`top150`	$150	1.000	1.000	500	333
`top300`	$300	2.000	2.000	1.000	666
`top1000`	$1.000	6.666	6.666	3.333	2.222
`custom`	libre	calculado	—	—	—

Para custom, el monto mínimo es $10 y el máximo es $5.000.

1. Ver opciones disponibles

GET /api/public/checkout/credits/preview

Endpoint público, sin autenticación. Retorna las opciones de recarga disponibles.

curl https://api.vario.lat/api/public/checkout/credits/preview

Response 200:

{
  "options": [
    { "id": "top75",   "label": "$75",    "amount_usd": 75.0,    "credits_preview": 500,   "status": "available" },
    { "id": "top150",  "label": "$150",   "amount_usd": 150.0,   "credits_preview": 1000,  "status": "available" },
    { "id": "top300",  "label": "$300",   "amount_usd": 300.0,   "credits_preview": 2000,  "status": "available" },
    { "id": "top1000", "label": "$1.000", "amount_usd": 1000.0,  "credits_preview": 6666,  "status": "available" },
    { "id": "custom",  "label": "otro",   "amount_usd": null,    "credits_preview": null,  "status": "available" }
  ],
  "current_balance": null,
  "pricing_note": "$0.150 per credit."
}

ℹ

El campo current_balance es null en este endpoint público. Para ver tu saldo actual, usa GET /api/v1/api-keys/credits con autenticación.

2. Iniciar recarga

POST /api/public/checkout/credits

Inicia el proceso de pago para el monto seleccionado. El endpoint devuelve un transaction_id que se usa para abrir el overlay de pago de Paddle.

Auth: ninguna (pública). El tenant_id identifica al comprador.

Parámetros del request:

Campo	Tipo	Requerido	Descripción
`top_up_id`	`string`	✅	Opción a comprar: `"top75"`, `"top150"`, `"top300"`, `"top1000"` o `"custom"`.
`tenant_id`	`string (uuid)`	✅	Identificador del tenant que recibirá los créditos.
`custom_amount_usd`	`float`	Solo si `top_up_id == "custom"`	Monto en USD (mín $10, máx $5.000).

Ejemplo — opción fija:

curl -X POST https://api.vario.lat/api/public/checkout/credits \
  -H "Content-Type: application/json" \
  -d '{
    "top_up_id": "top300",
    "tenant_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

Response 200:

{
  "transaction_id": "txn_01jxabc123def456",
  "top_up_id": "top300",
  "credits": 2000,
  "amount_usd": 300.0
}

Abrir el overlay de pago con el transaction_id devuelto:

Paddle.Checkout.open({ transactionId: response.transaction_id });

Al completarse el pago, los créditos quedan disponibles de inmediato en el balance del tenant.

Errores posibles:

HTTP	Descripción
`400`	`top_up_id` inválido.
`422`	`custom_amount_usd` ausente, menor a $10 o mayor a $5.000.
`402`	El tenant no tiene método de pago registrado.
`404`	Tenant no encontrado.
`502`	Error del proveedor de pagos.

3. Consultar saldo actual

GET /api/v1/api-keys/credits

Retorna el balance de créditos disponibles del tenant autenticado.

curl https://api.vario.lat/api/v1/api-keys/credits \
  -H "Authorization: Bearer vario_TU_API_KEY"

Response 200:

{
  "balance": 2000,
  "call_cost_screening": 1,
  "call_cost_fast": 2,
  "call_cost_full": 3,
  "estimated_calls_remaining_screening": 2000,
  "estimated_calls_remaining_fast": 1000,
  "estimated_calls_remaining_full": 666,
  "pricing_note": "$0.150 per credit."
}

4. Historial de uso

GET /api/v1/api-portal/usage

Retorna el consumo de créditos del tenant desglosado por día.

curl "https://api.vario.lat/api/v1/api-portal/usage?from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer vario_TU_API_KEY"

Response 200:

{
  "period": { "from": "2026-06-01", "to": "2026-06-30" },
  "total_credits_used": 1250,
  "total_calls": 520,
  "daily": [
    { "date": "2026-06-01", "credits_used": 45, "calls": 18 },
    { "date": "2026-06-02", "credits_used": 60, "calls": 24 }
  ]
}

Flujo completo — recargar y verificar créditos

# 1. Ver opciones disponibles
curl https://api.vario.lat/api/public/checkout/credits/preview

# 2. Iniciar recarga de $300 (2.000 créditos)
curl -X POST https://api.vario.lat/api/public/checkout/credits \
  -H "Content-Type: application/json" \
  -d '{"top_up_id": "top300", "tenant_id": "TU-TENANT-UUID"}'

# → Abrir overlay de Paddle con el transaction_id devuelto
# → Completar pago en el overlay

# 3. Verificar que los créditos se acreditaron
curl https://api.vario.lat/api/v1/api-keys/credits \
  -H "Authorization: Bearer vario_TU_API_KEY"