# Gateway Vipps MobilePay

Il gateway Vipps MobilePay ti consente di accettare pagamenti basati su telefono direttamente all'interno di WCPOS. I clienti pagano scansionando un codice QR sullo schermo o confermando una notifica push sul loro telefono, senza necessità di hardware per lettori di carte.

## Caratteristiche[​](#features "Collegamento diretto a Caratteristiche")

#### Pagamenti con QR Code

Mostra un codice QR al checkout affinché i clienti possano scansionarlo e pagare con il loro telefono

#### Notifiche Push

Invia una richiesta di pagamento direttamente al telefono del cliente inserendo il loro numero

#### Copertura Nordica

Funziona con Vipps in Norvegia, MobilePay in Danimarca e Finlandia

#### Auto Cattura

Cattura i fondi immediatamente dopo l'autorizzazione o riserva per cattura manuale

## Installazione[​](#installation "Collegamento diretto a Installazione")

1

#### Installa WCPOS Vipps MobilePay

Installa da `WP Admin > POS > Settings > Extensions`, oppure scarica l'ultimo **asset zip del plugin** (non lo zip o il tarball del codice sorgente di GitHub) dalla [pagina delle release di GitHub](https://github.com/wcpos/wcpos-vipps/releases) e caricalo tramite `Plugins > Add New > Upload Plugin`.

2

#### Configura le Credenziali Vipps

1. Naviga su `WP Admin > WooCommerce > Settings > Payments`

2. Trova **WCPOS Vipps MobilePay** nell'elenco dei metodi di pagamento

3. Clicca su **WCPOS Vipps MobilePay** per accedere alle impostazioni

