Skip to main content

How MobilePay Online works

View as Markdown (opens in a new tab)
Install AI tools

Give your assistant up-to-date guidance for our APIs, with our plugin or without it.

The plugin is still under development. See the AI tools page for details.

Run both commands, in order.

claude plugin marketplace add vippsas/agent-toolkit
claude plugin install vipps-developer@agent-toolkit

For troubleshooting, see the full instructions.

End of life

This API doesn't have any set end of life yet, but is receiving critical maintenance only. Long term support for PSPs will be served by the ePayment API. No new integrations to this API will be approved.

This API is only available in the Danish and Finnish markets.

How payments in web shops or merchant websites work with MobilePay Online.

Details​

1. Customer picks MobilePay at checkout​

Make MobilePay available as a payment option in your webshop or app—easy and familiar for your customers!

Web checkout showing MobilePay as a payment option

Screenshot: Mobile merchant cart page showing a product and a "Pay with MobilePay" button as payment option.

2. Customer enters phone number and logs in​

When they tap MobilePay, initiate a payment by calling POST:/api/v3/payments/.

  • Mobile device: The MobilePay app opens automatically.
  • Desktop: The landing page opens. The customer enters their phone number and hits Next to send the payment request to their app. A push notification appears on the customer's phone and the customer opens the MobilePay app.

MobilePay landing page showing phone number input field

Screenshot: MobilePay landing page. Left panel: phone number entry for a payment with "Remember my number" checkbox. Right panel: waiting screen with "Open MobilePay" and a countdown timer.

3. Customer approves the payment in the app​

The customer confirms the payment, and MobilePay Online reserves the payment and provides a confirmation.

Confirm payment MobilePay

Screenshot: Vipps/MobilePay app payment screen showing the amount to pay to the merchant, with a Visa Spendings card and a Pay button.

4. Confirm the order​

Once the payment is approved:

  • Mobile device: The store page/app reopens, confirming a successful order.
  • Desktop: The customer returns to the webshop, where the order confirmation is displayed.

Payment confirmation screen showing successful order

Screenshot: Merchant webshop order confirmation page showing "Thank you for your order" with a green checkmark. A confirmation email has been sent to the customer.

To check if the payment was authorized, poll using GET:/psp/v3/psppayments/{pspTransactionId}/details. See our polling guidelines for best practices.

5. Complete the order​

The merchant completes and ships the order to the customer.

6. Capture the payment​

Finish by capturing the payment through MobilePay Online.

Want more details?​

For technical details, see the MobilePay Online guide.

Last updated on