Panduan Integrasi Stripe Apps
Stripe Apps memungkinkan Anda menyematkan fungsionalitas kustom langsung ke Stripe Dashboard. Bagian ini adalah panduan pembuatan: isinya mendokumentasikan bagaimana aplikasi semacam itu untuk integrasi Tajo dan Brevo akan dibangun, diuji, dan dipublikasikan.
Caution
Status: belum dipublikasikan. Saat ini belum ada aplikasi Tajo di Stripe App Marketplace, dan identifier aplikasi, URL, serta kredensial pada halaman-halaman ini adalah placeholder ilustratif, bukan endpoint aktif. Untuk menghubungkan Stripe ke Tajo sekarang, gunakan konektor Stripe (API key terbatas, sinkronisasi baca-saja).
Tip
Tujuannya adalah memublikasikan sebuah integrasi Brevo di Stripe App Marketplace, sehingga merchant Stripe dapat menyinkronkan data pelanggan, pesanan, dan event langsung ke Brevo untuk otomatisasi pemasaran dan CRM.
Apa itu Stripe Apps?
Stripe Apps memperluas Stripe Dashboard dengan komponen UI kustom dan integrasi backend. Stripe Apps memungkinkan developer pihak ketiga untuk:
- Menambahkan tampilan kustom ke halaman Stripe Dashboard (pelanggan, pembayaran, faktur, dan lainnya)
- Mengakses data Stripe melalui izin yang dibatasi cakupannya
- Menyinkronkan data antara Stripe dan platform eksternal seperti Brevo
- Menyediakan alur onboarding dan konfigurasi di dalam Dashboard
Sasaran integrasi Tajo + Brevo
Tajo Stripe App menghubungkan Stripe dengan Brevo untuk menghadirkan:
- Customer Intelligence: Sinkronkan profil pelanggan Stripe, riwayat pembayaran, dan lifetime value ke dalam kontak Brevo
- Pelacakan event: Kirim event Stripe (pembayaran, langganan, pengembalian dana) sebagai event transaksional Brevo
- Kampanye otomatis: Picu kampanye email, SMS, dan WhatsApp Brevo berdasarkan aktivitas Stripe
- Program loyalitas: Bangun alur kerja retensi memakai data pembelian Stripe yang disinkronkan ke Brevo
Ikhtisar arsitektur
Isi panduan
Dokumentasi ini mencakup seluruh siklus hidup pembuatan dan publikasi sebuah Stripe App:
Memulai
| Panduan | Deskripsi |
|---|---|
| Memublikasikan ke Marketplace | Persyaratan dan langkah untuk mengajukan aplikasi Anda ke proses peninjauan |
| Persyaratan Peninjauan Aplikasi | Standar kualitas, keamanan, dan UX untuk memperoleh persetujuan |
Konfigurasi dan referensi
| Panduan | Deskripsi |
|---|---|
| Referensi App Manifest | Skema lengkap untuk berkas manifest stripe-app.json |
| Referensi Izin | Daftar lengkap izin API Stripe dan cara memintanya |
| Referensi Viewport | Lokasi Dashboard tempat UI aplikasi Anda dapat muncul |
Fitur dan integrasi
| Panduan | Deskripsi |
|---|---|
| Stripe Apps Tersemat | Menggunakan komponen tersemat Connect untuk integrasi platform |
| Tautan Instalasi dan Deep Link | Buat URL instalasi dan deep link ke tampilan aplikasi tertentu |
| Tindakan Pascainstalasi | Konfigurasikan alur onboarding setelah aplikasi dipasang |
Operasional dan pertumbuhan
| Panduan | Deskripsi |
|---|---|
| Analitik Aplikasi | Lacak instalasi, tampilan, dan metrik konversi |
| Ekosistem Partner | Manfaatkan program partner Stripe untuk co-marketing dan pertumbuhan |
Prasyarat
Sebelum membangun Stripe App, pastikan Anda memiliki:
- Akun Stripe: Akun Stripe yang sudah diaktifkan (tidak terbatas pada mode uji)
- Stripe CLI: Pasang Stripe CLI untuk pengembangan lokal dan pengunggahan aplikasi
- Node.js: Versi 16 atau yang lebih baru untuk ekstensi UI aplikasi
- Akses platform Tajo: Akun Tajo aktif dengan kredensial API Brevo yang sudah dikonfigurasi
Mulai cepat
# 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 startKonsep utama
App manifest
Setiap Stripe App memiliki manifest stripe-app.json yang mendeklarasikan izin, viewport, dan konfigurasi. Lihat Referensi App Manifest untuk skema lengkapnya.
Ekstensi UI
Stripe Apps dapat merender komponen UI berbasis React di viewport Dashboard tertentu. Toolkit UI menyediakan komponen siap pakai yang selaras dengan sistem desain Stripe Dashboard.
Izin
Aplikasi harus mendeklarasikan sumber daya API Stripe tertentu yang perlu diaksesnya. Pengguna menyetujui izin tersebut saat pemasangan. Lihat Referensi Izin.
Signing secret
Setiap aplikasi menerima sebuah signing secret untuk memverifikasi tanda tangan instalasi dan mengamankan komunikasi antara backend Anda dan Stripe.
Alur kerja pengembangan
- Definisikan manifest Anda beserta izin dan viewport yang dibutuhkan
- Bangun ekstensi UI memakai pustaka komponen React dari Stripe
- Terapkan endpoint backend untuk sinkronisasi data dengan Brevo melalui Tajo
- Uji secara lokal dengan
stripe apps start - Unggah dengan
stripe apps upload - Ajukan untuk peninjauan melalui Stripe Dashboard
- Publikasikan dan pantau melalui analitik
Caution
Stripe mewajibkan aplikasi ditulis dalam bahasa Inggris untuk distribusi di marketplace. Listing aplikasi, teks UI, dan dokumentasi Anda semuanya harus berbahasa Inggris.
Langkah berikutnya
Mulailah dengan Panduan Publikasi untuk memahami seluruh persyaratannya, lalu telusuri referensi teknis untuk mengonfigurasi manifest dan izin aplikasi Anda.