---
title: "Publikacja w Stripe App Marketplace | Tajo"
description: "Przewodnik krok po kroku po przygotowaniu, zgłoszeniu i opublikowaniu aplikacji Stripe w marketplace"
url: https://tajo.io/pl/docs/stripe-apps/publish-app/
markdown: https://tajo.io/pl/docs/stripe-apps/publish-app.md
lang: pl-PL
author: "Set Noa"
author_url: https://tajo.io/pl/set-noa/
robots: noindex
---

Poproś o wcześniejszy dostęp

Podaj imię i firmowy adres e-mail. Wyślemy Ci link potwierdzający prośbę o dostęp do Tajo.

# Publikacja w Stripe App Marketplace

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

Opublikowanie aplikacji Stripe w marketplace udostępnia ją wszystkim użytkownikom Stripe. Ten przewodnik opisuje wymagania, kroki przygotowawcze i proces zgłoszenia.

Caution

**Status: planowana, niezbudowana.** Tajo nie ma aplikacji Stripe App, więc niczego z tej sekcji nie można dziś zainstalować. Identyfikatory aplikacji, adresy URL i dane dostępowe na tej stronie są przykładowymi symbolami zastępczymi, a nie działającymi endpointami.

## Wymagania wstępne

Zanim opublikujesz aplikację w Stripe App Marketplace, musisz spełnić następujące wymagania:

- **Aktywowane konto Stripe**: Twoje konto nie może być ograniczone wyłącznie do trybu testowego
- **Jedna aplikacja na konto**: każde konto Stripe może opublikować w marketplace tylko jedną publiczną aplikację
- **Tylko po angielsku**: cała zawartość aplikacji, teksty interfejsu i informacje w ofercie muszą być w języku angielskim
- **Ukończona aplikacja**: Twoja aplikacja musi być w pełni funkcjonalna i przetestowana

Caution

Jeśli chcesz opublikować kilka aplikacji, musisz założyć osobne konto Stripe dla każdej z nich.

## Kroki publikacji

### Krok 1: zaktualizuj manifest

Ustaw `distribution_type` w pliku `stripe-app.json` 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: przygotuj aplikację

