recur-checkout
Installation
SKILL.md
Recur Checkout Integration
You are helping implement Recur checkout flows. Everything below is checked against the
recur-tw typings (RecurContextValue, UseSubscribeResult, CheckoutOptions,
RedirectToCheckoutOptions, SubscriptionResult). Product IDs are CUIDs from
list_products / the dashboard (e.g. cmfxq8n2a0001l8yz3k5p9t7d); prod_xxx in the
examples is a placeholder. You can also pass productSlug.
Checkout Modes
| Mode | How | Best For |
|---|---|---|
| Hosted (recommended) | useRecur().redirectToCheckout() → checkout.recur.tw |
Any app, works on localhost |
| Modal | useSubscribe() / useRecur().checkout() with provider checkoutMode: 'modal' |
Quick purchases without leaving the page |
| Embedded | same hooks with provider checkoutMode: 'embedded' + containerElementId |
Custom checkout pages |
checkoutMode lives on <RecurProvider config>, not on the call. The provider default is
'embedded', which throws without containerElementId — set checkoutMode: 'modal' when
you want the popup. There is no mode: 'hosted' | 'modal' option on any call.