---
title: "Guida all’integrazione delle Stripe Apps | Tajo"
description: "Stato: pianificata, non realizzata. Questa sezione è una guida alla realizzazione. Tajo non ha un’app Stripe e oggi nulla di quanto descritto qui può essere installato."
url: https://tajo.io/it/docs/stripe-apps/
markdown: https://tajo.io/it/docs/stripe-apps.md
lang: it-IT
author: "Set Noa"
author_url: https://tajo.io/it/set-noa/
robots: noindex
---

Richiedi l’accesso anticipato

Inserisci il tuo nome e indirizzo email aziendale. Ti invieremo un link per confermare la richiesta di accesso a Tajo.

# Guida all’integrazione delle Stripe Apps

[Set Noa](https://tajo.io/it/set-noa/)

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.

Caution

**Stato: pianificata, non realizzata.** Tajo non ha un’app Stripe, quindi oggi nulla di questa sezione può essere installato, e gli identificatori dell’app, gli URL e le credenziali presenti in queste pagine sono segnaposto illustrativi, non endpoint reali. Per collegare Stripe a Tajo fin da subito, usa il [connettore Stripe](https://tajo.io/docs/connectors/stripe/) (API key ristretta, sincronizzazione in sola lettura).

Tip

L’obiettivo è pubblicare un’**integrazione Brevo** nello Stripe App Marketplace, permettendo ai merchant Stripe di sincronizzare dati dei clienti, ordini ed eventi direttamente in Brevo per l’automazione del marketing e il CRM.

## 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

*Dove vanno i dati di un’app Stripe. La dashboard di Stripe e Tajo si scambiano dati di clienti e pagamenti, e Tajo sincronizza contatti, campagne e automazioni con Brevo.*

## Contenuti della guida

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

### Per iniziare

| Guida | Descrizione |
| --- | --- |
| [Pubblicazione nel Marketplace](https://tajo.io/it/docs/stripe-apps/publish-app) | Requisiti e passaggi per sottoporre la tua app alla revisione |
| [Requisiti di revisione dell’app](https://tajo.io/it/docs/stripe-apps/review-requirements) | Standard di qualità, sicurezza ed esperienza utente per l’approvazione |

### Configurazione e riferimenti

| Guida | Descrizione |
| --- | --- |
| [Riferimento del manifest dell’app](https://tajo.io/it/docs/stripe-apps/app-manifest) | Schema completo del file manifest `stripe-app.json` |
| [Riferimento dei permessi](https://tajo.io/it/docs/stripe-apps/permissions) | Elenco completo dei permessi API di Stripe e come richiederli |
| [Riferimento dei viewport](https://tajo.io/it/docs/stripe-apps/viewports) | Punti della dashboard in cui può comparire l’interfaccia della tua app |

### Funzionalità e integrazione

| Guida | Descrizione |
| --- | --- |
| [Stripe Apps incorporate](https://tajo.io/it/docs/stripe-apps/embedded-apps) | Usare i componenti incorporati di Connect per le integrazioni di piattaforma |
| [Link di installazione e deep link](https://tajo.io/it/docs/stripe-apps/install-links) | Generare URL di installazione e deep link verso viste specifiche dell’app |
| [Azioni post-installazione](https://tajo.io/it/docs/stripe-apps/post-install) | Configurare i flussi di onboarding dopo l’installazione dell’app |

### Operatività e crescita

| Guida | Descrizione |
| --- | --- |
| [Analytics dell’app](https://tajo.io/it/docs/stripe-apps/analytics) | Monitorare installazioni, visualizzazioni e metriche di conversione |

## 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

```bash
# 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](https://tajo.io/it/docs/stripe-apps/app-manifest) 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](https://tajo.io/it/docs/stripe-apps/permissions).

### 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

Caution

Stripe richiede che le app siano scritte in inglese per la distribuzione nel marketplace. La scheda della tua app, i testi dell’interfaccia e la documentazione devono essere tutti in inglese.

## Passaggi successivi

Parti dalla [guida alla pubblicazione](https://tajo.io/it/docs/stripe-apps/publish-app) per capire tutti i requisiti, poi lavora sui riferimenti tecnici per configurare il manifest e i permessi della tua app.