Salta al contenuto principale
Versione: 2.x

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.

Funzionalità Pro

PayArc Terminal richiede WCPOS Pro 2.0 o successivo.

Accettare un pagamento con carta​

Apri prima la cassa

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.

  1. Tocca il riquadro PayArc Terminal.
  2. 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.
  3. Per incassare con carta solo una parte del saldo, digita l'importo. Il resto rimane da saldare con un altro pagamento.
  4. Premi Invia … a PayArc Terminal. La cassa mostra Sul terminale con quattro fasi: Inviato, Sul terminale, Approvato e Acquisito.
  5. 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.

avviso

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​

avviso

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.

  1. Nel POS, apri il rimborso dell'ordine. Consulta Rimborsi.
  2. Scegli Rimborso su PayArc Terminal e premi Elabora rimborso.
  3. 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.

Account PayArc: Un account esercente con accesso a PayArc Connect V3
Hardware compatibile: Un terminale PAX supportato da PayArc e assegnato al tuo account
Connessioni: Solo con connessione Internet. Il negozio invia ogni pagamento a un terminale PAX tramite il numero di serie, quindi ogni cassa può utilizzarlo; ciascuna cassa sceglie il proprio terminale al momento del pagamento
WCPOS: WCPOS Pro 2.0 o successivo e versione 1.0 o successiva dell'estensione
Server: WooCommerce 7.0+, PHP 7.4+ e HTTPS per la modalità Live
Valuta: USD, CAD, GBP, EUR o JPY
Sei passaggi: installa, connetti, aggiungi il terminale, attivalo e scegli il terminale di ogni cassa
1

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

2

Inserisci le credenziali PayArc

  1. Vai a WP Admin > WooCommerce > Impostazioni > Pagamenti e apri PayArc Terminal
  2. Scegli Modalità: Live è l'opzione predefinita. Usa Test solo con le credenziali della dashboard di test di PayArc e l'app PayArc Connect Test. Non mescolare mai gli ambienti
  3. Inserisci Email di accesso a PayArc, l'indirizzo email che usi per accedere alla dashboard esercente di PayArc
  4. Inserisci MID PayArc dal profilo esercente di PayArc, non l'ID del terminale
  5. Inserisci ClientSecret PayArc dalla sezione API della dashboard e SecretKey PayArc / token bearer API dalla dashboard di PayArc
  6. Lascia vuoto Token bearer di callback, a meno che l'assistenza PayArc non te ne abbia fornito uno
3

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.

nota

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.

4

Aggiungi il terminale

  1. 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
  2. Scegli Tipo di pagamento e Stampa ricevuta
  3. Verifica che URL webhook sia un indirizzo HTTPS. Forniscilo a PayArc solo se richiesto
  4. 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.

5

Attivalo in WCPOS

  1. Vai a WP Admin > POS > Impostazioni > Pagamento
  2. Trova PayArc Terminal nell'elenco e attiva l'interruttore Abilitato
  3. Il riquadro appare alla cassa al successivo caricamento della pagina
nota

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.

6

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
ImpostazioneFunzione
TitoloIl nome del riquadro alla cassa; il valore predefinito è PayArc Terminal
DescrizioneLa 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 PayArcL'email di accesso alla dashboard esercente di PayArc; obbligatoria prima della connessione
MID PayArcIl MID dell'esercente dal profilo esercente di PayArc, non l'ID del terminale
ClientSecret PayArcIl segreto dalla sezione API della dashboard; memorizzato solo sul tuo server
SecretKey PayArc / token bearer APIIl token dalla dashboard di PayArc, usato per accedere e leggere il registro dei terminali
Token bearer di callbackFacoltativo. Compilalo solo se l'assistenza PayArc te ne ha fornito uno
Connessione PayArcPulsanti Connetti con queste credenziali, Aggiorna terminali e Disconnetti
Numero di serie del terminaleIl S/N PAX configurato da PayArc per il tuo account. Obbligatorio per i pagamenti
Tipo di pagamentoCREDIT (predefinito) o DEBIT
Stampa ricevutaStampa sul terminale: 0 - No receipt (predefinito), 1 - Merchant receipt, 2 - Customer receipt o 3 - Both receipts
URL webhookIndirizzo di callback di sola lettura. Verifica che sia HTTPS; forniscilo a PayArc solo se richiesto
Diagnostica PayArcInformazioni 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, sorgente payarc-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