Subscription Management

Customers can manage their subscriptions by entering the Subscriptions tab from the Store page.

The page displays the list of subscriptions associated with the customer's products, for each row the following properties are displayed:

  • Location: the location name where the product is installed.

  • Machine: the name and the serial number of the product the subscription is associated with.

  • Service: the name of the subscribed service level.

  • Status: the subscription status, which can be: FREE (nothing to pay), ACTIVE, or PENDING (missing payment).

  • Next Payment: the date of the next scheduled payment (if not FREE).

  • Amount: the amount of the next payment (if not FREE).

Expanding a row by clicking on it, it is possible to access the subscription detail, and where available modify it. For instance, a subscribed service level can be upgraded.

Once the subscription has been modified, a colored box displays the requested payment details, and a new item is added to the Cart.

To complete the subscription upgrade, the user should go to the Cart (tab or Go-to cart button), and then within the Subscription section, review and press Subscribe.

By clicking on the Subscribe button, the user must review and provide the missing billing information. When done, the user can finally complete the payment, for instance, by selecting a credit card or providing a new one.

When a new credit card number is provided, it is possible that the application asks for a token to fulfill the Strong Customer Authentication requirement based on the 3D Secure standard.

The purchased items will be available only if the payment completes correctly, if ok the user will see this message.

When the payment completes, the user is redirected to the application Payments page, where it is possible to see the details of the payment.

At any moment, the user can cancel the subscription from the Subscriptions page.

When canceled, the subscription will be valid until the next payment date, and before that the subscription can be restored again.

In case a credit card expires or has no funds, a payment with the status PENDING PAYMENT is registered, allowing the user to retry it by updating the associated payment method. In this case, the associated active subscriptions will be valid for at most 15 days.

If the subscription is not restored, or the payment is not performed, the associated service level is downgraded to the free one.

A Subscription can be in one of the following statuses:

  • ACTIVE: the subscription is valid and paid.

  • CANCELED: the subscription has been canceled.

  • PENDING PAYMENT: the subscription must be renewed, and the system is waiting for payment.
    In this case, a FAILED payment is registered.

Back-office management

Back-office users can manage subscriptions associated with a customer or to a product (Thing) by entering the Subscriptions tab in editing mode.

Within the Service Level section, it is possible to manage the subscription to a service level, by specifying:

  • The service level associated with the product (e.g. Gold, Premium).

  • The identifier of the Stripe active subscription.

  • The date until the subscription is valid (enabled if the Stripe subscription ID is empty).

  • Whether the Free period has been already consumed.

  • The number of extra authorizations associated with the product.

The Cancel subscription button allows removing the subscription, and if present this action has also an effect on the Stripe subscription.

The Restore button instead allows restoring the page when modified.

Taxes

All prices related to subscriptions (e.g. service levels) are inclusive of taxes. Prices visible to end-users will be described with the label "(tax incl.)".

To complete a purchase, when Servitly invokes Stripe, the purchase amount is stripped of taxes which are calculated based on the buyer's country (e.g. Italy 22%).

Note that: due to rounding, it is possible that the final price differs by a few cents from the initial price.

Payment Gateways

Servitly integrates these payment gateways:

In the alternative, if you do not have any of the above payment gateways, payments must be externally processed, and it is up to the provider to keep payment status updated. When a customer activate a new Subscription, and at any subscription recurrence, a new payment with status PENDING PAYMENT is registered. For more details, refer to the Payments Management article.