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 in the section uses 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.
- Vipps
- MobilePay
Manage agreementโ
When the user clicks on Manage agreement, they will be presented 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.
๐ณ๐ด Cards only
๐ซ๐ฎ ๐ฉ๐ฐ Cards and Accounts
- Vipps
- MobilePay
Update the maximum amount (applicable only for variable price payment agreements)โ
Users can choose a new max amount for the variable price payment agreements.
- Vipps
- MobilePay
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.
- Vipps
- MobilePay
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.
- Vipps
- MobilePay
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 Go to Merchant AS
link.
This merchant agreement URL is mandatory for Norwegian merchants and optional for Finnish and Danish merchants.
We recommend the merchants to 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.