Publikovanie na Stripe App Marketplace

Publikovaním Vašej Stripe App na marketplace ju sprístupníte všetkým používateľom Stripe. Táto príručka opisuje požiadavky, kroky prípravy a proces odoslania.

Predpoklady

Skôr než budete môcť aplikáciu publikovať na Stripe App Marketplace, musíte splniť tieto požiadavky:

• Aktivovaný účet Stripe: Váš účet nesmie byť obmedzený len na testovací režim
• Jedna aplikácia na účet: Každý účet Stripe môže na marketplace publikovať iba jednu verejnú aplikáciu
• Iba angličtina: Celý obsah aplikácie, texty rozhrania aj informácie v listingu musia byť v angličtine
• Dokončená aplikácia: Vaša aplikácia musí byť plne funkčná a otestovaná

Kroky publikovania

Krok 1: Aktualizujte manifest

Nastavte v súbore stripe-app.json hodnotu distribution_type na 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"
    }
  ]
}

Krok 2: Pripravte aplikáciu

Pred odoslaním sa uistite, že Vaša aplikácia spĺňa všetky požiadavky na kontrolu:

1. Dôkladne ju otestujte v ostrom aj sandboxovom režime
2. Overte, že všetky oprávnenia sú potrebné a zdokumentované
3. Potvrďte, že je implementované spracovanie chýb aj stavy načítania
4. Skontrolujte, že všetky texty rozhrania sú v angličtine

Krok 3: Nahrajte aplikáciu

Na nahratie aplikácie použite Stripe CLI:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Krok 4: Napíšte listing

Prejdite do Stripe Dashboardu a dokončite listing svojej aplikácie. Na odoslanie na marketplace sú povinné všetky polia listingu.

Krok 5: Odošlite na kontrolu

Po dokončení listingu odošlite aplikáciu na kontrolu cez Stripe Dashboard. Tím Stripe posúdi Vašu aplikáciu voči požiadavkám na kvalitu.

Krok 6: Publikujte

Po schválení môžete aplikáciu publikovať a sprístupniť ju na marketplace.

Nastavenie manifestu pre verejnú distribúciu

Manifest musí obsahovať distribution_type: "public" a deklarovať všetky potrebné oprávnenia so zrozumiteľným popisom účelu:

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

Nakonfigurovanú aplikáciu nahráte príkazom:

stripe apps upload

Požiadavky na listing

Listing Vašej aplikácie musí obsahovať všetky nasledujúce polia:

Pravidlá pre názov

• Musí byť na marketplace jedinečný
• Mal by jasne vystihovať účel Vašej aplikácie
• Vyhnite sa všeobecným pojmom, ktoré by mohli používateľov pomýliť
• Príklad: “Tajo for Brevo” (15 znakov)

Pravidlá pre ikonu

• Rozmery: presne 300 x 300 pixelov
• Formát: PNG alebo SVG
• Nepridávajte zaoblené rohy, Stripe ich aplikuje automaticky
• Použite zreteľné, rozpoznateľné logo alebo symbol
• Zaistite čitateľnosť aj pri malej veľkosti

Sekcia About

Napíšte presvedčivý opis, ktorý pokryje:

• Aký problém Vaša aplikácia rieši
• Kľúčové integračné možnosti
• Pre koho je aplikácia určená
• Prípadné predpoklady alebo požiadavky

Príklad:

Tajo for Brevo prepája Vaše platobné dáta zo Stripe s platformou marketingovej automatizácie Brevo. Automaticky synchronizuje zákazníkov, sleduje platobné udalosti a spúšťa personalizované e-mailové, SMS a WhatsApp kampane na základe nákupného správania v reálnom čase. Vytvorené pre e-commerce firmy, ktoré chcú maximalizovať celoživotnú hodnotu zákazníka pomocou retenčného marketingu založeného na dátach.

Kľúčové funkcie

Každá položka kľúčovej funkcie obsahuje:

• Názov: Krátke pomenovanie funkcie
• Popis: Jedna až dve vety, ktoré funkciu vysvetľujú
• Obrázok: Snímka obrazovky alebo diagram (odporúčaných 1600 x 900 pixelov)

Odporúčané funkcie pre integráciu Tajo Brevo:

1. Synchronizácia zákazníkov v reálnom čase, automaticky synchronizuje profily zákazníkov zo Stripe do kontaktov v Brevo aj s celou históriou nákupov
2. Automatizácia riadená udalosťami, spúšťa workflow v Brevo z udalostí Stripe, ako sú úspešné platby, zmeny predplatného a vrátenia peňazí
3. Synchronizácia katalógu produktov, udržiava Váš katalóg produktov v Brevo zosúladený so Stripe pre personalizovaný obsah kampaní
4. Viackanálové kampane, využíva synchronizované dáta na cielené e-mailové, SMS a WhatsApp kampane
5. Prehľady v dashboarde, zobrazuje metriky zapojenia z Brevo priamo v pohľade na zákazníka v Stripe Dashboarde

Informácie o cenách

Jasne odkomunikujte svoj cenový model:

• Zdarma: Inštalácia aj používanie sú bezplatné
• Platené: Uveďte cenu a frekvenciu fakturácie
• Freemium: Opíšte, čo je zdarma a čo je spoplatnené
• Podľa spotreby: Vysvetlite cenové úrovne alebo cenu za jednotku

Testovanie aplikácie

Pred odoslaním aplikáciu dôkladne otestujte:

Testovanie v sandboxovom režime

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

# Verify sandbox compatibility
stripe apps validate

Formát testovacích prihlasovacích údajov

Keď kontrolnému tímu poskytujete testovacie prihlasovacie údaje, použite tento formát:

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

Kontrolný zoznam pred kontrolou

Pred odoslaním overte:

• Aplikácia funguje v ostrom aj testovacom režime
• Všetky oprávnenia majú zrozumiteľný popis účelu
• Chybové stavy sú ošetrené
• Pri asynchrónnych operáciách sa zobrazujú stavy načítania
• V produkčnom builde nie sú natvrdo zapísané testovacie dáta
• URL zásad ochrany súkromia je dostupná a správna
• Kontaktné údaje na podporu sú platné
• Všetky obrázky v listingu spĺňajú požiadavky na rozmery
• Opis aplikácie presne zodpovedá jej funkčnosti

Po odoslaní

Kontrolný tím Stripe zvyčajne odpovie do 5 až 10 pracovných dní. Môže Vašu aplikáciu:

• Schváliť na publikovanie
• Vyžiadať si zmeny s konkrétnou spätnou väzbou
• Zamietnuť, ak nespĺňa požiadavky

Ak si vyžiada zmeny, zapracujte všetku spätnú väzbu a odošlite aplikáciu znova. Každé opätovné odoslanie prechádza celým kontrolným cyklom.

Aktualizácia publikovanej aplikácie

Ako aktualizovať už publikovanú aplikáciu:

1. Zvýšte verziu v súbore stripe-app.json
2. Nahrajte novú verziu: stripe apps upload
3. Odošlite aktualizáciu na kontrolu
4. Po schválení sa aktualizácia automaticky nasadí všetkým používateľom