Cancel WebUI

In the WebUI implementation of Cancel, we will handle the communication with the user. This includes presenting cancellation questions, gathering answers to the questions and finally getting a Letter of Attorney from the user. The following section describes the actions you need to perform to get the Cancel WebUI up and running.


Overview of the steps for submitting a Cancellation through the WebUI

Cancellable subscriptions

Before being able to cancel a subscription you need to determine if the subscription is cancellable or not. To answer this question, you need to perform a Transaction Overview: Merchant Sync. A service provider is cancellable if the serviceProvider.actions.cancel option is Cancellable .

Fetch the WebUI URL

The webUI URL is fetched through the Manage subscriptions endpoint. In the request you are required to provide a merchant id. You can optionally provide a service ID. This will result in a smoother user experience as Minna then will skip asking the question "Which service do you want to cancel?". Minna will respond to the request with a WebUI object.

You can also provide the cost of the subscription as well as the interval at which it is paid. If you do, it enables Minna to display more accurate information about the subscription. For example, we will be able to provide information about how much the user can save per year if they cancel the subscription.

It is possible to for you to allow the user to perform an action earlier on your side by having a "Cancel" button in your UI. The user will be directed into the user flow for that action.

Open the WebUI URL

To display the webUI to the user, please refer to the Opening WebUI URLs guide.

The user will be logged in automatically to the Minna application and able to see their subscription. From there, they can choose to enter the Cancel user flow. When the user finishes the flow, the WebBridge event CLOSE_WEB_VIEW will be sent. For more information on WebBridge events, see the general Webview guide.

Get cancellation status

To keep your server in sync with the cancellation state on Minna's side, you can retrieve the cancellation id for a cancellation that the user submitted. This is useful if you want to show any changes to the cancellation in your native UI. Minna will respond with the cancellation object, which contains all the information for the current cancellation.

Show cancellation

When the user wants to view the state of their cancellation, including a timeline of events, this can be viewed within a Web UI. The url is the same as for managing the subscription.