--- title: "Publikování na Stripe App Marketplace | Tajo" description: "Průvodce krok za krokem přípravou, odesláním a publikováním Vaší Stripe App na marketplace" url: https://tajo.io/cz/docs/stripe-apps/publish-app/ markdown: https://tajo.io/cz/docs/stripe-apps/publish-app.md lang: cs-CZ author: "Set Noa" author_url: https://tajo.io/cz/set-noa/ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # Publikování na Stripe App Marketplace [Set Noa](https://tajo.io/cz/set-noa/) 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í. Caution **Stav: plánováno, zatím nevytvořeno.** Tajo nemá žádnou aplikaci pro Stripe, takže nic z této sekce dnes nelze nainstalovat. Identifikátory aplikace, URL i přihlašovací údaje na této stránce jsou ilustrativní zástupné hodnoty, nikoli živé endpointy. ## 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á Caution Pokud potřebujete publikovat více aplikací, musíte pro každou z nich založit samostatný účet Stripe. ## Kroky publikování ### Krok 1: Aktualizujte manifest Nastavte v souboru `stripe-app.json` hodnotu `distribution_type` na `public`: ```json { "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](https://tajo.io/cz/docs/stripe-apps/review-requirements): 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: ```bash # 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](https://tajo.io/cz/docs/stripe-apps/review-requirements). ### 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: ```json { "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": "Read Stripe events so a sync picks up changes" }, { "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: ```bash stripe apps upload ``` ## Požadavky na listing Listing Vaší aplikace musí obsahovat všechna následující pole: | Pole | Požadavky | Podrobnosti | | --- | --- | --- | | **Název** | Maximálně 35 znaků | Zobrazovaný název na marketplace | | **Ikona** | 300x300 pixelů, PNG nebo SVG | Čtvercová ikona bez zaoblených rohů (přidá je Stripe) | | **Vytvořil** | Název firmy nebo jméno vývojáře | Zobrazuje se pod názvem aplikace | | **Kategorie** | Výběr z kategorií Stripe | Zvolte pro svou aplikaci nejrelevantnější kategorii | | **Podtitulek** | Maximálně 80 znaků | Krátký slogan zobrazený ve výsledcích vyhledávání | | **O aplikaci** | Maximálně 1 000 znaků | Podrobný popis toho, co Vaše aplikace dělá | | **Klíčové funkce** | Až 5, s obrázky | Vyzdvihněte hlavní funkce se snímky obrazovky nebo diagramy | | **Ceny** | Zdarma, placené nebo freemium | Jasně uveďte cenový model a případné náklady | | **Podpora** | Kontaktní URL nebo e-mail | Kde uživatelé získají pomoc s Vaší aplikací | | **Zásady ochrany osobních údajů** | URL zásad ochrany osobních údajů | Povinný právní dokument o nakládání s daty | ### 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í. 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ů**, 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 ```bash # 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: reviewer@test.tajo.io 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 Tip Drobné opravy chyb a nefunkční změny mohou získat zrychlenou kontrolu. Přidání velkých funkcí nebo změny oprávnění vyžadují plnou kontrolu.