Skip to main content

Technical newsletter for developers 2022-10

This newsletter was sent in October 2022.

New developer documentation

We have a completely new, in-progress, website for all developer documentation:

Vipps Developer Documentation

Examples:

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

Recurring API: New v3 API coming this fall

The Recurring API v3 will include new and much improved Campaign functionality, the opportunity to use "reserve capture" (first reserve the payment, then capture it), partial capture recurring charges, and more.

Estimated release is in October.

Recurring API: Rollback of UI changes on Android

As part of the improvements on our Campaign functionality we rolled out a new UI on campaign agreements on Android. However, we have gotten some feedback that this is not ideal for all merchants due to differences in "campaign logic".

In Vipps we take feedback and insight seriously and have therefore decided to roll back the UI changes on Android on v2 to meet the needs from our merchants.

The UI changes will be included in the Recurring API v3, together with the Campaign improvements.

Recurring API: Rollback of new charge business rules

Due to feedback from merchants we have decided not to enforce the stricter charge rules we enabled September 13. See the Vipps status page for more information about when this happened.

Going forward we will look into how we can implement charge limits in a better way, that takes care of the merchants needs. This will be communicated well in advance before we enforce any new rules.

Inform customers that there are no fees when paying with Vipps

It can help your conversion if you remind your users that:

  • There are no Vipps fees when paying a business
  • Users get all the benefits of the card when using the card in Vipps (bonus points, etc.)

We recommend using this text where users select payment method: Norwegian: "Husk: Vipps er alltid gebyrfritt når du betaler til bedrifter."

Roughly translated, this means, "Remember: Vipps MobilePay is always free from fees when you pay to companies".

If you use Klarna Checkout, here are our tips.

Vipps on-site messaging

Vipps on-site-messaging contains badges in different variants that can be used to let your customers know that Vipps payment is accepted.

Partner API: Prefill applications

Partners can now use the Partner API to prefill applications and submit a product order for a merchant.

Settlement API: In progress

We are in the early planning phase of developing an API for settlements.

If you are interested in this and want to be kept up to date when we have something to share, please email developer@vippsmobilepay.com.

Reminders

Please check your API calls for errors

We are working on eliminating incorrect API use. Although we always respond to incorrect API calls with a sensible HTTP status (usually HTTP 400 Bad Request) and an informative error message in the response body, we see that some merchants and partners keep making incorrect API calls.

Please:

  • Monitor the responses you get when making API calls
  • Log all errors
  • Fix errors as quickly as possible
  • Use the API Dashboard
  • Contact us if there is anything we can help with

Use the API Dashboard to find problems with your integration

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

The API Dashboard is available to all merchants for both the production and test environments, and is an easy way to see if you are using the APIs correctly. Think of it as a "health check", that you can use to see if there are any problems you need to investigate.

Here's an example for the eCom API's /refund endpoint:

API Dashboard example

How to get help quickly

Please see this page.

Newsletter archive

Please see: newsletters

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?