Poproś o wcześniejszy dostęp

Podaj imię oraz adres e-mail lub numer telefonu. Wyślemy Ci informacje o dostępie do Tajo.

Na tej stronie

Przewodnik po integracji Stripe Apps

Aplikacje Stripe pozwalają osadzić własne funkcje bezpośrednio w panelu Stripe. Ta sekcja jest przewodnikiem po budowie: opisuje, jak taka aplikacja dla integracji Tajo z Brevo zostałaby zbudowana, przetestowana i opublikowana.

Caution

Status: jeszcze nieopublikowana. W Stripe App Marketplace nie ma dziś żadnej aplikacji Tajo, a identyfikatory aplikacji, adresy URL i dane dostępowe na tych stronach są przykładowymi symbolami zastępczymi, a nie działającymi endpointami. Aby połączyć Stripe z Tajo już teraz, użyj konektora Stripe (ograniczony klucz API, synchronizacja tylko do odczytu).

Tip

Celem jest opublikowanie integracji z Brevo w Stripe App Marketplace, aby sprzedawcy korzystający ze Stripe mogli synchronizować dane klientów, zamówienia i zdarzenia bezpośrednio z Brevo na potrzeby automatyzacji marketingu i CRM.

Czym są aplikacje Stripe?

Aplikacje Stripe rozszerzają panel Stripe o własne komponenty interfejsu i integracje backendowe. Pozwalają zewnętrznym deweloperom:

Dodawać własne widoki do stron panelu Stripe (klienci, płatności, faktury itd.)
Uzyskiwać dostęp do danych Stripe poprzez zakresy uprawnień
Synchronizować dane między Stripe a zewnętrznymi platformami, takimi jak Brevo
Udostępniać procesy onboardingu i konfiguracji wewnątrz panelu

Cele integracji Tajo + Brevo

Aplikacja Tajo dla Stripe łączy Stripe z Brevo, aby dostarczyć:

Wiedzę o klientach: synchronizację profili klientów Stripe, historii płatności i wartości życiowej klienta do kontaktów w Brevo
Śledzenie zdarzeń: przesyłanie zdarzeń Stripe (płatności, subskrypcje, zwroty) jako zdarzeń transakcyjnych Brevo
Automatyczne kampanie: uruchamianie kampanii email, SMS i WhatsApp w Brevo na podstawie aktywności w Stripe
Programy lojalnościowe: budowanie procesów retencji na podstawie danych zakupowych ze Stripe zsynchronizowanych z Brevo

Przegląd architektury

Dokąd trafiają dane aplikacji Stripe

Zawartość przewodnika

Ta dokumentacja obejmuje pełny cykl życia budowania i publikowania aplikacji Stripe:

Pierwsze kroki

Przewodnik	Opis
Publikacja w Marketplace	Wymagania i kroki potrzebne do zgłoszenia aplikacji do weryfikacji
Wymagania weryfikacji aplikacji	Standardy jakości, bezpieczeństwa i UX niezbędne do zatwierdzenia

Konfiguracja i dokumentacja referencyjna

Przewodnik	Opis
Dokumentacja manifestu aplikacji	Pełny schemat pliku manifestu `stripe-app.json`
Dokumentacja uprawnień	Pełna lista uprawnień API Stripe i sposób ich żądania
Dokumentacja viewportów	Miejsca w panelu, w których może pojawić się interfejs Twojej aplikacji

Funkcje i integracja

Przewodnik	Opis
Osadzone aplikacje Stripe	Korzystanie z osadzonych komponentów Connect w integracjach platformowych
Linki instalacyjne i deep linki	Generowanie adresów instalacji i deep linków do konkretnych widoków aplikacji
Działania po instalacji	Konfiguracja procesów onboardingu po instalacji aplikacji

Operacje i wzrost

Przewodnik	Opis
Analityka aplikacji	Śledzenie instalacji, wyświetleń i wskaźników konwersji
Ekosystem partnerski	Wykorzystanie programu partnerskiego Stripe do wspólnego marketingu i wzrostu

Wymagania wstępne

Zanim zaczniesz budować aplikację Stripe, upewnij się, że masz:

Konto Stripe: aktywowane konto Stripe (nieograniczone do trybu testowego)
Stripe CLI: zainstalowane Stripe CLI do lokalnego programowania i przesyłania aplikacji
Node.js: wersję 16 lub nowszą na potrzeby rozszerzenia interfejsu aplikacji
Dostęp do platformy Tajo: aktywne konto Tajo ze skonfigurowanymi danymi dostępowymi API Brevo

Szybki start

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Kluczowe pojęcia

Manifest aplikacji

Każda aplikacja Stripe ma manifest stripe-app.json, który deklaruje uprawnienia, viewporty i konfigurację. Pełny schemat znajdziesz w dokumentacji manifestu aplikacji.

Rozszerzenia interfejsu

Aplikacje Stripe mogą renderować komponenty interfejsu oparte na React w określonych viewportach panelu. Zestaw narzędzi UI udostępnia gotowe komponenty zgodne z systemem projektowym panelu Stripe.

Uprawnienia

Aplikacje muszą zadeklarować konkretne zasoby API Stripe, do których potrzebują dostępu. Użytkownicy zatwierdzają te uprawnienia podczas instalacji. Zobacz dokumentację uprawnień.

Sekret podpisujący

Każda aplikacja otrzymuje sekret podpisujący, który służy do weryfikacji podpisów instalacji i zabezpieczenia komunikacji między Twoim backendem a Stripe.

Proces tworzenia aplikacji

Zdefiniuj manifest z wymaganymi uprawnieniami i viewportami
Zbuduj rozszerzenie interfejsu, korzystając z biblioteki komponentów React od Stripe
Zaimplementuj endpointy backendowe do synchronizacji danych z Brevo przez Tajo
Przetestuj lokalnie za pomocą stripe apps start
Prześlij aplikację poleceniem stripe apps upload
Zgłoś ją do weryfikacji w panelu Stripe
Opublikuj i monitoruj dzięki analityce