Existing payment agreements
Existing payment agreements and charges screens still use the old designs in the production and test apps. New designs will be launched in Q3. The screens used to explain the steps in this section use the new designs. They might have a different UX from what you see in the test or production apps. But the features are the same.
The user can see their active payment agreements, as well as stopped payment agreements, and get an overview of all charges in Vipps MobilePay.
Screenshot: Multi-screen navigation path in the app (Vipps or MobilePay) — the home screen, a profile menu with Payment agreements highlighted, a list of active agreements (such as electricity, e-books, and gym membership) and a Stopped agreements section, an individual agreement detail page with Manage agreement and Payments options, and a payments history showing past charges.
Manage agreement
When the user clicks on Manage agreement, they will be presented with the manage agreement view with different options specific to that agreement. On all agreements irrespective of their type, the users can:
Change the payment source
Users can change the payment source of any payment agreement at any point in time. Users can either choose an existing payment source or add a new one. The newly selected payment source is verified with a 0 amount transaction. If the verification is successful the user is notified that the change is successful.
The available payment sources may vary depending on the market:
Norway: Cards only
Finland Denmark: Cards and Accounts
Norway: Cards only
Finland 
Denmark: Cards and Accounts
Screenshot: Four-screen flow in the app (Vipps or MobilePay) for changing the payment source — the Manage agreement sheet with a Change link next to the current card, a Pay with picker listing available cards and accounts plus an option to add a new one, the updated agreement details with a Save button, and a payment method confirmation screen.
Update the maximum amount (applicable only for variable price payment agreements)
Users can choose a new max amount for the variable price payment agreements.
Screenshot: Three-screen flow in the app (Vipps or MobilePay) for changing the maximum amount — the Manage agreement sheet showing the current max amount, a Change max amount picker with a scrollable list of amounts and one marked as Recommended, and the same picker after a new amount has been selected with a checkmark.
Toggle notifications upon payment
Notifications for successful payments are sent to users who have this toggle ON. Notifications for failed payments are sent to users irrespective of this toggle value.
Screenshot: Two-screen comparison in the app (Vipps or MobilePay) showing the Manage agreement panel with the "Notify me when paying" toggle in the off position on the left and switched on on the right.
Stop payment agreement in app
Users can stop the agreement in the app through the manage agreement view. Merchants must make sure to
listen to the recurring.agreement-stopped.v1 webhook event and update the subscription status on your systems accordingly.
The actor field in the payload will indicate whether the agreement was stopped by the merchant or the user.
Screenshot: Five-screen flow in the app (Vipps or MobilePay) for stopping a payment agreement — the Manage agreement sheet with Stop payment agreement highlighted in red, a Keep in mind warning screen, a Stop agreement confirmation dialog with Stop agreement and Cancel buttons, the agreement view after stopping with a stop date and Delete agreement option, and a Delete payment agreement confirmation dialog.
Stop payment agreement in merchant website/app
Merchants can opt out of showing Stop payment agreement in the app. See API Guide: Opting out of the Stop Payment Agreement feature.
If the merchant has opted out of showing Stop payment agreement in the app, then users can
easily access My page on the merchant's site using the Go to Merchant AS link.
This merchant agreement URL is mandatory for Norwegian merchants and optional for Finnish and Danish merchants.
We recommend that merchants use the Login API to make logging in to the merchant’s site easy.
The merchant's "My page" must provide an easy way for users to cancel their subscription, as shown below.
Screenshot: Three-panel composite showing the Vipps app agreement detail with Manage agreement and Payments options, the Manage agreement sheet with the Go to Merchant AS link highlighted, and a merchant's browser page with a My subscriptions section offering Update payment option, Pause subscription, and Cancel subscription (shown in red) buttons.