Stripe Apps Entegrasyon Kılavuzu
Stripe Apps, özel işlevleri doğrudan Stripe Dashboard’a gömmenizi sağlar. Bu bölüm bir geliştirme kılavuzudur: Tajo–Brevo entegrasyonu için böyle bir uygulamanın nasıl oluşturulacağını, test edileceğini ve yayımlanacağını belgeler.
Caution
Durum: henüz yayımlanmadı. Bugün Stripe App Marketplace’te bir Tajo uygulaması yoktur ve bu sayfalardaki uygulama tanımlayıcıları, URL’ler ve kimlik bilgileri canlı uç noktalar değil, örnek amaçlı yer tutuculardır. Stripe’ı şu anda Tajo’ya bağlamak için Stripe bağlayıcısını kullanın (kısıtlı API anahtarı, salt okunur senkronizasyon).
Tip
Amaç, Stripe App Marketplace’te bir Brevo entegrasyonu yayımlamak ve Stripe satıcılarının müşteri verilerini, siparişlerini ve olaylarını pazarlama otomasyonu ile CRM için doğrudan Brevo’ya senkronize etmesini sağlamaktır.
Stripe Apps nedir?
Stripe Apps, Stripe Dashboard’u özel arayüz bileşenleri ve arka uç entegrasyonlarıyla genişletir. Üçüncü taraf geliştiricilerin şunları yapmasına olanak tanır:
- Stripe Dashboard sayfalarına (müşteriler, ödemeler, faturalar vb.) özel görünümler ekleme
- Kapsamı sınırlanmış izinler üzerinden Stripe verilerine erişme
- Stripe ile Brevo gibi harici platformlar arasında veri senkronize etme
- Dashboard içinde başlangıç ve yapılandırma akışları sunma
Tajo + Brevo entegrasyon hedefleri
Tajo Stripe uygulaması, Stripe’ı Brevo ile bağlayarak şunları sunar:
- Müşteri zekası: Stripe müşteri profillerini, ödeme geçmişini ve yaşam boyu değeri Brevo kişilerine senkronize edin
- Olay takibi: Stripe olaylarını (ödemeler, abonelikler, iadeler) Brevo işlemsel olayları olarak gönderin
- Otomatik kampanyalar: Stripe etkinliğine göre Brevo e-posta, SMS ve WhatsApp kampanyalarını tetikleyin
- Sadakat programları: Brevo’ya senkronize edilen Stripe satın alma verileriyle elde tutma iş akışları kurun
Mimari genel bakış
Kılavuz içeriği
Bu dokümantasyon, bir Stripe uygulaması oluşturmanın ve yayımlamanın tüm yaşam döngüsünü kapsar:
Başlangıç
| Kılavuz | Açıklama |
|---|---|
| Marketplace’te yayımlama | Uygulamanızı incelemeye göndermek için gereksinimler ve adımlar |
| Uygulama inceleme gereksinimleri | Onay için kalite, güvenlik ve kullanıcı deneyimi standartları |
Yapılandırma ve referans
| Kılavuz | Açıklama |
|---|---|
| Uygulama manifest referansı | stripe-app.json manifest dosyasının tam şeması |
| İzinler referansı | Stripe API izinlerinin tam listesi ve bunları nasıl talep edeceğiniz |
| Viewport referansı | Uygulama arayüzünüzün görünebileceği Dashboard konumları |
Özellikler ve entegrasyon
| Kılavuz | Açıklama |
|---|---|
| Gömülü Stripe uygulamaları | Platform entegrasyonları için Connect gömülü bileşenlerini kullanma |
| Kurulum bağlantıları ve derin bağlantılar | Kurulum URL’leri oluşturma ve belirli uygulama görünümlerine derin bağlantı verme |
| Kurulum sonrası eylemler | Uygulama kurulumundan sonraki başlangıç akışlarını yapılandırma |
Operasyon ve büyüme
| Kılavuz | Açıklama |
|---|---|
| Uygulama analitiği | Kurulumları, görüntülemeleri ve dönüşüm metriklerini takip edin |
| Partner ekosistemi | Ortak pazarlama ve büyüme için Stripe’ın partner programından yararlanın |
Ön koşullar
Bir Stripe uygulaması oluşturmadan önce şunlara sahip olduğunuzdan emin olun:
- Stripe hesabı: Etkinleştirilmiş bir Stripe hesabı (test moduyla sınırlı olmayan)
- Stripe CLI: Yerel geliştirme ve uygulama yüklemeleri için Stripe CLI’yi kurun
- Node.js: Uygulama arayüzü uzantısı için sürüm 16 veya üzeri
- Tajo platform erişimi: Brevo API kimlik bilgileri yapılandırılmış aktif bir Tajo hesabı
Hızlı başlangıç
# Install Stripe CLIbrew install stripe/stripe-cli/stripe
# Login to your Stripe accountstripe login
# Create a new Stripe App projectstripe apps create tajo-brevo-integration
# Start local developmentstripe apps startTemel kavramlar
Uygulama manifesti
Her Stripe uygulamasında izinleri, viewport’ları ve yapılandırmayı bildiren bir stripe-app.json manifesti bulunur. Tam şema için Uygulama manifest referansına bakın.
Arayüz uzantıları
Stripe uygulamaları, belirli Dashboard viewport’larında React tabanlı arayüz bileşenleri gösterebilir. Arayüz araç seti, Stripe Dashboard tasarım sistemiyle uyumlu hazır bileşenler sunar.
İzinler
Uygulamalar, erişmeleri gereken belirli Stripe API kaynaklarını bildirmelidir. Kullanıcılar bu izinleri kurulum sırasında onaylar. İzinler referansına bakın.
İmzalama sırrı
Her uygulama, kurulum imzalarını doğrulamak ve arka ucunuz ile Stripe arasındaki iletişimi güvence altına almak için bir imzalama sırrı alır.
Geliştirme iş akışı
- Gerekli izinler ve viewport’larla manifestinizi tanımlayın
- Arayüz uzantısını Stripe’ın React bileşen kitaplığıyla oluşturun
- Tajo üzerinden Brevo ile veri senkronizasyonu için arka uç uç noktalarını hayata geçirin
stripe apps startile yerelde test edinstripe apps uploadile yükleyin- Stripe Dashboard üzerinden incelemeye gönderin
- Yayımlayın ve analitikle izleyin
Caution
Stripe, marketplace dağıtımı için uygulamaların İngilizce yazılmasını şart koşar. Uygulama listeleme kaydınız, arayüz metinleriniz ve dokümantasyonunuz tamamen İngilizce olmalıdır.
Sonraki adımlar
Tüm gereksinimleri anlamak için Yayımlama kılavuzuyla başlayın, ardından uygulama manifestinizi ve izinlerinizi yapılandırmak için teknik referanslar üzerinde çalışın.