Firebase Extensions | Mengirim Invoice Menggunakan Stripe

Cara kerja ekstensi ini

Gunakan ekstensi ini untuk membuat dan mengirimkan invoice khas brand kepada pelanggan menggunakan plarform pembayaran Stripe.

Invoice tersebut otomatis disesuaikan dengan logo dan tema warna dari bisnis yang telah Anda siapkan di Stripe. Setelah invoice dikirimkan, Anda dapat menggunakan dasbor Stripe untuk melacak apakah pelanggan sudah membayar dan melacak jumlah uang yang Anda proses dengan diagram dan pelaporan mendetail.

Ekstensi ini memproses koleksi Cloud Firestore yang ditentukan untuk dokumen baru (seperti contoh di bawah ini). Saat Anda menambahkan dokumen, Stripe menggunakan informasi invoice dalam dokumen tersebut untuk membuat invoice di sistemnya, lalu mengirimkan invoice tersebut ke alamat email yang tertera dalam dokumen. Anda dapat secara opsional mengelola alamat email pelanggan menggunakan ID pengguna Firebase Authentication.

email: "pelanggan@contoh.com",
item: [{
    amount: 2000,
    currency: "usd",
    quantity: 2, // Optional, defaults to 1.
    description: "Growth plan"
}]

Berikut adalah contoh tampilan invoice Anda yang disesuaikan.

Halaman invoice yang menampilkan tanda terima mendetail, dengan opsi membayar dengan kartu atau transfer bank

Fitur opsional dari ekstensi ini adalah untuk otomatis memperbarui status invoice dalam dokumen Cloud Firestore-nya. Anda dapat mengonfigurasi fitur ini setelah menginstal ekstensi dengan mendaftarkan webhook Stripe yang memproses peristiwa invoice Stripe. Jika Anda ingin menggunakan fitur opsional ini, biarkan parameter Stripe webhook secret kosong selama penginstalan. Kemudian, konfigurasi ulang ekstensi Anda yang terinstal nanti dengan nilai sebenarnya untuk webhook yang didaftarkan. Detail selengkapnya tentang proses ini disediakan setelah penginstalan.

Penyiapan tambahan

Sebelum menginstal ekstensi ini, siapkan layanan Firebase berikut di project Firebase Anda:

Cloud Firestore untuk menyimpan informasi invoice dan, secara opsional, status invoice.
- Ikuti langkah-langkah dalam [dokumentasi] (https://firebase.google.com/docs/firestore/quickstart#create) untuk membuat database Cloud Firestore.
Firebase Authentication untuk secara opsional mengelola email dan data pelanggan.
- Aktifkan metode login dalam Firebase console yang ingin Anda tawarkan kepada pengguna.

Anda juga harus memiliki akun Stripe dan kunci API Stripe sebelum menginstal ekstensi ini.

Catatan: Stripe memiliki mode pengujian yang memungkinkan Anda melakukan panggilan API tanpa melakukan pembayaran yang sebenarnya. Untuk menggunakan ekstensi ini dengan mode pengujian Stripe, tetapkan parameter Stripe API key pada ekstensi (selama konfigurasi ekstensi) untuk menggunakan kunci mode pengujian. Kunci mode pengujian terlihat seperti rk_test_12345, sedangkan kunci mode live terlihat seperti rk_live_12345. Karena ekstensi ini hanya memerlukan akses tulis ke resource customers dan invoices Stripe, sebaiknya Anda membuat kunci yang dibatasi dengan akses terbatas hanya ke resource tersebut, bukan menggunakan kunci rahasia.

Penagihan

Ekstensi ini menggunakan layanan Firebase berikut yang mungkin mengenakan tagihan terkait:

Cloud Firestore
Cloud Functions
Firebase Authentication (opsional)

Ekstensi ini juga menggunakan layanan pihak ketiga berikut:

Penagihan Stripe (informasi harga)

Anda bertanggung jawab atas segala biaya yang timbul akibat penggunaan layanan ini.

Catatan dari Firebase

Untuk menginstal ekstensi ini, project Firebase Anda harus menggunakan paket Blaze (bayar sesuai penggunaan). Anda hanya akan dikenai biaya atas resource yang digunakan. Sebagian besar layanan Firebase menawarkan paket tanpa biaya untuk penggunaan bervolume rendah. Pelajari penagihan Firebase lebih lanjut.

Mulai 17 Agustus 2020, Anda akan dikenai biaya dalam jumlah kecil (biasanya kurang dari $0,10) saat menginstal atau mengonfigurasi ulang ekstensi ini. Lihat FAQ seputar penagihan Cloud Functions for Firebase untuk mendapatkan penjelasan yang mendetail.

Yang dapat Anda konfigurasi

Lokasi deployment Cloud Functions
Koleksi invoice
Kunci API Stripe dengan akses terbatas
Jumlah hari hingga pembayaran jatuh tempo
Stripe webhook secret

Resource yang dibuat

Jenis: Cloud Function
Deskripsi: Membuat Invoice Stripe saat dokumen invoice baru dibuat di koleksi Cloud Firestore yang Anda tentukan.
Jenis: Cloud Function
Deskripsi: Jika terdaftar sebagai webhook Stripe, fungsi ini memperbarui dokumen invoice yang sesuai di Cloud Firestore saat Peristiwa Stripe diterima.

Cara menginstal ekstensi ini

Menggunakan Firebase console

Anda dapat menggunakan Firebase console untuk menginstal dan mengelola ekstensi.

Instal menggunakan konsol

Menggunakan Firebase CLI

Anda juga dapat menggunakan Firebase CLI untuk menginstal dan mengelola ekstensi:

Langkah 1: Jalankan perintah npm berikut untuk menginstal CLI atau mengupdate ke versi CLI terbaru.

npm install -g firebase-tools

Tidak berhasil? Lihat referensi Firebase CLI atau ubah izin npm Anda.

Langkah 2: Siapkan direktori project Firebase baru atau buka direktori yang sudah ada

Langkah 3: Tambahkan ekstensi ini ke manifes ekstensi Anda dengan menjalankan

firebase ext:install stripe/firestore-stripe-invoices --local --project=projectId_or_alias

Langkah 4 (Opsional): Uji ekstensi ini secara lokal dengan Firebase Emulator Suite

firebase emulators:start

Langkah 5: Deploy ekstensi dalam manifes ke project Anda

firebase deploy --only extensions --project=projectId_or_alias

Dukungan

Authentication Cloud Firestore

Lisensi

Apache-2.0

Versi

0.2.0

Mengirim Invoice menggunakan Stripe

Made by Stripe