# Solde de facture client Découvrez comment utiliser le solde de facture client. 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* (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) 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](https://docs.stripe.com/api/customer_balance_transactions/object.md) peuvent faire référence à l’objet associé à un réajustement (par exemple, un objet [Credit Note](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) ou [Customer](https://docs.stripe.com/invoicing/customer.md)), ou même à des [métadonnées](https://docs.stripe.com/api/metadata.md) servant seulement à votre propre usage interne. > #### Utiliser l’API Accounts v2 pour représenter les clients > > L’API Accounts v2 est généralement disponible pour les utilisateurs de Connect et en aperçu public pour les autres utilisateurs de Stripe. Si vous avez accès à l’aperçu Accounts v2, vous devez [spécifier une version d’aperçu](https://docs.stripe.com/api-v2-overview.md#sdk-and-api-versioning) dans votre code. > > Pour demander l’accès à l’aperçu Accounts v2, > > Dans la plupart des cas d’usage, nous vous recommandons de [modéliser 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 d’utiliser des objets [Customer](https://docs.stripe.com/api/customers.md). ## Exemples de cas d’usage Voici quelques cas d’usage courants des soldes de facture client : - [Émission d’un avoir](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) 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](https://docs.stripe.com/billing/subscriptions/change-price.md) 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](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts), 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](https://docs.stripe.com/billing/customer/balance.md#cash-balances). ## 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](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance) 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`](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-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](https://docs.stripe.com/invoicing/invoice-edits.md) 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](https://docs.stripe.com/api/customer_balance_transactions/object.md). 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](https://docs.stripe.com/api/customer_balance_transactions/object.md) créées avec l’API ou dans le Dashboard ont une valeur [type](https://docs.stripe.com/api/customer_balance_transactions/object.md#customer_balance_transaction_object-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 : | Type | Description | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adjustment` | Opé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_invoice` | Relie l’application d’un crédit à la [facture](https://docs.stripe.com/invoicing/overview.md) qui lui est associée. | | `credit_note` | Relie la création d’un crédit à un [avoir](https://docs.stripe.com/invoicing/dashboard/credit-notes.md) et à la [facture](https://docs.stripe.com/invoicing/overview.md) associée. | | `invoice_too_small` | Lorsque le montant dû sur une facture est inférieur à notre [montant débiter minimal](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) et que le client n’a pas de solde disponible, nous débitons la facture du solde de la facture et l’ajoutons au montant dû de la prochaine facture émise. | | `invoice_too_large` | Lorsque le montant dû sur une facture est inférieur à notre [montant débiter minimal](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts) et que le client n’a pas de solde disponible, nous débitons la facture du solde de la facture et l’ajoutons au montant dû de la prochaine facture émise. | | `unapplied_from_invoice` | Suit l’annulation d’une imputation au solde de facture à partir d’une [facture](https://docs.stripe.com/invoicing.md) liée. Associé à une précédente opération `applied_to_invoice`. | | `unspent_receiver_credit` | Lorsque des fonds non dépensés dans des [sources bénéficiaires](https://docs.stripe.com/sources.md#flow-for-customer-action) 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. | | `initial` | Repré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 #### Dashboard Vous pouvez modifier le solde de facture client dans le Dashboard en créant un nouveau réajustement d’[opération sur solde client](https://docs.stripe.com/api/customer_balance_transactions/object.md) à 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.](https://b.stripecdn.com/docs-statics-srv/assets/2-Customer-balance.ed7d6df96ba2b8595461e1091e4da7a9.png) #### API Créez des réajustements à l’aide de l’[API Customer Balance](https://docs.stripe.com/api/customer_balance_transactions/create.md), comme illustré dans l’exemple de code suivant. Si vous représentez vos clients sous forme de [Accounts personnalisés plutôt que de Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), transmettez l’ID `Account` à la place de l’ID `Customer` (par exemple, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" \ -d amount=-500 \ -d currency=usd ``` ## Historique des opérations ayant affecté le solde de facture #### Dashboard 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](https://docs.stripe.com/billing/customer/balance.md#types) 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](https://b.stripecdn.com/docs-statics-srv/assets/3-Balance-history.446845092bb178c7924a9cbee2538f94.png) #### API Utilisez l’API [Customer Balance List](https://docs.stripe.com/api/customer_balance_transactions/list.md) pour obtenir la liste de toutes opérations affectant un client. Si vous représentez vos clients sous forme de [Accounts personnalisés plutôt que de Customers](https://docs.stripe.com/accounts-v2/use-accounts-as-customers.md), transmettez l’ID `Account` à la place de l’ID `Customer` (par exemple, `v1/customers/acct_xxxxx/balance_transactions`). ```curl curl https://api.stripe.com/v1/customers/cus_4fdAW5ftNQow1a/balance_transactions \ -u "<>:" ``` ## Soldes disponibles des clients Les clients qui utilisent le moyen de paiement par [virements bancaires](https://docs.stripe.com/payments/bank-transfers.md) disposent d’un [objet solde de trésorerie ](https://docs.stripe.com/api/customers/object.md#customer_object-cash_balance)comprenant une ou plusieurs devises`available`. Vous pouvez utiliser ces fonds pour [effectuer des paiements](https://docs.stripe.com/payments/customer-balance.md#make-cash-payment) ou régler des factures. > #### Gérer les soldes de trésorerie pour les Comptes configurés par le client > > Si vous utilisez des [Comptes](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-configuration-customer) personnalisés pour représenter vos clients, vous pouvez accéder au solde de trésorerie d’un `Account` en indiquant son identifiant à la place de l’identifiant du `Customer` (par exemple, `v1/customers/acct_xxxxx/balance_transactions`). Les clients disposant d’un solde disponible présentent les caractéristiques suivantes : - 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](https://docs.stripe.com/currencies.md#minimum-and-maximum-charge-amounts). - 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`.