Riassunto AI
Vorresti accettare pagamenti da clienti in Nigeria, Ghana, Kenya o Sud Africa? Gli acquirenti in questi paesi si aspettano di pagare con i metodi che già utilizzano ogni giorno, come carte locali, bonifici bancari e mobile money.
Il componente aggiuntivo Paystack collega i tuoi moduli a Paystack in modo che gli acquirenti completino il loro pagamento in un popup sicuro senza lasciare il tuo sito. Questo tutorial ti mostrerà come installare e utilizzare il componente aggiuntivo Paystack con WPForms.
Requisiti:
- Avrai bisogno di una licenza Pro o superiore per accedere al componente aggiuntivo Paystack.
- Assicurati di aver installato WPForms versione 2.0.2.2 o superiore per soddisfare la versione minima richiesta per il componente aggiuntivo Paystack.
- Avrai bisogno di un account Paystack registrato in Nigeria, Ghana, Kenya o Sud Africa.
Prima di iniziare, assicurati di installare e attivare WPForms sul tuo sito WordPress. Dopo aver verificato la tua licenza, sarai in grado di installare e attivare rapidamente il componente aggiuntivo Paystack.
Collegare Paystack al tuo sito
Una volta installato e attivato il componente aggiuntivo Paystack, dovrai collegare il tuo account Paystack a WPForms. Per fare ciò, copierai le tue chiavi API dalla tua dashboard Paystack nelle impostazioni di pagamento di WPForms. Ti guideremo attraverso ogni passaggio di seguito.
Ottenere le chiavi API di Paystack
Per iniziare, accedi alla tua dashboard Paystack. Quindi fai clic su Impostazioni in fondo al menu a sinistra.
Una volta lì, apri la scheda API Keys & Webhooks.
Paystack mostra le chiavi per la modalità in cui si trova la tua dashboard. Per accettare pagamenti reali, avrai bisogno delle tue chiavi live, che appaiono sotto Configurazione API – Modalità Live.
Nota: I nuovi account Paystack iniziano in Modalità Test e le chiavi live diventano disponibili solo dopo che Paystack ha attivato la tua attività. Per attivarla, apri la pagina Conformità nella tua dashboard Paystack, completa ogni sezione e fai clic su Attiva attività. La tua dashboard passerà alla Modalità Live una volta che Paystack avrà approvato i tuoi dettagli. Per i passaggi completi, consulta la guida di Paystack per l'attivazione della tua attività.
Mentre attendi l'approvazione, puoi comunque provare il componente aggiuntivo con le tue chiavi di test. Vedi la sezione Testare i pagamenti Paystack di seguito.
Successivamente, fai clic sull'icona dell'occhio accanto alla tua Live Secret Key. Paystack ti chiederà la password del tuo account prima di mostrare la chiave. Quindi copia la chiave.
Dopo, copia la tua Live Public Key dal campo sottostante.
Tieni aperta questa pagina. Incollerai entrambe le chiavi in WPForms nel passaggio successivo e tornerai qui per aggiungere il tuo URL webhook.
Completare la Connessione in WPForms
Nella tua area di amministrazione di WordPress, vai su WPForms » Impostazioni e fai clic sulla scheda Pagamenti.
Innanzitutto, controlla l'impostazione Valuta in cima alla pagina. Deve corrispondere alla valuta del paese in cui è registrato il tuo account Paystack. Ad esempio, un account kenyano necessita dello Scellino kenyano (KES).
Nota: Ogni account Paystack elabora i pagamenti in un'unica valuta, impostata dal paese scelto al momento dell'iscrizione. Se la valuta di WPForms non corrisponde, vedrai un avviso nelle impostazioni di pagamento e i pagamenti non andranno a buon fine finché le valute non corrisponderanno.
Successivamente, scorri verso il basso fino alla sezione Paystack. Incolla la tua chiave segreta nel campo Live Secret Key. Quindi incolla la tua chiave pubblica nel campo Live Public Key.
Al termine, fai clic su Salva impostazioni.
WPForms verifica la tua chiave segreta con Paystack e controlla che entrambe le chiavi appartengano alla modalità in cui ti trovi. Se una chiave è digitata in modo errato o appartiene all'altra modalità, vedrai subito un errore. Le chiavi Live iniziano con sk_live_ e pk_live_, mentre le chiavi di test iniziano con sk_test_ e pk_test_. Quando la connessione funziona, lo stato della connessione indica Connesso a Paystack in modalità Live.
Nota: La modalità di test e la modalità live utilizzano ciascuna la propria coppia di chiavi. Per provare l'integrazione Paystack del tuo modulo prima di accettare pagamenti reali, consulta la sezione Testare i pagamenti Paystack di seguito.
Configurare i webhook di Paystack
I webhook sono il modo in cui Paystack informa il tuo sito sugli aggiornamenti dei pagamenti che si verificano dopo che un cliente ha inviato il tuo modulo. Ad esempio, un webhook informa WPForms quando arriva un bonifico bancario o quando rimborsi un pagamento dal tuo dashboard Paystack.
Paystack non consente a WPForms di aggiungere un webhook per te, quindi dovrai copiare un URL da WPForms e incollarlo tu stesso nel tuo dashboard Paystack. Richiede solo un minuto e devi farlo solo una volta per ogni modalità.
Dopo aver salvato le tue chiavi, appariranno 2 nuove impostazioni nella sezione Paystack. Lascia attiva l'opzione Abilita Webhook. Quindi fai clic sull'icona di copia accanto al campo Endpoint Webhook per copiare il tuo URL webhook.
Ora torna alla pagina Chiavi API e Webhook nel tuo dashboard Paystack. Incolla l'URL nel campo URL Webhook Live. Quindi fai clic su Salva modifiche.
WPForms riceverà ora gli aggiornamenti dei pagamenti da Paystack.
Nota: Paystack mantiene impostazioni webhook separate per la modalità di test e la modalità live, ma WPForms utilizza lo stesso URL per entrambe. Se stai testando prima, incolla l'URL nel campo URL Webhook di test. Se utilizzi entrambe le modalità, aggiungilo a entrambi i campi.
Aggiungere Paystack ai tuoi moduli
Dopo aver collegato il tuo account, sei pronto per accettare pagamenti nei tuoi moduli. Per iniziare, crea un nuovo modulo o modifica uno esistente per aprire il generatore di moduli.
Il tuo modulo richiede almeno un campo di pagamento che imposti un importo, come Articolo singolo, Articoli multipli, Articoli checkbox o Articoli menu a discesa. Richiede anche un campo Email, poiché Paystack necessita dell'indirizzo email del cliente. Non c'è un campo Paystack separato da aggiungere. Paystack raccoglie i dettagli del pagamento nel proprio popup quando il modulo viene inviato.
Successivamente, vai su Pagamenti » Paystack nel generatore di moduli e attiva l'interruttore Abilita pagamenti Paystack.
Quindi compila le impostazioni per i pagamenti di questo modulo:
- Descrizione pagamento: Una breve descrizione del pagamento, come il nome del tuo prodotto o servizio. Appare nei dettagli del pagamento nella tua dashboard Paystack.
- Email cliente: Il campo nel tuo modulo che contiene l'indirizzo email del cliente. Questa impostazione è obbligatoria. Paystack necessita di un indirizzo email per creare il pagamento e invia la ricevuta a questo indirizzo.
- Nome cliente: Il campo nel tuo modulo che contiene il nome del cliente. Appare nei dettagli del pagamento nella tua dashboard Paystack.
Se il tuo modulo ha già un campo Email e un campo Nome, WPForms li seleziona per te.
Nota: I pagamenti Paystack richiedono l'invio del modulo tramite AJAX, che è attivo per impostazione predefinita per i nuovi moduli. Se è disattivato, WPForms ti ricorderà quando salvi il modulo. Per riattivarlo, vai su Impostazioni » Generali, apri la sezione Avanzate e seleziona Abilita invio modulo AJAX.
Al termine, salva il tuo modulo. Ora è pronto per accettare pagamenti.
Come i clienti pagano con Paystack
Quando un cliente invia il tuo modulo, si apre un popup Paystack sopra la pagina. Il modulo viene inviato solo dopo che il pagamento è andato a buon fine.
Le opzioni di pagamento nel popup dipendono dalla valuta del tuo account Paystack:
- Naira nigeriana (NGN): Carta e bonifico bancario
- Cedi ghanese (GHS): Carta e mobile money
- Scellino keniota (KES): Carta e mobile money
- Rand sudafricano (ZAR): Carta
Una volta che il pagamento ha successo, il popup si chiude e il cliente visualizza il messaggio di conferma del tuo modulo.
Testare i pagamenti Paystack
Prima di iniziare ad accettare pagamenti reali, è una buona idea eseguire tu stesso un pagamento tramite il tuo modulo. La modalità di test di Paystack ti consente di completare l'intero flusso senza che vengano spostati soldi.
Attivare la modalità di test
Per assicurarti che nessun pagamento reale venga elaborato mentre stai testando, vai su WPForms » Impostazioni e fai clic sulla scheda Pagamenti.
Sotto Paystack, attiva l'interruttore Modalità di test. I campi Chiave segreta di test e Chiave pubblica di test appariranno al posto di quelli live.
Nota: La modalità di test e la modalità live sono configurate separatamente, quindi dovrai aggiungere le tue chiavi di test qui anche se hai già collegato le tue chiavi live. WPForms te lo ricorderà quando cambi modalità.
Successivamente, torna alla pagina Chiavi API e Webhook nella tua dashboard Paystack. Se la tua dashboard è in Modalità Live, usa l'interruttore in alto a destra della dashboard per passare alla Modalità di test.
Copia la tua Chiave Segreta di Test e incollala nel campo Chiave Segreta di Test in WPForms. Poi fai lo stesso per la tua Chiave Pubblica di Test.
Fai clic su Salva Impostazioni. Lo Stato della Connessione mostrerà Connesso a Paystack in modalità Test.
Per ricevere webhook durante il test, incolla anche l'URL del tuo Endpoint Webhook nel campo URL Webhook di Test nella tua dashboard Paystack.
Effettuare un pagamento di prova
Successivamente, apri una pagina con il tuo modulo Paystack e compilala come farebbe un cliente. Poi invia il modulo per aprire il popup di Paystack.
In modalità di test, l'opzione Carta mostra scenari di test invece dei campi della carta. Seleziona Successo e fai clic sul pulsante Paga per completare un pagamento di test andato a buon fine. Per vedere come il tuo modulo gestisce un pagamento fallito, scegli invece Rifiutato.
Per inserire tu stesso i dettagli della carta, fai clic su Usa un'altra carta e utilizza una delle carte di test di Paystack. Ad esempio, il numero di carta 4084 0840 8408 4081 con CVV 408 e una data di scadenza futura qualsiasi completa un pagamento andato a buon fine. La stessa pagina elenca anche i numeri di test per i pagamenti tramite mobile money e bonifici bancari.
Visualizzare i tuoi pagamenti di prova
Per trovare i tuoi pagamenti di test, vai su WPForms » Pagamenti e attiva l'interruttore Dati di Test.
Fai clic su un pagamento per vederne i dettagli. Da lì, il link Visualizza in Paystack apre la transazione nella tua dashboard Paystack.
Per saperne di più sui dettagli dei pagamenti, sugli stati e sulle tendenze, consulta la nostra guida alla visualizzazione e gestione dei pagamenti.
Impostazione della logica condizionale (facoltativo)
La logica condizionale ti consente di decidere quando elaborare un addebito Paystack, in base a ciò che il cliente seleziona nel tuo modulo. Ad esempio, potresti voler addebitare solo ai clienti che scelgono un'opzione a pagamento.
Per configurare questo, vai su Pagamenti » Paystack nel costruttore di moduli e attiva Abilita Logica Condizionale. Quindi crea la regola che decide quando elaborare l'addebito.
Per ulteriori esempi, consulta il nostro tutorial sull'utilizzo della logica condizionale.
Domande frequenti
Di seguito, abbiamo risposto ad alcune delle domande più comuni sull'utilizzo del componente aggiuntivo Paystack.
Quali paesi e valute posso utilizzare con il componente aggiuntivo Paystack?
Il componente aggiuntivo funziona con account Paystack registrati in Nigeria, Ghana, Kenya e Sudafrica. Ogni account elabora i pagamenti nella valuta del proprio paese: Naira nigeriana (NGN), Cedi ghanese (GHS), Scellino keniota (KES) o Rand sudafricano (ZAR). Imposta la valuta corrispondente in WPForms » Impostazioni » Pagamenti.
Perché il mio pagamento Paystack è contrassegnato come in sospeso?
I bonifici bancari e i pagamenti tramite mobile money possono richiedere un po' più di tempo per essere confermati rispetto ai pagamenti con carta. Se un cliente sceglie una di queste opzioni e chiude il popup prima che Paystack confermi il pagamento, WPForms salva l'inserimento e contrassegna il pagamento come In Sospeso.
Fino a quando il pagamento non è confermato, WPForms trattiene le email di notifica del modulo. Attende inoltre l'attivazione degli account creati con il componente aggiuntivo User Registration e il conteggio dell'utilizzo di eventuali coupon. Una volta che Paystack conferma il pagamento, WPForms lo contrassegna come Completato e termina questi passaggi. Con i webhook configurati, ciò richiede solitamente pochi secondi. Senza di essi, può richiedere fino a 30 minuti.
Devo configurare i webhook?
Lo consigliamo. Senza webhook, WPForms controlla Paystack ogni 15 minuti e aggiorna i pagamenti ancora in attesa, quindi i bonifici bancari e i pagamenti tramite mobile money vengono comunque completati. I pagamenti con carta rimangono Elaborati per un massimo di 30 minuti finché quel controllo non li contrassegna come Completati. Tuttavia, i rimborsi effettuati nella dashboard di Paystack non verranno sincronizzati con WPForms.
Se WPForms rileva che i pagamenti vengono aggiornati solo tramite questi controlli, mostra un avviso nella tua bacheca di WordPress che ti chiede di controllare la configurazione dei webhook. Per risolvere il problema, copia l'URL dell' Endpoint Webhook da WPForms » Impostazioni » Pagamenti nel campo URL Webhook per la modalità che stai utilizzando nella tua dashboard Paystack.
Perché il mio modulo dice "I pagamenti non sono attualmente disponibili"?
Questo messaggio viene visualizzato quando WPForms non è in grado di elaborare un pagamento Paystack sul tuo modulo. Ecco le cause più comuni e come risolverle:
- Paystack non è connesso nella modalità corrente: ad esempio, la modalità di test è attiva, ma non sono state salvate chiavi di test. Vai su WPForms » Impostazioni » Pagamenti e aggiungi le chiavi per la modalità che stai utilizzando.
- Le valute non corrispondono: Paystack elabora i pagamenti solo nella valuta del tuo account, quindi la modifica della valuta di WPForms mette in pausa i pagamenti. Reimposta la valuta in modo che corrisponda al tuo account Paystack.
- L'invio del modulo AJAX è disattivato: i pagamenti Paystack richiedono l'invio del modulo AJAX e alcuni modelli di modulo, inclusi i modelli di registrazione utente, lo disattivano per impostazione predefinita. Per attivarlo, apri Impostazioni » Generali del tuo modulo, espandi Avanzate e seleziona Abilita invio modulo AJAX.
Perché vedo "L'importo del pagamento è inferiore al minimo consentito"?
Paystack imposta un importo minimo per ogni valuta e WPForms controlla il totale prima di aprire il popup. I minimi sono NGN 50, GHS 0,10, KES 3 e ZAR 1. Se il totale del tuo modulo può scendere al di sotto di questo importo, regola i tuoi prezzi o utilizza la logica condizionale per saltare l'addebito per quegli ordini.
WPForms memorizza i dettagli della carta dei miei clienti?
No. Il popup di Paystack è ospitato da Paystack, quindi i dettagli della carta vanno direttamente a Paystack e non toccano mai il tuo sito. WPForms salva solo il record di pagamento, insieme al marchio della carta e alle ultime 4 cifre per tuo riferimento.
Questo è tutto! Ora puoi accettare pagamenti con carta, bonifico bancario e mobile money tramite il componente aggiuntivo WPForms Paystack.
Successivamente, vuoi tenere d'occhio i pagamenti che arrivano tramite i tuoi moduli? Dai un'occhiata alla nostra guida per visualizzare e gestire i pagamenti per saperne di più sui dettagli dei pagamenti, sugli stati e sui rimborsi.
