VibeFox Comgate for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Il plugin non si attiva senza di esso.

PHP: 8.0 o successivo.

HTTPS: il tuo sito deve essere raggiungibile tramite HTTPS da internet, così che Comgate possa inviare la notifica in background.

Valuta: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK o SEK. Per le altre valute e per i totali inferiori al minimo Comgate il metodo di pagamento viene nascosto. I pagamenti in HUF vengono arrotondati a fiorini interi, come richiede Comgate.

Account Comgate: ti servono il Merchant ID e il secret (password per la comunicazione in background) della connessione del tuo negozio nel portale clienti Comgate, e l'URL di notifica impostato lì (vedi Configurazione). Comgate usa lo stesso Merchant ID e secret per i pagamenti di test e live.

Chiave di licenza VibeFox: acquistata su vibefox.net. Una chiave funziona su un solo dominio.

Installazione

1. In WordPress vai su Plugins > Add New > Upload Plugin, scegli il file ZIP del plugin e fai clic su Install Now. Puoi anche caricare la cartella wcp_comgate_gateway in /wp-content/plugins/ via FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > Comgate > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina Plugin.

4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in cima alla pagina e fai clic su Activate.

5. Inserisci Merchant ID e Secret dal portale clienti Comgate e imposta l'URL di notifica lì (vedi Configurazione).

6. Attiva Enable / Disable. Lascia attivo Test Mode per un pagamento di prova, poi disattivalo.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Comgate. Sopra i campi la pagina ti avvisa quando Comgate è attivo ma mancano Merchant ID o secret (il metodo di pagamento viene allora nascosto al checkout finché entrambi non sono compilati) e quando la valuta del negozio non è supportata. Finché la modalità test è attiva mostra Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

Generali

Enable / Disable: Enable Comgate Payment Gateway attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che i clienti vedono al checkout. Predefinito: Comgate.

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely via Comgate — cards, bank transfers, wallets and more. In modalità test viene aggiunto TEST MODE: no real money is charged., oppure viene mostrato da solo se la descrizione è vuota.

Connessione Comgate

Prendi l'identificativo del negozio (Merchant ID) e la password (secret) dal portale clienti Comgate, Integration > shop connection settings. Nello stesso punto imposta l'URL for passing the payment result (notifica in background) sull'URL mostrato in questa sezione. Ha una forma come https://your-site/wc-api/comgate_payment_callback/. Comgate lo richiama dopo ogni pagamento; il plugin poi verifica di nuovo il pagamento con l'API di stato Comgate prima di modificare l'ordine. Gli URL di ritorno per il cliente vengono inviati con ogni pagamento. Se il portale chiede anche gli URL di ritorno (pagato, annullato, in attesa), usa il secondo URL mostrato in questa sezione, che ha una forma come https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: l'identificativo del negozio Comgate (merchant).

Secret: la password per la comunicazione in background (secret) di questa connessione del negozio.

Test Mode: Create test payments (no money is charged). Comgate usa lo stesso Merchant ID e secret per i pagamenti di test e live; i pagamenti di test sono contrassegnati con test=true. I rimborsi vengono sempre inviati nella modalità del pagamento originale. Predefinito: attivato.

Pagina di pagamento

Payment Methods: da quali metodi di pagamento Comgate il cliente può scegliere. Vengono mostrati solo i metodi attivi per il tuo negozio in Comgate.

Language: la lingua della pagina di pagamento Comgate. Automatic (site language, English as fallback) (predefinita) oppure una delle 26 lingue.

Ordini

Order Status After Payment: lo stato impostato quando Comgate conferma il pagamento. Lo stato viene impostato subito, senza un secondo cambio di stato.

Avanzate

Debug Log: Log API requests and notifications scrive in WooCommerce > Status > Logs, origine wcp_comgate_gateway. Il secret e i dati personali non vengono mai registrati. Gli errori vengono sempre registrati. Predefinito: disattivato.

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Ordini e i loro ID transazione Comgate vengono sempre conservati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita Comgate) e fa l'ordine. Il plugin crea il pagamento in Comgate per il totale dell'ordine nella valuta dell'ordine e reindirizza il cliente alla pagina di pagamento Comgate. L'e-mail e il nome di fatturazione vengono passati a Comgate, e il pagamento viene etichettato con il numero dell'ordine. È obbligatorio un indirizzo e-mail di fatturazione valido. Sulla pagina Comgate il cliente paga con uno dei metodi che hai consentito.

