Webhook: subscription.status_changed

POST

Aviso de evento firmado. Verifica la firma antes de actualizar tu sistema.

Parámetros

Parámetros de cabecera

webhook-id

obligatorio

string

Identificador de mensaje de Standard Webhooks. Coincide con el id del evento en el cuerpo y es la clave de idempotencia del consumidor.

webhook-timestamp

obligatorio

string

/^[0-9]+$/

Segundos Unix en que se firmó la entrega. Rechaza una marca de tiempo fuera de una tolerancia de cinco minutos.

webhook-signature

obligatorio

string

/^v1,[A-Za-z0-9+/=]+( v1,[A-Za-z0-9+/=]+)*$/

Lista separada por espacios de firmas HMAC-SHA256 v1, sobre ... Acepta la entrega cuando coincide cualquier entrada.

Cuerpo de la solicitud^obligatorio

Media typeapplication/json

Evento firmado que se registra cuando cambia el estado o el motivo de suspensión de una suscripción. Consulta la suscripción para conocer su estado actual; los eventos pueden llegar fuera de orden.

object

id

obligatorio

Identificador del evento, igual al encabezado webhook-id.

string

/^event_[0-9a-hjkmnp-tv-z]{24,}$/

type

obligatorio

string

Valor permitido: subscription.status_changed

apiVersion

obligatorio

Identidad del contrato vigente con la que se generó este evento entregado.

string

Valor permitido: 2026-10-01

occurredAt

obligatorio

string format: date-time

data

obligatorio

object

id

obligatorio

La suscripción a la que corresponde el evento.

string

/^sub_[0-9a-hjkmnp-tv-z]{24,}$/

object

obligatorio

string

Valor permitido: subscription

Respuestas

2XX

2XX

El evento fue aceptado.