Przed zgłoszeniem upewnij się, że Twoja aplikacja spełnia wszystkie [wymagania weryfikacji](https://tajo.io/pl/docs/stripe-apps/review-requirements):

1. Przetestuj ją dokładnie w trybie live i w trybie sandbox
2. Sprawdź, czy wszystkie uprawnienia są niezbędne i udokumentowane
3. Potwierdź, że obsługa błędów i stany ładowania są zaimplementowane
4. Zweryfikuj, że wszystkie teksty interfejsu są po angielsku

### Krok 3: wgraj aplikację

Wgraj aplikację za pomocą Stripe CLI:

```bash
# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list
```

### Krok 4: napisz ofertę

Przejdź do panelu Stripe, aby uzupełnić ofertę aplikacji. Wszystkie pola oferty są wymagane przy zgłoszeniu do marketplace.

### Krok 5: zgłoś do weryfikacji

Po uzupełnieniu oferty zgłoś aplikację do weryfikacji przez panel Stripe. Zespół Stripe oceni ją pod kątem [wymagań jakościowych](https://tajo.io/pl/docs/stripe-apps/review-requirements).

### Krok 6: opublikuj

Po zatwierdzeniu możesz opublikować aplikację i udostępnić ją w marketplace.

## Konfiguracja manifestu dla dystrybucji publicznej

Manifest musi zawierać `distribution_type: "public"` i deklarować wszystkie wymagane uprawnienia wraz z jasnym opisem ich celu:

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

Wgraj skonfigurowaną aplikację poleceniem:

```bash
stripe apps upload
```

## Wymagania dotyczące oferty

Twoja oferta aplikacji musi zawierać wszystkie poniższe pola:

| Pole | Wymagania | Szczegóły |
| --- | --- | --- |
| **Nazwa** | Maksymalnie 35 znaków | Nazwa wyświetlana w marketplace |
| **Ikona** | 300x300 pikseli, PNG lub SVG | Kwadratowa ikona bez zaokrąglonych rogów (Stripe dodaje je sam) |
| **Autor** | Nazwa firmy lub dewelopera | Wyświetlana pod nazwą aplikacji |
| **Kategoria** | Wybór z kategorii Stripe | Wybierz kategorię najlepiej pasującą do Twojej aplikacji |
| **Podtytuł** | Maksymalnie 80 znaków | Krótkie hasło widoczne w wynikach wyszukiwania |
| **Opis** | Maksymalnie 1000 znaków | Szczegółowy opis tego, co robi Twoja aplikacja |
| **Kluczowe funkcje** | Do 5, z obrazami | Wyróżnij główne funkcje zrzutami ekranu lub diagramami |
| **Cennik** | Darmowa, płatna lub freemium | Jasno określ model cenowy i wszelkie koszty |
| **Wsparcie** | Adres URL lub email kontaktowy | Miejsce, w którym użytkownicy uzyskają pomoc |
| **Polityka prywatności** | Adres URL polityki prywatności | Wymagany dokument prawny dotyczący przetwarzania danych |

### Wskazówki dotyczące nazwy

- Musi być unikalna w marketplace
- Powinna jasno wskazywać przeznaczenie aplikacji
- Unikaj ogólnikowych określeń, które mogą mylić użytkowników
- Przykład: “Tajo for Brevo” (15 znaków)

### Wskazówki dotyczące ikony

- Wymiary: dokładnie 300x300 pikseli
- Format: PNG lub SVG
- Nie dodawaj zaokrąglonych rogów, Stripe robi to automatycznie
- Użyj czytelnego, rozpoznawalnego logo lub symbolu
- Zadbaj o czytelność w małych rozmiarach

### Sekcja opisu

Napisz przekonujący opis, który obejmie:

- Problem, który rozwiązuje Twoja aplikacja
- Kluczowe możliwości integracji
- Odbiorców, dla których aplikacja powstała
- Wszelkie wymagania wstępne

Przykład:

> Tajo for Brevo łączy dane o płatnościach ze Stripe z platformą automatyzacji marketingu Brevo. Automatycznie synchronizuj klientów, śledź zdarzenia płatnicze i wyzwalaj spersonalizowane kampanie email, SMS i WhatsApp na podstawie zachowań zakupowych. Rozwiązanie stworzone dla firm e-commerce, które chcą maksymalizować wartość klienta w całym cyklu życia dzięki marketingowi retencyjnemu opartemu na danych.

### Kluczowe funkcje

Każdy wpis o kluczowej funkcji zawiera:

- **Tytuł**: krótka nazwa funkcji
- **Opis**: jedno lub dwa zdania wyjaśniające funkcję
- **Obraz**: zrzut ekranu lub diagram (zalecane 1600x900 pikseli)

Zalecane funkcje dla integracji Tajo z Brevo:

1. **Synchronizacja klientów**, automatyczne przenoszenie profili klientów ze Stripe do kontaktów Brevo wraz z pełną historią zakupów
2. **Automatyzacja sterowana zdarzeniami**, wyzwalanie przepływów Brevo na podstawie zdarzeń Stripe, takich jak udane płatności, zmiany subskrypcji i zwroty
3. **Synchronizacja katalogu produktów**, utrzymywanie katalogu produktów Brevo w zgodzie ze Stripe na potrzeby spersonalizowanych treści kampanii
4. **Kampanie wielokanałowe**, wykorzystanie zsynchronizowanych danych do kierowanych kampanii email, SMS i WhatsApp
5. **Wgląd w panelu**, podgląd wskaźników zaangażowania z Brevo bezpośrednio w widoku klienta w panelu Stripe

### Informacje o cenniku

Jasno zakomunikuj swój model cenowy:

- **Darmowy**: instalacja i korzystanie bez opłat
- **Płatny**: podaj cenę i częstotliwość rozliczeń
- **Freemium**: opisz, co jest dostępne za darmo, a co wymaga opłaty
- **Rozliczany za użycie**: wyjaśnij progi cenowe lub koszty jednostkowe

## Testowanie aplikacji

Przed zgłoszeniem przetestuj aplikację dokładnie:

### Testy w trybie sandbox

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

# Verify sandbox compatibility
stripe apps validate
```

### Format danych testowych

Przekazując dane testowe zespołowi weryfikującemu, użyj tego formatu:

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

### Lista kontrolna przed weryfikacją

Przed zgłoszeniem sprawdź, czy:

- Aplikacja działa w trybie live i w trybie testowym
- Wszystkie uprawnienia mają jasny opis celu
- Stany błędów są obsługiwane w kontrolowany sposób
- Stany ładowania są pokazywane przy operacjach asynchronicznych
- W buildzie produkcyjnym nie ma zaszytych danych testowych
- Adres polityki prywatności jest dostępny i aktualny
- Dane kontaktowe do wsparcia są poprawne
- Wszystkie obrazy w ofercie spełniają wymagania dotyczące wymiarów
- Opis aplikacji wiernie oddaje jej funkcjonalność

## Po zgłoszeniu

Zespół weryfikujący Stripe odpowiada zwykle w ciągu 5 do 10 dni roboczych. Może wtedy:

- **Zatwierdzić** aplikację do publikacji
- **Poprosić o zmiany** wraz z konkretnymi uwagami
- **Odrzucić** aplikację, jeśli nie spełnia wymagań

Jeśli zespół poprosi o zmiany, odnieś się do wszystkich uwag i zgłoś aplikację ponownie. Każde ponowne zgłoszenie przechodzi pełny cykl weryfikacji.

## Aktualizacja opublikowanej aplikacji

Aby zaktualizować już opublikowaną aplikację:

1. Zwiększ numer wersji w pliku `stripe-app.json`
2. Wgraj nową wersję: `stripe apps upload`
3. Zgłoś aktualizację do weryfikacji
4. Po zatwierdzeniu aktualizacja trafia automatycznie do wszystkich użytkowników

Tip

Drobne poprawki błędów i zmiany niefunkcjonalne mogą przejść przyspieszoną weryfikację. Duże nowe funkcje lub zmiany uprawnień wymagają pełnej weryfikacji.