credits.granted

{ "event": "credits.granted", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "credits": 500, "reason": "period_reset" } }

Cuándo se dispara

Los créditos incluidos en el plan se otorgan al inicio de cada período de facturación (reason: "period_reset"), y los ajustes manuales desde el dashboard otorgan créditos comprados (reason: "manual_adjustment"). Las compras de paquetes de créditos son un flujo aparte y disparan credits.purchased en su lugar.

La clave de idempotencia se deriva de la operación de facturación que otorgó los créditos, por lo que los reintentos del motor nunca envían un duplicado.

Úsalo para reiniciar los medidores de uso de tu aplicación al inicio de un período o para confirmar que un otorgamiento de créditos gestionado por soporte llegó al cliente.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "credits.granted"

timestamp

string

requerido

organizationId

string

requerido

mode

enum<string>

requerido

Opciones disponibles:

live,

sandbox

apiVersion

string

requerido

data

object

requerido

Show child attributes

Respuesta

200

Return any 2xx status code to acknowledge receipt of the event.

Introducción

Eventos

credits.granted

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara