Subscriptions
Subscriptions is the plan-based approach to billing in FlexiBill. You define your product catalog — what you sell, how it is priced, and when customers are billed — then enroll customers by linking them to the appropriate plan. From that point, FlexiBill manages the entire billing lifecycle automatically.
Use Subscriptions when your business sells defined packages, tiers, or memberships and you need per-customer billing schedule and status visibility over time.
Subscriptions defines the billing rules per customer. The Billing section shows what invoices those rules have generated and their current payment status. → Go to Billing
What You Configure Here
Subscriptions is organized into two layers:
Collection and Plan — Your Product Catalog
A Collection is a container for a product or service offering — for example, "Monthly Membership" or "Internet Packages". Each Collection holds one or more Plans that define the specific pricing model and billing cycle.
Set the pricing model per plan: Flat Fee, Per Unit, Tiered, Volume, or Stairstep
Set the billing cycle per plan: daily, weekly, monthly, annual, or interval-based
Configure Invoice Term and Grace Period at the collection level
Create Coupons to apply discounts to subscriptions within the collection
Add Tax configurations that apply automatically on every invoice
Create Subscription — Enrolling Customers
A Subscription links a customer (Member) to a Plan. Once created, the system takes over — invoices are issued automatically on schedule and the subscription status reflects the customer's current billing standing at all times.
Subscriptions can be created in two ways:
Merchant Initiate — merchant creates the subscription from the dashboard on behalf of the customer
Customer Initiate — customer selects a plan and subscribes themselves via a shareable Pricing Table
Features & Benefits
💲 Pricing Models
Configure exactly how billing amounts are calculated per customer:
Flat Fee
Fixed charge per cycle, regardless of quantity
Monthly tuition, fixed rent, standard membership
Per Unit
Charge × quantity subscribed
Per-seat SaaS, per-user licensing
Tiered
Quantity distributed across price tiers progressively
Usage-based services with volume incentives
Volume
All units priced at the tier the total quantity falls into
Wholesale or bulk pricing
Stairstep
Flat price per quantity tier, not per unit
Packaged service tiers with fixed tier pricing
Open Amount
No fixed price in the plan — amount is entered at subscription creation and charged consistently each cycle
Negotiated or customer-specific pricing that differs per customer
👉 For a detailed explanation of each model including Open Amount → Collection and Plan
🗓️ Per-Customer Billing Schedule
Each subscription has its own start date and end condition — independent of other customers. Two customers on the same plan can have completely different billing dates based on when they enrolled.
🔁 Automatic Renewal
Subscriptions renew automatically each cycle without any merchant action. A new bill is created at the start of every new cycle and delivered to the customer — the merchant only needs to monitor payment status.
🌐 Customer Self-Subscribe via Pricing Table
Create a branded, shareable plan selection page. Customers browse plans, select one, verify their email via OTP, and complete their first payment — entirely self-served. The Pricing Table can be shared via URL or embedded on a website.
📦 Flexible End Conditions
Choose how a subscription ends: Unlimited (runs until manually stopped), Specific Date (ends on a chosen date), or After X Times (ends after a defined number of billing cycles).
🔖 Coupon Discounts
Apply discounts to subscriptions through coupons scoped to a Collection. Configure the discount type (flat amount or percentage), control how many subscriptions can redeem it (unlimited or limited stock), and define how long the discount applies per subscription (unlimited or limited billing cycles). Coupons can be applied to the full invoice amount or restricted to selected plans only.
How It Works
Build Your Product Catalog
Create a Collection to represent your product or service, then add one or more Plans with the appropriate pricing model and billing cycle. Configure the invoice term and grace period at the collection level.
Example: Collection "Monthly Membership" → Plans "Basic IDR 150,000/month", "Pro IDR 300,000/month"
Enroll the Customer
Register the customer as a Member in Member Center, then create a Subscription by linking the member to a plan. Set the start date and end condition.
Alternatively, publish a Pricing Table and let the customer select a plan and enroll themselves.
The subscription is created with status Created. If the start date is in the future, status is Future Active.
Customer Pays
The customer receives the invoice, clicks the payment link, and completes payment using their preferred method. If the customer has enabled auto-debit (via Account Billing), the charge is processed automatically without any customer action.
Upon successful payment, subscription status moves to Active.
Next Cycle — New Bill Created
At the start of the next billing cycle, FlexiBill automatically creates a new bill for the subscription and delivers a fresh invoice to the customer. The cycle repeats from Step 3 until the subscription reaches its configured end condition.
The subscription continues until: the end date is reached, the defined number of cycles is completed, or the merchant ends it manually.
What's in This Section
The foundation of Subscriptions — define your product catalog before enrolling any customers. A Collection acts as a container for a product or service offering, while Plans define the specific pricing model and billing cycle within that collection.
Use when:
You are setting up a new product or service to be billed on a recurring basis
You need to offer multiple pricing tiers or packages under the same product category
You want to configure invoice terms, grace periods, taxes, or coupon discounts at the product level
Supports:
Six pricing models: Flat Fee, Per Unit, Tiered, Volume, Stairstep, Open Amount
Recurring and One-Off Charge plan types
Tax configurations applied automatically per invoice
Coupon discounts with stock limits and billing duration controls
The merchant creates a subscription on behalf of a customer directly from the DOKU Dashboard. Use this when you are onboarding a customer manually — for example, after a phone call, an in-person sign-up, or a sales conversation.
Use when:
The customer is not self-enrolling and you need to register them directly
You want full control over plan selection, start date, and end condition per customer
The customer's billing details have been agreed upon in advance (especially for Open Amount plans)
Supports:
Single Plan subscription types
Custom or auto-generated subscription IDs
Start date up to one year in the future
Three end conditions: Unlimited, Specific Date, or After X Times
Tax and coupon application at the subscription level
The customer selects their own plan and subscribes through a Pricing Table — a branded, shareable plan selection page created by the merchant. No merchant involvement is needed at the point of enrollment.
Use when:
You want customers to self-serve — browse plans, select one, and pay without contacting you
You are embedding a subscription sign-up flow on your website or sharing a link via email or social media
You want to reduce operational overhead for high-volume customer onboarding
Supports:
Up to 10 plans per Pricing Table, grouped by billing frequency
Customizable appearance: title, subtitle, button text, brand colors
Coupon application at checkout
Email OTP verification to ensure valid customer contact
Auto-debit enrollment on the first payment
Merchant & Customer Experience
Merchant View
Build the product catalog at Subscription and Billing → Collection
Create and manage Collections and Plans
Create and manage Coupons per collection
Configure Tax rates per collection
Register customers at Member Center before creating subscriptions
Create and monitor subscriptions at Subscription and Billing → Subscription
Create individually via Create Subscription (Merchant Initiate)
Or publish a Pricing Table for customer self-enrollment
Track subscription status per customer: Created, Future Active, Pending, Active, Expired
Customer View
Receives a plan selection page (Pricing Table) via a shared link or on the merchant's website
Selects a plan, verifies their email via OTP, and completes the first payment
Receives invoices automatically via Email or WhatsApp at the start of every new cycle
May enable auto-debit on the first invoice — subsequent cycles are charged without any manual action required
Terms & Conditions
A single subscription can only contain plans from one Collection
All plans in a subscription must share the same billing cycle
Maximum 10 plans per subscription
Plans with active subscriptions cannot be deleted — they can only be deactivated
Subscription start date cannot be set to a date in the past
Auto-debit payment collection requires activating Account Billing separately → Activate Account Billing
FAQ
What does each subscription status mean and what should I do?
Created
Subscription exists but the first invoice has not yet been issued — typically because the start date has not arrived yet
No action needed — the invoice will be issued automatically on the start date
Future Active
Subscription is confirmed and scheduled to start on a future date
No action needed — monitor until the start date arrives and the first invoice is issued
Pending
Invoice has been issued and delivered — awaiting payment from the customer
Monitor; follow up with the customer if payment is approaching the due date
Active
Customer has paid and the subscription is running normally
No action needed — the next cycle bill will be created automatically
Expired
Invoice was not paid within the grace period — the subscription is no longer active
Follow up with the customer; create a new subscription if they wish to re-enroll
Do I need to set up a Collection and Plan before enrolling customers?
Yes — Collection and at least one Plan must exist before you can create a Subscription. If you need to bill customers quickly without setting up a product catalog, use Bulk Bill Upload under the Billing section instead — no plan configuration is required.
Can different customers on the same plan have different billing dates?
Yes. Each subscription has its own start date, and billing dates are calculated from that start date for interval billing. Two customers on the same monthly plan — one starting on the 5th and another on the 20th — will be billed on their respective individual dates independently.
How does a plan upgrade or downgrade work?
FlexiBill does not support in-place plan switching. To move a customer to a different plan, end their current subscription by setting an end date, then create a new subscription on the target plan with the desired start date. Billing on the old plan stops; billing on the new plan begins from the new start date.
Can I limit how many customers can subscribe to a specific plan?
Yes. When creating a Plan, configure stock as either unlimited or limited to a specific number. Once the stock limit is reached, no new subscriptions can be created on that plan.
What happens if a customer does not pay before the grace period ends?
The subscription moves to Expired status. The customer loses access to the service (based on your business logic) and no further invoices are issued for that subscription. To reactivate the customer, create a new subscription for them on the appropriate plan.
Can I apply a discount to only some customers on the same plan?
Yes. Coupons are applied at the individual subscription level — not at the plan level. You can apply a coupon to one customer's subscription while another customer on the same plan is billed at full price. This makes coupons suitable for targeted promotions, loyalty discounts, or negotiated pricing for specific customers.
Last updated
Was this helpful?