Közzététel a Stripe App Marketplace-en

Ha közzéteszed a Stripe Appodat a piactéren, az összes Stripe felhasználó számára elérhetővé válik. Ez az útmutató végigveszi a feltételeket, az előkészítés lépéseit és a beküldés folyamatát.

Előfeltételek

Mielőtt közzétehetnél egy alkalmazást a Stripe App Marketplace-en, a következőknek kell teljesülniük:

• Aktivált Stripe fiók: a fiókod nem lehet csak teszt módra korlátozva
• Fiókonként egy alkalmazás: minden Stripe fiók egyetlen nyilvános alkalmazást tehet közzé a piactéren
• Csak angolul: az alkalmazás minden tartalmának, felületi szövegének és listázási adatának angolul kell lennie
• Kész alkalmazás: az alkalmazásodnak teljesen működőképesnek és tesztelnek kell lennie

A közzététel lépései

1. lépés: frissítsd a manifestedet

Állítsd a distribution_type értékét public értékre a stripe-app.json fájlban:

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

2. lépés: készítsd elő az alkalmazásodat

Beküldés előtt győződj meg róla, hogy az alkalmazásod megfelel az összes átvizsgálási követelménynek:

1. Teszteld alaposan éles és sandbox módban is
2. Ellenőrizd, hogy minden jogosultság szükséges és dokumentált
3. Nézd meg, hogy a hibakezelés és a betöltési állapotok meg vannak-e valósítva
4. Ellenőrizd, hogy minden felületi szöveg angolul van-e

3. lépés: töltsd fel az alkalmazásodat

Használd a Stripe CLI-t az alkalmazás feltöltéséhez:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

4. lépés: írd meg a listázásodat

Nyisd meg a Stripe Dashboardot, és töltsd ki az alkalmazás listázását. A piactéri beküldéshez minden listázási mező kötelező.

5. lépés: küldd be átvizsgálásra

A listázás kitöltése után küldd be az alkalmazást átvizsgálásra a Stripe Dashboardon. A Stripe csapata a minőségi követelmények alapján értékeli az alkalmazásodat.

6. lépés: tedd közzé

A jóváhagyás után közzéteheted az alkalmazásodat, és ezzel elérhetővé válik a piactéren.

Manifest beállítása nyilvános terjesztéshez

A manifestnek tartalmaznia kell a distribution_type: "public" beállítást, és minden szükséges jogosultságot világos purpose leírással kell deklarálnia:

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

A beállított alkalmazást így töltöd fel:

stripe apps upload

Listázási követelmények

Az alkalmazás listázásának minden alábbi mezőt tartalmaznia kell:

Irányelvek a névhez

• Egyedinek kell lennie a piactéren
• Világosan meg kell mutatnia, mire való az alkalmazásod
• Kerüld az általános kifejezéseket, amik összezavarhatják a felhasználókat
• Példa: “Tajo for Brevo” (15 karakter)

Irányelvek az ikonhoz

• Méret: pontosan 300x300 pixel
• Formátum: PNG vagy SVG
• Ne kerekítsd le a sarkokat, ezt a Stripe automatikusan megteszi
• Használj tiszta, jól felismerhető logót vagy szimbólumot
• Ügyelj rá, hogy kis méretben is olvasható legyen

About szakasz

Írj meggyőző leírást, amely kitér ezekre:

• Milyen problémát old meg az alkalmazásod
• Milyen integrációs képességei vannak
• Kinek készült az alkalmazás
• Milyen előfeltételek vagy követelmények vannak

Példa:

A Tajo for Brevo összeköti a Stripe fizetési adataidat a Brevo marketingautomatizálási platformjával. Automatikusan szinkronizálja a vásárlókat, követi a fizetési eseményeket, és a valós vásárlási viselkedés alapján indít személyre szabott e-mail, SMS és WhatsApp kampányokat. Azoknak az e-kereskedelmi vállalkozásoknak készült, amelyek adatvezérelt megtartási marketinggel akarják maximalizálni a vásárlói életciklus-értéket.

Fő funkciók

Minden fő funkció bejegyzése ezekből áll:

• Cím: rövid funkciónév
• Leírás: egy-két mondat a funkcióról
• Kép: képernyőkép vagy ábra (ajánlott méret 1600x900 pixel)

Ajánlott funkciók a Tajo Brevo integrációhoz:

1. Valós idejű vásárlószinkronizálás, a Stripe vásárlói profilok automatikus szinkronizálása Brevo kapcsolatokká, teljes vásárlási előzményekkel
2. Eseményvezérelt automatizálás, Brevo munkafolyamatok indítása Stripe eseményekből, például sikeres fizetésből, előfizetés-változásból és visszatérítésből
3. Termékkatalógus-szinkronizálás, a Brevo termékkatalógusod szinkronban tartása a Stripe-pal a személyre szabott kampánytartalomhoz
4. Többcsatornás kampányok, a szinkronizált adatokra épülő célzott e-mail, SMS és WhatsApp kampányok
5. Elemzések a dashboardon, a Brevo aktivitási metrikák megtekintése közvetlenül a Stripe Dashboard vásárlói nézetében

Árazási információk

Világosan kommunikáld az árazási modelledet:

• Ingyenes: a telepítés és a használat díjmentes
• Fizetős: add meg az árat és a számlázás gyakoriságát
• Freemium: írd le, mi jár ingyen, és miért kell fizetni
• Használatalapú: magyarázd el az árazási szinteket vagy az egységárakat

Az alkalmazásod tesztelése

Beküldés előtt teszteld alaposan az alkalmazásodat:

Tesztelés sandbox módban

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

# Verify sandbox compatibility
stripe apps validate

A teszthozzáférések formátuma

Amikor teszthozzáféréseket adsz az átvizsgáló csapatnak, ezt a formátumot használd:

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

Átvizsgálási ellenőrzőlista

Beküldés előtt ellenőrizd:

• Az alkalmazás éles és teszt módban is működik
• Minden jogosultsághoz világos purpose leírás tartozik
• A hibaállapotokat elegánsan kezeled
• Az aszinkron műveletekhez betöltési állapot jelenik meg
• Nincs beégetett tesztadat az éles buildben
• Az adatvédelmi tájékoztató URL-je elérhető és pontos
• A támogatási elérhetőség érvényes
• Minden listázási kép megfelel a méretkövetelményeknek
• Az alkalmazás leírása pontosan tükrözi a működést

A beküldés után

A Stripe átvizsgáló csapata jellemzően 5-10 munkanapon belül válaszol. Ezek a lehetséges kimenetek:

• Jóváhagyják az alkalmazásodat közzétételre
• Módosítást kérnek konkrét visszajelzéssel
• Elutasítják az alkalmazást, ha nem felel meg a követelményeknek

Ha módosítást kérnek, dolgozd fel az összes visszajelzést, és küldd be újra. Minden újrabeküldés végigmegy a teljes átvizsgálási körön.

Közzétett alkalmazás frissítése

Egy már közzétett alkalmazás frissítéséhez:

1. Növeld a verziószámot a stripe-app.json fájlban
2. Töltsd fel az új verziót: stripe apps upload
3. Küldd be a frissítést átvizsgálásra
4. Jóváhagyás után a frissítés automatikusan kikerül minden felhasználóhoz