# RevCent MCP Guide: `SuspendSubscription`

Brief AI/MCP-focused guide for suspending a RevCent Subscription.

Reference overview:

```text
https://revcent.com/documentation/markdown/mcp/operation/OverviewSubscription.md
```

---

## Operation Summary

Operation:

```text
SuspendSubscription
```

Purpose:

```text
Suspend a subscription using the subscription ID.
```

Suspension is useful when the subscription should be paused or stopped temporarily but may need to be restarted later.

A suspended subscription can be restarted with:

```text
ActivateSubscription
```

---

## When to Run

Run `SuspendSubscription` when:

- customer wants to pause instead of permanently cancel,
- customer may return later,
- support wants to hold a subscription,
- payment/recovery issue requires temporary suspension,
- business policy prefers suspension before cancellation,
- the subscription should stop temporarily while preserving restart possibility.

---

## Suspend vs Cancel

This distinction is critical.

| Operation | Reversible? | Use When |
|---|---:|---|
| `SuspendSubscription` | Yes | The customer may restart later. |
| `CancelSubscription` | No | The customer wants permanent cancellation. |

Important:

```text
CancelSubscription is irreversible.
SuspendSubscription is reversible with ActivateSubscription.
```

If the user is unsure whether the subscription should be ended forever, use suspension rather than cancellation.

---

## Input Schema

Required:

| Field | Type | Description |
|---|---|---|
| `subscription_id` | string | 20-character Subscription ID. |

Example:

```json
{
  "subscription_id": "SSSSSSSSSSSSSSSSSSSS"
}
```

---

## Output

Successful output can include:

| Field | Description |
|---|---|
| `api_call_id` | 20-character API call ID. |
| `api_call_unix` | Unix timestamp of API call initiation. |
| `code` | Response code. `1` indicates success. |
| `subscription_id` | 20-character Subscription ID. |
| `result` | Result message. |

---

## Best Practices

- Retrieve the subscription first with `GetSubscription`.
- Confirm the customer/business wants a temporary pause.
- Prefer suspension over cancellation when the customer may return.
- Explain that suspended subscriptions can be restarted with `ActivateSubscription`.
- Do not use suspension for reporting or lookup.
- Consider Email Templates, notes, metadata, or AI workflows to record the reason for suspension.

---

## Final AI/MCP Instruction

Use `SuspendSubscription` when a subscription should be paused but may be restarted later. Use `ActivateSubscription` to restart it. Use `CancelSubscription` only for irreversible permanent cancellation.


---
Document Parent Directory
* [Operations](https://revcent.com/documentation/markdown/mcp/operation/index.md) - AI/MCP details and overviews for operations available within the RevCent MCP.