Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Outils de développement
Démarrer
Paiements
Automatisation des opérations financières
Démarrer
Paiements
Automatisation des opérations financières
Plateformes et places de marché
Gestion de fonds
Aperçu
Billing
    Présentation
    À propos des API Billing
    Abonnements
    Invoicing
    Facturation à la consommation
    Connect et Billing
    Tax et Billing
    Devis
    Recouvrement de revenus
    Automatisations
    Scripts
    Comptabilisation des revenus
    Gestion des clients
      Clients
      Solde de facture client
      Portail client
      Configurer le portail client no-code
      Configurer le portail client avec l'API
      Configurer le portail client
      Liens profonds et flux dans le portail client
      Ajouter une page d'annulation au portail client
    Droits d'accès
    Tester votre intégration
Tax
Rapports
Données
Constitution de start-up
AccueilAutomatisation des opérations financièresBillingCustomer management

Solde de facture client

Découvrez comment utiliser le solde de facture client.

Copier la page

Dans Stripe Billing, chaque client dispose d’un solde de facture, auquel vous pouvez imputer des réajustements. Ces réajustements peuvent être passés au crédit (ce qui signifie que vous devez de l’argent au client) ou au débit (ce qui signifie que le client vous doit de l’argent) du solde de facture. Ces réajustements modifient ainsi le solde de votre client, qui a lui-même vocation à être appliqué aux prochaines factures du client concerné.

Étant donné que le solde d’une facture est calculé à partir d’un grand livre comptable (une liste immuable d’opérations au débit et au crédit), il fournit un historique des opérations relatives à un client. Ces Opérations sur solde client peuvent faire référence à l’objet associé à un réajustement (par exemple, un objet Credit Note ou Customer), ou même à des métadonnées servant seulement à votre propre usage interne.

Exemples de cas d’usage

Voici quelques cas d’usage courants des soldes de facture client :

  • Émission d’un avoir pour créer un crédit qui réduit le montant dû sur la prochaine facture.
  • Les calculs au prorata issus des passages à un abonnement inférieur peuvent indirectement créer des réductions déductibles du montant dû sur la facture suivante.
  • Lorsque le montant dû sur une facture est inférieur au montant facturable minimal, la facture est marquée comme payée et le montant dû est passé au débit du solde de facture. Cette fonctionnalité ne s’applique qu’aux clients qui ne disposent pas de cash_balance.

Détails concernant le solde de facture client

Gardez les éléments suivants à l’esprit lorsque vous utilisez les soldes de facture client :

  • Le solde de facture s’applique automatiquement à la prochaine facture finalisée du client concerné.
  • Vous ne pouvez pas choisir une facture spécifique à laquelle appliquer le solde de facture.
  • Vous ne pouvez pas refuser l’application du solde de facture à une facture.
  • Le solde de facture est exprimé dans la devise du client.
  • Les clients ayant un solde disponible ne peuvent pas conserver un solde positif. En d’autres termes, le montant dû sur leur prochaine facture ne peut pas augmenter.
  • Le solde de facture ne s’applique pas aux factures créées par des sessions Checkout avec invoice_creation activé.
  • Vous ne pouvez pas appliquer des soldes de facture à des factures créées précédemment et toujours ouvertes. Toutefois, la modification d’une facture ouverte permet d’appliquer un solde de facture à la révision de la facture.

Débits et crédits

Les valeurs négatives sont traitées comme un crédit (une réduction du montant dû par le client) que vous pouvez appliquer à la prochaine facture.

Les valeurs positives sont traitées comme un débit (une augmentation du montant que vous doit le client) que vous pouvez appliquer à la prochaine facture.

Transactions

Toutes les modifications apportées au solde de facture sont enregistrées sous la forme d’Opérations. Une fois l’opération créée, seuls ses attributs description et metadata pourront être modifiés. Vous ne pouvez pas modifier d’autres propriétés ni supprimer une opération.

Annuler une transaction

Vous pouvez uniquement annuler une opération en créant une opération d’annulation correspondante. Par exemple, si vous créditez le client de 10 USD, vous devez le débiter de 10 USD à l’aide d’une nouvelle opération, chacune annulant l’autre.

Types de transactions

Toutes les transactions créées avec l’API ou dans le Dashboard ont une valeur type de adjustment, qui représente un débit ou un crédit que vous avez manuellement créé pour le client.

La propriété type peut prendre de nombreuses valeurs représentant la source et le motif de la création d’une transaction, lesquelles sont décrites dans le tableau suivant :

TypeDescription
adjustmentOpération de réajustement créée explicitement pour débiter ou créditer le solde de facture. Il s’agit du seul type d’opération que vous pouvez créer à l’aide des intégrations API et du Dashboard.
applied_to_invoiceRelie l’application d’un crédit à la facture qui lui est associée.
credit_noteRelie la création d’un crédit à un avoir et à sa facture associée.
invoice_too_smallLorsque le montant dû sur une facture est inférieur au montant facturable minimal de Stripe, et que le client ne dispose pas d’un solde disponible, la facture est débitée du solde de facture et ajoutée au montant dû de la prochaine facture émise.
invoice_too_largeLorsque le montant dû sur une facture est supérieur au montant facturable maximal de Stripe, et que le client ne dispose pas d’un solde disponible, la facture est débitée du solde de facture et ajoutée au montant dû de la prochaine facture émise.
unapplied_from_invoiceSuit l’annulation d’une imputation au solde de facture à partir d’une facture liée. Associé à une précédente opération applied_to_invoice.
unspent_receiver_creditLorsque des fonds non dépensés dans des sources bénéficiaires associées à un client n’ayant pas de solde disponible ne sont pas intégralement facturés après 60 jours, Stripe les facture automatiquement en votre nom et crédite votre solde. Dans cette situation, Stripe crée également une transaction de crédit correspondante.
initialReprésente la valeur de départ du solde de facture client lorsqu’un client est créé à l’aide de l’API avec un solde de facture non nul.

Modifier le solde de facture

Vous pouvez modifier le solde de facture client dans le Dashboard en créant un nouveau réajustement d’opération sur solde client à partir de la page contenant les informations du client.

Sous Solde de facture client, cliquez sur Réajuster le solde pour afficher la fenêtre de Réajustement du solde créditeur.

Vous pouvez définir des informations sur le réajustement, telles que :

  • Type de réajustement : choisissez crédit ou débit
  • Devise : disponible uniquement si le client n’a pas défini de devise
  • Montant
  • Note interne : visible des utilisateurs du Dashboard, mais pas du client
Comment réajuster le solde de l'abonnement d'un client.

API

Créez des réajustements à l’aide de l’API Customer Balance, comme illustré dans l’exemple de code suivant.

Command Line
cURL
curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"
\ -d amount=-500 \ -d currency=usd

Historique des opérations ayant affecté le solde de facture

Vérifiez les ajustements apportés au solde de facture d’un client dans le Dashboard, sur la page des informations du client, sous Solde de facture client.

Cette section affiche la valeur actuelle du solde de facture. Cliquez sur Afficher les détails pour consulter l’historique des opérations ayant permis de calculer cette valeur. Chaque ligne d’opération affiche des informations correspondant au type d’opération concerné, telles qu’un lien vers la facture ou l’avoir qui a affecté le solde de facture.

Affichage de l'historique des opérations affectant le solde de facture

API

Utilisez l’API Customer Balance List pour obtenir la liste de toutes opérations affectant un client.

Command Line
cURL
curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Soldes disponibles des clients

Les clients qui utilisent les virements bancaires ont un objet Cash Balance avec une ou plusieurs devises dans l’objet available. Vous pouvez utiliser ces fonds pour effectuer des paiements ou payer des factures. Les clients ayant un solde disponible présentent le comportement suivant :

  • Il n’est pas possible de créer un solde de trésorerie négatif pour les clients, car il représente l’argent envoyé par le Customer.

  • Vous ne pouvez pas finaliser une facture dont le montant est trop faible ou trop élevé avec le solde de trésorerie (par exemple, en créant un abonnement d’un montant de 0,01 USD). En savoir plus sur les montants minimum et maximum.

  • Vous pouvez supprimer des Customers qui ont un solde de trésorerie, mais uniquement si leur solde de trésorerie est égal à 0.

  • Vous ne pouvez pas supprimer le solde disponible d’un Customer.

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