Vipps Redirect Component

This page explains how to add Vipps to your existing Components integration.

Requirements

API reference

You do not need to send additional fields for Vipps. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:

• /sessions: This is the default with Components v5.0.0 or later.
• /payments: If you implemented an additional use case.

Component configuration

v5.0.0 or later

If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Vipps Component:

let paymentMethods = session.sessionContext.paymentMethods
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("vipps")) else { return }
let component = InstantPaymentComponent(paymentMethod: paymentMethod,
                                        context: context,
                                        order: nil)
self.currentComponent = component
// Set the session as the delegate.
component.delegate = session
component.initiatePayment()

v4.x.x

If your integration uses an earlier version of iOS Components:

// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: VippsPaymentMethod.self) else { return }
let style = FormComponentStyle()
let component = VippsComponent(paymentMethod: paymentMethod,
                                apiContext: context,
                                style: style)
present(component)

There are no configuration steps specific to Vipps required for Components.

Test and go live

Vipps cannot be tested in the test environment. You must make penny test (low-amount) payments in the live environment.

Request for Vipps in the live environment

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

After Vipps is added to your live Customer Area, do the following for each test payment:

1. Make a Vipps payment for a low amount.
2. Get the AUTHORISATION webhook on your server. It includes the status of the payment.
3. In your live Customer Area, go to Transactions > Payments to see the status of the payment.

See also