Pubblicare sullo Stripe App Marketplace

Pubblicare la tua Stripe App sul marketplace la rende disponibile a tutti gli utenti Stripe. Questa guida copre i requisiti, i passaggi di preparazione e il processo di invio.

Prerequisiti

Prima di poter pubblicare un’app sullo Stripe App Marketplace devi soddisfare questi requisiti:

• Account Stripe attivato: il tuo account non può essere limitato alla sola modalità di test
• Una sola app per account: ogni account Stripe può pubblicare una sola app pubblica sul marketplace
• Solo in inglese: tutti i contenuti dell’app, i testi dell’interfaccia e le informazioni della scheda devono essere in inglese
• App completa: la tua app deve essere pienamente funzionante e testata

Passaggi per la pubblicazione

Passaggio 1: aggiorna il manifest

Imposta distribution_type su public nel tuo stripe-app.json:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.0.0",
  "name": "Tajo Brevo Integration",
  "icon": "./icon.png",
  "distribution_type": "public",
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer data to Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    },
    {
      "permission": "event_read",
      "purpose": "Track payment and subscription events for Brevo automation"
    }
  ]
}

Passaggio 2: prepara l’app

Prima di inviarla, assicurati che l’app soddisfi tutti i requisiti di revisione:

1. Testa a fondo sia in modalità live sia in sandbox
2. Verifica che tutti i permessi siano necessari e documentati
3. Conferma di aver implementato la gestione degli errori e gli stati di caricamento
4. Controlla che tutti i testi dell’interfaccia siano in inglese

Passaggio 3: carica l’app

Usa la Stripe CLI per caricare la tua app:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Passaggio 4: scrivi la scheda dell’app

Vai nella dashboard di Stripe per completare la scheda della tua app. Tutti i campi della scheda sono obbligatori per l’invio al marketplace.

Passaggio 5: invia in revisione

Dopo aver completato la scheda, invia l’app in revisione dalla dashboard di Stripe. Il team di Stripe valuterà la tua app rispetto ai requisiti di qualità.

Passaggio 6: pubblica

Una volta approvata, puoi pubblicare l’app per renderla disponibile sul marketplace.

Configurazione del manifest per la distribuzione pubblica

Il manifest deve includere distribution_type: "public" e dichiarare tutti i permessi necessari con motivazioni chiare:

{
  "id": "com.tajo.brevo-integration",
  "version": "1.2.0",
  "name": "Tajo for Brevo",
  "icon": "./assets/icon.png",
  "distribution_type": "public",
  "stripe_api_access_type": "oauth",
  "allowed_redirect_uris": [
    "https://tajo.io/stripe/callback"
  ],
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Write sync metadata to customer records"
    },
    {
      "permission": "charge_read",
      "purpose": "Access payment data for Brevo event tracking"
    },
    {
      "permission": "event_read",
      "purpose": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for campaign personalization"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for Brevo transactional emails"
    }
  ],
  "ui_extension": {
    "views": [
      {
        "viewport": "stripe.dashboard.customer.detail",
        "component": "CustomerDetailView"
      },
      {
        "viewport": "stripe.dashboard.home.overview",
        "component": "OverviewView"
      }
    ]
  },
  "post_install_action": {
    "type": "onboarding"
  }
}

Carica l’app configurata con:

stripe apps upload

Requisiti della scheda

La scheda della tua app deve includere tutti i campi seguenti:

Linee guida per il nome

• Deve essere unico sul marketplace
• Deve indicare con chiarezza a cosa serve la tua app
• Evita termini generici che potrebbero confondere gli utenti
• Esempio: “Tajo for Brevo” (15 caratteri)

Linee guida per l’icona

• Dimensioni: esattamente 300x300 pixel
• Formato: PNG o SVG
• Non aggiungere angoli arrotondati, li applica Stripe automaticamente
• Usa un logo o un simbolo chiaro e riconoscibile
• Assicurati che resti leggibile anche in piccolo

Sezione descrittiva

Scrivi una descrizione convincente che copra:

