La Stripe CLI è lo strumento ufficiale per testare l’implementazione di stripe nei nostri sistemi, in modo sicuro e agevole. Ti faccio vedere come configurarla rapidamente per gestire stripe webhooks.
Perché Stripe CLI
Attraverso la Stripe CLI, possiamo:
- Testare webhooks senza la necessità di servizi di terze parti per il tunneling della connessione.
- Triggerare webhooks per testare la nostra implementazione
- Visualizzare i registri log delle API in tempo reale
- Creare, ottenere, aggiornare ed eliminare oggetti API
Per iniziare dobbiamo eseguire alcuni semplici step.
Rechiamoci al seguente link, e scarichiamo l’ultima versione compatibile con il nostro sistema operativo.
Io seguirò la procedura per Utenti Windows.
Entro nella cartella appena estratta, contenente l’eseguibile che deve essere eseguito da riga di comando (cmd windows).
Possiamo pensare di aggiungere l’eseguibile alle variabili globali, ma onde evitare di riavviare il computer, limitiamoci a questo
Login
Per prima cosa eseguiamo il login, quindi digitiamo
stripe login
Sarà generato un pairing code e ci verrà richiesto di aprire una schermata dal browser. Accettiamo dando invio.
Permettiamo l’accesso cliccando su Allow Access dopo esserci assicurati che il pairing code sia corretto.
L’API key generata ha una validità di 90 giorni, ma ovviamente è possibile modificarla, facendola all’occorrenza scadere prima, dalla Dashboard.
Listen Webhooks Events
Ora assicuriamoci che tutto funzioni correttamente entrando in ascolto dei webhooks, digitando
stripe listen
Il vero punto di forza è un altro.
Stripe CLI ha infatti un’opzione di forwarding con la quale siamo in grado di testare l’implementazione del webhook handling sul nostro server.
Abbiamo quindi creato un controller opportuno e definito una rotta sul server.
Configuriamo ora la CLI affinché indirizzi il traffico sulla porta corretta digitando:
stripe listen --forward-to localhost:5000/hooks
Test Tips: Trigger Events
Stripe crea eventi ogni qualvolta una specifica operazione venga compiuta.
Per ragioni principalmente di test potrebbe essere utile sfruttare le potenzialità del comando:
stripe trigger payment_intent.created
Lanciando il comando su una nuova shell, e sostituendo il payment_intent.created con uno degli eventi presenti nella lista ufficiale è possibile testare qualsivoglia evento.
Stripe CLI Documentazione
Puoi trovare la documentazione qui.
Un caldo abbraccio, Andrea