VibeFox Montonio for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 7.0 o successivo, installato e attivo. Senza WooCommerce il plugin non si attiva.

PHP: 8.0 o successivo.

Valuta: la valuta del negozio o dell'ordine deve essere EUR o PLN. Per qualsiasi altra valuta il metodo di pagamento viene nascosto al checkout.

Account Montonio: ti servono la chiave di accesso e la chiave segreta del tuo negozio, che trovi nel Montonio Partner System. Le chiavi sandbox e live sono diverse, quindi serve una coppia per ogni ambiente che usi. Non c'è altro da configurare in Montonio: l'indirizzo di notifica viene inviato con ogni pagamento.

Sito pubblico: il tuo sito deve essere raggiungibile da internet per ricevere le notifiche di Montonio. Altrimenti gli ordini vengono comunque confermati quando il cliente torna al negozio.

Chiave di licenza VibeFox: si acquista su vibefox.net. Una chiave funziona su un dominio.

Installazione

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

2. Fai clic su Activate.

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

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

5. Nel Montonio Partner System apri Stores > your store > API keys e copia la chiave di accesso e la chiave segreta sandbox. Incollale nelle impostazioni e lascia attivo Sandbox mode.

6. Attiva Enable/Disable e prova un pagamento in sandbox. Poi inserisci le chiavi live e deseleziona Sandbox mode.

Configurazione

Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > Montonio. Sopra i campi la pagina ti avvisa quando mancano le chiavi dell'ambiente corrente (il metodo di pagamento viene allora nascosto al checkout) e quando la valuta del negozio non è EUR o PLN, e mostra Sandbox mode is on: payments are simulated and no real money is charged. finché la sandbox è attiva. Nell'elenco dei metodi di pagamento Montonio risulta da configurare finché non sono impostate entrambe le chiavi dell'ambiente corrente.

Generali

Enable/Disable: Enable Montonio bank payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento che il cliente vede al checkout. Predefinito: Bank payment (Montonio).

Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay directly from your bank account. You will be redirected to Montonio to choose your bank.

Chiavi API

Le chiavi si ottengono nel Montonio Partner System, in Stores > your store > API keys. Le chiavi sandbox e live sono diverse. La sandbox usa solo le chiavi sandbox, la modalità live usa solo le chiavi live. Questa sezione delle impostazioni mostra anche l'indirizzo di notifica. Ha questo aspetto: https://your-site/wc-api/wc_mnt_payment/. Non devi inserirlo da nessuna parte: il plugin lo invia a Montonio con ogni pagamento.

Sandbox mode: Use the Montonio sandbox (test payments, no real money). Cambia sia l'indirizzo API di Montonio sia la coppia di chiavi. Predefinito: attivo. Disattivalo solo dopo aver inserito le chiavi live.

Sandbox access key: la chiave di accesso (UUID) del tuo negozio nella sandbox di Montonio.

Sandbox secret key: la chiave segreta del tuo negozio nella sandbox di Montonio.

Live access key: la chiave di accesso (UUID) del tuo negozio nell'ambiente live di Montonio.

Live secret key: la chiave segreta del tuo negozio nell'ambiente live di Montonio.

Avanzate

Debug log: Log payment events scrive tutti gli eventi di pagamento in WooCommerce > Status > Logs, origine wcp_montonio_payment. Gli errori vengono sempre registrati, anche con questa opzione disattivata. Chiavi, token e dati dei clienti non vengono mai registrati. Predefinito: disattivato.

Delete data: Delete the gateway settings and logs when the plugin is deleted. Disattivare il plugin non cancella mai nulla. I dati degli ordini (UUID Montonio, note) vengono sempre conservati. Predefinito: disattivato.

Notifiche di pagamento

Montonio comunica al tuo negozio ogni pagamento con un token firmato. Il token arriva in due modi: con una notifica server-to-server all'indirizzo di notifica e con il cliente quando torna al negozio. Vengono verificati entrambi: la firma con la tua chiave segreta, la data di scadenza, la tua chiave di accesso e che il pagamento sia stato creato dal tuo negozio per quell'ordine nello stesso ambiente. I token che non superano la verifica vengono rifiutati. Ogni stato viene applicato una sola volta, quindi le notifiche ripetute non aggiungono note, e-mail o variazioni di scorte.

