#cristiancalara-balance
near yew
Hi! Based on the description here: https://stripe.com/docs/api/customers/object#customer_object-balance
The customer balance should be updated when the invoices are paid.
if there's an easier way to get a customer's outstanding balance?
I'n not aware of anything, except what you mentioned: the customer balance, and/or retrieving the outstanding invoices.
vast mason
Hey @near yew - thanks for the quick reply. Not sure I follow on the above
You are saying that the "balance" key on the customer is actually including outstanding invoices?
From reading the docs, for that key, we have as a description:
Current balance, if any, being stored on the customer. If negative, the customer has credit to apply to their next invoice. If positive, the customer has an amount owed that will be added to their next invoice. The balance does not refer to any unpaid invoices; it solely takes into account amounts that have yet to be successfully applied to any invoice. This balance is only taken into account as invoices are finalized.
So it seems it says "The balance does not refer to any unpaid invoices;" quite clearly in there - but maybe I misunderstood things?
near yew
Sorry if I wasn't clear, but yes I agree with you! The balance on the customer object won't include unpaid invoice. So if you need to include unpaid invoices, then you need to look at each of the customer's invoice like you mentioned.