Cancel subscription
If a customer wants to permanently end their subscription, a cancellation dialog is available in the tebio Business portal. This dialog takes into account commercial deadlines (such as minimum terms and notice periods) and suggests the possible dates for the end of the contract.
When do I need this function?
Section titled “When do I need this function?”Use this function if you want to terminate the subscription. This is not a temporary suspension (please use Pause subscription), but rather a permanent termination of the current subscription.
Requirements
Section titled “Requirements”- The subscription must be active.
Step-by-step instructions
Section titled “Step-by-step instructions”Start the subscription from the customer view:
- Open the customer file. The Subscriptions tab is already open by default.
- Select the subscription you want from the dropdown.
- Click on the Manage subscription button.
Way 1: Initiate termination via the administration view
Section titled “Way 1: Initiate termination via the administration view”In the Manage Subscription view, scroll down.
- On the left you will find the Cancel subscription link.
- Click on this link to open the cancellation dialog.
Determine end of contract and reason: In the following dialog you must define the desired date and the reason.
- Click the “Select desired contract end date” drop-down menu.
- tebio suggests calculated possible dates (e.g. the regular expiry date of a minimum term or the
nächstmöglichen Zeitpunkttaking the notice period into account).
If you would like to carry out an extraordinary termination or set a fixed deadline in the future that is not suggested by the system:
- In the dropdown, select the bottom entry “other date”.
- A calendar field opens.
- Click on the desired day.
The last step is to identify the cause:
- Select the appropriate entry from the “Reason for termination” drop-down menu (e.g. “Moving away”, “Too expensive”).
- Click Cancel Subscription to complete the process.
Way 2: Cancellation via the status change in the details
Section titled “Way 2: Cancellation via the status change in the details”Alternatively, you can cancel a subscription directly via the administrative status changes in the subscription details.
- In the customer’s subscription overview, click “View Details” (instead of “Manage Subscription”).
- Stay in the Events tab and click Change Status in the Status Changes section.
The status dialog opens:
- Change the “New Status” to Disabled (technically: DEACTIVE).
- Under Deactivation, select either “Immediately” or “Select a date”.
- If you have clicked “Select date”, the date dropdown appears. The same rules apply here as in way 1: The system suggests calculated deadlines; you can freely choose a calendar day using “other date”.
- Select the reason for termination and confirm with “Change status”.
withdraw termination
Section titled “withdraw termination”As long as the set termination date is still in the future, planned terminations can be canceled in the system at any time.
- In the customer file, navigate to “Manage subscription”. (If a termination is planned, you will see a notice banner at the top with the effective date, e.g. “Terminated as of: July 6th, 2026”).
- Click on the 3-dot menu on the main product.
- Select the entry “Withdraw termination”.
Result
Section titled “Result”tebio saves the cancellation and plans the end of the subscription on the selected deadline. Once the date is reached, the status of the subscription will automatically change to the corresponding deactivated or canceled status. If necessary, final invoices or remaining credits (proration) are generated by the system for periods that are still open.
Notes and typical errors
Section titled “Notes and typical errors”- Cancellation vs. cancellation: If it is a reversal within the statutory cancellation period (14 days after completion), a real “cancellation” is often commercially necessary instead of a cancellation in order to fully credit initial costs. Clarify this difference with your accounting department.
API Notes
Section titled “API Notes”For automated cancellations via third-party systems (or customer self-care), the tebio REST API offers dedicated endpoints:
| End point | Method | Description | OperationId |
|---|---|---|---|
/v1/subscription/{uuid}/deactivate | POST | Cancel your subscription regularly or extraordinarily | deactivateSubscription |
/v1/subscription/{subscriptionUuid}/cancel-deactivation | POST | Undo planned termination | cancelSubscriptionDeactivation |
Further information about the Subscription API can be found centrally in the article Edit subscription.