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.
- Merchant creates a subscription with a defined billing frequency and schedule.
- Customer completes the first payment or authorization on Glomo checkout.
- Glomo securely stores the customer’s payment method.
- Glomo automatically charges the customer on each scheduled billing date.
- Subscription continues until completed, paused, halted, or cancelled.
You can create a subscription directly from the Glomopay dashboard. Here’s how:
Go to the Dashboard. Navigate to the Subscriptions section.
Click “Create Subscription”
Select customer
Define Amount, Billing Frequency, Billing Interval, Start Date, Number of Billing Cycles(if applicable).
Create the subscription and share the payment link with the customer.
Example:
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
}'Fixed-Frequency Subscriptions support pre-authorization, allowing customers to approve future recurring payments ahead of time.
- 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. |
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.
You can create a subscription directly from the Glomopay dashboard. Here's how:
Navigate to Subscriptions → Subscription Details.
Click “Update Next Payment Date” (visible only for active subscriptions)
A confirmation modal appears:
- Displays the current date.
- Allows selection of a new future date (within 28-day window)
Confirm the update.