Vipps MobilePay Gateway

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

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

1

Scarica e Installa

1. Visita la pagina delle release WCPOS Vipps MobilePay
2. Scarica il file wcpos-vipps.zip più recente
3. Nel tuo admin di WordPress, vai su Plugin > Aggiungi Nuovo > Carica Plugin
4. Carica il file zip e attiva il plugin

2

Configura le Credenziali Vipps

1. Naviga su WP Admin > WooCommerce > Impostazioni > Pagamenti
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:
   • Numero di Sequenza Commerciante (MSN)
   • Client ID
   • Client Secret
   • Subscription Key
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, 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 > Impostazioni > 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

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

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 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

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
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

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

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

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

Account Vipps: Account commerciante Vipps MobilePay attivo con credenziali API

Credenziali API: Numero di sequenza commerciante, 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

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

'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 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 > Stato > Log) per dettagli sugli errori API
• Verifica che il tuo account commerciante sia attivo e abbia abilitato l'API ePayment

Ottenere Aiuto

Per supporto tecnico:

• Visita il repository GitHub per segnalare problemi
• Controlla la documentazione per sviluppatori di Vipps per domande relative all'API
• Contatta il supporto di Vipps MobilePay per problemi relativi all'account e alle credenziali

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