Cette page a été traduite par l'API Cloud Translation.
Switch to English

Envoyer des factures à l'aide de Stripe

Bande
Fabriqué par Stripe

Crée et envoie des factures clients personnalisables à l'aide de la plateforme de paiement Stripe.

Comment fonctionne cette extension

Utilisez cette extension pour créer et envoyer des factures clients personnalisables à l'aide de la plateforme de paiement Stripe .

Les factures sont automatiquement personnalisées avec le logo et le thème de couleur de votre entreprise que vous avez configuré dans Stripe. Une fois la facture envoyée, vous pouvez utiliser le tableau de bord Stripe pour savoir si le client a payé et combien d'argent vous avez traité avec des rapports et des graphiques détaillés.

Cette extension écoute votre collection Cloud Firestore spécifiée pour les nouveaux documents (comme dans l'exemple ci-dessous). Lorsque vous ajoutez un document, Stripe utilise les informations de facturation dans le document pour créer une facture dans son système, puis envoie la facture à l'adresse e-mail spécifiée dans le document. Vous pouvez éventuellement gérer les adresses e-mail de vos clients à l'aide des ID utilisateur Firebase Authentication .

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

Voici un exemple de ce à quoi ressemblera votre facture personnalisée!

Une page de facture affichant un reçu détaillé, avec des options de paiement par carte ou virement bancaire

Une fonctionnalité facultative de cette extension consiste à mettre à jour automatiquement l'état de la facture dans son document Cloud Firestore. Vous pouvez configurer cette fonctionnalité après l'installation de l'extension en enregistrant un webhook Stripe qui écoute les événements de facturation Stripe . Si vous souhaitez utiliser cette fonctionnalité facultative, laissez le paramètre Stripe webhook secret vide lors de l'installation, puis reconfigurez votre extension installée ultérieurement avec la valeur réelle de votre webhook enregistré. Plus de détails sur ce processus sont fournis après l'installation.

Configuration supplémentaire

Avant d'installer cette extension, configurez les services Firebase suivants dans votre projet Firebase:

  • Cloud Firestore pour stocker les informations de facturation et éventuellement l'état de la facture.
    • Suivez les étapes de la documentation pour créer une base de données Cloud Firestore.
  • Authentification Firebase pour gérer éventuellement les e-mails et les données client.
    • Activez les méthodes de connexion dans la console Firebase que vous souhaitez proposer à vos utilisateurs.

Vous devez également avoir un compte Stripe et une clé API Stripe avant d'installer cette extension.

Remarque: Stripe dispose d'un mode de test qui vous permet de passer des appels API sans effectuer de paiements réels. Pour utiliser cette extension avec le mode de test de Stripe, définissez le paramètre de Stripe API key l'extension (pendant la configuration de l'extension) pour utiliser une clé de mode de test. Une clé de mode de test ressemble à rk_test_12345 , alors qu'une clé de mode en direct serait rk_live_12345 . Comme cette extension ne nécessite qu'un accès en écriture à vos ressources customers et invoices Stripe, nous vous recommandons de créer une clé restreinte avec un accès limité à ces ressources uniquement plutôt que d'utiliser votre clé secrète.

Facturation

Cette extension utilise les services Firebase suivants qui peuvent avoir des frais associés:

  • Cloud Firestore
  • Fonctions cloud
  • Authentification Firebase (facultatif)

Cette extension utilise également les services tiers suivants:

Vous êtes responsable de tous les coûts associés à votre utilisation de ces services.

Note de Firebase

Pour installer cette extension, votre projet Firebase doit être sur le plan Blaze (pay-as-you-go). Vous ne serez facturé que pour les ressources que vous utilisez. La plupart des services Firebase offrent un niveau gratuit pour une utilisation à faible volume. En savoir plus sur la facturation Firebase.

À partir du 17 août 2020, un petit montant vous sera facturé (généralement moins de 0,10 USD) lorsque vous installez ou reconfigurez cette extension. Consultez la FAQ sur la facturation Cloud Functions for Firebase pour une explication détaillée.

Comment installer cette extension

Utilisation de la console Firebase

Pour installer et gérer des extensions, vous pouvez utiliser la console Firebase.

Installer à l'aide de la console

Utilisation de la CLI Firebase

Pour installer et gérer les extensions, vous pouvez également utiliser la CLI Firebase:

Étape 1: exécutez la commande npm suivante pour installer l'interface de ligne de commande ou mettre à jour la dernière version de l'interface de ligne de commande.

npm install -g firebase-tools
ne fonctionne pas? Jetez un œil à la référence de Firebase CLI ou modifiez vos autorisations npm .

Étape 2: Installez cette extension en exécutant la commande suivante

firebase ext:install firestore-stripe-invoices --project=projectId_or_alias
Les soutiens
Authentification Cloud Firestore
Auteur
En collaboration avec
Licence
Apache-2.0
Version
0.1.4