Checkout

Il cliente sceglie il metodo di pagamento (per default Bank payment (Montonio)) e invia l'ordine. Il plugin crea un pagamento Montonio per il totale dell'ordine nella valuta dell'ordine e invia il cliente alla pagina di pagamento di Montonio. Lì il cliente sceglie una banca e paga. Le banche del paese di fatturazione del cliente vengono mostrate per prime (Polonia per gli ordini in PLN). Il pagamento compare come Order con il numero dell'ordine. La pagina di Montonio si apre nella lingua del negozio quando è tedesco, inglese, estone, finlandese, lituano, lettone, polacco o russo, altrimenti in inglese. In modalità sandbox il checkout mostra SANDBOX MODE — test payment, no real money is charged. sotto la descrizione.

L'ordine viene segnato come pagato solo dopo che Montonio lo conferma con stato PAID e con l'importo e la valuta esatti dell'ordine. Dopo il pagamento il cliente torna alla pagina di conferma dell'ordine del tuo negozio. Finché Montonio non ha ancora confermato il pagamento, quella pagina mostra Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. Se il pagamento è stato annullato o rifiutato, il cliente torna alla pagina Pay for order e vede uno di questi messaggi: The payment was cancelled or rejected by the bank. You can try again or choose another payment method., The payment was not completed. You can try again or choose another payment method. o Montonio could not complete the payment. Please try again or choose another payment method.

Un cliente può pagare di nuovo un ordine non pagato dalla pagina Pay for order. Prima di creare un nuovo pagamento, il plugin chiede a Montonio com'è andato il precedente. Se risulta già pagato, l'ordine viene confermato e non viene creato un secondo pagamento.

Se Montonio non riesce ad avviare il pagamento, il cliente vede un messaggio breve, per esempio Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method., e può scegliere un altro metodo di pagamento. L'errore di Montonio viene aggiunto alle note dell'ordine e al 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 solo pagamenti bancari (avvio del pagamento). Non prevede pagamenti con carta, BLIK, Apple Pay o Google Pay, Pay Later o finanziamenti, spedizioni Montonio, abbonamenti, metodi di pagamento salvati né la scelta della banca sul tuo sito.

Ordini e rimborsi

Stati dell'ordine

In attesa di pagamento: il cliente è stato inviato a Montonio e non ha ancora pagato. Viene aggiunta una nota quando Montonio segnala il pagamento come in sospeso.

In lavorazione o Completato: Montonio ha confermato il pagamento (PAID). L'ordine segue lo stato standard di WooCommerce per gli ordini pagati. La nota dell'ordine mostra la banca, l'UUID del pagamento Montonio, l'importo e l'ambiente. L'ID della transazione è l'UUID del pagamento Montonio.

In attesa: la banca non ha ancora confermato il pagamento (AUTHORIZED); l'ordine diventa pagato quando Montonio segnala PAID. Un ordine viene messo In attesa anche quando Montonio ha comunicato un importo o una valuta diversi dal totale dell'ordine, quando un pagamento in sandbox arriva mentre il negozio è in modalità live, o quando il pagamento arriva dopo che l'ordine è stato annullato. La nota dell'ordine lo spiega. Controlla il pagamento nel Montonio Partner System, poi evadi l'ordine o rimborsa il pagamento.

Non riuscito: il cliente non ha completato il pagamento oppure la banca lo ha rifiutato. Solo l'ultimo pagamento di un ordine non pagato può far fallire l'ordine. Il cliente può riprovare dalla pagina Pay for order.

Gli ordini pagati, annullati o rimborsati non vengono mai riaperti dalle notifiche successive. Se arriva un secondo pagamento per un ordine già pagato, l'ordine non cambia. Una nota ti chiede di rimborsare il secondo pagamento nel Montonio Partner System.

Rimborsi

Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via Bank payment (Montonio) (il pulsante usa il titolo del metodo di pagamento). Sono supportati rimborsi totali e parziali per gli ordini pagati tramite Montonio. Il rimborso viene inviato all'ambiente in cui è avvenuto il pagamento (sandbox o live), quindi le chiavi di quell'ambiente devono essere impostate. Se Montonio non accetta il rimborso, WooCommerce mostra l'errore e nessun rimborso viene registrato. Un rimborso inviato viene aggiunto alle note dell'ordine con il suo stato e l'ID di rimborso Montonio.

