User guide

Introduction

The Vipps Login module offers functionality for authenticating end users and authorizing clients. Vipps Login is founded on the OAuth2 and OpenID Connect specifications. It supports using web browsers on websites and in native apps for iOS and Android using app switching.

Basic Flow

Sign-In using Vipps / Register using Vipps

The sequence of operations is as follows:

1. The customer presses a Sign-In with Vipps or Register with Vipps button and is redirected to a Vipps web page.

2. The customer interacts with Vipps web page and mobile app to permit access to Vipps account data for the webshop.

3. The customer is redirected back to Magento webshop.

4. If access was granted to the webshop, the plugin has access to customer data such as: name, email, phone number, and addresses.

5. Magento performs the log-in or creates a new account for the customer.

   If the customer has granted consent for Magento to use their phone number, Magento can then use the Vipps Login module to check if the account exists. Magento checks if the system already contains an account that is linked with the Vipps account. If yes, the customer is already verified and the log-in can be completed. If no, it can mean one of the following:

   • The customer's account has not been previously linked with Vipps. They will need to confirm or link accounts.
   • The customer does not have an account and must create one.

Confirm existing account

In the case when a customer doesn't have a Magento account which has been previously linked with Vipps, Magento will try to find existing Magento account by using the email and phone number obtained from Vipps. If the account exists, it will redirect customer to Confirmation page.

The customer can finish the process by using password or email confirmation. When the account is confirmed, it will be linked with Vipps account. Thus, no extra steps are needed for a later sign-in.

Create a new account

If there is no account defined for customer then Magento will try automatically create a new account using Vipps account data.

In the case when Magento can't create an account automatically, the customer will be redirected to a standard Magento registration form to complete it manually. This could happen, for example if Magento required additional data for account creation that is missing in Vipps account.

Link Magento and Vipps accounts

It is possible to link the customer account and Vipps account that is being signed-in into the system. To do this, customer should:

• Go to My Account page
• Choose Login with Vipps on the left menu
• Press Login with Vipps and finalize the process

Sync addresses between Vipps and Magento

Each time a customer signs in to the system, the Vipps Login module checks if the customer's addresses have changed.

There are three ways to update the addresses and the customer is able to select from these:

• Update automatically - The customer will not be asked, but addresses will be automatically updated.
• Ask first - The customer will be asked before the update.
• Do nothing - The customer will not be asked, and addresses will not be updated.

In the case when a behavior set to ask first and the Vipps address(es) where changed, the customer will see a notification.

Work with addresses

Get addresses from Vipps account

After log in with Vipps, all your Vipps addresses will be transferred to the Magento webshop and displayed in My account / Address book left menu item.

The Vipps addresses are stored into a separate vipps_customer_address table.

The Vipps addresses are automatically converted to the Magento default billing and shipping address, if such do not exist.

Default billing and shipping address

The Vipps address that was converted to Magento address is marked as Applied/Used.

Use Vipps Address

If the Vipps address was not converted to Magento, there will be a link Use Address.

By selecting Bruk adresse ("Use address"), the customer will be able to edit the address and save it in a standard Magento way.

Adding new Magento address

If customer is adding an address in a standard Magento way and there is at least one Vipps address that was not converted to Magento (was not applied | not using), then customer will be able to use their Vipps address data for new address by choosing it in a dropdown menu at the top.

NB! If customer changed any data so that newly created address and Vipps address are different such addresses will not be linked between each other.

Cart page

The Vipps module injects a Vipps Login button on the cart page. This allows the customer to log in to the system and proceed to checkout. This provides a better user experience, since they don't need to specify their shipping or billing address manually.

Please note: If the cart page contains a Vipps Express Checkout button from the Vipps Payment module, only the Vipps Login button will be shown. Vipps Login has higher priority.

Checkout page

Sign-in

It is also possible to sign-in using Vipps from a checkout page.

Adding new address

If the customer wants to add an address directly from the checkout page, you can populate the form based on the unused Vipps addresses. This is done in the same manner as for My account / Address book page.