Stripe App Marketplace'te Yayınlama

Stripe App’inizi marketplace’te yayınlamak, uygulamayı tüm Stripe kullanıcılarının erişimine açar. Bu kılavuz gereksinimleri, hazırlık adımlarını ve gönderim sürecini kapsar.

Ön koşullar

Stripe App Marketplace’te bir uygulama yayınlayabilmeniz için şu gereksinimleri karşılamanız gerekir:

• Etkinleştirilmiş Stripe hesabı: Hesabınız yalnızca test moduyla sınırlı olamaz
• Hesap başına tek uygulama: Her Stripe hesabı marketplace’te yalnızca bir herkese açık uygulama yayınlayabilir
• Yalnızca İngilizce: Tüm uygulama içeriği, arayüz metinleri ve listeleme bilgileri İngilizce olmalıdır
• Tamamlanmış uygulama: Uygulamanız tam olarak çalışır durumda ve test edilmiş olmalıdır

Yayınlama adımları

Adım 1: Manifest dosyanızı güncelleyin

stripe-app.json dosyanızdaki distribution_type değerini public olarak ayarlayın:

{
  "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"
    }
  ]
}

Adım 2: Uygulamanızı hazırlayın

Göndermeden önce uygulamanızın tüm inceleme gereksinimlerini karşıladığından emin olun:

1. Hem canlı hem de sandbox modunda kapsamlı şekilde test edin
2. Tüm izinlerin gerekli olduğunu ve belgelendiğini doğrulayın
3. Hata yönetimi ve yükleme durumlarının uygulandığını teyit edin
4. Tüm arayüz metinlerinin İngilizce olduğunu kontrol edin

Adım 3: Uygulamanızı yükleyin

Uygulamanızı yüklemek için Stripe CLI’yi kullanın:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Adım 4: Listeleme metninizi yazın

Uygulama listelemenizi tamamlamak için Stripe yönetim paneline gidin. Marketplace’e gönderim için tüm listeleme alanları zorunludur.

Adım 5: İncelemeye gönderin

Listelemenizi tamamladıktan sonra uygulamayı Stripe yönetim paneli üzerinden incelemeye gönderin. Stripe ekibi uygulamanızı kalite gereksinimleri doğrultusunda değerlendirecektir.

Adım 6: Yayınlayın

Onaylandıktan sonra uygulamanızı yayınlayarak marketplace’te erişilebilir hale getirebilirsiniz.

Herkese açık dağıtım için manifest ayarları

Manifest dosyası distribution_type: "public" değerini içermeli ve gerekli tüm izinleri net amaç açıklamalarıyla birlikte bildirmelidir:

{
  "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": "Subscribe to Stripe events for real-time Brevo sync"
    },
    {
      "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"
  }
}

Yapılandırılmış uygulamayı şu komutla yükleyin:

stripe apps upload

Listeleme gereksinimleri

Uygulama listelemeniz aşağıdaki alanların tümünü içermelidir:

Ad kuralları

• Marketplace’te benzersiz olmalıdır
• Uygulamanızın amacını açıkça belirtmelidir
• Kullanıcıların kafasını karıştırabilecek genel ifadelerden kaçının
• Örnek: “Tajo for Brevo” (15 karakter)

Simge kuralları

• Boyutlar: tam olarak 300x300 piksel
• Biçim: PNG veya SVG
• Köşeleri yuvarlatmayın, Stripe bunu otomatik olarak uygular
• Net ve tanınabilir bir logo veya sembol kullanın
• Küçük boyutlarda okunabilirliğinden emin olun

Hakkında bölümü

Şu noktaları kapsayan, ilgi çekici bir açıklama yazın:

• Uygulamanızın hangi sorunu çözdüğü
• Temel entegrasyon yetenekleri
• Uygulamanın kimler için tasarlandığı
• Varsa ön koşullar veya gereksinimler

Örnek:

