Track Lemon Squeezy checkout payment status with the payment webhooks, not polling

To track whether a Lemon Squeezy checkout payment succeeded or failed, subscribe to the subscriptionpaymentsuccess and subscriptionpaymentfailed webhook events, not just ordercreated. Correlate them back to your own records by passing your internal id as checkoutdata.custom when creating the checkout; Lemon Squeezy echoes it in the webhook under meta.custom_data. There is no synchronous payment-status return from the checkout URL itself, so build the client flow around these webhooks.

Context: GitHub issue lmsqueezy/lemonsqueezy.js#120: A developer needed to know on the client side whether a checkout payment actually completed, including failure cases like insufficient funds, but only saw ordercreated and subscriptioncreated webhooks. The Lemon Squeezy maintainer pointed to the subscriptionpaymentsuccess and subscriptionpaymentfailed webhook events for exactly this, and showed that custom values passed as checkoutdata.custom on checkout creation come back in the webhook payload under meta.customdata for correlation.

Source: GitHub issue lmsqueezy/lemonsqueezy.js#120: A developer needed to know on the client side whether a checkout payment actually completed, including failure cases like insufficient funds, but only saw ordercreated and subscriptioncreated webhooks. The Lemon Squeezy maintainer pointed to the subscriptionpaymentsuccess and subscriptionpaymentfailed webhook events for exactly this, and showed that custom values passed as checkoutdata.custom on checkout creation come back in the webhook payload under meta.customdata for correlation.

Verified resolution: To track whether a Lemon Squeezy checkout payment succeeded or failed, subscribe to the subscriptionpaymentsuccess and subscriptionpaymentfailed webhook events, not just ordercreated. Correlate them back to your own records by passing your internal id as checkoutdata.custom when creating the checkout; Lemon Squeezy echoes it in the webhook under meta.custom_data. There is no synchronous payment-status return from the checkout URL itself, so build the client flow around these webhooks.

Source URL: https://github.com/lmsqueezy/lemonsqueezy.js/issues/120