Skip to main content
Tu saldo es un balance en MXN. Lo recargas tú (o lo recibes como bono al registrarte). Cada llamada al gateway descuenta su costo del saldo.

​
Cómo se calcula el saldo

Las transacciones tienen tipos:

​
Visibilidad

  • Tiempo real en el dashboard (app.geekhub.mx)
  • Endpoint API (próximo Sprint): GET /v1/credits regresará tu saldo actual
  • Headers de respuesta (próximo Sprint): cada response incluirá x-geekhub-balance-mxn

​
Threshold y alertas

Configura un cron en tu lado que cheque tu saldo (cuando habilitemos GET /v1/credits) y dispare alerta cuando esté < 1 día de uso típico.

​
Detalle de cada cobro

En /dashboard/usage tienes el log completo: cada request muestra:
  • Modelo usado
  • Tokens (in / out) o imágenes / segundos
  • Costo MXN exacto
  • Latencia P95
  • Estado (200 / 4xx / 5xx)
  • Timestamp
Y en /dashboard/billing tienes el detalle por movimiento (recargas, bonos, consumos agregados).

​
Race conditions

El descuento del saldo es atómico a nivel transacción Postgres: el trigger consume_credit_on_request() usa pg_advisory_xact_lock por org para serializar consumos concurrentes. Aunque hagas 100 requests paralelos, el balance_after siempre refleja el orden correcto.
Cero double-charging. Cada request fallido con cost_mxn > 0 no genera consumption (el trigger lo filtra).