---
title: "Publikovanie na Stripe App Marketplace | Tajo"
description: "Príručka krok za krokom, ako pripraviť, odoslať a publikovať Vašu Stripe App na marketplace"
url: https://tajo.io/sk/docs/stripe-apps/publish-app/
markdown: https://tajo.io/sk/docs/stripe-apps/publish-app.md
lang: sk-SK
author: "Set Noa"
author_url: https://tajo.io/sk/set-noa/
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Publikovanie na Stripe App Marketplace

[Set Noa](https://tajo.io/sk/set-noa/)

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.

Caution

**Stav: plánované, nevytvorené.** Tajo nemá žiadnu aplikáciu Stripe, takže nič z tejto sekcie sa dnes nedá nainštalovať. Identifikátory aplikácie, URL a prihlasovacie údaje na tejto stránke sú ilustratívne zástupné hodnoty, nie funkčné endpointy.

## 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á

Caution

Ak potrebujete publikovať viacero aplikácií, musíte pre každú z nich vytvoriť samostatný účet Stripe.

## Kroky publikovania

### Krok 1: Aktualizujte manifest

Nastavte v súbore `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: Pripravte aplikáciu

Pred odoslaním sa uistite, že Vaša aplikácia spĺňa všetky [požiadavky na kontrolu](https://tajo.io/sk/docs/stripe-apps/review-requirements):

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:

```bash
# 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](https://tajo.io/sk/docs/stripe-apps/review-requirements).

### 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:

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

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

```bash
stripe apps upload
```

## Požiadavky na listing

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

| Pole | Požiadavky | Podrobnosti |
| --- | --- | --- |
| **Názov** | Najviac 35 znakov | Zobrazovaný názov na marketplace |
| **Ikona** | 300 x 300 pixelov, PNG alebo SVG | Štvorcová ikona bez zaoblených rohov (Stripe ich doplní) |
| **Built by** | Názov firmy alebo vývojára | Zobrazuje sa pod názvom aplikácie |
| **Kategória** | Výber z kategórií Stripe | Vyberte kategóriu, ktorá Vašej aplikácii zodpovedá najviac |
| **Podtitul** | Najviac 80 znakov | Krátky slogan zobrazený vo výsledkoch vyhľadávania |
| **About** | Najviac 1 000 znakov | Podrobný opis toho, čo Vaša aplikácia robí |
| **Kľúčové funkcie** | Najviac 5, s obrázkami | Zvýraznite hlavné funkcie snímkami obrazovky alebo diagramami |
| **Cenník** | Zdarma, platené alebo freemium | Jasne uveďte cenový model a všetky náklady |
| **Podpora** | Kontaktná URL alebo e-mail | Kam sa používatelia obrátia o pomoc s Vašou aplikáciou |
| **Zásady ochrany súkromia** | URL na zásady ochrany súkromia | Povinný právny dokument o nakladaní s údajmi |

### 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. 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**, 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

```bash
# 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: 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ý 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

Tip

Drobné opravy chýb a nefunkčné zmeny môžu prejsť zrýchlenou kontrolou. Väčšie nové funkcie alebo zmeny oprávnení si vyžadujú plnú kontrolu.