Update a cash balance's settings

Payment Methods

Cash Balance

Changes the settings on a customer’s cash balance.

Parameters

settingsobject
A hash of settings for this cash balance.
- settings.reconciliation_modeenum
  Controls how funds transferred by the customer are applied to payment intents and invoices. Valid options are automatic, manual, or merchant_default. For more information about these reconciliation modes, see Reconciliation.
  Possible enum values
  automatic
  manual
  merchant_default

Returns

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

POST /v1/customers/:id/cash_balance

Server-side language

curl https://api.stripe.com/v1/customers/cus_Ob4Xiw8KXOqcvM/cash_balance \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d "settings[reconciliation_mode]"=manual

Response

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

Update a cash balance's settings

Parameters

settingsobject

settings.reconciliation_modeenum

Returns