logo

Events

Cashier dispatches several events that you may intercept and handle based on your application's needs. We will describe each of these events below.

Laravel\Paddle\Events\SubscriptionCreated

This event is dispatched when a subscription is created with a status of trialing or active.

Laravel\Paddle\Events\SubscriptionUpdated

This event is dispatched when a subscription is changed. Possible changes include plan changes, quantity changes, pausing a subscription, or resuming a subscription.

Laravel\Paddle\Events\SubscriptionCanceled

This event is dispatched when a subscription expires. This happens when a paused or canceled subscription is no longer within its cancelation "grace period".

Grace Periods

When a subscription is canceled, Cashier will automatically set the subscription's ends_at column in your database. This column is used to know when the billable's subscribed method should begin returning false. For example, if a customer cancels a subscription on March 1st, but the subscription was not scheduled to end until March 5th, the subscribed method will continue to return true until March 5th. This is done because a user is typically allowed to continue using an application until the end of their billing cycle.