> **Description:** Details about API and platform updates for April 2021, including new features, improvements, and important changes to Vipps services. # Technical update Apr 2021 ## "Click and collect" recommendations For "click and collect" we recommend to use [`staticShippingDetails`](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/vipps-ecom-api.md#shipping-and-static-shipping-details) (to avoid the extra HTTP roundtrip where Vipps asks the merchant for the shipping options and prices) and also to set the default shipping method to "Click and collect". This will significantly speed up the payment process for customers. This is done in the [`POST:​/ecomm​/v2​/payments`](https://developer.vippsmobilepay.com/redocusaurus/ecom-swagger-id.yaml) call by including: ```json "staticShippingDetails": [ { "isDefault": "Y", "priority": 0, "shippingCost": 0, "shippingMethod": "Click and collect", "shippingMethodId": "click-and-collect" } ] ``` ## Recurring payments and campaigns Tip: Use [Campaigns](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#campaigns) if the subscription is cheaper in the beginning, such as "One month for 10 NOK" and then the normal price. If you use `initialcharge`, users will be confused by how it appears in Vipps, as it looks like the full price period starts immediately. Initial charge should be used for situations where the customer pays for a phone and a phone subscription, and the first payment includes the phone. See more details and screenshots here: [When to use campaigns or initial charge](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md). ## Easier to use Userinfo The authentication is now much easier, with no need for additional keys, both for the eCom and Recurring APIs. See the call by call guides: * [eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/vipps-ecom-api.md#profile-sharing-call-by-call-guide) * [Recurring API](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#profile-sharing-call-by-call-guide) ## New date limits for capture and cancel Payments can be captured up to 365 days after reservation, and can be cancelled up to 180 days after reservation. Attempts at capturing and cancelling older payments will result in a `HTTP 400 Bad Request` with more details in the request body. ## Partner keys If you are a Vipps partner and manage transactions on behalf of other Vipps merchants you can use your own credentials to authenticate, and then send the `Merchant-Serial-Number` header to identify which of your merchants you are acting on behalf of. The same set of partner keys can be used for both the [eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/README.md) and the [Recurring API](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/README.md), including the [Userinfo](#use-userinfo) endpoints for both. See: [Partner keys](https://developer.vippsmobilepay.com/docs/partner/partner-keys.md) ## PSP Merchant API Payment Service Providers can use their existing API keys with the PSP Merchant API to: * List one or all merchants under them * Create a new merchant under them * Update an existing merchant See: [PSP Merchant API](https://developer.vippsmobilepay.com/docs/APIs/psp-merchant-api/psp-merchant-api-guide.md). ## Order new products and create new sales units on the portal All customers can now log in on the portal and order new products, which automatically creates a new sales unit: * Vipps på Nett ([eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/README.md)), for both webshops and apps * Vipps rett i Kassa ([eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/README.md)) * Vipps Faste betalinger ([Recurring API](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/README.md)) * Vipps Logg inn ([Login API](https://developer.vippsmobilepay.com/docs/APIs/login-api/README.md)) ## Create new sales units in the test environment You can create new sales units in the [test environment](https://developer.vippsmobilepay.com/docs/knowledge-base/test-environment.md) on the portal: On the page with the API keys for the test environment there is a button for creating additional sales units, and you can then select "direct capture" or "reserve capture", and also `skipLandingPage`. This is available for all customers, also those that do not yet have any API access. ## Reminders We have mentioned some things before, and take this opportunity to remind you: ### Please update your plugins Several of our plugins have been updated to use the newest versions of our APIs. Please make sure you have the newest version of the plugins you use, and keep them up to date. See the [plugin overview](https://developer.vippsmobilepay.com/docs/plugins/README.md). ### Use Userinfo Vipps Hurtigkasse is for shipping products to the customer. Some use it for other purposes, but if no products are shipped, you should not ask the customer for address and shipping method. You should avoid asking the customer in a pub for the shipping method for the drinks. Instead: Use *Userinfo* to ask for the user's details, such as: phone number, name, email address, postal address, birthdate, national identity number and bank accounts. The user must of course consent to sharing the information. See [Userinfo for eCom](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/vipps-ecom-api.md#profile-sharing) and [Userinfo for Recurring](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/recurring-api-guide.md#profile-sharing). ### API Dashboard *UPDATE from 2024-01-12: The API Dashboard is deprecated.* The API Dashboard is now available on the portal in the *Utvikler* section. It lets you see if there are problems with your use of APIs. Here's an example: This is just the start. Please let us know what you think and suggest improvements. ### Vipps HTTP headers We recommend using the following *optional* HTTP headers for all requests to the [eCom API](https://developer.vippsmobilepay.com/docs/APIs/ecom-api/README.md) and the [Recurring API](https://developer.vippsmobilepay.com/docs/APIs/recurring-api/README.md). | Header | Description | Example value | | ----------------------------- | -------------------------------------------- | -------------------- | | `Merchant-Serial-Number` | The merchant serial number | `123456` | | `Vipps-System-Name` | The name of the ecommerce solution | `WooCommerce` | | `Vipps-System-Version` | The version number of the ecommerce solution | `5.4` | | `Vipps-System-Plugin-Name` | The name of the ecommerce plugin | `woocommerce-payment` | | `Vipps-System-Plugin-Version` | The version number of the ecommerce plugin | `1.4.1` | These headers provide useful metadata about the merchant's system, which help Vipps improve our services, and also help in investigating problems. ### How to get help quickly Please see the [contact us](https://developer.vippsmobilepay.com/docs/contact.md) page. ### Technical updates archive Please see: [technical updates](https://developer.vippsmobilepay.com/docs/technical-updates/README.md) ## Questions or comments? We're always happy to help with code or other questions you might have! Please create [GitHub issues or pull requests](https://github.com/vippsas) for the relevant API, or [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).