--- title: "Pubblicare sullo Stripe App Marketplace | Tajo" description: "Guida passo passo per preparare, inviare e pubblicare la tua Stripe App sul marketplace" url: https://tajo.io/it/docs/stripe-apps/publish-app/ markdown: https://tajo.io/it/docs/stripe-apps/publish-app.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. # Pubblicare sullo Stripe App Marketplace [Set Noa](https://tajo.io/it/set-noa/) 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. Caution **Stato: pianificata, non realizzata.** Tajo non ha un’app Stripe, quindi oggi nulla di questa sezione può essere installato. Gli identificatori dell’app, gli URL e le credenziali presenti in questa pagina sono segnaposto illustrativi, non endpoint reali. ## 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 Caution Se ti serve pubblicare più app, devi creare un account Stripe separato per ciascuna. ## Passaggi per la pubblicazione ### Passaggio 1: aggiorna il manifest Imposta `distribution_type` su `public` nel tuo `stripe-app.json`: ```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](https://tajo.io/it/docs/stripe-apps/review-requirements): 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: ```bash # 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à](https://tajo.io/it/docs/stripe-apps/review-requirements). ### 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: ```json { "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": "Read Stripe events so a sync picks up changes" }, { "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: ```bash stripe apps upload ``` ## Requisiti della scheda La scheda della tua app deve includere tutti i campi seguenti: | Campo | Requisiti | Dettagli | | --- | --- | --- | | **Nome** | Massimo 35 caratteri | Il nome visualizzato sul marketplace | | **Icona** | 300x300 pixel, PNG o SVG | Icona quadrata, senza angoli arrotondati (li aggiunge Stripe) | | **Realizzata da** | Nome dell’azienda o dello sviluppatore | Mostrato sotto il nome dell’app | | **Categoria** | Da scegliere tra le categorie di Stripe | Scegli la categoria più pertinente per la tua app | | **Sottotitolo** | Massimo 80 caratteri | Breve slogan mostrato nei risultati di ricerca | | **Descrizione** | Massimo 1.000 caratteri | Descrizione dettagliata di cosa fa la tua app | | **Funzionalità principali** | Fino a 5, con immagini | Metti in evidenza le funzionalità principali con screenshot o diagrammi | | **Prezzi** | Gratis, a pagamento o freemium | Indica con chiarezza il modello di prezzo e ogni costo | | **Assistenza** | URL o email di contatto | Dove gli utenti possono ricevere aiuto sulla tua app | | **Informativa sulla privacy** | URL dell’informativa sulla privacy | Documento legale obbligatorio per il trattamento dei dati | ### 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. 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**, 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 ```bash # 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: reviewer@test.tajo.io 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 Tip Le correzioni di bug minori e le modifiche non funzionali possono ricevere una revisione accelerata. Le nuove funzionalità importanti o le modifiche ai permessi richiedono una revisione completa.