stripe-subscription

Stripe Subscription

Adds a MyApp.Billing.StripeSubscription provider that creates Stripe-hosted Checkout sessions for recurring subscriptions over Req. It only mints checkout URLs — it does not record subscription state. Treat a redirect to success_url as "checkout started", not "paid": grant access from verified Stripe webhooks.

When to use

• The app needs recurring (subscription) billing and you want Stripe to host the payment page rather than building a card form.
• You want a thin billing facade (MyApp.Billing) you can swap providers behind.
• Don't reach for this if you need one-time payments only, or if you already have a webhook-backed billing flow — this is a starting point, not a complete system.

Dependencies

• Requires: authentication (sessions are created from a user's email).
• Recommended: None.

Install

mix saaskit.feature.install stripe_subscription

No installer decisions. It generates the provider module and injects billing config into config/runtime.exs.

What it generates

• lib/my_app/billing/stripe_subscription.ex — the provider. Implements the MyApp.Billing behaviour with create_checkout_session/2, POSTs to Stripe's /v1/checkout/sessions in mode=subscription, and returns {:ok, url} or {:error, reason}.

Configuration

Injected after import Config in config/runtime.exs:

# config/runtime.exs
config :my_app, :billing,
  provider: MyApp.Billing.StripeSubscription

config :my_app, MyApp.Billing.StripeSubscription,
  secret_key: System.get_env("STRIPE_SECRET_KEY"),
  price_id: System.get_env("STRIPE_SUBSCRIPTION_PRICE_ID")

• STRIPE_SECRET_KEY — your Stripe API secret. Keep it out of source control.
• STRIPE_SUBSCRIPTION_PRICE_ID — the ID of a recurring Price created in Stripe. The provider errors with {:missing_configuration, key} if either is blank, so set both before calling checkout.

Tweaking for your app

Create a session and redirect the user to Stripe: