Login

Choose your login scenario:

• User-initiated - Customer initiates login from your website or mobile app
• Merchant-initiated - You trigger login using customer's phone number (ideal for in-store enrollment)

Login from website/app ⭐

Login from website or app

Let customers authenticate and share their profile information with your service using Vipps MobilePay instead of traditional usernames and passwords.

1. User initiates login - Customer clicks Log in with Vipps or Log in with MobilePay on your website or app.
2. Authentication - On desktop, user enters phone number on landing page. On mobile, app-switch happens automatically.
3. Confirm in app - User confirms login in the Vipps or MobilePay app (can choose to be remembered for faster future logins).
4. Consent to share - User consents to share requested information (name, email, phone, address) with your service.
5. User logged in - User is authenticated and returned to your site with their profile information.

Seamless for returning users

If a user has previously logged in and chose Remember me in browser, they can log in without opening the app on subsequent visits from the same browser.

View sequence diagram

Login flow from website

1. User clicks "Log in with Vipps/MobilePay" on the merchant site.
2. Merchant initiates a login request with the Login API.
3. Login API redirects to the landing page or switches to the app.
4. User enters their phone number if needed and opens the app.
5. App prompts user to confirm login.
6. User gives consent to share information.
7. App returns the authorization code to the Login API.
8. Login API redirects the user back to the merchant.
9. Merchant exchanges the code for tokens with the Login API.
10. Login API returns the access token and user info to the merchant.
11. User is logged in.

Merchant-initiated login

Merchant-initiated login

Trigger a login flow directly on the customer's device using their phone number. Perfect for in-store customer enrollment and identity verification at point of sale.

1. Get phone number - Ask customer for phone number (verbally, manual entry, or scan their personal QR code).
2. Initiate login - Send login request to customer's device using Login API.
3. Push notification - Customer receives push notification and opens Vipps or MobilePay app.
4. Confirm in app - Customer confirms login and consents to share information with your service.
5. Complete enrollment - Customer is enrolled in your system with their verified information.

View sequence diagram

Merchant-initiated login flow

1. Customer provides their phone number.
2. Merchant initiates login with the customer's phone number via the Login API.
3. Login API sends a push notification to the Vipps or MobilePay app.
4. Customer opens the app and views the login request.
5. App displays the consent screen to the customer.
6. Customer confirms and gives consent.
7. App returns the authorization code to the Login API.
8. Merchant polls for completion and receives tokens from the Login API.
9. Merchant retrieves user info from the Login API.
10. Merchant enrolls the customer in the system.

Technical details

• How it works: Login from mobile
• How it works: Login from desktop
• How it works: Merchant-initiated login
• API guide - Complete API documentation and integration guides