Dopo il pagamento, il cliente torna nel tuo negozio. L'ordine viene segnato come pagato solo dopo la conferma di Comgate: il plugin legge il pagamento dall'API di stato Comgate, sia quando arriva la notifica in background sia quando il cliente torna. Se il pagamento non è ancora confermato, per esempio un bonifico in viaggio, la pagina Ordine ricevuto mostra Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Se l'ordine è stato messo in sospeso, la pagina mostra Your payment is being reviewed. We will contact you if anything else is needed.

Se il pagamento viene annullato o scade, il cliente torna al checkout (o al carrello) con The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Un cliente può pagare di nuovo un ordine non pagato, per esempio dalla pagina Pay for order. Il tentativo precedente viene verificato per primo, quindi un pagamento già andato a buon fine non viene addebitato due volte, e viene annullato in Comgate se è ancora aperto. Un pagamento tardivo di un tentativo più vecchio paga comunque un ordine non pagato.

Se Comgate non riesce ad avviare il pagamento, il cliente vede un messaggio breve, per esempio The Comgate payment could not be started. Please try again or choose another payment method., che Comgate non può accettare questo importo o questa valuta, oppure che il metodo di pagamento Comgate scelto non è disponibile. Il motivo tecnico viene scritto nel registro.

Il metodo di pagamento funziona nel checkout classico, nel blocco Checkout e nella pagina Pay for order. È compatibile con WooCommerce High-Performance Order Storage (HPOS).

Il plugin accetta pagamenti una tantum solo sulla pagina Comgate. Non prevede pagamenti ricorrenti, abbonamenti o carte salvate, checkout Comgate integrato, pulsanti Apple Pay o Google Pay sul tuo sito (sono disponibili sulla pagina Comgate), né cattura o annullamento di pre-autorizzazioni da WooCommerce. Senza la notifica, lo stato del pagamento non viene interrogato automaticamente: viene verificato solo quando il cliente torna.

Ordini e rimborsi

Stati dell'ordine

Pending payment: il cliente è stato inviato a Comgate e non ha ancora pagato, oppure Comgate segnala il pagamento come in attesa. La nota dell'ordine mostra il pagamento Comgate creato.

Processing or Completed: Comgate ha segnalato il pagamento come PAID con lo stesso importo e la stessa valuta. Lo stato segue Order Status After Payment. L'ID transazione dell'ordine è l'ID transazione Comgate; tutti i tentativi vengono conservati con l'ordine. I pagamenti di prova ricevono la nota Comgate test payment — no money was charged.

On hold: l'importo o la valuta pagati differiscono dall'ordine, un pagamento di prova è stato confermato mentre il negozio è in modalità live (non è stato ricevuto denaro), oppure il pagamento è solo autorizzato (pre-autorizzazione sul tuo account Comgate). Un pagamento autorizzato diventa pagato automaticamente quando lo acquisisci nel portale Comgate. La nota dell'ordine spiega il motivo.

Cancelled: il pagamento Comgate corrente è stato annullato o è scaduto. Se Comgate conferma il pagamento dopo che WooCommerce ha annullato l'ordine non pagato (per esempio un bonifico lento), l'ordine viene riaperto come pagato con una nota per controllare le scorte prima della spedizione.

Se Comgate segnala un altro pagamento PAID per un ordine già pagato, l'ordine non viene modificato di nuovo. Una nota ti chiede di verificarlo nel portale Comgate e rimborsare il duplicato. Una conferma riprodotta non riapre mai un ordine rimborsato o un ordine annullato dopo il pagamento.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via Comgate (il pulsante mostra il titolo del metodo di pagamento). Sono supportati rimborsi totali e parziali. Il rimborso va alla transazione Comgate pagata ed è inviato nella modalità (test o live) del pagamento originale. Comgate rimborsa solo pagamenti PAID e al massimo l'importo pagato; i rimborsi in HUF devono essere in fiorini interi. Se Comgate non accetta il rimborso, WooCommerce mostra l'errore e nessun rimborso viene registrato. Un rimborso riuscito viene aggiunto alle note dell'ordine con importo, transazione Comgate e motivo.

