---
title: "Changes to Update balance settings"
method: POST
path: "/v1/balance_settings"
---

# Changes to Update balance settings

`POST /v1/balance_settings`

> Every recorded change to this endpoint, newest first.
> 51 revisions in range; 14 not diffed, 6 could not be searched.

## Timeline

Changed in 5 of 51 revisions.

- **2026-07-01** `e24a26de4188` — 3 breaking
- **2025-12-11** `f83e93720259` — 6 info
- **2025-11-05** `62e8dc4ed869` — 1 info
- **2025-10-22** `1e483c60b480` — 1 info
- **2025-09-25** `eb1ac21ec19c` — 5 warning

## Changes

- **2026-07-01** `e24a26de4188` — 3 breaking
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/application_fee/anyOf[subschema #2: PlatformFee]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/failure_balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - …this revision’s changelog is incomplete
- **2025-12-11** `f83e93720259` — 6 info
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/acss_debit/expected_debit_date` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/au_becs_debit/expected_debit_date` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/bacs_debit/expected_debit_date` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/nz_bank_account/expected_debit_date` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/sepa_debit/expected_debit_date` to the response with the `default` status
  - added the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/us_bank_account/expected_debit_date` to the response with the `default` status
  - …this revision’s changelog is incomplete
- **2025-11-05** `62e8dc4ed869` — 1 info
  - added the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/card_present/anyOf[subschema #1: payment_method_options_card_present]/capture_method` to the response with the `default` status
- **2025-10-22** `1e483c60b480` — 1 info
  - added the optional property `error/payment_intent/amount_details/anyOf[subschema #1: PaymentFlowsAmountDetails]/line_items/data/items/payment_method_options/anyOf[subschema #1: PaymentFlowsAmountDetailsResourceLineItemsListResourceLineItemResourcePaymentMethodOptions]/klarna/subscription_reference` to the response with the `default` status
- **2025-09-25** `eb1ac21ec19c` — 5 warning
  - removed the optional property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/payment_method_details/anyOf[subschema #1: payment_method_details]/paypay` from the response with the `default` status
  - removed the optional property `error/payment_intent/payment_method_options/anyOf[subschema #1: PaymentIntentPaymentMethodOptions]/paypay` from the response with the `default` status
  - added the new `prevented` enum value to the `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/application_fee/anyOf[subschema #2: PlatformFee]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/status` response property for the response status `default`
  - added the new `prevented` enum value to the `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/status` response property for the response status `default`
  - added the new `prevented` enum value to the `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/failure_balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/status` response property for the response status `default`
  - …this revision’s changelog is incomplete

---

[Operation](https://skmtc.dev/stripe/apis/spec3/docs/v1/balance_settings/post.md) · [API](https://skmtc.dev/stripe/apis/spec3.md) · [Page](https://skmtc.dev/stripe/apis/spec3/changes/v1/balance_settings/post)