Subscriptions

Recurring billing and subscription lifecycle for 86d: create, pause, resume, cancel, with provider-agnostic billing through @86d-app/payments.

The subscriptions module manages the recurring-billing lifecycle on top of the products and payments modules. Customers can subscribe to a product, choose a billing interval, pause and resume, swap variants, and cancel. The module schedules renewal charges through whichever payment provider is configured under @86d-app/payments.

Source: modules/subscriptions · npm: @86d-app/subscriptions

Installation

86d module add subscriptions

The module requires @86d-app/products, @86d-app/orders, and @86d-app/payments to be enabled.

Configuration

subscriptions({
  defaultBillingDay: "1",          // 1-28, day of month for renewals
  retryAttempts: "3",              // retries on failed renewal charge
  cancelOnFailure: "true",         // cancel after exhausting retries
  trialDaysDefault: "0",           // default trial period in days
});

Store endpoints

Method	Path	Description
POST	/subscriptions	Create a subscription
GET	/subscriptions/me	List the customer’s subscriptions
GET	/subscriptions/me/:id	Get a single subscription
POST	/subscriptions/me/:id/pause	Pause renewals
POST	/subscriptions/me/:id/resume	Resume
POST	/subscriptions/me/:id/swap	Swap variant
POST	/subscriptions/me/:id/cancel	Cancel

Admin endpoints

Method	Path	Description
GET	/admin/subscriptions	List subscriptions (filter by status, customerId)
GET	/admin/subscriptions/:id	Detail
POST	/admin/subscriptions/:id/refund	Refund a renewal charge
GET	/admin/subscriptions/upcoming	Renewals due in the next N days

Lifecycle

trial -> active -> active (renews each cycle)
active -> paused -> active
active -> past_due -> active (after retry success) | cancelled (after retry exhaustion)
active -> cancelled

Components

• <SubscriptionPlanCard plan={...} />: storefront upsell card.
• <SubscriptionsList />: customer self-service list.
• <SubscriptionDetail id={...} />: management UI with pause / cancel actions.

Related modules

• Payments: processes renewal charges.
• Customers: owns the customer record.
• Memberships: for paid access plans rather than per-product subscriptions.