Skip to main content

How the Vipps PSP API works online

How payments in web shops or merchant websites work with the Vipps PSP API.

Details​

1. Customer selects their payment method​

Give the customer the option to pay with Vipps in your webshop or app.

Web checkout showing Vipps as a payment option

Screenshot: Mobile merchant cart page showing items, cost, and and a "Pay with Vipps" button.

2. Customer enters their phone number and logs in​

When they select Vipps, initiate a payment with: POST:/psp/v3/psppayments/init/.

If the payment was started from a mobile device, the Vipps app will automatically open.

If the payment was started on a desktop device, the landing page will open. There, the customer enters their phone number and clicks Next to send the payment request to the app on their phone.

Vipps landing page showing phone number input field

Screenshot: Vipps landing page. Left panel: phone number entry (Norwegian +47 prefix) with "Remember my number" checkbox. Right panel: waiting screen with "Open Vipps" and a countdown timer.

3. Customer confirms the payment in the app​

A push notification appears on the customer's phone. They log in to Vipps and confirm the payment. The Vipps PSP API automatically reserves the payment and provides confirmation of the successful payment.

Customer approves payment in Vipps

Screenshot: Vipps app payment screen showing payment to Merchant with order description, Visa Spendings card, and a Pay button.

4. The merchant's shop confirms the order​

After the customer has approved the payment in the app:

  • If the payment was started on a mobile device, the store page or app will open again and confirm that the order was successful.
  • If the payment was started on a desktop device, the user can go back to the webpage where it will confirm that the order was successful.

Payment confirmation screen showing successful order

Screenshot: Merchant webshop order confirmation page showing "Thank you for your order" with a green checkmark and an order summary with free shipping.

To determine that the user has authorized the payment, poll with the GET:/psp/v3/psppayments/{pspTransactionId}/details request. See the guidelines for polling.

5. The merchant completes the order and shipping​

The merchant completes the order and ships it to the customer.

6. Capture the payment​

The merchant captures the order through the PSP who captured the payment through the Vipps PSP API.

More information​

For technical details, see the Vipps PSP API guide.

Last updated on