Publikování na Stripe App Marketplace

Publikováním Vaší Stripe App na marketplace ji zpřístupníte všem uživatelům Stripe. Tento průvodce popisuje požadavky, přípravné kroky a proces odeslání.

Předpoklady

Než budete moci publikovat aplikaci na Stripe App Marketplace, musíte splnit tyto požadavky:

• Aktivovaný účet Stripe: Váš účet nesmí být omezen pouze na testovací režim
• Jedna aplikace na účet: každý účet Stripe může na marketplace publikovat jen jednu veřejnou aplikaci
• Pouze angličtina: veškerý obsah aplikace, texty rozhraní i informace v listingu musí být anglicky
• Hotová aplikace: Vaše aplikace musí být plně funkční a otestovaná

Kroky publikování

Krok 1: Aktualizujte manifest

Nastavte v souboru 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: Připravte aplikaci

Před odesláním se ujistěte, že Vaše aplikace splňuje všechny požadavky na kontrolu:

1. Důkladně otestujte v živém i sandboxovém režimu
2. Ověřte, že jsou všechna oprávnění nezbytná a zdokumentovaná
3. Potvrďte, že máte implementované ošetření chyb a stavy načítání
4. Zkontrolujte, že jsou všechny texty rozhraní anglicky

Krok 3: Nahrajte aplikaci

K nahrání aplikace použijte Stripe CLI:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Krok 4: Napište listing

Přejděte do Stripe Dashboardu a dokončete listing aplikace. Pro odeslání na marketplace jsou všechna pole listingu povinná.

Krok 5: Odešlete ke kontrole

Po dokončení listingu odešlete aplikaci ke kontrole ve Stripe Dashboardu. Tým Stripe posoudí Vaši aplikaci podle požadavků na kvalitu.

Krok 6: Publikujte

Po schválení můžete aplikaci publikovat, čímž ji zpřístupníte na marketplace.

Nastavení manifestu pro veřejnou distribuci

Manifest musí obsahovat distribution_type: "public" a deklarovat všechna potřebná oprávnění se srozumitelným popisem úč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"
  }
}

Nakonfigurovanou aplikaci nahrajte příkazem:

stripe apps upload

Požadavky na listing

Listing Vaší aplikace musí obsahovat všechna následující pole:

Pravidla pro název

• Musí být na marketplace jedinečný
• Měl by jasně vyjadřovat účel Vaší aplikace
• Vyhněte se obecným výrazům, které mohou uživatele mást
• Příklad: “Tajo for Brevo” (15 znaků)

Pravidla pro ikonu

• Rozměry: přesně 300x300 pixelů
• Formát: PNG nebo SVG
• Nepřidávejte zaoblené rohy, Stripe je aplikuje automaticky
• Použijte zřetelné a dobře rozpoznatelné logo nebo symbol
• Zajistěte čitelnost i v malých velikostech

Sekce O aplikaci

Napište přesvědčivý popis, který pokryje:

• Jaký problém Vaše aplikace řeší
• Klíčové možnosti integrace
• Pro koho je aplikace určena
• Případné předpoklady nebo požadavky

Příklad:

Tajo for Brevo propojuje data o platbách ze Stripe s platformou pro marketingovou automatizaci Brevo. Automaticky synchronizujte zákazníky, sledujte platební události a spouštějte personalizované e-mailové, SMS a WhatsApp kampaně podle nákupního chování v reálném čase. Vytvořeno pro e-shopy, které chtějí maximalizovat celoživotní hodnotu zákazníka pomocí retenčního marketingu založeného na datech.

Klíčové funkce

Každá položka klíčové funkce obsahuje:

• Název: krátký název funkce
• Popis: jedna až dvě věty vysvětlující funkci
• Obrázek: snímek obrazovky nebo diagram (doporučeno 1600x900 pixelů)

Doporučené funkce pro integraci Tajo Brevo:

1. Synchronizace zákazníků v reálném čase, automaticky synchronizuje profily zákazníků ze Stripe do kontaktů Brevo včetně celé historie nákupů
2. Automatizace řízená událostmi, spouští workflow v Brevo z událostí Stripe, jako jsou úspěšné platby, změny předplatného a refundace
3. Synchronizace katalogu produktů, udržuje katalog produktů v Brevo synchronizovaný se Stripe kvůli personalizovanému obsahu kampaní
4. Vícekanálové kampaně, využívá synchronizovaná data pro cílené e-mailové, SMS a WhatsApp kampaně
5. Přehledy v dashboardu, zobrazuje metriky zapojení z Brevo přímo v detailu zákazníka ve Stripe Dashboardu

Informace o cenách

Jasně sdělte svůj cenový model:

• Zdarma: instalace i používání jsou bez poplatku
• Placené: uveďte cenu a frekvenci fakturace
• Freemium: popište, co je zdarma a co je za poplatek
• Podle využití: vysvětlete cenové úrovně nebo náklady za jednotku

Testování aplikace

Před odesláním svou aplikaci důkladně otestujte:

Test v sandboxovém režimu

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

# Verify sandbox compatibility
stripe apps validate

Formát testovacích přihlašovacích údajů

Když kontrolnímu týmu poskytujete testovací přihlašovací údaje, použijte 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í seznam před odesláním

Před odesláním ověřte:

• Aplikace funguje v živém i testovacím režimu
• Všechna oprávnění mají srozumitelný popis účelu
• Chybové stavy jsou ošetřeny
• U asynchronních operací se zobrazují stavy načítání
• V produkčním sestavení nejsou natvrdo zapsaná testovací data
• URL zásad ochrany osobních údajů je dostupná a správná
• Kontaktní údaje na podporu jsou platné
• Všechny obrázky listingu splňují požadované rozměry
• Popis aplikace přesně odpovídá její funkčnosti

Po odeslání

Kontrolní tým Stripe obvykle odpoví do 5 až 10 pracovních dní. Může:

• Schválit Vaši aplikaci k publikování
• Vyžádat si změny s konkrétní zpětnou vazbou
• Zamítnout aplikaci, pokud nesplňuje požadavky

Pokud si vyžádá změny, vypořádejte celou zpětnou vazbu a odešlete znovu. Každé opětovné odeslání prochází celým kontrolním cyklem.

Aktualizace publikované aplikace

Postup aktualizace již publikované aplikace:

1. Navyšte verzi v souboru stripe-app.json
2. Nahrajte novou verzi: stripe apps upload
3. Odešlete aktualizaci ke kontrole
4. Po schválení se aktualizace automaticky nasadí všem uživatelům