A customer’s Cash balance represents real funds. Customers can add funds to their cash balance by sending a bank transfer. These funds can be used for payment and can eventually be paid out to your bank account.
Attributes
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- availablenullable object
A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the smallest currency unit.
- customerstring
The ID of the customer whose cash balance this object represents.
- customer_
accountnullable string The ID of an Account representing a customer whose cash balance this object represents.
- livemodeboolean
If the object exists in live mode, the value is
true. If the object exists in test mode, the value isfalse. - settingsobject
A hash of settings for this cash balance.
{ "object": "cash_balance", "available": { "eur": 10000 }, "customer": "cus_OaCLf8Fi1nbFpJ", "livemode": false, "settings": { "reconciliation_mode": "automatic", "using_merchant_default": true }}Changes the settings on a customer’s cash balance.
Parameters
- settingsobject
A hash of settings for this cash balance.
Returns
The customer’s cash balance, with the updated settings.
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/cash_balance \ -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \ -d "settings[reconciliation_mode]=manual"{ "object": "cash_balance", "available": null, "customer": "cus_Ob4Xiw8KXOqcvM", "livemode": false, "settings": { "reconciliation_mode": "manual", "using_merchant_default": false }}