Payment-method icon

Vipps Component

Add Vipps to your Web Components integration.

On this page, you can find additional configuration for adding Vipps to your Components integration.

Before you begin

This page assumes you have already:

API reference

Select which endpoint you're integrating:

Parameter name Required Description
shopperStatement The description of this payment shown in the Vipps app. If you don't specify a shopperStatement, we'll use the value that you provided as the reference to populate this field.

Component configuration

Step 1: Create a DOM element

Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:

 <div id="vipps-container"></div>

Step 2: Create an instance of the Component

Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:

const vippsComponent = checkout.create('vipps').mount('#vipps-container');

Recurring payments

The minimum transaction amount for Vipps is 1.00 NOK

Complete the following to make recurring payments for Vipps:

  1. Contact our Support Team and ask them to configure vippsAgreementUrl for your account.
    vippsAgreementUrl is a URL that you provide, where the shopper can manage their recurring agreement.
  2. Create a shopper token when the shopper is making a Vipps payment.
  3. Use the token to make future payments for the shopper.

Create a token

To create a token, include in your /payments request:

  • storePaymentMethod: true
  • shopperReference: Your unique identifier for the shopper.

When the payment has been authorised, you receive a webhook containing:

  • eventCode: RECURRING_CONTRACT
  • originalReference: The pspReference of the initial payment.
  • pspReference: The token that you need to make recurring payments for this shopper.

Make sure that your server is able to receive RECURRING_CONTRACT as part of your standard webhooks. You can enable the RECURRING_CONTRACT event code in the webhook settings page.

Make a payment with a token

To make a payment with saved payment details, include in your /payments request:

  • paymentMethod.type: vipps.
  • paymentMethod.storedPaymentMethodId: The pspReference from the RECURRING_CONTRACT webhook.
  • shopperReference: The unique shopper identifier that you specified when creating the token.
  • shopperInteraction: ContAuth.
  • recurringProcessingModel: Subscription for subscription payments, or CardOnFile for one-off payments.
    For more information about these parameters, refer to our Tokenization guide.

Test and go live

To test your integration, install a Vipps test app, and use the following credentials:

  • Phone number: 98258879, 91437328, 46364980, 45902658, 97538802, 45480257, 45241041, 99290775, or 95686106, 92426303
  • PIN: 1236

The Vipps test app is limited to a Visa test card. You can test different scenarios by adding additionalData.RequestedTestAcquirerResponseCode to your /payments request, as described in Using additional data.

Check the status of Vipps test payments in your Customer Area > Transactions > Payments.

Go live

Before you can accept live Vipps payments, you need to submit a request for Vipps in your live Customer Area.

See also