Udgivelse på Stripe App Marketplace

Når du udgiver din Stripe App på marketplace, bliver den tilgængelig for alle Stripe-brugere. Denne guide gennemgår kravene, forberedelsen og selve indsendelsen.

Forudsætninger

Før du kan udgive en app på Stripe App Marketplace, skal du opfylde disse krav:

• Aktiveret Stripe-konto: Din konto må ikke være begrænset til testtilstand
• Én app per konto: Hver Stripe-konto kan kun udgive én offentlig app på marketplace
• Kun engelsk: Alt indhold i appen, al UI-tekst og alle oplysninger i annonceringen skal være på engelsk
• Færdig app: Din app skal være fuldt funktionsdygtig og testet

Sådan udgiver du

Trin 1: Opdatér dit manifest

Sæt distribution_type i din 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"
    }
  ]
}

Trin 2: Forbered din app

Sørg for, at din app opfylder alle krav til gennemgangen, før du indsender den:

1. Test grundigt i både live- og sandbox-tilstand
2. Kontrollér, at alle rettigheder er nødvendige og dokumenterede
3. Bekræft, at fejlhåndtering og indlæsningstilstande er på plads
4. Tjek, at al UI-tekst er på engelsk

Trin 3: Upload din app

Brug Stripe CLI til at uploade din app:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Trin 4: Skriv din annoncering

Gå ind i Stripe Dashboard for at færdiggøre annonceringen af din app. Alle felter i annonceringen skal udfyldes, før du kan indsende til marketplace.

Trin 5: Indsend til gennemgang

Når annonceringen er færdig, indsender du appen til gennemgang via Stripe Dashboard. Stripes team vurderer din app ud fra kvalitetskravene.

Trin 6: Udgiv

Når appen er godkendt, kan du udgive den, så den bliver tilgængelig på marketplace.

Opsætning af manifestet til offentlig distribution

Manifestet skal indeholde distribution_type: "public" og angive alle nødvendige rettigheder med en tydelig beskrivelse af 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"
  }
}

Upload den konfigurerede app med:

stripe apps upload

Krav til annonceringen

Din annoncering skal indeholde alle disse felter:

Retningslinjer for navnet

• Skal være unikt på marketplace
• Bør tydeligt vise, hvad din app bruges til
• Undgå generiske ord, der kan forvirre brugerne
• Eksempel: “Tajo for Brevo” (15 tegn)

Retningslinjer for ikonet

• Mål: præcis 300x300 pixels
• Format: PNG eller SVG
• Tilføj ikke afrundede hjørner, det gør Stripe automatisk
• Brug et tydeligt logo eller symbol, der er let at genkende
• Sørg for, at det kan læses i lille størrelse

Om-sektionen

Skriv en overbevisende beskrivelse, der dækker:

• Hvilket problem din app løser
• De vigtigste ting, integrationen kan
• Hvem appen er lavet til
• Eventuelle forudsætninger eller krav

Eksempel:

Tajo for Brevo forbinder dine Stripe-betalingsdata med Brevos platform til marketingautomatisering. Synkronisér kunder automatisk, følg betalingshændelser, og udløs personaliserede kampagner på e-mail, SMS og WhatsApp ud fra købsadfærden i realtid. Bygget til e-handelsvirksomheder, der vil have mest muligt ud af kundernes livstidsværdi gennem datadrevet fastholdelsesmarkedsføring.

Vigtigste funktioner

Hver post under de vigtigste funktioner indeholder:

• Titel: Kort navn på funktionen
• Beskrivelse: En til to sætninger, der forklarer funktionen
• Billede: Skærmbillede eller diagram (1600x900 pixels anbefales)

Anbefalede funktioner for Tajo Brevo-integrationen:

1. Kundesynkronisering i realtid, synkronisér automatisk Stripe-kundeprofiler til Brevo-kontakter med hele købshistorikken
2. Hændelsesdrevet automatisering, udløs Brevo-workflows fra Stripe-hændelser som gennemførte betalinger, ændringer i abonnementer og refusioner
3. Synkronisering af produktkataloget, hold dit Brevo-produktkatalog synkroniseret med Stripe, så kampagneindholdet kan personaliseres
4. Kampagner på flere kanaler, brug de synkroniserede data til målrettede kampagner på e-mail, SMS og WhatsApp
5. Indsigt i dashboardet, se Brevos engagementstal direkte i kundevisningen i Stripe Dashboard

Oplysninger om pris

Kommunikér din prismodel tydeligt:

• Gratis: Det koster ikke noget at installere eller bruge appen
• Betalt: Angiv prisen og hvor ofte der faktureres
• Freemium: Beskriv, hvad der er gratis, og hvad der kræver betaling
• Forbrugsbaseret: Forklar prisniveauerne eller prisen per enhed

Test af din app

Test din app grundigt, før du indsender den:

Test i sandbox-tilstand

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

# Verify sandbox compatibility
stripe apps validate

Format for testadgang

Brug dette format, når du giver gennemgangsteamet adgang til test:

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

Tjekliste før gennemgang

Kontrollér følgende, før du indsender:

• Appen virker i både live- og testtilstand
• Alle rettigheder har en tydelig beskrivelse af formålet
• Fejltilstande håndteres pænt
• Der vises indlæsningstilstande ved asynkrone handlinger
• Der ligger ingen hardkodede testdata i produktionsbuildet
• URL’en til privatlivspolitikken virker og er korrekt
• Kontaktoplysningerne til support er gyldige
• Alle billeder i annonceringen overholder kravene til mål
• Beskrivelsen af appen svarer til det, den rent faktisk gør

Efter indsendelsen

Stripes gennemgangsteam svarer typisk inden for 5-10 hverdage. De kan:

• Godkende din app til udgivelse
• Bede om ændringer med konkret feedback
• Afvise appen, hvis den ikke opfylder kravene

Bliver du bedt om ændringer, skal du rette op på al feedback og indsende igen. Hver ny indsendelse går gennem hele gennemgangen forfra.

Opdatering af en udgivet app

Sådan opdaterer du en app, der allerede er udgivet:

1. Tæl versionen op i stripe-app.json
2. Upload den nye version: stripe apps upload
3. Indsend opdateringen til gennemgang
4. Når den er godkendt, bliver opdateringen automatisk rullet ud til alle brugere