Vipps MobilePay Gateway

Met de Vipps MobilePay-gateway kun je rechtstreeks binnen WCPOS telefoongebaseerde betalingen accepteren. Klanten betalen door een QR-code op het scherm te scannen of door een pushmelding op hun telefoon te bevestigen — er is geen kaartlezerhardware nodig.

Functies

QR-codebetalingen

Toon een QR-code bij het afrekenen zodat klanten kunnen scannen en betalen met hun telefoon

Pushmeldingen

Stuur een betaalverzoek rechtstreeks naar de telefoon van de klant door het nummer in te voeren

Noordse dekking

Werkt met Vipps in Noorwegen, MobilePay in Denemarken en Finland

Automatisch incasseren

Incasseer het geld direct na autorisatie, of reserveer het voor handmatige incasso

Installatie

1

Installeer WCPOS Vipps MobilePay

Installeer via WP Admin > POS > Settings > Extensions, of download de nieuwste plugin-zip-asset (niet de GitHub broncode-zip of tarball) van de GitHub releases-pagina en upload deze via Plugins > Add New > Upload Plugin.

2

Vipps-inloggegevens configureren

1. Ga naar WP Admin > WooCommerce > Settings > Payments
2. Zoek WCPOS Vipps MobilePay in de lijst met betaalmethoden
3. Klik op WCPOS Vipps MobilePay om de instellingen te openen
4. Voer je inloggegevens in vanuit het Vipps Portal:
   • Merchant Serial Number (MSN) (merchant-serienummer)
   • Client ID (client-ID)
   • Client Secret (clientgeheim)
   • Subscription Key (abonnementssleutel)
5. Sla de instellingen op

opmerking

Je hoeft de gateway hier niet in te schakelen voor POS-gebruik — deze wordt in de volgende stap specifiek voor de POS ingeschakeld. Door deze in de WooCommerce-instellingen in te schakelen, wordt deze ook beschikbaar bij het afrekenen in je webwinkel, wat handig kan zijn om te testen.

Gebruik je al de Vipps-plugin?

Als je de officiële plugin Checkout with Vipps MobilePay hebt geïnstalleerd, worden je inloggegevens automatisch geïmporteerd wanneer je deze plugin activeert. Je kunt het handmatig invoeren van inloggegevens overslaan.

3

Inschakelen in WCPOS

1. Ga naar WP Admin > POS > Settings > Checkout
2. Zoek de WCPOS Vipps MobilePay-gateway in de lijst
3. Schakel de gateway in voor gebruik in de POS
4. Sla je instellingen op

Gebruik

Betalingen verwerken — QR-code

1. Artikelen toevoegen: Voeg producten toe aan je winkelwagen in de POS
2. Gateway selecteren: Kies "Vipps MobilePay" als betaalmethode
3. QR-code genereren: Klik op de knop "Generate QR Code"
4. Klant scant: De klant scant de QR-code met de Vipps- of MobilePay-app
5. Klant bevestigt: De klant bevestigt de betaling in de app
6. Automatische voltooiing: De bestelling wordt automatisch voltooid zodra de betaling is geautoriseerd

Betalingen verwerken — Naar telefoon sturen

1. Artikelen toevoegen: Voeg producten toe aan je winkelwagen in de POS
2. Gateway selecteren: Kies "Vipps MobilePay" als betaalmethode
3. Telefoonnummer invoeren: Typ het telefoonnummer van de klant
4. Naar telefoon sturen: Klik op de knop "Send to Phone"
5. Klant bevestigt: De klant ontvangt een pushmelding of wordt naar de Vipps-landingspagina geleid en bevestigt vervolgens de betaling in de app
6. Automatische voltooiing: De bestelling wordt automatisch voltooid zodra de betaling is geautoriseerd

De plugin detecteert automatisch de beste methode om het betaalverzoek naar de telefoon van de klant te sturen:

• Directe push (voorkeur) — Stuurt een melding rechtstreeks naar de Vipps-app van de klant. Dit is de snelste ervaring, maar vereist dat Vipps PUSH_MESSAGE inschakelt op je verkooppunt (zie Directe push inschakelen hieronder).
• Landingspagina als terugval — Als directe push niet is ingeschakeld, opent de plugin de Vipps-landingspagina in een nieuw browsertabblad. De landingspagina verzorgt het verzenden van de melding. Dit werkt direct zonder speciale goedkeuring.

