Questa guida illustra come creare un account Stripe, verificare la tua email e individuare la chiave API e il segreto webhook che utilizzerai per aggiungere un account merchant Stripe in Perno Orchestration.
A cosa serve un account Stripe?
Un account Stripe è ciò di cui hai bisogno prima di poter collegare Stripe come gateway per un account merchant in Perno Orchestration - è in Stripe che vengono generati la chiave API e il segreto webhook utilizzati in quella connessione. I nuovi account partono in una sandbox, un ambiente di test in cui puoi esplorare il pannello e generare chiavi API di prova senza movimentare denaro reale; passi a un account live solo quando sei pronto per operare realmente.
Creazione del tuo account Stripe
- Vai su stripe.com e fai clic su Dashboard nell'angolo in alto a destra.
- Compila Email, Nome completo e Password, scegli il tuo Paese, quindi fai clic su Create account.
Verifica della tua email
Stripe invia un link di verifica all'indirizzo con cui ti sei registrato. Aprendolo confermi che l'indirizzo è tuo e completi la creazione dell'account:
Configurazione del tuo profilo aziendale
- Inserisci Nome dell'attività e Sede dell'attività, quindi fai clic su Continue.
- Facoltativamente aggiungi il tuo Sito web e una breve descrizione dell'attività della tua azienda. Fai clic su Continue, oppure su Skip se preferisci compilarlo più tardi.
Scelta della modalità di configurazione di Stripe
Stripe offre due modi per iniziare: la configurazione manuale nel Dashboard, oppure iniziare con uno strumento di coding AI. Seleziona Set up in the Dashboard e fai clic su Continue:
Accesso alla tua sandbox
Il tuo nuovo account si apre in una sandbox - un ambiente sicuro per i test in cui non viene movimentato denaro reale. Dopo aver esplorato la sandbox e completato la configurazione, potrai passare a un account live quando sarai pronto ad accettare pagamenti reali. Fai clic su Go to sandbox per continuare:
Individuazione delle tue chiavi API
Stripe genera automaticamente una chiave pubblicabile (publishable key) e una chiave segreta (secret key) per il tuo account. Puoi raggiungerle in due modi:
- Dalla pagina Home, il pannello delle chiavi API mostrato dopo il primo accesso rimanda direttamente ad esse.
- Oppure fai clic sull'icona Settings (ingranaggio) nella barra di navigazione superiore, quindi seleziona Developers sotto Personal settings.
- Nella pagina Developers, fai clic su Manage API keys accanto alla riga API keys.
Verifica delle tue chiavi API
La pagina delle chiavi API elenca due sezioni: Restricted keys (chiavi con restrizioni), che crei tu stesso con limiti di accesso specifici, e Standard keys (chiavi standard), che Stripe genera automaticamente e che hanno accesso completo all'API:
Scorri verso il basso per vedere entrambe le chiavi standard per intero - la Publishable key e la Secret key:
Tratta la Secret key come una password - chiunque la possieda può agire sul tuo account, quindi non condividerla né includerla nel tuo codice. Quando aggiungi un account merchant Stripe in Perno Orchestration, questa Secret key è ciò che inserisci come Dati API n. 1.
Individuazione del tuo segreto webhook
Il segreto webhook utilizzato per i Dati API n. 2 non si trova nella pagina delle chiavi API - viene generato separatamente, per ogni destinazione degli eventi, in Workbench.
- Apri Workbench e passa alla scheda Webhooks, quindi fai clic su + Add destination. In alternativa, usa la barra Search nella navigazione superiore, digita webhooks e seleziona Create a webhook sotto Workbench.
Selezione degli eventi
- Scegli l'Event destination scope (ambito della destinazione degli eventi): Your account per gli eventi provenienti da risorse nel tuo account, oppure Connected accounts per gli eventi provenienti da risorse all'interno di account collegati al tuo. Per una configurazione a singolo account, come un account merchant Perno, scegli Your account.
- Scegli la API version che la destinazione dovrà utilizzare, quindi seleziona a quali Events iscriverti - seleziona Select all per ricevere ogni evento, oppure cerca eventi specifici. Stripe avverte che selezionare un numero elevato di eventi può influire sulle prestazioni; per l'analisi dei dati, anziché per attivare integrazioni, suggerisce di usare invece Data Pipeline. Fai clic su Continue.
Scelta del tipo di destinazione
Stripe può inviare gli eventi a un endpoint webhook, Amazon EventBridge o Azure Event Grid. Seleziona Webhook endpoint e fai clic su Continue:
Configurazione della destinazione
- Inserisci un Destination name (nome della destinazione), l'Endpoint URL a cui inviare gli eventi e una Description (descrizione) opzionale. Scegli Snapshot payload, Thin payload o entrambi - Stripe crea una destinazione separata, ciascuna con il proprio segreto webhook, per ogni tipo di payload selezionato. Fai clic su Continue.
- Nella schermata Review and finish, ogni destinazione configurata viene elencata con le relative impostazioni.
Copia del segreto di firma
Una volta creata una destinazione, il suo Signing secret (segreto di firma) - il segreto webhook - viene mostrato per intero, una destinazione alla volta. Copialo subito: se lo consulti di nuovo in seguito vedrai solo un valore mascherato. Fai clic su Done una volta copiato:
Se ti serve di nuovo in seguito, apri Workbench > Webhooks, seleziona la destinazione e trova Signing secret nella sua scheda Overview. È mascherato per impostazione predefinita - fai clic sull'icona a forma di occhio per rivelarlo, oppure sull'icona di aggiornamento per generarne uno nuovo, il che invalida quello precedente:
Quando aggiungi un account merchant Stripe in Perno Orchestration, questo segreto webhook è ciò che inserisci come Dati API n. 2.