Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Şerit kullanarak Faturaları Gönderin

Şerit
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: "customer@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!

Kartla veya banka havalesiyle ödeme seçenekleri içeren, ayrıntılı bir makbuzu gösteren fatura sayfası

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:

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.

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
Destekler
Authentication Cloud Firestore
Yazar
Birlikte
Lisans
Apache-2.0
Sürüm
0.1.4