# 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[​](#features "Directe link naar 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[​](#installation "Directe link naar 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](https://github.com/wcpos/wcpos-vipps/releases) 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](https://portal.vipps.no/):

   <!-- -->

   * **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](https://wordpress.org/plugins/woo-vipps/) 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[​](#usage "Directe link naar Gebruik")

### Betalingen verwerken — QR-code[​](#processing-payments--qr-code "Directe link naar 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[​](#processing-payments--send-to-phone "Directe link naar 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](#enabling-direct-push) 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[​](#enabling-direct-push "Directe link naar 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](https://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[​](#cancelling-a-payment "Directe link naar 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[​](#refunds "Directe link naar 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[​](#supported-markets "Directe link naar 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[​](#requirements "Directe link naar 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[​](#troubleshooting "Directe link naar Probleemoplossing")

### Veelvoorkomende problemen[​](#common-issues "Directe link naar 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](https://portal.vipps.no/)

'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](#enabling-direct-push) 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[​](#getting-help "Directe link naar Hulp krijgen")

Voor technische ondersteuning:

* Bezoek de [GitHub-repository](https://github.com/wcpos/wcpos-vipps) om problemen te melden
* Raadpleeg de [Vipps-ontwikkelaarsdocumentatie](https://developer.vippsmobilepay.com/) voor API-gerelateerde vragen
* Neem contact op met Vipps MobilePay support voor account- en inloggegevensproblemen

## Schermafbeeldingen[​](#screenshots "Directe link naar 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