Skip to main content
POST
Buyout a subscription

Overview

Process a buyout to convert a subscription into a purchase. The customer pays a buyout price and keeps the device permanently. This ends the subscription and transfers ownership of the asset.

When to Offer Buyouts

Buyout Pricing

Before processing a buyout, calculate the price using Calculate Buyout. Buyout prices typically consider:
  • Remaining contract value: Unpaid months × monthly rate
  • Residual value: Expected asset value at contract end
  • Cost recovery status: How much you’ve already collected

Request Fields

Example Request

What Happens

When you process a buyout:
  1. Subscription status changes to ended_buyout
  2. Asset ownership transferred to customer
  3. Asset status changed to sold or unavailable
  4. Buyout details recorded on subscription
  5. Future payments cancelled
  6. Final invoice generated for buyout amount

Response Structure

Buyout Workflow

Example: End-to-End Buyout

Buyout vs Early Return

Error Handling

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
reason
enum<string>
required
Available options:
customer_request,
end_of_contract,
other
buyoutPrice
number
Required range: x >= 0
notes
string

Response

Buyout completed

success
boolean
required
rentalId
string
required
assetSerialNumber
string
required
buyoutPrice
number
required
Required range: x >= 0
currency
string
required
effectiveDate
string
required
message
string
required