Ir al contenido
Eventos

FISCALISTO / API / REFERENCIA

balance.low

A la cuenta le quedan pocos timbres de producción: llega al bajar a low_balance_at (se elige en Desarrolladores › Timbres) y otra vez cuando se acaban, una vez cada uno hasta que vuelva a tener más. data.object es el saldo, como lo da GET /v1/balance. Siempre en producción. Llega a sus webhooks como POST firmado con Standard Webhooks (encabezados webhook-id, webhook-timestamp y webhook-signature).

Cuerpo de la solicitud

application/json
  1. body

Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks).

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

object*string

Qué tipo de objeto es («invoice», «customer»…).

type*string

Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, issuer.ready, balance.low o test_clock.ready.

api_version*string

Versión de la API con que se armó el objeto.

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

created_at*string

Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).

Formatodate-time
data*

Lo que cambió, en data.object: el comprobante (o el lote) completo, como lo contesta su GET.

Cuerpo de la respuesta

Conteste 2xx en menos de 15 segundos; si no, se reintenta durante un día.

Así llega a su webhook

{  "id": "evt_0PKhIdhYuAGwzmMQYfkc",  "object": "event",  "type": "balance.low",  "api_version": "2026-10-24",  "livemode": true,  "created_at": "2026-10-24T10:15:42-06:00",  "data": {    "object": {      "object": "balance",      "livemode": true,      "available": 87,      "unlimited": false,      "low_balance_at": 100,      "auto_recharge": null,      "packs": [        {          "timbres": 20,          "remaining": 20,          "purchased_at": "2026-10-24T10:15:42-06:00",          "expires_at": null        }      ]    }  }}