Skip to content

Change product

If a customer wants to change their current tariff (e.g. an upgrade from a digital-only subscription to a complete subscription with print delivery), the tebio business portal guides them through a guided change process. tebio takes into account deadlines, remaining terms and configured fees.

Use this function if you want to change the main product of a subscription. If it’s just a matter of adding an additional service to an existing contract (e.g. a hardware option or an additional license), use the options management at Edit subscription instead.

  • The customer must have an active subscription.
  • Product management must have determined in advance that a change from the current tariff to the desired target tariff is commercially permitted. You can find more information about this in the article Configure product change.

The switching process starts in the customer view:

  1. Open the customer view. The Subscriptions tab is already open by default.
  2. Click on the desired contract.
  3. Click on the Manage subscription button.
  4. At the top right of the main product view you will find the Change product link.

You will now see an overview of all possible target tariffs. tebio only lists products for which a corresponding switching rule has been defined in the background.

You can immediately see the most important commercial information for each tile (target product):

  • The applicable exchange fee (if configured).
  • The earliest possible change date (e.g. Immediately or only at the expiry of the minimum term).
  • A note on the treatment of the contract term (e.g. “The current minimum term will be maintained”).

Click on View & change for the desired product.

In the last step you will find yourself in a checkout dialog that is very similar to that of a regular new creation:

  • On the left you can select specific variants or options of the new product.
  • On the right side you will see the order overview with the new, current price.
  • Check the payment method.
  • (Optional): If the customer would like to change the tariff at a later date, you can set a different start date in the future using the checkbox “I would like a desired date…”.

Confirm the process by clicking on Change product & pay.


[!TIP] Customer Self Service Depending on the configuration, customers can carry out the same process themselves in the self-care / customer portal. The interface, the selection logic and the commercial calculations are identical to what you see here in the portal.

In the background, the system carries out a seamless commercial migration. The original subscription is deactivated and a new subscription is activated. (The history of the original subscription documents the product change as the reason for deactivation).

[!WARNING] Change of subscription number Since a product change technically consists of canceling the original subscription and creating a new target subscription, the change changes the subscription number and the internal Subscription UUID! External systems, for example an ERP system, must be prepared to receive the new reference when there are product changes.

  • The desired tile is missing: If you cannot find a product in “Step 2” that the customer wants to switch to, there is usually no technical error. In this case, the configured change rule or release is missing from the original product. Product management must first configure the route there.

The product change can also be carried out via the tebio REST API. The relevant endpoint for this is:

End pointMethodDescriptionOperationId
/v1/subscription/{uuid}/product-changePOSTCarry out product changessubscriptionProductChange

The entire table with all relevant subscription endpoints (including the revocation endpoints for product changes) can be found centrally in the article Edit subscription under “API notes”.