--- title: "Публикуване в Stripe App Marketplace | Tajo" description: "Ръководство стъпка по стъпка за подготовка, подаване и публикуване на Вашето Stripe App в маркетплейса" url: https://tajo.io/bg/docs/stripe-apps/publish-app/ markdown: https://tajo.io/bg/docs/stripe-apps/publish-app.md lang: bg-BG author: "Set Noa" author_url: https://tajo.io/bg/set-noa/ robots: noindex --- Заявете ранен достъп Въведете собственото си име и служебен имейл адрес. Ще ви изпратим връзка за потвърждение на заявката за достъп до Tajo. # Публикуване в Stripe App Marketplace [Set Noa](https://tajo.io/bg/set-noa/) Публикуването на Вашето Stripe App в маркетплейса го прави достъпно за всички потребители на Stripe. Това ръководство обхваща изискванията, стъпките за подготовка и процеса на подаване. Caution **Статус: планирано, не е изградено.** Tajo няма приложение за Stripe, така че нищо в този раздел не може да бъде инсталирано днес. Идентификаторите на приложения, адресите и идентификационните данни на тази страница са илюстративни примери, а не действащи крайни точки. ## Предварителни изисквания Преди да публикувате приложение в Stripe App Marketplace, трябва да отговаряте на следните изисквания: - **Активиран Stripe акаунт**: акаунтът Ви не може да бъде ограничен само до тестов режим - **По едно приложение на акаунт**: всеки Stripe акаунт може да публикува само едно публично приложение в маркетплейса - **Само на английски**: цялото съдържание на приложението, текстовете в интерфейса и информацията в обявата трябва да бъдат на английски - **Завършено приложение**: приложението Ви трябва да е напълно функционално и тествано Caution Ако трябва да публикувате няколко приложения, създайте отделен Stripe акаунт за всяко от тях. ## Стъпки за публикуване ### Стъпка 1: Актуализирайте манифеста си Задайте `distribution_type` във Вашия `stripe-app.json` на `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/bg/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/bg/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** | Максимум 1000 знака | Подробно описание на това, което прави приложението Ви | | **Key Features** | До 5, с изображения | Откройте основните функции със снимки на екрана или диаграми | | **Pricing** | Безплатно, платено или freemium | Посочете ясно ценовия модел и всички разходи | | **Support** | URL или имейл за контакт | Къде потребителите могат да получат помощ за приложението Ви | | **Privacy Policy** | URL към политиката за поверителност | Задължителен правен документ за обработката на данни | ### Насоки за името - Трябва да е уникално в маркетплейса - Трябва ясно да показва предназначението на приложението Ви - Избягвайте общи термини, които могат да объркат потребителите - Пример: „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 режим ```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 ``` ### Контролен списък преди преглед Преди да подадете, проверете: - Приложението работи както в реален, така и в тестов режим - Всички права имат ясно описано предназначение - Състоянията при грешка се обработват коректно - Състоянията на зареждане се показват при асинхронни операции - В продукционния билд няма твърдо записани тестови данни - URL адресът на политиката за поверителност е достъпен и точен - Данните за контакт с поддръжката са валидни - Всички изображения в обявата отговарят на изискванията за размери - Описанието на приложението отразява точно функционалността ## След подаването Екипът за преглед на Stripe обикновено отговаря в рамките на 5-10 работни дни. Той може да: - **Одобри** приложението Ви за публикуване - **Поиска промени** с конкретна обратна връзка - **Отхвърли** приложението, ако то не отговаря на изискванията Ако бъдат поискани промени, отстранете всички забележки и подайте отново. Всяко повторно подаване преминава през пълния цикъл на преглед. ## Актуализиране на публикувано приложение За да актуализирате вече публикувано приложение: 1. Увеличете версията в `stripe-app.json` 2. Качете новата версия: `stripe apps upload` 3. Подайте актуализацията за преглед 4. След одобрение актуализацията се разгръща автоматично при всички потребители Tip Дребни поправки на грешки и промени без функционален ефект може да получат ускорен преглед. Добавянето на големи функции или промените в правата изискват пълен преглед.