Gateway di pagamento PayArc Terminal
PayArc Terminal invia una vendita dalla cassa a un terminale PayArc PAX. Il cliente paga sul terminale e la cassa registra il pagamento quando PayArc lo conferma.
Questa pagina parte dalle operazioni alla cassa. Per configurare il gateway di pagamento, vai a Configurare PayArc Terminal.
PayArc Terminal richiede WCPOS Pro 2.0 o successivo.
Accettare un pagamento con carta
Con Apri e chiudi la cassa attivato, la cassa non registra pagamenti mentre è chiusa e un pagamento con carta già incassato dovrebbe essere rimborsato. Per questa impostazione, consulta Casse.
Premi Cassa nel carrello. PayArc Terminal appare come riquadro nella scheda Pagamenti, accanto agli altri metodi di pagamento.
- Tocca il riquadro PayArc Terminal.
- Controlla il terminale indicato sopra il tastierino: Terminale: …. Se hai più terminali, premi Cambia e tocca quello al tuo banco. La cassa ricorda la scelta per la volta successiva.
- Per incassare con carta solo una parte del saldo, digita l'importo. Il resto rimane da saldare con un altro pagamento.
- Premi Invia … a PayArc Terminal. La cassa mostra Sul terminale con quattro fasi: Inviato, Sul terminale, Approvato e Acquisito.
- Il cliente paga sul terminale. Quando il pagamento viene acquisito e non resta nulla da pagare, si apre la ricevuta. Se rimane un importo da saldare, incassalo usando un altro riquadro.
Dettagli, sotto le fasi, apre un registro del pagamento: quando è stato inviato, quando è arrivato al terminale e l'importo approvato. Il pagamento conserva il circuito della carta, le ultime 4 cifre, il metodo di lettura della carta e il codice di autorizzazione di PayArc.
Il terminale non richiede mance. Per conoscere i terminali che le richiedono, consulta Mance.
Annullare un pagamento
Premi Annulla sul terminale prima che il cliente paghi. La cassa attende la conferma del terminale, poi mostra Pagamento annullato.
Se la lettura della carta è già in corso, PayArc potrebbe rifiutare l'annullamento e completare il pagamento; la cassa continua a verificare e mostra l'esito. Durante l'attesa, mostra Annullamento in corso — in attesa di conferma dal terminale e offre Sblocca questo pagamento. Lo sblocco consente di pagare l'ordine in un altro modo mentre il negozio continua a verificare lo stato del terminale.
Lo sblocco non annulla il pagamento: il terminale potrebbe ancora incassarlo. Controlla l'esito sul terminale prima di accettare un altro pagamento.
Se un pagamento non va a buon fine
Il terminale ha confermato un importo diverso? Non incassare di nuovo il pagamento. Controlla prima il terminale, l'ordine e la dashboard di PayArc.
Pagamento fallito: carta rifiutata
Premi Riprova per inviarlo di nuovo al terminale, oppure Scegli un altro metodo per pagare con un altro riquadro.
Pagamento fallito, con un messaggio di PayArc
PayArc ha rifiutato la vendita, ad esempio perché il terminale è spento o non è online. Controlla il terminale, poi premi Riprova.
Tempo scaduto — pagamento annullato
Nessuno ha pagato entro 5 minuti, oppure il terminale è rimasto in attesa di una carta che non è stata presentata. Controlla il terminale, poi premi Riprova.
Il riquadro PayArc Terminal è disattivato
La cassa indica il motivo sotto i riquadri. Consulta Quando un riquadro non è utilizzabile per tutti i possibili motivi.
- Nessun terminale configurato per PayArc Terminal — il negozio non ha terminali per questo gateway di pagamento. Un responsabile ne aggiunge uno al passaggio 4 di Configurare PayArc Terminal.
- In uso per l'ordine #… — il terminale è occupato con il pagamento di un altro ordine. Completa o annulla quel pagamento, oppure premi Cambia e scegli un altro terminale.
- Connessione necessaria — la cassa è offline. Un pagamento tramite terminale passa attraverso il negozio, quindi accetta un altro tipo di pagamento o attendi che la connessione sia ripristinata.
Connessione instabile, tentativi in corso
Questo messaggio appare nel registro Dettagli. La cassa continua a verificare. Lascia aperta la schermata: il pagamento prosegue sul terminale.
Un pagamento è bloccato o la cassa indica che il fornitore non ha risposto
Un pagamento rimane in attesa troppo a lungo
- Controlla lo schermo del terminale e lascia aperta la schermata di pagamento
- Dopo 5 minuti la cassa si ferma e mostra Tempo scaduto — pagamento annullato
- Controlla il terminale, le note dell'ordine e la dashboard di PayArc prima di incassare di nuovo il pagamento
Non è possibile leggere un precedente pagamento PayArc Terminal di questo ordine con le credenziali PayArc attuali
- Incassa il pagamento in un altro modo o chiedi a un responsabile. L'ordine contiene un pagamento precedente a una modifica della modalità o delle credenziali
- Il responsabile verifica quel pagamento nella dashboard di PayArc, nella modalità in cui è stato incassato
- Per usare di nuovo PayArc su questo ordine, il responsabile ripristina quella modalità in PayArc e fa clic su Connetti con queste credenziali, poi tu ricarichi la pagina
Rimborsare un pagamento PayArc
Il rimborso viene inviato al terminale che ha incassato la vendita, per l'intero importo o per una sua parte.
- Nel POS, apri il rimborso dell'ordine. Consulta Rimborsi.
- Scegli Rimborso su PayArc Terminal e premi Elabora rimborso.
- PayArc invia il rimborso al terminale, dove viene approvato o rifiutato. Il rimborso resta in attesa finché il terminale non risponde e l'esito viene aggiunto alle note dell'ordine.
Un rimborso in WP Admin, tramite il pulsante Rimborsa … tramite PayArc Terminal di WooCommerce, funziona allo stesso modo.
Se un rimborso rimane in attesa, controlla la dashboard di PayArc prima di rimborsare di nuovo.
Se PayArc non risponde a una richiesta di rimborso
Il negozio ripete la richiesta ogni 2 minuti, fino a 5 volte, con la stessa chiave di richiesta, in modo che PayArc tratti ogni nuovo tentativo come lo stesso rimborso. Se non riceve ancora risposta, invita il personale a controllare la dashboard di PayArc.
Pagamenti incassati con una versione precedente
Questo pagamento PayArc è stato incassato dal pannello order-pay del plugin. Il pagamento è stato incassato dalla versione 0.1 dell'estensione, precedente a WCPOS 2, quindi il gateway di pagamento non può rimborsarlo. Esegui il rimborso nella dashboard di PayArc o sul terminale, poi registralo in WooCommerce con Rimborsa … manualmente.
Configurare PayArc Terminal
Un responsabile configura il gateway di pagamento una sola volta in WP Admin, poi sceglie un terminale su ogni cassa.
Prima della configurazione: cosa serve
Requisiti
PayArc fornisce MID, ClientSecret e SecretKey, oltre al numero di serie di un terminale configurato per te.
Il negozio raggiunge ogni terminale tramite PayArc via Internet, quindi non occorre eseguire alcun abbinamento e qualsiasi cassa può usare tutti i tuoi terminali. Senza WCPOS Pro 2.0 o successivo, l'estensione mostra un avviso in WP Admin e non aggiunge nulla al POS.
Sei passaggi: installa, connetti, aggiungi il terminale, attivalo e scegli il terminale di ogni cassa
Installa PayArc Terminal for WooCommerce
Scarica payarc-terminal-for-woocommerce.zip, versione 1.0 o successiva, dalla pagina delle release su GitHub e caricalo da Plugin > Add Plugin, poi Carica plugin. Attiva il plugin.
WP Admin > POS > Impostazioni > Estensioni potrebbe ancora elencare la versione 0.1, sviluppata prima di WCPOS 2. Controlla la versione prima di installarla da lì.
Inserisci le credenziali PayArc
- Vai a
WP Admin > WooCommerce > Impostazioni > Pagamentie apri PayArc Terminal - Scegli Modalità:
Liveè l'opzione predefinita. UsaTestsolo con le credenziali della dashboard di test di PayArc e l'app PayArc Connect Test. Non mescolare mai gli ambienti - Inserisci Email di accesso a PayArc, l'indirizzo email che usi per accedere alla dashboard esercente di PayArc
- Inserisci MID PayArc dal profilo esercente di PayArc, non l'ID del terminale
- Inserisci ClientSecret PayArc dalla sezione API della dashboard e SecretKey PayArc / token bearer API dalla dashboard di PayArc
- Lascia vuoto Token bearer di callback, a meno che l'assistenza PayArc non te ne abbia fornito uno
Connetti
Fai clic su Connetti con queste credenziali. Se l'operazione riesce, la schermata mostra Connesso a PayArc e chiede di inserire o confermare il numero di serie del terminale e salvare. Se indica che le credenziali sembrano appartenere all'altro ambiente, cambia Modalità e connettiti di nuovo.
Dopo ogni modifica a Modalità o a una credenziale, fai di nuovo clic su Connetti con queste credenziali, poi salva. Una volta attivato PayArc Terminal in WCPOS (passaggio 5), il salvataggio mostra un errore finché non lo fai. Mentre un pagamento è in corso su un terminale, non puoi modificare la modalità, le credenziali o la connessione.
Aggiungi il terminale
- Inserisci il Numero di serie del terminale PAX riportato sull'etichetta S/N sul retro del dispositivo, come configurato da PayArc per il tuo account
- Scegli Tipo di pagamento e Stampa ricevuta
- Verifica che URL webhook sia un indirizzo HTTPS. Forniscilo a PayArc solo se richiesto
- Fai clic su Salva le modifiche
La cassa propone questo terminale e tutti quelli che il registro dei terminali di PayArc indica come abilitati per il tuo account. Connetti con queste credenziali recupera il registro e Aggiorna terminali lo recupera di nuovo. Un terminale che PayArc contrassegna come disabilitato viene escluso, anche se hai inserito proprio il suo numero di serie. Viene comunque proposto un numero di serie inserito che non compare nel registro. La modalità live richiede un sito HTTPS.
Attivalo in WCPOS
- Vai a
WP Admin > POS > Impostazioni > Pagamento - Trova PayArc Terminal nell'elenco e attiva l'interruttore Abilitato
- Il riquadro appare alla cassa al successivo caricamento della pagina
Questo è l'unico interruttore che conta. L'interruttore Abilitato nell'elenco Pagamenti di WooCommerce non ha alcun effetto e PayArc Terminal non viene mai proposto nella pagina di pagamento del negozio online. Consulta Impostazioni della cassa.
Scegli il terminale di ogni cassa
Su ogni cassa, apri Impostazioni > Lettori di carte. I terminali PayArc sono elencati sotto Lettori smart, uno per riga, tutti contrassegnati come Online: PayArc non indica se un terminale è acceso. Premi Usa questo lettore su quello del banco; la sua riga mostra Selezionato. Il cassiere può comunque premere Cambia al momento del pagamento.
Con un solo terminale PayArc non c'è nulla da scegliere: è già Selezionato su ogni cassa. Una riga con Impostato dal negozio indica che le casse sono vincolate al terminale predefinito del negozio. Consulta Scegliere un lettore smart.
Riferimento delle impostazioni
Tutte le opzioni nella pagina del gateway di pagamento in WP Admin > WooCommerce > Impostazioni > Pagamenti > PayArc Terminal.
Tutte le impostazioni di PayArc Terminal
| Impostazione | Funzione |
|---|---|
| Titolo | Il nome del riquadro alla cassa; il valore predefinito è PayArc Terminal |
| Descrizione | La descrizione del metodo di pagamento; il valore predefinito è Pay in person at a PayArc PAX terminal. |
| Modalità | Live (predefinita) o Test. Test richiede le credenziali della dashboard di test di PayArc e l'app PayArc Connect Test |
| Email di accesso a PayArc | L'email di accesso alla dashboard esercente di PayArc; obbligatoria prima della connessione |
| MID PayArc | Il MID dell'esercente dal profilo esercente di PayArc, non l'ID del terminale |
| ClientSecret PayArc | Il segreto dalla sezione API della dashboard; memorizzato solo sul tuo server |
| SecretKey PayArc / token bearer API | Il token dalla dashboard di PayArc, usato per accedere e leggere il registro dei terminali |
| Token bearer di callback | Facoltativo. Compilalo solo se l'assistenza PayArc te ne ha fornito uno |
| Connessione PayArc | Pulsanti Connetti con queste credenziali, Aggiorna terminali e Disconnetti |
| Numero di serie del terminale | Il S/N PAX configurato da PayArc per il tuo account. Obbligatorio per i pagamenti |
| Tipo di pagamento | CREDIT (predefinito) o DEBIT |
| Stampa ricevuta | Stampa sul terminale: 0 - No receipt (predefinito), 1 - Merchant receipt, 2 - Customer receipt o 3 - Both receipts |
| URL webhook | Indirizzo di callback di sola lettura. Verifica che sia HTTPS; forniscilo a PayArc solo se richiesto |
| Diagnostica PayArc | Informazioni sulla connessione e un pulsante Verifica impostazioni; i segreti non vengono mai mostrati |
I campi dei segreti salvati mostrano solo gli ultimi 4 caratteri. Lascia vuoto un campo segreto per mantenere il valore salvato.
La tabella Diagnostica PayArc mostra la modalità, gli endpoint PayArc, se l'email di accesso e il token di accesso Connect sono impostati, il MID, l'ID tenant e il numero di serie del terminale mascherati, il numero di terminali trovati, l'URL webhook, l'ora dell'ultimo callback e l'ultimo errore PayArc. Verifica impostazioni controlla le impostazioni salvate ed elenca ciò che manca.
Disconnetti cancella la connessione PayArc memorizzata, l'elenco dei terminali e il Numero di serie del terminale. Le credenziali vengono conservate, così puoi riconnetterti rapidamente. Controlla il numero di serie prima di salvare.
Log
Quando chiedi assistenza, invia il numero dell'ordine e le righe di log pertinenti.
Trovare i log per l'assistenza
Trovi i log in WooCommerce > Status > Log, sotto la sorgente payarc-terminal-for-woocommerce. Gli identificativi sono mascherati e i segreti vengono rimossi.
Non è disponibile un pacchetto di assistenza da scaricare. Non condividere MID completi, ID dei terminali, token o dati delle carte.
Ambito e limitazioni
- Nessuna mancia sul terminale
- Un terminale accetta un pagamento alla volta; mentre è occupato, le altre casse mostrano In uso per l'ordine #…
- Le valute supportate sono limitate a USD, CAD, GBP, EUR e JPY
- La connessione non indica se un terminale è acceso: una vendita inviata a un terminale offline fallisce immediatamente, senza che venga inviato nulla al terminale
- I pagamenti incassati dalla versione 0.1 dell'estensione si rimborsano in PayArc, non tramite il gateway di pagamento
- Il rimborso viene inviato al terminale che ha incassato la vendita
Se la configurazione non va a buon fine
Problemi comuni
Queste sembrano credenziali PayArc Test (o Live)
- La modalità selezionata e le credenziali appartengono ad ambienti PayArc diversi
- Cambia Modalità scegliendo quella indicata nel messaggio, oppure sostituisci le credenziali con quelle della modalità selezionata
- Fai di nuovo clic su Connetti con queste credenziali e salva
Impossibile connettersi a PayArc
- PayArc ha rifiutato l'accesso. Controlla le credenziali inserite e riprova
- Per i dettagli, controlla
WooCommerce > Status > Log, sorgentepayarc-terminal-for-woocommerce
L'URL di callback deve essere HTTPS prima di attivare la modalità Live
- La modalità Live richiede che il sito usi HTTPS, in modo che PayArc possa raggiungere URL webhook
- Passa il sito a HTTPS oppure usa la modalità Test su un sito di test
Il registro dei terminali è vuoto
- In questo caso la cassa propone solo il terminale indicato in Numero di serie del terminale e i pagamenti su quel terminale continuano a funzionare
- Chiedi a PayArc di confermare quel numero di serie per il tuo account e di elencare gli altri terminali se vuoi che la cassa li proponga
- Fai clic su Aggiorna terminali dopo che PayArc li ha aggiunti
PayArc ha rifiutato sia Connect AccessToken sia SecretKey
- PayArc ha negato al tuo account l'accesso alla propria API delle transazioni
- Chiedi all'assistenza PayArc di confermare che PayArc Connect V3 sia abilitato per il tuo account esercente e quale credenziale autorizzi le transazioni
Ottenere assistenza
- Includi il numero dell'ordine e le righe di log pertinenti nella richiesta di assistenza
- Visita il repository GitHub per segnalare problemi
- Contatta l'assistenza PayArc per l'account, PayArc Connect e la configurazione del terminale