Skip to main content

Technical update 2022-11

This update was sent in November 2022.

Specify amounts in øre without decimals

Vipps MobilePay requires amounts to be specified in øre, without decimals: "Amounts are specified in minor units. For Norwegian kroner (NOK) that means 1 NOK = 100 øre. Example: 499 NOK = 49900 øre."

We still see that some attempts at specifying payments with amounts that end in .0000001.

API requests til incorrect amounts will fail: Both initiate, capture and refund.

Please check for rounding errors, and of course: Always monitor the responses to your API requests: Please check your API calls for errors.

Get ready for "black week"

Let your customers pay with Vipps Hurtigkasse with the new and improved user experience by specifying useExplicitCheckoutFlow": true to reduce drop-off, left shopping carts, etc.

Make sure your use of Vipps MobilePay is as good as it can be, without errors. See: Please check your API calls for errors.

Monitor the Vipps Status Page: vipps.statuspage.io (link updated to https://status.vippsmobilepay.com on 15/1/24)

See: Why do payments fail?

eCom API: Don't rely 100 % on callbacks

Callback offers a faster user experience than polling, but you cannot rely on callbacks alone. You must also poll GET:/ecomm/v2/payments/{orderId}/details as described in the Polling guidelines.

See: Callbacks

Report API

The Report API gives you or a third-party acting on your behalf the ability to fetch information about payment events that have been processed by Vipps.

Documentation improvements

We are working hard to improve the Vipps Technical Documentation:

Please tell us what you think in this short, 3-minute survey - thanks!

Check your phone number format

Far too many Vipps payments fail because of badly formatted phone numbers. We try to silently correct them, but we can't fix all errors.

This is especially important when using Skip landing page, as it's impossible to send a push message to a user if the specified phone number is incorrect.

Please see the API specification: POST:/ecomm/v2/payments

API specification for phone number

Reminders

Please check your API calls for errors

UPDATE from 12 Jan 2024: The API Dashboard is deprecated.

We are working on eliminating incorrect API use. Please:

  • Monitor the responses you get when making API calls
  • Log all errors
  • Fix errors as quickly as possible
  • Use the API Dashboard to find problems with your integration.

API Dashboard example

Questions or comments?

We're always happy to help with code or other questions you might have! Please create GitHub issues or pull requests for the relevant API, or contact us.

Help us improve our documentation

Did you find what you were looking for?