De eerste keer dat de plugin detecteert dat directe push niet beschikbaar is, zie je een korte melding met het verzoek om opnieuw op "Send to Phone" te klikken. Daarna onthoudt de plugin het resultaat en werkt het naadloos.

Directe push inschakelen

De directe-pushflow biedt de beste ervaring voor telefoonbetalingen — geen extra tabbladen, geen landingspagina's. Om deze in te schakelen:

1. Log in op portal.vippsmobilepay.com
2. Neem contact op met je Vipps key account manager, partner manager of klantenservice
3. Vertel hun: "I need PUSH_MESSAGE enabled on my MSN for use with a POS integration"

Na goedkeuring detecteert de plugin de wijziging binnen 24 uur automatisch en schakelt over naar de directe-pushflow. Je ziet een herinnering op de pagina met gateway-instellingen terwijl je de landingspagina als terugval gebruikt.

Een betaling annuleren

Terwijl je wacht tot de klant bevestigt, kun je op de knop Cancel Payment klikken om de transactie af te breken. Hiermee wordt de openstaande betaling aan de Vipps-kant geannuleerd en wordt de afrekeninterface gereset.

Terugbetalingen

Terugbetalingen worden afgehandeld via het standaard WooCommerce-terugbetalingsproces. Open de bestelling, klik op Refund, voer het bedrag in en de terugbetaling wordt automatisch verwerkt via de Vipps-API.

Ondersteunde markten

Vipps MobilePay opereert in de hele Noordse regio onder twee merken:

Regio	Merk	Valuta's
Noorwegen	Vipps	NOK
Denemarken, Finland	MobilePay	DKK, EUR

Je merchantaccount bepaalt welke markten en valuta's beschikbaar zijn. Klanten in elke ondersteunde markt kunnen betalen met hun lokale Vipps- of MobilePay-app.

Vereisten

Vipps-account: Actief Vipps MobilePay merchantaccount met API-inloggegevens

API-inloggegevens: Merchant Serial Number, Client ID, Client Secret en Subscription Key

WCPOS: Pro-versie vereist voor POS-afrekenen. De gateway werkt ook bij het standaard afrekenen via WooCommerce op het web zonder Pro.

HTTPS: Je site moet SSL/HTTPS gebruiken (vereist door de Vipps-API)

Probleemoplossing

Veelvoorkomende problemen

Betaling wordt niet voltooid

• De afrekenpagina peilt tot 5 minuten — als de klant binnen dat tijdvenster niet bevestigt, verloopt de betaling
• Controleer of je testmodus en productie-inloggegevens niet door elkaar haalt
• Controleer of je internetverbinding stabiel is op zowel het POS-apparaat als de telefoon van de klant

Fout met ongeldige inloggegevens

• Controleer alle vier de invoervelden voor inloggegevens (MSN, Client ID, Client Secret, Subscription Key) nogmaals
• Zorg dat je testinloggegevens gebruikt wanneer de testmodus is ingeschakeld en productie-inloggegevens wanneer deze is uitgeschakeld
• Controleer je inloggegevens in het Vipps Portal

'Send to Phone' opent een nieuw tabblad in plaats van rechtstreeks te verzenden

Dit betekent dat je Vipps-account nog geen PUSH_MESSAGE heeft ingeschakeld. De plugin gebruikt de landingspagina als terugval, wat werkt maar een extra stap toevoegt. Voor de soepelere directe-pushervaring neem je contact op met Vipps en vraag je hun om PUSH_MESSAGE in te schakelen op je verkooppunt (MSN). Zie Directe push inschakelen hierboven.

QR-code wordt niet gegenereerd

• Bevestig dat je site via HTTPS draait — de Vipps-API weigert verzoeken van HTTP-sites
• Controleer de WooCommerce-logs (WooCommerce > Status > Logs) op details over API-fouten
• Controleer of je merchantaccount actief is en de ePayment API ingeschakeld heeft

Hulp krijgen

Voor technische ondersteuning:

• Bezoek de GitHub-repository om problemen te melden
• Raadpleeg de Vipps-ontwikkelaarsdocumentatie voor API-gerelateerde vragen
• Neem contact op met Vipps MobilePay support voor account- en inloggegevensproblemen

Schermafbeeldingen

Schermafbeeldingen worden in een toekomstige update toegevoegd om het volgende te tonen:

• Gateway-configuratie in de WooCommerce-betaalinstellingen
• POS-afrekeninterface met opties voor QR-code en pushmelding
• Betalingsbevestigingsflow