Vipps MobilePay
Two ways to accept Vipps – through Surfboard or under a direct agreement with Vipps – and how to connect Vipps for the webshop, the till and subscriptions.
Your customers can pay with Vipps in both the webshop and the till. In Cmerce you can set up Vipps in two ways: through Surfboard, or under your own direct agreement with Vipps MobilePay. This article explains the difference and shows the setup for the direct agreement.
Two ways to offer Vipps
| Through Surfboard | Direct agreement with Vipps | |
|---|---|---|
| Where you switch it on | The «Vipps» toggle on the Surfboard card | The «Vipps» card |
| Agreement and keys | Part of the Surfboard agreement | Your own agreement with Vipps MobilePay and your own API keys |
| Webshop | Yes | Yes |
| Till | No | Yes, once Vipps has approved it |
| Subscriptions | Card stored through Surfboard | The «Vipps Recurring» card |
If you have Surfboard and only need Vipps in the webshop, the simplest option is to switch on «Vipps» on the Surfboard card. See Surfboard – application and activation. To take Vipps at the till, you need the direct agreement. The rest of this article covers the direct agreement.
Before you start
- You need the «Betalingsmetoder» (Payment methods) permission.
- You need an agreement with Vipps MobilePay and access to portal.vippsmobilepay.com.
- Fetch these from the portal under «Utvikler» (Developer) → «Nøkler» (Keys): the MSN (the sales unit's number), Client ID, Client secret and Subscription key.
How to do it
Connect Vipps
- Go to «Innstillinger» (Settings) → «Salg og betaling» (Sales and payment) → «Betalingsmetoder» (Payment methods).
- On the «Vipps» card, choose «Miljø» (Environment): «Produksjon» (Production) for real payments, or «Test» if you only want to try it out.
- Fill in «MSN (merchant serial number)», «Client ID», «Client secret» and «Subscription key (Ocp-Apim-Subscription-Key)».
- Click «Test tilkobling» (Test connection) to check the keys, then «Lagre» (Save).
- Switch the card on («Aktivert») and tick «Nettbutikk» (Webshop).
When Vipps is connected, the card shows the MSN, the environment and the status of the notifications from Vipps («Aktiv», Active). If it says «Ikke registrert» (Not registered), click «Verifiser» (Verify) to try again. To change keys later, click «Endre innstillinger» (Change settings). The secret key fields can be left empty to keep the stored ones.
Vipps at the till
At the till, Cmerce sends a payment request (push message) to the customer's mobile number, and the customer approves it in the Vipps app. Vipps must first approve that specific payment method for your sales unit.
- Tick «Kasse (POS)» (Till) on the Vipps card. The text «Vipps i kassen krever godkjenning fra Vipps» (Vipps at the till requires approval from Vipps) appears.
- Contact your account manager, partner manager or Vipps customer service, and ask for «PUSH_MESSAGE» (in-store payment) to be activated for your MSN.
- Once Vipps has confirmed, click «Vipps har godkjent — slå på» (Vipps has approved — switch on) and confirm.
How the till takes Vipps payments: Taking payment: Vipps.
Vipps Recurring for subscriptions
- Connect Vipps first (see above).
- On the «Vipps Recurring» card, choose «Delt tilkobling» (Shared connection – same keys as Vipps) or «Egne nøkler» (Own keys – separate keys for Recurring), and click «Lagre».
- Click «Verifiser kompatibilitet» (Verify compatibility). You get an overview of which subscription products Vipps supports, and which have an interval Vipps cannot use. Adjust the interval on the product if needed.
- Switch the card on. Vipps Recurring can only be used in the webshop.
Good to know
- Online Vipps payments are reserved first and charged when the order is delivered, just like cards. Reservations that have not been charged after 7 days are cancelled automatically and the order is set to cancelled.
- At the till Vipps is charged straight away, because the customer receives the goods there and then.
- Vipps Recurring renewals are scheduled in advance. Vipps takes the money on the due date, never earlier, and the customer is notified in the app. That is why «Forny nå» (Renew now) on a subscription is not available for Vipps.
- If you switch the Vipps card off, the notification setup at Vipps is removed too. It is set up again when you switch the card back on.
- Regular Vipps cannot be chosen for «Abonnementer» (Subscriptions) – use Vipps Recurring or Surfboard for that.
Frequently asked questions
The customer does not get a push message at the till. What is wrong?
Check that the mobile number is correct, and that the customer has the Vipps app on that number. Also check that the approval for in-store payment is recorded on the Vipps card.
Can I test without real money?
Yes. Choose «Test» as the environment and use the test keys from the Vipps portal. Remember to switch to «Produksjon» before opening to customers.