Gateway PayArc Terminal
Il gateway PayArc Terminal consente di accettare pagamenti di persona su un terminale PayArc PAX da WCPOS tramite PayArc Connect. Il pagamento viene avviato da WooCommerce e completato sul terminale; l'ordine viene contrassegnato come pagato solo dopo la conferma di PayArc.
Funzionalità
Integrazione con terminali PAX
Invia i pagamenti al tuo terminale PayArc PAX tramite PayArc Connect nel cloud, senza abbinamento locale
Completamento verificato
Prima del completamento, importo e valuta devono corrispondere all'ordine; il circuito della carta, la modalità di inserimento e le ultime 4 cifre vengono salvati nell'ordine
Motivi di rifiuto chiari
I motivi del rifiuto vengono mostrati al cassiere e aggiunti come nota all'ordine
Ricevute del terminale
Stampa sul terminale la ricevuta dell'esercente, quella del cliente o entrambe
Diagnostica integrata
Verifica la connessione con il pulsante Validate Settings e una tabella diagnostica con identificatori mascherati
Come funziona
WordPress chiama PayArc Connect e PayArc raggiunge il terminale PAX. WCPOS comunica solo con il tuo sito. Ogni pagamento addebita l'importo totale dell'ordine.
La pagina di pagamento controlla il risultato ogni 1.5 secondi e si arresta dopo 5 minuti. Le callback di PayArc all'Webhook URL accelerano il risultato; i pagamenti vengono comunque completati tramite polling anche senza callback. Lascia aperta la pagina di pagamento mentre il cliente paga sul terminale.
Configurazione
Installa PayArc Terminal for WooCommerce
Installa da WP Admin > POS > Impostazioni > Estensioni oppure scarica il file payarc-terminal-for-woocommerce.zip dalla pagina delle release di GitHub e caricalo tramite Plugin > Aggiungi Nuovo > Carica plugin. Attiva il plugin.
Inserisci le credenziali PayArc
- Vai a
WP Admin > WooCommerce > Impostazioni > Pagamentie apri PayArc Terminal - Scegli Mode:
Liveè l'impostazione predefinita. UsaTestsolo con le credenziali della dashboard di test PayArc e l'app PayArc Connect Test. Non mescolare mai gli ambienti - Inserisci PayArc login email, l'indirizzo email usato per accedere alla dashboard esercenti PayArc
- Inserisci PayArc MID dal profilo esercente PayArc, non l'ID del terminale
- Inserisci PayArc ClientSecret dalla sezione API della dashboard e PayArc SecretKey / API bearer token dalla dashboard PayArc
- Lascia vuoto Callback bearer token, a meno che non te ne abbia fornito uno il supporto PayArc; è facoltativo
Connetti
Fai clic su Connect using these credentials. In caso di esito positivo, la schermata ti chiede di inserire o confermare il numero di serie del terminale e salvare le impostazioni. Se indica che le credenziali sembrano appartenere all'altro ambiente, cambia Mode e connettiti di nuovo.
Dopo ogni modifica alla modalità o alle credenziali, fai nuovamente clic su Connect using these credentials e salva. I pagamenti sono bloccati finché la modalità e le credenziali non corrispondono alla connessione salvata. Se esegui l'aggiornamento da una versione precedente alla 0.1.14, premi Connect una volta.
Aggiungi il terminale
- Inserisci il Terminal serial number PAX riportato sull'etichetta S/N sul retro del dispositivo, come configurato da PayArc per il tuo account
- Scegli Tender type e Print receipt
- Verifica che Webhook URL usi HTTPS. Forniscilo a PayArc solo se te lo chiede
- Fai clic su Save changes
La modalità Live richiede un sito HTTPS.
Abilita in WCPOS
- Vai a
WP Admin > POS > Impostazioni > Pagamento - Trova il gateway PayArc Terminal e abilitalo per WCPOS
- Salva le impostazioni
La casella Enable/Disable nella schermata delle impostazioni di WooCommerce controlla solo il pagamento nel negozio online. WCPOS usa questo gateway una volta configurato, indipendentemente dal fatto che la casella sia selezionata.
La maggior parte dei negozi lascia questa opzione deselezionata.
Riferimento delle impostazioni
| Impostazione | Funzione |
|---|---|
| Enable/Disable | Abilita PayArc Terminal per il pagamento nel negozio online. Disattivato per impostazione predefinita; l'abilitazione per WCPOS si gestisce in POS > Impostazioni > Pagamento |
| Title | L'etichetta di pagamento; il valore predefinito è PayArc Terminal |
| Description | La descrizione del pagamento; il valore predefinito è Pay in person at a PayArc PAX terminal. |
| Mode | Live (predefinito) o Test. Test richiede le credenziali della dashboard di test PayArc e l'app PayArc Connect Test |
| PayArc login email | L'indirizzo email usato per accedere alla dashboard esercenti PayArc; obbligatorio prima di connettersi |
| PayArc MID | Il MID esercente del profilo esercente PayArc, non l'ID del terminale |
| PayArc ClientSecret | Il segreto dalla sezione API della dashboard; viene memorizzato solo sul tuo server |
| PayArc SecretKey / API bearer token | Il token dalla dashboard PayArc, usato per accedere e recuperare il registro dei terminali |
| Callback bearer token | Facoltativo. Inseriscilo solo se te ne ha fornito uno il supporto PayArc |
| PayArc connection | Pulsanti Connect using these credentials, Refresh Terminals e Disconnect |
| Terminal serial number | Il numero S/N PAX assegnato al tuo account, necessario per i pagamenti. Se viene trovato nel registro, è compilato automaticamente; inseriscilo o confermalo prima di salvare |
| Tender type | CREDIT (predefinito) o DEBIT |
| Print receipt | 0 — nessuna (predefinito), 1 — esercente, 2 — cliente, 3 — entrambe |
| Webhook URL | Indirizzo di callback di sola lettura. Verifica che usi HTTPS; forniscilo a PayArc solo se te lo chiede |
| PayArc diagnostics | Informazioni sulla connessione e pulsante Validate Settings; 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 PayArc diagnostics mostra la modalità, gli endpoint, MID / ID tenant / numero di serie mascherati, se il token di accesso Connect è configurato, il Webhook URL, l'ultima callback e l'ultimo errore PayArc. Usa Validate Settings per verificare le impostazioni.
Utilizzo
Elaborazione dei pagamenti
- Select Gateway: scegli PayArc Terminal come metodo di pagamento in WCPOS
- Start Payment: fai clic su Start Payment per inviare il totale dell'ordine al terminale
- Customer Payment: lascia aperta la pagina mentre il cliente completa il pagamento sul terminale PAX. Segui i messaggi di stato:
Starting terminal payment...→Payment sent to terminal.→Waiting for the terminal result...→Payment approved. Completing the order... - Automatic Completion: quando PayArc conferma il pagamento, l'ordine viene completato automaticamente
Controlli dei pagamenti
- Cancel Payment appare una volta avviato un pagamento. Se PayArc non ha ancora restituito un ID di tracciamento, attendi qualche istante prima di annullare
- Dopo un rifiuto, un annullamento o un timeout, puoi riprovare. In caso di timeout, controlla il terminale prima di riprovare il pagamento
- Il registro delle attività di pagamento è compresso per impostazione predefinita. Usa Show activity per visualizzarlo e Clear per cancellare le attività mostrate
Ricevute
L'impostazione Print receipt controlla la stampa sul terminale: nessuna, esercente, cliente o entrambe.
Rimborsi
Il plugin non supporta i rimborsi. Esegui il rimborso tramite PayArc, quindi registralo manualmente in WooCommerce.
Registri
Trovi i registri in WooCommerce > Status > Log, nella sorgente payarc-terminal-for-woocommerce. I registri includono tentativi di connessione, vendite avviate o non riuscite, annullamenti e callback accettate o rifiutate. Gli identificatori sono mascherati e i segreti oscurati.
Non è possibile scaricare un pacchetto di assistenza. Quando chiedi aiuto, invia il numero dell'ordine e le righe di registro pertinenti. Non condividere MID completi, ID dei terminali, token o dati della carta.
Requisiti
Ambito e limitazioni
- Il plugin non supporta i rimborsi
- I pagamenti addebitano l'importo totale dell'ordine; i pagamenti parziali o suddivisi non sono supportati
- Le mance non sono supportate
- Un terminale per negozio: una sola impostazione per il numero di serie, senza selettore del cassiere
- Le valute sono limitate a USD, CAD, GBP, EUR e JPY
- I pagamenti sono bloccati finché la modalità e le credenziali non corrispondono alla connessione salvata
Risoluzione dei problemi
Problemi comuni
Le credenziali sembrano appartenere all'altro ambiente
- La modalità selezionata e le credenziali provengono da ambienti diversi
- Imposta Mode in base alle credenziali oppure sostituisci le credenziali con quelle dell'ambiente selezionato
- Fai nuovamente clic su Connect using these credentials e salva
Impossibile connettersi a PayArc
- PayArc ha rifiutato le credenziali di accesso. Controlla le credenziali inserite e riprova
- Per i dettagli, controlla
WooCommerce > Status > Log, sorgentepayarc-terminal-for-woocommerce
Impossibile elaborare la richiesta di pagamento. (HTTP 500)
- Questo messaggio mostrato al cassiere è generico. Cerca PayArc payment action failed nel registro WooCommerce per conoscere la causa effettiva
- Dopo una modifica alla modalità o alle credenziali, fai nuovamente clic su Connect using these credentials e salva
- Verifica che Terminal serial number sia compilato
- Se il registro indica che PayArc ha rifiutato sia il token di accesso Connect sia SecretKey, chiedi al supporto PayArc di confermare che PayArc Connect V3 sia abilitato per il tuo account esercente
- Verifica che la valuta del negozio sia USD, CAD, GBP, EUR o JPY
Accesso negato. (HTTP 403) durante Start Payment
- Aggiorna alla versione 0.1.12 o successiva, che corregge questo errore nelle sessioni WCPOS
Il registro dei terminali è vuoto
- È normale che il registro sia vuoto o che un terminale sia mostrato senza un identificatore WCPOS
- I dati del registro sono solo informativi. Per i pagamenti viene usato il Terminal serial number
Un pagamento impiega troppo tempo
- Controlla lo schermo del terminale e lascia aperta la pagina di pagamento
- Controlla le note dell'ordine e la dashboard PayArc prima di riprovare
- La pagina controlla ogni 1.5 secondi e si arresta dopo 5 minuti
Richiedere assistenza
- Includi il numero dell'ordine e le righe di registro pertinenti nella richiesta di assistenza
- Visita il repository GitHub per segnalare i problemi
- Contatta il supporto PayArc per assistenza su account, PayArc Connect e configurazione del terminale