> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finhub.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# SCT05 - Subscription Business Performance Management

> Tools for managing subscription-based business models and recurring revenue via API

# SCT05 - Subscription Business Performance Management

Tools for managing subscription-based business models and recurring revenue, enabling automated billing and customer lifecycle management through the API.

## Overview

This capability provides API access to comprehensive tools for managing subscription-based services, from plan creation to billing automation and churn prevention.

## Features

| Feature                   | Description                          |
| ------------------------- | ------------------------------------ |
| **Plan Management**       | Create and manage subscription plans |
| **Recurring Billing**     | Automated billing cycles             |
| **Analytics & Reporting** | Subscription metrics and insights    |
| **Lifecycle Management**  | Customer journey automation          |
| **Churn Prevention**      | Predictive churn analytics           |

## Configuration Options

| Level        | Features                  | Automation           |
| ------------ | ------------------------- | -------------------- |
| **Basic**    | Essential plan management | Manual billing       |
| **Standard** | Full subscription tools   | Automated billing    |
| **Advanced** | AI-powered optimization   | Predictive analytics |

## API Usage

### Create Subscription Plan

```bash theme={null}
POST /api/v1/subscriptions/plans
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "name": "Professional Plan",
  "billing_cycle": "MONTHLY",
  "price": 49.99,
  "currency": "EUR",
  "features": ["feature_1", "feature_2", "feature_3"],
  "trial_days": 14
}
```

**Response:**

```json theme={null}
{
  "plan_id": "plan_pro_001",
  "name": "Professional Plan",
  "billing_cycle": "MONTHLY",
  "price": 49.99,
  "currency": "EUR",
  "status": "ACTIVE"
}
```

### Create Customer Subscription

```bash theme={null}
POST /api/v1/subscriptions
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "customer_id": "cust_123456",
  "plan_id": "plan_pro_001",
  "payment_method_id": "pm_card_789",
  "start_date": "2024-02-01"
}
```

**Response:**

```json theme={null}
{
  "subscription_id": "sub_abc123",
  "customer_id": "cust_123456",
  "plan_id": "plan_pro_001",
  "status": "TRIALING",
  "trial_end": "2024-02-15",
  "next_billing_date": "2024-02-15"
}
```

### Get Subscription Metrics

```bash theme={null}
GET /api/v1/subscriptions/metrics
Authorization: Bearer {access_token}
```

**Response:**

```json theme={null}
{
  "mrr": 125000.00,
  "arr": 1500000.00,
  "active_subscriptions": 2500,
  "churn_rate": 2.5,
  "ltv": 850.00,
  "new_subscriptions_mtd": 150
}
```

## Webhook Events

```json theme={null}
{
  "event": "subscription.renewed",
  "subscription_id": "sub_abc123",
  "plan_id": "plan_pro_001",
  "amount": 49.99,
  "next_billing_date": "2024-03-15"
}
```

## Integration with Other Capabilities

| Capability                   | Integration                |
| ---------------------------- | -------------------------- |
| **SCT04 - Instant Payment**  | Payment collection         |
| **SCT06 - Decision Support** | Subscription analytics     |
| **SCT10 - Closed-loop**      | Wallet-based subscriptions |

## Related API Reference

<Card title="Subscription APIs" icon="repeat" href="/baas/api/reference/financial-operations/index">
  View detailed subscription API specifications
</Card>

## Subscription Tier Availability

| Tier         | Configuration Level |
| ------------ | ------------------- |
| Starter      | Not included        |
| Professional | Standard            |
| Enterprise   | Advanced            |
| Custom       | Configurable        |