## Subscription Management

Glomo provides comprehensive tools to manage subscriptions throughout their lifecycle.
Merchants can pause, resume, cancel, or update subscriptions directly from the Glomopay dashboard or via APIs, giving full control over customer billing while maintaining transparency and compliance. Subscription management capabilities vary slightly depending on whether the subscription is Fixed-Frequency or As Presented.

![subscription_management](/assets/subscription_management.bed19a1c94a95bb80931a031589ac12ca8bccb12fbe6c7cf2059cf67a6416de8.9e6425bf.png)

### Supported Management Actions

| Action | Fixed-Frequency Subscriptions | As Presented Subscriptions |
|  --- | --- | --- |
| Pause Subscription | ✅ Supported | ❌ Not applicable |
| Resume Subscription | ✅ Supported | ❌ Not applicable |
| Cancel Subscription | ✅ Supported | ✅ Supported |
| Update Next Payment Date | ✅ Supported | ❌ Not applicable |
| Manual Charge | ❌ Not applicable | ✅ Supported |
| Deactivate Subscription Link | ✅ Supported | ✅ Supported |


## Pausing a Subscription

### What Happens When a Subscription Is Paused

- All upcoming scheduled payments are temporarily stopped.
- No charges will be attempted until the subscription is resumed.
- Subscription remains visible and can be reactivated at any time.


### Steps to Pause a Subscription

div
![subscription_pause](/assets/subscription_pause.e5b99ef79b2688993f6759ccd7cab5786e416eb5f94965e2ff732c16754522c0.9e6425bf.png)

Alternatively, you can use the **Pause Subscription API** to pause an active subscription.

## Resuming a Paused Subscription

### What Happens When a Subscription Is Resumed

- The subscription returns to Active state.
- Billing resumes based on the existing schedule.
- Future payments are charged automatically by Glomo.


### Steps to Resume a Subscription

div
![subscription_resume](/assets/subscription_resume.6fc7e13cc8868b547670dd1f3c110f7d561c08589da6cab6a7b10cf76031623b.9e6425bf.png)

Alternatively, you can use the **Resume Subscription API** to resume a paused subscription.

## Canceling a Subscription

### What Happens When a Subscription Is Cancelled

- The subscription is permanently stopped.
- No further payments will be charged.
- The subscription cannot be resumed once cancelled.


### Steps to Cancel a Subscription

div
Cancellation is supported for both Fixed-Frequency and As Presented subscriptions.

![subscription_cancel](/assets/subscription_cancel.3b67bfd82135f40a443fcaff08525566c6188d0189162ea92004e8b5ff2e3467.9e6425bf.png)

Alternatively, you can use the **Cancel Subscription API** to cancel an active subscription.

## Updating the Next Payment Date (Fixed-Frequency Only)

The **Update Next Payment Date** feature allows merchants to adjust the upcoming billing date for an active subscription.

This is particularly useful for merchants in the insurance and financial services sectors, where policy issuance or activation may occur after the initial payment collection.

By updating the next payment date, merchants can align the recurring billing schedule with business events without cancelling or recreating the subscription.

![update_next_payment_date](/assets/update-next-payment-date.a6261bb179569bfc03d37a93bd7888fea791d3572f7c80312b664ad472560d28.9e6425bf.png)

### 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:

### API Reference

Endpoint:


```curl
PATCH /subscriptions/{subscription_id}/next-payment-date
```

Request Body:


```http
{
"next_payment_date": "2025-11-10"
}
```

## Handling Failed Payments & Halted Subscriptions

- If a scheduled payment fails after configured retries, the subscription moves to Halted state.
- While halted:
  - No further charges are attempted.
  - Merchant can collect a payment on the same subscription from the customer to move the subscription to the active state again.
- For As Presented subscriptions, halting occurs due to card expiry or repeated failed charges.