Публикация в Stripe App Marketplace

Публикация Stripe App на маркетплейсе делает его доступным для всех пользователей Stripe. Это руководство охватывает требования, подготовительные шаги и процесс отправки.

Предварительные требования

Перед публикацией приложения в Stripe App Marketplace необходимо выполнить следующие условия:

• Активированный аккаунт Stripe: Ваш аккаунт не должен быть ограничен только тестовым режимом
• Одно приложение на аккаунт: Каждый аккаунт Stripe может опубликовать только одно публичное приложение на маркетплейсе
• Только английский язык: Весь контент приложения, текст UI и информация листинга должны быть на английском
• Завершённое приложение: Ваше приложение должно быть полностью функциональным и протестированным

Шаги публикации

Шаг 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. Проверьте, что весь текст UI на английском

Шаг 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 Brevo

1. Синхронизация покупателей в реальном времени, Автоматическая синхронизация профилей покупателей Stripe в контакты Brevo с полной историей покупок
2. Автоматизация на основе событий, Запуск рабочих процессов Brevo по событиям Stripe: успешные платежи, изменения подписок, возвраты
3. Синхронизация каталога товаров, Поддержание актуальности каталога Brevo в соответствии со Stripe для персонализированного контента кампаний
4. Мультиканальные кампании, Использование синхронизированных данных для целевых email, SMS и WhatsApp-кампаний
5. Инсайты Dashboard, Просмотр метрик вовлечённости Brevo прямо в Stripe Dashboard

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

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

# Verify sandbox compatibility
stripe apps validate

Чеклист проверки

Перед отправкой убедитесь:

• Приложение работает в живом и тестовом режимах
• Все разрешения имеют понятные описания цели
• Состояния ошибок обработаны корректно
• Состояния загрузки отображаются для асинхронных операций
• В production-сборке нет захардкоженных тестовых данных
• URL политики конфиденциальности доступен и актуален
• Контактная информация поддержки валидна
• Все изображения листинга соответствуют требованиям к размерам
• Описание приложения точно отражает функциональность

После отправки

Команда Stripe обычно отвечает в течение 5-10 рабочих дней. Они могут:

• Одобрить приложение для публикации
• Запросить изменения с конкретной обратной связью
• Отклонить приложение, если оно не соответствует требованиям

Обновление опубликованного приложения

Для обновления уже опубликованного приложения:

1. Увеличьте версию в stripe-app.json
2. Загрузите новую версию: stripe apps upload
3. Отправьте обновление на проверку
4. После одобрения обновление автоматически развернётся у всех пользователей