Allows your customers to pay the services through Stripe.

Customers can pay the service fees (activation or recurring) and goods (consumable and spare-parts) through the Stripe embedded payment service that allows the manufacturer to directly collect the incomes.

Plugin Configuration

To enable this plugin, you need to:

Go to the Integrations / Plugins page.
Select the Payments category.
Locate the Stripe card.
Click on the card switch to activate the plugin.
Configure the plugin properties and save.
Click the TEST CONNECTION button to verify the correctness of your configuration.

Here is the list of all the properties that can be used in the plugin configuration.

PROPERTIES

Publishable key

The String account publishable key.
Type: STRING | Mandatory

Secret key

The Stripe account secret key.
Type: PASSWORD | Mandatory

Tax Service Enabled

If selected the taxes area computed by using the Stripe Tax Service.
Type: CHECKBOX | Optional

Testing payments

Stripe allows using fake credit card numbers to test the payment flow.

For instance:

Number: 4242 4242 4242 4242
Brand: VISA
CVS: Any 3 digits
Date: Any future date

See the Testing page for more details.

Managing Subscriptions

Customers can manage subscriptions by entering the Subscriptions page from the Profile menu.

The Subscriptions menu item is available only if the user has the WRITE_SERVICE_SUBSCRIPTION permission.

The page displays the list of subscriptions associated with the customer or its products, for each row the following properties are shown:

Location: the location name where the product is installed.
Thing: the name and the serial number of the product the subscription is associated with.
Service: the name of the subscribed service plan or service.
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.
Amount: the amount of the next payment.

Expanding a row by clicking on it, it is possible to access the subscription details, and where available modify them. For instance, service plans 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 (icon on the page header).

The final step is to pay the items within the Cart that can be shown by clicking on the cart icon or on the Go-to cart button.

Items are subdivided into one-time purchases (e.g. Consumables, Spare parts, On-time services) and subscribable items (e.g. Service plans or Services with recurring). Due to the different natures of these items, it is not possible to perform one payment, but these must be paid separately.

The Pay button allows the user to pay for the selected items, instead, the Subscribe button allows the user to confirm a subscription that will result in a recurring charge on the provided credit card.

Once one of the confirm buttons is clicked, it is requested to verify and update the billing information. When done, the user can finally complete the payment, 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.

At any moment, the user can remove the selected items by clicking on the Reset button within the cart or within the subscription details.

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

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 is removed from the Thing or Customer, and service plans are 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.

Managing Payments

Users can access the list of executed payments through the Payments page. Depending on the user type (buyer vs seller), the page will show respectively only the list of executed payments (buyer) or the list of all incoming payments of all visible customers (seller).

The list reports the payments executed during the current month, the period filter allows selecting a different filtering period. Only for manufacturer users (seller), it is also possible to filter out payments by the customer. Expanding a payment, it is possible to access its details including the purchased items with quantity and prices, and the billing information saved for the payment.

Payment can be in one of the following statuses:

PAID: the amount of the purchase or recurring subscription has been correctly paid.
FAILED: the payment has failed (e.g. invalid card, card without funds).

Failed payments can be retried by the customer providing a valid payment method.

Subscriptions back-office management

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

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

The service plan associated with the thing or customer.
The Stripe subscription ID, in case there is a 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 thing.

Within the Services section, it is possible to manage services associates with the thing or customer, by specifying:

The service associated with the thing or customer.
The Stripe subscription ID, in case there is a 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 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.

Tax Management

All prices defined in Servitly (e.g. service levels, services, consumables) 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.