Partner FAQ

What do I do if I've compromised the keys

For all keys other than merchant API keys, contact our partner team. For merchant keys, the merchant needs to generate new ones on the portal.

Update your integrations, so they will continue working.

How to check the status of a product order

The Management API has functionality to:

• Get information about a product order (only if the product order was submitted with "prefill")
• Get information about a sales unit
• Get the sales units for a merchant by business identifier
• and more.

note

• There are strict rules for what information we are allowed to share with a partner. To give more details than the above, we require consent from the merchant, and the merchant must also be able to withdraw that consent. We do not have that consent management system, and it is unlikely that we will implement it.
• Partners can use Get the sales units for a merchant by business identifier to check if a merchant's sales unit is live.
• The best way to check the status of a product order is for the merchant to check on portal.vippsmobilepay.com.
• See: Typical reasons for delays.

How can a partner check things on behalf of the merchant?

We recommend the following approach:

1. Integrate with the Management API, so the functionality is made available in the partner's own admin interface.

   The Management API is designed and developed to enable as much self-service and automation as possible. Our Partner terms and conditions state that partners are obligated to use the Management API.

   You can send single requests with an API client.

2. Ask the merchant to create a user for the partner on portal.vippsmobilepay.com, so the partner can check on behalf of the merchant.

Common things to check:

• How can I check if I have skipLandingPage activated?
• How can I check if a sales unit has "reserve capture" or "direct capture".

note

Vipps MobilePay can only share information about the status of a merchant's agreement or product orders if the partner used the prefill functionality in the Management API.

We can't share information about product orders submitted by merchants on their own. This is because we need explicit consent from the merchant to share the information, and the consent must also be possible to withdraw.

The merchant can check the status on portal.vippsmobilepay.com any time.

When a new merchant gets their Vipps MobilePay application approved, an email is sent to both the merchant and the partner with information about:

• The merchant's organization number
• The merchant's name
• The sales unit's MSN
• The sales unit's name

The Management API enables a partner to look up merchant serial numbers based on the merchant's organization number, and also retrieve details of a specific sales unit based on the sales unit's MSN.

How to get access to your sales units on the merchant portal

Partners can get access to manage sales units in the merchant portal by ordering a product, such as Login.

Ordering Login is the fastest, because the Login API does not allow for payments and, therefore, the requirements for compliance are simplest.

You will need to get a merchant agreement and order the product as described on the Applying for services page.

note

• The partner must have a website.
• The partner's organization number must be clearly visible on the website.
• The partner must mention in the application that the application is for a partner and that it's for access to the API for development.

When your order for Login is approved, you can log in to the portal and manage your own sales units for use in the test environment.

You can ask the merchant to create a user for you, so you get access to the merchant's MSN as described in detail with screenshots.

note

Vipps MobilePay doesn't have a separate partner portal.

See:

• Merchant portal: How to log in

Where can I find guides for integrating with the API?

The API platform page should guide you to the API that corresponds with the product ordered by the merchant. Go into that API section and have a look at the examples in the "How it works" guides and the Quick start guide. These you with illustrations and examples for starting with the API. You can then dig deeper to find all the details for each endpoint.

Other questions

You may find answers to your questions on our FAQ section on the bottom of the partner page.

Please contact your partner manager. If you do not have a partner manager, please contact partner@vippsmobilepay.com.