Publicera till Stripe App Marketplace

Att publicera din Stripe App till marketplace gör den tillgänglig för alla Stripe-användare. Den här guiden täcker krav, förberedelsesteg och inlämningsprocessen.

Förutsättningar

Innan du kan publicera en app till Stripe App Marketplace måste du uppfylla dessa krav:

• Aktiverat Stripe-konto: Ditt konto kan inte vara begränsat till enbart testläge
• En app per konto: Varje Stripe-konto kan bara publicera en offentlig app till marketplace
• Endast engelska: Allt appinnehåll, UI-text och listningsinformation måste vara på engelska
• Färdig app: Din app måste vara fullt fungerande och testad

Publiceringssteg

Steg 1: Uppdatera ditt manifest

Ange distribution_type i din stripe-app.json till public:

{
  "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"
    }
  ]
}

Steg 2: Förbered din app

Se till att din app uppfyller alla granskningskrav innan du skickar in:

1. Testa noggrant i både live- och sandboxläge
2. Verifiera att alla behörigheter är nödvändiga och dokumenterade
3. Bekräfta att felhantering och laddningstillstånd är implementerade
4. Kontrollera att all UI-text är på engelska

Steg 3: Ladda upp din app

Använd Stripe CLI för att ladda upp din app:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Steg 4: Skriv din listning

Navigera till Stripe Dashboard för att fylla i din applisting. Alla listningsfält krävs för marketplace-inlämning.

Steg 5: Skicka in för granskning

När du fyllt i din listning, skicka in appen för granskning via Stripe Dashboard. Stripe-teamet kommer att utvärdera din app mot kvalitetskraven.

Steg 6: Publicera

När godkänd kan du publicera din app för att göra den tillgänglig på marketplace.

Manifestinställning för offentlig distribution

Manifestet måste inkludera distribution_type: "public" och deklarera alla nödvändiga behörigheter med tydliga syftebeskrivningar:

{
  "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"
  }
}

Ladda upp den konfigurerade appen med:

stripe apps upload

Listningskrav

Din applisting måste inkludera alla följande fält:

Riktlinjer för namn

• Måste vara unikt på marketplace
• Ska tydligt identifiera din apps syfte
• Undvik generiska termer som kan förvirra användare
• Exempel: “Tajo for Brevo” (15 tecken)

Riktlinjer för ikon

• Dimensioner: exakt 300x300 pixlar
• Format: PNG eller SVG
• Lägg inte till rundade hörn – Stripe tillämpar dem automatiskt
• Använd en tydlig, igenkännlig logotyp eller symbol
• Säkerställ läsbarhet i små storlekar

Om-avsnittet

Skriv en övertygande beskrivning som täcker:

• Vilket problem din app löser
• Viktiga integrationsfunktioner
• Vem appen är utformad för
• Eventuella förutsättningar eller krav

Exempel:

Tajo for Brevo kopplar din Stripe-betalningsdata med Brevos marknadsföringsautomationsplattform. Synkronisera automatiskt kunder, spåra betalningshändelser och utlös personliga e-post-, SMS- och WhatsApp-kampanjer baserat på köpbeteende i realtid. Byggd för e-handelsföretag som vill maximera kundens livstidsvärde genom datadriven retentionsmarknadsföring.

Nyckelfunktioner

Varje nyckelfunktionspost inkluderar:

• Titel: Kort funktionsnamn
• Beskrivning: En till två meningar som förklarar funktionen
• Bild: Skärmdump eller diagram (rekommenderat 1600x900 pixlar)

Rekommenderade funktioner för Tajo Brevo-integrationen:

1. Kundsynkronisering i realtid, Synkronisera automatiskt Stripe-kundprofiler till Brevo-kontakter med fullständig köphistorik
2. Händelsedriven automatisering, Utlös Brevo-arbetsflöden från Stripe-händelser som framgångsrika betalningar, prenumerationsändringar och återbetalningar
3. Produktkatalogsynkronisering, Håll din Brevo-produktkatalog synkroniserad med Stripe för personaliserat kampanjinnehåll
4. Flerkanalskampanjer, Använd synkroniserad data för att driva riktade e-post-, SMS- och WhatsApp-kampanjer
5. Instrumentpanelinsikter, Visa Brevo-engagemangsmätvärden direkt i Stripe Dashboard-kundvyn

Prisinformation

Kommunicera tydligt din prismodell:

• Gratis: Ingen kostnad att installera eller använda
• Betald: Ange priset och faktureringsfre kvensen
• Freemium: Beskriv vad som ingår gratis och vad som kräver betalning
• Användningsbaserad: Förklara prisnivåerna eller per-enhetskostnader

Testa din app

Testa noggrant din app innan inlämning:

Testa i sandboxläge

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

# Verify sandbox compatibility
stripe apps validate

Format för testuppgifter

När du tillhandahåller testuppgifter till granskningsteamet, använd detta format:

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

Granskningschecklista

Kontrollera innan du skickar in:

• Appen fungerar i både live- och testläge
• Alla behörigheter har tydliga syftebeskrivningar
• Feltillstånd hanteras elegant
• Laddningstillstånd visas för asynkrona operationer
• Inga hårdkodade testdata i produktionsbygget
• URL till integritetspolicyn är tillgänglig och korrekt
• Supportkontaktinformation är giltig
• Alla listningsbilder uppfyller dimensionskrav
• Appbeskrivningen återspeglar korrekt funktionaliteten

Efter inlämning

Stripe-granskningsteamet svarar vanligtvis inom 5-10 arbetsdagar. De kan:

• Godkänna din app för publicering
• Begära ändringar med specifik feedback
• Avvisa appen om den inte uppfyller kraven

Om ändringar begärs, åtgärda all feedback och skicka in igen. Varje återinlämning går igenom hela granskningscykeln.

Uppdatera en publicerad app

För att uppdatera en redan publicerad app:

1. Öka versionen i stripe-app.json
2. Ladda upp den nya versionen: stripe apps upload
3. Skicka in uppdateringen för granskning
4. När godkänd distribueras uppdateringen automatiskt till alla användare