---
title: "Публикация в Stripe App Marketplace | Tajo"
description: "Пошаговое руководство по подготовке, отправке и публикации Вашего Stripe App на маркетплейсе"
url: https://tajo.io/ru/docs/stripe-apps/publish-app/
markdown: https://tajo.io/ru/docs/stripe-apps/publish-app.md
lang: ru-RU
author: "Set Noa"
author_url: https://tajo.io/ru/set-noa/
robots: noindex
---

Подайте заявку на ранний доступ

Укажите имя и рабочий адрес электронной почты. Мы отправим ссылку для подтверждения запроса на доступ к Tajo.

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

[Set Noa](https://tajo.io/ru/set-noa/)

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

Caution

**Статус: запланировано, не создано.** У Tajo нет приложения Stripe, поэтому ничего из этого раздела сегодня нельзя установить. Идентификаторы приложения, URL и учётные данные на этой странице являются иллюстративными заглушками, а не рабочими эндпоинтами.

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

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

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

Caution

Если Вам нужно опубликовать несколько приложений, придётся создать для каждого отдельный аккаунт Stripe.

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

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

Установите в `stripe-app.json` значение `distribution_type` равным `public`:

```json
{
  "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. Подготовьте приложение

Убедитесь, что приложение соответствует всем [требованиям проверки](https://tajo.io/ru/docs/stripe-apps/review-requirements), прежде чем отправлять его:

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

### Шаг 3. Загрузите приложение

Используйте Stripe CLI для загрузки приложения:

```bash
# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list
```

### Шаг 4. Составьте листинг

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

### Шаг 5. Отправьте на проверку

После заполнения листинга отправьте приложение на проверку через Stripe Dashboard. Команда Stripe оценит его по [требованиям к качеству](https://tajo.io/ru/docs/stripe-apps/review-requirements).

### Шаг 6. Опубликуйте

После одобрения Вы можете опубликовать приложение и сделать его доступным на маркетплейсе.

## Настройка манифеста для публичного распространения

Манифест должен содержать `distribution_type: "public"` и объявлять все необходимые разрешения с понятными описаниями цели:

```json
{
  "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": "Read Stripe events so a sync picks up changes"
    },
    {
      "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"
  }
}
```

Загрузите настроенное приложение командой:

```bash
stripe apps upload
```

## Требования к листингу

Листинг приложения должен содержать все перечисленные поля:

| Поле | Требования | Подробности |
| --- | --- | --- |
| **Name** | Не более 35 символов | Отображаемое имя на маркетплейсе |
| **Icon** | 300x300 пикселей, PNG или SVG | Квадратная иконка без скруглённых углов (Stripe добавляет их сам) |
| **Built by** | Название компании или разработчика | Отображается под именем приложения |
| **Category** | Выбор из категорий Stripe | Выберите наиболее подходящую для приложения категорию |
| **Subtitle** | Не более 80 символов | Краткий слоган, который показывается в результатах поиска |
| **About** | Не более 1 000 символов | Подробное описание того, что делает приложение |
| **Key Features** | До 5 пунктов, с изображениями | Опишите основные возможности со скриншотами или схемами |
| **Pricing** | Бесплатно, платно или freemium | Чётко укажите модель ценообразования и все расходы |
| **Support** | URL или email поддержки | Куда пользователи могут обратиться за помощью |
| **Privacy Policy** | URL политики конфиденциальности | Обязательный юридический документ об обработке данных |

### Требования к имени

- Должно быть уникальным на маркетплейсе
- Должно ясно отражать назначение приложения
- Избегайте общих слов, которые могут запутать пользователей
- Пример: «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 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

```bash
# 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: reviewer@test.tajo.io
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. После одобрения обновление автоматически разворачивается у всех пользователей

Tip

Небольшие исправления ошибок и нефункциональные изменения могут пройти ускоренную проверку. Крупные новые возможности или изменения разрешений требуют полной проверки.