Configurazione del plugin WooCommerce per pagamenti 4Geeks¶
Panoramica¶
Il 4Geeks Payments WooCommerce Plugin ti consente di accettare pagamenti online sul tuo negozio WordPress/WooCommerce in 5 minuti o meno, senza bisogno di codifica. In qualitĂ di commerciante registrato, 4Geeks gestisce la conformitĂ fiscale, la prevenzione delle frodi e gli storni di addebito in modo che tu possa concentrarti sulla vendita.
In questo tutorial potrai:
- Installa il plug-in Pagamenti 4Geeks
- Configurare i metodi di pagamento
- Testare le transazioni in modalitĂ sandbox
- Vai in diretta e inizia ad accettare pagamenti
Prerequisiti¶
- Un conto 4Geeks Payments attivato (attivare il servizio)
- WordPress 5.0+ con WooCommerce installato
- Accesso amministratore alla dashboard di WordPress
Passaggio 1: installa il plug-in¶
Opzione A: dalla directory dei plugin WordPress¶
- Vai al dashboard di amministrazione di WordPress
- Vai a Plugin → Aggiungi nuovo
- Cerca “Pagamenti 4Geeks”
- Fare clic su “Installa ora” quindi su “Attiva”
Opzione B: caricamento manuale¶
- Scarica il plug-in da docs.4geeks.io/en/payments/plugins/woocommerce
- Vai a Plugin → Aggiungi nuovo → Carica plugin
- Carica il file ZIP
- Fai clic su “Attiva”
Passaggio 2: configura le chiavi API¶
- Vai su WooCommerce → Impostazioni → Pagamenti
- Trova 4Geeks Payments e fai clic su “Gestisci”
- Inserisci le tue credenziali API:
- Chiave pubblica: dalla tua console 4Geeks
- Chiave segreta: dalla tua console 4Geeks
- Alterna “Abilita/Disabilita” in Abilita
Suggerimento: inizia con le chiavi sandbox da testare prima della pubblicazione.
Passaggio 3: configura le impostazioni di pagamento¶
Impostazioni generali¶
| Impostazione | Descrizione | Consigliato |
|---|---|---|
| Titolo | Nome del metodo di pagamento mostrato al momento del pagamento | “Carta di credito/debito” |
| Descrizione | Descrizione mostrata ai clienti | “Paga in sicurezza con la tua carta” |
| Modalità prova | Abilita test sandbox | Sì (inizialmente) |
| 3D Secure | Abilita autenticazione 3DS | Sì |
Impostazioni della transazione¶
| Impostazione | Descrizione | Consigliato |
|---|---|---|
| Cattura | Acquisisci automaticamente o autorizza solo | Acquisizione automatica |
| Descrittore dell’istruzione | Testo sull’estratto conto del cliente | Il nome della tua attivitĂ |
| Carte accettate | Quali marchi di carte accettare | Tutti abilitati |
Passaggio 4: prova in modalitĂ Sandbox¶
- Assicurati che la ModalitĂ test sia abilitata
- Aggiungi un prodotto al carrello e procedi al pagamento
- Utilizza un numero di carta di prova:
| Carta | Numero | Risultato |
|---|---|---|
| Visto (successo) | 4242 4242 4242 4242 | Pagamento approvato |
| Visto (rifiutato) | 4000 0000 0000 9995 | Pagamento rifiutato |
| Richiede 3DS | 4000 0000 0000 0002 | Sfida 3D Secure |
- Utilizzare qualsiasi data di scadenza futura e qualsiasi CVC a 3 cifre
- Completa il checkout e verifica lo stato dell’ordine
Passaggio 5: verifica la configurazione del webhook¶
I webhook assicurano che il tuo negozio riceva aggiornamenti sui pagamenti in tempo reale:
- Nella tua console 4Geeks, vai su Pagamenti → Impostazioni → Webhooks
- Aggiungi l’URL del tuo webhook:
https://yourstore.com/wc-api/4geeks_payments - Seleziona gli eventi da ricevere:
- “addebito.riuscito”.
- “caricamento fallito”.
- “rimborso.completato”.
- “abbonamento.creato”.
- Salva e testa il webhook
Passaggio 6: vai in diretta¶
Una volta completato il test:
- Passa dalla ModalitĂ test alla ModalitĂ live nelle impostazioni del plugin
- Sostituisci le chiavi API sandbox con chiavi di produzione
- Effettua un ordine di prova reale con una carta reale (piccolo importo)
- Verifica che il pagamento venga visualizzato nella tua console 4Geeks
- Conferma che il pagamento è programmato sul tuo conto bancario
FunzionalitĂ supportate¶
| Caratteristica | Supportato |
|---|---|
| Pagamenti una tantum | Sì |
| Abbonamenti ricorrenti (Abbonamenti WooCommerce) | Sì |
| Rimborsi dall’amministratore di WooCommerce | Sì |
| Rimborsi parziali | Sì |
| Multivaluta | Sì |
| 3D sicuro (3DS) | Sì |
| Carte salvate | Sì |
| Collegamenti di pagamento | Sì |
Risoluzione dei problemi¶
Problemi comuni¶
| Problema | Soluzione |
|---|---|
| Errore “Chiave API non valida” | Verificare che le chiavi siano corrette e provenienti dall’ambiente corretto (sandbox o produzione) |
| Il pagamento fallisce silenziosamente | Controlla la configurazione del webhook e i log del server |
| 3D Secure non si attiva | Assicurati che 3DS sia abilitato nelle impostazioni del plugin |
| Rimborso non elaborato | Verifica che l’addebito originale venga acquisito e rimborsabile |
Ottenere aiuto¶
- Controlla i log del plugin: WooCommerce → Stato → Log
- Esamina la documentazione sui pagamenti
- Contatta l’assistenza tramite la dashboard della console
Qual è il prossimo passo?¶
- Ulteriori informazioni sulla Fatturazione ricorrente dell’abbonamento
- Esplora il Pagamento multivaluta
Hai bisogno di aiuto?¶
- Documentazione: docs.4geeks.io/en/payments/plugins/woocommerce
- Riferimento API: docs.4geeks.io/en/api
- Supporto: disponibile tramite il dashboard della console
Hai ancora domande? Richiedi supporto or explore tutoriali