4. Inserisci le tue credenziali dal [Vipps Portal](https://portal.vipps.no/):

   <!-- -->

   * **Numero di serie del commerciante (MSN)**
   * **Client ID**
   * **Client Secret (segreto del client)**
   * **Subscription Key (chiave di sottoscrizione)**

5. Salva le impostazioni

nota

Non è necessario abilitare il gateway qui per l'uso in POS — sarà abilitato specificamente per il POS nel passaggio successivo. Abilitandolo nelle impostazioni di WooCommerce, sarà anche disponibile al checkout del tuo negozio online, il che può essere utile per i test.

Stai già utilizzando il plugin Vipps?

Se hai installato il plugin ufficiale [Checkout with Vipps MobilePay](https://wordpress.org/plugins/woo-vipps/), le tue credenziali saranno importate automaticamente quando attivi questo plugin. Puoi saltare l'inserimento manuale delle credenziali.

3

#### Abilita in WCPOS

1. Vai su `WP Admin > POS > Settings > Checkout`
2. Trova il gateway **WCPOS Vipps MobilePay** nell'elenco
3. Abilita il gateway per l'uso nel POS
4. Salva le tue impostazioni

## Utilizzo[​](#usage "Collegamento diretto a Utilizzo")

### Elaborazione dei Pagamenti — QR Code[​](#processing-payments--qr-code "Collegamento diretto a Elaborazione dei Pagamenti — QR Code")

1. **Aggiungi Articoli**: Aggiungi prodotti al tuo carrello nel POS
2. **Seleziona Gateway**: Scegli "Vipps MobilePay" come metodo di pagamento
3. **Genera QR Code**: Clicca sul pulsante "Genera QR Code"
4. **Il Cliente Scansiona**: Il cliente scansiona il codice QR con la propria app Vipps o MobilePay
5. **Il Cliente Conferma**: Il cliente conferma il pagamento nella sua app
6. **Completamento Automatico**: L'ordine viene completato automaticamente una volta autorizzato il pagamento

### Elaborazione dei Pagamenti — Invia a Telefono[​](#processing-payments--send-to-phone "Collegamento diretto a Elaborazione dei Pagamenti — Invia a Telefono")

1. **Aggiungi Articoli**: Aggiungi prodotti al tuo carrello nel POS
2. **Seleziona Gateway**: Scegli "Vipps MobilePay" come metodo di pagamento
3. **Inserisci Numero di Telefono**: Digita il numero di telefono del cliente
4. **Invia a Telefono**: Clicca sul pulsante "Invia a Telefono"
5. **Il Cliente Conferma**: Il cliente riceve una notifica push o viene diretto alla pagina di atterraggio di Vipps, quindi conferma il pagamento nella sua app
6. **Completamento Automatico**: L'ordine viene completato automaticamente una volta autorizzato il pagamento

Il plugin rileva automaticamente il miglior metodo per inviare la richiesta di pagamento al telefono del cliente:

* **Push diretto** (preferito) — Invia una notifica direttamente all'app Vipps del cliente. Questa è l'esperienza più veloce ma richiede che Vipps abiliti `PUSH_MESSAGE` sulla tua unità di vendita (vedi [Abilitare il Push Diretto](#enabling-direct-push) qui sotto).
* **Fallback alla pagina di atterraggio** — Se il push diretto non è abilitato, il plugin apre la pagina di atterraggio di Vipps in una nuova scheda del browser. La pagina di atterraggio si occupa di inviare la notifica. Questo funziona immediatamente senza approvazione speciale.

La prima volta che il plugin rileva che il push diretto non è disponibile, vedrai un breve messaggio che ti chiede di cliccare nuovamente su "Invia a Telefono". Dopo di che, ricorda il risultato e funziona senza problemi.

### Abilitare il Push Diretto[​](#enabling-direct-push "Collegamento diretto a Abilitare il Push Diretto")

Il flusso di push diretto offre la migliore esperienza per i pagamenti telefonici — niente schede extra, niente pagine di atterraggio. Per abilitarlo:

1. Accedi a [portal.vippsmobilepay.com](https://portal.vippsmobilepay.com)
2. Contatta il tuo account manager chiave Vipps, partner manager o servizio clienti
3. Dì loro: **"Ho bisogno che PUSH\_MESSAGE sia abilitato sul mio MSN per l'uso con un'integrazione POS"**

Una volta approvato, il plugin rileva il cambiamento automaticamente entro 24 ore e passa al flusso di push diretto. Vedrai una notifica di promemoria sulla pagina delle impostazioni del gateway mentre utilizzi il fallback della pagina di atterraggio.

### Annullare un Pagamento[​](#cancelling-a-payment "Collegamento diretto a Annullare un Pagamento")

Mentre aspetti che il cliente confermi, puoi cliccare sul pulsante **Annulla Pagamento** per annullare la transazione. Questo annulla il pagamento in sospeso sul lato Vipps e ripristina l'interfaccia di checkout.

### Rimborsi[​](#refunds "Collegamento diretto a Rimborsi")

I rimborsi vengono gestiti tramite il processo standard di rimborso di WooCommerce. Apri l'ordine, clicca su **Rimborso**, inserisci l'importo e il rimborso viene elaborato automaticamente tramite l'API Vipps.

## Mercati Supportati[​](#supported-markets "Collegamento diretto a Mercati Supportati")

Vipps MobilePay opera nella regione nordica sotto due marchi:

| Regione              | Marchio   | Valute   |
| -------------------- | --------- | -------- |
| Norvegia             | Vipps     | NOK      |
| Danimarca, Finlandia | MobilePay | DKK, EUR |

Il tuo account commerciante determina quali mercati e valute sono disponibili. I clienti in qualsiasi mercato supportato possono pagare utilizzando la propria app Vipps o MobilePay locale.

## Requisiti[​](#requirements "Collegamento diretto a Requisiti")

Account Vipps

<!-- -->

: Account commerciante Vipps MobilePay attivo con credenziali API

Credenziali API

<!-- -->

: Merchant Serial Number, Client ID, Client Secret e Subscription Key

WCPOS

<!-- -->

: Versione Pro richiesta per il checkout POS. Il gateway funziona anche sul checkout web standard di WooCommerce senza Pro.

HTTPS

<!-- -->

: Il tuo sito deve utilizzare SSL/HTTPS (richiesto dall'API Vipps)

## Risoluzione dei Problemi[​](#troubleshooting "Collegamento diretto a Risoluzione dei Problemi")

### Problemi Comuni[​](#common-issues "Collegamento diretto a Problemi Comuni")

Pagamento non completato

* Il checkout verifica fino a 5 minuti — se il cliente non conferma entro quel lasso di tempo, il pagamento scade
* Controlla che non stai mescolando modalità di test e credenziali di produzione
* Verifica che la tua connessione a Internet sia stabile sia sul dispositivo POS che sul telefono del cliente

Errore credenziali non valide

* Controlla attentamente tutti e quattro i campi delle credenziali (MSN, Client ID, Client Secret, Subscription Key)
* Assicurati di utilizzare credenziali di test quando la modalità di test è abilitata e credenziali di produzione quando è disabilitata
* Verifica le tue credenziali nel [Vipps Portal](https://portal.vipps.no/)

'Invia a Telefono' apre una nuova scheda invece di inviare direttamente

Questo significa che il tuo account Vipps non ha ancora abilitato `PUSH_MESSAGE`. Il plugin sta utilizzando il fallback della pagina di atterraggio, che funziona ma aggiunge un passaggio extra. Per ottenere un'esperienza di push diretto più fluida, contatta Vipps e chiedi di abilitare PUSH\_MESSAGE sulla tua unità di vendita (MSN). Vedi [Abilitare il Push Diretto](#enabling-direct-push) sopra.

QR code non generato

* Conferma che il tuo sito stia funzionando su HTTPS — l'API Vipps rifiuta le richieste dai siti HTTP
* Controlla i log di WooCommerce (`WooCommerce > Status > Logs`) per dettagli sugli errori API
* Verifica che il tuo account commerciante sia attivo e abbia abilitato l'API ePayment

### Ottenere Aiuto[​](#getting-help "Collegamento diretto a Ottenere Aiuto")

Per supporto tecnico:

* Visita il [repository GitHub](https://github.com/wcpos/wcpos-vipps) per segnalare problemi
* Controlla la [documentazione per sviluppatori di Vipps](https://developer.vippsmobilepay.com/) per domande relative all'API
* Contatta il supporto di Vipps MobilePay per problemi relativi all'account e alle credenziali

## Screenshot[​](#screenshots "Collegamento diretto a Screenshot")

Gli screenshot saranno aggiunti in un futuro aggiornamento per mostrare:

* Configurazione del gateway nelle impostazioni di pagamento di WooCommerce
* Interfaccia di checkout POS con opzioni di codice QR e notifica push
* Flusso di conferma del pagamento