Agreements
1. Initiation
A user chooses Vipps MobilePay as payment method for a subscription on a merchant’s website or app.
2. The landing page
If the agreement was started on a desktop device, the user will be sent to the Vipps MobilePay landing page. The user confirms their number and is prompted to log in to Vipps MobilePay.
If the agreement was started from a mobile device, the app will automatically switch over to Vipps MobilePay.
3. Accept agreement
The user receives a push notification on their phone. They log in to Vipps MobilePay and accept the agreement. The agreement has multiple parameters that you can use to customize it to your business needs:
- The agreement can be with or without initial charge. Read more at How Recurring works with initial charge.
- The agreement can be with a campaign. Read more at How Recurring works with campaign.
- The agreement can have fixed or variable amount.
- The agreement can have flexible or fixed frequency: daily, weekly, monthly, etc.
In the example you can see the agreement with initial charge, without a campaign, with fixed amount and fixed monthly frequency.
- Vipps
- MobilePay
4. Confirmation of subscription
The user is redirected back to the merchant’s website or app, and the subscription is confirmed on the merchant’s page.
Please note: Activation of the agreement is not guaranteed to be finished by the time the user is redirected back to the merchantRedirectUrl
. The agreement could still have the status PENDING, so it is important to continue to poll the status of the agreement until a final status is returned by the API or use webhooks.
5. Overview of agreements and charges
The user can see their active subscriptions, as well as stopped subscriptions, and get an overview of previous charges in Vipps MobilePay.
6. Manage agreements
If the user clicks on Manage agreement in the previous step, they will be sent to the merchant’s site where they can manage their subscriptions. We recommend using the Login API to make login to the merchant’s site go smoothly. The manage agreement URL is mandatory for Norwegian merchants and optional for Finish and Danish merchants.
7. Stop agreement
Danish and Finish users can stop the agreement in the app. Make sure you have webhooks implemented to listen for this event.
Great! Now you know how the Recurring agreement process works.
Take a look at the technical documentation in the Recurring API Guide.