# Clients Découvrez comment utiliser l’objet Customer avec Stripe Billing. L’objet *Customer* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments) est une entité centrale au sein de Stripe. Utilisez-le pour stocker toutes les informations de profil, de facturation et fiscales nécessaires pour facturer un client pour ses *abonnements* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) et ses *factures* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice). > #### Utiliser l’API Accounts v2 pour représenter des clients > > Vous pouvez également utiliser des objets `Account` configurés par le client pour représenter vos clients. L’utilisation des `Accounts` vous offre une méthode unifiée pour représenter vos utilisateurs sur l’ensemble des produits Stripe. > > L’API Accounts v2 est généralement disponible pour les utilisateurs Connect, et en version bêta publique pour les autres utilisateurs Stripe. En savoir plus sur [la modélisation de vos clients en tant qu’objets Account configurés par le client](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md) plutôt que l’utilisation d’objets `Customer`. ## Gérer la clientèle 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](https://docs.stripe.com/billing/customer.md#minimum-customer-profile) 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. #### Dashboard Vous pouvez créer et gérer des clients en vous rendant sur la [page Clients](https://dashboard.stripe.com/customers) si vous ne souhaitez pas utiliser de code pour créer un client, ou si vous voulez facturer manuellement une facture ponctuelle à un client. Vous pouvez également créer un client dans le Dashboard lors de la création de la facture. ### Créer un client Lorsque vous créez un client, vous pouvez lui associer diverses données de compte et de facturation, notamment un **E-mail**, un **Nom** ou encore un **Pays**. Vous pouvez également définir la langue préférée ou la devise du client, ainsi que d’autres informations. Pour créer un client, suivez ces étapes : 1. Vérifiez que ce client n’existe pas déjà. 1. Cliquez sur **Ajouter un client** ou appuyez sur la touche **N** sur la page **Clients**. 1. Veuillez saisir au moins le **Nom** et l’**Adresse e-mail du compte** de votre client. 1. Cliquez sur **Ajouter un client** dans la boîte de dialogue. ### Modifier un client Pour modifier le profil d’un client, suivez ces étapes : 1. Recherchez le client que vous souhaitez modifier et cliquez sur son nom sur la page **Clients**. 1. Sur la page des informations du compte, cliquez sur **Actions** > **Modifier les informations**. 1. Apportez les modifications voulues au profil du client. 1. Cliquez sur **Mettre à jour**. ### Supprimer un client Pour supprimer un client, suivez ces étapes : 1. Recherchez le client que vous souhaitez supprimer sur la page **Clients**. 1. Cochez la case située en regard du nom du client, puis cliquez sur le bouton **Supprimer**. Vous pouvez également cliquer sur la page des informations du client, puis sur **Actions** > **Supprimer le client**. #### API Avant de facturer un client, vous devez créer un objet Customer dont vous pouvez défini le nom, l’adresse e-mail et un moyen de paiement. Pour en savoir plus, consultez notre [guide d’intégration](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md). Voici un exemple d’objet Customer basique : ```curl curl https://api.stripe.com/v1/customers \ -u "<>:" \ --data-urlencode "email=jenny.rosen@example.com" \ -d payment_method=pm_card_visa \ -d "invoice_settings[default_payment_method]=pm_card_visa" ``` Consultez la page dédiée à la [création de client](https://docs.stripe.com/api/customers/create.md) via l’API pour voir la liste complète des paramètres. ## 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 sert à la génération des factures et des reçus et peut généralement faire office de système simplifié de gestion de la relation client (CRM) pour votre application. Vous pouvez également utiliser [Stripe Apps pour les affiliations et les parrainages](https://marketplace.stripe.com/categories/affiliate_and_referrals) afin de mettre en place et de gérer des programmes de parrainage et d’affiliation avec Stripe, obtenir des informations sur les clients et automatiser les réajustements de commissions à 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](https://docs.stripe.com/api/customers/object.md#customer_object-email) 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](https://docs.stripe.com/invoicing/automatic-collection.md). Enregistrez l’ID de client interne à votre application dans l’attribut [metadata](https://docs.stripe.com/api/customers/object.md#customer_object-metadata). Comme la plupart des ressources Stripe, la ressource Customer inclut un hachage d’objet [Metadata](https://docs.stripe.com/api/metadata.md) permettant de stocker des informations clé-valeur contextuelles. Pour faciliter le processus d’audit et de support, 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](https://docs.stripe.com/api/customers/object.md#customer_object-address) de facturation (factures, avoirs, etc.) et une adresse de [livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping) (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_locales`. 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](https://tools.ietf.org/html/rfc4646) (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](https://docs.stripe.com/invoicing/customize.md#customer-language). #### 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](https://docs.stripe.com/invoicing/customize.md). Elle aborde les [champs personnalisés](https://docs.stripe.com/invoicing/customize.md#custom-fields), le [pied de page de la facture](https://docs.stripe.com/invoicing/customize.md#footer-field) et la [personnalisation du numéro de facture](https://docs.stripe.com/invoicing/customize.md#invoice-numbering-schemes). ### Paiement Tous les paiements sont encaissés conformément aux informations de [paiement](https://docs.stripe.com/payments.md) du client, et un client peut disposer de plusieurs façons d’effectuer un paiement, y compris : - [Moyens de paiement](https://docs.stripe.com/payments/payment-methods.md) - [Solde créditeur du client](https://docs.stripe.com/billing/customer.md#customer-balance) Vous ne pouvez attribuer qu’une [seule devise](https://docs.stripe.com/billing/customer.md#currency) par client. De ce fait, une fois que vous avez défini la devise d’un client, que vous l’avez facture ou que vous avez [custom un solde de créditeur](https://docs.stripe.com/billing/customer.md#customer-balance) du client, vous ne pouvez plus modifier la devise. Ce état 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 : - [Postes de facture en attente](https://docs.stripe.com/billing/invoices/subscription.md#adding-draft-invoice-items) - [Abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) - [Factures](https://docs.stripe.com/invoicing/overview.md) - [Reçus](https://docs.stripe.com/receipts.md) - [Paramètres de facturation](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) ### 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](https://docs.stripe.com/billing/customer/tax-ids.md), l’[état d’exonération fiscale](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) et l’[adresse](https://docs.stripe.com/billing/customer.md#addresses) 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_exempt` 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é ``ax_exempt`respectivement sur`reverse`ou`exempt`. Pour en savoir plus sur les statuts`tax_exempt`et`reverse`, consultez la page dédiée aux [taux de taxe](https://docs.stripe.com/tax/tax-rates.md#tax-exempt-and-reverse-charge). ## 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. 1. [Créer le client](https://docs.stripe.com/billing/customer.md#create-a-customer). 1. Définissez votre catalogue de [produits](https://docs.stripe.com/products-prices/manage-prices.md#create-product) et vos [tarifs](https://docs.stripe.com/products-prices/manage-prices.md#create-price). 1. [Créez un abonnement](https://docs.stripe.com/billing/subscriptions/overview.md) en utilisant le client créé à l’étape 1 et le tarif de l’étape 2. Vous pouvez continuer à mettre à jour les informations du client après avoir créé l’abonnement et jusqu’à ce qu’une facture soit [finalisée](https://docs.stripe.com/invoicing.md). Toute modification s’applique à la période de facturation suivante, au cours de laquelle une nouvelle facture est générée en utilisant l’état le plus récent du client lors de la création de PDF, d’e-mails et de la page de facture hébergée. Consultez la page [Fonctionnement des abonnements](https://docs.stripe.com/billing/subscriptions/overview.md) pour en savoir plus. ### 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.). 1. [Créer le client](https://docs.stripe.com/billing/customer.md#create-a-customer). 1. [Créez un nouveau brouillon de facture](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) en ajoutant des postes de facture accompagnés d’une description, d’une quantité, d’un prix unitaire et d’un taux de taxe. 1. [Définissez un moyen de paiement pour la facture](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). Vous pouvez encaisser le paiement en débitant automatiquement le moyen de paiement enregistré, ou en envoyant la facture par e-mail au client. 1. Finalisez la facture. Consultez la [documentation sur les factures ponctuelles](https://docs.stripe.com/invoicing/dashboard.md#create-invoice) 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](https://docs.stripe.com/billing/customer/balance.md) 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](https://docs.stripe.com/billing/customer/tax-ids.md) à 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](https://docs.stripe.com/billing/customer/tax-ids.md). ### Définir la devise d’un client La propriété`currency` est un [code ISO qui indique la devise](https://docs.stripe.com/currencies.md) dans laquelle vous facturez le client pour la facturation 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, d’un poste de facture ou d’un solde créditeur pour le client définit également de manière définitive la devise du client.