Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Mengirim Invoice menggunakan Stripe

Stripe
Dibuat oleh Stripe

Membuat dan mengirimkan invoice pelanggan yang dapat ditambahi branding sendiri menggunakan platform pembayaran Stripe.

Cara kerja ekstensi ini

Gunakan ekstensi ini untuk membuat dan mengirimkan invoice pelanggan unik 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 kunci API Stripe pada ekstensi (selama konfigurasi ekstensi) untuk menggunakan kunci mode pengujian. Kunci mode pengujian terlihat seperti rk_test_12345, sedangkan kunci mode live rk_live_12345. Karena ekstensi ini hanya memerlukan akses tulis ke resource invoice dan pelanggan 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:

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 gratis 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.

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: Instal ekstensi ini dengan menjalankan perintah berikut

firebase ext:install stripe/firestore-stripe-invoices --project=projectId_or_alias
Dukungan
Authentication Cloud Firestore
Penulis
Berkolaborasi dengan
Lisensi
Apache-2.0
Versi
0.1.6