Tajo for Brevo, Stripe ödeme verilerinizi Brevo’nun pazarlama otomasyonu platformuna bağlar. Müşterileri otomatik olarak senkronize edin, ödeme olaylarını izleyin ve gerçek zamanlı satın alma davranışına dayalı kişiselleştirilmiş e-posta, SMS ve WhatsApp kampanyaları tetikleyin. Veriye dayalı elde tutma pazarlamasıyla müşteri yaşam boyu değerini en üst düzeye çıkarmak isteyen e-ticaret işletmeleri için geliştirildi.

Öne çıkan özellikler

Her öne çıkan özellik girdisi şunları içerir:

• Başlık: Kısa özellik adı
• Açıklama: Özelliği anlatan bir veya iki cümle
• Görsel: Ekran görüntüsü veya diyagram (önerilen: 1600x900 piksel)

Tajo Brevo entegrasyonu için önerilen özellikler:

1. Gerçek zamanlı müşteri senkronizasyonu, Stripe müşteri profillerini satın alma geçmişinin tamamıyla birlikte Brevo kişilerine otomatik olarak senkronize edin
2. Olay tabanlı otomasyon, Başarılı ödemeler, abonelik değişiklikleri ve iadeler gibi Stripe olaylarından Brevo iş akışlarını tetikleyin
3. Ürün kataloğu senkronizasyonu, Kişiselleştirilmiş kampanya içeriği için Brevo ürün kataloğunuzu Stripe ile senkron tutun
4. Çok kanallı kampanyalar, Senkronize edilen verileri hedefli e-posta, SMS ve WhatsApp kampanyalarını beslemek için kullanın
5. Panel içgörüleri, Brevo etkileşim metriklerini doğrudan Stripe yönetim panelinin müşteri görünümünde inceleyin

Fiyatlandırma bilgisi

Fiyatlandırma modelinizi açıkça iletin:

• Ücretsiz: Kurulum veya kullanım için ücret yok
• Ücretli: Fiyatı ve faturalandırma sıklığını belirtin
• Freemium: Ücretsiz olarak nelerin dahil olduğunu ve neyin ödeme gerektirdiğini açıklayın
• Kullanıma dayalı: Fiyatlandırma kademelerini veya birim başına maliyetleri açıklayın

Uygulamanızı test etme

Göndermeden önce uygulamanızı kapsamlı şekilde test edin:

Sandbox modunda test edin

# Start your app in test mode
stripe apps start --mode test

# Verify sandbox compatibility
stripe apps validate

Test kimlik bilgileri biçimi

İnceleme ekibine test kimlik bilgilerini sağlarken şu biçimi kullanın:

Test Account Credentials
========================
Platform: Tajo
URL: https://app.tajo.io/test
Email: [email protected]
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

İnceleme kontrol listesi

Göndermeden önce şunları doğrulayın:

• Uygulama hem canlı hem de test modunda çalışıyor
• Tüm izinlerin net amaç açıklamaları var
• Hata durumları düzgün şekilde ele alınıyor
• Asenkron işlemler için yükleme durumları gösteriliyor
• Üretim derlemesinde sabit kodlanmış test verisi yok
• Gizlilik politikası URL’si erişilebilir ve doğru
• Destek iletişim bilgileri geçerli
• Tüm listeleme görselleri boyut gereksinimlerini karşılıyor
• Uygulama açıklaması işlevselliği doğru şekilde yansıtıyor

Gönderimden sonra

Stripe inceleme ekibi genellikle 5-10 iş günü içinde yanıt verir. Ekip şunları yapabilir:

• Uygulamanızı yayın için onaylayabilir
• Belirli geri bildirimlerle değişiklik talep edebilir
• Gereksinimleri karşılamıyorsa uygulamayı reddedebilir

Değişiklik talep edilirse tüm geri bildirimleri ele alın ve yeniden gönderin. Her yeni gönderim, inceleme döngüsünün tamamından geçer.

Yayınlanmış bir uygulamayı güncelleme

Halihazırda yayınlanmış bir uygulamayı güncellemek için:

1. stripe-app.json dosyasındaki sürüm numarasını artırın
2. Yeni sürümü yükleyin: stripe apps upload
3. Güncellemeyi incelemeye gönderin
4. Onaylandıktan sonra güncelleme tüm kullanıcılara otomatik olarak dağıtılır