Extend Subscription - FlexPortal

Extend a subscription

curl --request POST \
  --url https://api-eu.flexportal.io/v1/subscriptions/{subscriptionId}/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "rentalId": "<string>",
  "extensionMonths": 60,
  "reason": "<string>",
  "newMonthlyAmount": 1,
  "notes": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "rentalId": "<string>",
  "assetSerialNumber": "<string>",
  "oldEndDate": "<string>",
  "newEndDate": "<string>",
  "extensionMonths": 60,
  "oldContractLength": 60,
  "newContractLength": 60
}

POST

subscriptions

{subscriptionId}

extend

Extend a subscription

curl --request POST \
  --url https://api-eu.flexportal.io/v1/subscriptions/{subscriptionId}/extend \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Tenant-ID: <tenant-id>' \
  --data '
{
  "rentalId": "<string>",
  "extensionMonths": 60,
  "reason": "<string>",
  "newMonthlyAmount": 1,
  "notes": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "rentalId": "<string>",
  "assetSerialNumber": "<string>",
  "oldEndDate": "<string>",
  "newEndDate": "<string>",
  "extensionMonths": 60,
  "oldContractLength": 60,
  "newContractLength": 60
}

Overview

Extend an active subscription’s contract period. Extensions allow customers to keep their device longer than the original contract term, typically at a reduced monthly rate.

When to Use Extensions

Scenario	Action
Customer wants same device longer	Use Extend
Customer wants a different/newer device	Use Upgrade
Customer wants to own the device	Use Buyout

Extension Benefits

For customers: Keep familiar device at lower monthly cost
For operators: Continue earning revenue on fully depreciated assets
For both: No logistics costs (no return/ship new device)

Request Fields

Field	Required	Description
`extensionMonths`	Yes	Number of months to extend
`newMonthlyAmount`	No	New monthly price (default: current price)
`reason`	No	Reason for extension

Basic Example

{
  "extensionMonths": 6
}

Example with Price Adjustment

{
  "extensionMonths": 12,
  "newMonthlyAmount": 79.00,
  "reason": "Loyalty discount for renewal"
}

Extensions are a great opportunity to offer loyalty discounts. Assets are often fully paid off by the end of the initial contract, so lower extension rates can still be highly profitable.

What Happens

When you extend a subscription:

End date pushed forward by extension months
Contract length updated to reflect total duration
Monthly amount updated (if new price provided)
Extension history logged with details
Future payments scheduled at new rate

Pricing Strategy for Extensions

// Example: Calculate extension pricing
function calculateExtensionPrice(subscription, extensionMonths) {
  const currentMonthly = subscription.monthlyAmount;
  const costRecovery = subscription.costRecovery.costRecoveryPercent;

  if (costRecovery >= 100) {
    // Asset is paid off - offer 30% discount
    return currentMonthly * 0.7;
  } else if (costRecovery >= 80) {
    // Almost paid off - offer 20% discount
    return currentMonthly * 0.8;
  } else {
    // Still recovering costs - keep same price
    return currentMonthly;
  }
}

Extension History

After extending, the subscription tracks extension history:

{
  "extensionHistory": [
    {
      "extendedAt": "2025-01-15T10:30:00Z",
      "extensionMonths": 6,
      "previousEndDate": "2025-01-31",
      "newEndDate": "2025-07-31",
      "previousMonthlyAmount": 129.00,
      "newMonthlyAmount": 99.00,
      "reason": "Customer renewal"
    }
  ]
}

Common Extension Periods

Period	Typical Use
3 months	Short-term bridge while waiting for upgrade
6 months	Standard renewal for satisfied customers
12 months	Full year renewal with loyalty discount
24 months	Long-term commitment with best pricing

Error Handling

Error Code	Cause	Solution
`SUBSCRIPTION_NOT_ACTIVE`	Subscription is not active	Can only extend active subscriptions
`INVALID_EXTENSION_MONTHS`	Extension months must be positive	Use positive integer

Get Subscription - Check current subscription details
Upgrade Subscription - Upgrade to different device
Buyout Subscription - Convert to purchase
List Subscriptions - Find subscriptions to extend

Authorizations

Authorization

string

header

required

API key obtained from FlexPortal dashboard

Headers

Tenant-ID

string

required

Your tenant identifier

Path Parameters

subscriptionId

string

required

The subscription ID

Body

application/json

rentalId

string

required

Minimum string length: 1

extensionMonths

integer

required

Required range: 1 < x <= 120

reason

string

required

Minimum string length: 1

newMonthlyAmount

number

Required range: x >= 0

notes

string

Response

Extension completed

success

enum<boolean>

required

Available options:

true

message

string

required

rentalId

string

required

assetSerialNumber

string

required

oldEndDate

string

required

newEndDate

string

required

extensionMonths

integer

required

Required range: 0 <= x <= 120

oldContractLength

integer

required

Required range: 1 < x <= 120

newContractLength

integer

required

Required range: 1 < x <= 120

Create Subscription Upgrade Subscription

​Overview

​When to Use Extensions

​Extension Benefits

​Request Fields

​Basic Example

​Example with Price Adjustment

​What Happens

​Pricing Strategy for Extensions

​Extension History

​Common Extension Periods

​Error Handling

​Related Endpoints

Authorizations

Headers

Path Parameters

Body

Response

Overview

When to Use Extensions

Extension Benefits

Request Fields

Basic Example

Example with Price Adjustment

What Happens

Pricing Strategy for Extensions

Extension History

Common Extension Periods

Error Handling

Related Endpoints