Subscription webhook events

If you sell recurring products with selling plans, LaunchMyStore can notify your app or external system every time a subscription changes. This lets you keep another platform (for example a membership or course tool) in sync automatically — granting access on the first payment, extending it on each renewal, and revoking it when a subscription ends.

Recurring billing itself is handled automatically: once a customer subscribes, each renewal is charged on schedule without any action from you. The events below simply tell your system when those things happen.

Available subscription events

You can subscribe to any of these five events from your app or webhook settings:

• subscriptions/create — Fires when a customer's first subscription payment succeeds and the subscription becomes active. Use this to grant access or start fulfilment.
• subscriptions/renew — Fires on every automatic renewal charge after the first. Use this to extend access or ship the next order.
• subscriptions/update — Fires when a subscription changes — for example a plan or quantity change, or a status change such as a trial converting to active.
• subscriptions/payment_failed — Fires when a renewal charge fails. The subscription then enters the standard retry process. Use this to pause access or prompt the customer to update their card.
• subscriptions/cancelled — Fires when a subscription ends, whether it was cancelled by you or the customer, or it reached the end of its term. Use this to revoke access.

What about refunds and expiry?

A subscription that expires at the end of its term is delivered as subscriptions/cancelled — there is no separate "expired" event.

A refund on a subscription order is delivered through the standard refunds/create event, not a subscription event.

What's in the notification

Every subscription event includes the same details so your system can act on it:

• The order and customer the subscription belongs to (including the customer's email)
• The subscription's current status
• The plan name, amount, and currency
• The billing interval (for example, monthly or yearly)
• The current billing period's start and end, and the trial end date if there is one

How to start receiving events

1. Make sure your store is set up to sell recurring products with selling plans.
2. In your app or webhook settings, subscribe to the subscription events you want to receive and provide the secure address (HTTPS URL) where notifications should be sent.
3. Your endpoint should reply quickly to confirm receipt. If it doesn't, delivery is retried a few times before being marked as failed.

For full technical details and payload examples, developers can refer to the LaunchMyStore developer documentation.