Публикуване в Stripe App Marketplace

Публикуването на Вашето Stripe App в маркетплейса го прави достъпно за всички потребители на Stripe. Това ръководство обхваща изискванията, стъпките за подготовка и процеса на подаване.

Предварителни изисквания

Преди да публикувате приложение в Stripe App Marketplace, трябва да отговаряте на следните изисквания:

• Активиран Stripe акаунт: акаунтът Ви не може да бъде ограничен само до тестов режим
• По едно приложение на акаунт: всеки Stripe акаунт може да публикува само едно публично приложение в маркетплейса
• Само на английски: цялото съдържание на приложението, текстовете в интерфейса и информацията в обявата трябва да бъдат на английски
• Завършено приложение: приложението Ви трябва да е напълно функционално и тествано

Стъпки за публикуване

Стъпка 1: Актуализирайте манифеста си

Задайте distribution_type във Вашия stripe-app.json на 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"
    }
  ]
}

Стъпка 2: Подгответе приложението си

Уверете се, че приложението Ви отговаря на всички изисквания за преглед, преди да го подадете:

1. Тествайте обстойно както в реален режим, така и в sandbox режим
2. Проверете дали всички права са необходими и документирани
3. Потвърдете, че обработката на грешки и състоянията на зареждане са реализирани
4. Проверете дали целият текст в интерфейса е на английски

Стъпка 3: Качете приложението си

Използвайте Stripe CLI, за да качите приложението си:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Стъпка 4: Напишете обявата си

Отидете в Stripe Dashboard, за да попълните обявата на приложението си. Всички полета в обявата са задължителни за подаване към маркетплейса.

Стъпка 5: Подайте за преглед

След като попълните обявата, подайте приложението за преглед през Stripe Dashboard. Екипът на Stripe ще го оцени спрямо изискванията за качество.

Стъпка 6: Публикувайте

След одобрение можете да публикувате приложението си, за да го направите достъпно в маркетплейса.

Настройка на манифеста за публично разпространение

Манифестът трябва да съдържа distribution_type: "public" и да декларира всички необходими права с ясно описано предназначение:

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

Качете конфигурираното приложение с:

stripe apps upload

Изисквания към обявата

Обявата на Вашето приложение трябва да съдържа всички изброени полета:

Насоки за името

• Трябва да е уникално в маркетплейса
• Трябва ясно да показва предназначението на приложението Ви
• Избягвайте общи термини, които могат да объркат потребителите
• Пример: „Tajo for Brevo” (15 знака)

Насоки за иконата

• Размери: точно 300x300 пиксела
• Формат: PNG или SVG
• Не добавяйте заоблени ъгли, Stripe ги прилага автоматично
• Използвайте ясно и разпознаваемо лого или символ
• Осигурете четливост при малки размери

Раздел About

Напишете убедително описание, което обхваща:

• Какъв проблем решава Вашето приложение
• Ключовите възможности за интеграция
• За кого е предназначено приложението
• Всички предварителни условия или изисквания

Пример:

Tajo for Brevo свързва данните Ви за плащания в Stripe с платформата за маркетингова автоматизация на Brevo. Синхронизирайте автоматично клиентите, проследявайте събитията при плащане и задействайте персонализирани имейл, SMS и WhatsApp кампании на база поведението при покупка в реално време. Създадено за бизнеси в електронната търговия, които искат да увеличат максимално жизнената стойност на клиента чрез маркетинг за задържане, основан на данни.

Ключови функции

Всеки запис за ключова функция включва:

• Заглавие: кратко име на функцията
• Описание: едно до две изречения, които обясняват функцията
• Изображение: снимка на екрана или диаграма (препоръчително 1600x900 пиксела)

Препоръчителни функции за интеграцията на Tajo с Brevo:

1. Синхронизация на клиентите в реално време, синхронизирайте автоматично клиентските профили от Stripe с контактите в Brevo, заедно с пълната история на покупките
2. Автоматизация, задвижвана от събития, задействайте работни процеси в Brevo от събития в Stripe като успешни плащания, промени в абонаменти и възстановявания
3. Синхронизация на продуктовия каталог, поддържайте продуктовия си каталог в Brevo синхронизиран със Stripe за персонализирано съдържание на кампаниите
4. Многоканални кампании, използвайте синхронизираните данни за таргетирани имейл, SMS и WhatsApp кампании
5. Анализи в таблото, разглеждайте показателите за ангажираност от Brevo директно в изгледа на клиента в Stripe Dashboard

Информация за цените

Комуникирайте ясно ценовия си модел:

• Безплатно: без разходи за инсталиране или използване
• Платено: посочете цената и честотата на таксуване
• Freemium: опишете какво е включено безплатно и какво изисква плащане
• На база потребление: обяснете ценовите нива или цената за единица

Тестване на приложението

Преди подаване тествайте приложението си обстойно:

Тестване в sandbox режим

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

# Verify sandbox compatibility
stripe apps validate

Формат на тестовите данни за достъп

Когато предоставяте тестови данни за достъп на екипа за преглед, използвайте този формат:

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

Контролен списък преди преглед

Преди да подадете, проверете:

• Приложението работи както в реален, така и в тестов режим
• Всички права имат ясно описано предназначение
• Състоянията при грешка се обработват коректно
• Състоянията на зареждане се показват при асинхронни операции
• В продукционния билд няма твърдо записани тестови данни
• URL адресът на политиката за поверителност е достъпен и точен
• Данните за контакт с поддръжката са валидни
• Всички изображения в обявата отговарят на изискванията за размери
• Описанието на приложението отразява точно функционалността

След подаването

Екипът за преглед на Stripe обикновено отговаря в рамките на 5-10 работни дни. Той може да:

• Одобри приложението Ви за публикуване
• Поиска промени с конкретна обратна връзка
• Отхвърли приложението, ако то не отговаря на изискванията

Ако бъдат поискани промени, отстранете всички забележки и подайте отново. Всяко повторно подаване преминава през пълния цикъл на преглед.

Актуализиране на публикувано приложение

За да актуализирате вече публикувано приложение:

1. Увеличете версията в stripe-app.json
2. Качете новата версия: stripe apps upload
3. Подайте актуализацията за преглед
4. След одобрение актуализацията се разгръща автоматично при всички потребители