Vipps can be enabled in the Billwerk+ Administration under Configurations > Payment Methods by adding a Vipps agreement. When using Vipps in Billwerk+ Checkout there are a number of things you need to be aware of and handle in your implementation.

💻 Vipps on desktop

If the customer is on a desktop browser, there is no difference between Vipps and other payment types like credit cards. If the customer chooses to pay with Vipps, the customer is redirected to Vipps' page where the customer enters phone number and waits for a push message on the phone where the payment can be completed.

Once completed the page redirects back to Billwerk+ Checkout and either a return url is activated in window mode or a JS callback is invoked in overlay or embedded mode.

📱 Vipps on mobile device

When Vipps is used on a mobile device, the Vipps page might activate an app switch to the Vipps app instead of the normal flow as on desktop. When the app completes the payment, the app opens the accept url in the standard browser for the device. If the customer is not using the standard browser, the customer will return in another browser.

To handle this, the accept page should not rely on cookies, but only rely on content on the accept url to identify the payment session. To use Vipps on a mobile device with overlay and embedded mode, it is required to use accept and cancel urls to be able to return. We recommend detecting device type and use window mode for mobile devices.

📘

Vipps desktop flow on mobile device

Alternatively, it is possible to redirect to Vipps' page to enter phone number instead of app switch to Vipps app. This can be done by adding a query parameter ?forceVippsDesktopFlow=true

💳 Vipps as the only payment method

If Vipps is the only payment method selected by using "payment_methods": ["vipps"] some special handling is performed:

The customer will be redirected directly to Vipps without showing the Billwerk+ Checkout window.

If the payment is cancelled by the customer, the cancel url/callback is invoked immediately without showing the Billwerk+ Checkout window as it would only show Vipps in this case.