Şerit kullanarak Faturaları Gönderin
Stripe tarafından yapılmıştır
Stripe ödeme platformunu kullanarak markalı müşteri faturaları oluşturur ve gönderir.
Bu uzantı nasıl çalışır?
Stripe ödeme platformunu kullanarak markalı müşteri faturaları oluşturmak ve göndermek için bu uzantıyı kullanın.
Faturalar, Stripe'de oluşturduğunuz işletmenizin logosu ve renk temasıyla otomatik olarak özelleştirilir. Fatura gönderildikten sonra, müşterinin ödeme yapıp yapmadığını ve ayrıntılı raporlama ve grafiklerle ne kadar para işlediğinizi izlemek için Stripe panosunu kullanabilirsiniz.
Bu uzantı, yeni belgeler için belirttiğiniz Cloud Firestore koleksiyonunuzu dinler (aşağıdaki örnek gibi). Bir belge eklediğinizde, Stripe sistemlerinde bir fatura oluşturmak için belgedeki fatura bilgilerini kullanır ve ardından faturayı belgede belirtilen e-posta adresine gönderir. Firebase Authentication kullanıcı kimliklerini kullanarak isteğe bağlı olarak müşteri e-posta adreslerinizi yönetebilirsiniz.
email: "email@example.com", items: [{ amount: 2000, currency: "usd", quantity: 2, // Optional, defaults to 1. description: "Growth plan" }]
İşte özelleştirilmiş faturanızın nasıl görüneceğine dair bir örnek!
Bu uzantının isteğe bağlı bir özelliği, faturanın Cloud Firestore belgesindeki durumunu otomatik olarak güncellemesidir. Uzantıyı kurduktan sonra, Şeritli fatura olaylarını dinleyen bir Şerit web kancası kaydederek bu özelliği yapılandırabilirsiniz. Bu isteğe bağlı özelliği kullanmak istiyorsanız,
Stripe webhook secret parametresini kurulum sırasında boş bırakın, ardından kurulu uzantınızı daha sonra kayıtlı webhook'unuzun gerçek değeriyle yeniden yapılandırın. Bu işlemle ilgili daha fazla ayrıntı, kurulumdan sonra sağlanır.
Ek kurulum
Bu uzantıyı yüklemeden önce, Firebase projenizde aşağıdaki Firebase hizmetlerini kurun:
- Fatura bilgilerini ve isteğe bağlı olarak fatura durumunu saklamak için Cloud Firestore .
- Bir Cloud Firestore veritabanı oluşturmak için belgelerdeki adımları izleyin.
- İsteğe bağlı olarak e-posta ve müşteri verilerini yönetmek için Firebase Authentication .
- Firebase konsolunda kullanıcılarınıza sunmak istediğiniz oturum açma yöntemlerini etkinleştirin.
Bu uzantıyı yüklemeden önce ayrıca bir Stripe hesabınız ve bir Stripe API anahtarınız olmalıdır .
Not: Stripe, gerçek ödeme yapmadan API çağrıları yapmanıza izin veren bir test moduna sahiptir. Bu uzantıyı Stripe'ın test modu ile kullanmak için, uzantının
Stripe API key parametresini (uzantı yapılandırması sırasında) bir test modu anahtarı kullanacak şekilde ayarlayın. Bir test modu anahtarı
rk_test_12345 , oysa canlı mod anahtarı
rk_live_12345 olacaktır. Bu uzantı yalnızca Stripe
customers ve
invoices kaynaklarınıza yazma erişimi gerektirdiğinden, gizli anahtarınızı kullanmak yerine yalnızca bu kaynaklara sınırlı erişime sahip sınırlı bir anahtar oluşturmanızı öneririz.
Fatura
Bu uzantı, ilişkili ücretleri olabilecek aşağıdaki Firebase hizmetlerini kullanır:
- Cloud Firestore
- Bulut İşlevleri
- Firebase Authentication (isteğe bağlı)
Bu uzantı, aşağıdaki üçüncü taraf hizmetlerini de kullanır:
- Şeritli Faturalama ( fiyatlandırma bilgileri )
Bu hizmetleri kullanımınızla ilgili tüm maliyetlerden siz sorumlusunuz.
Firebase'den not
Bu uzantıyı yüklemek için Firebase projenizin Blaze (kullandıkça öde) planında olması gerekir. Yalnızca kullandığınız kaynaklar için ücretlendirileceksiniz. Çoğu Firebase hizmeti, düşük hacimli kullanım için ücretsiz bir katman sunar. Firebase faturalandırması hakkında daha fazla bilgi edinin.
17 Ağustos 2020 tarihinden itibaren, bu uzantıyı yüklediğinizde veya yeniden yapılandırdığınızda size küçük bir miktar (genellikle 0,10 ABD Dolarından az) faturalandırılacaksınız. Ayrıntılı bir açıklama için Firebase faturalandırması için Cloud Functions'a bakın.
Ne yapılandırabilirsiniz
- Cloud Functions dağıtım konumu
- Faturaların tahsilatı
- Sınırlı erişime sahip Stripe API anahtarı
- Ödemenin son ödeme tarihine kadar geçen gün sayısı
- Şerit ağ kancası sırrı
Oluşturulan kaynaklar
- Tür: Bulut İşlevi
Açıklama: Belirttiğiniz Cloud Firestore koleksiyonunuzda yeni bir fatura belgesi oluşturulduğunda Şerit Fatura oluşturur
- Tür: Bulut İşlevi
Açıklama: Stripe webhook olarak kaydedilmişse bu işlev, yeni bir Stripe Event alındığında Cloud Firestore'daki uygun fatura belgesini günceller.
Bu uzantı nasıl kurulur
Firebase konsolunu kullanma
Uzantıları yüklemek ve yönetmek için Firebase konsolunu kullanabilirsiniz.Konsolu kullanarak yükleyin
Firebase CLI'yı kullanma
Uzantıları yüklemek ve yönetmek için Firebase CLI'yi de kullanabilirsiniz:
Adım 1: CLI'yi yüklemek veya en son CLI sürümüne güncellemek için aşağıdaki npm komutunu çalıştırın.
npm install -g firebase-toolsçalışmıyor mu? Firebase CLI referansına bir göz atın veya npm izinlerinizi değiştirin.
Adım 2: Aşağıdaki komutu çalıştırarak bu uzantıyı yükleyin
firebase ext:install firestore-stripe-invoices --project=projectId_or_alias