VibeFox GMO for WooCommerce — Guida

Requisiti

WordPress: 6.0 o successivo.

WooCommerce: 8.0 o successivo, installato e attivo. Senza di esso il plugin non si attiva.

PHP: 8.0 o successivo.

Valuta del negozio: yen giapponese (JPY). Con un’altra valuta del negozio, il metodo di pagamento viene nascosto al checkout. Nella pagina Pay for order conta la valuta dell’ordine.

Account GMO Payment Gateway: un contratto commerciante GMO-PG con Link Type Plus. Servono Shop ID, Shop password e Config ID di Link Type Plus (設定ID) dell’ambiente di test e/o produzione, e la notifica del risultato (結果通知) attiva nella console del negozio GMO-PG (vedi Configurazione). Site ID e Site password non vengono usati.

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_gmo_payment in /wp-content/plugins/ tramite FTP.

2. Fai clic su Activate.

3. Apri le impostazioni: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage, oppure fai clic su Settings sotto il nome del plugin nella pagina dei plugin.

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

5. Inserisci Shop ID, Shop password e Config ID dell’ambiente di test e/o produzione e scegli Environment.

6. Nella console del negozio GMO-PG attiva 結果通知 (notifica del risultato) e imposta l’URL di notifica mostrato nelle impostazioni (vedi Configurazione).

7. Attiva Enable/Disable. Esegui un pagamento di prova nell’ambiente di test, poi passa Environment a produzione.

Configurazione

Tutte le impostazioni sono in un’unica pagina: WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card. Il titolo della pagina mostra un badge TEST o PRODUCTION per l’ambiente attuale. Sopra i campi, la pagina ti avvisa se la valuta del negozio non è JPY o se mancano Shop ID, Shop password o Config ID dell’ambiente attuale. In entrambi i casi, il metodo di pagamento viene nascosto al checkout. Nell’elenco dei metodi di pagamento, il gateway è indicato come da configurare finché l’ambiente attuale non ha le sue credenziali. Gli spazi iniziali e finali delle credenziali vengono rimossi al salvataggio.

Enable/Disable: Enable GMO Payment Gateway — Credit Card attiva o disattiva il metodo di pagamento. Predefinito: disattivato.

Title: il nome del metodo di pagamento mostrato al checkout. Predefinito: Credit card.

Description: il testo sotto il metodo di pagamento al checkout. Predefinito: You will be redirected to the secure GMO Payment Gateway page to pay by credit card.

Account GMO-PG

Shop ID e Shop password si trovano nella console del negozio GMO-PG in Shop management > Shop information, mentre Config ID si trova in Link Type Plus > Settings (設定ID). Gli ambienti di test e produzione hanno credenziali diverse.

Environment: l’ambiente GMO-PG che riceve i pagamenti.

Credenziali di produzione (p01.mul-pay.jp)

Production Shop ID: lo Shop ID dell’ambiente di produzione.

Production Shop password: la Shop password dell’ambiente di produzione.

Production Config ID: l’ID di configurazione Link Type Plus (設定ID) registrato nella console GMO-PG.

Credenziali di test (pt01.mul-pay.jp)

Test Shop ID: lo Shop ID dell’ambiente di test.

Test Shop password: la Shop password dell’ambiente di test.

Test Config ID: l’ID di configurazione Link Type Plus (設定ID) dell’ambiente di test.

Pagamento

Capture: quando viene addebitata la carta.

Order status after payment: lo stato di un ordine pagato. Viene impostato subito, con un solo cambio di stato e una sola e-mail al cliente.

Notifiche di pagamento (結果通知)

La notifica del risultato comunica al tuo negozio che è stato effettuato un pagamento. È obbligatoria. Nella console del negozio GMO-PG attiva 結果通知 (notifica del risultato) e imposta l’URL di notifica mostrato in questa sezione delle impostazioni. È simile a https://your-site/wc-api/gmo_pg_webhook/. Copia l’URL esattamente come appare nelle impostazioni.

Le notifiche GMO-PG non sono firmate, quindi il plugin non si fida mai del loro contenuto. La notifica deve provenire da uno degli Shop ID configurati e riferirsi a un pagamento creato da questo negozio, nell’ambiente in cui è stato pagato l’ordine. Il plugin richiede quindi la transazione a GMO-PG (SearchTrade) con la tua Shop password e modifica l’ordine solo in base a quella risposta. Una notifica che non corrisponde a una transazione reale non cambia nulla. Le transazioni non create dal negozio, per esempio quelle effettuate nella console GMO-PG, vengono confermate come ricevute e ignorate. Se il plugin non può verificare una notifica, risponde in modo che GMO-PG la invii di nuovo (GMO-PG riprova fino a 5 volte).

