Guida all’integrazione delle Stripe Apps

Le Stripe Apps ti permettono di integrare funzionalità personalizzate direttamente nella dashboard di Stripe. Questa sezione è una guida alla realizzazione: documenta come si costruirebbe, testerebbe e pubblicherebbe un’app di questo tipo per l’integrazione Tajo–Brevo.

Cosa sono le Stripe Apps

Le Stripe Apps estendono la dashboard di Stripe con componenti di interfaccia personalizzati e integrazioni backend. Permettono agli sviluppatori terzi di:

• Aggiungere viste personalizzate alle pagine della dashboard di Stripe (clienti, pagamenti, fatture e altro)
• Accedere ai dati di Stripe tramite permessi circoscritti
• Sincronizzare dati tra Stripe e piattaforme esterne come Brevo
• Offrire flussi di onboarding e configurazione dentro la dashboard

Obiettivi dell’integrazione Tajo + Brevo

L’app Stripe di Tajo collega Stripe a Brevo per offrire:

• Customer intelligence: sincronizza profili cliente, cronologia dei pagamenti e lifetime value di Stripe nei contatti Brevo
• Tracciamento degli eventi: invia gli eventi Stripe (pagamenti, abbonamenti, rimborsi) come eventi transazionali Brevo
• Campagne automatizzate: attiva campagne email, SMS e WhatsApp di Brevo in base all’attività su Stripe
• Programmi fedeltà: costruisci workflow di retention usando i dati di acquisto Stripe sincronizzati in Brevo

Panoramica dell’architettura

Contenuti della guida

Questa documentazione copre l’intero ciclo di vita della creazione e pubblicazione di una Stripe App:

Per iniziare

Configurazione e riferimenti

Funzionalità e integrazione

Operatività e crescita

Prerequisiti

Prima di creare una Stripe App, assicurati di avere:

1. Account Stripe: un account Stripe attivato (non limitato alla modalità test)
2. Stripe CLI: installa la Stripe CLI per lo sviluppo locale e il caricamento delle app
3. Node.js: versione 16 o successiva per la UI extension dell’app
4. Accesso alla piattaforma Tajo: account Tajo attivo con le credenziali API di Brevo configurate

Avvio rapido

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Concetti chiave

Manifest dell’app

Ogni Stripe App ha un manifest stripe-app.json che dichiara permessi, viewport e configurazione. Vedi il riferimento del manifest dell’app per lo schema completo.

UI extension

Le Stripe Apps possono renderizzare componenti di interfaccia basati su React in viewport specifici della dashboard. Il toolkit di interfaccia offre componenti pronti all’uso, allineati al design system della dashboard di Stripe.

Permessi

Le app devono dichiarare le risorse API di Stripe a cui hanno bisogno di accedere. Gli utenti approvano questi permessi durante l’installazione. Vedi il riferimento dei permessi.

Segreto di firma

Ogni app riceve un segreto di firma per verificare le firme di installazione e proteggere la comunicazione tra il tuo backend e Stripe.

Flusso di sviluppo

1. Definisci il tuo manifest con i permessi e i viewport necessari
2. Costruisci la UI extension con la libreria di componenti React di Stripe
3. Implementa gli endpoint backend per la sincronizzazione dei dati con Brevo tramite Tajo
4. Testa in locale con stripe apps start
5. Carica con stripe apps upload
6. Sottoponi alla revisione dalla dashboard di Stripe
7. Pubblica e monitora tramite le analytics

Passaggi successivi

Parti dalla guida alla pubblicazione per capire tutti i requisiti, poi lavora sui riferimenti tecnici per configurare il manifest e i permessi della tua app.