Menerbitkan ke Stripe App Marketplace

Menerbitkan Stripe App Anda ke marketplace membuatnya tersedia bagi seluruh pengguna Stripe. Panduan ini membahas persyaratan, langkah persiapan, dan proses pengiriman.

Prasyarat

Sebelum dapat menerbitkan app ke Stripe App Marketplace, Anda harus memenuhi persyaratan berikut:

• Akun Stripe yang sudah aktif: Akun Anda tidak boleh terbatas pada test mode saja
• Satu app per akun: Setiap akun Stripe hanya dapat menerbitkan satu app publik ke marketplace
• Hanya bahasa Inggris: Seluruh konten app, teks UI, dan informasi listing harus dalam bahasa Inggris
• App yang sudah selesai: App Anda harus berfungsi penuh dan sudah diuji

Langkah penerbitan

Langkah 1: Perbarui manifest Anda

Setel distribution_type di stripe-app.json Anda menjadi public:

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

Langkah 2: Siapkan app Anda

Pastikan app Anda memenuhi seluruh persyaratan review sebelum mengirimkannya:

1. Uji secara menyeluruh dalam live mode maupun sandbox mode
2. Verifikasi bahwa semua permission memang diperlukan dan terdokumentasi
3. Pastikan penanganan kesalahan dan loading state sudah diterapkan
4. Periksa bahwa seluruh teks UI menggunakan bahasa Inggris

Langkah 3: Unggah app Anda

Gunakan Stripe CLI untuk mengunggah app Anda:

# Upload your app to Stripe
stripe apps upload

# Verify the upload
stripe apps versions list

Langkah 4: Tulis listing Anda

Buka Stripe Dashboard untuk melengkapi listing app Anda. Semua kolom listing wajib diisi untuk pengiriman ke marketplace.

Langkah 5: Kirim untuk review

Setelah listing Anda lengkap, kirim app untuk direview melalui Stripe Dashboard. Tim Stripe akan mengevaluasi app Anda terhadap persyaratan kualitas.

Langkah 6: Terbitkan

Setelah disetujui, Anda dapat menerbitkan app agar tersedia di marketplace.

Pengaturan manifest untuk distribusi publik

Manifest harus menyertakan distribution_type: "public" dan mendeklarasikan semua permission yang diperlukan beserta deskripsi tujuan yang jelas:

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

Unggah app yang sudah dikonfigurasi dengan:

stripe apps upload

Persyaratan listing

Listing app Anda harus mencakup seluruh kolom berikut:

Panduan nama

• Harus unik di marketplace
• Sebaiknya menjelaskan tujuan app Anda dengan jelas
• Hindari istilah umum yang dapat membingungkan pengguna
• Contoh: “Tajo for Brevo” (15 karakter)

Panduan ikon

• Dimensi: tepat 300x300 piksel
• Format: PNG atau SVG
• Jangan tambahkan sudut membulat, Stripe menerapkannya secara otomatis
• Gunakan logo atau simbol yang jelas dan mudah dikenali
• Pastikan tetap terbaca pada ukuran kecil

Bagian About

Tulis deskripsi yang meyakinkan dan mencakup:

• Masalah apa yang diselesaikan app Anda
• Kemampuan integrasi utama
• Siapa target pengguna app ini
• Prasyarat atau persyaratan apa pun

Contoh:

Tajo for Brevo menghubungkan data pembayaran Stripe Anda dengan platform otomatisasi pemasaran Brevo. Sinkronkan pelanggan secara otomatis, lacak event pembayaran, dan picu kampanye email, SMS, serta WhatsApp yang dipersonalisasi berdasarkan perilaku pembelian secara real-time. Dibangun untuk bisnis e-commerce yang ingin memaksimalkan nilai seumur hidup pelanggan melalui pemasaran retensi berbasis data.

Key Features

Setiap entri fitur utama mencakup:

• Judul: Nama fitur yang singkat
• Deskripsi: Satu hingga dua kalimat yang menjelaskan fitur tersebut
• Gambar: Tangkapan layar atau diagram (disarankan 1600x900 piksel)

Fitur yang disarankan untuk integrasi Tajo Brevo:

1. Sinkronisasi pelanggan real-time, Sinkronkan profil pelanggan Stripe ke kontak Brevo secara otomatis beserta riwayat pembelian lengkap
2. Otomatisasi berbasis event, Picu alur kerja Brevo dari event Stripe seperti pembayaran berhasil, perubahan langganan, dan pengembalian dana
3. Sinkronisasi katalog produk, Jaga katalog produk Brevo Anda tetap sinkron dengan Stripe untuk konten kampanye yang dipersonalisasi
4. Kampanye multi-saluran, Manfaatkan data tersinkronisasi untuk menjalankan kampanye email, SMS, dan WhatsApp yang tertarget
5. Wawasan dasbor, Lihat metrik keterlibatan Brevo langsung di tampilan pelanggan Stripe Dashboard

Informasi harga

Komunikasikan model harga Anda dengan jelas:

• Gratis: Tanpa biaya untuk memasang atau menggunakan
• Berbayar: Nyatakan harga dan frekuensi penagihan
• Freemium: Jelaskan apa yang termasuk gratis dan apa yang memerlukan pembayaran
• Berbasis penggunaan: Jelaskan tingkatan harga atau biaya per unit

Menguji app Anda

Sebelum pengiriman, uji app Anda secara menyeluruh:

Uji dalam sandbox mode

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

# Verify sandbox compatibility
stripe apps validate

Format kredensial uji

Saat menyediakan kredensial uji untuk tim review, gunakan format berikut:

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

Daftar periksa review

Sebelum mengirimkan, verifikasi hal berikut:

• App berfungsi dalam live mode maupun test mode
• Semua permission memiliki deskripsi tujuan yang jelas
• Status kesalahan ditangani dengan baik
• Loading state ditampilkan untuk operasi asinkron
• Tidak ada data uji yang di-hardcode pada build produksi
• URL kebijakan privasi dapat diakses dan akurat
• Informasi kontak dukungan valid
• Semua gambar listing memenuhi persyaratan dimensi
• Deskripsi app mencerminkan fungsionalitasnya secara akurat

Setelah pengiriman

Tim review Stripe biasanya merespons dalam 5-10 hari kerja. Mereka dapat:

• Menyetujui app Anda untuk diterbitkan
• Meminta perubahan disertai masukan yang spesifik
• Menolak app jika tidak memenuhi persyaratan

Jika perubahan diminta, tangani seluruh masukan lalu kirim ulang. Setiap pengiriman ulang melalui siklus review penuh.

Memperbarui app yang sudah diterbitkan

Untuk memperbarui app yang sudah diterbitkan:

1. Naikkan versi di stripe-app.json
2. Unggah versi baru: stripe apps upload
3. Kirim pembaruan tersebut untuk direview
4. Setelah disetujui, pembaruan otomatis diterapkan ke seluruh pengguna