Senza la notifica, un ordine viene confermato solo quando il cliente torna al negozio dopo aver pagato.

Avanzate

Debug log: Log API requests and notifications li scrive in WooCommerce > Status > Logs, origine wcp_gmo_payment. Gli errori vengono sempre registrati. Password e dati dei clienti vengono mascherati. Predefinito: disattivato.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. La disattivazione non elimina mai nulla. I dati degli ordini (ID delle transazioni) vengono sempre conservati. Predefinito: disattivato.

Checkout

Il cliente sceglie il metodo di pagamento (per impostazione predefinita Credit card) ed effettua l’ordine. Il plugin crea un pagamento GMO-PG Link Type Plus per il totale dell’ordine, arrotondato a yen interi, e reindirizza il cliente alla pagina di pagamento GMO-PG. Qui il cliente paga con carta di credito. GMO-PG gestisce 3-D Secure 2.0 e riceve l’e-mail di fatturazione del cliente per 3-D Secure. La pagina di pagamento si apre in giapponese, cinese o inglese, in base alla lingua del sito. Il pagamento appare in GMO-PG con WC- e il numero dell’ordine. Non vengono inviati altri dati del cliente.

Dopo il pagamento, il cliente torna al negozio. Il risultato firmato viene verificato con la tua Shop password e l’ordine viene segnato come pagato solo dopo la conferma di GMO-PG: tramite una richiesta SearchTrade lato server al ritorno del cliente o tramite la notifica del risultato. Entrambi i percorsi usano la stessa logica, quindi l’ordine non viene mai elaborato due volte. Se il pagamento non è ancora confermato, la pagina di ordine ricevuto mostra Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.

Se la carta viene rifiutata o il pagamento non riesce sulla pagina GMO-PG, l’ordine passa a Fallito e il cliente viene portato alla pagina Pay for order con il messaggio The card payment was declined or could not be completed. Please try again or use another card. Se il cliente lascia la pagina GMO-PG senza pagare, la stessa pagina mostra The payment was not completed. You can try again or choose another payment method. Ogni nuovo tentativo annulla il precedente link di pagamento non pagato. Se nel frattempo il link precedente è già stato pagato, viene applicato quel pagamento e non viene creato un nuovo link.

Si possono pagare ordini con totali da 1 a 9.999.999 JPY. Per totali superiori il metodo di pagamento viene nascosto. Se non è possibile avviare il pagamento, il cliente vede un breve messaggio, per esempio Card payment could not be started. Please try again or choose another payment method., e il motivo viene aggiunto alle note dell’ordine.

Il metodo di pagamento funziona nel checkout classico, nei blocchi Carrello e Checkout e nella pagina Pay for order. Nel blocco Checkout mostra l’icona della carta e la descrizione. Nell’ambiente di test, sia il checkout classico sia il blocco Checkout mostrano il badge Test mode — no real charge. È compatibile con l’archiviazione degli ordini ad alte prestazioni di WooCommerce (HPOS).

Il plugin accetta pagamenti con carta di credito solo in JPY, sempre sulla pagina GMO-PG. Non offre altri metodi di pagamento GMO-PG, più valute, carte salvate o registrazione di membri GMO-PG, abbonamenti o addebiti ricorrenti, né un modulo della carta sul tuo sito.

Ordini e rimborsi

Stati degli ordini

Pending payment: il cliente è stato reindirizzato a GMO-PG e non ha ancora pagato, oppure GMO-PG non ha ancora confermato il pagamento.

Processing or Completed: il pagamento è stato confermato. Lo stato segue Order status after payment. La nota dell’ordine mostra l’importo, lo stato GMO-PG, la transazione e come è stata confermata (notifica o ritorno). L’ID della transazione è il TranID di GMO-PG.

On hold (authorized): con Authorize only (仮売上) l’importo è stato autorizzato. Acquisiscilo con l’azione dell’ordine Capture payment (GMO-PG) o nella console GMO-PG prima che l’autorizzazione scada. Dopo l’acquisizione, l’ordine passa a In lavorazione o Completato. Se l’autorizzazione viene annullata in GMO-PG, l’ordine viene annullato.

On hold after payment: GMO-PG ha segnalato un importo diverso dal totale dell’ordine, oppure il pagamento è arrivato dopo l’annullamento dell’ordine. La nota dell’ordine lo spiega. Controlla l’ordine ed evadilo o rimborsa il pagamento.

Failed: la carta è stata rifiutata o il pagamento non è stato completato sulla pagina GMO-PG.

Se arriva un secondo pagamento per un ordine già pagato o chiuso, l’ordine non viene modificato. Una nota ti chiede di rimborsare il duplicato nella console GMO-PG.

