> **Description:** Details about API and platform updates for September 2024, including new features, improvements, and important changes to Vipps services.

# Technical update Sep 2024

## Improved documentation search

The documentation search is now *much* better:

* More relevant results.
* Hierarchical results: Better overview
* Search as you type: **Fast!**
* Shortcut: `Command-K` (Mac) or `Control-K` (Windows)

## Recurring API: Future app changes

Based on the feedback from users in Norway, we are making it possible for Vipps users to stop their payment agreement
in the app starting 2024-11-04.
Key takeaways from the survey:

* 20000 Vipps users took part in the survey
* 87 % answered they would like to manage their agreement in Vipps
* 85 % answered they are more likely take the subscription again if it was easy to manage

You can [see what it looks like in the app](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/how-it-works/payment-agreement/README.md).

**Important information for the merchants**

1. Ensure that you listen to the `recurring.agreement-stopped.v1` webhook event and
   update the subscription status on your systems accordingly. The `actor` field in
   the payload will indicate if it was stopped by the merchant or the user.
2. When a user stops an agreement:
   * Already `RESERVED` charges will *not* be cancelled. Merchants can cancel or capture based on their needs.
   * All `PENDING/DUE` charges are cancelled.
3. Attempts at creating new future charges for a stopped agreement will result in an error.

Merchants will have the option to disable the feature that lets users cancel payment agreements within the app.
While we advise merchants against blocking users from canceling their agreements,
they can opt out if they have a compelling reason and meet the specified requirements.
However, it's important to note that opting out will exclude merchants from future functionalities related to managing agreements.
For more information, see
[Recurring API Guide: Opting out of the Stop Payment Agreement feature](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#opting-out-of-the-stop-payment-agreement-feature).

## Partners: Save 90 % of the time by using "prefill" in the Management API

Partners can use the Management API to
[prefill the product order form](https://developer.vippsmobilepay.com/docs/APIs/management-api/management-api-guide.md#prefill-a-product-order)
and make it much easier for merchants to provide the correct information, product configuration, and related details.

Our data shows that prefilled order forms save 90 % of the time filling out the form,
as the merchant only needs to check and submit. Processing the product orders is also faster,
since the product orders are correct.

In short: Use prefill to make sure merchants go live faster.

## Management API: Prefill available for management partners too

Partners that use *management keys* (deprecated)
can now use
[prefill product orders](https://developer.vippsmobilepay.com/docs/APIs/management-api/management-api-guide.md#prefill-a-product-order)
[get information about product orders](https://developer.vippsmobilepay.com/docs/APIs/management-api/management-api-guide.md#get-information-about-a-product-order),
and all other features of the Management API.

## Management API: Improved sales unit details

The
[`GET:/management/v1/sales-units/{msn}`](https://developer.vippsmobilepay.com/redocusaurus/management-swagger-id.yaml)
endpoint now returns more data about the sales unit:

```json
{
   "msn":123456,
   "name":"ACME Fantastic Fitness",
   "businessIdentifier":{
      "scheme":"business:NO:ORG",
      "id":"9876543221"
   },
   "configuration":{
      "paymentAllowed":false,
      "captureType":"ReserveCapture",
      "skipLandingPageAllowed":false,
      "recurringAllowed":false,
      "partialCaptureAllowed":true,
      "lateCaptureAllowed":false,
      "landingPagePhoneNumberLocked":false,
      "longLivingPaymentAllowed":false,
      "creditCardPaymentAllowed":true
   }
}
```

See:
[Get information about a sales unit](https://developer.vippsmobilepay.com/docs/APIs/management-api/management-api-guide.md#get-information-about-a-sales-unit).

## QR API: `IN_STORE` and `VENDING` categories for merchant callback QR codes

The merchant callbacks QR codes now offer
[two types of categories](https://developer.vippsmobilepay.com/docs/APIs/qr-api/api-guide/merchant-callback.md#setting-category).

These will determine which waiting screen the user will see in the app after the QR code
has been scanned, so the user gets a better user experience.

| `IN_STORE` | `VENDING` |
|----------|----------|
|     |    |

## Allowing decimal values for tax rate

The
[ePayment API](https://developer.vippsmobilepay.com/redocusaurus/epayment-swagger-id.yaml)
and
[Order Management API](https://developer.vippsmobilepay.com/redocusaurus/order_management-swagger-id.yaml)
now accept decimal values for tax/VAT input on the order details.
The `taxPercentage` field is now deprecated, and replaced with `taxRate` to allow decimal values for the tax lines.

## Get ready for MobilePay facade migration

For the merchants and partners using the existing MobilePay Subscriptions and App payments the time is approaching
where you need to start migrating to the Recurring and ePayment API. We have improved and are expanding the migration
guides to assist you in the migrations.

## Prefill phone number on landing page for MobilePay Online

You can now add a field to the Initiate Payment request allowing the phone number to be prefilled
on the landing page for MobilePay Online.
For more information, see
[Prefill phone number on landing page](https://developer.vippsmobilepay.com/docs/APIs/psp-mp-api/mp-psp-api-guide.md#prefill-phone-number-on-landing-page).

## Support for Danish and Finnish users in Vipps Login

Following the merger of Vipps and MobilePay, Vipps Login now supports Danish and Finnish MobilePay users.

## Questions or comments?

We're always happy to help with code or other questions you might have!
Please
[contact us](https://developer.vippsmobilepay.com/docs/contact.md).

> **Full site overview:** For every page in this documentation, read [https://developer.vippsmobilepay.com/llms.txt](https://developer.vippsmobilepay.com/llms.txt).