Skip to main content

​
When this fires

The trial reached trialEndsAt. With a payment method, the billing cycle activates the subscription (status: "active"), starts the first regular billing period, and generates the first invoice — invoice.created and payment events follow as the charge is processed. Access does not change at this moment: the customer already had full access while trialing. A retryable first-charge failure moves the subscription to past_due recovery; a missing payment method or a customer-action-required outcome leaves it in pending_payment until checkout is completed. A trial without a payment method that ends without a card creates no invoice. The subscription moves to the plan group’s default plan (subscription.plan_changed) or, without one, is canceled with cancelReason: "trial_ended_without_payment_method" (subscription.canceled).

Body

application/json
​
id
string
required
​
event
string
required
Allowed value: "trial.expired"
​
timestamp
string
required
​
organizationId
string
required
​
mode
enum<string>
required
Available options:
live,
sandbox
​
apiVersion
string
required
​
data
object
required

Response

200

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