URL: /baas/api/capabilities/sct05-subscription-management

---
title: "SCT05 - Subscription Business Performance Management"
description: "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
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
{
  "plan_id": "plan_pro_001",
  "name": "Professional Plan",
  "billing_cycle": "MONTHLY",
  "price": 49.99,
  "currency": "EUR",
  "status": "ACTIVE"
}
```

### Create Customer Subscription

```bash
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
{
  "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
GET /api/v1/subscriptions/metrics
Authorization: Bearer {access_token}
```

**Response:**
```json
{
  "mrr": 125000.00,
  "arr": 1500000.00,
  "active_subscriptions": 2500,
  "churn_rate": 2.5,
  "ltv": 850.00,
  "new_subscriptions_mtd": 150
}
```

## Webhook Events

```json
{
  "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">
  View detailed subscription API specifications
</Card>

## Subscription Tier Availability

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