How to change a merchant's partner

Merchants have the ability to change partners at their own discretion, and they are responsible for granting access to their data to their chosen partner(s).

If a merchant decides to change partners, their sales unit, identified by the Merchant Serial Number (MSN), they must provide a letter of consent to Vipps MobilePay. Then the sales unit must be reconfigured for use with new partner keys.

For general information about signing up new merchants, see How to sign up new merchants.

Procedure for changing partners

The sales unit can only be used with one set of partner keys at a time, so in the transition period, partners will need to use the merchant's API keys.

1. The merchant logs in on portal.vippsmobilepay.com and gets their API keys for the sales unit MSN.

   How to find the API keys

   You can find the API keys for your test or production sales unit in the merchant portal, portal.vippsmobilepay.com. (Need help logging in?)

   1. Select For developers in the sidebar. With the API keys tab selected, you should see a table with sales units.

      

   2. Select either Production or Test, depending on the type of sales unit you are looking for.

   3. Find the sales unit in the table and click the corresponding Show keys button. A panel will open where you can copy the values of each key.

      For example:

      

   If you need to get/give the API keys from/to someone, be sure to do it securely. If you can't do that, then create a portal user for that person, and give them basic access to the sales unit.

2. The merchant securely provides the MSN's API keys to both the old partner and the new partner. This ensures that, during the transition period, both partners can make API calls for the MSN without partner keys.

3. The new partner contacts their partner manager or the partner support team to request and provide consent for the partner change. This initiates a reconfiguration of the sales unit MSN, which must be connected to the new partner instead of the old one.

   Include the following information:

   • Organization number
   • Name of the new partner
   • Name of the old partner
   • MSN for the sales unit
   • Test page, if the website changes
   • Date and time of desired transfer from old partner to new partner
   • Signature from the merchant

   When this is done, the sales unit will be connected to the new partner, and we will provide new partner keys for the sales unit.

4. The new partner's partner keys now work for the MSN. The old partner keys will no longer work for the sales unit.

5. The new partner will begin using their partner keys.

6. When the merchant is ready to remove the old partner's access to the sales unit, they can log in on portal.vippsmobilepay.com and regenerate the API keys for the sales unit. The previous API keys will become invalid and unusable. The old partner will no longer have access to the sales unit, while the new partner will continue to use their partner keys.

Information

The merchant should generate new API keys, so their keys can no longer be used by the old partner.

The new partner should always use the partner keys. Use the Management API to verify that the MSN is set up correctly. See the Management API quick start guide to get started.

note

The Merchant Serial Number value (e.g., 281014) does not change when changing partners.

note

The new partner will have access to all payments made to the sales unit. It is not possible to limit the new partner's access, so they will be able to see payments made prior to the partner change.