invoice.upcoming

{ "event": "invoice.upcoming", "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", "status": "active", "planId": "pln_pro_monthly", "planName": "Pro", "billingInterval": "monthly", "currentPeriodEnd": "2026-04-25T00:00:00.000Z" } }

Cuándo se dispara

Un escaneo diario encuentra suscripciones activas que se renuevan dentro de los próximos 3 días y emite este evento una vez por renovación. La clave de idempotencia se deriva de la suscripción y la fecha de renovación, por lo que volver a ejecutar el escaneo nunca envía un duplicado.

Las suscripciones con una cancelación programada quedan excluidas — no se emitirá ningún recibo de renovación para ellas.

Úsalo para notificar al cliente antes de que se le cobre. El payload intencionalmente no incluye un monto: los cargos basados en consumo solo son definitivos al momento de la renovación, cuando invoice.created entrega el recibo real.

Cuerpo

application/json

string

requerido

event

string

requerido

Allowed value: "invoice.upcoming"

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

invoice.upcoming

Cuándo se dispara

Cuerpo

Respuesta

​Cuándo se dispara

Cuerpo

Respuesta

Cuándo se dispara