Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

subscriptionIdstring

The subscription ID.

customerIdstring

The customer ID. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

planNamestring

The plan name.

trialDaysnumber

The length of the trial in days.

checkoutUrlstring

The hosted checkout URL to share with the customer.

{
  "event": "trial.checkout_ready",
  "timestamp": "2026-03-25T14:30:05.000Z",
  "organizationId": "org_abc123",
  "mode": "live",
  "apiVersion": "2026-06-10",
  "data": {
    "subscriptionId": "sub_1a2b3c4d",
    "customerId": "user_123",
    "planName": "Pro",
    "trialDays": 14,
    "checkoutUrl": "https://pay.commet.co/checkout/tok_9f8e7d6c"
  }
}

Cuándo se dispara

Cuando se crea una suscripción con prueba y el cliente todavía necesita agregar un método de pago, Commet genera un enlace de checkout que inicia la prueba una vez completado y dispara este evento en cuanto el enlace está listo.

Completar este checkout guarda la tarjeta y dispara trial.started; al cliente no se le cobra hasta que termina la prueba. Los checkouts pagos (sin prueba) disparan checkout.ready en su lugar.

Usá el checkoutUrl y trialDays para gestionar tus propios mensajes de "comenzá tu prueba de X días".