# Clients Comment utiliser la ressource Customer avec Stripe Invoicing. Si votre intégration utilise des [Accounts configurés par le client](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), remplacez les références `Customer` et événement dans les exemples de code par les références équivalentes de l’API Accounts v2. Pour plus d’informations, consultez la page [Représenter des clients avec des objets Account](https://docs.stripe.com/connect/use-accounts-as-customers.md). 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/invoicing/customer.md#customer-profile) pour aider à créer plus de factures utiles, et activez la fonction de relance intelligente Smart Retries (si vous êtes un utilisateur [Invoicing Plus](https://stripe.com/invoicing/pricing)). Après la création et la configuration de ce client, vous pouvez émettre des factures ponctuelles ou créer des *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). > Avant de créer un nouveau client, assurez-vous qu’il n’existe pas déjà dans le Dashboard. La création de plusieurs entrées client pour un même client peut vous poser problème par la suite, par exemple lorsque vous devez rapprocher l’historique des transactions ou coordonner les moyens de paiement enregistrés. #### 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 au moment de la création d’une 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. Vous pouvez également effectuer les actions suivantes sur la page **Clients** : - Filtrer vos clients. - Supprimer des clients. - Afficher tous vos clients. - Exporter une liste de vos données client. 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 créer un client, vérifiez qu’il n’existe pas déjà. Par exemple, transmettez une adresse e-mail à l’API [List all customers](https://docs.stripe.com/api/customers/list.md). ```curl curl -G https://api.stripe.com/v1/customers \ -u "<>:" \ -d email={EMAIL_ADDRESS} ``` L’exemple suivant montre comment créer un client avec une adresse e-mail et un moyen de paiement par défaut. Consultez la page [Créer un client](https://docs.stripe.com/api/customers/create.md) pour connaître la liste complète des arguments que vous pouvez transmettre à l’API. ```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" ``` ## Profils de client Utilisez un profil de client de base pour générer des factures et des reçus ou comme système simplifié de gestion des relations clients (CRM) pour votre application. Pour créer un profil client minimal, définissez ces propriétés : - Adresse e-mail. - Nom du client. - Métadonnées avec une référence à l’ID de client interne de votre application. Stripe utilise l’[adresse e-mail](https://docs.stripe.com/api/customers/object.md#customer_object-email) de votre client pour lui signaler les échecs de paiement. Stripe utilise également les adresses e-mail pour signaler aux clients qu’ils doivent exécuter des actions pour finaliser un paiement. Enregistrez l’ID de client interne de 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. 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 [attributs d’adresse](https://docs.stripe.com/api/customers/object.md#customer_object-address) pour définir une adresse de facturation pour la facturation et les avoirs. Pour la livraison physique de biens, ajoutez une adresse de [livraison](https://docs.stripe.com/api/customers/object.md#customer_object-shipping). > L’adresse de facturation apparaît sur les factures, les avoirs et les reçus (exigence courante à des fins de conformité fiscale). ### Localisation des e-mails et des PDF Lorsque vous créez un client, ajoutez sa langue préférée à partir de la liste déroulante **Langue**. (Vous pouvez aussi changer la langue préférée du client, ou en ajouter une autre, dans la page **Informations du client** ou au moment de la création d’une facture.) Stripe utilise la langue choisie pour localiser les e-mails et les PDF de facture, les e-mails et les PDF de reçu, et les PDF d’avoir. Pour changer la langue au moyen de l’API, utilisez le paramètre [preferred_locales](https://docs.stripe.com/api/customers/object.md#customer_object-preferred_locales). Ce paramètre accepte une liste triée des langues préférées, classées par ordre de préférence. Ces valeurs régionales préférées sont établies sur la base du document [RFC-4646](https://tools.ietf.org/html/rfc4646) (par exemple, « en » pour l’anglais, ou « fr-CA » pour le français-canadien). Pour en savoir plus, consultez la page [Langues préférées du client](https://docs.stripe.com/invoicing/customize.md#customer-language). ## Propriétés client Le tableau suivant présente des propriétés client supplémentaires : | Propriété | Description | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Propriétés de paiement | Stripe utilise les informations de [paiement](https://docs.stripe.com/payments.md) associées à un client pour encaisser un paiement. Le client peut effectuer un paiement de plusieurs façons, notamment avec l’[API Payment Methods](https://docs.stripe.com/payments/payment-methods.md) et le [solde créditeur du client](https://docs.stripe.com/invoicing/customer/balance.md). Vous ne pouvez attribuer qu’une seule devise par client. De ce fait, une fois que vous avez affecté une devise au client, que vous l’avez facturé ou que vous avez configuré un solde créditeur du client, vous ne pouvez plus changer la devise. Ce blocage est affiché sur le Dashboard dans une liste déroulante **Devise** désactivée. Si vous devez facturer une seule entité avec plusieurs devises, créez un client pour chaque devise. | | Propriétés de facturation | Toutes les [ressources relatives à la facturation](https://docs.stripe.com/api/customers/create.md#create_customer-invoice_settings) sont associées au client facturé. | | Propriétés de taxation | Pour répondre aux exigences de la juridiction fiscale, vous devez inclure le numéro d’identification fiscale du client et les autres informations fiscales sur les factures. Il est de votre responsabilité de vous assurer que les factures du client contiennent toutes les informations correctes. Cela inclut le [numéro d’identification fiscale](https://docs.stripe.com/invoicing/customer/tax-ids.md), le [statut d’exemption fiscale](https://docs.stripe.com/api/customers/create.md#create_customer-tax_exempt) et les [adresses](https://docs.stripe.com/invoicing/customer.md#addresses). 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 l’entité est imposable ou non. Le statut `tax_exempt` d’un client est défini par défaut sur `none`, ce qui signifie que l’entité est imposable. Toutefois, vous pouvez définir le paramètre `tax_exempt` sur `reverse` pour les clients qui doivent régler la taxe de la facture. Vous pouvez aussi indiquer que le client est exempté de taxe en définissant l’état sur `exempt`. Pour en savoir plus sur l’utilisation des paramètres `tax_exempt` et `reverse`, consultez la page [Taux de taxe](https://docs.stripe.com/billing/taxes/tax-rates.md#tax-exempt-and-reverse-charge). | ## Tâches courantes Voici des exemples de tâches que vous serez fréquemment amené à effectuer avec la ressource `Customer` : - **Envoyer une facture à un client** : après la création du client, vous pouvez [lui envoyer une facture](https://docs.stripe.com/invoicing/dashboard.md#create-invoice). - **Enregistrer le solde créditeur d’un client** : la fonctionnalité de solde créditeur du client vous permet d’affecter des réajustements de crédit et de débit à un client spécifique, puis d’appliquer le solde qui en résulte à ses futures factures. - **Ajouter et valider les numéros fiscaux** : l’affichage du numéro fiscal d’un client sur une facture est une exigence courante, et Stripe vous permet d’ajouter plusieurs numéros fiscaux pour un client. Ils apparaissent dans l’en-tête de la facture et de l’avoir au format PDF. Consultez la page [Numéros fiscaux des clients](https://docs.stripe.com/invoicing/customer/tax-ids.md) pour plus d’informations. - **Définir la devise pour un client** : vous pouvez définir la devise par défaut dans laquelle vous facturerez un client à l’aide du Dashboard en accédant à la page **Clients**, en sélectionnant votre client et en cliquant sur **Modifier** à côté de **Détails**. Consultez la page [Clients multi-devises](https://docs.stripe.com/invoicing/multi-currency-customers.md) pour en savoir plus sur la facturation d’un client dans une devise différente de la devise par défaut. - **Créez des clients en masse**: chargez des clients en masse à l’aide des [Stripe Apps de productivité](https://marketplace.stripe.com/categories/productivity).