Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Update a cash balance's settings


Update a cash balance's settings

POST / v1 / customers /:id / cash_balance

Changes the settings on a customer’s cash balance.

Parameters

  • settings object A hash of settings for this cash balance.

Returns

The customer’s cash balance, with the updated settings.

Response

{ "object": "cash_balance", "available": null, "customer": "cus_Ob4Xiw8KXOqcvM", "livemode": false, "settings": { "reconciliation_mode": "manual", "using_merchant_default": false }}

Retrieve a cash balance

GET / v1 / customers /:id / cash_balance

Retrieves a customer’s cash balance.

Parameters

No parameters.

Returns

The Cash Balance object for a given customer.

Response

{ "object": "cash_balance", "available": { "eur": 10000 }, "customer": "cus_OaCLf8Fi1nbFpJ", "livemode": false, "settings": { "reconciliation_mode": "automatic", "using_merchant_default": true }}
Last verified 2026-09-24

Is this helpful?