Montonio conferma o rifiuta ogni rimborso più tardi con una notifica. Una conferma viene aggiunta alle note dell'ordine. Se Montonio rifiuta il rimborso, la nota indica che il denaro non è stato restituito al cliente; verifica nel Montonio Partner System e correggi il rimborso in WooCommerce.

I rimborsi effettuati nel Montonio Partner System vengono aggiunti alle note dell'ordine quando Montonio li comunica. Non vengono registrati automaticamente come rimborsi di WooCommerce. Se necessario, crea un rimborso manuale in WooCommerce.

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 > Montonio. 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 dominio. Rimuovere la chiave da un sito non libera lo slot del dominio. Liberalo nel tuo account vibefox.net.

Senza una chiave attiva, Montonio 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 come (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria compare nella pagina Plugins 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 il rinnovo. Lo stato viene verificato di nuovo automaticamente in background.

Risoluzione dei problemi

Montonio non compare al checkout: verifica che la licenza sia attiva, che Enable/Disable sia attivo, che siano impostate entrambe le chiavi dell'ambiente corrente (Sandbox access key e Sandbox secret key in modalità sandbox, Live access key e Live secret key in modalità live) e che la valuta del negozio o dell'ordine sia EUR o PLN. La pagina delle impostazioni mostra un avviso quando mancano chiavi o la valuta non è supportata.

Il pagamento è andato a buon fine, ma l'ordine resta In attesa di pagamento: la notifica non è arrivata al tuo negozio. Verifica che il sito sia raggiungibile da internet e che le chiavi nelle impostazioni appartengano all'ambiente del pagamento. L'ordine viene confermato anche quando il cliente torna al negozio dopo aver pagato, e quando tenta di pagare di nuovo lo stesso ordine.

La notifica risponde Invalid token: la firma del token, la scadenza o la chiave di accesso non corrispondevano. Verifica che chiave di accesso e chiave segreta siano copiate correttamente e appartengano all'ambiente giusto, e che l'orologio del server sia corretto.

La notifica risponde Payment does not belong to this order oppure Wrong environment: il pagamento non è stato creato da questo negozio per questo ordine, oppure è stato creato nell'altro ambiente (sandbox o live). Succede quando due negozi usano lo stesso account Montonio e gli stessi numeri d'ordine.

La notifica risponde Gateway not configured: non sono state impostate chiavi Montonio. Inserisci le chiavi; Montonio ripeterà la notifica.

Il cliente vede un errore durante l'invio dell'ordine: apri le note dell'ordine oppure attiva Debug log e controlla WooCommerce > Status > Logs, origine wcp_montonio_payment. This payment method is temporarily unavailable. Please choose another payment method. di solito indica chiavi errate o mancanti. Montonio could not start the payment. Please check your order details or choose another payment method. significa che Montonio ha rifiutato i dati del pagamento; la nota riporta il motivo.

L'ordine è In attesa dopo il pagamento: leggi la nota dell'ordine. La banca non ha ancora confermato il pagamento, l'importo o la valuta pagati non corrispondono all'ordine, un pagamento in sandbox è arrivato in modalità live, oppure il pagamento è arrivato dopo l'annullamento dell'ordine. Controlla il pagamento nel Montonio Partner System.

I pagamenti in sandbox non confermano un ordine live: un pagamento in sandbox non completa mai un ordine mentre il negozio è in modalità live; l'ordine viene messo In attesa. Imposta Sandbox mode sull'ambiente che vuoi usare e utilizza le chiavi di quell'ambiente.

Il rimborso fallisce con un messaggio sull'ambiente: il pagamento è stato effettuato nell'ambiente sandbox o live, e le chiavi di quell'ambiente non sono impostate. Inseriscile e riprova.

Il blocco licenza mostra un errore: segui il messaggio nel blocco. Per esempio, se la chiave è già usata su un altro dominio, libera uno slot 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 conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway e i registri vengono rimossi solo se Delete data era attivo. Altrimenti restano disponibili per una reinstallazione futura. Gli ordini esistenti conservano le note di pagamento e gli ID delle transazioni.

Montonio è un marchio del rispettivo proprietario. Questo plugin non è affiliato a Montonio né approvato da Montonio.