Clients

Découvrez comment utiliser l’objet Customer avec Stripe Invoicing.

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 pour aider à créer plus de factures utiles, et activez la fonction de relance intelligente Smart Retries (si vous êtes un utilisateur Invoicing Plus). Après la création et la configuration de ce client, vous pouvez émettre des factures ponctuelles ou créer des abonnements.

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 façon unifiée de représenter vos clients dans tous les 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 plutôt que l’utilisation d’objets Customer.

Avant de créer un client, consultez la liste des clients dans votre Dashboard pour vous assurer qu’il n’existe pas déjà. La présence de plusieurs enregistrements pour le même client peut entraîner des problèmes ultérieurs, notamment lorsque vous devez rapprocher l’historique des transactions ou coordonner les moyens de paiement enregistrés.

Vous pouvez créer et gérer des clients en vous rendant sur la page Clients 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 :

Vérifiez que ce client n’existe pas déjà.
Cliquez sur Ajouter un client ou appuyez sur la touche N sur la page Clients.
Veuillez saisir au moins le Nom et l’Adresse e-mail du compte de votre client.
Cliquez sur Ajouter un client dans la boîte de dialogue.

Modifier un client

Pour modifier le profil d’un client, suivez ces étapes :

Recherchez le client que vous souhaitez modifier et cliquez sur son nom sur la page Clients.
Sur la page des informations du compte, cliquez sur Actions > Modifier les informations.
Apportez les modifications voulues au profil du client.
Cliquez sur Mettre à jour.

Supprimer un client

Pour supprimer un client, suivez ces étapes :

Recherchez le client que vous souhaitez supprimer sur la page Clients.
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.

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 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. 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 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 pour définir une adresse de facturation pour la facturation et les avoirs. Pour la livraison physique de biens, ajoutez une adresse de livraison.

Remarque

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. 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 (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.

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 associées à un client pour encaisser un paiement. Le client peut effectuer un paiement de plusieurs façons, notamment avec l’API Payment Methods et le solde créditeur du client. 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 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, le statut d’exemption fiscale et les adresses. 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.

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.
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 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 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é.