🔄 Subscriptions
Manage recurring billing and subscription services for your customers.
The Subscriptions endpoints enable you to manage recurring billing relationships with your customers.
You can create subscription products, manage customer subscriptions, and provide self-service options through the customer portal.
This section covers:
- Creating and managing subscription products with pricing plans
- Setting up customer subscriptions with Stripe price IDs
- Providing customer billing portal access for self-service
- Listing subscriptions with filtering and pagination
- Canceling subscriptions immediately or at period end
Available Endpoints
Method | Endpoint | Description |
---|---|---|
GET | /public/subscriptions | List subscriptions with filtering |
POST | /public/subscriptions | Create new subscription |
GET | /public/subscriptions/:id | Get subscription details |
DELETE | /public/subscriptions/:id | Cancel subscription |
POST | /public/subscriptions/billing-portal | Create customer billing portal session |
POST | /public/subscriptions/products | Create subscription product with plans |
GET | /public/subscriptions/products | Get subscription products |
Pro tipAll subscription endpoints now use Stripe price IDs (starting with
price_
) instead of internal plan IDs. ThepaymentMethod
field is required when creating subscriptions to determine fee structures.
API Refs
- Staging: Get list of subscriptions
Updated 18 days ago