VibeFox MakeCommerce 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.
Accesso a Internet per il tuo sito: MakeCommerce invia notifiche di pagamento al tuo negozio, quindi il sito deve essere raggiungibile da Internet (consigliato HTTPS). Un firewall, la modalità di manutenzione o l'autenticazione di base possono bloccarle.
Account MakeCommerce: hai bisogno dello Shop ID e della Secret key reperibili nel MakeCommerce Merchant Portal (Settings > API). Gli ambienti di test e live hanno account e chiavi separati. I metodi di pagamento e le valute disponibili sono definiti dal tuo contratto MakeCommerce (i link bancari sono in EUR). Le valute con tre decimali, come KWD o BHD, non sono disponibili.
Chiave di licenza VibeFox: acquistata 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. Puoi anche caricare la cartella wcp_makecommerce_payment in /wp-content/plugins/ tramite FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Payments > MakeCommerce > 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 lo Shop ID e la Secret key dell'ambiente di test e, per i pagamenti reali, le chiavi live (vedi Configurazione). Non occorre configurare nulla nel Merchant Portal.
6. Attiva Enable/Disable. Esegui un pagamento di prova con Test mode attivo, poi deselezionalo per accettare pagamenti reali.
Configurazione
Tutte le impostazioni si trovano in una sola pagina: WooCommerce > Settings > Payments > MakeCommerce. Sopra i campi la pagina mostra Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. finché la modalità di test è attiva. Ti avvisa quando il metodo è abilitato ma lo Shop ID o la Secret key dell'ambiente corrente sono vuoti, e quando la valuta del negozio non può essere addebitata da MakeCommerce. In entrambi i casi il metodo viene nascosto al checkout. Nell'elenco dei metodi di pagamento, MakeCommerce viene contrassegnato come richiedente configurazione finché l'ambiente corrente non ha le sue chiavi. Gli spazi vuoti vengono rimossi dalle chiavi durante il salvataggio.
General
Enable/Disable: Enable MakeCommerce payments attiva o disattiva il metodo di pagamento. Predefinito: disattivato.
Title: il nome del metodo di pagamento visibile ai clienti al checkout. Predefinito: Bank link or card (MakeCommerce).
Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.
MakeCommerce account
Lo Shop ID e la Secret key si trovano nel MakeCommerce Merchant Portal sotto Settings > API. Il portale di test e il portale live hanno account e chiavi separati. La sezione offre link a entrambi i portali e alla pagina di registrazione di MakeCommerce.
Test mode: Use the MakeCommerce test environment (no real money is charged). I nuovi pagamenti vengono creati nell'ambiente selezionato con le relative chiavi. Ogni ordine memorizza l'ambiente in cui è stato pagato: i controlli di stato e i rimborsi vanno sempre lì. Una riga TEST MODE — MakeCommerce test environment, no real money is charged. viene mostrata al checkout. Predefinito: attivo.
Test Shop ID: lo Shop ID del tuo account di test, nel formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Test Secret key: la Secret key del tuo account di test.
Live Shop ID: lo Shop ID del tuo account live.
Live Secret key: la Secret key del tuo account live.
Payment notifications
Non occorre configurare nulla nel Merchant Portal. Ogni transazione include i propri URL di ritorno, annullamento e notifica, basati sull'indirizzo mostrato in questa sezione (simile a https://your-site/wc-api/wc_mkc_payment/) a cui vengono aggiunti numero d'ordine e chiave dell'ordine. MakeCommerce invia un messaggio firmato all'URL di notifica (da server a server) e tramite il browser del cliente all'URL di ritorno o annullamento. La firma viene verificata con la Secret key dell'ambiente in cui la transazione è stata creata. I messaggi senza una firma valida vengono rifiutati.
Il plugin gestisce i seguenti stati di transazione di MakeCommerce:
Il pagamento viene confermato anche quando il cliente torna al negozio. Se il cliente torna senza un messaggio firmato, il plugin interroga l'API di MakeCommerce per ottenere lo stato.
Advanced
Debug log: Log API calls and payment notifications scrive i dettagli in WooCommerce > Status > Logs, origine wcp_makecommerce_payment. Gli errori vengono registrati sempre. Le chiavi e i dati dei clienti non vengono mai registrati. Predefinito: disattivato.
Delete data: Delete the gateway settings and logs when the plugin is deleted. Gli ordini e le relative note di pagamento vengono sempre conservati. La disattivazione del plugin non elimina mai nulla. Predefinito: disattivato.
Checkout
Il cliente sceglie il metodo di pagamento (per impostazione predefinita Bank link or card (MakeCommerce)) ed effettua l'ordine. Il plugin crea una transazione MakeCommerce per il totale dell'ordine nella valuta dell'ordine e indirizza il cliente alla pagina di pagamento di MakeCommerce. Lì il cliente sceglie un link bancario o una carta. L'e-mail di fatturazione e il paese vengono trasmessi a MakeCommerce, e la pagina si apre nella lingua del negozio ove MakeCommerce la supporti (estone, inglese, lettone, lituano, finlandese, russo, tedesco, polacco), altrimenti in inglese.
Dopo il pagamento, il cliente torna alla pagina dell'ordine ricevuto del tuo negozio. L'ordine viene contrassegnato come pagato solo dopo la conferma da parte di MakeCommerce: tramite la notifica firmata o tramite il ritorno firmato del cliente, con un controllo della transazione attraverso l'API di MakeCommerce.
Se il cliente annulla sulla pagina di MakeCommerce o il pagamento scade, il cliente torna al checkout (o alla pagina Pay for order) con un messaggio, per esempio The payment was cancelled. You can try again or choose another payment method. oppure The payment session expired. Please try again. Se il pagamento non può ancora essere confermato, il messaggio è We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Il cliente può riprovare a pagare. Un link di pagamento precedente dello stesso ordine funziona ancora, e l'ordine non può essere pagato due volte.
Se MakeCommerce non riesce ad avviare il pagamento, il cliente vede MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. oppure MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Il motivo tecnico 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 l'archiviazione ad alte prestazioni degli ordini (HPOS) di WooCommerce.
La banca o la carta viene scelta sulla pagina di MakeCommerce, non nel tuo checkout. Il plugin non prevede carte salvate, pagamenti ricorrenti o WooCommerce Subscriptions e non include le spedizioni di MakeCommerce (armadietti per pacchi, etichette).
Ordini e rimborsi
Stati dell'ordine
Pending payment: il cliente è stato indirizzato a MakeCommerce e non ha ancora pagato, oppure MakeCommerce non ha ancora confermato il pagamento. La nota dell'ordine mostra la transazione MakeCommerce, l'importo e l'ambiente.
Processing: il pagamento è stato confermato. Gli ordini con soli prodotti virtuali scaricabili passano a Completato, l'impostazione predefinita di WooCommerce. La nota dell'ordine mostra l'importo, la transazione, l'ambiente e la modalità di verifica (API MakeCommerce o notifica firmata). L'ID transazione è l'ID transazione di MakeCommerce.
On hold: l'importo pagato o la valuta differivano dall'ordine, l'importo era mancante, lo stato della transazione su MakeCommerce non era ancora definitivo, o il pagamento è arrivato per un ordine annullato. La nota dell'ordine ne spiega il motivo. Tale transazione non potrà mai pagare l'ordine in seguito. Controlla la transazione nel Merchant Portal e completa o rimborsa l'ordine manualmente.
Failed: l'ultimo pagamento dell'ordine è stato annullato, è scaduto o non è riuscito. Il cliente può riprovare a pagare.
Se arriva un secondo pagamento per un ordine già pagato, l'ordine non viene modificato di nuovo. Una nota ti chiede di rimborsare il duplicato nel MakeCommerce Merchant Portal.
Check MakeCommerce payment status
Nella schermata dell'ordine, scegli Check MakeCommerce payment status nelle azioni dell'ordine. Il plugin interroga l'API di MakeCommerce per verificare lo stato delle transazioni dell'ordine (la più recente per prima), lo applica e aggiunge una nota con l'esito. Usalo quando un ordine rimane In attesa di pagamento benché il cliente abbia pagato.
Rimborsi
Apri l'ordine, fai clic su Refund, inserisci l'importo e fai clic su Refund via Bank link or card (MakeCommerce) (il pulsante mostra il tuo Title). Sono supportati rimborsi totali e parziali. Il rimborso viene inviato all'ambiente in cui l'ordine è stato pagato (test o live), pertanto le chiavi di quell'ambiente devono essere impostate. Se MakeCommerce non accetta il rimborso, WooCommerce mostra l'errore, viene aggiunta una nota e nessun rimborso viene registrato. Se MakeCommerce sta ancora elaborando il pagamento, il messaggio è MakeCommerce is still processing this payment — try the refund again later. Un rimborso andato a buon fine viene aggiunto alle note dell'ordine con l'ID rimborso di MakeCommerce.
I rimborsi effettuati nel Merchant Portal arrivano con lo stato della transazione e vengono aggiunti alle note dell'ordine. Non vengono registrati automaticamente come rimborsi di 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 > MakeCommerce. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, ad esempio la data di scadenza della licenza e il tuo dominio. Usa Check now per ricontrollare 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 su vibefox.net.
Una chiave funziona su un dominio. Rimuovere la chiave da un sito non libera lo slot del dominio corrispondente. Libera lo slot nel tuo account su vibefox.net.
Senza una chiave attiva, MakeCommerce non viene mostrato ai clienti al checkout. Se un pagamento viene comunque avviato, il cliente vede This payment method is not available. Please choose another one. I gestori del negozio connessi vedono comunque il metodo di pagamento, contrassegnato con (unlicensed — visible to admins only), così da poter configurare e testare il plugin prima di acquistare una chiave. Un promemoria viene mostrato nella pagina dei plugin e nelle pagine di WooCommerce. Gli ordini esistenti non vengono toccati: i pagamenti già avviati continuano a essere confermati e i rimborsi funzionano.
Quando una licenza scade, il plugin continua a funzionare, ma per gli aggiornamenti e il supporto occorre rinnovarla. Lo stato viene ricontrollato automaticamente in background.
Risoluzione dei problemi
MakeCommerce non compare al checkout: controlla che la licenza sia attiva, che Enable/Disable sia abilitato e che l'ambiente corrente disponga delle sue chiavi: Test Shop ID e Test Secret key in modalità di test, Live Shop ID e Live Secret key in modalità live. Verifica che la valuta del negozio (o la valuta dell'ordine nella pagina Pay for order) abbia al massimo due decimali. La pagina delle impostazioni mostra un avviso per ciascuno di questi problemi.
Il pagamento è andato a buon fine, ma l'ordine rimane In attesa di pagamento: le notifiche non sono riuscite a raggiungere il sito, ad esempio a causa di un firewall, della modalità di manutenzione o dell'autenticazione di base. Apri l'ordine ed esegui l'azione dell'ordine Check MakeCommerce payment status. Controlla che le chiavi dell'ambiente in cui è stato eseguito il pagamento siano impostate: la notifica viene verificata con la Secret key di quell'ambiente, e senza di essa MakeCommerce riceve un errore e riprova.
L'ordine è In attesa con una nota di MakeCommerce: il pagamento non corrispondeva all'ordine (importo, valuta, stato) o è arrivato per un ordine annullato. Controlla la transazione nel Merchant Portal e completa o rimborsa l'ordine manualmente.
Le notifiche vengono rifiutate: un messaggio con firma non valida, per un altro ordine, un altro negozio o una transazione non creata per quell'ordine viene rifiutato e l'ordine non viene modificato. Verifica che Shop ID e Secret key appartengano allo stesso account e ambiente MakeCommerce.
Il cliente visualizza un errore al momento dell'ordine: apri le note dell'ordine o attiva Debug log e controlla in WooCommerce > Status > Logs, origine wcp_makecommerce_payment. Una valuta che MakeCommerce non può addebitare genera il messaggio MakeCommerce cannot process payments in seguito dal codice valuta.
Il rimborso non riesce con un messaggio relativo all'ambiente: l'ordine è stato pagato nell'ambiente di test o live, e le chiavi di quell'ambiente non sono configurate. Inseriscile e riprova.
Il rimborso non riesce con No MakeCommerce transaction ID found for this order: l'ordine non ha una transazione MakeCommerce. Esegui il rimborso nel Merchant Portal.
Il blocco licenza mostra un errore: segui il messaggio presente nel blocco. Ad esempio, se la chiave è già usata su un altro dominio, libera uno slot nel tuo account su vibefox.net e fai clic su Check now. Se l'indirizzo del sito è cambiato, fai clic su Check now per attivare la chiave sul nuovo dominio. Se il server delle licenze non è raggiungibile, il plugin continua a funzionare con l'ultimo stato noto.
Disinstallazione
La disattivazione del 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. Le impostazioni del gateway e i registri vengono rimossi solo se Delete data era attivo. In caso contrario rimangono per una reinstallazione successiva. Gli ordini esistenti conservano le relative note di pagamento e gli ID di transazione.
MakeCommerce è un marchio commerciale del rispettivo proprietario. Questo plugin non è affiliato né approvato da MakeCommerce.