Publisere til Stripe App Marketplace

Når du publiserer Stripe-appen din til marketplace, blir den tilgjengelig for alle Stripe-brukere. Denne veiledningen dekker kravene, forberedelsene og selve innsendingen.

Forutsetninger

Før du kan publisere en app til Stripe App Marketplace, må du oppfylle disse kravene:

• Aktivert Stripe-konto: Kontoen din kan ikke være begrenset til testmodus
• Én app per konto: Hver Stripe-konto kan bare publisere én offentlig app til marketplace
• Kun engelsk: Alt innhold i appen, all UI-tekst og all informasjon i oppføringen må være på engelsk
• Ferdig app: Appen din må være fullt funksjonell og testet

Slik publiserer du

Trinn 1: Oppdater manifestet ditt

Sett distribution_type i stripe-app.json til 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"
    }
  ]
}

Trinn 2: Gjør appen klar

Sørg for at appen din oppfyller alle krav til gjennomgangen før du sender den inn:

1. Test grundig i både live-modus og sandkassemodus
2. Kontroller at alle tillatelser er nødvendige og dokumenterte
3. Bekreft at feilhåndtering og lastetilstander er på plass
4. Sjekk at all UI-tekst er på engelsk

Trinn 3: Last opp appen din

Bruk Stripe CLI til å laste opp appen:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Trinn 4: Skriv oppføringen din

Gå til Stripe-dashboardet for å fullføre oppføringen av appen. Alle feltene i oppføringen må fylles ut før du kan sende inn til marketplace.

Trinn 5: Send inn til gjennomgang

Når oppføringen er ferdig, sender du appen inn til gjennomgang fra Stripe-dashboardet. Stripe-teamet vurderer appen din mot kvalitetskravene.

Trinn 6: Publiser

Når appen er godkjent, kan du publisere den slik at den blir tilgjengelig i marketplace.

Oppsett av manifestet for offentlig distribusjon

Manifestet må inneholde distribution_type: "public" og oppgi alle nødvendige tillatelser med tydelige beskrivelser av formålet:

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

Last opp den ferdig konfigurerte appen med:

stripe apps upload

Krav til oppføringen

Oppføringen av appen din må inneholde alle disse feltene:

Retningslinjer for navnet

• Må være unikt i marketplace
• Bør gjøre det tydelig hva appen er til for
• Unngå generiske ord som kan forvirre brukerne
• Eksempel: «Tajo for Brevo» (15 tegn)

Retningslinjer for ikonet

• Størrelse: nøyaktig 300x300 piksler
• Format: PNG eller SVG
• Ikke legg til avrundede hjørner, Stripe gjør det automatisk
• Bruk en tydelig logo eller et gjenkjennelig symbol
• Sørg for at det er lesbart i liten størrelse

Om-seksjonen

Skriv en beskrivelse som engasjerer og som dekker:

• Hvilket problem appen din løser
• De viktigste mulighetene i integrasjonen
• Hvem appen er laget for
• Eventuelle forutsetninger eller krav

Eksempel:

Tajo for Brevo kobler betalingsdataene dine fra Stripe sammen med Brevos plattform for markedsautomatisering. Synkroniser kunder automatisk, følg betalingshendelser og utløs personaliserte kampanjer på e-post, SMS og WhatsApp basert på kjøpsatferd i sanntid. Laget for netthandelsbedrifter som vil hente mest mulig verdi ut av kundeforholdet gjennom datadrevet markedsføring mot eksisterende kunder.

Nøkkelfunksjoner

Hver nøkkelfunksjon består av:

• Tittel: Kort navn på funksjonen
• Beskrivelse: Én til to setninger som forklarer funksjonen
• Bilde: Skjermbilde eller diagram (1600x900 piksler anbefales)

Anbefalte funksjoner for Tajos Brevo-integrasjon:

1. Kundesynkronisering i sanntid, synkroniser Stripe-kundeprofiler automatisk til Brevo-kontakter med full kjøpshistorikk
2. Hendelsesdrevet automatisering, utløs Brevo-flyter fra Stripe-hendelser som vellykkede betalinger, endringer i abonnement og refusjoner
3. Synkronisering av produktkatalog, hold produktkatalogen i Brevo synkronisert med Stripe for personalisert kampanjeinnhold
4. Kampanjer i flere kanaler, bruk de synkroniserte dataene til målrettede kampanjer på e-post, SMS og WhatsApp
5. Innsikt i dashboardet, se engasjementstall fra Brevo direkte i kundevisningen i Stripe-dashboardet

Informasjon om priser

Vær tydelig på prismodellen din:

• Gratis: Ingen kostnad ved installasjon eller bruk
• Betalt: Oppgi pris og hvor ofte det faktureres
• Freemium: Beskriv hva som er gratis og hva som koster penger
• Bruksbasert: Forklar prisnivåene eller prisen per enhet

Test appen din

Test appen grundig før du sender den inn:

Test i sandkassemodus

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

# Verify sandbox compatibility
stripe apps validate

Format for testtilganger

Når du oppgir testtilganger til gjennomgangsteamet, bruker du dette formatet:

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

Sjekkliste før gjennomgang

Kontroller dette før du sender inn:

• Appen fungerer både i live-modus og testmodus
• Alle tillatelser har tydelige beskrivelser av formålet
• Feiltilstander håndteres på en ryddig måte
• Lastetilstander vises for asynkrone operasjoner
• Ingen hardkodede testdata i produksjonsbygget
• URL-en til personvernerklæringen er tilgjengelig og riktig
• Kontaktinformasjonen for support er gyldig
• Alle bilder i oppføringen har riktige dimensjoner
• Beskrivelsen av appen stemmer med det den faktisk gjør

Etter innsending

Stripes gjennomgangsteam svarer vanligvis innen 5 til 10 virkedager. De kan:

• Godkjenne appen din for publisering
• Be om endringer med konkrete tilbakemeldinger
• Avvise appen hvis den ikke oppfyller kravene

Blir du bedt om endringer, retter du opp alle tilbakemeldingene og sender inn på nytt. Hver ny innsending går gjennom hele gjennomgangen på nytt.

Oppdatere en publisert app

Slik oppdaterer du en app som allerede er publisert:

1. Øk versjonsnummeret i stripe-app.json
2. Last opp den nye versjonen: stripe apps upload
3. Send oppdateringen inn til gjennomgang
4. Når den er godkjent, rulles oppdateringen automatisk ut til alle brukere