In questa storia
Dove: Impostazioni → Lettori e denaro → Connessioni → Pagamenti
Apri questa pagina: admin.<your-site>/settings/connections/payments (sostituisci <your-site> con l'indirizzo del tuo sito)
Prima di iniziare
- Prima collega Razorpay, Stripe o PayPal. Vedi Pagamenti.
- Devi essere il proprietario del sito.
Procedura
Stripe e PayPal: quando possibile, Keynate configura automaticamente i messaggi di pagamento nel tuo account. La scheda indicherà "I messaggi di pagamento sono stati configurati in Stripe per te". Se l'operazione non riesce, mostrerà "Manca un passaggio" e il pulsante Completa configurazione. Segui i passaggi riportati di seguito.
Razorpay: non può essere configurato in automatico. La scheda di Razorpay mostra una procedura guidata in 3 passaggi con un controllo in tempo reale: la scritta In attesa del primo messaggio di Razorpay… diventa Abbiamo ricevuto il primo messaggio di Razorpay. dopo la ricezione del primo pagamento, di prova o reale. Premi Controlla ora per verificare nuovamente. Vedi Collega Razorpay.
Ecco i passaggi validi per qualsiasi gateway:
- Apri Impostazioni → Lettori e ricavi → Connessioni → Pagamenti.
- Nella scheda del tuo gateway, individua il riquadro Webhook.
- Premi Apri webhook (il nome del pulsante indica il tuo gateway). La dashboard del gateway si aprirà in una nuova scheda.
- All'interno del gateway, premi Aggiungi.
- Torna su Keynate, premi Copia accanto a URL del webhook e incollalo nel gateway.
- Seleziona gli eventi elencati nel riquadro di Keynate.
- Razorpay: premi Copia sul codice segreto e incollalo come secret. Usa un secret diverso per la modalità di prova e quella reale.
- Salva le modifiche nel gateway.
- Dopo il salvataggio, Stripe e PayPal mostrano un codice. Stripe lo chiama chiave di firma (signing secret) e inizia con
whsec_. PayPal lo chiama Webhook ID. Copialo e incollalo nella casella corrispondente su Keynate. - Premi Verifica connessione.
Da sapere
- La modalità di prova e quella reale richiedono ciascuna il proprio webhook.
- Se perdi il codice segreto, aggiungi un nuovo webhook nel gateway e incolla il nuovo codice.
Problemi frequenti
- "Incolla il secret del webhook inserito in Razorpay." La casella su Keynate è vuota. Incolla lo stesso codice segreto inserito su Razorpay.
- "Usa un webhook secret diverso per test e live." Crea un nuovo secret per la seconda modalità.
- "Incolla la chiave di firma del webhook. Inizia con whsec_." Copiala da Stripe dopo aver aggiunto l'endpoint.
- "Incolla il Webhook ID (solo lettere e numeri)." Copia l'ID dall'elenco dei webhook nella tua app PayPal.
- Razorpay mostra ancora "In attesa del primo messaggio di Razorpay…". Esegui un piccolo pagamento di prova. Il messaggio arriverà subito dopo. Poi premi Controlla ora.
- Un ordine risulta non pagato anche se il lettore ha effettuato il pagamento. Il webhook è assente o non corretto. Ogni notte Keynate confronta i tuoi ordini con il gateway e sistema quelli non registrati.
Domande frequenti
Domande frequenti
È la stessa cosa di una chiave API?
No. Le chiavi permettono a Keynate di comunicare con il gateway. Il webhook consente al gateway di comunicare con Keynate.
Serve un webhook sia per i test che per la modalità reale?
Sì. La modalità di prova e quella reale richiedono ciascuna un proprio webhook.
Cosa succede se perdo il codice segreto?
Aggiungi un nuovo webhook nella piattaforma di pagamento e incolla il nuovo codice su Keynate.
Cosa posso fare se un ordine risulta non pagato anche se il lettore ha pagato?
Il webhook non è configurato o non è corretto. Ogni notte Keynate confronta comunque gli ordini con il gateway e sistema quelli persi.