Ръководство за интеграция на Stripe Apps

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

Какво представляват Stripe Apps?

Stripe Apps разширяват таблото на Stripe с персонализирани UI компоненти и backend интеграции. Те позволяват на разработчици от трети страни да:

• Добавят персонализирани изгледи към страниците на таблото на Stripe (клиенти, плащания, фактури и т.н.)
• Получават достъп до данни на Stripe чрез ограничени разрешения
• Синхронизират данни между Stripe и външни платформи като Brevo
• Предоставят потоци за въвеждане и конфигурация в таблото

Цели на интеграцията Tajo + Brevo

Stripe App на Tajo свързва Stripe с Brevo за:

• Клиентско разузнаване: Синхронизиране на клиентски профили, история на плащанията и доживотна стойност от Stripe в контакти в Brevo
• Проследяване на събития: Изпращане на събитията от Stripe (плащания, абонаменти, възстановявания) като транзакционни събития в Brevo
• Автоматизирани кампании: Задействане на кампании за имейл, SMS и WhatsApp в Brevo въз основа на активността в Stripe
• Програми за лоялност: Изграждане на работни потоци за задържане, използвайки данни за покупки от Stripe, синхронизирани с Brevo

Преглед на архитектурата

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Табло на Stripe │────▶│   Платформа Tajo │────▶│     Brevo       │
│  (UI на App)    │◀────│   (Посредник)    │◀────│   (CRM/Имейл)   │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                        │                        │
   Изгледи на клиенти      Синхронизация          Контакти,
   Детайли за плащания      на данни и             Кампании,
   Настройки на App         Маршрутизиране         Автоматизации
                             на webhook-и

Съдържание на ръководството

Тази документация обхваща пълния жизнен цикъл на изграждане и публикуване на Stripe App:

Начало на работа

Конфигурация и справочник

Функции и интеграция

Операции и растеж

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

Преди изграждане на Stripe App се уверете, че имате:

1. Акаунт в Stripe: Активиран акаунт в Stripe (не ограничен до режим на тест)
2. Stripe CLI: Инсталирайте Stripe CLI за локална разработка
3. Node.js: Версия 16 или по-нова за UI разширението на app
4. Достъп до платформата Tajo: Активен акаунт в Tajo с конфигурирани Brevo API идентификационни данни

Бърз старт

# Инсталирайте Stripe CLI
brew install stripe/stripe-cli/stripe

# Влезте в акаунта си в Stripe
stripe login

# Създайте нов проект за Stripe App
stripe apps create tajo-brevo-integration

# Стартирайте локална разработка
stripe apps start

Ключови концепции

Манифест на App

Всеки Stripe App има манифест stripe-app.json, декларираш разрешения, viewport-и и конфигурация. Вижте Справочник за манифест на App за пълната схема.

UI разширения

Stripe Apps могат да рендерират базирани на React UI компоненти в специфични viewport-и на таблото. Инструментариумът за UI предоставя предварително изградени компоненти, съответстващи на дизайн системата на таблото на Stripe.

Разрешения

Apps трябва да декларират конкретните ресурси на Stripe API, до които имат достъп. Потребителите одобряват тези разрешения по време на инсталирането. Вижте Справочник за разрешения.

Секрет за подписване

Всеки app получава секрет за подписване за проверка на подписите при инсталиране и осигуряване на комуникацията между вашия backend и Stripe.

Работен поток за разработка

1. Дефинирайте вашия манифест с необходимите разрешения и viewport-и
2. Изградете UI разширението с библиотека от React компоненти на Stripe
3. Имплементирайте backend крайни точки за синхронизиране на данни с Brevo чрез Tajo
4. Тествайте локално с stripe apps start
5. Качете с stripe apps upload
6. Подайте за преглед чрез таблото на Stripe
7. Публикувайте и наблюдавайте чрез анализи

Следващи стъпки

Започнете с Ръководство за публикуване, за да разберете пълните изисквания, след което преминете през техническите справочници за конфигуриране на манифеста и разрешенията на вашия app.