Billing and access
A product defines what a customer can use. A product grant gives that customer access for a period. The grant’s allowances track usage during that period; they are different from an upstream ChatGPT, Grok or Claude subscription’s own quota.
Modem records grants from four sources:
| Source | How access is granted |
|---|---|
| Default | The project’s default product applies when no active grant remains. |
| Manual | An operator grants a product through customer administration. |
| Stripe | Modem verifies a checkout, invoice or supported subscription change. |
| App Store | Modem verifies imported App Store purchase data. |
See product configuration for allowances and rate limits. Adding an external billing connection does not grant a paid product to any customer.
Payment workflows
- Connect Stripe or App Store Connect to the project in the intended environment.
- Map your paid product to the provider’s SKU or price.
- Start Checkout or import the verified StoreKit purchase.
- Wait for the verified outcome before showing paid access. A success redirect is not payment verification.
- Read the customer’s current product and usage to update your UI.
For existing Stripe subscriptions, use the separate upgrade workflow. Refunds and cancellation are operator actions described in refunds and cancellation.
Renewals and expiry
Recurring Stripe access follows verified billing periods. A paid cycle invoice records the payment and grants the associated period. Subscription-update invoices enter upgrade reconciliation instead of being treated as ordinary renewals.
When a manual or App Store grant expires, or Stripe access ends, the old grant’s allowances retire. If no active grant remains, the customer falls back to the default product. Do not keep displaying the old product’s remaining allowance as if it were still usable.
An invoice payment failure alone is not a final subscription state. unpaid, canceled and incomplete_expired end local Stripe access, but unpaid can recover. Only canceled and incomplete_expired establish a final provider state in this integration. Stopped access therefore does not always mean future billing has stopped.
Inspect a customer’s access
In Customers, open the customer and inspect product grants, usage allowances and payment history. Stripe checkout details show Modem’s stored lifecycle and processing history separately from provider checkout/payment status. They are not a live refresh of Stripe’s current account state.
From the Client SDK:
const current = await client.products.retrieveCurrent()
const subscriptions = await client.products.listActive({ limit: 20 })listActive() lists active paid subscriptions presented as products; it is not an inventory of every manual/default entitlement. Read upgrades for pagination and subscription selection. Use admin customer operations for operator-side grants and access management.