Publikacja w Stripe App Marketplace

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

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

Kroki publikacji

Krok 1: zaktualizuj manifest

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

Przed zgłoszeniem upewnij się, że Twoja aplikacja spełnia wszystkie wymagania weryfikacji:

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:

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

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:

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

Wgraj skonfigurowaną aplikację poleceniem:

stripe apps upload

Wymagania dotyczące oferty

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

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 w czasie rzeczywistym. 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 w czasie rzeczywistym, 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

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

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