I rimborsi effettuati nel portale Comgate non vengono comunicati al negozio. Se necessario, crea un rimborso manuale in WooCommerce senza usare Refund via il gateway.

Chiave di licenza

Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in cima a WooCommerce > Settings > Payments > Comgate. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino alla quale la licenza è attiva e il tuo dominio. Usa Check now per verificare di nuovo lo stato, Change key per inserire un'altra chiave e Remove key per rimuoverla da questo sito. Il link Manage licenses and domains in your account apre il tuo account vibefox.net.

Una chiave funziona su un solo dominio. Rimuovere la chiave da un sito non libera il posto del dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Comgate non viene mostrato ai clienti al checkout. Se un pagamento viene avviato comunque, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio che hanno effettuato l'accesso vedono ancora il metodo di pagamento, contrassegnato da (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugin e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati e i rimborsi funzionano.

Quando una licenza scade, il plugin continua a funzionare, ma aggiornamenti e supporto richiedono un rinnovo. Lo stato viene ricontrollato automaticamente in background.

Risoluzione dei problemi

Comgate non appare al checkout: verifica che la licenza sia attiva, che Enable / Disable sia attivo, che Merchant ID e Secret siano compilati, che la valuta dell'ordine sia supportata e che il totale dell'ordine non sia sotto il minimo Comgate (per esempio 1 CZK, 0,10 EUR o 100 HUF). La pagina delle impostazioni mostra un avviso quando mancano le credenziali o la valuta non è supportata.

Il pagamento è andato a buon fine, ma l'ordine resta Pending payment: Comgate non ha consegnato la notifica in background. Controlla l'URL for passing the payment result nel portale Comgate, che il tuo sito sia raggiungibile tramite HTTPS da internet (senza modalità manutenzione o protezione con password) e il registro (attiva il Debug Log). Comgate ripete le notifiche non consegnate; il plugin risponde con un errore ogni volta che non ne ha elaborata una, quindi verrà riprovata. L'ordine viene confermato anche quando il cliente torna nel negozio.

La notifica risponde Invalid merchant or secret: il Merchant ID o il secret nelle impostazioni non corrispondono alla connessione del negozio nel portale Comgate.

La notifica risponde Gateway not configured: Merchant ID o secret sono vuoti nelle impostazioni. Comgate riprova quando vengono compilati.

La notifica risponde Order not found, Unknown transaction o Reference mismatch: la notifica riguarda un pagamento non creato da questo negozio per quell'ordine. L'ordine non viene modificato.

La notifica risponde Status verification failed, Status verification rejected o Busy, retry later: l'API di stato Comgate non è raggiungibile, ha rifiutato la richiesta, oppure l'ordine era in elaborazione da un'altra richiesta nello stesso momento. Comgate ripete la notifica.

Il cliente vede We could not verify the Comgate payment: il link di ritorno non corrispondeva all'ordine. Se il denaro è stato addebitato, la notifica conferma comunque l'ordine. Verifica il pagamento nel portale Comgate prima che il cliente paghi di nuovo.

Il cliente vede The order total is below the minimum amount accepted by Comgate oppure A valid billing e-mail address is required for Comgate payments: l'ordine non può essere pagato con Comgate così com'è.

L'ordine è On hold dopo il pagamento: leggi la nota dell'ordine. L'importo o la valuta erano diversi, un pagamento di prova è arrivato in modalità live, oppure il pagamento è solo autorizzato. Verifica il pagamento nel portale Comgate e completa o rimborsa l'ordine manualmente.

Il rimborso non riesce: leggi il messaggio. Comgate rejected the refund: the amount exceeds the refundable amount. significa che l'importo è superiore a quanto resta da rimborsare; un pagamento in uno stato diverso da PAID non può essere rimborsato. Comgate could not be reached. The refund was not made — please try again later. significa un problema di connessione.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera un posto nel tuo account vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave per il nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.

Disinstallazione

Disattivare il plugin mantiene tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato della licenza di questo plugin vengono sempre rimossi. Impostazioni del gateway e file di registro vengono rimossi solo se Delete Data on Uninstall era attivo. Altrimenti restano per una successiva reinstallazione. Ordini e relativi dati Comgate vengono sempre conservati. Gli ordini esistenti mantengono le note di pagamento e gli ID transazione.

Comgate è un marchio del rispettivo titolare. Questo plugin non è affiliato né approvato da Comgate.