Estensioni precedentiObsoleto
Stripe Apps sostituisce le estensioni
Non puoi più creare nuove estensioni Stripe. Stripe Apps sostituisce le estensioni per lo sviluppo su Stripe. Le estensioni esistenti continueranno comunque a funzionare fino al 2024. Se hai già un’estensione, ti consigliamo di fare il passaggio a Stripe Apps.
Nota
Ora puoi inviare automaticamente i tuoi dati e report Stripe a Snowflake o ad Amazon Redshift in pochi clic con Stripe Data Pipeline. Ulteriori informazioni.
I prodotti e le funzionalità di Stripe consentono alle aziende di accettare pagamenti online, ma esistono anche altri motivi per cui creare un’integrazione. Le aziende come Baremetrics e Segment si avvalgono delle risorse di Stripe per fornire i propri servizi agli account Stripe che dispongono di una Dashboard Standard.
La procedura di creazione di un’estensione per Stripe è costituita da quattro passaggi:
- Configurare OAuth e specificare un URI di reindirizzamento.
- Configurare le impostazioni di branding.
- Creare un link OAuth per gli utenti.
- Usare l’API per conto degli account connessi.
Se non l’hai già fatto, per attivare l’account dovrai anche aggiungere i dati relativi alla tua azienda.
Per iniziare, visita la pagina dedicata alle estensioni che si trova nella scheda Sviluppatori della dashboard di Stripe.
Configurare OAuth e specificare un URL di reindirizzamento
Puoi configurare questa impostazione nella sezione Integrazione della pagina Impostazioni delle estensioni.
Inizia a effettuare l’integrazione servendoti del pulsante per abilitare l’attivazione degli account Standard con OAuth. Le estensioni non dovrebbero utilizzare OAuth con gli account Express.
Stripe fornisce un identificativo univoco per la tua estensione chiamato client_id
. Il redirect_uri
è impostato da te e, dopo aver collegato il proprio account, gli utenti vengono indirizzati su quella pagina. Devi specificare tutti gli URI di reindirizzamento nelle impostazioni della tua estensione. Le versioni di sviluppo e di produzione di questi due valori semplificano l’esecuzione dei test. Annota questi valori in modo da poter creare un link OAuth nel terzo passaggio.
Configurare le impostazioni di branding
Puoi personalizzare il modo in cui la tua attività appare agli utenti nella sezione Branding della pagina Impostazioni delle estensioni.
Gli utenti vedono il tuo logo quando collegano i propri account Stripe alla tua applicazione. Una volta collegati gli account, la tua icona viene visualizzata nel loro elenco delle applicazioni collegate.
Creare un link OAuth per gli utenti
Stripe offre un flusso OAuth 2.0 standard per il collegamento degli account Stripe. Usando i valori client_id
e redirect_uri
ottenuti nel primo passaggio, puoi creare un link OAuth che gli utenti possono usare per l’attivazione. Consigliamo di mostrare questo link con un pulsante Connettiti con Stripe che indirizza gli utenti al nostro endpoint authorize_url
:
https://connect.stripe.com/oauth/authorize?response_type=code&client_id=ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb&scope=read_only
Ecco un esempio di come mostrare il link riportato sopra agli utenti, insieme al pulsante Connettiti con Stripe:
Connettiti conUna volta che il cliente avrà fatto clic sul link sul tuo sito, lo reindirizzeremo a una pagina che permette o nega il collegamento alla tua estensione. Nel flusso di autorizzazione di Stripe, all’utente viene chiesto di scegliere un account esistente da collegare all’estensione, oppure di crearne uno nuovo.
Quando il cliente avrà collegato il suo account esistente o quello appena creato alla tua estensione, lo reindirizzeremo di nuovo all’URL che hai impostato come redirect_uri
dell’estensione.
Al termine del flusso di lavoro OAuth, ti vengono fornite le credenziali di autorizzazione per l’account dell’utente:
{ ... "stripe_user_id": "acct_0123456789", ... }
Devi salvare lo stripe_user_id
in modo da identificare gli account utente.
Usare l'API per conto degli account connessi
Una volta che gli utenti hanno collegato i propri account Stripe alla tua applicazione, puoi effettuare richieste API per conto loro. Per eseguire richieste API, occorre la chiave privata dell’account della tua estensione e un’intestazione Stripe-Account
che identifichi l’account per il quale stai effettuando la richiesta. Tutte le librerie Stripe sono compatibili con questo tipo di autenticazione in base alla richiesta.
Recuperare i dati salvati
I dati salvati includono informazioni quali addebiti e dettagli del cliente. Con l’accesso read_only
puoi eseguire la maggior parte delle richieste GET
nell’API di Stripe. Puoi recuperare un singolo oggetto (come recuperare un Payment Intent) o un elenco di oggetti (ad esempio elencare tutti i Payment Intent).
Mentre l’API opera ad alti livelli, il recupero ripetuto di set di dati di grandi dimensioni rallenta la velocità di risposta della tua applicazione. Consigliamo di salvare i dati recuperati sui tuoi sistemi per l’analisi e la reportistica.
Essere in ascolto di dati in tempo reale
Oltre ai dati salvati, puoi accedere ai dati in tempo reale tramite i webhook. Una volta definito un endpoint del webhook dell’estensione nell’account, Stripe invia notifiche degli eventi all’endpoint per ogni account connesso. La proprietà account
dell’oggetto event identifica l’account in cui si è verificato l’evento.
Ad esempio, l’evento riportato di seguito indica che è stato creato un cliente nell’account acct_0123456789
. Anche in questo caso, consigliamo di salvare i dati sui tuoi sistemi per l’analisi e la reportistica. Osservando gli eventi nel momento in cui si verificano, l’applicazione può rispondere più rapidamente e non sarà necessario effettuare numerose chiamate API.
{ "id": "evt_mWX1ScyEsLSis8", "livemode": true, "object": "event", "type": "customer.created", "account": "acct_0123456789", "pending_webhooks": 2, "created": 1349654313, "data": {...} }
Addebitare un costo per la tua applicazione
L’account Stripe della tua estensione può elaborare i propri addebiti; puoi quindi addebitare un costo per l’applicazione anche con l’accesso di tipo read_only
. Una volta che i clienti hanno collegato i propri account Stripe, chiedi loro i dettagli di pagamento e crea un abbonamento per loro nel tuo account Stripe. Salva l’ID cliente creato con l’ID dell’account Stripe associato, in modo da poter distinguere gli utenti che vengono pagati e sono attivi dagli altri utenti.
Se crei abbonamenti, puoi anche specificare un valore application_fee_percent
come commissione per l’applicazione. Questo importo viene addebitato in aggiunta alle altre commissioni Stripe. Per ulteriori informazioni, consulta la documentazione sugli abbonamenti.
Account scollegati
Gli utenti possono scollegare i propri account dalla tua integrazione in qualsiasi momento. In tal caso, Stripe invia un webhook account.application.deauthorized
. Puoi utilizzare questa notifica per attivare la pulizia sui tuoi sistemi, ad esempio disattivando l’account dell’utente sul tuo sito o rimuovendo i suoi dati.
Puoi anche scollegare gli account dalla tua integrazione effettuando una richiesta all’endpoint di annullamento dell’autorizzazione OAuth.