# RevCent MCP Guide: `RefundSubscriptionRenewal`

Brief AI/MCP-focused guide for the RevCent `RefundSubscriptionRenewal` operation.

---

## Operation Summary

Operation:

```text
RefundSubscriptionRenewal
```

Purpose:

```text
Refund a Subscription Renewal using the Subscription Renewal ID.
```

Use `RefundSubscriptionRenewal` when the refund target is specifically a recurring subscription renewal charge.

This is preferred over raw transaction-level refunding when the business wants the refund tied cleanly to the Subscription Renewal for lifecycle tracking, renewal reporting, and recurring revenue metrics.

---

## When to Use

Use `RefundSubscriptionRenewal` when:

- the customer is being refunded for a specific renewal charge,
- the user provides or confirms the Subscription Renewal ID,
- the refund should be attributed to the renewal lifecycle,
- the business wants clean subscription renewal refund metrics,
- the refund should not be treated as a raw credit card refund without renewal context.

Example user intent:

```text
Refund this subscription renewal.
Refund $10 from this renewal.
Refund the renewal charge from last billing cycle.
```

---

## When Not to Use

Do not use `RefundSubscriptionRenewal` when the refund target is a different item.

Prefer the operation that matches the item being refunded:

| Refund Intent | Preferred Operation |
|---|---|
| Void or fully refund an entire Sale | `VoidSale` |
| Refund a Product Sale line item | `RefundProductSale` |
| Refund Shipping / Shipment amount | `RefundShipment` |
| Refund Tax | `RefundTax` |
| Refund raw credit card funds without item context | `RefundTransaction` |
| Refund a Subscription Renewal | `RefundSubscriptionRenewal` |

Best practice:

```text
Use the most specific refund operation for the item being refunded.
```

---

## Input Schema

| Field | Type | Required | Description |
|---|---:|---:|---|
| `subscription_renewal_id` | string | Yes | 20-character Subscription Renewal ID. |
| `amount` | number | No | Amount to refund. If omitted, the entire Subscription Renewal amount is refunded. |

---

## Full Renewal Refund

If `amount` is omitted, the entire Subscription Renewal amount is refunded.

Example:

```json
{
  "subscription_renewal_id": "RRRRRRRRRRRRRRRRRRRR"
}
```

Use this only when the user intends to refund the full renewal amount.

---

## Partial Renewal Refund

If `amount` is provided, only that amount is refunded.

Example:

```json
{
  "subscription_renewal_id": "RRRRRRRRRRRRRRRRRRRR",
  "amount": 10.00
}
```

Use this when the user intends to refund only part of the renewal amount.

---

## Output Schema

Successful output can include:

| Field | Description |
|---|---|
| `api_call_id` | 20-character API call ID. |
| `api_call_unix` | Unix timestamp of the API call. |
| `code` | API response code. `1` indicates success. |
| `amount` | Amount refunded. |
| `subscription_id` | Subscription ID associated with the renewal. |
| `subscription_renewal_id` | Subscription Renewal ID that was refunded. |
| `pending_refund` | Pending Refund IDs created as a result of the refund, if applicable. |
| `result` | Result message. |

---

## Pre-Refund Checklist

Before calling `RefundSubscriptionRenewal`, confirm:

- the correct Subscription Renewal ID,
- the related Subscription/customer context,
- whether the refund is full or partial,
- the exact `amount` if partial,
- whether another item-specific refund operation is more appropriate,
- the user explicitly confirmed the refund.

---

## Reporting Guidance

Use `RefundSubscriptionRenewal` to perform the renewal refund.

Use:

```text
BigQueryRunQuery
```

for renewal refund reporting, subscription metrics, aggregation, or analysis.

Do not use operational refund or retrieval operations to build subscription renewal reports.

---

## Final AI/MCP Instruction

Use `RefundSubscriptionRenewal` when the refund target is specifically a Subscription Renewal.

If `amount` is omitted, the entire renewal amount is refunded. If `amount` is provided, only that amount is refunded. For other refund scenarios, prefer the operation that matches the root item being refunded, such as `VoidSale`, `RefundProductSale`, `RefundShipment`, `RefundTax`, or `RefundTransaction`.


---
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.