Acquisizione

L’azione dell’ordine Capture payment (GMO-PG) compare negli ordini In sospeso che sono stati solo autorizzati. Addebita l’importo autorizzato. Se la transazione non è più autorizzata, per esempio perché è già stata acquisita nella console GMO-PG, l’azione aggiunge una nota con lo stato attuale e lo segue.

Rimborsi

Apri l’ordine, fai clic su Refund, inserisci l’importo e fai clic su Refund via Credit card (il pulsante mostra il tuo Title). Sono supportati rimborsi totali e parziali in yen interi. Il rimborso dell’intero importo rimanente annulla la transazione GMO-PG, e GMO-PG decide se si tratta di un annullamento o di una restituzione. Un rimborso parziale riduce l’importo della transazione e l’emittente della carta autorizza il nuovo importo. Il rimborso viene inviato all’ambiente in cui è stato pagato l’ordine, quindi Shop ID e Shop password di quell’ambiente devono essere impostati. Se GMO-PG non accetta il rimborso, WooCommerce mostra l’errore e non viene registrato alcun rimborso. Un rimborso riuscito viene aggiunto alle note dell’ordine.

I rimborsi e gli annullamenti effettuati nella console GMO-PG arrivano tramite la notifica del risultato e vengono aggiunti alle note dell’ordine. Non vengono registrati automaticamente come rimborsi WooCommerce. Se necessario, crea un rimborso manuale in WooCommerce senza il pulsante GMO-PG.

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 > GMO Payment Gateway — Credit Card. 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 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 vibefox.net.

Una chiave funziona su un dominio. Rimuovere la chiave da un sito non libera il suo posto per il dominio. Libera il posto nel tuo account vibefox.net.

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

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

Risoluzione dei problemi

La carta di credito non compare al checkout: verifica che la licenza sia attiva, Enable/Disable sia attivo, la valuta del negozio sia JPY e siano impostati Shop ID, Shop password e Config ID dell’ambiente attuale. Gli ordini superiori a 9.999.999 JPY non possono essere pagati con carta. La pagina delle impostazioni mostra un avviso se la valuta o le credenziali sono errate.

Il pagamento è riuscito, ma l’ordine resta Pending payment: la notifica del risultato non funziona. Nella console del negozio GMO-PG dell’ambiente che usi, verifica che 結果通知 sia attivo e che l’URL sia esattamente quello delle impostazioni. Verifica che Shop ID e Shop password di quell’ambiente siano compilati, perché il plugin li usa per verificare ogni notifica. Attiva Debug log e consulta WooCommerce > Status > Logs, origine wcp_gmo_payment. L’ordine viene confermato anche quando il cliente torna al negozio dopo aver pagato.

Il registro mostra Notification rejected: unknown ShopID: la notifica proviene da un negozio il cui Shop ID non è nelle impostazioni. Inserisci lo Shop ID di quell’ambiente.

Il registro mostra Notification ignored ... is not a payment of this store: la transazione non è stata creata da questo negozio, per esempio è stata effettuata nella console GMO-PG. Non occorre fare nulla.

Il registro indica che l’ordine è stato pagato in un altro ambiente: i pagamenti di test e produzione restano separati. Una notifica di test non conferma mai un ordine di produzione e viceversa.

Il cliente vede un errore quando effettua l’ordine: apri le note dell’ordine o attiva Debug log. La nota mostra il codice di errore GMO-PG (ErrCode, ErrInfo). Di solito la causa è uno Shop ID, una Shop password o un Config ID errati. GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. significa che l’ordine non è in JPY.

L’ordine è On hold dopo il pagamento: leggi la nota dell’ordine. L’ordine è stato solo autorizzato e attende l’acquisizione, l’importo pagato differiva dal totale oppure il pagamento è arrivato dopo l’annullamento dell’ordine.

Il rimborso non riesce: leggi il messaggio. L’ordine potrebbe essere stato pagato nell’altro ambiente, di cui non sono impostati Shop ID e password, la transazione potrebbe essere già annullata in GMO-PG oppure l’importo potrebbe superare il residuo della transazione.

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 conserva tutti i dati. Per rimuoverlo, disattivalo ed eliminalo nella pagina Plugins. La chiave e lo stato della licenza di questo plugin vengono sempre rimossi. Le impostazioni del gateway e i registri vengono rimossi solo se Delete data on uninstall era attivo. Altrimenti restano per una successiva reinstallazione. I dati GMO-PG memorizzati negli ordini fanno parte della cronologia dei pagamenti e vengono sempre conservati. Gli ordini esistenti mantengono le note di pagamento e gli ID delle transazioni.

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