## Fixed Frquency Subscriptions

Fixed-Frequency Subscriptions are designed for businesses that charge customers on a predictable, recurring schedule - such as monthly, quarterly, or yearly. With fixed-frequency subscriptions, Glomo automatically initiates payments based on the configured billing cycle, removing the need for manual intervention while ensuring reliable and timely collections. This model is ideal for businesses offering SaaS products, memberships, subscriptions, or installment-based services with consistent billing intervals.

### How Fixed-Frequency Subscriptions Work

1. Merchant creates a subscription with a defined billing frequency and schedule.
2. Customer completes the first payment or authorization on Glomo checkout.
3. Glomo securely stores the customer’s payment method.
4. Glomo automatically charges the customer on each scheduled billing date.
5. Subscription continues until completed, paused, halted, or cancelled.


## Steps to Create a Subscription

You can create a subscription directly from the Glomopay dashboard. Here’s how:

### Via API

Example:


```http
curl -i -X POST \
  https://api.glomopay.com/api/v1/subscriptions \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "customer_id": "cust_5JU9yv0lGSUP",
    "product_name": "ShieldGuard Insurance",
    "product_description": "Flexible, monthly insurance for belongings, travel, and digital assets; easy to manage",
    "plan_name": "ShieldGuard Lite",
    "plan_description": "Simple, monthly insurance plan that covers your basic belongings and key digital assets",
    "amount": 1000,
    "currency": "USD",
    "interval_type": "month",
    "interval_count": 1,
    "billing_cycles": 12,
    "start_date": "2025-01-01",
    "expires_at": "2025-01-07",
    "notify_customer": true,
    "notes": {
      "key1": "value1",
      "key2": "value2"
    },
    "reference_number": "R0001",
    "starts_with_first_payment": true
  }'
```

## Pre-Authorization with Future Start Date

Fixed-Frequency Subscriptions support pre-authorization, allowing customers to approve future recurring payments ahead of time.

### How It Works

- Merchant sets a future start date during subscription creation.
- Customer completes checkout immediately.
- Glomo stores the authorized payment method securely.
- The first charge occurs automatically on the configured start date.


| State | Description |
|  --- | --- |
|  Created  | Subscription is created by the merchant. No payment has been made yet. |
|  Authorized  | The user has successfully set up the subscription. Recurring payments will start on the scheduled date. |
|  Active  | Subscription is active after the first successful payment, or resumed after a pause. Recurring billing continues. |
|  Paused  | Subscription is paused by the merchant. No further payments will be charged 
until resumed. |
|  Completed  | The subscription has run its full billing cycle and is now complete. |
|  Expired  | The customer didn’t complete payment before the link expired. The subscription is no longer valid. |
|  Halted  | A scheduled payment failed (after retries). Subscription is paused pending manual reactivation. |
|  Cancelled  | Subscription is cancelled by the merchant. No further billing will occur. |


## When to Use

Use this feature when:

- You’ve collected the first payment and want the next charge to align with the policy start or renewal date.
- A customer has requested a short deferral of their next billing date.
- You want to maintain consistent billing intervals while preserving the subscription lifecycle.


Avoid using this feature to:

- Change subscription frequency (e.g., monthly → quarterly).
- Modify the billing amount.
- Retry a failed payment use the retry mechanism instead.


## Dashboard Flow

You can create a subscription directly from the Glomopay dashboard. Here's how: