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 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 liés au passage à un abonnement inférieur peuvent indirectement générer des crédits visant à réduire le montant dû sur la prochaine facture.
• 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 :

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

API

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

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.

API

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

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.