Solde disponible du client
Dans Stripe Billing, chaque client possède un solde créditeur sur lequel vous pouvez émettre des réajustements de crédit (ce qui signifie que vous devez de l’argent au client) ou de débit (ce qui signifie qu’il vous doit de l’argent). Cumulés, ces réajustements définissent le solde du client, que vous pouvez appliquer aux prochaines factures.
Le solde créditeur étant calculé à partir du grand livre (une liste immuable des transactions au débit et au crédit), il permet de garder une trace des opérations du client. Pour plus de facilité, ces opérations sur solde du client peuvent renvoyer à l’objet associé au réajustement (par exemple, un avoir, un client) ou même des métadonnées.
Exemples de cas d’usage
Voici quelques cas d’usage fréquents pour les soldes créditeurs des clients :
- É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 minimal facturable, la facture est marquée comme payée et le montant dû est débité du solde créditeur. Cette fonctionnalité est uniquement disponible pour les clients sans cash_balance.
Détails du solde créditeur du client
Gardez à l’esprit les points suivants concernant l’utilisation des soldes créditeurs des clients :
- Le solde créditeur s’applique automatiquement à la prochaine facture finalisée d’un client.
- Vous ne pouvez pas choisir d’appliquer le solde créditeur à une facture spécifique.
- Vous êtes contraint d’appliquer le solde créditeur à une facture.
- Le solde créditeur 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.
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 créditeur sont enregistrées en tant que Transactions. Une fois la transaction créée, vous pouvez uniquement mettre à jour les paramètres description
ou metadata
. Vous ne pouvez plus modifier les autres propriétés ni supprimer une transaction.
Annuler une transaction
La seule façon d’annuler une transaction est de créer une transaction inverse d’un montant équivalent. Par exemple, si vous créditez le client de 10 USD, vous devrez créer une nouvelle transaction pour le débiter de 10 USD. De cette manière, les transactions s’annulent mutuellement.
Types de transactions
La valeur de l’objet type de toutes les transactions créées avec l’API ou dans le Dashboard est définie sur adjustment
. Elle représente un débit ou un crédit que vous avez créé manuellement pour votre 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 | Une transaction de réajustement créée explicitement pour débiter ou créditer le solde créditeur. C’est le seul type de transaction que vous pouvez créer à l’aide des intégrations d’API et du Dashboard. |
applied_to_invoice | Relie l’application d’un crédit à la facture qui lui est associée. |
credit_note | Relie la création d’un crédit à un avoir et à sa facture associée. |
invoice_too_small | Lorsque le montant dû sur une facture est inférieur au montant minimal facturable établi par Stripe et que le client n’a pas de solde disponible, la facture est débitée du solde créditeur et ajoutée au montant dû de la prochaine facture émise. |
invoice_too_large | Lorsque le montant dû sur une facture est supérieur au montant maximal facturable établi par Stripe et que le client n’a pas de solde disponible, la facture est débitée du solde créditeur et ajoutée au montant dû de la prochaine facture émise. |
unapplied_from_invoice | Consigne l’annulation d’un solde créditeur appliqué à une facture associée. Va de pair avec une transaction antérieure ‘applied_to_invoice’. |
unspent_receiver_credit | Lorsque 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. |
initial | Représente la valeur initiale du solde créditeur d’un client lorsque le client est créé à l’aide de l’API et d’un solde créditeur non nul. |
Modifier le solde créditeur
Vous pouvez modifier le solde créditeur d’un client via le Dashboard en créant un nouveau réajustement d’opération sur solde depuis la page de profil du client.
Faites défiler l’écran jusqu’au panneau Solde créditeur de la facture, puis cliquez sur Réajuster le solde pour afficher la fenêtre modale Réajustement du solde créditeur.
Vous pouvez ensuite définir des informations relatives au réajustement, telles que le Type de réajustement (crédit ou débit), la Devise (uniquement disponible si le client n’en a pas défini) et le Montant. Vous pouvez également ajouter une note interne (visible par les utilisateurs du Dashboard, mais pas par le client).
API
Créez des réajustements à l’aide de l’API Customer Balance, comme illustré dans l’exemple de code suivant.
Historique des opérations sur solde créditeur
Vérifiez les réajustements du solde créditeur dans le Dashboard en accédant à la page de profil du client et en faisant défiler l’écran jusqu’au panneau Solde créditeur de la facture.
Le panneau Solde créditeur de la facture affiche la valeur actuelle du solde créditeur du client. Cliquez sur Afficher les détails pour consulter l’historique de transactions utilisé pour le calcul du solde. Chaque ligne de transaction affiche des informations relatives au type de transaction, telles qu’un lien vers la facture sur laquelle le solde créditeur a été appliqué ou l’avoir qui a crédité le solde.
API
Utilisez l’API Customer Balance List pour récupérer la liste des transactions d’un client.
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.
You can delete
Customers
that have a cash balance, but only if their cash balance is 0.Vous ne pouvez pas supprimer le solde disponible d’un
Customer
.