VibeFox DPO for WooCommerce — Guida
Requisiti
WordPress: 6.2 o successivo.
WooCommerce: 8.0 o successivo, installato e attivo. Il plugin si rifiuta di attivarsi senza di esso.
PHP: 8.0 o successivo.
Account DPO Pay: ti servono il Company Token e il Service Type ID del tuo account commerciante DPO. DPO li rilascia quando il tuo account viene aperto; ottienili dal tuo account manager DPO o da dpogroup.com. DPO può anche fornire un account di test con un proprio token e service type. Non esiste un server di test separato: DPO usa lo stesso indirizzo API per gli account di test e live, e l'account viene scelto in base al token.
Valuta: la valuta del negozio deve essere supportata dal tuo account DPO, per esempio USD, EUR, ZAR, KES, UGX, TZS, RWF, GHS, NGN, ZMW, XOF o AED. DPO accetta al massimo 2 decimali, quindi i totali dell'ordine con 3 decimali (per esempio KWD 12.345) non possono essere pagati.
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_dpo_pay in /wp-content/plugins/ via FTP.
2. Fai clic su Activate.
3. Apri le impostazioni: WooCommerce > Settings > Payments > DPO Pay > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina dei plugin.
4. Inserisci la tua chiave di licenza VibeFox nel blocco licenza in alto nella pagina e fai clic su Activate.
5. Inserisci il Company Token e il Service Type di test e/o live (vedi Configurazione).
6. Invia l'URL di notifica push mostrato nella pagina delle impostazioni all'assistenza DPO e chiedi di impostarlo per il tuo account.
7. Attiva Enable/Disable. Effettua un ordine di prova in modalità test, poi deseleziona Test mode per accettare pagamenti reali.
Configurazione
Tutte le impostazioni si trovano in un'unica pagina: WooCommerce > Settings > Payments > DPO Pay. Quando il gateway è attivo ma il Company Token o il Service Type della modalità selezionata è vuoto, la pagina avverte che il metodo di pagamento è nascosto al checkout, e il salvataggio mostra lo stesso errore. Mentre la modalità di test è attiva, la pagina mostra Test mode is on: payments are created with the test account credentials.
Generale
Enable/Disable: Enable DPO Pay attiva o disattiva il metodo di pagamento. Predefinito: disattivato.
Title: il nome del metodo di pagamento visto dai clienti al checkout. Predefinito: DPO Pay.
Description: il testo mostrato sotto il metodo di pagamento al checkout. Predefinito: Pay securely by card or mobile money on the DPO Pay payment page.
Credenziali API
DPO rilascia un Company Token e un Service Type ID per il tuo account commerciante, e altri separati per un account di test. Ottienili dal tuo account manager DPO o da dpogroup.com.
Test mode: Use the test account credentials below. Quando attivo, i nuovi pagamenti vengono creati con il Company Token e il Service Type di test. Predefinito: attivo. Deselezionalo per accettare pagamenti reali con le credenziali live. I controlli di stato degli ordini esistenti usano sempre l'account con cui il pagamento è stato creato.
Test Company Token: il Company Token del tuo account di test DPO.
Test Service Type: il Service Type ID numerico del tuo account di test DPO.
Live Company Token: il Company Token del tuo account commerciante DPO live.
Live Service Type: il Service Type ID numerico del tuo account commerciante DPO live.
Un Service Type deve essere un numero. Qualsiasi altro valore non viene salvato: la pagina mostra un errore e mantiene il valore precedente. Se aggiorni dalla versione 1.0, le credenziali di quella versione vengono copiate anche nei campi di test.
Notifiche di pagamento
La notifica push comunica subito al tuo negozio che un pagamento è stato effettuato, anche se il cliente chiude il browser dopo aver pagato. Questa sezione mostra l'URL di notifica push. Ha un aspetto simile a https://your-site/wc-api/dpo_pay_notify/. Non si imposta da una dashboard: chiedi all'assistenza DPO di impostare questo URL per il tuo account.
Le notifiche push di DPO non hanno firma, quindi il loro contenuto non è mai considerato attendibile. Il plugin le usa solo per trovare l'ordine e poi verifica il pagamento direttamente con DPO. Senza l'URL push, gli ordini vengono comunque confermati quando il cliente torna al negozio e dai controlli automatici 15 minuti dopo il reindirizzamento e dopo il limite di tempo per il pagamento.
Ordini
Successful payment status: lo stato dell'ordine dopo un pagamento riuscito verificato. Lo stato viene impostato subito, senza un secondo cambio di stato.
Avanzate
Logging: Enable logging scrive le chiamate API e le notifiche in WooCommerce > Status > Logs, origine wcp_dpo_pay. Gli errori vengono sempre registrati. I token sono mascherati, non vengono registrati dati dei clienti. Predefinito: disattivato.
Delete data: Delete all plugin data when the plugin is deleted. Rimuove le impostazioni, i dati DPO memorizzati sugli ordini e i log alla disinstallazione. La disattivazione non elimina mai i dati. Predefinito: disattivato.
Checkout
Il cliente sceglie il metodo di pagamento (predefinito DPO Pay) ed effettua l'ordine. Il plugin crea una transazione DPO per il totale dell'ordine nella valuta dell'ordine, con il numero d'ordine e il nome del tuo sito come descrizione, e invia il cliente alla pagina di pagamento DPO. Nome, e-mail, telefono e indirizzo del cliente vengono trasmessi per precompilare la pagina. Lì il cliente paga con qualsiasi metodo attivato sul tuo account DPO. Il link di pagamento è valido per 5 ore.
Dopo il pagamento, il cliente torna al tuo negozio. L'ordine viene segnato come pagato solo dopo che DPO lo conferma: il plugin chiede a DPO il risultato della transazione quando il cliente torna, quando arriva una notifica push e ai controlli automatici. Quando il pagamento è confermato, il cliente va alla pagina dell'ordine ricevuto.
Se il pagamento non è confermato, il cliente torna al checkout o alla pagina Pay for order con uno di questi messaggi:
Se il cliente fa clic sul pulsante nella pagina DPO per tornare al negozio, l'ordine viene annullato nel modo standard di WooCommerce e il suo link di pagamento DPO viene annullato presso DPO.
Quando un cliente paga di nuovo per lo stesso ordine, il link di pagamento DPO precedente viene controllato prima. Se è stato pagato, l'ordine viene completato senza un secondo addebito. Se è ancora in elaborazione, il cliente vede Your previous payment for this order is still being processed by DPO. Please wait a few minutes before trying again. Altrimenti il vecchio link viene annullato presso DPO e ne viene creato uno nuovo.
Se DPO non può avviare il pagamento, il cliente vede un breve messaggio scelto in base al codice di errore DPO, per esempio che DPO Pay non supporta la valuta di questo ordine, o che l'importo supera il limite consentito da DPO Pay, e può scegliere un altro metodo di pagamento.
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 singoli sulla pagina DPO. Non prevede rimborsi da WooCommerce, carte salvate, abbonamenti o pagamenti ricorrenti, campi carta sul tuo sito né acquisizione di pagamenti solo autorizzati.
Ordini
Stati dell'ordine
Pending payment: il cliente è stato inviato a DPO e non ha ancora pagato, oppure DPO non ha ancora confermato il pagamento.
Processing, Completed o On hold: il pagamento è stato verificato. Lo stato segue Successful payment status. La nota dell'ordine mostra l'importo, la valuta, il codice di approvazione e l'inizio del token di transazione DPO. L'ID transazione è il token di transazione DPO.
On hold after payment: DPO ha confermato un pagamento, ma l'importo o la valuta differiscono dall'ordine, il pagamento è solo autorizzato e non acquisito, la transazione è stata sovra- o sottopagata, oppure l'ordine era già stato annullato. La nota dell'ordine spiega il motivo. Controlla la transazione nel portale DPO. Acquisisci o annulla un pagamento solo autorizzato nel portale DPO, poi aggiorna l'ordine.
Failed: il pagamento è stato rifiutato, annullato, oppure è trascorso il limite di tempo per il pagamento. Il cliente può pagare di nuovo.
Cancelled: il cliente è tornato al negozio dalla pagina DPO, oppure l'ordine è stato annullato da te o dal timeout di WooCommerce per gli ordini non pagati. Il link di pagamento DPO non pagato viene annullato presso DPO.
Un messaggio di rifiuto successivo non modifica mai un ordine già pagato, e i risultati di link di pagamento precedenti non fanno mai fallire il tentativo attuale. Se DPO conferma un secondo pagamento riuscito per un ordine già pagato, l'ordine riceve una nota su un possibile doppio pagamento, così puoi rimborsarlo nel portale DPO.
Rimborsi
I rimborsi da WooCommerce non sono disponibili in questa versione. Rimborsa il pagamento nel portale commerciante DPO, poi contrassegna l'ordine come rimborsato in WooCommerce.
Chiave di licenza
Il plugin funziona con una chiave di licenza VibeFox da vibefox.net. Il blocco licenza si trova in alto in WooCommerce > Settings > Payments > DPO Pay. Incolla la chiave in License key e fai clic su Activate. Il blocco mostra lo stato, per esempio la data fino a cui la licenza è attiva e il tuo dominio. Usa Check now per controllare 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 il suo slot di dominio. Libera lo slot nel tuo account vibefox.net.
Senza una chiave attiva, DPO Pay 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 con accesso effettuato vedono comunque il metodo di pagamento, contrassegnato (unlicensed — visible to admins only), così puoi configurare e testare il plugin prima di acquistare una chiave. Un promemoria appare nella pagina dei plugin e nelle pagine di WooCommerce. Gli ordini esistenti non sono interessati: i pagamenti già avviati vengono comunque confermati.
Quando una licenza scade, il plugin continua a funzionare, ma gli aggiornamenti e l'assistenza richiedono un rinnovo. Lo stato viene controllato di nuovo automaticamente in background.
Risoluzione dei problemi
DPO Pay non appare al checkout: controlla che la licenza sia attiva, Enable/Disable sia attivo e che il Company Token e il Service Type della modalità selezionata siano impostati: i campi di test in modalità test, i campi live altrimenti. La pagina delle impostazioni mostra un avviso quando mancano.
Il pagamento è andato a buon fine, ma l'ordine resta Pending payment: probabilmente l'URL di notifica push non è impostato per il tuo account DPO, e il cliente non è tornato al negozio. Chiedi all'assistenza DPO di impostare l'URL mostrato nelle impostazioni. L'ordine viene confermato anche dal controllo automatico 15 minuti dopo il reindirizzamento. Attiva Logging e guarda WooCommerce > Status > Logs, origine wcp_dpo_pay.
La notifica push risponde Unknown transaction: il token di transazione non appartiene a un ordine DPO Pay di questo negozio, per esempio la notifica proviene da un altro negozio sullo stesso account DPO.
La notifica push risponde Verification failed: non è stato possibile contattare DPO per verificare il pagamento. DPO ripete la notifica, e anche il controllo automatico conferma l'ordine.
Il Service Type non viene salvato: deve essere il Service Type ID numerico di DPO.
Il cliente vede DPO Pay is temporarily unavailable: DPO ha rifiutato di creare la transazione, per esempio per un Company Token o Service Type errato, o un token dell'altra modalità. Il codice di risultato DPO si trova in WooCommerce > Status > Logs, origine wcp_dpo_pay.
Il cliente vede che DPO accetta al massimo 2 decimali: il totale dell'ordine ha 3 decimali. DPO non può addebitare tali importi.
L'ordine è In sospeso dopo il pagamento: leggi la nota dell'ordine. L'importo o la valuta pagati differivano dall'ordine, il pagamento è solo autorizzato, la transazione è stata sovra- o sottopagata, oppure l'ordine era stato annullato. Controlla la transazione nel portale DPO.
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 conosciuto.
Disinstallazione
Disattivare il plugin conserva tutti i dati e interrompe solo i controlli di stato pianificati. Per rimuoverlo, disattivalo ed eliminalo sulla pagina Plugins. La chiave di licenza e lo stato di licenza di questo plugin vengono sempre rimossi. Le impostazioni, i dati DPO memorizzati sugli ordini, i controlli pianificati e i log vengono rimossi solo se Delete data era attivo. Altrimenti restano per una reinstallazione successiva. Gli ordini esistenti conservano le loro note di pagamento e gli ID transazione.
DPO Pay è un marchio del rispettivo proprietario. Questo plugin non è affiliato né approvato da DPO Pay.