Eventos de facturación

Suscripción, facturas y límites de consumo.

Suscripción, facturas y límites de consumo. Son 7 eventos. Todos llegan con la envoltura estándar y su contenido propio en data.

subscription.created

Se activó una suscripción.

Disponible desde 2026-01-15. Volumen bajo.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`plan`	string	free \| starter \| pro \| business, que en la interfaz se llaman Free, Esencial, Avanzado y Experto
`seats`	number	Asientos, se factura por plaza
`interval`	string	monthly \| yearly

subscription.created

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "subscription.created",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "plan": "pro",    "seats": 15,    "interval": "monthly"  }}

subscription.updated

Cambió el plan o la cantidad de asientos.

Disponible desde 2026-01-15. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`plan`	string	Plan nuevo: free \| starter \| pro \| business
`previous_plan`	string	Plan anterior
`seats`	number	Asientos
`prorated_amount_ars`	number	Prorrateo en pesos argentinos

subscription.updated

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "subscription.updated",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "plan": "pro",    "previous_plan": "starter",    "seats": 15,    "prorated_amount_ars": 33458  }}

subscription.canceled

Se canceló la suscripción.

Disponible desde 2026-01-15. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`ends_at`	string	Fecha ISO 8601
`reason`	string	Motivo declarado o null

subscription.canceled

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "subscription.canceled",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "ends_at": "2026-09-02T14:03:11.000Z",    "reason": "low_confidence"  }}

invoice.paid

Se cobró una factura.

Disponible desde 2026-01-15. Volumen bajo.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`number`	number	Número de factura
`amount_ars`	number	Importe en pesos
`period_start`	string	Fecha ISO 8601
`period_end`	string	Fecha ISO 8601

invoice.paid

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "invoice.paid",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "number": 1041,    "amount_ars": 79900,    "period_start": "2026-09-02T14:03:11.000Z",    "period_end": "2026-09-02T14:03:11.000Z"  }}

invoice.payment_failed

Falló el cobro.

Disponible desde 2026-01-15. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`id`	string	ID del objeto
`number`	number	Número de factura
`amount_ars`	number	Importe en pesos
`failure_reason`	string	Motivo del rechazo
`retry_at`	string	Fecha ISO 8601

invoice.payment_failed

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "invoice.payment_failed",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "id": "cv_1832",    "number": 1041,    "amount_ars": 79900,    "failure_reason": "card_declined",    "retry_at": "2026-09-02T14:03:11.000Z"  }}

usage.limit_approaching

El consumo llegó al 80% del límite del plan.

Disponible desde 2026-03-05. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`metric`	string	ai_resolutions \| contacts \| storage \| seats
`used`	number	Consumido
`limit`	number	Límite del plan

usage.limit_approaching

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "usage.limit_approaching",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "metric": "ai_resolutions",    "used": 12400,    "limit": 15000  }}

usage.limit_reached

Se alcanzó un límite del plan.

Disponible desde 2026-03-05. Volumen bajo. Se puede usar como disparador de automatizaciones.

Campos de data

Campo	Tipo	Descripción
`metric`	string	Métrica
`used`	number	Consumido
`limit`	number	Límite
`overage_policy`	string	bill \| memory_only \| byo_key \| stop

usage.limit_reached

{  "id": "evt_8f1c2a9d4b",  "object": "event",  "name": "usage.limit_reached",  "api_version": "2026-09-01",  "workspace_id": "ws_tinkay",  "occurred_at": "2026-09-02T14:03:11.000Z",  "data": {    "metric": "ai_resolutions",    "used": 12400,    "limit": 15000,    "overage_policy": "bill"  }}