Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
Aperçu
Billing
PrésentationÀ propos des API Billing
Invoicing
Tax
Présentation
Rapports
PrésentationRapports sur plusieurs comptes
Données
PrésentationSchéma

Clients

Comment utiliser la ressource 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.

Mise en garde

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.

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.

Command Line
curl -G https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 pour connaître la liste complète des arguments que vous pouvez transmettre à l’API.

Command Line
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --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 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 paiementStripe 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 facturationToutes les ressources relatives à la facturation sont associées au client facturé.
Propriétés de taxationPour 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é.

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc