Konektor Stripe
Hubungkan akun Stripe Anda ke Tajo untuk sinkronisasi baca-saja data pembayaran: pelanggan, charge, langganan, dan invoice masuk ke resolusi kontak, segmentasi, serta otomatisasi berbasis pendapatan (melalui Brevo dan penyedia keterlibatan lainnya).
Ikhtisar
| Properti | Nilai |
|---|---|
| Autentikasi | Secret key Stripe (sk_live_... / sk_test_...) atau restricted key |
| Akses | Baca-saja, Tajo tidak pernah menulis ke akun Stripe Anda |
| API dasar | https://api.stripe.com/v1 |
| Arah sinkronisasi | Stripe → Tajo |
| Webhook real-time | Belum ada, sinkronisasi saat ini berbasis polling |
Penyiapan
- Di Stripe Dashboard, buka Developers → API keys.
- Buat restricted key, izin baca pada Customers, Charges, Subscriptions, dan Invoices sudah cukup. Restricted key jauh lebih disarankan daripada secret key penuh: Tajo hanya membaca, jadi berikan izin baca saja.
- Tempelkan key tersebut ke koneksi Stripe di Tajo.
Koneksi divalidasi dengan permintaan baca-saja sebelum sinkronisasi apa pun dimulai. Rotasikan atau cabut key di Stripe kapan saja.
Apa yang tersinkron
| Data | Apa yang dilakukan Tajo dengannya |
|---|---|
| Pelanggan | Diresolusi menjadi kontak (email, nama, telepon, alamat) untuk identitas dan segmentasi. Persetujuan tidak pernah disimpulkan dari keberadaan sebuah record pelanggan. |
| Charge | Event pendapatan untuk otomatisasi siklus hidup berbasis pembelian dan segmentasi LTV |
| Langganan | Status siklus hidup (active, past_due, canceled…) untuk alur dunning, win-back, dan retensi |
| Invoice | Status pembayaran untuk pesan yang berdekatan dengan penagihan |
Paginasi memakai model kursor Stripe (starting_after), sehingga akun besar tersinkron lengkap dan dapat dilanjutkan setelah terputus.
Batasan saat ini
Dinyatakan terus terang agar Anda dapat merencanakannya:
- Belum ada webhook real-time. Perubahan tiba mengikuti jadwal sinkronisasi, bukan pada saat sebuah pembayaran berhasil. Penerimaan webhook ada dalam roadmap.
- Baca-saja. Tajo tidak membuat atau mengubah pelanggan, pembayaran, atau langganan di Stripe.
- Belum ada Stripe App. Saat ini belum ada aplikasi Tajo di Stripe App Marketplace; koneksinya dikonfigurasi di Tajo, bukan di Stripe Dashboard.
Pemecahan masalah
| Gejala | Penyebab dan solusi |
|---|---|
| 401 dari Stripe | Key dicabut atau dirotasi, tempelkan key yang berlaku ke koneksi |
| Pelanggan tersinkron tetapi charge tidak | Restricted key belum memiliki izin baca pada Charges |
| Kontak tidak punya email | Pelanggan Stripe tanpa email tersinkron sebagai record pendapatan anonim; mereka bergabung ke graf kontak jika emailnya ditambahkan kemudian |
Langkah berikutnya
- Sinkronisasi pelanggan: memetakan pelanggan Stripe ke sistem pencatatan utama Anda
- Bangun otomatisasi dunning dan win-back di Tajo berdasarkan perubahan status langganan