• Quale problema risolve la tua app
• Le principali capacità di integrazione
• A chi è rivolta l’app
• Eventuali prerequisiti o requisiti

Esempio:

Tajo for Brevo collega i dati di pagamento di Stripe alla piattaforma di marketing automation di Brevo. Sincronizza automaticamente i clienti, traccia gli eventi di pagamento e attiva campagne email, SMS e WhatsApp personalizzate in base al comportamento di acquisto in tempo reale. Pensata per le attività di e-commerce che vogliono massimizzare il valore nel tempo dei clienti con un marketing di retention basato sui dati.

Funzionalità principali

Ogni voce delle funzionalità principali comprende:

• Titolo: nome breve della funzionalità
• Descrizione: una o due frasi che spiegano la funzionalità
• Immagine: screenshot o diagramma (consigliato 1600x900 pixel)

Funzionalità consigliate per l’integrazione Tajo Brevo:

1. Sincronizzazione clienti in tempo reale, sincronizza automaticamente i profili cliente di Stripe nei contatti Brevo con lo storico completo degli acquisti
2. Automazione guidata dagli eventi, attiva workflow di Brevo a partire da eventi Stripe come pagamenti riusciti, modifiche agli abbonamenti e rimborsi
3. Sincronizzazione del catalogo prodotti, mantieni il catalogo prodotti di Brevo allineato a Stripe per personalizzare i contenuti delle campagne
4. Campagne multicanale, usa i dati sincronizzati per alimentare campagne email, SMS e WhatsApp mirate
5. Insight nella dashboard, guarda le metriche di coinvolgimento di Brevo direttamente nella vista cliente della dashboard di Stripe

Informazioni sui prezzi

Comunica con chiarezza il tuo modello di prezzo:

• Gratis: nessun costo per installare o usare l’app
• A pagamento: indica il prezzo e la frequenza di fatturazione
• Freemium: descrivi cosa è incluso gratis e cosa richiede un pagamento
• A consumo: spiega le fasce di prezzo o i costi unitari

Testare la tua app

Prima dell’invio, testa a fondo la tua app:

Testa in modalità sandbox

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

Formato delle credenziali di test

Quando fornisci le credenziali di test al team di revisione, usa questo formato:

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
Password: [secure test password]

Brevo Test API Key: xkeysib-test-xxxxxxxxxxxx

Required Setup Steps:
1. Log in to the Tajo test account
2. Navigate to Settings > Integrations > Brevo
3. The Brevo API key is pre-configured
4. Install the Stripe App from the test link provided

Expected Behavior:
- Customer sync should begin within 60 seconds of installation
- Navigate to any Stripe customer to see Brevo contact data
- Create a test payment to verify event sync to Brevo

Checklist di revisione

Prima di inviare, verifica che:

• L’app funzioni sia in modalità live sia in modalità test
• Tutti i permessi abbiano motivazioni chiare
• Gli stati di errore siano gestiti con eleganza
• Gli stati di caricamento siano mostrati per le operazioni asincrone
• Non ci siano dati di test scritti nel codice della build di produzione
• L’URL dell’informativa sulla privacy sia raggiungibile e corretto
• I contatti di assistenza siano validi
• Tutte le immagini della scheda rispettino i requisiti dimensionali
• La descrizione dell’app rispecchi davvero le sue funzionalità

Dopo l’invio

Il team di revisione di Stripe risponde di solito entro 5-10 giorni lavorativi. Può:

• Approvare la tua app per la pubblicazione
• Richiedere modifiche con un riscontro puntuale
• Rifiutare l’app se non soddisfa i requisiti

Se ti vengono richieste modifiche, rispondi a tutto il riscontro ricevuto e reinvia. Ogni reinvio passa dall’intero ciclo di revisione.

Aggiornare un’app pubblicata

Per aggiornare un’app già pubblicata:

1. Incrementa la versione in stripe-app.json
2. Carica la nuova versione: stripe apps upload
3. Invia l’aggiornamento in revisione
4. Una volta approvato, l’aggiornamento viene distribuito automaticamente a tutti gli utenti