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

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

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

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

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

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

Шаг 1. Обновите манифест

Установите в stripe-app.json значение distribution_type равным 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 connects your Stripe payment data with Brevo’s marketing automation platform. Automatically sync customers, track payment events, and trigger personalized email, SMS, and WhatsApp campaigns based on real-time purchase behavior. Built for ecommerce businesses that want to maximize customer lifetime value through data-driven retention marketing.

Ключевые возможности

Каждая запись о ключевой возможности включает:

• Заголовок: короткое название возможности
• Описание: одно или два предложения с пояснением
• Изображение: скриншот или схема (рекомендуется 1600x900 пикселей)

Рекомендуемые возможности для интеграции Tajo с Brevo:

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

Чек-лист перед отправкой

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

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

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

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

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

Если запрошены изменения, устраните все замечания и отправьте приложение повторно. Каждая повторная отправка проходит полный цикл проверки.

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

Чтобы обновить уже опубликованное приложение:

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