Clients
Découvrez comment utiliser la ressource Client avec Stripe Billing.
Les objets Customer sont une ressource clé dans Stripe. Utilisez-la pour sauvegarder toutes les informations de profil, de facturation et de taxes requises pour facturer des abonnements au client et lui soumettre des factures ponctuelles.
Gérer des clients
Créez un client pour chaque nouvel utilisateur ou nouvelle entreprise à facturer. Lors de la création d’un client, définissez un profil client minimal qui vous sera utile pour générer des factures, et activez la fonction de relance intelligente Smart Retries. Après la création et la configuration de votre client, vous pouvez créer des abonnements et émettre des factures ponctuelles.
Propriétés disponibles et utilisations
La ressource Customer propose de nombreuses propriétés utiles que vous pouvez configurer pour personnaliser la facturation. Cette section décrit les propriétés que vous pouvez stocker sur la ressource Customer et leurs différents effets.
Profil client
Un profil client de base est utile pour générer des factures et des reçus, et peut généralement agir comme un système léger de gestion de la relation client (CRM) pour votre application. Vous pouvez également utiliser les Stripe Apps pour les affiliations et les parrainages afin de mettre en place et gérer des programmes de parrainage et d’affiliation avec Stripe, obtenir des informations sur les clients et automatiser les ajustements de commission à partir du Dashboard Stripe.
Profil client minimal
Lorsque vous créez un client, définissez les propriétés suivantes :
- Adresse e-mail
- Nom du client
- Métadonnées référençant l’ID de client interne de votre application
Si une adresse e-mail est renseignée, Stripe est en mesure de prévenir le client en cas d’échec de paiement ou lorsqu’un paiement requiert une action supplémentaire, dans le cadre du processus d’encaissement automatique.
Enregistrez l’ID de client interne à votre application dans l’attribut metadata. Comme la plupart des ressources Stripe, la ressource Customer inclut un hachage d’objet Metadata permettant de stocker des informations clé-valeur contextuelles. Pour faciliter le processus d’audit et d’assistance, enregistrez votre ID de client interne en tant que paire clé-valeur dans la ressource Customer. Cela vous permet de rechercher le client à l’aide de votre ID de référence interne. De même, nous vous recommandons d’enregistrer les ID de client Stripe dans le modèle de client interne de votre application.
Adresses de facturation et de livraison
Utilisez les propriétés d’adresse pour configurer une adresse de facturation (factures, avoirs, etc.) et une adresse de livraison (pour les marchandises).
Même si l’adresse de livraison est la plus utile aux yeux des entreprises qui vendent des biens matériels, l’adresse de facturation est également importante, car elle apparaît sur les factures, les avoirs et les reçus, conformément aux obligations fiscales.
Localisation des e-mails et des PDF
Localisez les e-mails et PDF générés par Stripe en définissant la propriété preferred_. Celle-ci accepte une liste de langues, classées par ordre de préférence. Ces paramètres régionaux suivent la norme RFC-4646 (par exemple, « en » pour l’anglais, ou « fr-CA » pour le français canadien). Pour plus d’informations, consultez la page consacrée à la personnalisation des factures.
Paramètres de facturation personnalisés par client
Pour savoir comment personnaliser les factures d’un client donné, consultez la page dédiée à la personnalisation des factures. Elle aborde les champs personnalisés, le pied de page de la facture et la personnalisation du numéro de facture.
Paiement
Tous les paiements sont encaissés conformément aux informations de paiement du client, et un client peut disposer de plusieurs façons d’effectuer un paiement, y compris :
Vous ne pouvez attribuer qu’une seule devise par client. De ce fait, une fois que vous avez défini la devise d’un client, que vous l’avez facturé ou que vous avez configuré un solde de créditeur du client, vous ne pouvez plus modifier la devise. Ce blocage est visible sur le Dashboard avec un menu déroulant Devise désactivé.
Si vous devez facturer une même entité dans différentes devises, créez un client pour chaque devise concernée.
Facturation
Toutes les ressources relatives à la facturation sont associées au client facturé. Ces ressources incluent :
Informations fiscales
Pour répondre aux exigences des territoires fiscaux, vous pouvez être amené à faire figurer sur les factures les numéros fiscaux des clients ainsi que d’autres informations. C’est à vous qu’il incombe en dernier ressort de veiller à ce que les factures contiennent les informations voulues, notamment le numéro fiscal, l’état d’exonération fiscale et l’adresse de vos clients.
Les numéros fiscaux permettent d’enregistrer et d’afficher un ou plusieurs numéros d’identification fiscale sur les factures. Le statut d’exemption de taxe indique si une entité est assujettie à la taxe ou non. Le statut tax_ d’un client est défini par défaut sur none, ce qui indique que l’entité est taxable. Toutefois, vous pouvez préciser sur une facture si le client doit régler des taxes ou en est exonéré en définissant la propriété tax_ respectivement sur reverse ou exempt. Pour en savoir plus sur les statuts tax_ et reverse, consultez la page dédiée aux taux de taxe.
Tâches fréquentes
Cette section décrit certaines des tâches que vous serez fréquemment amené à effectuer avec la ressource Customer.
Créer un abonnement
Avant de créer un nouvel abonnement, vous devez créer un client aux fins de facturation.
- Créez le client.
- Définissez votre catalogue de produits et vos tarifs.
- Créez un abonnement en utilisant le client créé à l’étape 1 et le tarif de l’étape 2.
Une fois l’abonnement créé, vous pouvez encore modifier les informations du client jusqu’à la finalisation de votre facture. Toute modification apportée sera appliquée au prochain cycle de facturation, à savoir à la création d’une nouvelle facture avec l’état le plus récent du client au moment de la génération des PDF, des e-mails ou de la page de facture hébergée. Pour en savoir plus consultez la page dédiée au fonctionnement des abonnements.
Envoyer (manuellement) une facture ponctuelle à un client
Contrairement aux factures d’abonnement qui suivent un calendrier de génération automatique, vous devez émettre vos factures ponctuelles manuellement. Celles-ci servent notamment à facturer des ordres de travail ponctuels (par exemple, des frais d’installation ou de conseil, des commandes uniques pour des biens matériels, etc.).
- Créez le client.
- Créez un nouveau brouillon de facture en ajoutant des postes de facture accompagnés d’une description, d’une quantité, d’un prix unitaire et d’un taux de taxe.
- Définissez un moyen de paiement pour la facture. Vous pouvez encaisser le paiement en débitant automatiquement le moyen de paiement enregistré, ou en envoyant la facture par e-mail au client.
- Finalisez la facture.
Consultez la documentation sur les factures ponctuelles pour en savoir plus sur la création et l’encaissement de paiements pour les factures ponctuelles.
Enregistrer le solde créditeur d’un client
La fonctionnalité de solde créditeur des clients vous permet d’affecter des réajustements au crédit ou au débit à un client donné. Le solde obtenu est ensuite appliqué aux futures factures du client.
Ajouter et valider des numéros fiscaux
Il est généralement nécessaire de faire apparaître le numéro fiscal des clients sur les documents de facturation. Avec Stripe, vous pouvez ajouter un ou plusieurs numéros fiscaux à un client. Ils apparaîtront dans l’en-tête des factures et avoirs au format PDF. Pour en savoir plus, consultez la page dédiée aux numéros fiscaux.
Ajouter un bon de réduction à un client
Un bon de réduction contient des informations sur le pourcentage ou le montant d’une réduction. Avec Stripe Billing, vous pouvez associer un bon de réduction à un client pour appliquer une réduction à toutes les factures que vous lui envoyez.
Lorsque vous créez une facture, manuellement ou à partir d’un abonnement, le bon de réduction est déduit du montant dû (avant déduction des taxes). Cette information est disponible dans le tableau récapitulatif en pied de page de la facture.
Définir la devise d’un client
La propriété currency est un code ISO à trois lettres correspondant à la devise dans laquelle vous débitez un client sur une base récurrente. Vous pouvez définir la devise dans le Dashboard en accédant à la page Clients > Détails, puis en cliquant sur Mettre à jour les détails. Une fois la devise définie, vous ne pouvez plus la modifier. La création d’une facture ou d’un solde créditeur pour le client définit également la devise de ce client.