trial.checkout_ready

{ "event": "trial.checkout_ready", "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", "planName": "Pro", "trialDays": 14, "checkoutUrl": "https://pay.commet.co/checkout/tok_9f8e7d6c" } }

When this fires

When a subscription with a trial is created and the customer still needs to add a payment method, Commet generates a checkout link that starts the trial once completed and fires this event as soon as the link is ready.

Completing this checkout saves the card and fires trial.started; the customer is not charged until the trial ends. Paid (non-trial) checkouts fire checkout.ready instead.

Use the checkoutUrl and trialDays to drive your own “start your X-day trial” messaging.

Body

application/json

string

required

event

string

required

Allowed value: "trial.checkout_ready"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

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

Overview

Events

trial.checkout_ready

When this fires

Body

Response

​When this fires

Body

Response

When this fires