Frequencies

Subscription Frequencies

The subscription frequency determines how often a subscription billing cycle occurs and when the recurring amount is charged.

Frequency	Code	Billing Cycle	Example
Daily	`DAIL`	Every day	₹100 every day
Weekly	`WEEK`	Every 7 days	₹500 every week
Monthly	`MNTH`	Every month	₹999 every month
Bi-Monthly	`BIMN`	Every 15 days	₹1,800 every 15 days
Quarterly	`QURT`	Every 3 months	₹2,500 every 3 months
Half-Yearly	`MIAN`	Every 6 months	₹5,000 every 6 months
Yearly	`YEAR`	Every 12 months	₹10,000 every year
On-Demand	`ONDM`	Charged when requested	₹1,000 per service/request

The billing frequency determines the start and end of each billing period.

For a subscription with:

{
  "frequency": "MNTH"
}

The subscription follows a monthly billing cycle. For example:

August 1
   ↓
Billing Period
August 1 ───────── August 31
   ↓
Renewal
September 1
   ↓
Next Billing Period
September 1 ───── September 30

For a weekly subscription:

August 1
   ↓
August 1 ─── August 7
   ↓
Next Billing Cycle
August 8 ─── August 14
   ↓
Next Billing Cycle
August 15 ── August 21

Feature	Fixed Frequency	On-Demand Frequency
Definition	Follows a predefined recurring billing schedule.	The merchant generates a payment request whenever billing is required.
Invoice generation	Automatic, based on the configured frequency.	Generated only when the merchant initiates billing.
Collection	Auto-debit is attempted at each billing cycle.	Collection occurs only after the merchant creates the request.
Frequency value	`DAIL`, `WEEK`, `MNTH`, `BIMN`, `QURT`, `MIAN`, `YEAR`	`ONDM`
Best suited for	Fixed recurring schedules.	Variable, usage-based, or pay-per-use billing.
Examples	Monthly memberships, OTT subscriptions, insurance premiums.	Utility bills, cloud services, usage charges.