From 885cdaa8d8b335b0768d955b5ee69f951ebe00e3 Mon Sep 17 00:00:00 2001
From: Zachary Chua <zacchua@stripe.com>
Date: Tue, 1 Sep 2026 11:41:18 -0700
Subject: [PATCH 1/8] Bump version to 15.6.1

---
 CHANGELOG.md       | 5 +++++
 VERSION            | 2 +-
 pyproject.toml     | 2 +-
 stripe/_version.py | 2 +-
 4 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53d5ab774..9f3327d0f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,8 @@
+## 15.6.1 - 2026-09-01
+* [#1896](https://github.com/stripe/stripe-python/pull/1896) Harden API requestor code against malicious URLs
+* [#1898](https://github.com/stripe/stripe-python/pull/1898) Use cryptographically secure boundaries for multipart file uploads
+* [#1860](https://github.com/stripe/stripe-python/pull/1860) Dispatch discriminated union fields to their variant class
+
 ## 15.6.0 - 2026-08-26
 This release changes the pinned API version to 2026-08-26.dahlia.
 
diff --git a/VERSION b/VERSION
index 9f6d8f2fd..0ab55a66f 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-15.6.0
+15.6.1
diff --git a/pyproject.toml b/pyproject.toml
index 0a20a5240..5ba581723 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "stripe"
-version = "15.6.0"
+version = "15.6.1"
 readme = "README.md"
 description = "Python bindings for the Stripe API"
 authors = [{ name = "Stripe", email = "support@stripe.com" }]
diff --git a/stripe/_version.py b/stripe/_version.py
index 8fd39a3e3..22177fc0d 100644
--- a/stripe/_version.py
+++ b/stripe/_version.py
@@ -1 +1 @@
-VERSION = "15.6.0"
+VERSION = "15.6.1"

From 4b718afb9b248f5f8858c4d1848cd9532de25e4f Mon Sep 17 00:00:00 2001
From: David Brownman <1231935+xavdid@users.noreply.github.com>
Date: Wed, 9 Sep 2026 11:33:46 -0700
Subject: [PATCH 2/8] update webhook examples (#1902)

---
 examples/async_event_notification_handler_endpoint.py |  2 +-
 examples/event_notification_handler_endpoint.py       |  2 +-
 examples/event_notification_webhook_handler.py        |  2 +-
 examples/webhooks.py                                  |  2 +-
 tests/test_webhook.py                                 | 10 ++++++++++
 5 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/examples/async_event_notification_handler_endpoint.py b/examples/async_event_notification_handler_endpoint.py
index 2cad998ed..3a7f6a9ec 100644
--- a/examples/async_event_notification_handler_endpoint.py
+++ b/examples/async_event_notification_handler_endpoint.py
@@ -22,7 +22,7 @@
 
 app = FastAPI()
 api_key = os.environ.get("STRIPE_API_KEY", "")
-webhook_secret = os.environ.get("WEBHOOK_SECRET", "")
+webhook_secret = os.environ["WEBHOOK_SECRET"]
 
 # Webhooks can be delivered more than once, so we track ids we've already
 # processed. In production, back this with something durable and shared
diff --git a/examples/event_notification_handler_endpoint.py b/examples/event_notification_handler_endpoint.py
index c1db46f13..b33b845b2 100644
--- a/examples/event_notification_handler_endpoint.py
+++ b/examples/event_notification_handler_endpoint.py
@@ -19,7 +19,7 @@
 
 app = Flask(__name__)
 api_key = os.environ.get("STRIPE_API_KEY", "")
-webhook_secret = os.environ.get("WEBHOOK_SECRET", "")
+webhook_secret = os.environ["WEBHOOK_SECRET"]
 
 # Webhooks can be delivered more than once, so we track ids we've already
 # processed. In production, back this with something durable and shared
diff --git a/examples/event_notification_webhook_handler.py b/examples/event_notification_webhook_handler.py
index d05117c8c..6bfdb8cb2 100644
--- a/examples/event_notification_webhook_handler.py
+++ b/examples/event_notification_webhook_handler.py
@@ -25,7 +25,7 @@
 
 app = Flask(__name__)
 api_key = os.environ.get("STRIPE_API_KEY", "")
-webhook_secret = os.environ.get("WEBHOOK_SECRET", "")
+webhook_secret = os.environ["WEBHOOK_SECRET"]
 
 client = StripeClient(api_key)
 
diff --git a/examples/webhooks.py b/examples/webhooks.py
index 79352b1a6..5f393bf00 100644
--- a/examples/webhooks.py
+++ b/examples/webhooks.py
@@ -6,7 +6,7 @@
 # this is for handling v1-style Snapshot Events.
 # To handle v2-style Events, see `event_notification_webhook_handler.py`
 
-webhook_secret = os.environ.get("WEBHOOK_SECRET")
+webhook_secret = os.environ["WEBHOOK_SECRET"]
 
 app = Flask(__name__)
 
diff --git a/tests/test_webhook.py b/tests/test_webhook.py
index 9b1420a8d..08c9e20b7 100644
--- a/tests/test_webhook.py
+++ b/tests/test_webhook.py
@@ -274,6 +274,16 @@ def test_raise_on_v2_payload(self, stripe_mock_stripe_client):
             )
         assert "parse_event_notification" in str(e.value)
 
+    @pytest.mark.parametrize("secret", [None, ""])
+    def test_raise_on_missing_secret(self, stripe_mock_stripe_client, secret):
+        with pytest.raises(
+            SignatureVerificationError,
+            match="No webhook secret value was provided",
+        ):
+            stripe_mock_stripe_client.construct_event(
+                DUMMY_WEBHOOK_PAYLOAD, generate_header(), secret
+            )
+
     def test_construct_event_inherits_requestor(self, http_client_mock):
         http_client_mock.stub_request("delete", "/v1/terminal/readers/rdr_123")
 

From 23983187cb0dec4bf50d561ea01d59b95b6bb194 Mon Sep 17 00:00:00 2001
From: David Brownman <1231935+xavdid@users.noreply.github.com>
Date: Mon, 14 Sep 2026 15:00:54 -0700
Subject: [PATCH 3/8] Migrate changelog management to `hark` (#1905)

* migrate to hark

* tweak issue template

* point the hark actions at master

* use the single hark/checks action in CI

* use the hark checks action and rename pr_link to pr_url

* record language and channel in versions.json metadata

* rename versions.json to releases.json

* regenerate changelogs; pad short versions

* add a minimum-runtime-version recipe

Committed-By-Agent: claude

* add print-version-info recipe

* swap from is_breaking to semver_level
---
 .github/pull_request_template.md              |   12 +-
 .github/workflows/changelog.yml               |   21 +
 .github/zizmor.yml                            |    1 +
 ...04_unknown_parameters-value-none.change.md |    4 +
 ...-17_unknown_add-new-deletediscou.change.md |    4 +
 ...012-05-17_unknown_add-new-stripe.change.md |    4 +
 ...5-17_unknown_numerous-test-suite.change.md |    4 +
 ...-05-17_unknown_switch-using-http.change.md |    4 +
 ...-05-21_unknown_prefer-app-engine.change.md |    4 +
 ...2012-05-31_unknown_fix-bug-would.change.md |    4 +
 ...012-08-17_unknown_add-new-stripe.change.md |    4 +
 ...nknown_remove-uncapturedch-tests.change.md |    4 +
 ...012-08-31_unknown_add-update-pay.change.md |    4 +
 ...-30_unknown_add-support-creating.change.md |    4 +
 ...12-10-30_unknown_add-support-new.change.md |    4 +
 ...-10-30_unknown_add-support-new_2.change.md |    4 +
 ...-08_unknown_add-support-updating.change.md |    4 +
 ..._unknown_update-requests-version.change.md |    4 +
 ...1-15_unknown_add-support-setting.change.md |    4 +
 ...2-04_unknown_add-support-passing.change.md |    4 +
 .../2013-02-21_unknown_add-id-list.change.md  |    4 +
 ...013-04-11_unknown_add-new-stripe.change.md |    4 +
 ...nknown_allow-transfers-creatable.change.md |    4 +
 ...3-04-25_unknown_support-python-3.change.md |    4 +
 ...013-05-03_unknown_remove-id-list.change.md |    4 +
 ...-12_unknown_add-support-multiple.change.md |    4 +
 ...12_unknown_add-support-unsetting.change.md |    6 +
 ...08-20_unknown_add-stripe-balance.change.md |    4 +
 ...9-18_unknown_add-support-closing.change.md |    4 +
 ...-10-08_unknown_fix-issue-support.change.md |    4 +
 ...-17_unknown_add-support-metadata.change.md |    4 +
 ...7_unknown_removed-incorrect-test.change.md |    4 +
 ..._unknown_add-stripe-applicationf.change.md |    4 +
 ..._unknown_abstracted-http-library.change.md |    4 +
 ...-05_unknown_added-extensive-unit.change.md |    4 +
 ...unknown_extended-functional-test.change.md |    4 +
 ...nown_pep8ified-codebase-enforced.change.md |    4 +
 ...previousmeta-attribute-resources.change.md |    5 +
 ...unknown_proper-encoding-timezone.change.md |    4 +
 ..._unknown_refactored-code-modules.change.md |    4 +
 ..._refactored-stripeobject-inherit.change.md |    4 +
 ..._unknown_timezone-aware-datetime.change.md |    5 +
 ...05_unknown_todict-values-methods.change.md |    6 +
 ...9_unknown_added-support-multiple.change.md |    4 +
 ...3-13_unknown_added-license-other.change.md |    4 +
 ...14-03-13_unknown_fix-repr-python.change.md |    4 +
 ...-03-13_unknown_fix-syntax-errors.change.md |    4 +
 ...known_support-pickling-responses.change.md |    4 +
 ...nknown_add-certificate-blacklist.change.md |    4 +
 .../2014-04-09_unknown_don-t-rely.change.md   |    4 +
 ...-04-09_unknown_update-bundled-ca.change.md |    4 +
 ...14-04-09_unknown_use-der-encoded.change.md |    4 +
 ...5-19_unknown_disable-loading-ssl.change.md |    4 +
 ...unknown_support-cards-recipients.change.md |    4 +
 ...nown_support-canceling-transfers.change.md |    4 +
 ..._unknown_remove-official-support.change.md |    4 +
 ...17_unknown_add-metadata-disputes.change.md |    4 +
 ..._unknown_application-fee-refunds.change.md |    4 +
 ..._unknown_remove-redundant-manual.change.md |    4 +
 ...2-23_unknown_adding-support-file.change.md |    4 +
 ..._unknown_adding-bitcoin-receiver.change.md |    4 +
 ...01-21_unknown_remove-support-top.change.md |    4 +
 ...9_unknown_added-bitcoin-receiver.change.md |    4 +
 ...2_unknown_added-methods-updating.change.md |    4 +
 ...nknown_pass-stripeaccoun-balance.change.md |    4 +
 ...-04-08_unknown_fix-saving-manage.change.md |    4 +
 ..._unknown_fix-saving-additionalow.change.md |    4 +
 ...unknown_include-response-headers.change.md |    4 +
 ...03_unknown_added-dispute-listing.change.md |    4 +
 ...-03_unknown_managed-accounts-can.change.md |    4 +
 ...08-05_unknown_fix-error-handling.change.md |    4 +
 ...-17_unknown_added-refund-listing.change.md |    4 +
 ...15-09-11_unknown_add-support-new.change.md |    4 +
 ...-14_unknown_products-skus-orders.change.md |    4 +
 ...10-02_unknown_add-ability-delete.change.md |    4 +
 ...02_unknown_add-configurable-http.change.md |    4 +
 ...-10-02_unknown_official-python-3.change.md |    4 +
 ...unknown_add-automatic-paginating.change.md |    4 +
 ...16-01-04_unknown_all-method-list.change.md |    4 +
 ...04_unknown_calls-instanceurl-now.change.md |    4 +
 ...01-04_unknown_error-messages-set.change.md |    4 +
 ...6-01-04_unknown_list-objects-now.change.md |    4 +
 ...-26_unknown_add-support-deleting.change.md |    4 +
 ...-02-01_unknown_update-bundled-ca.change.md |    4 +
 ...27_unknown_add-countryspec-model.change.md |    4 +
 ...03-15_unknown_add-reject-account.change.md |    4 +
 ...-24_unknown_fix-uploading-binary.change.md |    4 +
 ...016-03-31_unknown_update-ca-cert.change.md |    4 +
 ...2016-04-11_unknown_fix-bug-where.change.md |    4 +
 ...2016-04-12_unknown_fix-bug-where.change.md |    4 +
 ...16-05-04_unknown_add-support-new.change.md |    9 +
 ...05-20_unknown_add-support-alipay.change.md |    4 +
 ...24_unknown_add-support-returning.change.md |    4 +
 ...6-06-29_unknown_add-update-class.change.md |    4 +
 ...2_unknown_add-threedsecure-model.change.md |    4 +
 ...-09-15_unknown_add-support-apple.change.md |    4 +
 ...-10-06_unknown_add-proxy-support.change.md |    4 +
 ...unknown_add-support-subscription.change.md |    4 +
 ...unknown_add-configurable-timeout.change.md |    4 +
 ...nknown_return-subscription-model.change.md |    4 +
 ...6-10-12_unknown_add-source-model.change.md |    4 +
 ..._unknown_implement-copy-deepcopy.change.md |    4 +
 ...1-21_unknown_add-retrieve-method.change.md |    4 +
 ...30_unknown_add-support-verifying.change.md |    4 +
 ...2-16_unknown_add-request-logging.change.md |    4 +
 ...17-01-06_unknown_format-now-same.change.md |    4 +
 ...-06_unknown_logs-properly-handle.change.md |    4 +
 ...-06_unknown_request-logging-goes.change.md |    4 +
 ...-06_unknown_use-internal-session.change.md |    4 +
 ...18_unknown_allow-sources-updated.change.md |    4 +
 ...unknown_add-account-modifyextern.change.md |    4 +
 ...nknown_add-customer-modifysource.change.md |    4 +
 ..._unknown_fix-encoding-parameters.change.md |    4 +
 ..._unknown_accept-session-argument.change.md |    4 +
 ...nknown_support-detaching-sources.change.md |    4 +
 ...unknown_support-oauth-operations.change.md |    4 +
 ...4-06_unknown_add-support-payouts.change.md |    4 +
 ...017-04-06_unknown_op-release-peg.change.md |    4 +
 ...28_unknown_add-stripe-setappinfo.change.md |    4 +
 ...unknown_support-checking-webhook.change.md |    4 +
 ...-10_unknown_constrain-requests-2.change.md |    4 +
 ...known_remove-requests-constraint.change.md |    4 +
 ...5-25_unknown_add-support-account.change.md |    4 +
 ...-26_unknown_add-apikey-parameter.change.md |    4 +
 ...-05-31_unknown_fix-pycurl-client.change.md |    4 +
 ...06-02_unknown_re-use-connections.change.md |    4 +
 ...nown_refactor-oauth-implementati.change.md |    4 +
 ...19_unknown_add-support-ephemeral.change.md |    4 +
 ...unknown_expose-code-invalidreque.change.md |    4 +
 ...17-06-27_unknown_pay-invoice-can.change.md |    4 +
 ...change-serializatio-subscription.change.md |    4 +
 ...unknown_add-support-invalidclien.change.md |    4 +
 ...09-01_unknown_error-invalid-type.change.md |    4 +
 ...1_unknown_fix-serializatio-items.change.md |    4 +
 ...9-07_unknown_add-support-passing.change.md |    4 +
 ...1_unknown_handle-bytearray-bytes.change.md |    4 +
 ...-29_unknown_support-length-reads.change.md |    4 +
 ...-11_brandur_rename-source-delete.change.md |    5 +
 ...10-19_brandur_add-static-methods.change.md |   10 +
 ...-10-20_brandur_break-resource-py.change.md |    7 +
 ...ndur_fix-unpickling-stripeobject.change.md |    5 +
 ..._brandur_support-uploading-files.change.md |    5 +
 ...6_brandur_support-listing-source.change.md |    5 +
 ...7_brandur_fix-byteswarning-being.change.md |    5 +
 ..._brandur_fix-balance-transaction.change.md |    5 +
 ...1_brandur_support-exchange-rates.change.md |    5 +
 ..._brandur_switch-vendored-version.change.md |    5 +
 ...11-07_brandur_remove-api-allowed.change.md |    5 +
 ...1-08_brandur_make-custom-actions.change.md |    5 +
 .../2017-11-29_ob_add-only-changed.change.md  |    5 +
 .../2017-11-29_ob_use-custom-json.change.md   |    5 +
 ...2-05_brandur_log-encoded-version.change.md |    5 +
 ...05_unknown_accidental-op-release.change.md |    4 +
 ...-21_brandur_add-new-idempotencye.change.md |    5 +
 ...randur_add-accessor-lastresponse.change.md |    5 +
 ...018-01-05_ob_drop-support-python.change.md |    5 +
 ...ndur_register-unsaved-attributes.change.md |    5 +
 ...8_ob_make-lastresponse-available.change.md |    5 +
 ...02-21_brandur_add-support-topups.change.md |    5 +
 .../2018-02-21_ob_use-py-test.change.md       |    5 +
 .../2018-02-23_ob_add-support-code.change.md  |    5 +
 ...-02-23_ob_build-universal-wheels.change.md |    5 +
 ...ur_drop-conditional-dependencies.change.md |    5 +
 ...-02-27_ob_remove-deprecated-code.change.md |    5 +
 .../2018-02-28_ob_remove-util-json.change.md  |    5 +
 .../2018-03-05_ob_update-setup-py.change.md   |    5 +
 .../2018-03-13_ob_use-pipenv.change.md        |    5 +
 ...15_ob_change-exception-detaching.change.md |    5 +
 ...18-04-24_ob_add-support-flexible.change.md |    5 +
 ...05-10_brandur_add-support-issuer.change.md |    5 +
 ...andur_add-usermesage-stripeerror.change.md |    5 +
 ...-05-14_brandur_handle-case-where.change.md |    5 +
 .../2018-06-19_ob_add-repr-methods.change.md  |    5 +
 ...8-06-28_ob_add-support-partnerid.change.md |    5 +
 ...018-06-29_ob_add-support-payment.change.md |    5 +
 ...-07-04_ob_fix-serializatio-empty.change.md |    5 +
 ...18-07-06_ob_better-hopefully-fix.change.md |    5 +
 .../2018-07-10_ob_fix-setup-py.change.md      |    5 +
 ..._unknown_minimum-python-versions.change.md |    4 +
 ...10_unknown_some-older-deprecated.change.md |    4 +
 ...unknown_stripe-exception-classes.change.md |    4 +
 ...unknown_trying-detach-unattached.change.md |    4 +
 ...18_ob_avoid-duplicate-dependency.change.md |    5 +
 ...nternal-improvements-apiresource.change.md |    5 +
 ...-07-25_ob_add-invoicelinei-class.change.md |    5 +
 ...2018-07-26_ob_add-support-stripe.change.md |    5 +
 .../2018-07-27_ob_add-support-sigma.change.md |    5 +
 ...2018-08-03_ob_add-cancel-support.change.md |    5 +
 .../2018-08-03_ob_add-support-file.change.md  |    5 +
 ...andur_remove-unsupported-bitcoin.change.md |    5 +
 .../2018-08-23_ob_add-support-usage.change.md |    5 +
 ...8-09-05_ob_add-support-reporting.change.md |    5 +
 ...rmsurawong_add-support-automatic.change.md |    5 +
 .../changes/2018-09-13_ob_don-t-url.change.md |    5 +
 ...18-09-13_ob_integer-index-encode.change.md |    5 +
 ...09-24_brandur_add-support-stripe.change.md |    5 +
 ...-09-24_ob_rename-fileupload-file.change.md |    5 +
 ..._brandur_correct-behavior-stripe.change.md |    5 +
 ...18-10-30_remi_add-support-person.change.md |    5 +
 ...30_remi_add-support-webhookendpo.change.md |    5 +
 ...8-11-06_ob_bump-minimum-requests.change.md |    5 +
 .../2018-11-09_remi_add-new-api.change.md     |    5 +
 ...8-11-22_ob_make-striperespon-new.change.md |    5 +
 ...8-11-27_ob_add-support-valuelist.change.md |    5 +
 ...18-11-28_remi_add-support-review.change.md |    5 +
 ...8-11-30_ob_add-support-providing.change.md |    5 +
 ...018-12-11_ob_add-support-account.change.md |    5 +
 ...-12-21_remi_add-support-checkout.change.md |    5 +
 ...15_ob_add-configurable-telemetry.change.md |    5 +
 ...ob_properly-serialize-individual.change.md |    5 +
 ...remi_rename-checkoutsess-session.change.md |    5 +
 ...01-29_brandur_reuse-default-http.change.md |    5 +
 ...-30_brandur_fix-client-telemetry.change.md |    5 +
 ...brandur_fix-session-initializati.change.md |    5 +
 ...1-30_ob_make-requestsclie-thread.change.md |    5 +
 ...2-12_ob_add-support-subscription.change.md |    5 +
 .../2019-03-14_ob_add-stripe-util.change.md   |    5 +
 ...-03-19_remi_add-support-deleting.change.md |    5 +
 ...19_remi_add-support-paymentmetho.change.md |    5 +
 ...3-19_remi_add-support-retrieving.change.md |    5 +
 .../2019-04-03_ob_add-class-methods.change.md |    5 +
 .../2019-04-03_ob_add-delete-class.change.md  |    5 +
 ...019-04-08_ob_fix-encoding-nested.change.md |    5 +
 ...4-18_remi_add-support-creditnote.change.md |    5 +
 ...019-04-22_remi_add-support-taxid.change.md |    5 +
 ...9-04-24_remi_add-support-taxrate.change.md |    5 +
 ...-05-14_ob_add-support-capability.change.md |    5 +
 .../2019-05-20_ob_fix-few-code.change.md      |    5 +
 .../2019-05-23_ob_add-support-radar.change.md |    5 +
 .../2019-05-23_ob_fix-few-more.change.md      |    5 +
 ...9-05-31_ob_replace-pipenv-poetry.change.md |    5 +
 ...5-31_ob_verify-signatures-before.change.md |    5 +
 ...06-03_ob_remove-poetry-reinstate.change.md |    5 +
 ...6-17_ob_add-support-customerbala.change.md |    5 +
 ...21_remi_fix-support-customerbala.change.md |    5 +
 ...-06-25_ob_enable-request-latency.change.md |    5 +
 ...-27_remi_add-support-setupintent.change.md |    5 +
 .../2019-07-08_ob_fix-argument-name.change.md |    5 +
 ...emi_listing-balancetrans-objects.change.md |    5 +
 ...019-08-06_ob_add-support-passing.change.md |    5 +
 .../2019-08-06_ob_bump-vendored-six.change.md |    5 +
 .../2019-08-06_ob_fix-del-statement.change.md |    5 +
 ...lex_remove-subscription-schedule.change.md |    7 +
 ...ob_add-subscription-createusager.change.md |    5 +
 ...randur_clarify-what-maxnetworkre.change.md |    5 +
 ...9-08-20_ob_fix-automatic-retries.change.md |    5 +
 ...2019-09-10_ob_add-support-header.change.md |    5 +
 ...-11_ob_use-listobject-properties.change.md |    5 +
 ...9-12_ob_use-ordereddict-maintain.change.md |    5 +
 ...019-09-14_ob_pass-cflags-ldflags.change.md |    5 +
 ...6_ob_add-errorobject-stripeerror.change.md |    5 +
 .../2019-09-26_ob_check-error-dict.change.md  |    5 +
 ...rayalex_implement-support-stripe.change.md |    5 +
 ...9-10-24_ob_contributor-convenant.change.md |    5 +
 ...019-10-29_ob_add-support-reverse.change.md |    5 +
 ...019-11-06_ob_add-support-mandate.change.md |    5 +
 ...ex_add-listusagerec-listsourcetr.change.md |    5 +
 ...1-26_remi_add-support-creditnote.change.md |    5 +
 .../2019-12-03_ob_update-proxy-py.change.md   |    5 +
 ...019-12-23_remi_update-python-api.change.md |    5 +
 ...019-12-31_ob_fix-uploading-files.change.md |    5 +
 ...20-01-07_ob_start-testing-python.change.md |    5 +
 ...1-14_ob_add-support-creditnoteli.change.md |    5 +
 .../2020-01-14_ob_pin-black-version.change.md |    5 +
 ...0-02-26_remi_add-support-listing.change.md |    5 +
 ...20-03-23_ob_allow-overriding-api.change.md |    5 +
 ...020-04-06_ob_add-support-express.change.md |    5 +
 ...22_remi_add-support-billingporta.change.md |    5 +
 ...020-04-29_remi_add-support-price.change.md |    5 +
 ...-05-12_remi_add-support-lineitem.change.md |    5 +
 ...-13_richardm_support-stripe-file.change.md |    5 +
 ...05_remi_add-support-promotioncod.change.md |    5 +
 ...0-09-02_remi_add-support-issuing.change.md |    5 +
 .../2020-09-29_unknown_2-52-0.change.md       |    4 +
 ...30_remi_add-support-setupattempt.change.md |    5 +
 ...20-10-14_remi_add-support-payout.change.md |    5 +
 ..._richardm_include-examples-built.change.md |    5 +
 ...20-12-01_ob_start-testing-python.change.md |    5 +
 .../2020-12-01_remi_fix-issue-where.change.md |    5 +
 .../2021-02-04_ob_fix-ca-bundle.change.md     |    5 +
 ...-20_richardm_add-support-billing.change.md |    5 +
 ...05-19_seang_add-support-identity.change.md |    5 +
 .../2021-06-04_richardm_api-updates.change.md |    8 +
 ...1-07-09_richardm_725-add-support.change.md |    5 +
 .../2021-07-14_dcr_api-updates.change.md      |    8 +
 .../2021-10-08_dcr_stop-sending-raw.change.md |    5 +
 .../2021-10-11_richardm_api-updates.change.md |    8 +
 .../2021-11-11_richardm_api-updates.change.md |    8 +
 .../2021-11-16_dcr_api-updates.change.md      |    8 +
 ...09_dcr_clarify-metadata-deletion.change.md |    5 +
 ...-21_dcr_introduce-custom-listing.change.md |    5 +
 ...21-12-21_dcr_update-class-custom.change.md |    5 +
 ...19_richardm_start-testing-python.change.md |    5 +
 .../2022-01-20_richardm_api-updates.change.md |    8 +
 .../2022-02-15_richardm_api-updates.change.md |    8 +
 .../2022-03-01_richardm_api-updates.change.md |    8 +
 ...-17_dcr_add-support-searchresult.change.md |    5 +
 .../2022-03-23_dcr_api-updates.change.md      |    8 +
 ...-25_pakrym_add-infrastructu-test.change.md |    5 +
 ...2-03-25_pakrym_revert-orders-use.change.md |    5 +
 .../2022-03-28_pakrym_api-updates.change.md   |    9 +
 ...3-28_pakrym_pin-click-dependency.change.md |    5 +
 .../2022-03-29_pakrym_api-updates.change.md   |    8 +
 .../2022-04-08_kamil_api-updates.change.md    |    8 +
 .../2022-04-13_richardm_api-updates.change.md |    8 +
 .../2022-04-15_richardm_794-795-api.change.md |    7 +
 .../2022-04-21_richardm_api-updates.change.md |    8 +
 .../2022-05-03_dcr_api-updates.change.md      |    8 +
 .../2022-05-05_dcr_api-updates.change.md      |    8 +
 ...9_richardm_release-major-version.change.md |   14 +
 ...5-18_kamil_add-sanitizeid-method.change.md |    5 +
 ...2022-05-19_dcr_bump-vendored-six.change.md |    5 +
 ...2-05-19_dcr_set-daemon-attribute.change.md |    5 +
 ...022-05-19_dcr_start-testing-pypy.change.md |    5 +
 .../2022-05-20_dcr_api-updates.change.md      |   10 +
 .../2022-05-23_pakrym_api-updates.change.md   |    8 +
 .../2022-06-08_dcr_fix-update-cash.change.md  |    5 +
 ...15_pakrym_trigger-workflows-beta.change.md |    5 +
 .../2022-06-17_kamil_api-updates.change.md    |    8 +
 .../2022-06-30_dcr_api-updates.change.md      |   10 +
 ...022-07-06_pakrym_api-updates-use.change.md |    6 +
 ...022-07-07_pakrym_api-updates-add.change.md |    6 +
 ...-08-01_pakrym_next-major-release.change.md |    6 +
 .../2022-08-02_pakrym_api-updates.change.md   |    6 +
 ...nknown_consistent-other-resource.change.md |    6 +
 ...nown_consistent-other-resource_2.change.md |    6 +
 ...nown_consistent-other-resource_3.change.md |    6 +
 ...02_unknown_lineitem-resource-now.change.md |    6 +
 ..._removed-deprecated-alipayaccoun.change.md |    6 +
 ..._unknown_removed-deprecated-card.change.md |    6 +
 ...nknown_removed-deprecated-charge.change.md |    6 +
 ...nown_removed-deprecated-charge_2.change.md |    6 +
 ...nknown_removed-deprecated-source.change.md |    6 +
 ..._removed-deprecated-subscription.change.md |    6 +
 ...02_unknown_request-sending-logic.change.md |    5 +
 ...02_unknown_update-ca-certificate.change.md |    5 +
 .../2022-08-03_dcr_fix-issue-where.change.md  |    5 +
 ...03_pakrym_fix-incorrect-handling.change.md |    7 +
 ...-08-03_yejia_fix-test-testcharge.change.md |    5 +
 ...-08-17_ramya_add-support-section.change.md |    5 +
 .../2022-08-19_kamil_api-updates.change.md    |    8 +
 .../2022-08-23_dcr_api-updates.change.md      |    8 +
 ...09-06_yejia_add-abstract-methods.change.md |    5 +
 .../2022-09-23_pakrym_api-updates.change.md   |    8 +
 ...2_anniel_removed-orders-resource.change.md |    7 +
 ...-15_richardm_hide-misleading-ssl.change.md |    5 +
 ...0-17_anniel_removed-sku-resource.change.md |    7 +
 ...22-10-24_anniel_do-run-coveralls.change.md |    5 +
 ...0-27_anniel_fixed-mistyped-names.change.md |    7 +
 .../2022-11-02_kamil_api-updates.change.md    |    6 +
 ...-11-16_anniel_next-major-release.change.md |    6 +
 ...16_unknown_deprecate-save-method.change.md |   15 +
 ...6_unknown_dropped-support-python.change.md |    6 +
 ...1-30_richardm_pass-params-logger.change.md |    5 +
 .../2023-02-02_richardm_api-updates.change.md |    8 +
 ...2-06_richardm_bugfix-revert-pass.change.md |    5 +
 .../2023-02-16_anniel_api-updates.change.md   |    8 +
 ...-23_pakrym_update-generated-code.change.md |   10 +
 ...-30_anniel_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...23-08-14_richardm_pin-latest-api.change.md |   35 +
 ...-16_richardm_1008-remove-support.change.md |    7 +
 ...richardm_assert-types-pagination.change.md |    8 +
 ...rdm_removed-testhelper-decorator.change.md |    8 +
 ...3_richardm_adds-type-annotations.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    6 +
 ...-31_richardm_types-crudl-methods.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...richardm_types-annotate-resource.change.md |    5 +
 ...05_anniel_require-typingextens-4.change.md |    5 +
 ...-09-05_richardm_types-listobject.change.md |    5 +
 ...9-06_richardm_types-expandablefi.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...richardm_explicitly-define-crudl.change.md |    5 +
 ...12_richardm_types-datetimes-ints.change.md |    5 +
 ...ichardm_generate-explicit-nested.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...9-21_richardm_add-optional-types.change.md |    5 +
 ...richardm_partially-type-resource.change.md |    5 +
 ...09-21_richardm_types-add-deleted.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    6 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...23-10-16_unknown_please-read-api.change.md |    4 +
 ...0-18_richardm_apirequestor-don-t.change.md |    5 +
 ...-25_richardm_add-util-deprecated.change.md |    5 +
 ..._richardm_inner-resource-classes.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...-10-27_richardm_include-py-typed.change.md |    8 +
 ...3-10-31_richardm_types-add-types.change.md |    5 +
 ..._richardm_types-use-staticmethod.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...3-11-06_anniel_types-remove-none.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...-11-10_pakrym_add-support-python.change.md |    5 +
 ...3-11-10_pakrym_move-python3-venv.change.md |    5 +
 ...10_richardm_suppress-type-errors.change.md |    5 +
 ...-15_pakrym_fix-unnecessary-casts.change.md |    5 +
 ...023-11-15_pakrym_run-pyright-via.change.md |    5 +
 ..._pakrym_upgrade-black-dependency.change.md |    5 +
 ...3-11-16_pakrym_add-initial-tests.change.md |    5 +
 ...16_richardm_mention-types-readme.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   14 +
 ...pe-openapi_update-generated-code.change.md |   17 +
 ...chardm_refactor-integration-test.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   18 +
 ...-12-05_pakrym_move-resource-type.change.md |   19 +
 ...2-07_pakrym_add-missing-explicit.change.md |    5 +
 ...3-12-07_pakrym_fix-getattr-raise.change.md |    5 +
 ...3-12-07_pakrym_move-exports-more.change.md |   20 +
 ...pe-openapi_update-generated-code.change.md |   17 +
 ...-11_pakrym_do-raise-deprecationw.change.md |    5 +
 ...23-12-11_richardm_add-more-types.change.md |    5 +
 ...2_richardm_mark-defunct-internal.change.md |    5 +
 ..._richardm_track-usage-deprecated.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |   10 +
 ...nniel_support-accessing-reserved.change.md |    5 +
 ...niel_remove-apibase-requestoptio.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   24 +
 ...pe-openapi_update-generated-code.change.md |    6 +
 ...pe-openapi_update-generated-code.change.md |   13 +
 ...pe-openapi_update-generated-code.change.md |   13 +
 ...pe-openapi_update-generated-code.change.md |   18 +
 ...24-01-25_anniel_stripe-python-v8.change.md |   50 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...pe-openapi_update-generated-code.change.md |   11 +
 ...nniel_measure-stripeclient-usage.change.md |    5 +
 ...richardm_move-stripeclient-usage.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   12 +
 ...ichardm_improve-types-httpclient.change.md |    5 +
 ...02-15_anniel_remove-broken-child.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |   13 +
 ...2-16_richardm_testing-unify-http.change.md |    5 +
 ...2-20_richardm_remove-http-client.change.md |    5 +
 ...2024-02-22_anniel_add-taxids-api.change.md |    8 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...2-23_anniel_fix-type-errorobject.change.md |    5 +
 ...-02-28_helenye_update-readme-use.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   14 +
 ...-03-07_richardm_update-readme-md.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   11 +
 ...3-14_ramya_update-generated-code.change.md |   12 +
 ...pe-openapi_update-generated-code.change.md |   20 +
 ...24-03-26_pakrym_update-readme-md.change.md |    5 +
 ...ichardm_types-remove-unnecessary.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...4-03_richardm_port-async-support.change.md |   12 +
 ...24-04-04_richardm_bump-aiohttp-3.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   34 +
 ...024-04-05_richardm_fix-readme-md.change.md |    5 +
 ..._richardm_tweak-changelog-python.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 .../2024-04-10_ramya_api-updates.change.md    |   53 +
 ...04-11_ramya_use-stdlib-asyncmock.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   27 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...04-17_prathmesh_update-quote-pdf.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...024-04-22_helenye_bump-aiohttp-3.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   18 +
 ...024-04-26_anniel_fix-type-change.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   14 +
 ...pe-openapi_update-generated-code.change.md |   14 +
 ...4-05-13_xavdid_switch-black-ruff.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   21 +
 ...pe-openapi_update-generated-code.change.md |   10 +
 ...2024-05-24_ramya_add-method-list.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |   17 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |   28 +
 ...pe-openapi_update-generated-code.change.md |   15 +
 ...pe-openapi_update-generated-code.change.md |   10 +
 ...07-11_prathmesh_update-changelog.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   15 +
 ...pe-openapi_update-generated-code.change.md |   11 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...-openapi_update-generated-code_2.change.md |   17 +
 ...pe-openapi_update-generated-code.change.md |   12 +
 ...pe-openapi_update-generated-code.change.md |   25 +
 ...pe-openapi_update-generated-code.change.md |   13 +
 ...08-29_ramya_generate-sdk-openapi.change.md |   11 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |   14 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...-openapi_update-generated-code_2.change.md |   14 +
 ...024-10-01_ramya_support-apis-new.change.md |   35 +
 ...-03_ramya_update-class-thinevent.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...2024-10-09_jar_clean-up-examples.change.md |    5 +
 ...8_helenye_deserialize-correct-v2.change.md |    7 +
 ...-10-18_xavdid_update-object-tags.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |   38 +
 ...pe-openapi_update-generated-code.change.md |   28 +
 ...2_xavdid_fix-deprecation-warning.change.md |    5 +
 ...-16_jar_fix-stripeerror-httpbody.change.md |    7 +
 ...17_xavdid_fix-using-autopagingit.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   68 +
 ...4-12-19_jar_fix-regression-using.change.md |    5 +
 ...2025-01-13_jar_fix-v2-listobject.change.md |    7 +
 ...25-01-13_jar_fix-v2-listobject_2.change.md |    7 +
 ...01-14_xavdid_add-justfile-update.change.md |    5 +
 ...-14_xavdid_add-justfile-update_2.change.md |    5 +
 ...1-16_xavdid_minor-justfile-fixes.change.md |    5 +
 ...16_xavdid_minor-justfile-fixes_2.change.md |    5 +
 ...-01-17_jar_added-contributing-md.change.md |    5 +
 ...1-17_jar_added-contributing-md_2.change.md |    5 +
 ...25-01-21_xavdid_add-just-publish.change.md |    5 +
 ...-01-21_xavdid_add-just-publish_2.change.md |    5 +
 ...rathmesh_updated-upload-artifact.change.md |    5 +
 ...thmesh_updated-upload-artifact_2.change.md |    5 +
 ...1-27_helenye_revert-bump-version.change.md |    5 +
 ...elenye_upgrade-download-artifact.change.md |    5 +
 ...enye_upgrade-download-artifact_2.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   32 +
 ...-openapi_update-generated-code_2.change.md |   32 +
 ...02-13_xavdid_add-codeowners-file.change.md |    5 +
 ...2-13_xavdid_upgrade-ruff-version.change.md |    5 +
 ...lenye_remove-incorrect-changelog.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   16 +
 ...-19_ramya_fix-incorrect-property.change.md |   10 +
 ..._stripe-openapi_support-apis-new.change.md |   93 +
 ...-31_xavdid_rename-stripestream-s.change.md |   11 +
 ...ramya_update-readme-clarificatio.change.md |    5 +
 .../2025-04-15_xavdid_fix-type-hint.change.md |    5 +
 ...04-18_mbroshi_encode-bools-lower.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |   29 +
 ...5-05-02_jar_adds-contributing-md.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   37 +
 ...25-06-30_ramya_fix-link-releases.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   40 +
 ...5-07-11_helenye_fix-timeout-type.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   26 +
 ...rathmesh_introduce-v1-namespaces.change.md |   15 +
 ...-08-27_ramya_add-section-private.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   25 +
 ...-27_xavdid_import-available-http.change.md |    5 +
 ...4_mbroshi_fix-paginate-backwards.change.md |    7 +
 .../2025-09-09_xavdid_build-sdk-w.change.md   |    9 +
 .../2025-09-18_xavdid_don-t-use.change.md     |    7 +
 ...enamed-urllib2clien-urllibclient.change.md |    8 +
 ...23_stripe-openapi_1593-1607-1605.change.md |   48 +
 ...25-09-24_xavdid_migrate-setup-py.change.md |    9 +
 ...5_xavdid_add-stripecontex-object.change.md |    9 +
 ...-09-25_xavdid_add-strongly-typed.change.md |   12 +
 ...thmesh_fixed-invoicelinei-method.change.md |    9 +
 .../2025-09-29_xavdid_move-v2-event.change.md |    8 +
 ...d_remove-deprecated-compatibilit.change.md |   44 +
 ...30_unknown_deprecated-v1-service.change.md |   14 +
 ...09-30_xavdid_drop-support-python.change.md |   10 +
 ...30_xavdid_unify-resource-service.change.md |   10 +
 ...25-10-02_helenye_make-new-nested.change.md |    8 +
 .../2025-10-02_xavdid_re-add-tests.change.md  |    7 +
 .../2025-10-03_xavdid_add-new-async.change.md |    8 +
 ...025-10-03_xavdid_remove-gpg-step.change.md |    5 +
 ...dramatically-improve-performance.change.md |    9 +
 ...pe-openapi_update-generated-code.change.md |   49 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...-10-31_xavdid_fix-stripe-context.change.md |    5 +
 ...stripe-openapi_add-support-value.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...pe-openapi_update-generated-code.change.md |   25 +
 ...25-11-17_mbroshi_update-v2-array.change.md |    7 +
 ...pe-openapi_update-generated-code.change.md |    9 +
 ...1-21_xavdid_throw-specific-error.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |    8 +
 ...-24_ramya_add-createasync-method.change.md |    5 +
 ...-08_prathmesh_updated-bundled-ca.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   42 +
 ...2025-12-17_mbroshi_update-ci-run.change.md |    5 +
 ..._ramya_fix-deprecationw-encoding.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   10 +
 ...ya_add-documentatio-undocumented.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   26 +
 ...athmesh_added-instruction-update.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   31 +
 ...ukutla_allow-aiohttpclien-accept.change.md |    5 +
 ...-28_xavdid_add-agent-information.change.md |    5 +
 ...-03-05_xavdid_add-stripe-request.change.md |    5 +
 ...3-18_mbroshi_add-runtime-support.change.md |    6 +
 ...03-18_xavdid_drop-support-python.change.md |    6 +
 ...did_stripeobject-longer-inherits.change.md |   13 +
 ...6-03-24_xavdid_throw-error-using.change.md |    6 +
 ...25_jar_add-decimalstrin-coercion.change.md |   18 +
 ...5_unknown_generated-changes-1749.change.md |   43 +
 .../2026-03-31_xavdid_fix-str-repr.change.md  |    5 +
 .../2026-04-01_jar_fix-encoding-two.change.md |    5 +
 ...01_xavdid_improve-types-metadata.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   47 +
 ...05-22_xavdid_emit-warning-stripe.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   57 +
 ...26-06-05_xavdid_add-source-field.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   43 +
 ...-01_jar_reduce-stripeclient-cold.change.md |    7 +
 ...07-09_xavdid_remove-unused-retry.change.md |    5 +
 ...6-07-10_xavdid_make-error-fields.change.md |    5 +
 ...07-16_xavdid_replace-source-hash.change.md |    5 +
 ...2026-07-16_xavdid_use-ip-address.change.md |    5 +
 ...-24_jar_fix-intermittent-windows.change.md |    5 +
 ...pe-openapi_update-generated-code.change.md |   52 +
 ...3_xavdid_add-stripe-majorapivers.change.md |    5 +
 ...26-08-06_xavdid_add-adjust-event.change.md |   11 +
 ...026-08-07_johno_emit-claude-code.change.md |    7 +
 ...7_xavdid_surface-object-property.change.md |    5 +
 ...26-08-10_jar_add-async-iteration.change.md |    7 +
 ...did_better-document-stripeobject.change.md |    5 +
 ...8-19_xavdid_add-new-eventnotific.change.md |   11 +
 ...pe-openapi_update-generated-code.change.md |   30 +
 ..._jar_dispatch-discriminate-union.change.md |    5 +
 ...8-31_xavdid_harden-api-requestor.change.md |    5 +
 ...1_xavdid_use-cryptographi-secure.change.md |    5 +
 .hark/intros/intro-13.0.0.md                  |    1 +
 .hark/intros/intro-15.0.0.md                  |    3 +
 .hark/intros/intro-2.0.0.md                   |    5 +
 .hark/intros/intro-2.29.3.md                  |    1 +
 .hark/intros/intro-4.0.0.md                   |    3 +
 .hark/intros/intro-5.0.0.md                   |    3 +
 .hark/intros/intro-6.0.0.md                   |    1 +
 .hark/releases.json                           | 1977 +++++++++++++++++
 CHANGELOG.md                                  | 1526 +++++++------
 justfile                                      |    7 +
 623 files changed, 7668 insertions(+), 734 deletions(-)
 create mode 100644 .github/workflows/changelog.yml
 create mode 100644 .hark/changes/2012-02-04_unknown_parameters-value-none.change.md
 create mode 100644 .hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md
 create mode 100644 .hark/changes/2012-05-17_unknown_add-new-stripe.change.md
 create mode 100644 .hark/changes/2012-05-17_unknown_numerous-test-suite.change.md
 create mode 100644 .hark/changes/2012-05-17_unknown_switch-using-http.change.md
 create mode 100644 .hark/changes/2012-05-21_unknown_prefer-app-engine.change.md
 create mode 100644 .hark/changes/2012-05-31_unknown_fix-bug-would.change.md
 create mode 100644 .hark/changes/2012-08-17_unknown_add-new-stripe.change.md
 create mode 100644 .hark/changes/2012-08-17_unknown_remove-uncapturedch-tests.change.md
 create mode 100644 .hark/changes/2012-08-31_unknown_add-update-pay.change.md
 create mode 100644 .hark/changes/2012-10-30_unknown_add-support-creating.change.md
 create mode 100644 .hark/changes/2012-10-30_unknown_add-support-new.change.md
 create mode 100644 .hark/changes/2012-10-30_unknown_add-support-new_2.change.md
 create mode 100644 .hark/changes/2012-11-08_unknown_add-support-updating.change.md
 create mode 100644 .hark/changes/2012-12-18_unknown_update-requests-version.change.md
 create mode 100644 .hark/changes/2013-01-15_unknown_add-support-setting.change.md
 create mode 100644 .hark/changes/2013-02-04_unknown_add-support-passing.change.md
 create mode 100644 .hark/changes/2013-02-21_unknown_add-id-list.change.md
 create mode 100644 .hark/changes/2013-04-11_unknown_add-new-stripe.change.md
 create mode 100644 .hark/changes/2013-04-11_unknown_allow-transfers-creatable.change.md
 create mode 100644 .hark/changes/2013-04-25_unknown_support-python-3.change.md
 create mode 100644 .hark/changes/2013-05-03_unknown_remove-id-list.change.md
 create mode 100644 .hark/changes/2013-07-12_unknown_add-support-multiple.change.md
 create mode 100644 .hark/changes/2013-08-12_unknown_add-support-unsetting.change.md
 create mode 100644 .hark/changes/2013-08-20_unknown_add-stripe-balance.change.md
 create mode 100644 .hark/changes/2013-09-18_unknown_add-support-closing.change.md
 create mode 100644 .hark/changes/2013-10-08_unknown_fix-issue-support.change.md
 create mode 100644 .hark/changes/2013-10-17_unknown_add-support-metadata.change.md
 create mode 100644 .hark/changes/2013-10-17_unknown_removed-incorrect-test.change.md
 create mode 100644 .hark/changes/2013-12-04_unknown_add-stripe-applicationf.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_abstracted-http-library.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_added-extensive-unit.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_extended-functional-test.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_pep8ified-codebase-enforced.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_previousmeta-attribute-resources.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_proper-encoding-timezone.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_refactored-code-modules.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_refactored-stripeobject-inherit.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_timezone-aware-datetime.change.md
 create mode 100644 .hark/changes/2013-12-05_unknown_todict-values-methods.change.md
 create mode 100644 .hark/changes/2014-01-29_unknown_added-support-multiple.change.md
 create mode 100644 .hark/changes/2014-03-13_unknown_added-license-other.change.md
 create mode 100644 .hark/changes/2014-03-13_unknown_fix-repr-python.change.md
 create mode 100644 .hark/changes/2014-03-13_unknown_fix-syntax-errors.change.md
 create mode 100644 .hark/changes/2014-03-13_unknown_support-pickling-responses.change.md
 create mode 100644 .hark/changes/2014-04-09_unknown_add-certificate-blacklist.change.md
 create mode 100644 .hark/changes/2014-04-09_unknown_don-t-rely.change.md
 create mode 100644 .hark/changes/2014-04-09_unknown_update-bundled-ca.change.md
 create mode 100644 .hark/changes/2014-04-09_unknown_use-der-encoded.change.md
 create mode 100644 .hark/changes/2014-05-19_unknown_disable-loading-ssl.change.md
 create mode 100644 .hark/changes/2014-05-22_unknown_support-cards-recipients.change.md
 create mode 100644 .hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md
 create mode 100644 .hark/changes/2014-06-10_unknown_remove-official-support.change.md
 create mode 100644 .hark/changes/2014-06-17_unknown_add-metadata-disputes.change.md
 create mode 100644 .hark/changes/2014-07-29_unknown_application-fee-refunds.change.md
 create mode 100644 .hark/changes/2014-10-23_unknown_remove-redundant-manual.change.md
 create mode 100644 .hark/changes/2014-12-23_unknown_adding-support-file.change.md
 create mode 100644 .hark/changes/2015-01-07_unknown_adding-bitcoin-receiver.change.md
 create mode 100644 .hark/changes/2015-01-21_unknown_remove-support-top.change.md
 create mode 100644 .hark/changes/2015-02-19_unknown_added-bitcoin-receiver.change.md
 create mode 100644 .hark/changes/2015-03-22_unknown_added-methods-updating.change.md
 create mode 100644 .hark/changes/2015-03-30_unknown_pass-stripeaccoun-balance.change.md
 create mode 100644 .hark/changes/2015-04-08_unknown_fix-saving-manage.change.md
 create mode 100644 .hark/changes/2015-06-04_unknown_fix-saving-additionalow.change.md
 create mode 100644 .hark/changes/2015-07-06_unknown_include-response-headers.change.md
 create mode 100644 .hark/changes/2015-08-03_unknown_added-dispute-listing.change.md
 create mode 100644 .hark/changes/2015-08-03_unknown_managed-accounts-can.change.md
 create mode 100644 .hark/changes/2015-08-05_unknown_fix-error-handling.change.md
 create mode 100644 .hark/changes/2015-08-17_unknown_added-refund-listing.change.md
 create mode 100644 .hark/changes/2015-09-11_unknown_add-support-new.change.md
 create mode 100644 .hark/changes/2015-09-14_unknown_products-skus-orders.change.md
 create mode 100644 .hark/changes/2015-10-02_unknown_add-ability-delete.change.md
 create mode 100644 .hark/changes/2015-10-02_unknown_add-configurable-http.change.md
 create mode 100644 .hark/changes/2015-10-02_unknown_official-python-3.change.md
 create mode 100644 .hark/changes/2016-01-04_unknown_add-automatic-paginating.change.md
 create mode 100644 .hark/changes/2016-01-04_unknown_all-method-list.change.md
 create mode 100644 .hark/changes/2016-01-04_unknown_calls-instanceurl-now.change.md
 create mode 100644 .hark/changes/2016-01-04_unknown_error-messages-set.change.md
 create mode 100644 .hark/changes/2016-01-04_unknown_list-objects-now.change.md
 create mode 100644 .hark/changes/2016-01-26_unknown_add-support-deleting.change.md
 create mode 100644 .hark/changes/2016-02-01_unknown_update-bundled-ca.change.md
 create mode 100644 .hark/changes/2016-02-27_unknown_add-countryspec-model.change.md
 create mode 100644 .hark/changes/2016-03-15_unknown_add-reject-account.change.md
 create mode 100644 .hark/changes/2016-03-24_unknown_fix-uploading-binary.change.md
 create mode 100644 .hark/changes/2016-03-31_unknown_update-ca-cert.change.md
 create mode 100644 .hark/changes/2016-04-11_unknown_fix-bug-where.change.md
 create mode 100644 .hark/changes/2016-04-12_unknown_fix-bug-where.change.md
 create mode 100644 .hark/changes/2016-05-04_unknown_add-support-new.change.md
 create mode 100644 .hark/changes/2016-05-20_unknown_add-support-alipay.change.md
 create mode 100644 .hark/changes/2016-05-24_unknown_add-support-returning.change.md
 create mode 100644 .hark/changes/2016-06-29_unknown_add-update-class.change.md
 create mode 100644 .hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md
 create mode 100644 .hark/changes/2016-09-15_unknown_add-support-apple.change.md
 create mode 100644 .hark/changes/2016-10-06_unknown_add-proxy-support.change.md
 create mode 100644 .hark/changes/2016-10-06_unknown_add-support-subscription.change.md
 create mode 100644 .hark/changes/2016-10-07_unknown_add-configurable-timeout.change.md
 create mode 100644 .hark/changes/2016-10-10_unknown_return-subscription-model.change.md
 create mode 100644 .hark/changes/2016-10-12_unknown_add-source-model.change.md
 create mode 100644 .hark/changes/2016-10-26_unknown_implement-copy-deepcopy.change.md
 create mode 100644 .hark/changes/2016-11-21_unknown_add-retrieve-method.change.md
 create mode 100644 .hark/changes/2016-11-30_unknown_add-support-verifying.change.md
 create mode 100644 .hark/changes/2016-12-16_unknown_add-request-logging.change.md
 create mode 100644 .hark/changes/2017-01-06_unknown_format-now-same.change.md
 create mode 100644 .hark/changes/2017-01-06_unknown_logs-properly-handle.change.md
 create mode 100644 .hark/changes/2017-01-06_unknown_request-logging-goes.change.md
 create mode 100644 .hark/changes/2017-01-06_unknown_use-internal-session.change.md
 create mode 100644 .hark/changes/2017-01-18_unknown_allow-sources-updated.change.md
 create mode 100644 .hark/changes/2017-02-21_unknown_add-account-modifyextern.change.md
 create mode 100644 .hark/changes/2017-02-21_unknown_add-customer-modifysource.change.md
 create mode 100644 .hark/changes/2017-02-21_unknown_fix-encoding-parameters.change.md
 create mode 100644 .hark/changes/2017-03-13_unknown_accept-session-argument.change.md
 create mode 100644 .hark/changes/2017-03-17_unknown_support-detaching-sources.change.md
 create mode 100644 .hark/changes/2017-03-20_unknown_support-oauth-operations.change.md
 create mode 100644 .hark/changes/2017-04-06_unknown_add-support-payouts.change.md
 create mode 100644 .hark/changes/2017-04-06_unknown_op-release-peg.change.md
 create mode 100644 .hark/changes/2017-04-28_unknown_add-stripe-setappinfo.change.md
 create mode 100644 .hark/changes/2017-04-28_unknown_support-checking-webhook.change.md
 create mode 100644 .hark/changes/2017-05-10_unknown_constrain-requests-2.change.md
 create mode 100644 .hark/changes/2017-05-11_unknown_remove-requests-constraint.change.md
 create mode 100644 .hark/changes/2017-05-25_unknown_add-support-account.change.md
 create mode 100644 .hark/changes/2017-05-26_unknown_add-apikey-parameter.change.md
 create mode 100644 .hark/changes/2017-05-31_unknown_fix-pycurl-client.change.md
 create mode 100644 .hark/changes/2017-06-02_unknown_re-use-connections.change.md
 create mode 100644 .hark/changes/2017-06-07_unknown_refactor-oauth-implementati.change.md
 create mode 100644 .hark/changes/2017-06-19_unknown_add-support-ephemeral.change.md
 create mode 100644 .hark/changes/2017-06-24_unknown_expose-code-invalidreque.change.md
 create mode 100644 .hark/changes/2017-06-27_unknown_pay-invoice-can.change.md
 create mode 100644 .hark/changes/2017-08-07_unknown_change-serializatio-subscription.change.md
 create mode 100644 .hark/changes/2017-08-29_unknown_add-support-invalidclien.change.md
 create mode 100644 .hark/changes/2017-09-01_unknown_error-invalid-type.change.md
 create mode 100644 .hark/changes/2017-09-01_unknown_fix-serializatio-items.change.md
 create mode 100644 .hark/changes/2017-09-07_unknown_add-support-passing.change.md
 create mode 100644 .hark/changes/2017-09-21_unknown_handle-bytearray-bytes.change.md
 create mode 100644 .hark/changes/2017-09-29_unknown_support-length-reads.change.md
 create mode 100644 .hark/changes/2017-10-11_brandur_rename-source-delete.change.md
 create mode 100644 .hark/changes/2017-10-19_brandur_add-static-methods.change.md
 create mode 100644 .hark/changes/2017-10-20_brandur_break-resource-py.change.md
 create mode 100644 .hark/changes/2017-10-20_brandur_fix-unpickling-stripeobject.change.md
 create mode 100644 .hark/changes/2017-10-23_brandur_support-uploading-files.change.md
 create mode 100644 .hark/changes/2017-10-26_brandur_support-listing-source.change.md
 create mode 100644 .hark/changes/2017-10-27_brandur_fix-byteswarning-being.change.md
 create mode 100644 .hark/changes/2017-10-31_brandur_fix-balance-transaction.change.md
 create mode 100644 .hark/changes/2017-10-31_brandur_support-exchange-rates.change.md
 create mode 100644 .hark/changes/2017-11-02_brandur_switch-vendored-version.change.md
 create mode 100644 .hark/changes/2017-11-07_brandur_remove-api-allowed.change.md
 create mode 100644 .hark/changes/2017-11-08_brandur_make-custom-actions.change.md
 create mode 100644 .hark/changes/2017-11-29_ob_add-only-changed.change.md
 create mode 100644 .hark/changes/2017-11-29_ob_use-custom-json.change.md
 create mode 100644 .hark/changes/2017-12-05_brandur_log-encoded-version.change.md
 create mode 100644 .hark/changes/2017-12-05_unknown_accidental-op-release.change.md
 create mode 100644 .hark/changes/2017-12-21_brandur_add-new-idempotencye.change.md
 create mode 100644 .hark/changes/2017-12-22_brandur_add-accessor-lastresponse.change.md
 create mode 100644 .hark/changes/2018-01-05_ob_drop-support-python.change.md
 create mode 100644 .hark/changes/2018-01-12_brandur_register-unsaved-attributes.change.md
 create mode 100644 .hark/changes/2018-02-08_ob_make-lastresponse-available.change.md
 create mode 100644 .hark/changes/2018-02-21_brandur_add-support-topups.change.md
 create mode 100644 .hark/changes/2018-02-21_ob_use-py-test.change.md
 create mode 100644 .hark/changes/2018-02-23_ob_add-support-code.change.md
 create mode 100644 .hark/changes/2018-02-23_ob_build-universal-wheels.change.md
 create mode 100644 .hark/changes/2018-02-27_brandur_drop-conditional-dependencies.change.md
 create mode 100644 .hark/changes/2018-02-27_ob_remove-deprecated-code.change.md
 create mode 100644 .hark/changes/2018-02-28_ob_remove-util-json.change.md
 create mode 100644 .hark/changes/2018-03-05_ob_update-setup-py.change.md
 create mode 100644 .hark/changes/2018-03-13_ob_use-pipenv.change.md
 create mode 100644 .hark/changes/2018-03-15_ob_change-exception-detaching.change.md
 create mode 100644 .hark/changes/2018-04-24_ob_add-support-flexible.change.md
 create mode 100644 .hark/changes/2018-05-10_brandur_add-support-issuer.change.md
 create mode 100644 .hark/changes/2018-05-14_brandur_add-usermesage-stripeerror.change.md
 create mode 100644 .hark/changes/2018-05-14_brandur_handle-case-where.change.md
 create mode 100644 .hark/changes/2018-06-19_ob_add-repr-methods.change.md
 create mode 100644 .hark/changes/2018-06-28_ob_add-support-partnerid.change.md
 create mode 100644 .hark/changes/2018-06-29_ob_add-support-payment.change.md
 create mode 100644 .hark/changes/2018-07-04_ob_fix-serializatio-empty.change.md
 create mode 100644 .hark/changes/2018-07-06_ob_better-hopefully-fix.change.md
 create mode 100644 .hark/changes/2018-07-10_ob_fix-setup-py.change.md
 create mode 100644 .hark/changes/2018-07-10_unknown_minimum-python-versions.change.md
 create mode 100644 .hark/changes/2018-07-10_unknown_some-older-deprecated.change.md
 create mode 100644 .hark/changes/2018-07-10_unknown_stripe-exception-classes.change.md
 create mode 100644 .hark/changes/2018-07-10_unknown_trying-detach-unattached.change.md
 create mode 100644 .hark/changes/2018-07-18_ob_avoid-duplicate-dependency.change.md
 create mode 100644 .hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md
 create mode 100644 .hark/changes/2018-07-25_ob_add-invoicelinei-class.change.md
 create mode 100644 .hark/changes/2018-07-26_ob_add-support-stripe.change.md
 create mode 100644 .hark/changes/2018-07-27_ob_add-support-sigma.change.md
 create mode 100644 .hark/changes/2018-08-03_ob_add-cancel-support.change.md
 create mode 100644 .hark/changes/2018-08-03_ob_add-support-file.change.md
 create mode 100644 .hark/changes/2018-08-16_brandur_remove-unsupported-bitcoin.change.md
 create mode 100644 .hark/changes/2018-08-23_ob_add-support-usage.change.md
 create mode 100644 .hark/changes/2018-09-05_ob_add-support-reporting.change.md
 create mode 100644 .hark/changes/2018-09-07_mickjermsurawong_add-support-automatic.change.md
 create mode 100644 .hark/changes/2018-09-13_ob_don-t-url.change.md
 create mode 100644 .hark/changes/2018-09-13_ob_integer-index-encode.change.md
 create mode 100644 .hark/changes/2018-09-24_brandur_add-support-stripe.change.md
 create mode 100644 .hark/changes/2018-09-24_ob_rename-fileupload-file.change.md
 create mode 100644 .hark/changes/2018-10-02_brandur_correct-behavior-stripe.change.md
 create mode 100644 .hark/changes/2018-10-30_remi_add-support-person.change.md
 create mode 100644 .hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md
 create mode 100644 .hark/changes/2018-11-06_ob_bump-minimum-requests.change.md
 create mode 100644 .hark/changes/2018-11-09_remi_add-new-api.change.md
 create mode 100644 .hark/changes/2018-11-22_ob_make-striperespon-new.change.md
 create mode 100644 .hark/changes/2018-11-27_ob_add-support-valuelist.change.md
 create mode 100644 .hark/changes/2018-11-28_remi_add-support-review.change.md
 create mode 100644 .hark/changes/2018-11-30_ob_add-support-providing.change.md
 create mode 100644 .hark/changes/2018-12-11_ob_add-support-account.change.md
 create mode 100644 .hark/changes/2018-12-21_remi_add-support-checkout.change.md
 create mode 100644 .hark/changes/2019-01-15_ob_add-configurable-telemetry.change.md
 create mode 100644 .hark/changes/2019-01-21_ob_properly-serialize-individual.change.md
 create mode 100644 .hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md
 create mode 100644 .hark/changes/2019-01-29_brandur_reuse-default-http.change.md
 create mode 100644 .hark/changes/2019-01-30_brandur_fix-client-telemetry.change.md
 create mode 100644 .hark/changes/2019-01-30_brandur_fix-session-initializati.change.md
 create mode 100644 .hark/changes/2019-01-30_ob_make-requestsclie-thread.change.md
 create mode 100644 .hark/changes/2019-02-12_ob_add-support-subscription.change.md
 create mode 100644 .hark/changes/2019-03-14_ob_add-stripe-util.change.md
 create mode 100644 .hark/changes/2019-03-19_remi_add-support-deleting.change.md
 create mode 100644 .hark/changes/2019-03-19_remi_add-support-paymentmetho.change.md
 create mode 100644 .hark/changes/2019-03-19_remi_add-support-retrieving.change.md
 create mode 100644 .hark/changes/2019-04-03_ob_add-class-methods.change.md
 create mode 100644 .hark/changes/2019-04-03_ob_add-delete-class.change.md
 create mode 100644 .hark/changes/2019-04-08_ob_fix-encoding-nested.change.md
 create mode 100644 .hark/changes/2019-04-18_remi_add-support-creditnote.change.md
 create mode 100644 .hark/changes/2019-04-22_remi_add-support-taxid.change.md
 create mode 100644 .hark/changes/2019-04-24_remi_add-support-taxrate.change.md
 create mode 100644 .hark/changes/2019-05-14_ob_add-support-capability.change.md
 create mode 100644 .hark/changes/2019-05-20_ob_fix-few-code.change.md
 create mode 100644 .hark/changes/2019-05-23_ob_add-support-radar.change.md
 create mode 100644 .hark/changes/2019-05-23_ob_fix-few-more.change.md
 create mode 100644 .hark/changes/2019-05-31_ob_replace-pipenv-poetry.change.md
 create mode 100644 .hark/changes/2019-05-31_ob_verify-signatures-before.change.md
 create mode 100644 .hark/changes/2019-06-03_ob_remove-poetry-reinstate.change.md
 create mode 100644 .hark/changes/2019-06-17_ob_add-support-customerbala.change.md
 create mode 100644 .hark/changes/2019-06-21_remi_fix-support-customerbala.change.md
 create mode 100644 .hark/changes/2019-06-25_ob_enable-request-latency.change.md
 create mode 100644 .hark/changes/2019-06-27_remi_add-support-setupintent.change.md
 create mode 100644 .hark/changes/2019-07-08_ob_fix-argument-name.change.md
 create mode 100644 .hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md
 create mode 100644 .hark/changes/2019-08-06_ob_add-support-passing.change.md
 create mode 100644 .hark/changes/2019-08-06_ob_bump-vendored-six.change.md
 create mode 100644 .hark/changes/2019-08-06_ob_fix-del-statement.change.md
 create mode 100644 .hark/changes/2019-08-09_rattrayalex_remove-subscription-schedule.change.md
 create mode 100644 .hark/changes/2019-08-13_ob_add-subscription-createusager.change.md
 create mode 100644 .hark/changes/2019-08-14_brandur_clarify-what-maxnetworkre.change.md
 create mode 100644 .hark/changes/2019-08-20_ob_fix-automatic-retries.change.md
 create mode 100644 .hark/changes/2019-09-10_ob_add-support-header.change.md
 create mode 100644 .hark/changes/2019-09-11_ob_use-listobject-properties.change.md
 create mode 100644 .hark/changes/2019-09-12_ob_use-ordereddict-maintain.change.md
 create mode 100644 .hark/changes/2019-09-14_ob_pass-cflags-ldflags.change.md
 create mode 100644 .hark/changes/2019-09-26_ob_add-errorobject-stripeerror.change.md
 create mode 100644 .hark/changes/2019-09-26_ob_check-error-dict.change.md
 create mode 100644 .hark/changes/2019-10-05_rattrayalex_implement-support-stripe.change.md
 create mode 100644 .hark/changes/2019-10-24_ob_contributor-convenant.change.md
 create mode 100644 .hark/changes/2019-10-29_ob_add-support-reverse.change.md
 create mode 100644 .hark/changes/2019-11-06_ob_add-support-mandate.change.md
 create mode 100644 .hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md
 create mode 100644 .hark/changes/2019-11-26_remi_add-support-creditnote.change.md
 create mode 100644 .hark/changes/2019-12-03_ob_update-proxy-py.change.md
 create mode 100644 .hark/changes/2019-12-23_remi_update-python-api.change.md
 create mode 100644 .hark/changes/2019-12-31_ob_fix-uploading-files.change.md
 create mode 100644 .hark/changes/2020-01-07_ob_start-testing-python.change.md
 create mode 100644 .hark/changes/2020-01-14_ob_add-support-creditnoteli.change.md
 create mode 100644 .hark/changes/2020-01-14_ob_pin-black-version.change.md
 create mode 100644 .hark/changes/2020-02-26_remi_add-support-listing.change.md
 create mode 100644 .hark/changes/2020-03-23_ob_allow-overriding-api.change.md
 create mode 100644 .hark/changes/2020-04-06_ob_add-support-express.change.md
 create mode 100644 .hark/changes/2020-04-22_remi_add-support-billingporta.change.md
 create mode 100644 .hark/changes/2020-04-29_remi_add-support-price.change.md
 create mode 100644 .hark/changes/2020-05-12_remi_add-support-lineitem.change.md
 create mode 100644 .hark/changes/2020-07-13_richardm_support-stripe-file.change.md
 create mode 100644 .hark/changes/2020-08-05_remi_add-support-promotioncod.change.md
 create mode 100644 .hark/changes/2020-09-02_remi_add-support-issuing.change.md
 create mode 100644 .hark/changes/2020-09-29_unknown_2-52-0.change.md
 create mode 100644 .hark/changes/2020-09-30_remi_add-support-setupattempt.change.md
 create mode 100644 .hark/changes/2020-10-14_remi_add-support-payout.change.md
 create mode 100644 .hark/changes/2020-11-20_richardm_include-examples-built.change.md
 create mode 100644 .hark/changes/2020-12-01_ob_start-testing-python.change.md
 create mode 100644 .hark/changes/2020-12-01_remi_fix-issue-where.change.md
 create mode 100644 .hark/changes/2021-02-04_ob_fix-ca-bundle.change.md
 create mode 100644 .hark/changes/2021-02-20_richardm_add-support-billing.change.md
 create mode 100644 .hark/changes/2021-05-19_seang_add-support-identity.change.md
 create mode 100644 .hark/changes/2021-06-04_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2021-07-09_richardm_725-add-support.change.md
 create mode 100644 .hark/changes/2021-07-14_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2021-10-08_dcr_stop-sending-raw.change.md
 create mode 100644 .hark/changes/2021-10-11_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2021-11-11_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2021-11-16_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2021-12-09_dcr_clarify-metadata-deletion.change.md
 create mode 100644 .hark/changes/2021-12-21_dcr_introduce-custom-listing.change.md
 create mode 100644 .hark/changes/2021-12-21_dcr_update-class-custom.change.md
 create mode 100644 .hark/changes/2022-01-19_richardm_start-testing-python.change.md
 create mode 100644 .hark/changes/2022-01-20_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2022-02-15_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2022-03-01_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2022-03-17_dcr_add-support-searchresult.change.md
 create mode 100644 .hark/changes/2022-03-23_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-03-25_pakrym_add-infrastructu-test.change.md
 create mode 100644 .hark/changes/2022-03-25_pakrym_revert-orders-use.change.md
 create mode 100644 .hark/changes/2022-03-28_pakrym_api-updates.change.md
 create mode 100644 .hark/changes/2022-03-28_pakrym_pin-click-dependency.change.md
 create mode 100644 .hark/changes/2022-03-29_pakrym_api-updates.change.md
 create mode 100644 .hark/changes/2022-04-08_kamil_api-updates.change.md
 create mode 100644 .hark/changes/2022-04-13_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2022-04-15_richardm_794-795-api.change.md
 create mode 100644 .hark/changes/2022-04-21_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2022-05-03_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-05-05_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-05-09_richardm_release-major-version.change.md
 create mode 100644 .hark/changes/2022-05-18_kamil_add-sanitizeid-method.change.md
 create mode 100644 .hark/changes/2022-05-19_dcr_bump-vendored-six.change.md
 create mode 100644 .hark/changes/2022-05-19_dcr_set-daemon-attribute.change.md
 create mode 100644 .hark/changes/2022-05-19_dcr_start-testing-pypy.change.md
 create mode 100644 .hark/changes/2022-05-20_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-05-23_pakrym_api-updates.change.md
 create mode 100644 .hark/changes/2022-06-08_dcr_fix-update-cash.change.md
 create mode 100644 .hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md
 create mode 100644 .hark/changes/2022-06-17_kamil_api-updates.change.md
 create mode 100644 .hark/changes/2022-06-30_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-07-06_pakrym_api-updates-use.change.md
 create mode 100644 .hark/changes/2022-07-07_pakrym_api-updates-add.change.md
 create mode 100644 .hark/changes/2022-08-01_pakrym_next-major-release.change.md
 create mode 100644 .hark/changes/2022-08-02_pakrym_api-updates.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_consistent-other-resource.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_lineitem-resource-now.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-alipayaccoun.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-card.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-charge.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-source.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_removed-deprecated-subscription.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_request-sending-logic.change.md
 create mode 100644 .hark/changes/2022-08-02_unknown_update-ca-certificate.change.md
 create mode 100644 .hark/changes/2022-08-03_dcr_fix-issue-where.change.md
 create mode 100644 .hark/changes/2022-08-03_pakrym_fix-incorrect-handling.change.md
 create mode 100644 .hark/changes/2022-08-03_yejia_fix-test-testcharge.change.md
 create mode 100644 .hark/changes/2022-08-17_ramya_add-support-section.change.md
 create mode 100644 .hark/changes/2022-08-19_kamil_api-updates.change.md
 create mode 100644 .hark/changes/2022-08-23_dcr_api-updates.change.md
 create mode 100644 .hark/changes/2022-09-06_yejia_add-abstract-methods.change.md
 create mode 100644 .hark/changes/2022-09-23_pakrym_api-updates.change.md
 create mode 100644 .hark/changes/2022-10-12_anniel_removed-orders-resource.change.md
 create mode 100644 .hark/changes/2022-10-15_richardm_hide-misleading-ssl.change.md
 create mode 100644 .hark/changes/2022-10-17_anniel_removed-sku-resource.change.md
 create mode 100644 .hark/changes/2022-10-24_anniel_do-run-coveralls.change.md
 create mode 100644 .hark/changes/2022-10-27_anniel_fixed-mistyped-names.change.md
 create mode 100644 .hark/changes/2022-11-02_kamil_api-updates.change.md
 create mode 100644 .hark/changes/2022-11-16_anniel_next-major-release.change.md
 create mode 100644 .hark/changes/2022-11-16_unknown_deprecate-save-method.change.md
 create mode 100644 .hark/changes/2022-11-16_unknown_dropped-support-python.change.md
 create mode 100644 .hark/changes/2023-01-30_richardm_pass-params-logger.change.md
 create mode 100644 .hark/changes/2023-02-02_richardm_api-updates.change.md
 create mode 100644 .hark/changes/2023-02-06_richardm_bugfix-revert-pass.change.md
 create mode 100644 .hark/changes/2023-02-16_anniel_api-updates.change.md
 create mode 100644 .hark/changes/2023-03-23_pakrym_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-03-30_anniel_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-08-14_richardm_pin-latest-api.change.md
 create mode 100644 .hark/changes/2023-08-16_richardm_1008-remove-support.change.md
 create mode 100644 .hark/changes/2023-08-16_richardm_assert-types-pagination.change.md
 create mode 100644 .hark/changes/2023-08-16_richardm_removed-testhelper-decorator.change.md
 create mode 100644 .hark/changes/2023-08-23_richardm_adds-type-annotations.change.md
 create mode 100644 .hark/changes/2023-08-24_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-08-31_richardm_types-crudl-methods.change.md
 create mode 100644 .hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-09-01_richardm_types-annotate-resource.change.md
 create mode 100644 .hark/changes/2023-09-05_anniel_require-typingextens-4.change.md
 create mode 100644 .hark/changes/2023-09-05_richardm_types-listobject.change.md
 create mode 100644 .hark/changes/2023-09-06_richardm_types-expandablefi.change.md
 create mode 100644 .hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-09-08_richardm_explicitly-define-crudl.change.md
 create mode 100644 .hark/changes/2023-09-12_richardm_types-datetimes-ints.change.md
 create mode 100644 .hark/changes/2023-09-14_richardm_generate-explicit-nested.change.md
 create mode 100644 .hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-09-21_richardm_add-optional-types.change.md
 create mode 100644 .hark/changes/2023-09-21_richardm_partially-type-resource.change.md
 create mode 100644 .hark/changes/2023-09-21_richardm_types-add-deleted.change.md
 create mode 100644 .hark/changes/2023-09-21_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-10-16_unknown_please-read-api.change.md
 create mode 100644 .hark/changes/2023-10-18_richardm_apirequestor-don-t.change.md
 create mode 100644 .hark/changes/2023-10-25_richardm_add-util-deprecated.change.md
 create mode 100644 .hark/changes/2023-10-26_richardm_inner-resource-classes.change.md
 create mode 100644 .hark/changes/2023-10-26_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-10-27_richardm_include-py-typed.change.md
 create mode 100644 .hark/changes/2023-10-31_richardm_types-add-types.change.md
 create mode 100644 .hark/changes/2023-10-31_richardm_types-use-staticmethod.change.md
 create mode 100644 .hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-11-06_anniel_types-remove-none.change.md
 create mode 100644 .hark/changes/2023-11-09_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-11-10_pakrym_add-support-python.change.md
 create mode 100644 .hark/changes/2023-11-10_pakrym_move-python3-venv.change.md
 create mode 100644 .hark/changes/2023-11-10_richardm_suppress-type-errors.change.md
 create mode 100644 .hark/changes/2023-11-15_pakrym_fix-unnecessary-casts.change.md
 create mode 100644 .hark/changes/2023-11-15_pakrym_run-pyright-via.change.md
 create mode 100644 .hark/changes/2023-11-15_pakrym_upgrade-black-dependency.change.md
 create mode 100644 .hark/changes/2023-11-16_pakrym_add-initial-tests.change.md
 create mode 100644 .hark/changes/2023-11-16_richardm_mention-types-readme.change.md
 create mode 100644 .hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-11-27_richardm_refactor-integration-test.change.md
 create mode 100644 .hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-12-05_pakrym_move-resource-type.change.md
 create mode 100644 .hark/changes/2023-12-07_pakrym_add-missing-explicit.change.md
 create mode 100644 .hark/changes/2023-12-07_pakrym_fix-getattr-raise.change.md
 create mode 100644 .hark/changes/2023-12-07_pakrym_move-exports-more.change.md
 create mode 100644 .hark/changes/2023-12-07_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-12-11_pakrym_do-raise-deprecationw.change.md
 create mode 100644 .hark/changes/2023-12-11_richardm_add-more-types.change.md
 create mode 100644 .hark/changes/2023-12-12_richardm_mark-defunct-internal.change.md
 create mode 100644 .hark/changes/2023-12-13_richardm_track-usage-deprecated.change.md
 create mode 100644 .hark/changes/2023-12-14_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-12-18_anniel_support-accessing-reserved.change.md
 create mode 100644 .hark/changes/2023-12-21_anniel_remove-apibase-requestoptio.change.md
 create mode 100644 .hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2023-12-22_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-01-18_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-01-25_anniel_stripe-python-v8.change.md
 create mode 100644 .hark/changes/2024-01-25_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-02-01_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-02-02_anniel_measure-stripeclient-usage.change.md
 create mode 100644 .hark/changes/2024-02-05_richardm_move-stripeclient-usage.change.md
 create mode 100644 .hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-02-13_richardm_improve-types-httpclient.change.md
 create mode 100644 .hark/changes/2024-02-15_anniel_remove-broken-child.change.md
 create mode 100644 .hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-02-16_richardm_testing-unify-http.change.md
 create mode 100644 .hark/changes/2024-02-20_richardm_remove-http-client.change.md
 create mode 100644 .hark/changes/2024-02-22_anniel_add-taxids-api.change.md
 create mode 100644 .hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-02-23_anniel_fix-type-errorobject.change.md
 create mode 100644 .hark/changes/2024-02-28_helenye_update-readme-use.change.md
 create mode 100644 .hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-03-07_richardm_update-readme-md.change.md
 create mode 100644 .hark/changes/2024-03-07_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-03-14_ramya_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-03-26_pakrym_update-readme-md.change.md
 create mode 100644 .hark/changes/2024-03-26_richardm_types-remove-unnecessary.change.md
 create mode 100644 .hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-03_richardm_port-async-support.change.md
 create mode 100644 .hark/changes/2024-04-04_richardm_bump-aiohttp-3.change.md
 create mode 100644 .hark/changes/2024-04-04_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-05_richardm_fix-readme-md.change.md
 create mode 100644 .hark/changes/2024-04-05_richardm_tweak-changelog-python.change.md
 create mode 100644 .hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-10_ramya_api-updates.change.md
 create mode 100644 .hark/changes/2024-04-11_ramya_use-stdlib-asyncmock.change.md
 create mode 100644 .hark/changes/2024-04-11_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-17_prathmesh_update-quote-pdf.change.md
 create mode 100644 .hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-22_helenye_bump-aiohttp-3.change.md
 create mode 100644 .hark/changes/2024-04-25_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-04-26_anniel_fix-type-change.change.md
 create mode 100644 .hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-05-13_xavdid_switch-black-ruff.change.md
 create mode 100644 .hark/changes/2024-05-16_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-05-23_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-05-24_ramya_add-method-list.change.md
 create mode 100644 .hark/changes/2024-05-30_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-06-06_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-06-13_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-06-17_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-06-24_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-06-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-07-11_prathmesh_update-changelog.change.md
 create mode 100644 .hark/changes/2024-07-11_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-07-18_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md
 create mode 100644 .hark/changes/2024-08-01_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-08-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-08-29_ramya_generate-sdk-openapi.change.md
 create mode 100644 .hark/changes/2024-09-05_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-09-18_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md
 create mode 100644 .hark/changes/2024-10-01_ramya_support-apis-new.change.md
 create mode 100644 .hark/changes/2024-10-03_ramya_update-class-thinevent.change.md
 create mode 100644 .hark/changes/2024-10-03_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-10-09_jar_clean-up-examples.change.md
 create mode 100644 .hark/changes/2024-10-18_helenye_deserialize-correct-v2.change.md
 create mode 100644 .hark/changes/2024-10-18_xavdid_update-object-tags.change.md
 create mode 100644 .hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-12-12_xavdid_fix-deprecation-warning.change.md
 create mode 100644 .hark/changes/2024-12-16_jar_fix-stripeerror-httpbody.change.md
 create mode 100644 .hark/changes/2024-12-17_xavdid_fix-using-autopagingit.change.md
 create mode 100644 .hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2024-12-19_jar_fix-regression-using.change.md
 create mode 100644 .hark/changes/2025-01-13_jar_fix-v2-listobject.change.md
 create mode 100644 .hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md
 create mode 100644 .hark/changes/2025-01-14_xavdid_add-justfile-update.change.md
 create mode 100644 .hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md
 create mode 100644 .hark/changes/2025-01-16_xavdid_minor-justfile-fixes.change.md
 create mode 100644 .hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md
 create mode 100644 .hark/changes/2025-01-17_jar_added-contributing-md.change.md
 create mode 100644 .hark/changes/2025-01-17_jar_added-contributing-md_2.change.md
 create mode 100644 .hark/changes/2025-01-21_xavdid_add-just-publish.change.md
 create mode 100644 .hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md
 create mode 100644 .hark/changes/2025-01-25_prathmesh_updated-upload-artifact.change.md
 create mode 100644 .hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md
 create mode 100644 .hark/changes/2025-01-27_helenye_revert-bump-version.change.md
 create mode 100644 .hark/changes/2025-01-27_helenye_upgrade-download-artifact.change.md
 create mode 100644 .hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md
 create mode 100644 .hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md
 create mode 100644 .hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md
 create mode 100644 .hark/changes/2025-02-13_xavdid_upgrade-ruff-version.change.md
 create mode 100644 .hark/changes/2025-02-18_helenye_remove-incorrect-changelog.change.md
 create mode 100644 .hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-03-19_ramya_fix-incorrect-property.change.md
 create mode 100644 .hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md
 create mode 100644 .hark/changes/2025-03-31_xavdid_rename-stripestream-s.change.md
 create mode 100644 .hark/changes/2025-04-09_ramya_update-readme-clarificatio.change.md
 create mode 100644 .hark/changes/2025-04-15_xavdid_fix-type-hint.change.md
 create mode 100644 .hark/changes/2025-04-18_mbroshi_encode-bools-lower.change.md
 create mode 100644 .hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-05-02_jar_adds-contributing-md.change.md
 create mode 100644 .hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-06-30_ramya_fix-link-releases.change.md
 create mode 100644 .hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-07-11_helenye_fix-timeout-type.change.md
 create mode 100644 .hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-08-21_prathmesh_introduce-v1-namespaces.change.md
 create mode 100644 .hark/changes/2025-08-27_ramya_add-section-private.change.md
 create mode 100644 .hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-08-27_xavdid_import-available-http.change.md
 create mode 100644 .hark/changes/2025-09-04_mbroshi_fix-paginate-backwards.change.md
 create mode 100644 .hark/changes/2025-09-09_xavdid_build-sdk-w.change.md
 create mode 100644 .hark/changes/2025-09-18_xavdid_don-t-use.change.md
 create mode 100644 .hark/changes/2025-09-22_prathmesh_renamed-urllib2clien-urllibclient.change.md
 create mode 100644 .hark/changes/2025-09-23_stripe-openapi_1593-1607-1605.change.md
 create mode 100644 .hark/changes/2025-09-24_xavdid_migrate-setup-py.change.md
 create mode 100644 .hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md
 create mode 100644 .hark/changes/2025-09-25_xavdid_add-strongly-typed.change.md
 create mode 100644 .hark/changes/2025-09-29_prathmesh_fixed-invoicelinei-method.change.md
 create mode 100644 .hark/changes/2025-09-29_xavdid_move-v2-event.change.md
 create mode 100644 .hark/changes/2025-09-29_xavdid_remove-deprecated-compatibilit.change.md
 create mode 100644 .hark/changes/2025-09-30_unknown_deprecated-v1-service.change.md
 create mode 100644 .hark/changes/2025-09-30_xavdid_drop-support-python.change.md
 create mode 100644 .hark/changes/2025-09-30_xavdid_unify-resource-service.change.md
 create mode 100644 .hark/changes/2025-10-02_helenye_make-new-nested.change.md
 create mode 100644 .hark/changes/2025-10-02_xavdid_re-add-tests.change.md
 create mode 100644 .hark/changes/2025-10-03_xavdid_add-new-async.change.md
 create mode 100644 .hark/changes/2025-10-03_xavdid_remove-gpg-step.change.md
 create mode 100644 .hark/changes/2025-10-17_xavdid_dramatically-improve-performance.change.md
 create mode 100644 .hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-10-31_xavdid_fix-stripe-context.change.md
 create mode 100644 .hark/changes/2025-11-04_stripe-openapi_add-support-value.change.md
 create mode 100644 .hark/changes/2025-11-05_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-11-17_mbroshi_update-v2-array.change.md
 create mode 100644 .hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-11-21_xavdid_throw-specific-error.change.md
 create mode 100644 .hark/changes/2025-11-22_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-11-24_ramya_add-createasync-method.change.md
 create mode 100644 .hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md
 create mode 100644 .hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2025-12-17_mbroshi_update-ci-run.change.md
 create mode 100644 .hark/changes/2025-12-23_ramya_fix-deprecationw-encoding.change.md
 create mode 100644 .hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-01-19_ramya_add-documentatio-undocumented.change.md
 create mode 100644 .hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-02-05_prathmesh_added-instruction-update.change.md
 create mode 100644 .hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-02-24_skukutla_allow-aiohttpclien-accept.change.md
 create mode 100644 .hark/changes/2026-02-28_xavdid_add-agent-information.change.md
 create mode 100644 .hark/changes/2026-03-05_xavdid_add-stripe-request.change.md
 create mode 100644 .hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md
 create mode 100644 .hark/changes/2026-03-18_xavdid_drop-support-python.change.md
 create mode 100644 .hark/changes/2026-03-18_xavdid_stripeobject-longer-inherits.change.md
 create mode 100644 .hark/changes/2026-03-24_xavdid_throw-error-using.change.md
 create mode 100644 .hark/changes/2026-03-25_jar_add-decimalstrin-coercion.change.md
 create mode 100644 .hark/changes/2026-03-25_unknown_generated-changes-1749.change.md
 create mode 100644 .hark/changes/2026-03-31_xavdid_fix-str-repr.change.md
 create mode 100644 .hark/changes/2026-04-01_jar_fix-encoding-two.change.md
 create mode 100644 .hark/changes/2026-04-01_xavdid_improve-types-metadata.change.md
 create mode 100644 .hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-05-22_xavdid_emit-warning-stripe.change.md
 create mode 100644 .hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-06-05_xavdid_add-source-field.change.md
 create mode 100644 .hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-07-01_jar_reduce-stripeclient-cold.change.md
 create mode 100644 .hark/changes/2026-07-09_xavdid_remove-unused-retry.change.md
 create mode 100644 .hark/changes/2026-07-10_xavdid_make-error-fields.change.md
 create mode 100644 .hark/changes/2026-07-16_xavdid_replace-source-hash.change.md
 create mode 100644 .hark/changes/2026-07-16_xavdid_use-ip-address.change.md
 create mode 100644 .hark/changes/2026-07-24_jar_fix-intermittent-windows.change.md
 create mode 100644 .hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-08-03_xavdid_add-stripe-majorapivers.change.md
 create mode 100644 .hark/changes/2026-08-06_xavdid_add-adjust-event.change.md
 create mode 100644 .hark/changes/2026-08-07_johno_emit-claude-code.change.md
 create mode 100644 .hark/changes/2026-08-07_xavdid_surface-object-property.change.md
 create mode 100644 .hark/changes/2026-08-10_jar_add-async-iteration.change.md
 create mode 100644 .hark/changes/2026-08-18_xavdid_better-document-stripeobject.change.md
 create mode 100644 .hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md
 create mode 100644 .hark/changes/2026-08-26_stripe-openapi_update-generated-code.change.md
 create mode 100644 .hark/changes/2026-08-28_jar_dispatch-discriminate-union.change.md
 create mode 100644 .hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md
 create mode 100644 .hark/changes/2026-08-31_xavdid_use-cryptographi-secure.change.md
 create mode 100644 .hark/intros/intro-13.0.0.md
 create mode 100644 .hark/intros/intro-15.0.0.md
 create mode 100644 .hark/intros/intro-2.0.0.md
 create mode 100644 .hark/intros/intro-2.29.3.md
 create mode 100644 .hark/intros/intro-4.0.0.md
 create mode 100644 .hark/intros/intro-5.0.0.md
 create mode 100644 .hark/intros/intro-6.0.0.md
 create mode 100644 .hark/releases.json

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 4e1cbb2de..c7d166a31 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -10,14 +10,6 @@ List out the key changes made in this PR, e.g.
 ### See Also
 <!-- Include any links or additional information that help explain this change. -->
 
-## Changelog
-<!-- Heads up! This section should include entries for any user-facing changes.
-Either fill it out or remove it if there are no entries to report.
+## Configuration
 
-List changes that affect end users, e.g.
-- Fixes crash when calling `foo.bar()` with null argument
-- Adds support for new `baz` parameter on `PaymentIntent` creation
-
-List breaking changes first with a ⚠️ prefix, e.g.
-- ⚠️ Removes deprecated `legacy_method` function
--->
+- [ ] `skip-changefile`: This PR is not a user-facing change, so there's no changefile.
diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
new file mode 100644
index 000000000..aed122580
--- /dev/null
+++ b/.github/workflows/changelog.yml
@@ -0,0 +1,21 @@
+name: Changelog
+
+on:
+  pull_request:
+    # opened, synchronize and reopened are the defaults; `edited` is what makes this
+    # re-run when someone toggles an opt-out box in the description
+    types: [opened, synchronize, reopened, edited]
+
+permissions: {}
+
+jobs:
+  changefile:
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read # check out the repo so `hark validate` can read .hark/
+      pull-requests: read # list the files this pull request adds
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: stripe/hark/actions/checks@master
diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index 25cd8201c..c0f321f1a 100644
--- a/.github/zizmor.yml
+++ b/.github/zizmor.yml
@@ -6,3 +6,4 @@ rules:
     config:
       policies:
         "stripe/openapi/*": ref-pin
+        "stripe/hark/*": ref-pin
diff --git a/.hark/changes/2012-02-04_unknown_parameters-value-none.change.md b/.hark/changes/2012-02-04_unknown_parameters-value-none.change.md
new file mode 100644
index 000000000..5eb2ca2ab
--- /dev/null
+++ b/.hark/changes/2012-02-04_unknown_parameters-value-none.change.md
@@ -0,0 +1,4 @@
+---
+title: Parameters with value None are no longer included in API requests
+released_in_version: 1.6.1
+---
diff --git a/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md b/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md
new file mode 100644
index 000000000..429068781
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new delete_discount method to stripe.Customer
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_add-new-stripe.change.md b/.hark/changes/2012-05-17_unknown_add-new-stripe.change.md
new file mode 100644
index 000000000..fd78a9792
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_add-new-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new stripe.Transfer resource
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md b/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md
new file mode 100644
index 000000000..be381bb67
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md
@@ -0,0 +1,4 @@
+---
+title: Numerous test suite improvements
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_switch-using-http.change.md b/.hark/changes/2012-05-17_unknown_switch-using-http.change.md
new file mode 100644
index 000000000..ee2a5b724
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_switch-using-http.change.md
@@ -0,0 +1,4 @@
+---
+title: "Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)"
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-21_unknown_prefer-app-engine.change.md b/.hark/changes/2012-05-21_unknown_prefer-app-engine.change.md
new file mode 100644
index 000000000..59faf2977
--- /dev/null
+++ b/.hark/changes/2012-05-21_unknown_prefer-app-engine.change.md
@@ -0,0 +1,4 @@
+---
+title: Prefer App Engine's urlfetch over requests, as that's the only thing that will work in App Engine's environment. Previously, if requests was available in the App Engine environment, we would attempt to use it.
+released_in_version: 1.7.1
+---
diff --git a/.hark/changes/2012-05-31_unknown_fix-bug-would.change.md b/.hark/changes/2012-05-31_unknown_fix-bug-would.change.md
new file mode 100644
index 000000000..51617954a
--- /dev/null
+++ b/.hark/changes/2012-05-31_unknown_fix-bug-would.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix a bug that would cause nested objects to be mis-rendered in __str__ and __repr__ methods (github issues #17, #18)"
+released_in_version: 1.7.2
+---
diff --git a/.hark/changes/2012-08-17_unknown_add-new-stripe.change.md b/.hark/changes/2012-08-17_unknown_add-new-stripe.change.md
new file mode 100644
index 000000000..b1a5e744a
--- /dev/null
+++ b/.hark/changes/2012-08-17_unknown_add-new-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new stripe.Account resource
+released_in_version: 1.7.3
+---
diff --git a/.hark/changes/2012-08-17_unknown_remove-uncapturedch-tests.change.md b/.hark/changes/2012-08-17_unknown_remove-uncapturedch-tests.change.md
new file mode 100644
index 000000000..1ca46ec80
--- /dev/null
+++ b/.hark/changes/2012-08-17_unknown_remove-uncapturedch-tests.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove uncaptured_charge tests (this has been deprecated from the API).
+released_in_version: 1.7.3
+---
diff --git a/.hark/changes/2012-08-31_unknown_add-update-pay.change.md b/.hark/changes/2012-08-31_unknown_add-update-pay.change.md
new file mode 100644
index 000000000..f98cf4f88
--- /dev/null
+++ b/.hark/changes/2012-08-31_unknown_add-update-pay.change.md
@@ -0,0 +1,4 @@
+---
+title: Add update and pay methods for Invoice resource
+released_in_version: 1.7.4
+---
diff --git a/.hark/changes/2012-10-30_unknown_add-support-creating.change.md b/.hark/changes/2012-10-30_unknown_add-support-creating.change.md
new file mode 100644
index 000000000..2da28f61c
--- /dev/null
+++ b/.hark/changes/2012-10-30_unknown_add-support-creating.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for creating invoices
+released_in_version: 1.7.5
+---
diff --git a/.hark/changes/2012-10-30_unknown_add-support-new.change.md b/.hark/changes/2012-10-30_unknown_add-support-new.change.md
new file mode 100644
index 000000000..f7e3d3fc2
--- /dev/null
+++ b/.hark/changes/2012-10-30_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new invoice lines return format
+released_in_version: 1.7.5
+---
diff --git a/.hark/changes/2012-10-30_unknown_add-support-new_2.change.md b/.hark/changes/2012-10-30_unknown_add-support-new_2.change.md
new file mode 100644
index 000000000..a5de529e9
--- /dev/null
+++ b/.hark/changes/2012-10-30_unknown_add-support-new_2.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new List objects
+released_in_version: 1.7.5
+---
diff --git a/.hark/changes/2012-11-08_unknown_add-support-updating.change.md b/.hark/changes/2012-11-08_unknown_add-support-updating.change.md
new file mode 100644
index 000000000..10af7a3f6
--- /dev/null
+++ b/.hark/changes/2012-11-08_unknown_add-support-updating.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for updating charge disputes
+released_in_version: 1.7.6
+---
diff --git a/.hark/changes/2012-12-18_unknown_update-requests-version.change.md b/.hark/changes/2012-12-18_unknown_update-requests-version.change.md
new file mode 100644
index 000000000..faec7c30f
--- /dev/null
+++ b/.hark/changes/2012-12-18_unknown_update-requests-version.change.md
@@ -0,0 +1,4 @@
+---
+title: "Update requests version check to work with requests 1.x.x (github issue #24)"
+released_in_version: 1.7.7
+---
diff --git a/.hark/changes/2013-01-15_unknown_add-support-setting.change.md b/.hark/changes/2013-01-15_unknown_add-support-setting.change.md
new file mode 100644
index 000000000..99c1c0ebe
--- /dev/null
+++ b/.hark/changes/2013-01-15_unknown_add-support-setting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for setting a Stripe API version override
+released_in_version: 1.7.8
+---
diff --git a/.hark/changes/2013-02-04_unknown_add-support-passing.change.md b/.hark/changes/2013-02-04_unknown_add-support-passing.change.md
new file mode 100644
index 000000000..cb0e75537
--- /dev/null
+++ b/.hark/changes/2013-02-04_unknown_add-support-passing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for passing options when retrieving Stripe objects; e.g., stripe.Charge.retrieve("foo", params={"expand":["customer"]})
+released_in_version: 1.7.9
+---
diff --git a/.hark/changes/2013-02-21_unknown_add-id-list.change.md b/.hark/changes/2013-02-21_unknown_add-id-list.change.md
new file mode 100644
index 000000000..c39588d58
--- /dev/null
+++ b/.hark/changes/2013-02-21_unknown_add-id-list.change.md
@@ -0,0 +1,4 @@
+---
+title: Add 'id' to the list of permanent attributes
+released_in_version: 1.7.10
+---
diff --git a/.hark/changes/2013-04-11_unknown_add-new-stripe.change.md b/.hark/changes/2013-04-11_unknown_add-new-stripe.change.md
new file mode 100644
index 000000000..1ac1e11a6
--- /dev/null
+++ b/.hark/changes/2013-04-11_unknown_add-new-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new stripe.Recipient resource
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2013-04-11_unknown_allow-transfers-creatable.change.md b/.hark/changes/2013-04-11_unknown_allow-transfers-creatable.change.md
new file mode 100644
index 000000000..1fbc8796d
--- /dev/null
+++ b/.hark/changes/2013-04-11_unknown_allow-transfers-creatable.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow transfers to be creatable
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2013-04-25_unknown_support-python-3.change.md b/.hark/changes/2013-04-25_unknown_support-python-3.change.md
new file mode 100644
index 000000000..b478a4670
--- /dev/null
+++ b/.hark/changes/2013-04-25_unknown_support-python-3.change.md
@@ -0,0 +1,4 @@
+---
+title: "Support for Python 3 (github issue #32)"
+released_in_version: 1.9.0
+---
diff --git a/.hark/changes/2013-05-03_unknown_remove-id-list.change.md b/.hark/changes/2013-05-03_unknown_remove-id-list.change.md
new file mode 100644
index 000000000..bf65c7535
--- /dev/null
+++ b/.hark/changes/2013-05-03_unknown_remove-id-list.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove 'id' from the list of permanent attributes
+released_in_version: 1.9.1
+---
diff --git a/.hark/changes/2013-07-12_unknown_add-support-multiple.change.md b/.hark/changes/2013-07-12_unknown_add-support-multiple.change.md
new file mode 100644
index 000000000..8190af8db
--- /dev/null
+++ b/.hark/changes/2013-07-12_unknown_add-support-multiple.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for multiple cards API
+released_in_version: 1.9.2
+---
diff --git a/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md b/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md
new file mode 100644
index 000000000..215fb3879
--- /dev/null
+++ b/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md
@@ -0,0 +1,6 @@
+---
+title: Add support for unsetting attributes by setting to None.
+released_in_version: 1.9.3
+---
+
+Setting properties to a blank string is now an error.
diff --git a/.hark/changes/2013-08-20_unknown_add-stripe-balance.change.md b/.hark/changes/2013-08-20_unknown_add-stripe-balance.change.md
new file mode 100644
index 000000000..6bab829a5
--- /dev/null
+++ b/.hark/changes/2013-08-20_unknown_add-stripe-balance.change.md
@@ -0,0 +1,4 @@
+---
+title: Add stripe.Balance and stripe.BalanceTransaction resources
+released_in_version: 1.9.4
+---
diff --git a/.hark/changes/2013-09-18_unknown_add-support-closing.change.md b/.hark/changes/2013-09-18_unknown_add-support-closing.change.md
new file mode 100644
index 000000000..c60457264
--- /dev/null
+++ b/.hark/changes/2013-09-18_unknown_add-support-closing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for closing disputes.
+released_in_version: 1.9.5
+---
diff --git a/.hark/changes/2013-10-08_unknown_fix-issue-support.change.md b/.hark/changes/2013-10-08_unknown_fix-issue-support.change.md
new file mode 100644
index 000000000..13afab8e4
--- /dev/null
+++ b/.hark/changes/2013-10-08_unknown_fix-issue-support.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix issue with support for closing disputes.
+released_in_version: 1.9.6
+---
diff --git a/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md b/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md
new file mode 100644
index 000000000..54893756e
--- /dev/null
+++ b/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for metadata.
+released_in_version: 1.9.7
+---
diff --git a/.hark/changes/2013-10-17_unknown_removed-incorrect-test.change.md b/.hark/changes/2013-10-17_unknown_removed-incorrect-test.change.md
new file mode 100644
index 000000000..514c94dcf
--- /dev/null
+++ b/.hark/changes/2013-10-17_unknown_removed-incorrect-test.change.md
@@ -0,0 +1,4 @@
+---
+title: Removed incorrect test.
+released_in_version: 1.9.8
+---
diff --git a/.hark/changes/2013-12-04_unknown_add-stripe-applicationf.change.md b/.hark/changes/2013-12-04_unknown_add-stripe-applicationf.change.md
new file mode 100644
index 000000000..84913590a
--- /dev/null
+++ b/.hark/changes/2013-12-04_unknown_add-stripe-applicationf.change.md
@@ -0,0 +1,4 @@
+---
+title: Add stripe.ApplicationFee resource
+released_in_version: 1.10.8
+---
diff --git a/.hark/changes/2013-12-05_unknown_abstracted-http-library.change.md b/.hark/changes/2013-12-05_unknown_abstracted-http-library.change.md
new file mode 100644
index 000000000..c32d42ead
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_abstracted-http-library.change.md
@@ -0,0 +1,4 @@
+---
+title: Abstracted http library selection and use from the `APIRequestor` into `stripe.http_client`
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_added-extensive-unit.change.md b/.hark/changes/2013-12-05_unknown_added-extensive-unit.change.md
new file mode 100644
index 000000000..3f1d47d5e
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_added-extensive-unit.change.md
@@ -0,0 +1,4 @@
+---
+title: Added extensive unit tests
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_extended-functional-test.change.md b/.hark/changes/2013-12-05_unknown_extended-functional-test.change.md
new file mode 100644
index 000000000..f6d838c1a
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_extended-functional-test.change.md
@@ -0,0 +1,4 @@
+---
+title: Extended functional test coverage
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_pep8ified-codebase-enforced.change.md b/.hark/changes/2013-12-05_unknown_pep8ified-codebase-enforced.change.md
new file mode 100644
index 000000000..dcf324add
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_pep8ified-codebase-enforced.change.md
@@ -0,0 +1,4 @@
+---
+title: PEP8ified the codebase and enforced with a test.
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_previousmeta-attribute-resources.change.md b/.hark/changes/2013-12-05_unknown_previousmeta-attribute-resources.change.md
new file mode 100644
index 000000000..13c27c575
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_previousmeta-attribute-resources.change.md
@@ -0,0 +1,5 @@
+---
+title: The `previous_metadata` attribute on resources is now protected.
+section: Backwards incompatible changes
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_proper-encoding-timezone.change.md b/.hark/changes/2013-12-05_unknown_proper-encoding-timezone.change.md
new file mode 100644
index 000000000..59d728dee
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_proper-encoding-timezone.change.md
@@ -0,0 +1,4 @@
+---
+title: Proper encoding of timezone aware datetimes
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_refactored-code-modules.change.md b/.hark/changes/2013-12-05_unknown_refactored-code-modules.change.md
new file mode 100644
index 000000000..f04fd555e
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_refactored-code-modules.change.md
@@ -0,0 +1,4 @@
+---
+title: Refactored code into modules and out of stripe/__init__.py
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_refactored-stripeobject-inherit.change.md b/.hark/changes/2013-12-05_unknown_refactored-stripeobject-inherit.change.md
new file mode 100644
index 000000000..b9d8a5748
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_refactored-stripeobject-inherit.change.md
@@ -0,0 +1,4 @@
+---
+title: Refactored `StripeObject` to inherit from `dict` and avoid direct access of `__dict__`.
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_timezone-aware-datetime.change.md b/.hark/changes/2013-12-05_unknown_timezone-aware-datetime.change.md
new file mode 100644
index 000000000..9d565b1a8
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_timezone-aware-datetime.change.md
@@ -0,0 +1,5 @@
+---
+title: Timezone aware `datetime` objects passed to the API will now be encoded in a way that does not depend on the local system time.  If you are passing timezone-aware datetimes to our API and your server time is not already in UTC, this will change the value passed to our API.
+section: Backwards incompatible changes
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2013-12-05_unknown_todict-values-methods.change.md b/.hark/changes/2013-12-05_unknown_todict-values-methods.change.md
new file mode 100644
index 000000000..7465eb3cc
--- /dev/null
+++ b/.hark/changes/2013-12-05_unknown_todict-values-methods.change.md
@@ -0,0 +1,6 @@
+---
+title: The `to_dict` and `values` methods on resources no longer recursively convert objects to plain `dict`s.  All resources now inherit from `dict` but are functionally different in that you cannot set a value to an empty string and cannot delete items.
+semver_level: major
+section: Backwards incompatible changes
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2014-01-29_unknown_added-support-multiple.change.md b/.hark/changes/2014-01-29_unknown_added-support-multiple.change.md
new file mode 100644
index 000000000..f383e6523
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_added-support-multiple.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for multiple subscriptions per customer
+released_in_version: 1.12.0
+---
diff --git a/.hark/changes/2014-03-13_unknown_added-license-other.change.md b/.hark/changes/2014-03-13_unknown_added-license-other.change.md
new file mode 100644
index 000000000..454668bba
--- /dev/null
+++ b/.hark/changes/2014-03-13_unknown_added-license-other.change.md
@@ -0,0 +1,4 @@
+---
+title: Added license and other metadata in setup.py
+released_in_version: 1.12.1
+---
diff --git a/.hark/changes/2014-03-13_unknown_fix-repr-python.change.md b/.hark/changes/2014-03-13_unknown_fix-repr-python.change.md
new file mode 100644
index 000000000..490c094e2
--- /dev/null
+++ b/.hark/changes/2014-03-13_unknown_fix-repr-python.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix `__repr__` in Python 3
+released_in_version: 1.12.1
+---
diff --git a/.hark/changes/2014-03-13_unknown_fix-syntax-errors.change.md b/.hark/changes/2014-03-13_unknown_fix-syntax-errors.change.md
new file mode 100644
index 000000000..f5fababd8
--- /dev/null
+++ b/.hark/changes/2014-03-13_unknown_fix-syntax-errors.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix syntax errors in setup.py metadata
+released_in_version: 1.12.2
+---
diff --git a/.hark/changes/2014-03-13_unknown_support-pickling-responses.change.md b/.hark/changes/2014-03-13_unknown_support-pickling-responses.change.md
new file mode 100644
index 000000000..60780429a
--- /dev/null
+++ b/.hark/changes/2014-03-13_unknown_support-pickling-responses.change.md
@@ -0,0 +1,4 @@
+---
+title: Support pickling of responses
+released_in_version: 1.12.1
+---
diff --git a/.hark/changes/2014-04-09_unknown_add-certificate-blacklist.change.md b/.hark/changes/2014-04-09_unknown_add-certificate-blacklist.change.md
new file mode 100644
index 000000000..501b9dab4
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_add-certificate-blacklist.change.md
@@ -0,0 +1,4 @@
+---
+title: Add certificate blacklist for CVE-2014-0160 mitigation
+released_in_version: 1.13.0
+---
diff --git a/.hark/changes/2014-04-09_unknown_don-t-rely.change.md b/.hark/changes/2014-04-09_unknown_don-t-rely.change.md
new file mode 100644
index 000000000..9f61ba21a
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_don-t-rely.change.md
@@ -0,0 +1,4 @@
+---
+title: Don't rely on SNI support in integration tests
+released_in_version: 1.14.0
+---
diff --git a/.hark/changes/2014-04-09_unknown_update-bundled-ca.change.md b/.hark/changes/2014-04-09_unknown_update-bundled-ca.change.md
new file mode 100644
index 000000000..5169b9859
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_update-bundled-ca.change.md
@@ -0,0 +1,4 @@
+---
+title: Update bundled ca-certificates
+released_in_version: 1.13.0
+---
diff --git a/.hark/changes/2014-04-09_unknown_use-der-encoded.change.md b/.hark/changes/2014-04-09_unknown_use-der-encoded.change.md
new file mode 100644
index 000000000..ae5fd4244
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_use-der-encoded.change.md
@@ -0,0 +1,4 @@
+---
+title: Use DER encoded certificate for checksumming
+released_in_version: 1.14.0
+---
diff --git a/.hark/changes/2014-05-19_unknown_disable-loading-ssl.change.md b/.hark/changes/2014-05-19_unknown_disable-loading-ssl.change.md
new file mode 100644
index 000000000..ba18f7b71
--- /dev/null
+++ b/.hark/changes/2014-05-19_unknown_disable-loading-ssl.change.md
@@ -0,0 +1,4 @@
+---
+title: Disable loading the ssl module on the Google App Engine dev server.
+released_in_version: 1.14.1
+---
diff --git a/.hark/changes/2014-05-22_unknown_support-cards-recipients.change.md b/.hark/changes/2014-05-22_unknown_support-cards-recipients.change.md
new file mode 100644
index 000000000..a13e59c77
--- /dev/null
+++ b/.hark/changes/2014-05-22_unknown_support-cards-recipients.change.md
@@ -0,0 +1,4 @@
+---
+title: Support cards for recipients.
+released_in_version: 1.15.1
+---
diff --git a/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md b/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md
new file mode 100644
index 000000000..8205d3e10
--- /dev/null
+++ b/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for canceling transfers
+released_in_version: 1.16.0
+---
diff --git a/.hark/changes/2014-06-10_unknown_remove-official-support.change.md b/.hark/changes/2014-06-10_unknown_remove-official-support.change.md
new file mode 100644
index 000000000..13759adc1
--- /dev/null
+++ b/.hark/changes/2014-06-10_unknown_remove-official-support.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove official support for Python 2.5
+released_in_version: 1.17.0
+---
diff --git a/.hark/changes/2014-06-17_unknown_add-metadata-disputes.change.md b/.hark/changes/2014-06-17_unknown_add-metadata-disputes.change.md
new file mode 100644
index 000000000..f6dae2d5a
--- /dev/null
+++ b/.hark/changes/2014-06-17_unknown_add-metadata-disputes.change.md
@@ -0,0 +1,4 @@
+---
+title: Add metadata for disputes and refunds
+released_in_version: 1.18.0
+---
diff --git a/.hark/changes/2014-07-29_unknown_application-fee-refunds.change.md b/.hark/changes/2014-07-29_unknown_application-fee-refunds.change.md
new file mode 100644
index 000000000..e84281e56
--- /dev/null
+++ b/.hark/changes/2014-07-29_unknown_application-fee-refunds.change.md
@@ -0,0 +1,4 @@
+---
+title: Application Fee refunds now a list instead of array
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2014-10-23_unknown_remove-redundant-manual.change.md b/.hark/changes/2014-10-23_unknown_remove-redundant-manual.change.md
new file mode 100644
index 000000000..26440654a
--- /dev/null
+++ b/.hark/changes/2014-10-23_unknown_remove-redundant-manual.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove redundant manual SSL blacklist preflight check
+released_in_version: 1.19.1
+---
diff --git a/.hark/changes/2014-12-23_unknown_adding-support-file.change.md b/.hark/changes/2014-12-23_unknown_adding-support-file.change.md
new file mode 100644
index 000000000..87fbb1164
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_adding-support-file.change.md
@@ -0,0 +1,4 @@
+---
+title: Adding support for file uploads resource
+released_in_version: 1.20.0
+---
diff --git a/.hark/changes/2015-01-07_unknown_adding-bitcoin-receiver.change.md b/.hark/changes/2015-01-07_unknown_adding-bitcoin-receiver.change.md
new file mode 100644
index 000000000..e8e4676eb
--- /dev/null
+++ b/.hark/changes/2015-01-07_unknown_adding-bitcoin-receiver.change.md
@@ -0,0 +1,4 @@
+---
+title: Adding bitcoin receiver and transaction objects
+released_in_version: 1.20.1
+---
diff --git a/.hark/changes/2015-01-21_unknown_remove-support-top.change.md b/.hark/changes/2015-01-21_unknown_remove-support-top.change.md
new file mode 100644
index 000000000..cc6c4f76a
--- /dev/null
+++ b/.hark/changes/2015-01-21_unknown_remove-support-top.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove support for top-level bitcoin transactions
+released_in_version: 1.20.2
+---
diff --git a/.hark/changes/2015-02-19_unknown_added-bitcoin-receiver.change.md b/.hark/changes/2015-02-19_unknown_added-bitcoin-receiver.change.md
new file mode 100644
index 000000000..d61601967
--- /dev/null
+++ b/.hark/changes/2015-02-19_unknown_added-bitcoin-receiver.change.md
@@ -0,0 +1,4 @@
+---
+title: Added Bitcoin Receiver update and delete methods
+released_in_version: 1.21.0
+---
diff --git a/.hark/changes/2015-03-22_unknown_added-methods-updating.change.md b/.hark/changes/2015-03-22_unknown_added-methods-updating.change.md
new file mode 100644
index 000000000..da75f7692
--- /dev/null
+++ b/.hark/changes/2015-03-22_unknown_added-methods-updating.change.md
@@ -0,0 +1,4 @@
+---
+title: Added methods for updating and saving arrays of objects
+released_in_version: 1.22.0
+---
diff --git a/.hark/changes/2015-03-30_unknown_pass-stripeaccoun-balance.change.md b/.hark/changes/2015-03-30_unknown_pass-stripeaccoun-balance.change.md
new file mode 100644
index 000000000..139b1a7c2
--- /dev/null
+++ b/.hark/changes/2015-03-30_unknown_pass-stripeaccoun-balance.change.md
@@ -0,0 +1,4 @@
+---
+title: Pass `stripe_account` to Balance.retrieve
+released_in_version: 1.22.1
+---
diff --git a/.hark/changes/2015-04-08_unknown_fix-saving-manage.change.md b/.hark/changes/2015-04-08_unknown_fix-saving-manage.change.md
new file mode 100644
index 000000000..baca114b6
--- /dev/null
+++ b/.hark/changes/2015-04-08_unknown_fix-saving-manage.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix saving manage accounts
+released_in_version: 1.22.2
+---
diff --git a/.hark/changes/2015-06-04_unknown_fix-saving-additionalow.change.md b/.hark/changes/2015-06-04_unknown_fix-saving-additionalow.change.md
new file mode 100644
index 000000000..7e5ba4920
--- /dev/null
+++ b/.hark/changes/2015-06-04_unknown_fix-saving-additionalow.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix saving `additional_owners` on managed accounts
+released_in_version: 1.22.3
+---
diff --git a/.hark/changes/2015-07-06_unknown_include-response-headers.change.md b/.hark/changes/2015-07-06_unknown_include-response-headers.change.md
new file mode 100644
index 000000000..c2d77707e
--- /dev/null
+++ b/.hark/changes/2015-07-06_unknown_include-response-headers.change.md
@@ -0,0 +1,4 @@
+---
+title: Include response headers in exceptions
+released_in_version: 1.23.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_added-dispute-listing.change.md b/.hark/changes/2015-08-03_unknown_added-dispute-listing.change.md
new file mode 100644
index 000000000..0d0458031
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_added-dispute-listing.change.md
@@ -0,0 +1,4 @@
+---
+title: Added dispute listing and retrieval
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_managed-accounts-can.change.md b/.hark/changes/2015-08-03_unknown_managed-accounts-can.change.md
new file mode 100644
index 000000000..633690b94
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_managed-accounts-can.change.md
@@ -0,0 +1,4 @@
+---
+title: Managed accounts can now be deleted
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-08-05_unknown_fix-error-handling.change.md b/.hark/changes/2015-08-05_unknown_fix-error-handling.change.md
new file mode 100644
index 000000000..5b5731665
--- /dev/null
+++ b/.hark/changes/2015-08-05_unknown_fix-error-handling.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix error handling for Python 2.6
+released_in_version: 1.24.1
+---
diff --git a/.hark/changes/2015-08-17_unknown_added-refund-listing.change.md b/.hark/changes/2015-08-17_unknown_added-refund-listing.change.md
new file mode 100644
index 000000000..58f662cbe
--- /dev/null
+++ b/.hark/changes/2015-08-17_unknown_added-refund-listing.change.md
@@ -0,0 +1,4 @@
+---
+title: Added refund listing, creation and retrieval
+released_in_version: 1.25.0
+---
diff --git a/.hark/changes/2015-09-11_unknown_add-support-new.change.md b/.hark/changes/2015-09-11_unknown_add-support-new.change.md
new file mode 100644
index 000000000..70b0dd966
--- /dev/null
+++ b/.hark/changes/2015-09-11_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new 429 rate limit response
+released_in_version: 1.26.0
+---
diff --git a/.hark/changes/2015-09-14_unknown_products-skus-orders.change.md b/.hark/changes/2015-09-14_unknown_products-skus-orders.change.md
new file mode 100644
index 000000000..f0fa453f4
--- /dev/null
+++ b/.hark/changes/2015-09-14_unknown_products-skus-orders.change.md
@@ -0,0 +1,4 @@
+---
+title: Products, SKUs, Orders resources
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-10-02_unknown_add-ability-delete.change.md b/.hark/changes/2015-10-02_unknown_add-ability-delete.change.md
new file mode 100644
index 000000000..1984d9abc
--- /dev/null
+++ b/.hark/changes/2015-10-02_unknown_add-ability-delete.change.md
@@ -0,0 +1,4 @@
+---
+title: Add ability to delete attributes
+released_in_version: 1.27.1
+---
diff --git a/.hark/changes/2015-10-02_unknown_add-configurable-http.change.md b/.hark/changes/2015-10-02_unknown_add-configurable-http.change.md
new file mode 100644
index 000000000..1b84905e6
--- /dev/null
+++ b/.hark/changes/2015-10-02_unknown_add-configurable-http.change.md
@@ -0,0 +1,4 @@
+---
+title: Add configurable HTTP client
+released_in_version: 1.27.1
+---
diff --git a/.hark/changes/2015-10-02_unknown_official-python-3.change.md b/.hark/changes/2015-10-02_unknown_official-python-3.change.md
new file mode 100644
index 000000000..96fa095c8
--- /dev/null
+++ b/.hark/changes/2015-10-02_unknown_official-python-3.change.md
@@ -0,0 +1,4 @@
+---
+title: Official Python 3.4 & 3.5 compatibility
+released_in_version: 1.27.1
+---
diff --git a/.hark/changes/2016-01-04_unknown_add-automatic-paginating.change.md b/.hark/changes/2016-01-04_unknown_add-automatic-paginating.change.md
new file mode 100644
index 000000000..fb0c0cdfa
--- /dev/null
+++ b/.hark/changes/2016-01-04_unknown_add-automatic-paginating.change.md
@@ -0,0 +1,4 @@
+---
+title: Add an automatic paginating iterator to lists available via `auto_paging_iter`
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2016-01-04_unknown_all-method-list.change.md b/.hark/changes/2016-01-04_unknown_all-method-list.change.md
new file mode 100644
index 000000000..d40c3b084
--- /dev/null
+++ b/.hark/changes/2016-01-04_unknown_all-method-list.change.md
@@ -0,0 +1,4 @@
+---
+title: The `all` method on list objects has been deprecated in favor of `list`
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2016-01-04_unknown_calls-instanceurl-now.change.md b/.hark/changes/2016-01-04_unknown_calls-instanceurl-now.change.md
new file mode 100644
index 000000000..226f8dcad
--- /dev/null
+++ b/.hark/changes/2016-01-04_unknown_calls-instanceurl-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Calls to `instance_url` are now side effect free
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2016-01-04_unknown_error-messages-set.change.md b/.hark/changes/2016-01-04_unknown_error-messages-set.change.md
new file mode 100644
index 000000000..fc1ae397b
--- /dev/null
+++ b/.hark/changes/2016-01-04_unknown_error-messages-set.change.md
@@ -0,0 +1,4 @@
+---
+title: Error messages set to `None` are now handled properly
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2016-01-04_unknown_list-objects-now.change.md b/.hark/changes/2016-01-04_unknown_list-objects-now.change.md
new file mode 100644
index 000000000..fda1c3638
--- /dev/null
+++ b/.hark/changes/2016-01-04_unknown_list-objects-now.change.md
@@ -0,0 +1,4 @@
+---
+title: List objects are now iterable
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2016-01-26_unknown_add-support-deleting.change.md b/.hark/changes/2016-01-26_unknown_add-support-deleting.change.md
new file mode 100644
index 000000000..10cc57a01
--- /dev/null
+++ b/.hark/changes/2016-01-26_unknown_add-support-deleting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for deleting Relay products and SKUs
+released_in_version: 1.29.0
+---
diff --git a/.hark/changes/2016-02-01_unknown_update-bundled-ca.change.md b/.hark/changes/2016-02-01_unknown_update-bundled-ca.change.md
new file mode 100644
index 000000000..5bac1e069
--- /dev/null
+++ b/.hark/changes/2016-02-01_unknown_update-bundled-ca.change.md
@@ -0,0 +1,4 @@
+---
+title: Update bundled CA certs
+released_in_version: 1.29.1
+---
diff --git a/.hark/changes/2016-02-27_unknown_add-countryspec-model.change.md b/.hark/changes/2016-02-27_unknown_add-countryspec-model.change.md
new file mode 100644
index 000000000..c5f53825e
--- /dev/null
+++ b/.hark/changes/2016-02-27_unknown_add-countryspec-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `CountrySpec` model for looking up country payment information
+released_in_version: 1.30.0
+---
diff --git a/.hark/changes/2016-03-15_unknown_add-reject-account.change.md b/.hark/changes/2016-03-15_unknown_add-reject-account.change.md
new file mode 100644
index 000000000..0d70377cd
--- /dev/null
+++ b/.hark/changes/2016-03-15_unknown_add-reject-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `reject` on `Account` to support the new API feature
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2016-03-24_unknown_fix-uploading-binary.change.md b/.hark/changes/2016-03-24_unknown_fix-uploading-binary.change.md
new file mode 100644
index 000000000..3584bab2f
--- /dev/null
+++ b/.hark/changes/2016-03-24_unknown_fix-uploading-binary.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix uploading of binary files in Python 3
+released_in_version: 1.31.1
+---
diff --git a/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md b/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md
new file mode 100644
index 000000000..26cdfaafe
--- /dev/null
+++ b/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md
@@ -0,0 +1,4 @@
+---
+title: Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
+released_in_version: 1.32.0
+---
diff --git a/.hark/changes/2016-04-11_unknown_fix-bug-where.change.md b/.hark/changes/2016-04-11_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..9a498830a
--- /dev/null
+++ b/.hark/changes/2016-04-11_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where request parameters were not passed between pages with `auto_paging_iter`
+released_in_version: 1.32.1
+---
diff --git a/.hark/changes/2016-04-12_unknown_fix-bug-where.change.md b/.hark/changes/2016-04-12_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..b6c7a3312
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where file uploads could not be properly listed
+released_in_version: 1.32.2
+---
diff --git a/.hark/changes/2016-05-04_unknown_add-support-new.change.md b/.hark/changes/2016-05-04_unknown_add-support-new.change.md
new file mode 100644
index 000000000..3f93a780b
--- /dev/null
+++ b/.hark/changes/2016-05-04_unknown_add-support-new.change.md
@@ -0,0 +1,9 @@
+---
+title: Add support for the new `/v1/subscriptions` endpoint
+released_in_version: 1.33.0
+---
+
+* `stripe.Subscription.retrieve`
+* `stripe.Subscription.update`
+* `stripe.Subscription.create`
+* `stripe.Subscription.list`
diff --git a/.hark/changes/2016-05-20_unknown_add-support-alipay.change.md b/.hark/changes/2016-05-20_unknown_add-support-alipay.change.md
new file mode 100644
index 000000000..1aadb03f8
--- /dev/null
+++ b/.hark/changes/2016-05-20_unknown_add-support-alipay.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for Alipay accounts
+released_in_version: 1.34.0
+---
diff --git a/.hark/changes/2016-05-24_unknown_add-support-returning.change.md b/.hark/changes/2016-05-24_unknown_add-support-returning.change.md
new file mode 100644
index 000000000..685262acb
--- /dev/null
+++ b/.hark/changes/2016-05-24_unknown_add-support-returning.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for returning Relay orders
+released_in_version: 1.35.0
+---
diff --git a/.hark/changes/2016-06-29_unknown_add-update-class.change.md b/.hark/changes/2016-06-29_unknown_add-update-class.change.md
new file mode 100644
index 000000000..92a4248e7
--- /dev/null
+++ b/.hark/changes/2016-06-29_unknown_add-update-class.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `update` class method to resources that can be updated
+released_in_version: 1.36.0
+---
diff --git a/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md b/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md
new file mode 100644
index 000000000..b1a776a4d
--- /dev/null
+++ b/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `ThreeDSecure` model for 3-D secure payments
+released_in_version: 1.37.0
+---
diff --git a/.hark/changes/2016-09-15_unknown_add-support-apple.change.md b/.hark/changes/2016-09-15_unknown_add-support-apple.change.md
new file mode 100644
index 000000000..358a27ffc
--- /dev/null
+++ b/.hark/changes/2016-09-15_unknown_add-support-apple.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for Apple Pay domains
+released_in_version: 1.38.0
+---
diff --git a/.hark/changes/2016-10-06_unknown_add-proxy-support.change.md b/.hark/changes/2016-10-06_unknown_add-proxy-support.change.md
new file mode 100644
index 000000000..501a8444f
--- /dev/null
+++ b/.hark/changes/2016-10-06_unknown_add-proxy-support.change.md
@@ -0,0 +1,4 @@
+---
+title: Add proxy support for pycurl, Requests, urlfetch, and urllib2 libraries
+released_in_version: 1.39.0
+---
diff --git a/.hark/changes/2016-10-06_unknown_add-support-subscription.change.md b/.hark/changes/2016-10-06_unknown_add-support-subscription.change.md
new file mode 100644
index 000000000..1c2aa37ef
--- /dev/null
+++ b/.hark/changes/2016-10-06_unknown_add-support-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for subscription items
+released_in_version: 1.39.0
+---
diff --git a/.hark/changes/2016-10-07_unknown_add-configurable-timeout.change.md b/.hark/changes/2016-10-07_unknown_add-configurable-timeout.change.md
new file mode 100644
index 000000000..a88d8f7bd
--- /dev/null
+++ b/.hark/changes/2016-10-07_unknown_add-configurable-timeout.change.md
@@ -0,0 +1,4 @@
+---
+title: Add configurable timeout for Requests HTTP library
+released_in_version: 1.40.0
+---
diff --git a/.hark/changes/2016-10-10_unknown_return-subscription-model.change.md b/.hark/changes/2016-10-10_unknown_return-subscription-model.change.md
new file mode 100644
index 000000000..98f8f2dfb
--- /dev/null
+++ b/.hark/changes/2016-10-10_unknown_return-subscription-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Return subscription model instance on subscription create/modify
+released_in_version: 1.40.1
+---
diff --git a/.hark/changes/2016-10-12_unknown_add-source-model.change.md b/.hark/changes/2016-10-12_unknown_add-source-model.change.md
new file mode 100644
index 000000000..16884f278
--- /dev/null
+++ b/.hark/changes/2016-10-12_unknown_add-source-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Source` model for generic payment sources
+released_in_version: 1.41.0
+---
diff --git a/.hark/changes/2016-10-26_unknown_implement-copy-deepcopy.change.md b/.hark/changes/2016-10-26_unknown_implement-copy-deepcopy.change.md
new file mode 100644
index 000000000..1cfebcbaa
--- /dev/null
+++ b/.hark/changes/2016-10-26_unknown_implement-copy-deepcopy.change.md
@@ -0,0 +1,4 @@
+---
+title: Implement __copy__ and __deepcopy__ on StripeObject to fix these operations
+released_in_version: 1.41.1
+---
diff --git a/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md b/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md
new file mode 100644
index 000000000..c11972c65
--- /dev/null
+++ b/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Add retrieve method for 3-D Secure resources
+released_in_version: 1.42.0
+---
diff --git a/.hark/changes/2016-11-30_unknown_add-support-verifying.change.md b/.hark/changes/2016-11-30_unknown_add-support-verifying.change.md
new file mode 100644
index 000000000..6b5bbb761
--- /dev/null
+++ b/.hark/changes/2016-11-30_unknown_add-support-verifying.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for verifying sources
+released_in_version: 1.43.0
+---
diff --git a/.hark/changes/2016-12-16_unknown_add-request-logging.change.md b/.hark/changes/2016-12-16_unknown_add-request-logging.change.md
new file mode 100644
index 000000000..a326c9b17
--- /dev/null
+++ b/.hark/changes/2016-12-16_unknown_add-request-logging.change.md
@@ -0,0 +1,4 @@
+---
+title: Add request logging and some mechanisms to enable it when debugging
+released_in_version: 1.44.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_format-now-same.change.md b/.hark/changes/2017-01-06_unknown_format-now-same.change.md
new file mode 100644
index 000000000..087a38902
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_format-now-same.change.md
@@ -0,0 +1,4 @@
+---
+title: Format is now the same between logging logs, and console logs
+released_in_version: 1.45.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_logs-properly-handle.change.md b/.hark/changes/2017-01-06_unknown_logs-properly-handle.change.md
new file mode 100644
index 000000000..65615a613
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_logs-properly-handle.change.md
@@ -0,0 +1,4 @@
+---
+title: Logs properly handle unicode
+released_in_version: 1.45.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_request-logging-goes.change.md b/.hark/changes/2017-01-06_unknown_request-logging-goes.change.md
new file mode 100644
index 000000000..a79cecd15
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_request-logging-goes.change.md
@@ -0,0 +1,4 @@
+---
+title: request logging goes to stderr now
+released_in_version: 1.45.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_use-internal-session.change.md b/.hark/changes/2017-01-06_unknown_use-internal-session.change.md
new file mode 100644
index 000000000..59e57f56c
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_use-internal-session.change.md
@@ -0,0 +1,4 @@
+---
+title: Use internal session for Requests for connection pooling
+released_in_version: 1.46.0
+---
diff --git a/.hark/changes/2017-01-18_unknown_allow-sources-updated.change.md b/.hark/changes/2017-01-18_unknown_allow-sources-updated.change.md
new file mode 100644
index 000000000..67cbdfea4
--- /dev/null
+++ b/.hark/changes/2017-01-18_unknown_allow-sources-updated.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow sources to be updated
+released_in_version: 1.47.0
+---
diff --git a/.hark/changes/2017-02-21_unknown_add-account-modifyextern.change.md b/.hark/changes/2017-02-21_unknown_add-account-modifyextern.change.md
new file mode 100644
index 000000000..f553fff16
--- /dev/null
+++ b/.hark/changes/2017-02-21_unknown_add-account-modifyextern.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Account.modify_external_account` to modify an account in one API call
+released_in_version: 1.48.0
+---
diff --git a/.hark/changes/2017-02-21_unknown_add-customer-modifysource.change.md b/.hark/changes/2017-02-21_unknown_add-customer-modifysource.change.md
new file mode 100644
index 000000000..30cb3c574
--- /dev/null
+++ b/.hark/changes/2017-02-21_unknown_add-customer-modifysource.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Customer.modify_source` to modify a source in one API call
+released_in_version: 1.48.0
+---
diff --git a/.hark/changes/2017-02-21_unknown_fix-encoding-parameters.change.md b/.hark/changes/2017-02-21_unknown_fix-encoding-parameters.change.md
new file mode 100644
index 000000000..ccf48aa28
--- /dev/null
+++ b/.hark/changes/2017-02-21_unknown_fix-encoding-parameters.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix encoding of parameters when fetching upcoming invoices
+released_in_version: 1.48.1
+---
diff --git a/.hark/changes/2017-03-13_unknown_accept-session-argument.change.md b/.hark/changes/2017-03-13_unknown_accept-session-argument.change.md
new file mode 100644
index 000000000..00c85116b
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_accept-session-argument.change.md
@@ -0,0 +1,4 @@
+---
+title: Accept `session` argument for `RequestsClient`
+released_in_version: 1.49.0
+---
diff --git a/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md b/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md
new file mode 100644
index 000000000..3a8c393df
--- /dev/null
+++ b/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for detaching sources from customers
+released_in_version: 1.50.0
+---
diff --git a/.hark/changes/2017-03-20_unknown_support-oauth-operations.change.md b/.hark/changes/2017-03-20_unknown_support-oauth-operations.change.md
new file mode 100644
index 000000000..0bfeb6088
--- /dev/null
+++ b/.hark/changes/2017-03-20_unknown_support-oauth-operations.change.md
@@ -0,0 +1,4 @@
+---
+title: Support OAuth operations (getting a token and deauthorizing)
+released_in_version: 1.51.0
+---
diff --git a/.hark/changes/2017-04-06_unknown_add-support-payouts.change.md b/.hark/changes/2017-04-06_unknown_add-support-payouts.change.md
new file mode 100644
index 000000000..2ac571900
--- /dev/null
+++ b/.hark/changes/2017-04-06_unknown_add-support-payouts.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for payouts and recipient transfers
+released_in_version: 1.53.0
+---
diff --git a/.hark/changes/2017-04-06_unknown_op-release-peg.change.md b/.hark/changes/2017-04-06_unknown_op-release-peg.change.md
new file mode 100644
index 000000000..7eb8f28fe
--- /dev/null
+++ b/.hark/changes/2017-04-06_unknown_op-release-peg.change.md
@@ -0,0 +1,4 @@
+---
+title: "No-op release: peg test suite to a specific API version"
+released_in_version: 1.52.0
+---
diff --git a/.hark/changes/2017-04-28_unknown_add-stripe-setappinfo.change.md b/.hark/changes/2017-04-28_unknown_add-stripe-setappinfo.change.md
new file mode 100644
index 000000000..7d72c7a7b
--- /dev/null
+++ b/.hark/changes/2017-04-28_unknown_add-stripe-setappinfo.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `stripe.set_app_info` for use by plugin creators
+released_in_version: 1.54.0
+---
diff --git a/.hark/changes/2017-04-28_unknown_support-checking-webhook.change.md b/.hark/changes/2017-04-28_unknown_support-checking-webhook.change.md
new file mode 100644
index 000000000..190258981
--- /dev/null
+++ b/.hark/changes/2017-04-28_unknown_support-checking-webhook.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for checking webhook signatures
+released_in_version: 1.55.0
+---
diff --git a/.hark/changes/2017-05-10_unknown_constrain-requests-2.change.md b/.hark/changes/2017-05-10_unknown_constrain-requests-2.change.md
new file mode 100644
index 000000000..b4414a373
--- /dev/null
+++ b/.hark/changes/2017-05-10_unknown_constrain-requests-2.change.md
@@ -0,0 +1,4 @@
+---
+title: Constrain Requests to < 2.13.0 if on setuptools < 18.0.0
+released_in_version: 1.55.1
+---
diff --git a/.hark/changes/2017-05-11_unknown_remove-requests-constraint.change.md b/.hark/changes/2017-05-11_unknown_remove-requests-constraint.change.md
new file mode 100644
index 000000000..b85b25104
--- /dev/null
+++ b/.hark/changes/2017-05-11_unknown_remove-requests-constraint.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove Requests constraint from 1.55.1 now that they've patched (as of 2.14.2)
+released_in_version: 1.55.2
+---
diff --git a/.hark/changes/2017-05-25_unknown_add-support-account.change.md b/.hark/changes/2017-05-25_unknown_add-support-account.change.md
new file mode 100644
index 000000000..366f5fb5a
--- /dev/null
+++ b/.hark/changes/2017-05-25_unknown_add-support-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for account login links
+released_in_version: 1.56.0
+---
diff --git a/.hark/changes/2017-05-26_unknown_add-apikey-parameter.change.md b/.hark/changes/2017-05-26_unknown_add-apikey-parameter.change.md
new file mode 100644
index 000000000..d879e43e8
--- /dev/null
+++ b/.hark/changes/2017-05-26_unknown_add-apikey-parameter.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `api_key` parameter to webhook's `construct_event`
+released_in_version: 1.57.0
+---
diff --git a/.hark/changes/2017-05-31_unknown_fix-pycurl-client.change.md b/.hark/changes/2017-05-31_unknown_fix-pycurl-client.change.md
new file mode 100644
index 000000000..aaf38aeac
--- /dev/null
+++ b/.hark/changes/2017-05-31_unknown_fix-pycurl-client.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix the pycurl client
+released_in_version: 1.57.1
+---
diff --git a/.hark/changes/2017-06-02_unknown_re-use-connections.change.md b/.hark/changes/2017-06-02_unknown_re-use-connections.change.md
new file mode 100644
index 000000000..bb9a70f92
--- /dev/null
+++ b/.hark/changes/2017-06-02_unknown_re-use-connections.change.md
@@ -0,0 +1,4 @@
+---
+title: Re-use connections with Pycurl
+released_in_version: 1.58.0
+---
diff --git a/.hark/changes/2017-06-07_unknown_refactor-oauth-implementati.change.md b/.hark/changes/2017-06-07_unknown_refactor-oauth-implementati.change.md
new file mode 100644
index 000000000..609732f89
--- /dev/null
+++ b/.hark/changes/2017-06-07_unknown_refactor-oauth-implementati.change.md
@@ -0,0 +1,4 @@
+---
+title: Refactor OAuth implementation to have dedicated classes for errors
+released_in_version: 1.59.0
+---
diff --git a/.hark/changes/2017-06-19_unknown_add-support-ephemeral.change.md b/.hark/changes/2017-06-19_unknown_add-support-ephemeral.change.md
new file mode 100644
index 000000000..44f29533e
--- /dev/null
+++ b/.hark/changes/2017-06-19_unknown_add-support-ephemeral.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for ephemeral keys
+released_in_version: 1.60.0
+---
diff --git a/.hark/changes/2017-06-24_unknown_expose-code-invalidreque.change.md b/.hark/changes/2017-06-24_unknown_expose-code-invalidreque.change.md
new file mode 100644
index 000000000..ea5f2086d
--- /dev/null
+++ b/.hark/changes/2017-06-24_unknown_expose-code-invalidreque.change.md
@@ -0,0 +1,4 @@
+---
+title: Expose `code` on `InvalidRequestError`
+released_in_version: 1.61.0
+---
diff --git a/.hark/changes/2017-06-27_unknown_pay-invoice-can.change.md b/.hark/changes/2017-06-27_unknown_pay-invoice-can.change.md
new file mode 100644
index 000000000..a6ce1c534
--- /dev/null
+++ b/.hark/changes/2017-06-27_unknown_pay-invoice-can.change.md
@@ -0,0 +1,4 @@
+---
+title: "`pay` on invoice can now take parameter"
+released_in_version: 1.62.0
+---
diff --git a/.hark/changes/2017-08-07_unknown_change-serializatio-subscription.change.md b/.hark/changes/2017-08-07_unknown_change-serializatio-subscription.change.md
new file mode 100644
index 000000000..ea337463b
--- /dev/null
+++ b/.hark/changes/2017-08-07_unknown_change-serializatio-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Change serialization of subscription items on update to encoded as an integer-indexed map
+released_in_version: 1.62.1
+---
diff --git a/.hark/changes/2017-08-29_unknown_add-support-invalidclien.change.md b/.hark/changes/2017-08-29_unknown_add-support-invalidclien.change.md
new file mode 100644
index 000000000..8f794851f
--- /dev/null
+++ b/.hark/changes/2017-08-29_unknown_add-support-invalidclien.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for `InvalidClientError` OAuth error
+released_in_version: 1.63.0
+---
diff --git a/.hark/changes/2017-09-01_unknown_error-invalid-type.change.md b/.hark/changes/2017-09-01_unknown_error-invalid-type.change.md
new file mode 100644
index 000000000..b291289ae
--- /dev/null
+++ b/.hark/changes/2017-09-01_unknown_error-invalid-type.change.md
@@ -0,0 +1,4 @@
+---
+title: Error when an invalid type (i.e. non-string) passed as an API method argument
+released_in_version: 1.64.0
+---
diff --git a/.hark/changes/2017-09-01_unknown_fix-serializatio-items.change.md b/.hark/changes/2017-09-01_unknown_fix-serializatio-items.change.md
new file mode 100644
index 000000000..67dc51a99
--- /dev/null
+++ b/.hark/changes/2017-09-01_unknown_fix-serializatio-items.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix serialization of `items` on Relay order creation and order return
+released_in_version: 1.63.1
+---
diff --git a/.hark/changes/2017-09-07_unknown_add-support-passing.change.md b/.hark/changes/2017-09-07_unknown_add-support-passing.change.md
new file mode 100644
index 000000000..728f88d67
--- /dev/null
+++ b/.hark/changes/2017-09-07_unknown_add-support-passing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for passing a `stripe_version` argument to all API requests
+released_in_version: 1.65.0
+---
diff --git a/.hark/changes/2017-09-21_unknown_handle-bytearray-bytes.change.md b/.hark/changes/2017-09-21_unknown_handle-bytearray-bytes.change.md
new file mode 100644
index 000000000..e4f5f997d
--- /dev/null
+++ b/.hark/changes/2017-09-21_unknown_handle-bytearray-bytes.change.md
@@ -0,0 +1,4 @@
+---
+title: Handle `bytearray` and `bytes` (in addition to string) in `Webhook.construct_event`
+released_in_version: 1.65.1
+---
diff --git a/.hark/changes/2017-09-29_unknown_support-length-reads.change.md b/.hark/changes/2017-09-29_unknown_support-length-reads.change.md
new file mode 100644
index 000000000..efb547c9b
--- /dev/null
+++ b/.hark/changes/2017-09-29_unknown_support-length-reads.change.md
@@ -0,0 +1,4 @@
+---
+title: Support length reads on list objects
+released_in_version: 1.66.0
+---
diff --git a/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md b/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md
new file mode 100644
index 000000000..1d08f3df5
--- /dev/null
+++ b/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename source `delete` to `detach` (and deprecate the former)
+pr_url: https://github.com/stripe/stripe-python/pull/349
+released_in_version: 1.67.0
+---
diff --git a/.hark/changes/2017-10-19_brandur_add-static-methods.change.md b/.hark/changes/2017-10-19_brandur_add-static-methods.change.md
new file mode 100644
index 000000000..97655beec
--- /dev/null
+++ b/.hark/changes/2017-10-19_brandur_add-static-methods.change.md
@@ -0,0 +1,10 @@
+---
+title: Add static methods to manipulate resources from parent
+pr_url: https://github.com/stripe/stripe-python/pull/350
+released_in_version: 1.68.0
+---
+
+* `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
+* `ApplicationFee` gains methods for refunds
+* `Customer` gains methods for sources
+* `Transfer` gains methods for reversals
diff --git a/.hark/changes/2017-10-20_brandur_break-resource-py.change.md b/.hark/changes/2017-10-20_brandur_break-resource-py.change.md
new file mode 100644
index 000000000..91e47c8c1
--- /dev/null
+++ b/.hark/changes/2017-10-20_brandur_break-resource-py.change.md
@@ -0,0 +1,7 @@
+---
+title: Break resource.py module into separate ones for each type of resource
+pr_url: https://github.com/stripe/stripe-python/pull/351
+released_in_version: 1.69.0
+---
+
+* Classes are still into resource.py for backwards compatibility
diff --git a/.hark/changes/2017-10-20_brandur_fix-unpickling-stripeobject.change.md b/.hark/changes/2017-10-20_brandur_fix-unpickling-stripeobject.change.md
new file mode 100644
index 000000000..be6a0b483
--- /dev/null
+++ b/.hark/changes/2017-10-20_brandur_fix-unpickling-stripeobject.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix unpickling `StripeObject` in Python 3
+pr_url: https://github.com/stripe/stripe-python/pull/353
+released_in_version: 1.69.0
+---
diff --git a/.hark/changes/2017-10-23_brandur_support-uploading-files.change.md b/.hark/changes/2017-10-23_brandur_support-uploading-files.change.md
new file mode 100644
index 000000000..1d7525bdb
--- /dev/null
+++ b/.hark/changes/2017-10-23_brandur_support-uploading-files.change.md
@@ -0,0 +1,5 @@
+---
+title: Support uploading files with `StringIO` in addition to a file on disk
+pr_url: https://github.com/stripe/stripe-python/pull/356
+released_in_version: 1.70.0
+---
diff --git a/.hark/changes/2017-10-26_brandur_support-listing-source.change.md b/.hark/changes/2017-10-26_brandur_support-listing-source.change.md
new file mode 100644
index 000000000..01ddd808a
--- /dev/null
+++ b/.hark/changes/2017-10-26_brandur_support-listing-source.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for listing source transactions
+pr_url: https://github.com/stripe/stripe-python/pull/359
+released_in_version: 1.71.0
+---
diff --git a/.hark/changes/2017-10-27_brandur_fix-byteswarning-being.change.md b/.hark/changes/2017-10-27_brandur_fix-byteswarning-being.change.md
new file mode 100644
index 000000000..ee4265998
--- /dev/null
+++ b/.hark/changes/2017-10-27_brandur_fix-byteswarning-being.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `BytesWarning` being issued on logging in Python 3
+pr_url: https://github.com/stripe/stripe-python/pull/360
+released_in_version: 1.71.1
+---
diff --git a/.hark/changes/2017-10-31_brandur_fix-balance-transaction.change.md b/.hark/changes/2017-10-31_brandur_fix-balance-transaction.change.md
new file mode 100644
index 000000000..ad428890a
--- /dev/null
+++ b/.hark/changes/2017-10-31_brandur_fix-balance-transaction.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix balance transaction and invoice item conversion into `StripeObject`s
+pr_url: https://github.com/stripe/stripe-python/pull/362
+released_in_version: 1.71.2
+---
diff --git a/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md b/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md
new file mode 100644
index 000000000..a0446c296
--- /dev/null
+++ b/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for exchange rates APIs
+pr_url: https://github.com/stripe/stripe-python/pull/361
+released_in_version: 1.72.0
+---
diff --git a/.hark/changes/2017-11-02_brandur_switch-vendored-version.change.md b/.hark/changes/2017-11-02_brandur_switch-vendored-version.change.md
new file mode 100644
index 000000000..8b18052c5
--- /dev/null
+++ b/.hark/changes/2017-11-02_brandur_switch-vendored-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Switch to vendored version of the `six` package for compatibility between Python 2 and 3
+pr_url: https://github.com/stripe/stripe-python/pull/364
+released_in_version: 1.73.0
+---
diff --git a/.hark/changes/2017-11-07_brandur_remove-api-allowed.change.md b/.hark/changes/2017-11-07_brandur_remove-api-allowed.change.md
new file mode 100644
index 000000000..5ad9f9f6f
--- /dev/null
+++ b/.hark/changes/2017-11-07_brandur_remove-api-allowed.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove API that allowed the creation of new disputes (this was an erroneous addition; it never worked because the API would not allow it)
+pr_url: https://github.com/stripe/stripe-python/pull/368
+released_in_version: 1.74.0
+---
diff --git a/.hark/changes/2017-11-08_brandur_make-custom-actions.change.md b/.hark/changes/2017-11-08_brandur_make-custom-actions.change.md
new file mode 100644
index 000000000..0a29f535e
--- /dev/null
+++ b/.hark/changes/2017-11-08_brandur_make-custom-actions.change.md
@@ -0,0 +1,5 @@
+---
+title: Make custom actions on various resources (e.g. `Account.reject`) more consistent with other APIs
+pr_url: https://github.com/stripe/stripe-python/pull/369
+released_in_version: 1.75.0
+---
diff --git a/.hark/changes/2017-11-29_ob_add-only-changed.change.md b/.hark/changes/2017-11-29_ob_add-only-changed.change.md
new file mode 100644
index 000000000..f958fd7f6
--- /dev/null
+++ b/.hark/changes/2017-11-29_ob_add-only-changed.change.md
@@ -0,0 +1,5 @@
+---
+title: Add only changed values to `_unsaved_values` in `StripeObject`
+pr_url: https://github.com/stripe/stripe-python/pull/372
+released_in_version: 1.75.1
+---
diff --git a/.hark/changes/2017-11-29_ob_use-custom-json.change.md b/.hark/changes/2017-11-29_ob_use-custom-json.change.md
new file mode 100644
index 000000000..d44e23021
--- /dev/null
+++ b/.hark/changes/2017-11-29_ob_use-custom-json.change.md
@@ -0,0 +1,5 @@
+---
+title: Use a custom JSON encoder to handle `datetime` objects when serializing `StripeObject`s
+pr_url: https://github.com/stripe/stripe-python/pull/375
+released_in_version: 1.75.1
+---
diff --git a/.hark/changes/2017-12-05_brandur_log-encoded-version.change.md b/.hark/changes/2017-12-05_brandur_log-encoded-version.change.md
new file mode 100644
index 000000000..b10e17e18
--- /dev/null
+++ b/.hark/changes/2017-12-05_brandur_log-encoded-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Log encoded version of parameters instead of raw POST data
+pr_url: https://github.com/stripe/stripe-python/pull/378
+released_in_version: 1.75.3
+---
diff --git a/.hark/changes/2017-12-05_unknown_accidental-op-release.change.md b/.hark/changes/2017-12-05_unknown_accidental-op-release.change.md
new file mode 100644
index 000000000..0fb8138a5
--- /dev/null
+++ b/.hark/changes/2017-12-05_unknown_accidental-op-release.change.md
@@ -0,0 +1,4 @@
+---
+title: (Accidental no-op release. See 1.75.3.)
+released_in_version: 1.75.2
+---
diff --git a/.hark/changes/2017-12-21_brandur_add-new-idempotencye.change.md b/.hark/changes/2017-12-21_brandur_add-new-idempotencye.change.md
new file mode 100644
index 000000000..c1cbff203
--- /dev/null
+++ b/.hark/changes/2017-12-21_brandur_add-new-idempotencye.change.md
@@ -0,0 +1,5 @@
+---
+title: Add new `IdempotencyError` type
+pr_url: https://github.com/stripe/stripe-python/pull/382
+released_in_version: 1.76.0
+---
diff --git a/.hark/changes/2017-12-22_brandur_add-accessor-lastresponse.change.md b/.hark/changes/2017-12-22_brandur_add-accessor-lastresponse.change.md
new file mode 100644
index 000000000..961ff632a
--- /dev/null
+++ b/.hark/changes/2017-12-22_brandur_add-accessor-lastresponse.change.md
@@ -0,0 +1,5 @@
+---
+title: Add accessor `last_response` on `StripeObject` for accessing request ID and other metadata
+pr_url: https://github.com/stripe/stripe-python/pull/371
+released_in_version: 1.77.0
+---
diff --git a/.hark/changes/2018-01-05_ob_drop-support-python.change.md b/.hark/changes/2018-01-05_ob_drop-support-python.change.md
new file mode 100644
index 000000000..7d284adb7
--- /dev/null
+++ b/.hark/changes/2018-01-05_ob_drop-support-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Drop support for Python 2.6 and 3.3
+pr_url: https://github.com/stripe/stripe-python/pull/385
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-01-12_brandur_register-unsaved-attributes.change.md b/.hark/changes/2018-01-12_brandur_register-unsaved-attributes.change.md
new file mode 100644
index 000000000..773f079f5
--- /dev/null
+++ b/.hark/changes/2018-01-12_brandur_register-unsaved-attributes.change.md
@@ -0,0 +1,5 @@
+---
+title: Register unsaved attributes on assignment regardless of new value
+pr_url: https://github.com/stripe/stripe-python/pull/389
+released_in_version: 1.77.1
+---
diff --git a/.hark/changes/2018-02-08_ob_make-lastresponse-available.change.md b/.hark/changes/2018-02-08_ob_make-lastresponse-available.change.md
new file mode 100644
index 000000000..aeea6616c
--- /dev/null
+++ b/.hark/changes/2018-02-08_ob_make-lastresponse-available.change.md
@@ -0,0 +1,5 @@
+---
+title: Make `last_response` available after calling `save()`
+pr_url: https://github.com/stripe/stripe-python/pull/394
+released_in_version: 1.77.2
+---
diff --git a/.hark/changes/2018-02-21_brandur_add-support-topups.change.md b/.hark/changes/2018-02-21_brandur_add-support-topups.change.md
new file mode 100644
index 000000000..30daa784c
--- /dev/null
+++ b/.hark/changes/2018-02-21_brandur_add-support-topups.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for topups
+pr_url: https://github.com/stripe/stripe-python/pull/396
+released_in_version: 1.78.0
+---
diff --git a/.hark/changes/2018-02-21_ob_use-py-test.change.md b/.hark/changes/2018-02-21_ob_use-py-test.change.md
new file mode 100644
index 000000000..bf551d875
--- /dev/null
+++ b/.hark/changes/2018-02-21_ob_use-py-test.change.md
@@ -0,0 +1,5 @@
+---
+title: Use py.test for tests
+pr_url: https://github.com/stripe/stripe-python/pull/384
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-02-23_ob_add-support-code.change.md b/.hark/changes/2018-02-23_ob_add-support-code.change.md
new file mode 100644
index 000000000..471b256dc
--- /dev/null
+++ b/.hark/changes/2018-02-23_ob_add-support-code.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `code` attribute on all Stripe exceptions
+pr_url: https://github.com/stripe/stripe-python/pull/398
+released_in_version: 1.79.0
+---
diff --git a/.hark/changes/2018-02-23_ob_build-universal-wheels.change.md b/.hark/changes/2018-02-23_ob_build-universal-wheels.change.md
new file mode 100644
index 000000000..3e7de541b
--- /dev/null
+++ b/.hark/changes/2018-02-23_ob_build-universal-wheels.change.md
@@ -0,0 +1,5 @@
+---
+title: Build universal wheels by default
+pr_url: https://github.com/stripe/stripe-python/pull/397
+released_in_version: 1.79.0
+---
diff --git a/.hark/changes/2018-02-27_brandur_drop-conditional-dependencies.change.md b/.hark/changes/2018-02-27_brandur_drop-conditional-dependencies.change.md
new file mode 100644
index 000000000..d35f245f1
--- /dev/null
+++ b/.hark/changes/2018-02-27_brandur_drop-conditional-dependencies.change.md
@@ -0,0 +1,5 @@
+---
+title: Drop conditional dependencies that incorrectly led to an added `simplejson` dependency in Python 3+ after switching to universal wheel
+pr_url: https://github.com/stripe/stripe-python/pull/401
+released_in_version: 1.79.1
+---
diff --git a/.hark/changes/2018-02-27_ob_remove-deprecated-code.change.md b/.hark/changes/2018-02-27_ob_remove-deprecated-code.change.md
new file mode 100644
index 000000000..8cb0f9ac1
--- /dev/null
+++ b/.hark/changes/2018-02-27_ob_remove-deprecated-code.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove deprecated code
+pr_url: https://github.com/stripe/stripe-python/pull/399
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-02-28_ob_remove-util-json.change.md b/.hark/changes/2018-02-28_ob_remove-util-json.change.md
new file mode 100644
index 000000000..597bf509c
--- /dev/null
+++ b/.hark/changes/2018-02-28_ob_remove-util-json.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove `util.json` and use `json` module directly everywhere
+pr_url: https://github.com/stripe/stripe-python/pull/402
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-03-05_ob_update-setup-py.change.md b/.hark/changes/2018-03-05_ob_update-setup-py.change.md
new file mode 100644
index 000000000..6b298fdbe
--- /dev/null
+++ b/.hark/changes/2018-03-05_ob_update-setup-py.change.md
@@ -0,0 +1,5 @@
+---
+title: Update setup.py and test flow
+pr_url: https://github.com/stripe/stripe-python/pull/403
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-03-13_ob_use-pipenv.change.md b/.hark/changes/2018-03-13_ob_use-pipenv.change.md
new file mode 100644
index 000000000..c7c6ea100
--- /dev/null
+++ b/.hark/changes/2018-03-13_ob_use-pipenv.change.md
@@ -0,0 +1,5 @@
+---
+title: Use pipenv
+pr_url: https://github.com/stripe/stripe-python/pull/410
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-03-15_ob_change-exception-detaching.change.md b/.hark/changes/2018-03-15_ob_change-exception-detaching.change.md
new file mode 100644
index 000000000..1917c7ec6
--- /dev/null
+++ b/.hark/changes/2018-03-15_ob_change-exception-detaching.change.md
@@ -0,0 +1,5 @@
+---
+title: Change exception when detaching unattached sources from `NotImplementedError` to `stripe.error.InvalidRequestError`
+pr_url: https://github.com/stripe/stripe-python/pull/415
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-04-24_ob_add-support-flexible.change.md b/.hark/changes/2018-04-24_ob_add-support-flexible.change.md
new file mode 100644
index 000000000..5c2f237b4
--- /dev/null
+++ b/.hark/changes/2018-04-24_ob_add-support-flexible.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for flexible billing and usage records
+pr_url: https://github.com/stripe/stripe-python/pull/421
+released_in_version: 1.80.0
+---
diff --git a/.hark/changes/2018-05-10_brandur_add-support-issuer.change.md b/.hark/changes/2018-05-10_brandur_add-support-issuer.change.md
new file mode 100644
index 000000000..258f9e8d4
--- /dev/null
+++ b/.hark/changes/2018-05-10_brandur_add-support-issuer.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for issuer fraud records
+pr_url: https://github.com/stripe/stripe-python/pull/425
+released_in_version: 1.81.0
+---
diff --git a/.hark/changes/2018-05-14_brandur_add-usermesage-stripeerror.change.md b/.hark/changes/2018-05-14_brandur_add-usermesage-stripeerror.change.md
new file mode 100644
index 000000000..a9ff308d0
--- /dev/null
+++ b/.hark/changes/2018-05-14_brandur_add-usermesage-stripeerror.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `user_mesage` to `StripeError` for a way in Python 3 to avoid the "Request req_...:" string normally appended to error messages
+pr_url: https://github.com/stripe/stripe-python/pull/422
+released_in_version: 1.82.0
+---
diff --git a/.hark/changes/2018-05-14_brandur_handle-case-where.change.md b/.hark/changes/2018-05-14_brandur_handle-case-where.change.md
new file mode 100644
index 000000000..72e6c4311
--- /dev/null
+++ b/.hark/changes/2018-05-14_brandur_handle-case-where.change.md
@@ -0,0 +1,5 @@
+---
+title: Handle the case where request ID is `None` when formatting errors
+pr_url: https://github.com/stripe/stripe-python/pull/430
+released_in_version: 1.82.1
+---
diff --git a/.hark/changes/2018-06-19_ob_add-repr-methods.change.md b/.hark/changes/2018-06-19_ob_add-repr-methods.change.md
new file mode 100644
index 000000000..8c30ce6f4
--- /dev/null
+++ b/.hark/changes/2018-06-19_ob_add-repr-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `__repr__` methods to `StripeError` exception classes
+pr_url: https://github.com/stripe/stripe-python/pull/365
+released_in_version: 1.82.2
+---
diff --git a/.hark/changes/2018-06-28_ob_add-support-partnerid.change.md b/.hark/changes/2018-06-28_ob_add-support-partnerid.change.md
new file mode 100644
index 000000000..0e5c12e4c
--- /dev/null
+++ b/.hark/changes/2018-06-28_ob_add-support-partnerid.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `partner_id` in `stripe.set_app_info()`
+pr_url: https://github.com/stripe/stripe-python/pull/437
+released_in_version: 1.83.0
+---
diff --git a/.hark/changes/2018-06-29_ob_add-support-payment.change.md b/.hark/changes/2018-06-29_ob_add-support-payment.change.md
new file mode 100644
index 000000000..07da26cc8
--- /dev/null
+++ b/.hark/changes/2018-06-29_ob_add-support-payment.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for payment intents
+pr_url: https://github.com/stripe/stripe-python/pull/436
+released_in_version: 1.84.0
+---
diff --git a/.hark/changes/2018-07-04_ob_fix-serializatio-empty.change.md b/.hark/changes/2018-07-04_ob_fix-serializatio-empty.change.md
new file mode 100644
index 000000000..84b2f1141
--- /dev/null
+++ b/.hark/changes/2018-07-04_ob_fix-serializatio-empty.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix serialization of empty `ListObject`s
+pr_url: https://github.com/stripe/stripe-python/pull/439
+released_in_version: 1.84.1
+---
diff --git a/.hark/changes/2018-07-06_ob_better-hopefully-fix.change.md b/.hark/changes/2018-07-06_ob_better-hopefully-fix.change.md
new file mode 100644
index 000000000..5a278dc4a
--- /dev/null
+++ b/.hark/changes/2018-07-06_ob_better-hopefully-fix.change.md
@@ -0,0 +1,5 @@
+---
+title: Better (hopefully) fix for serialization of empty `ListObject`s
+pr_url: https://github.com/stripe/stripe-python/pull/441
+released_in_version: 1.84.2
+---
diff --git a/.hark/changes/2018-07-10_ob_fix-setup-py.change.md b/.hark/changes/2018-07-10_ob_fix-setup-py.change.md
new file mode 100644
index 000000000..195fca9c0
--- /dev/null
+++ b/.hark/changes/2018-07-10_ob_fix-setup-py.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `setup.py`
+pr_url: https://github.com/stripe/stripe-python/pull/445
+released_in_version: 2.0.1
+---
diff --git a/.hark/changes/2018-07-10_unknown_minimum-python-versions.change.md b/.hark/changes/2018-07-10_unknown_minimum-python-versions.change.md
new file mode 100644
index 000000000..a398c154f
--- /dev/null
+++ b/.hark/changes/2018-07-10_unknown_minimum-python-versions.change.md
@@ -0,0 +1,4 @@
+---
+title: The minimum Python versions are now 2.7 / 3.4. If you're using Python 2.6 or 3.3, consider upgrading to a more recent version.
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-07-10_unknown_some-older-deprecated.change.md b/.hark/changes/2018-07-10_unknown_some-older-deprecated.change.md
new file mode 100644
index 000000000..b41cd0609
--- /dev/null
+++ b/.hark/changes/2018-07-10_unknown_some-older-deprecated.change.md
@@ -0,0 +1,4 @@
+---
+title: Some older deprecated methods have been removed
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-07-10_unknown_stripe-exception-classes.change.md b/.hark/changes/2018-07-10_unknown_stripe-exception-classes.change.md
new file mode 100644
index 000000000..3b44c1f88
--- /dev/null
+++ b/.hark/changes/2018-07-10_unknown_stripe-exception-classes.change.md
@@ -0,0 +1,4 @@
+---
+title: Stripe exception classes should now be accessed via `stripe.error` rather than just `stripe`
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-07-10_unknown_trying-detach-unattached.change.md b/.hark/changes/2018-07-10_unknown_trying-detach-unattached.change.md
new file mode 100644
index 000000000..06ee46411
--- /dev/null
+++ b/.hark/changes/2018-07-10_unknown_trying-detach-unattached.change.md
@@ -0,0 +1,4 @@
+---
+title: Trying to detach an unattached source will now raise a `stripe.error.InvalidRequestError` exception instead of a `NotImplementedError` exception
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2018-07-18_ob_avoid-duplicate-dependency.change.md b/.hark/changes/2018-07-18_ob_avoid-duplicate-dependency.change.md
new file mode 100644
index 000000000..7a6a0dd2e
--- /dev/null
+++ b/.hark/changes/2018-07-18_ob_avoid-duplicate-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Avoid duplicate dependency on `requests` with Python 2.7
+pr_url: https://github.com/stripe/stripe-python/pull/448
+released_in_version: 2.0.2
+---
diff --git a/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md b/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md
new file mode 100644
index 000000000..c2083e172
--- /dev/null
+++ b/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md
@@ -0,0 +1,5 @@
+---
+title: Internal improvements to `ApiResource.class_url`
+pr_url: https://github.com/stripe/stripe-python/pull/450
+released_in_version: 2.0.3
+---
diff --git a/.hark/changes/2018-07-25_ob_add-invoicelinei-class.change.md b/.hark/changes/2018-07-25_ob_add-invoicelinei-class.change.md
new file mode 100644
index 000000000..3a67fb3c6
--- /dev/null
+++ b/.hark/changes/2018-07-25_ob_add-invoicelinei-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `InvoiceLineItem` class
+pr_url: https://github.com/stripe/stripe-python/pull/452
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2018-07-26_ob_add-support-stripe.change.md b/.hark/changes/2018-07-26_ob_add-support-stripe.change.md
new file mode 100644
index 000000000..01ecdc870
--- /dev/null
+++ b/.hark/changes/2018-07-26_ob_add-support-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Stripe Issuing
+pr_url: https://github.com/stripe/stripe-python/pull/455
+released_in_version: 2.2.0
+---
diff --git a/.hark/changes/2018-07-27_ob_add-support-sigma.change.md b/.hark/changes/2018-07-27_ob_add-support-sigma.change.md
new file mode 100644
index 000000000..362ae134b
--- /dev/null
+++ b/.hark/changes/2018-07-27_ob_add-support-sigma.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Sigma scheduled query run objects
+pr_url: https://github.com/stripe/stripe-python/pull/456
+released_in_version: 2.3.0
+---
diff --git a/.hark/changes/2018-08-03_ob_add-cancel-support.change.md b/.hark/changes/2018-08-03_ob_add-cancel-support.change.md
new file mode 100644
index 000000000..ca8581ddd
--- /dev/null
+++ b/.hark/changes/2018-08-03_ob_add-cancel-support.change.md
@@ -0,0 +1,5 @@
+---
+title: Add cancel support for topups
+pr_url: https://github.com/stripe/stripe-python/pull/460
+released_in_version: 2.4.0
+---
diff --git a/.hark/changes/2018-08-03_ob_add-support-file.change.md b/.hark/changes/2018-08-03_ob_add-support-file.change.md
new file mode 100644
index 000000000..d66a9c2dd
--- /dev/null
+++ b/.hark/changes/2018-08-03_ob_add-support-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for file links
+pr_url: https://github.com/stripe/stripe-python/pull/461
+released_in_version: 2.4.0
+---
diff --git a/.hark/changes/2018-08-16_brandur_remove-unsupported-bitcoin.change.md b/.hark/changes/2018-08-16_brandur_remove-unsupported-bitcoin.change.md
new file mode 100644
index 000000000..9c5036d57
--- /dev/null
+++ b/.hark/changes/2018-08-16_brandur_remove-unsupported-bitcoin.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove unsupported Bitcoin endpoints (this is technically a breaking change, but we're releasing as a minor version because none of these APIs were usable anyway)
+pr_url: https://github.com/stripe/stripe-python/pull/463
+released_in_version: 2.5.0
+---
diff --git a/.hark/changes/2018-08-23_ob_add-support-usage.change.md b/.hark/changes/2018-08-23_ob_add-support-usage.change.md
new file mode 100644
index 000000000..2ff8cb353
--- /dev/null
+++ b/.hark/changes/2018-08-23_ob_add-support-usage.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for usage record summaries
+pr_url: https://github.com/stripe/stripe-python/pull/467
+released_in_version: 2.6.0
+---
diff --git a/.hark/changes/2018-09-05_ob_add-support-reporting.change.md b/.hark/changes/2018-09-05_ob_add-support-reporting.change.md
new file mode 100644
index 000000000..435650d95
--- /dev/null
+++ b/.hark/changes/2018-09-05_ob_add-support-reporting.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for reporting resources
+pr_url: https://github.com/stripe/stripe-python/pull/469
+released_in_version: 2.7.0
+---
diff --git a/.hark/changes/2018-09-07_mickjermsurawong_add-support-automatic.change.md b/.hark/changes/2018-09-07_mickjermsurawong_add-support-automatic.change.md
new file mode 100644
index 000000000..32e287be3
--- /dev/null
+++ b/.hark/changes/2018-09-07_mickjermsurawong_add-support-automatic.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for automatic network retries
+pr_url: https://github.com/stripe/stripe-python/pull/470
+released_in_version: 2.8.0
+---
diff --git a/.hark/changes/2018-09-13_ob_don-t-url.change.md b/.hark/changes/2018-09-13_ob_don-t-url.change.md
new file mode 100644
index 000000000..300bc2a9b
--- /dev/null
+++ b/.hark/changes/2018-09-13_ob_don-t-url.change.md
@@ -0,0 +1,5 @@
+---
+title: Don't URL-encode square brackets
+pr_url: https://github.com/stripe/stripe-python/pull/474
+released_in_version: 2.8.1
+---
diff --git a/.hark/changes/2018-09-13_ob_integer-index-encode.change.md b/.hark/changes/2018-09-13_ob_integer-index-encode.change.md
new file mode 100644
index 000000000..53b2d5432
--- /dev/null
+++ b/.hark/changes/2018-09-13_ob_integer-index-encode.change.md
@@ -0,0 +1,5 @@
+---
+title: Integer-index encode all arrays
+pr_url: https://github.com/stripe/stripe-python/pull/473
+released_in_version: 2.8.1
+---
diff --git a/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md b/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md
new file mode 100644
index 000000000..b0671d676
--- /dev/null
+++ b/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Stripe Terminal
+pr_url: https://github.com/stripe/stripe-python/pull/478
+released_in_version: 2.10.0
+---
diff --git a/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md b/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md
new file mode 100644
index 000000000..f7f50525b
--- /dev/null
+++ b/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `FileUpload` to `File`
+pr_url: https://github.com/stripe/stripe-python/pull/477
+released_in_version: 2.9.0
+---
diff --git a/.hark/changes/2018-10-02_brandur_correct-behavior-stripe.change.md b/.hark/changes/2018-10-02_brandur_correct-behavior-stripe.change.md
new file mode 100644
index 000000000..191baf82f
--- /dev/null
+++ b/.hark/changes/2018-10-02_brandur_correct-behavior-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Correct behavior of `stripe.max_network_retries` if it's reset after initial use
+pr_url: https://github.com/stripe/stripe-python/pull/481
+released_in_version: 2.10.1
+---
diff --git a/.hark/changes/2018-10-30_remi_add-support-person.change.md b/.hark/changes/2018-10-30_remi_add-support-person.change.md
new file mode 100644
index 000000000..553d12522
--- /dev/null
+++ b/.hark/changes/2018-10-30_remi_add-support-person.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Person` resource
+pr_url: https://github.com/stripe/stripe-python/pull/482
+released_in_version: 2.11.0
+---
diff --git a/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md b/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md
new file mode 100644
index 000000000..9b63d57b8
--- /dev/null
+++ b/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `WebhookEndpoint` resource
+pr_url: https://github.com/stripe/stripe-python/pull/484
+released_in_version: 2.11.0
+---
diff --git a/.hark/changes/2018-11-06_ob_bump-minimum-requests.change.md b/.hark/changes/2018-11-06_ob_bump-minimum-requests.change.md
new file mode 100644
index 000000000..d171f947a
--- /dev/null
+++ b/.hark/changes/2018-11-06_ob_bump-minimum-requests.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump minimum requests version to 2.20.0 (for [CVE-2018-18074](https://nvd.nist.gov/vuln/detail/CVE-2018-18074))
+pr_url: https://github.com/stripe/stripe-python/pull/491
+released_in_version: 2.11.1
+---
diff --git a/.hark/changes/2018-11-09_remi_add-new-api.change.md b/.hark/changes/2018-11-09_remi_add-new-api.change.md
new file mode 100644
index 000000000..ae9e30a9e
--- /dev/null
+++ b/.hark/changes/2018-11-09_remi_add-new-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Add new API endpoints for the `Invoice` resource.
+pr_url: https://github.com/stripe/stripe-python/pull/483
+released_in_version: 2.12.0
+---
diff --git a/.hark/changes/2018-11-22_ob_make-striperespon-new.change.md b/.hark/changes/2018-11-22_ob_make-striperespon-new.change.md
new file mode 100644
index 000000000..0d16db9a2
--- /dev/null
+++ b/.hark/changes/2018-11-22_ob_make-striperespon-new.change.md
@@ -0,0 +1,5 @@
+---
+title: Make `StripeResponse` a new-style class
+pr_url: https://github.com/stripe/stripe-python/pull/495
+released_in_version: 2.12.1
+---
diff --git a/.hark/changes/2018-11-27_ob_add-support-valuelist.change.md b/.hark/changes/2018-11-27_ob_add-support-valuelist.change.md
new file mode 100644
index 000000000..a6cfc159b
--- /dev/null
+++ b/.hark/changes/2018-11-27_ob_add-support-valuelist.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `ValueList` and `ValueListItem` for Radar
+pr_url: https://github.com/stripe/stripe-python/pull/489
+released_in_version: 2.13.0
+---
diff --git a/.hark/changes/2018-11-28_remi_add-support-review.change.md b/.hark/changes/2018-11-28_remi_add-support-review.change.md
new file mode 100644
index 000000000..4717c29db
--- /dev/null
+++ b/.hark/changes/2018-11-28_remi_add-support-review.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `Review` for Radar
+pr_url: https://github.com/stripe/stripe-python/pull/500
+released_in_version: 2.14.0
+---
diff --git a/.hark/changes/2018-11-30_ob_add-support-providing.change.md b/.hark/changes/2018-11-30_ob_add-support-providing.change.md
new file mode 100644
index 000000000..54d4199cc
--- /dev/null
+++ b/.hark/changes/2018-11-30_ob_add-support-providing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for providing custom CA certificate bundle
+pr_url: https://github.com/stripe/stripe-python/pull/503
+released_in_version: 2.15.0
+---
diff --git a/.hark/changes/2018-12-11_ob_add-support-account.change.md b/.hark/changes/2018-12-11_ob_add-support-account.change.md
new file mode 100644
index 000000000..9cffa8cb2
--- /dev/null
+++ b/.hark/changes/2018-12-11_ob_add-support-account.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for account links
+pr_url: https://github.com/stripe/stripe-python/pull/507
+released_in_version: 2.16.0
+---
diff --git a/.hark/changes/2018-12-21_remi_add-support-checkout.change.md b/.hark/changes/2018-12-21_remi_add-support-checkout.change.md
new file mode 100644
index 000000000..0b5d2eaad
--- /dev/null
+++ b/.hark/changes/2018-12-21_remi_add-support-checkout.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Checkout sessions
+pr_url: https://github.com/stripe/stripe-python/pull/510
+released_in_version: 2.17.0
+---
diff --git a/.hark/changes/2019-01-15_ob_add-configurable-telemetry.change.md b/.hark/changes/2019-01-15_ob_add-configurable-telemetry.change.md
new file mode 100644
index 000000000..092afa223
--- /dev/null
+++ b/.hark/changes/2019-01-15_ob_add-configurable-telemetry.change.md
@@ -0,0 +1,5 @@
+---
+title: Add configurable telemetry to gather information on client-side request latency
+pr_url: https://github.com/stripe/stripe-python/pull/518
+released_in_version: 2.18.0
+---
diff --git a/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md b/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md
new file mode 100644
index 000000000..5d265ab55
--- /dev/null
+++ b/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md
@@ -0,0 +1,5 @@
+---
+title: Properly serialize `individual` on `Account` objects
+pr_url: https://github.com/stripe/stripe-python/pull/525
+released_in_version: 2.18.1
+---
diff --git a/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md b/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md
new file mode 100644
index 000000000..ea793985d
--- /dev/null
+++ b/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `CheckoutSession` to `Session` and move it under the `checkout` namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.
+pr_url: https://github.com/stripe/stripe-python/pull/524
+released_in_version: 2.19.0
+---
diff --git a/.hark/changes/2019-01-29_brandur_reuse-default-http.change.md b/.hark/changes/2019-01-29_brandur_reuse-default-http.change.md
new file mode 100644
index 000000000..599799aa4
--- /dev/null
+++ b/.hark/changes/2019-01-29_brandur_reuse-default-http.change.md
@@ -0,0 +1,5 @@
+---
+title: Reuse the default HTTP client by default
+pr_url: https://github.com/stripe/stripe-python/pull/526
+released_in_version: 2.20.0
+---
diff --git a/.hark/changes/2019-01-30_brandur_fix-client-telemetry.change.md b/.hark/changes/2019-01-30_brandur_fix-client-telemetry.change.md
new file mode 100644
index 000000000..e56a49849
--- /dev/null
+++ b/.hark/changes/2019-01-30_brandur_fix-client-telemetry.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix client telemetry implementation
+pr_url: https://github.com/stripe/stripe-python/pull/530
+released_in_version: 2.20.3
+---
diff --git a/.hark/changes/2019-01-30_brandur_fix-session-initializati.change.md b/.hark/changes/2019-01-30_brandur_fix-session-initializati.change.md
new file mode 100644
index 000000000..a6425dd7a
--- /dev/null
+++ b/.hark/changes/2019-01-30_brandur_fix-session-initializati.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix session initialization for multi-threaded environments
+pr_url: https://github.com/stripe/stripe-python/pull/534
+released_in_version: 2.20.2
+---
diff --git a/.hark/changes/2019-01-30_ob_make-requestsclie-thread.change.md b/.hark/changes/2019-01-30_ob_make-requestsclie-thread.change.md
new file mode 100644
index 000000000..8a3b3233a
--- /dev/null
+++ b/.hark/changes/2019-01-30_ob_make-requestsclie-thread.change.md
@@ -0,0 +1,5 @@
+---
+title: Make `RequestsClient` thread-safe
+pr_url: https://github.com/stripe/stripe-python/pull/531
+released_in_version: 2.20.1
+---
diff --git a/.hark/changes/2019-02-12_ob_add-support-subscription.change.md b/.hark/changes/2019-02-12_ob_add-support-subscription.change.md
new file mode 100644
index 000000000..79a709511
--- /dev/null
+++ b/.hark/changes/2019-02-12_ob_add-support-subscription.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for subscription schedules
+pr_url: https://github.com/stripe/stripe-python/pull/532
+released_in_version: 2.21.0
+---
diff --git a/.hark/changes/2019-03-14_ob_add-stripe-util.change.md b/.hark/changes/2019-03-14_ob_add-stripe-util.change.md
new file mode 100644
index 000000000..4ff48044a
--- /dev/null
+++ b/.hark/changes/2019-03-14_ob_add-stripe-util.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `stripe.util.convert_to_dict` method for converting `StripeObject` instances to regular `dict`s
+pr_url: https://github.com/stripe/stripe-python/pull/541
+released_in_version: 2.22.0
+---
diff --git a/.hark/changes/2019-03-19_remi_add-support-deleting.change.md b/.hark/changes/2019-03-19_remi_add-support-deleting.change.md
new file mode 100644
index 000000000..164cf2d5a
--- /dev/null
+++ b/.hark/changes/2019-03-19_remi_add-support-deleting.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for deleting a Terminal `Location` and `Reader`
+pr_url: https://github.com/stripe/stripe-python/pull/542
+released_in_version: 2.23.0
+---
diff --git a/.hark/changes/2019-03-19_remi_add-support-paymentmetho.change.md b/.hark/changes/2019-03-19_remi_add-support-paymentmetho.change.md
new file mode 100644
index 000000000..1a654d062
--- /dev/null
+++ b/.hark/changes/2019-03-19_remi_add-support-paymentmetho.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `PaymentMethod` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/537
+released_in_version: 2.23.0
+---
diff --git a/.hark/changes/2019-03-19_remi_add-support-retrieving.change.md b/.hark/changes/2019-03-19_remi_add-support-retrieving.change.md
new file mode 100644
index 000000000..4bf5b576d
--- /dev/null
+++ b/.hark/changes/2019-03-19_remi_add-support-retrieving.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for retrieving a Checkout `Session`
+pr_url: https://github.com/stripe/stripe-python/pull/540
+released_in_version: 2.23.0
+---
diff --git a/.hark/changes/2019-04-03_ob_add-class-methods.change.md b/.hark/changes/2019-04-03_ob_add-class-methods.change.md
new file mode 100644
index 000000000..8c480888d
--- /dev/null
+++ b/.hark/changes/2019-04-03_ob_add-class-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Add class methods for all custom API requests (e.g. `Charge.capture`)
+pr_url: https://github.com/stripe/stripe-python/pull/547
+released_in_version: 2.24.0
+---
diff --git a/.hark/changes/2019-04-03_ob_add-delete-class.change.md b/.hark/changes/2019-04-03_ob_add-delete-class.change.md
new file mode 100644
index 000000000..4ab9842a9
--- /dev/null
+++ b/.hark/changes/2019-04-03_ob_add-delete-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `delete` class method on deletable API resources
+pr_url: https://github.com/stripe/stripe-python/pull/543
+released_in_version: 2.24.0
+---
diff --git a/.hark/changes/2019-04-08_ob_fix-encoding-nested.change.md b/.hark/changes/2019-04-08_ob_fix-encoding-nested.change.md
new file mode 100644
index 000000000..d7ea32901
--- /dev/null
+++ b/.hark/changes/2019-04-08_ob_fix-encoding-nested.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix encoding of nested parameters in multipart requests
+pr_url: https://github.com/stripe/stripe-python/pull/550
+released_in_version: 2.24.1
+---
diff --git a/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md b/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md
new file mode 100644
index 000000000..2386403cd
--- /dev/null
+++ b/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `CreditNote` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/551
+released_in_version: 2.25.0
+---
diff --git a/.hark/changes/2019-04-22_remi_add-support-taxid.change.md b/.hark/changes/2019-04-22_remi_add-support-taxid.change.md
new file mode 100644
index 000000000..3e0760047
--- /dev/null
+++ b/.hark/changes/2019-04-22_remi_add-support-taxid.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `TaxId` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/555
+released_in_version: 2.26.0
+---
diff --git a/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md b/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md
new file mode 100644
index 000000000..9d9b6b4af
--- /dev/null
+++ b/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `TaxRate` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/554
+released_in_version: 2.27.0
+---
diff --git a/.hark/changes/2019-05-14_ob_add-support-capability.change.md b/.hark/changes/2019-05-14_ob_add-support-capability.change.md
new file mode 100644
index 000000000..66805ec73
--- /dev/null
+++ b/.hark/changes/2019-05-14_ob_add-support-capability.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Capability` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/566
+released_in_version: 2.28.0
+---
diff --git a/.hark/changes/2019-05-20_ob_fix-few-code.change.md b/.hark/changes/2019-05-20_ob_fix-few-code.change.md
new file mode 100644
index 000000000..66d298fa2
--- /dev/null
+++ b/.hark/changes/2019-05-20_ob_fix-few-code.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix a few code quality issues
+pr_url: https://github.com/stripe/stripe-python/pull/572
+released_in_version: 2.28.1
+---
diff --git a/.hark/changes/2019-05-23_ob_add-support-radar.change.md b/.hark/changes/2019-05-23_ob_add-support-radar.change.md
new file mode 100644
index 000000000..cf5d05b53
--- /dev/null
+++ b/.hark/changes/2019-05-23_ob_add-support-radar.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `radar.early_fraud_warning` resource
+pr_url: https://github.com/stripe/stripe-python/pull/575
+released_in_version: 2.29.0
+---
diff --git a/.hark/changes/2019-05-23_ob_fix-few-more.change.md b/.hark/changes/2019-05-23_ob_fix-few-more.change.md
new file mode 100644
index 000000000..fc0fa81eb
--- /dev/null
+++ b/.hark/changes/2019-05-23_ob_fix-few-more.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix a few more code quality issues
+pr_url: https://github.com/stripe/stripe-python/pull/574
+released_in_version: 2.28.2
+---
diff --git a/.hark/changes/2019-05-31_ob_replace-pipenv-poetry.change.md b/.hark/changes/2019-05-31_ob_replace-pipenv-poetry.change.md
new file mode 100644
index 000000000..16589dae4
--- /dev/null
+++ b/.hark/changes/2019-05-31_ob_replace-pipenv-poetry.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace pipenv with poetry
+pr_url: https://github.com/stripe/stripe-python/pull/561
+released_in_version: 2.29.2
+---
diff --git a/.hark/changes/2019-05-31_ob_verify-signatures-before.change.md b/.hark/changes/2019-05-31_ob_verify-signatures-before.change.md
new file mode 100644
index 000000000..d46575c31
--- /dev/null
+++ b/.hark/changes/2019-05-31_ob_verify-signatures-before.change.md
@@ -0,0 +1,5 @@
+---
+title: Verify signatures before deserializing events
+pr_url: https://github.com/stripe/stripe-python/pull/578
+released_in_version: 2.29.1
+---
diff --git a/.hark/changes/2019-06-03_ob_remove-poetry-reinstate.change.md b/.hark/changes/2019-06-03_ob_remove-poetry-reinstate.change.md
new file mode 100644
index 000000000..ecadfb897
--- /dev/null
+++ b/.hark/changes/2019-06-03_ob_remove-poetry-reinstate.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove Poetry and reinstate `setup.py`
+pr_url: https://github.com/stripe/stripe-python/pull/583
+released_in_version: 2.29.4
+---
diff --git a/.hark/changes/2019-06-17_ob_add-support-customerbala.change.md b/.hark/changes/2019-06-17_ob_add-support-customerbala.change.md
new file mode 100644
index 000000000..8fae09a3b
--- /dev/null
+++ b/.hark/changes/2019-06-17_ob_add-support-customerbala.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CustomerBalanceTransaction` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/564
+released_in_version: 2.30.0
+---
diff --git a/.hark/changes/2019-06-21_remi_fix-support-customerbala.change.md b/.hark/changes/2019-06-21_remi_fix-support-customerbala.change.md
new file mode 100644
index 000000000..98b7ed10b
--- /dev/null
+++ b/.hark/changes/2019-06-21_remi_fix-support-customerbala.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix support for `CustomerBalanceTransaction`
+pr_url: https://github.com/stripe/stripe-python/pull/589
+released_in_version: 2.30.1
+---
diff --git a/.hark/changes/2019-06-25_ob_enable-request-latency.change.md b/.hark/changes/2019-06-25_ob_enable-request-latency.change.md
new file mode 100644
index 000000000..ebfb1d970
--- /dev/null
+++ b/.hark/changes/2019-06-25_ob_enable-request-latency.change.md
@@ -0,0 +1,5 @@
+---
+title: Enable request latency telemetry by default
+pr_url: https://github.com/stripe/stripe-python/pull/587
+released_in_version: 2.31.0
+---
diff --git a/.hark/changes/2019-06-27_remi_add-support-setupintent.change.md b/.hark/changes/2019-06-27_remi_add-support-setupintent.change.md
new file mode 100644
index 000000000..a2a494403
--- /dev/null
+++ b/.hark/changes/2019-06-27_remi_add-support-setupintent.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `SetupIntent` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/590
+released_in_version: 2.32.0
+---
diff --git a/.hark/changes/2019-07-08_ob_fix-argument-name.change.md b/.hark/changes/2019-07-08_ob_fix-argument-name.change.md
new file mode 100644
index 000000000..97ea684af
--- /dev/null
+++ b/.hark/changes/2019-07-08_ob_fix-argument-name.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix argument name conflict
+pr_url: https://github.com/stripe/stripe-python/pull/592
+released_in_version: 2.32.1
+---
diff --git a/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md b/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md
new file mode 100644
index 000000000..2f65f7939
--- /dev/null
+++ b/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md
@@ -0,0 +1,5 @@
+---
+title: Listing `BalanceTransaction` objects now uses `/v1/balance_transactions` instead of `/v1/balance/history`
+pr_url: https://github.com/stripe/stripe-python/pull/595
+released_in_version: 2.33.0
+---
diff --git a/.hark/changes/2019-08-06_ob_add-support-passing.change.md b/.hark/changes/2019-08-06_ob_add-support-passing.change.md
new file mode 100644
index 000000000..735fd35e9
--- /dev/null
+++ b/.hark/changes/2019-08-06_ob_add-support-passing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for passing full objects instead of IDs to custom methods
+pr_url: https://github.com/stripe/stripe-python/pull/601
+released_in_version: 2.33.2
+---
diff --git a/.hark/changes/2019-08-06_ob_bump-vendored-six.change.md b/.hark/changes/2019-08-06_ob_bump-vendored-six.change.md
new file mode 100644
index 000000000..e70d2800f
--- /dev/null
+++ b/.hark/changes/2019-08-06_ob_bump-vendored-six.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump vendored six to latest version
+pr_url: https://github.com/stripe/stripe-python/pull/603
+released_in_version: 2.33.2
+---
diff --git a/.hark/changes/2019-08-06_ob_fix-del-statement.change.md b/.hark/changes/2019-08-06_ob_fix-del-statement.change.md
new file mode 100644
index 000000000..653bae5f9
--- /dev/null
+++ b/.hark/changes/2019-08-06_ob_fix-del-statement.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `del` statement to not raise `KeyError`
+pr_url: https://github.com/stripe/stripe-python/pull/599
+released_in_version: 2.33.1
+---
diff --git a/.hark/changes/2019-08-09_rattrayalex_remove-subscription-schedule.change.md b/.hark/changes/2019-08-09_rattrayalex_remove-subscription-schedule.change.md
new file mode 100644
index 000000000..8e6d2228d
--- /dev/null
+++ b/.hark/changes/2019-08-09_rattrayalex_remove-subscription-schedule.change.md
@@ -0,0 +1,7 @@
+---
+title: Remove subscription schedule revisions
+pr_url: https://github.com/stripe/stripe-python/pull/604
+released_in_version: 2.34.0
+---
+
+- This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
diff --git a/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md b/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md
new file mode 100644
index 000000000..6dd42038f
--- /dev/null
+++ b/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `SubscriptionItem.create_usage_record` method
+pr_url: https://github.com/stripe/stripe-python/pull/607
+released_in_version: 2.35.0
+---
diff --git a/.hark/changes/2019-08-14_brandur_clarify-what-maxnetworkre.change.md b/.hark/changes/2019-08-14_brandur_clarify-what-maxnetworkre.change.md
new file mode 100644
index 000000000..ed15bcd05
--- /dev/null
+++ b/.hark/changes/2019-08-14_brandur_clarify-what-maxnetworkre.change.md
@@ -0,0 +1,5 @@
+---
+title: Clarify what `max_network_retries` does
+pr_url: https://github.com/stripe/stripe-python/pull/606
+released_in_version: 2.35.1
+---
diff --git a/.hark/changes/2019-08-20_ob_fix-automatic-retries.change.md b/.hark/changes/2019-08-20_ob_fix-automatic-retries.change.md
new file mode 100644
index 000000000..5e34cd942
--- /dev/null
+++ b/.hark/changes/2019-08-20_ob_fix-automatic-retries.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix automatic retries of failed requests
+pr_url: https://github.com/stripe/stripe-python/pull/605
+released_in_version: 2.35.1
+---
diff --git a/.hark/changes/2019-09-10_ob_add-support-header.change.md b/.hark/changes/2019-09-10_ob_add-support-header.change.md
new file mode 100644
index 000000000..a20bb99ce
--- /dev/null
+++ b/.hark/changes/2019-09-10_ob_add-support-header.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for header parameters in `ListObject` request methods
+pr_url: https://github.com/stripe/stripe-python/pull/610
+released_in_version: 2.36.0
+---
diff --git a/.hark/changes/2019-09-11_ob_use-listobject-properties.change.md b/.hark/changes/2019-09-11_ob_use-listobject-properties.change.md
new file mode 100644
index 000000000..38d58faa2
--- /dev/null
+++ b/.hark/changes/2019-09-11_ob_use-listobject-properties.change.md
@@ -0,0 +1,5 @@
+---
+title: Use `ListObject` properties as default values in request methods
+pr_url: https://github.com/stripe/stripe-python/pull/612
+released_in_version: 2.36.1
+---
diff --git a/.hark/changes/2019-09-12_ob_use-ordereddict-maintain.change.md b/.hark/changes/2019-09-12_ob_use-ordereddict-maintain.change.md
new file mode 100644
index 000000000..345a84690
--- /dev/null
+++ b/.hark/changes/2019-09-12_ob_use-ordereddict-maintain.change.md
@@ -0,0 +1,5 @@
+---
+title: Use `OrderedDict` to maintain key order in API requests and responses
+pr_url: https://github.com/stripe/stripe-python/pull/614
+released_in_version: 2.36.2
+---
diff --git a/.hark/changes/2019-09-14_ob_pass-cflags-ldflags.change.md b/.hark/changes/2019-09-14_ob_pass-cflags-ldflags.change.md
new file mode 100644
index 000000000..80b5e47a0
--- /dev/null
+++ b/.hark/changes/2019-09-14_ob_pass-cflags-ldflags.change.md
@@ -0,0 +1,5 @@
+---
+title: Pass `CFLAGS` and `LDFLAGS` when running tests
+pr_url: https://github.com/stripe/stripe-python/pull/616
+released_in_version: 2.37.0
+---
diff --git a/.hark/changes/2019-09-26_ob_add-errorobject-stripeerror.change.md b/.hark/changes/2019-09-26_ob_add-errorobject-stripeerror.change.md
new file mode 100644
index 000000000..c510da550
--- /dev/null
+++ b/.hark/changes/2019-09-26_ob_add-errorobject-stripeerror.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `ErrorObject` to `StripeError` exceptions
+pr_url: https://github.com/stripe/stripe-python/pull/619
+released_in_version: 2.37.0
+---
diff --git a/.hark/changes/2019-09-26_ob_check-error-dict.change.md b/.hark/changes/2019-09-26_ob_check-error-dict.change.md
new file mode 100644
index 000000000..d7dd2efc1
--- /dev/null
+++ b/.hark/changes/2019-09-26_ob_check-error-dict.change.md
@@ -0,0 +1,5 @@
+---
+title: Check that `error` is a dict before trying to use it to create a `StripeError`
+pr_url: https://github.com/stripe/stripe-python/pull/620
+released_in_version: 2.37.1
+---
diff --git a/.hark/changes/2019-10-05_rattrayalex_implement-support-stripe.change.md b/.hark/changes/2019-10-05_rattrayalex_implement-support-stripe.change.md
new file mode 100644
index 000000000..e543b83d8
--- /dev/null
+++ b/.hark/changes/2019-10-05_rattrayalex_implement-support-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Implement support for stripe-should-retry and retry-after headers
+pr_url: https://github.com/stripe/stripe-python/pull/621
+released_in_version: 2.37.2
+---
diff --git a/.hark/changes/2019-10-24_ob_contributor-convenant.change.md b/.hark/changes/2019-10-24_ob_contributor-convenant.change.md
new file mode 100644
index 000000000..6a3878b69
--- /dev/null
+++ b/.hark/changes/2019-10-24_ob_contributor-convenant.change.md
@@ -0,0 +1,5 @@
+---
+title: Contributor Convenant
+pr_url: https://github.com/stripe/stripe-python/pull/624
+released_in_version: 2.38.0
+---
diff --git a/.hark/changes/2019-10-29_ob_add-support-reverse.change.md b/.hark/changes/2019-10-29_ob_add-support-reverse.change.md
new file mode 100644
index 000000000..ecac1f838
--- /dev/null
+++ b/.hark/changes/2019-10-29_ob_add-support-reverse.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for reverse pagination
+pr_url: https://github.com/stripe/stripe-python/pull/623
+released_in_version: 2.38.0
+---
diff --git a/.hark/changes/2019-11-06_ob_add-support-mandate.change.md b/.hark/changes/2019-11-06_ob_add-support-mandate.change.md
new file mode 100644
index 000000000..8ba5aac23
--- /dev/null
+++ b/.hark/changes/2019-11-06_ob_add-support-mandate.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `Mandate`
+pr_url: https://github.com/stripe/stripe-python/pull/625
+released_in_version: 2.39.0
+---
diff --git a/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md b/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md
new file mode 100644
index 000000000..6faf128b9
--- /dev/null
+++ b/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md
@@ -0,0 +1,5 @@
+---
+title: Add list_usage_record_summaries and list_source_transactions
+pr_url: https://github.com/stripe/stripe-python/pull/627
+released_in_version: 2.40.0
+---
diff --git a/.hark/changes/2019-11-26_remi_add-support-creditnote.change.md b/.hark/changes/2019-11-26_remi_add-support-creditnote.change.md
new file mode 100644
index 000000000..96d45052d
--- /dev/null
+++ b/.hark/changes/2019-11-26_remi_add-support-creditnote.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CreditNote` preview
+pr_url: https://github.com/stripe/stripe-python/pull/630
+released_in_version: 2.41.0
+---
diff --git a/.hark/changes/2019-12-03_ob_update-proxy-py.change.md b/.hark/changes/2019-12-03_ob_update-proxy-py.change.md
new file mode 100644
index 000000000..ee2215ae4
--- /dev/null
+++ b/.hark/changes/2019-12-03_ob_update-proxy-py.change.md
@@ -0,0 +1,5 @@
+---
+title: Update `proxy.py`
+pr_url: https://github.com/stripe/stripe-python/pull/631
+released_in_version: 2.41.1
+---
diff --git a/.hark/changes/2019-12-23_remi_update-python-api.change.md b/.hark/changes/2019-12-23_remi_update-python-api.change.md
new file mode 100644
index 000000000..d225364ef
--- /dev/null
+++ b/.hark/changes/2019-12-23_remi_update-python-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Update Python API docs inline link
+pr_url: https://github.com/stripe/stripe-python/pull/635
+released_in_version: 2.41.1
+---
diff --git a/.hark/changes/2019-12-31_ob_fix-uploading-files.change.md b/.hark/changes/2019-12-31_ob_fix-uploading-files.change.md
new file mode 100644
index 000000000..4e63e89c9
--- /dev/null
+++ b/.hark/changes/2019-12-31_ob_fix-uploading-files.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix uploading files with Unicode names (Python 2.7)
+pr_url: https://github.com/stripe/stripe-python/pull/636
+released_in_version: 2.41.1
+---
diff --git a/.hark/changes/2020-01-07_ob_start-testing-python.change.md b/.hark/changes/2020-01-07_ob_start-testing-python.change.md
new file mode 100644
index 000000000..992ef8860
--- /dev/null
+++ b/.hark/changes/2020-01-07_ob_start-testing-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Start testing Python 3.8
+pr_url: https://github.com/stripe/stripe-python/pull/637
+released_in_version: 2.42.0
+---
diff --git a/.hark/changes/2020-01-14_ob_add-support-creditnoteli.change.md b/.hark/changes/2020-01-14_ob_add-support-creditnoteli.change.md
new file mode 100644
index 000000000..513176930
--- /dev/null
+++ b/.hark/changes/2020-01-14_ob_add-support-creditnoteli.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CreditNoteLineItem`
+pr_url: https://github.com/stripe/stripe-python/pull/640
+released_in_version: 2.42.0
+---
diff --git a/.hark/changes/2020-01-14_ob_pin-black-version.change.md b/.hark/changes/2020-01-14_ob_pin-black-version.change.md
new file mode 100644
index 000000000..907bfc259
--- /dev/null
+++ b/.hark/changes/2020-01-14_ob_pin-black-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Pin black version
+pr_url: https://github.com/stripe/stripe-python/pull/639
+released_in_version: 2.42.0
+---
diff --git a/.hark/changes/2020-02-26_remi_add-support-listing.change.md b/.hark/changes/2020-02-26_remi_add-support-listing.change.md
new file mode 100644
index 000000000..2082a0ee1
--- /dev/null
+++ b/.hark/changes/2020-02-26_remi_add-support-listing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for listing Checkout `Session`
+pr_url: https://github.com/stripe/stripe-python/pull/644
+released_in_version: 2.43.0
+---
diff --git a/.hark/changes/2020-03-23_ob_allow-overriding-api.change.md b/.hark/changes/2020-03-23_ob_allow-overriding-api.change.md
new file mode 100644
index 000000000..2cf46afb3
--- /dev/null
+++ b/.hark/changes/2020-03-23_ob_allow-overriding-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Allow overriding API key in OAuth methods
+pr_url: https://github.com/stripe/stripe-python/pull/646
+released_in_version: 2.44.0
+---
diff --git a/.hark/changes/2020-04-06_ob_add-support-express.change.md b/.hark/changes/2020-04-06_ob_add-support-express.change.md
new file mode 100644
index 000000000..f7c7c6226
--- /dev/null
+++ b/.hark/changes/2020-04-06_ob_add-support-express.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Express links in `authorize_url` for `OAuth`
+pr_url: https://github.com/stripe/stripe-python/pull/648
+released_in_version: 2.45.0
+---
diff --git a/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md b/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md
new file mode 100644
index 000000000..f3b6d3d89
--- /dev/null
+++ b/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `billing_portal` namespace and `Session` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/651
+released_in_version: 2.46.0
+---
diff --git a/.hark/changes/2020-04-29_remi_add-support-price.change.md b/.hark/changes/2020-04-29_remi_add-support-price.change.md
new file mode 100644
index 000000000..a49a793a1
--- /dev/null
+++ b/.hark/changes/2020-04-29_remi_add-support-price.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Price` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/652
+released_in_version: 2.47.0
+---
diff --git a/.hark/changes/2020-05-12_remi_add-support-lineitem.change.md b/.hark/changes/2020-05-12_remi_add-support-lineitem.change.md
new file mode 100644
index 000000000..551f2e00f
--- /dev/null
+++ b/.hark/changes/2020-05-12_remi_add-support-lineitem.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `LineItem` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/655
+released_in_version: 2.48.0
+---
diff --git a/.hark/changes/2020-07-13_richardm_support-stripe-file.change.md b/.hark/changes/2020-07-13_richardm_support-stripe-file.change.md
new file mode 100644
index 000000000..0608d0798
--- /dev/null
+++ b/.hark/changes/2020-07-13_richardm_support-stripe-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Support stripe.File.create(stripe_version='...')
+pr_url: https://github.com/stripe/stripe-python/pull/665
+released_in_version: 2.49.0
+---
diff --git a/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md b/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md
new file mode 100644
index 000000000..fe2273acc
--- /dev/null
+++ b/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `PromotionCode` resource and APIs
+pr_url: https://github.com/stripe/stripe-python/pull/669
+released_in_version: 2.50.0
+---
diff --git a/.hark/changes/2020-09-02_remi_add-support-issuing.change.md b/.hark/changes/2020-09-02_remi_add-support-issuing.change.md
new file mode 100644
index 000000000..31edf2d32
--- /dev/null
+++ b/.hark/changes/2020-09-02_remi_add-support-issuing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Issuing Dispute Submit API
+pr_url: https://github.com/stripe/stripe-python/pull/676
+released_in_version: 2.51.0
+---
diff --git a/.hark/changes/2020-09-29_unknown_2-52-0.change.md b/.hark/changes/2020-09-29_unknown_2-52-0.change.md
new file mode 100644
index 000000000..ef2dd30d5
--- /dev/null
+++ b/.hark/changes/2020-09-29_unknown_2-52-0.change.md
@@ -0,0 +1,4 @@
+---
+title: 2.52.0 and 2.53.0 were empty releases that contained no additional changes.
+released_in_version: 2.54.0
+---
diff --git a/.hark/changes/2020-09-30_remi_add-support-setupattempt.change.md b/.hark/changes/2020-09-30_remi_add-support-setupattempt.change.md
new file mode 100644
index 000000000..11c100b3c
--- /dev/null
+++ b/.hark/changes/2020-09-30_remi_add-support-setupattempt.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `SetupAttempt` resource and List API
+pr_url: https://github.com/stripe/stripe-python/pull/681
+released_in_version: 2.54.0
+---
diff --git a/.hark/changes/2020-10-14_remi_add-support-payout.change.md b/.hark/changes/2020-10-14_remi_add-support-payout.change.md
new file mode 100644
index 000000000..db6daf70a
--- /dev/null
+++ b/.hark/changes/2020-10-14_remi_add-support-payout.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Payout Reverse API
+pr_url: https://github.com/stripe/stripe-python/pull/684
+released_in_version: 2.55.0
+---
diff --git a/.hark/changes/2020-11-20_richardm_include-examples-built.change.md b/.hark/changes/2020-11-20_richardm_include-examples-built.change.md
new file mode 100644
index 000000000..2c286a286
--- /dev/null
+++ b/.hark/changes/2020-11-20_richardm_include-examples-built.change.md
@@ -0,0 +1,5 @@
+---
+title: Include the examples in the built sources
+pr_url: https://github.com/stripe/stripe-python/pull/691
+released_in_version: 2.55.1
+---
diff --git a/.hark/changes/2020-12-01_ob_start-testing-python.change.md b/.hark/changes/2020-12-01_ob_start-testing-python.change.md
new file mode 100644
index 000000000..77af33753
--- /dev/null
+++ b/.hark/changes/2020-12-01_ob_start-testing-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Start testing Python 3.9
+pr_url: https://github.com/stripe/stripe-python/pull/699
+released_in_version: 2.55.1
+---
diff --git a/.hark/changes/2020-12-01_remi_fix-issue-where.change.md b/.hark/changes/2020-12-01_remi_fix-issue-where.change.md
new file mode 100644
index 000000000..6415d0a23
--- /dev/null
+++ b/.hark/changes/2020-12-01_remi_fix-issue-where.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix issue where StripeObjects in lists would not be converted to dicts
+pr_url: https://github.com/stripe/stripe-python/pull/698
+released_in_version: 2.55.1
+---
diff --git a/.hark/changes/2021-02-04_ob_fix-ca-bundle.change.md b/.hark/changes/2021-02-04_ob_fix-ca-bundle.change.md
new file mode 100644
index 000000000..5f70132fe
--- /dev/null
+++ b/.hark/changes/2021-02-04_ob_fix-ca-bundle.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix CA bundle path issue
+pr_url: https://github.com/stripe/stripe-python/pull/704
+released_in_version: 2.55.2
+---
diff --git a/.hark/changes/2021-02-20_richardm_add-support-billing.change.md b/.hark/changes/2021-02-20_richardm_add-support-billing.change.md
new file mode 100644
index 000000000..cbbe05089
--- /dev/null
+++ b/.hark/changes/2021-02-20_richardm_add-support-billing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Billing Portal Configuration API
+pr_url: https://github.com/stripe/stripe-python/pull/713
+released_in_version: 2.56.0
+---
diff --git a/.hark/changes/2021-05-19_seang_add-support-identity.change.md b/.hark/changes/2021-05-19_seang_add-support-identity.change.md
new file mode 100644
index 000000000..9200296fc
--- /dev/null
+++ b/.hark/changes/2021-05-19_seang_add-support-identity.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Identity VerificationSession and VerificationReport APIs
+pr_url: https://github.com/stripe/stripe-python/pull/720
+released_in_version: 2.57.0
+---
diff --git a/.hark/changes/2021-06-04_richardm_api-updates.change.md b/.hark/changes/2021-06-04_richardm_api-updates.change.md
new file mode 100644
index 000000000..99c1258b1
--- /dev/null
+++ b/.hark/changes/2021-06-04_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/722
+is_stripe_api_change: true
+released_in_version: 2.58.0
+---
+
+* Add support for new `TaxCode` API.
diff --git a/.hark/changes/2021-07-09_richardm_725-add-support.change.md b/.hark/changes/2021-07-09_richardm_725-add-support.change.md
new file mode 100644
index 000000000..d9dc58085
--- /dev/null
+++ b/.hark/changes/2021-07-09_richardm_725-add-support.change.md
@@ -0,0 +1,5 @@
+---
+title: "[#725](https://github.com/stripe/stripe-python/pull/725) Add support for new `Quote` API."
+pr_url: https://github.com/stripe/stripe-python/pull/727
+released_in_version: 2.59.0
+---
diff --git a/.hark/changes/2021-07-14_dcr_api-updates.change.md b/.hark/changes/2021-07-14_dcr_api-updates.change.md
new file mode 100644
index 000000000..170907138
--- /dev/null
+++ b/.hark/changes/2021-07-14_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/728
+is_stripe_api_change: true
+released_in_version: 2.60.0
+---
+
+* Add support for `list_computed_upfront_line_items` method on resource `Quote`
diff --git a/.hark/changes/2021-10-08_dcr_stop-sending-raw.change.md b/.hark/changes/2021-10-08_dcr_stop-sending-raw.change.md
new file mode 100644
index 000000000..385347fcf
--- /dev/null
+++ b/.hark/changes/2021-10-08_dcr_stop-sending-raw.change.md
@@ -0,0 +1,5 @@
+---
+title: Stop sending raw exception message as part of Stripe user agent.
+pr_url: https://github.com/stripe/stripe-python/pull/736
+released_in_version: 2.61.0
+---
diff --git a/.hark/changes/2021-10-11_richardm_api-updates.change.md b/.hark/changes/2021-10-11_richardm_api-updates.change.md
new file mode 100644
index 000000000..b04f52cc2
--- /dev/null
+++ b/.hark/changes/2021-10-11_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/738
+is_stripe_api_change: true
+released_in_version: 2.61.0
+---
+
+* Add support for `list_payment_methods` method on resource `Customer`
diff --git a/.hark/changes/2021-11-11_richardm_api-updates.change.md b/.hark/changes/2021-11-11_richardm_api-updates.change.md
new file mode 100644
index 000000000..30a138e92
--- /dev/null
+++ b/.hark/changes/2021-11-11_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/745
+is_stripe_api_change: true
+released_in_version: 2.62.0
+---
+
+* Add support for `expire` method on resource `Checkout.Session`
diff --git a/.hark/changes/2021-11-16_dcr_api-updates.change.md b/.hark/changes/2021-11-16_dcr_api-updates.change.md
new file mode 100644
index 000000000..236bfe1b8
--- /dev/null
+++ b/.hark/changes/2021-11-16_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/748
+is_stripe_api_change: true
+released_in_version: 2.63.0
+---
+
+* Add support for new resource `ShippingRate`
diff --git a/.hark/changes/2021-12-09_dcr_clarify-metadata-deletion.change.md b/.hark/changes/2021-12-09_dcr_clarify-metadata-deletion.change.md
new file mode 100644
index 000000000..175a464b3
--- /dev/null
+++ b/.hark/changes/2021-12-09_dcr_clarify-metadata-deletion.change.md
@@ -0,0 +1,5 @@
+---
+title: Clarify metadata deletion message.
+pr_url: https://github.com/stripe/stripe-python/pull/754
+released_in_version: 2.64.0
+---
diff --git a/.hark/changes/2021-12-21_dcr_introduce-custom-listing.change.md b/.hark/changes/2021-12-21_dcr_introduce-custom-listing.change.md
new file mode 100644
index 000000000..acd6f5054
--- /dev/null
+++ b/.hark/changes/2021-12-21_dcr_introduce-custom-listing.change.md
@@ -0,0 +1,5 @@
+---
+title: Introduce custom listing methods on objects.
+pr_url: https://github.com/stripe/stripe-python/pull/756
+released_in_version: 2.64.0
+---
diff --git a/.hark/changes/2021-12-21_dcr_update-class-custom.change.md b/.hark/changes/2021-12-21_dcr_update-class-custom.change.md
new file mode 100644
index 000000000..a5f63e774
--- /dev/null
+++ b/.hark/changes/2021-12-21_dcr_update-class-custom.change.md
@@ -0,0 +1,5 @@
+---
+title: Update class custom methods to save list object parameters.
+pr_url: https://github.com/stripe/stripe-python/pull/757
+released_in_version: 2.64.0
+---
diff --git a/.hark/changes/2022-01-19_richardm_start-testing-python.change.md b/.hark/changes/2022-01-19_richardm_start-testing-python.change.md
new file mode 100644
index 000000000..dcce8becd
--- /dev/null
+++ b/.hark/changes/2022-01-19_richardm_start-testing-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Start testing Python 3.10
+pr_url: https://github.com/stripe/stripe-python/pull/763
+released_in_version: 2.65.0
+---
diff --git a/.hark/changes/2022-01-20_richardm_api-updates.change.md b/.hark/changes/2022-01-20_richardm_api-updates.change.md
new file mode 100644
index 000000000..f94bbcf53
--- /dev/null
+++ b/.hark/changes/2022-01-20_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/766
+is_stripe_api_change: true
+released_in_version: 2.65.0
+---
+
+* Add support for new resource `PaymentLink`
diff --git a/.hark/changes/2022-02-15_richardm_api-updates.change.md b/.hark/changes/2022-02-15_richardm_api-updates.change.md
new file mode 100644
index 000000000..8126b4b48
--- /dev/null
+++ b/.hark/changes/2022-02-15_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/771
+is_stripe_api_change: true
+released_in_version: 2.66.0
+---
+
+* Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
diff --git a/.hark/changes/2022-03-01_richardm_api-updates.change.md b/.hark/changes/2022-03-01_richardm_api-updates.change.md
new file mode 100644
index 000000000..3aa7ca421
--- /dev/null
+++ b/.hark/changes/2022-03-01_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/774
+is_stripe_api_change: true
+released_in_version: 2.67.0
+---
+
+* Add support for new resource `TestHelpers.TestClock`
diff --git a/.hark/changes/2022-03-17_dcr_add-support-searchresult.change.md b/.hark/changes/2022-03-17_dcr_add-support-searchresult.change.md
new file mode 100644
index 000000000..e92a540c6
--- /dev/null
+++ b/.hark/changes/2022-03-17_dcr_add-support-searchresult.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for SearchResult.
+pr_url: https://github.com/stripe/stripe-python/pull/777
+released_in_version: 2.68.0
+---
diff --git a/.hark/changes/2022-03-23_dcr_api-updates.change.md b/.hark/changes/2022-03-23_dcr_api-updates.change.md
new file mode 100644
index 000000000..60b769383
--- /dev/null
+++ b/.hark/changes/2022-03-23_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/781
+is_stripe_api_change: true
+released_in_version: 2.68.0
+---
+
+* Add support for `cancel` method on resource `Refund`
diff --git a/.hark/changes/2022-03-25_pakrym_add-infrastructu-test.change.md b/.hark/changes/2022-03-25_pakrym_add-infrastructu-test.change.md
new file mode 100644
index 000000000..ee6f20517
--- /dev/null
+++ b/.hark/changes/2022-03-25_pakrym_add-infrastructu-test.change.md
@@ -0,0 +1,5 @@
+---
+title: Add infrastructure for test-helper methods
+pr_url: https://github.com/stripe/stripe-python/pull/773
+released_in_version: 2.69.0
+---
diff --git a/.hark/changes/2022-03-25_pakrym_revert-orders-use.change.md b/.hark/changes/2022-03-25_pakrym_revert-orders-use.change.md
new file mode 100644
index 000000000..159ea94db
--- /dev/null
+++ b/.hark/changes/2022-03-25_pakrym_revert-orders-use.change.md
@@ -0,0 +1,5 @@
+---
+title: Revert Orders to use qualified name for upload_api_base
+pr_url: https://github.com/stripe/stripe-python/pull/782
+released_in_version: 2.69.0
+---
diff --git a/.hark/changes/2022-03-28_pakrym_api-updates.change.md b/.hark/changes/2022-03-28_pakrym_api-updates.change.md
new file mode 100644
index 000000000..e857e32e9
--- /dev/null
+++ b/.hark/changes/2022-03-28_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/783
+is_stripe_api_change: true
+released_in_version: 2.69.0
+---
+
+* Add support for Search API
+  * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
diff --git a/.hark/changes/2022-03-28_pakrym_pin-click-dependency.change.md b/.hark/changes/2022-03-28_pakrym_pin-click-dependency.change.md
new file mode 100644
index 000000000..e252d5f22
--- /dev/null
+++ b/.hark/changes/2022-03-28_pakrym_pin-click-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Pin click dependency to 8.0.4 to avoid breakage in black
+pr_url: https://github.com/stripe/stripe-python/pull/784
+released_in_version: 2.69.0
+---
diff --git a/.hark/changes/2022-03-29_pakrym_api-updates.change.md b/.hark/changes/2022-03-29_pakrym_api-updates.change.md
new file mode 100644
index 000000000..51d2d32ac
--- /dev/null
+++ b/.hark/changes/2022-03-29_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/785
+is_stripe_api_change: true
+released_in_version: 2.70.0
+---
+
+* Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
diff --git a/.hark/changes/2022-04-08_kamil_api-updates.change.md b/.hark/changes/2022-04-08_kamil_api-updates.change.md
new file mode 100644
index 000000000..730846297
--- /dev/null
+++ b/.hark/changes/2022-04-08_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/788
+is_stripe_api_change: true
+released_in_version: 2.71.0
+---
+
+* Add support for `apply_customer_balance` method on resource `PaymentIntent`
diff --git a/.hark/changes/2022-04-13_richardm_api-updates.change.md b/.hark/changes/2022-04-13_richardm_api-updates.change.md
new file mode 100644
index 000000000..e89f5ec4d
--- /dev/null
+++ b/.hark/changes/2022-04-13_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/791
+is_stripe_api_change: true
+released_in_version: 2.72.0
+---
+
+* Add support for `increment_authorization` method on resource `PaymentIntent`
diff --git a/.hark/changes/2022-04-15_richardm_794-795-api.change.md b/.hark/changes/2022-04-15_richardm_794-795-api.change.md
new file mode 100644
index 000000000..ed535defb
--- /dev/null
+++ b/.hark/changes/2022-04-15_richardm_794-795-api.change.md
@@ -0,0 +1,7 @@
+---
+title: "[#794](https://github.com/stripe/stripe-python/pull/794) [#795](https://github.com/stripe/stripe-python/pull/795) API Updates"
+pr_url: https://github.com/stripe/stripe-python/pull/792
+released_in_version: 2.73.0
+---
+
+* Add support for new resources `FundingInstructions` and `Terminal.Configuration`
diff --git a/.hark/changes/2022-04-21_richardm_api-updates.change.md b/.hark/changes/2022-04-21_richardm_api-updates.change.md
new file mode 100644
index 000000000..4f7d1cb99
--- /dev/null
+++ b/.hark/changes/2022-04-21_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/796
+is_stripe_api_change: true
+released_in_version: 2.74.0
+---
+
+* Add support for `expire` test helper method on resource `Refund`
diff --git a/.hark/changes/2022-05-03_dcr_api-updates.change.md b/.hark/changes/2022-05-03_dcr_api-updates.change.md
new file mode 100644
index 000000000..a2fac9d6e
--- /dev/null
+++ b/.hark/changes/2022-05-03_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/805
+is_stripe_api_change: true
+released_in_version: 2.75.0
+---
+
+* Add support for new resource `CashBalance`
diff --git a/.hark/changes/2022-05-05_dcr_api-updates.change.md b/.hark/changes/2022-05-05_dcr_api-updates.change.md
new file mode 100644
index 000000000..5db61684b
--- /dev/null
+++ b/.hark/changes/2022-05-05_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/808
+is_stripe_api_change: true
+released_in_version: 2.76.0
+---
+
+* Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
diff --git a/.hark/changes/2022-05-09_richardm_release-major-version.change.md b/.hark/changes/2022-05-09_richardm_release-major-version.change.md
new file mode 100644
index 000000000..4bdd8e949
--- /dev/null
+++ b/.hark/changes/2022-05-09_richardm_release-major-version.change.md
@@ -0,0 +1,14 @@
+---
+title: Release of major version v3.0.0. The [migration guide](https://github.com/stripe/stripe-python/wiki/Migration-Guide-for-v3) contains more information.
+pr_url: https://github.com/stripe/stripe-python/pull/809
+semver_level: major
+released_in_version: 3.0.0
+---
+
+(⚠️ = breaking changes):
+* ⚠️ Replace the legacy `Order` API with the new `Order` API.
+  * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
+  * Removed methods: `pay` and `return_order`
+  * Removed resources: `OrderItem` and `OrderReturn`
+* ⚠️ Rename `financial_connections.account.refresh` to `financial_connections.refresh_account`
+* Add support for `amount_discount`, `amount_tax`, and `product` on `LineItem`
diff --git a/.hark/changes/2022-05-18_kamil_add-sanitizeid-method.change.md b/.hark/changes/2022-05-18_kamil_add-sanitizeid-method.change.md
new file mode 100644
index 000000000..8f8c4d7a9
--- /dev/null
+++ b/.hark/changes/2022-05-18_kamil_add-sanitizeid-method.change.md
@@ -0,0 +1,5 @@
+---
+title: Add sanitize_id method
+pr_url: https://github.com/stripe/stripe-python/pull/811
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2022-05-19_dcr_bump-vendored-six.change.md b/.hark/changes/2022-05-19_dcr_bump-vendored-six.change.md
new file mode 100644
index 000000000..920723445
--- /dev/null
+++ b/.hark/changes/2022-05-19_dcr_bump-vendored-six.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump vendored six to 1.16.0
+pr_url: https://github.com/stripe/stripe-python/pull/767
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2022-05-19_dcr_set-daemon-attribute.change.md b/.hark/changes/2022-05-19_dcr_set-daemon-attribute.change.md
new file mode 100644
index 000000000..ee85e646a
--- /dev/null
+++ b/.hark/changes/2022-05-19_dcr_set-daemon-attribute.change.md
@@ -0,0 +1,5 @@
+---
+title: Set daemon attribute instead of using setDaemon method that was deprecated in Python 3.10
+pr_url: https://github.com/stripe/stripe-python/pull/719
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2022-05-19_dcr_start-testing-pypy.change.md b/.hark/changes/2022-05-19_dcr_start-testing-pypy.change.md
new file mode 100644
index 000000000..0c058676b
--- /dev/null
+++ b/.hark/changes/2022-05-19_dcr_start-testing-pypy.change.md
@@ -0,0 +1,5 @@
+---
+title: Start testing on pypy-3.8
+pr_url: https://github.com/stripe/stripe-python/pull/806
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2022-05-20_dcr_api-updates.change.md b/.hark/changes/2022-05-20_dcr_api-updates.change.md
new file mode 100644
index 000000000..bd2e8a04d
--- /dev/null
+++ b/.hark/changes/2022-05-20_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/810
+is_stripe_api_change: true
+released_in_version: 3.1.0
+---
+
+* Add support for new resources `Treasury.CreditReversal`, `Treasury.DebitReversal`, `Treasury.FinancialAccountFeatures`, `Treasury.FinancialAccount`, `Treasury.FlowDetails`, `Treasury.InboundTransfer`, `Treasury.OutboundPayment`, `Treasury.OutboundTransfer`, `Treasury.ReceivedCredit`, `Treasury.ReceivedDebit`, `Treasury.TransactionEntry`, and `Treasury.Transaction`
+* Add support for `retrieve_payment_method` method on resource `Customer`
+* Add support for `list_owners` and `list` methods on resource `FinancialConnections.Account`
diff --git a/.hark/changes/2022-05-23_pakrym_api-updates.change.md b/.hark/changes/2022-05-23_pakrym_api-updates.change.md
new file mode 100644
index 000000000..64c84d128
--- /dev/null
+++ b/.hark/changes/2022-05-23_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/812
+is_stripe_api_change: true
+released_in_version: 3.2.0
+---
+
+* Add support for new resource `Apps.Secret`
diff --git a/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md b/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md
new file mode 100644
index 000000000..649765538
--- /dev/null
+++ b/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md
@@ -0,0 +1,5 @@
+---
+title: "fix: Update cash balance methods to no longer require nested ID."
+pr_url: https://github.com/stripe/stripe-python/pull/818
+released_in_version: 3.3.0
+---
diff --git a/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md b/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md
new file mode 100644
index 000000000..be2af0252
--- /dev/null
+++ b/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md
@@ -0,0 +1,5 @@
+---
+title: Trigger workflows on beta branches
+pr_url: https://github.com/stripe/stripe-python/pull/823
+released_in_version: 3.4.0
+---
diff --git a/.hark/changes/2022-06-17_kamil_api-updates.change.md b/.hark/changes/2022-06-17_kamil_api-updates.change.md
new file mode 100644
index 000000000..9fae8fa14
--- /dev/null
+++ b/.hark/changes/2022-06-17_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/824
+is_stripe_api_change: true
+released_in_version: 3.4.0
+---
+
+* Add support for `fund_cash_balance` test helper method on resource `Customer`
diff --git a/.hark/changes/2022-06-30_dcr_api-updates.change.md b/.hark/changes/2022-06-30_dcr_api-updates.change.md
new file mode 100644
index 000000000..7e4091cae
--- /dev/null
+++ b/.hark/changes/2022-06-30_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/831
+is_stripe_api_change: true
+released_in_version: 3.5.0
+---
+
+* Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
+* Switch from using `instance_url` to computing method path in place for custom methods.
+* Switch from using explicit class methods for test helpers instead of using meta-programming.
diff --git a/.hark/changes/2022-07-06_pakrym_api-updates-use.change.md b/.hark/changes/2022-07-06_pakrym_api-updates-use.change.md
new file mode 100644
index 000000000..3df7e7ac9
--- /dev/null
+++ b/.hark/changes/2022-07-06_pakrym_api-updates-use.change.md
@@ -0,0 +1,6 @@
+---
+title: API Updates. Use auto-generation for credit_note and invoice methods.
+pr_url: https://github.com/stripe/stripe-python/pull/835
+is_stripe_api_change: true
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-07-07_pakrym_api-updates-add.change.md b/.hark/changes/2022-07-07_pakrym_api-updates-add.change.md
new file mode 100644
index 000000000..3dcceb8d8
--- /dev/null
+++ b/.hark/changes/2022-07-07_pakrym_api-updates-add.change.md
@@ -0,0 +1,6 @@
+---
+title: API Updates. Add Price.create tests.
+pr_url: https://github.com/stripe/stripe-python/pull/836
+is_stripe_api_change: true
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-01_pakrym_next-major-release.change.md b/.hark/changes/2022-08-01_pakrym_next-major-release.change.md
new file mode 100644
index 000000000..d2651d961
--- /dev/null
+++ b/.hark/changes/2022-08-01_pakrym_next-major-release.change.md
@@ -0,0 +1,6 @@
+---
+title: Next major release changes
+pr_url: https://github.com/stripe/stripe-python/pull/845
+is_stripe_api_change: true
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_pakrym_api-updates.change.md b/.hark/changes/2022-08-02_pakrym_api-updates.change.md
new file mode 100644
index 000000000..8100f9a41
--- /dev/null
+++ b/.hark/changes/2022-08-02_pakrym_api-updates.change.md
@@ -0,0 +1,6 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/847
+is_stripe_api_change: true
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_consistent-other-resource.change.md b/.hark/changes/2022-08-02_unknown_consistent-other-resource.change.md
new file mode 100644
index 000000000..8a175bb11
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_consistent-other-resource.change.md
@@ -0,0 +1,6 @@
+---
+title: To be consistent with other resource methods, `ApplicationFee.refund` returns an instance of `ApplicationFee` and doesn't mutate the instance of `ApplicationFee`.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md b/.hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md
new file mode 100644
index 000000000..35416cb6c
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md
@@ -0,0 +1,6 @@
+---
+title: "To be consistent with other resource methods, the `Customer.delete_discount` no longer resets the `discount` property to `None` and returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually:"
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md b/.hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md
new file mode 100644
index 000000000..9256ad724
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md
@@ -0,0 +1,6 @@
+---
+title: To be consistent with other resource methods, the `Subscription.delete_discount` returns an instance of deleted discount and doesn't mutate the instance of `Subscription`.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_lineitem-resource-now.change.md b/.hark/changes/2022-08-02_unknown_lineitem-resource-now.change.md
new file mode 100644
index 000000000..952c0b100
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_lineitem-resource-now.change.md
@@ -0,0 +1,6 @@
+---
+title: The `LineItem` resource now inherits from `StripeObject` as it has no methods of it's own.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-alipayaccoun.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-alipayaccoun.change.md
new file mode 100644
index 000000000..66ac5c69c
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-alipayaccoun.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `IssuerFraudRecord`, `Recipient`, `RecipientTransfer`, and  `ThreeDSecure` classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-card.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-card.change.md
new file mode 100644
index 000000000..29d65ecfd
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-card.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Card.details` method and `CardDetails` resource. The REST API endpoint is not longer supported.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-charge.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge.change.md
new file mode 100644
index 000000000..ce5a1ea70
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Charge.update_dispute` and `Charge.close_dispute` methods that were using legacy REST API endpoint. Prefer [Dispute.modify](https://stripe.com/docs/api/disputes/update?lang=python) and [Dispute.close](https://stripe.com/docs/api/disputes/close?lang=python)
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md
new file mode 100644
index 000000000..51d66bdee
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed the deprecated `Charge.refund` method. Prefer [Refund.create](https://stripe.com/docs/api/refunds/create)
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-source.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-source.change.md
new file mode 100644
index 000000000..ff9ec7697
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-source.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed the deprecated `Source.source_transactions` method. Prefer `SubscriptionItem.list_source_transactions`
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-subscription.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-subscription.change.md
new file mode 100644
index 000000000..17ef1bec1
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-subscription.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed the deprecated `SubscriptionItem.usage_record_summaries` method. Prefer `SubscriptionItem.list_usage_record_summaries`
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_request-sending-logic.change.md b/.hark/changes/2022-08-02_unknown_request-sending-logic.change.md
new file mode 100644
index 000000000..bdb359c2a
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_request-sending-logic.change.md
@@ -0,0 +1,5 @@
+---
+title: Request sending logic unified across standard and custom methods (https://github.com/stripe/stripe-python/pull/832)
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_update-ca-certificate.change.md b/.hark/changes/2022-08-02_unknown_update-ca-certificate.change.md
new file mode 100644
index 000000000..f41b313ba
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_update-ca-certificate.change.md
@@ -0,0 +1,5 @@
+---
+title: Update the CA certificate bundle.
+section: ⚠️ Changed
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2022-08-03_dcr_fix-issue-where.change.md b/.hark/changes/2022-08-03_dcr_fix-issue-where.change.md
new file mode 100644
index 000000000..4f8ce66ec
--- /dev/null
+++ b/.hark/changes/2022-08-03_dcr_fix-issue-where.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix issue where auto_paging_iter failed on nested list objects.
+pr_url: https://github.com/stripe/stripe-python/pull/855
+released_in_version: 4.0.2
+---
diff --git a/.hark/changes/2022-08-03_pakrym_fix-incorrect-handling.change.md b/.hark/changes/2022-08-03_pakrym_fix-incorrect-handling.change.md
new file mode 100644
index 000000000..e7e2747d3
--- /dev/null
+++ b/.hark/changes/2022-08-03_pakrym_fix-incorrect-handling.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix incorrect handling of additional request parameters
+pr_url: https://github.com/stripe/stripe-python/pull/850
+released_in_version: 4.0.1
+---
+
+* Fixes issue where using special parameter like `api_key`, `idempotency_key`, `stripe_version`, `stripe_account`, `headers` can cause a `Received unknown parameter error`.
diff --git a/.hark/changes/2022-08-03_yejia_fix-test-testcharge.change.md b/.hark/changes/2022-08-03_yejia_fix-test-testcharge.change.md
new file mode 100644
index 000000000..934c5e2aa
--- /dev/null
+++ b/.hark/changes/2022-08-03_yejia_fix-test-testcharge.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix test TestCharge.test_is_saveable().
+pr_url: https://github.com/stripe/stripe-python/pull/717
+released_in_version: 4.1.0
+---
diff --git a/.hark/changes/2022-08-17_ramya_add-support-section.change.md b/.hark/changes/2022-08-17_ramya_add-support-section.change.md
new file mode 100644
index 000000000..5c3577cc6
--- /dev/null
+++ b/.hark/changes/2022-08-17_ramya_add-support-section.change.md
@@ -0,0 +1,5 @@
+---
+title: Add a support section to the readme
+pr_url: https://github.com/stripe/stripe-python/pull/860
+released_in_version: 4.1.0
+---
diff --git a/.hark/changes/2022-08-19_kamil_api-updates.change.md b/.hark/changes/2022-08-19_kamil_api-updates.change.md
new file mode 100644
index 000000000..3cd11d7f3
--- /dev/null
+++ b/.hark/changes/2022-08-19_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/861
+is_stripe_api_change: true
+released_in_version: 4.1.0
+---
+
+* Add support for new resource `CustomerCashBalanceTransaction`
diff --git a/.hark/changes/2022-08-23_dcr_api-updates.change.md b/.hark/changes/2022-08-23_dcr_api-updates.change.md
new file mode 100644
index 000000000..5e052a503
--- /dev/null
+++ b/.hark/changes/2022-08-23_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/867
+is_stripe_api_change: true
+released_in_version: 4.2.0
+---
+
+* Update links in documentation to be absolute.
diff --git a/.hark/changes/2022-09-06_yejia_add-abstract-methods.change.md b/.hark/changes/2022-09-06_yejia_add-abstract-methods.change.md
new file mode 100644
index 000000000..d1cbcdde5
--- /dev/null
+++ b/.hark/changes/2022-09-06_yejia_add-abstract-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Add abstract methods for SearchableAPIResource
+pr_url: https://github.com/stripe/stripe-python/pull/873
+released_in_version: 4.2.0
+---
diff --git a/.hark/changes/2022-09-23_pakrym_api-updates.change.md b/.hark/changes/2022-09-23_pakrym_api-updates.change.md
new file mode 100644
index 000000000..515f6915a
--- /dev/null
+++ b/.hark/changes/2022-09-23_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/877
+is_stripe_api_change: true
+released_in_version: 4.2.0
+---
+
+* Add `upcoming_lines` method to the `Invoice` resource.
diff --git a/.hark/changes/2022-10-12_anniel_removed-orders-resource.change.md b/.hark/changes/2022-10-12_anniel_removed-orders-resource.change.md
new file mode 100644
index 000000000..67ea96da5
--- /dev/null
+++ b/.hark/changes/2022-10-12_anniel_removed-orders-resource.change.md
@@ -0,0 +1,7 @@
+---
+title: Removed `Orders` resource
+pr_url: https://github.com/stripe/stripe-python/pull/882
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-10-15_richardm_hide-misleading-ssl.change.md b/.hark/changes/2022-10-15_richardm_hide-misleading-ssl.change.md
new file mode 100644
index 000000000..0b96443ae
--- /dev/null
+++ b/.hark/changes/2022-10-15_richardm_hide-misleading-ssl.change.md
@@ -0,0 +1,5 @@
+---
+title: hide misleading ssl security warning in python>=2.7.9
+pr_url: https://github.com/stripe/stripe-python/pull/875
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-10-17_anniel_removed-sku-resource.change.md b/.hark/changes/2022-10-17_anniel_removed-sku-resource.change.md
new file mode 100644
index 000000000..b2dacd0ae
--- /dev/null
+++ b/.hark/changes/2022-10-17_anniel_removed-sku-resource.change.md
@@ -0,0 +1,7 @@
+---
+title: Removed `SKU` resource
+pr_url: https://github.com/stripe/stripe-python/pull/883
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-10-24_anniel_do-run-coveralls.change.md b/.hark/changes/2022-10-24_anniel_do-run-coveralls.change.md
new file mode 100644
index 000000000..58f2c4658
--- /dev/null
+++ b/.hark/changes/2022-10-24_anniel_do-run-coveralls.change.md
@@ -0,0 +1,5 @@
+---
+title: Do not run Coveralls if secret token is not available
+pr_url: https://github.com/stripe/stripe-python/pull/888
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-10-27_anniel_fixed-mistyped-names.change.md b/.hark/changes/2022-10-27_anniel_fixed-mistyped-names.change.md
new file mode 100644
index 000000000..68780e7b8
--- /dev/null
+++ b/.hark/changes/2022-10-27_anniel_fixed-mistyped-names.change.md
@@ -0,0 +1,7 @@
+---
+title: "Fixed mistyped names for two OAuth exceptions: `UnsupportedGrantTypError`->`UnsupportedGrantTypeError` and `UnsupportedResponseTypError`->`UnsupportedResponseTypeError`"
+pr_url: https://github.com/stripe/stripe-python/pull/872
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-11-02_kamil_api-updates.change.md b/.hark/changes/2022-11-02_kamil_api-updates.change.md
new file mode 100644
index 000000000..2ebaa9b68
--- /dev/null
+++ b/.hark/changes/2022-11-02_kamil_api-updates.change.md
@@ -0,0 +1,6 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/889
+is_stripe_api_change: true
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-11-16_anniel_next-major-release.change.md b/.hark/changes/2022-11-16_anniel_next-major-release.change.md
new file mode 100644
index 000000000..2788a3ccc
--- /dev/null
+++ b/.hark/changes/2022-11-16_anniel_next-major-release.change.md
@@ -0,0 +1,6 @@
+---
+title: Next major release changes
+pr_url: https://github.com/stripe/stripe-python/pull/895
+is_stripe_api_change: true
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2022-11-16_unknown_deprecate-save-method.change.md b/.hark/changes/2022-11-16_unknown_deprecate-save-method.change.md
new file mode 100644
index 000000000..104ef7e37
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_deprecate-save-method.change.md
@@ -0,0 +1,15 @@
+---
+title: "Deprecate `save` method on resources (#887). Use `modify` instead."
+section: Deprecated
+released_in_version: 5.0.0
+---
+
+ ```python
+# Before
+customer = stripe.Customer.retrieve("cus_123")
+customer.email = "example@test.com"
+customer.save()
+
+# After
+stripe.Customer.modify("cus_123", email="example@test.com")
+ ```
diff --git a/.hark/changes/2022-11-16_unknown_dropped-support-python.change.md b/.hark/changes/2022-11-16_unknown_dropped-support-python.change.md
new file mode 100644
index 000000000..20591af2d
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_dropped-support-python.change.md
@@ -0,0 +1,6 @@
+---
+title: "Dropped support for Python version 3.4 and 3.5 (#881). We now support Python 2.7 or 3.6+."
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2023-01-30_richardm_pass-params-logger.change.md b/.hark/changes/2023-01-30_richardm_pass-params-logger.change.md
new file mode 100644
index 000000000..42e3904a5
--- /dev/null
+++ b/.hark/changes/2023-01-30_richardm_pass-params-logger.change.md
@@ -0,0 +1,5 @@
+---
+title: Pass params into logger.{info,debug}
+pr_url: https://github.com/stripe/stripe-python/pull/913
+released_in_version: 5.1.0
+---
diff --git a/.hark/changes/2023-02-02_richardm_api-updates.change.md b/.hark/changes/2023-02-02_richardm_api-updates.change.md
new file mode 100644
index 000000000..384c434fe
--- /dev/null
+++ b/.hark/changes/2023-02-02_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/920
+is_stripe_api_change: true
+released_in_version: 5.1.0
+---
+
+* Add support for `resume` method on resource `Subscription`
diff --git a/.hark/changes/2023-02-06_richardm_bugfix-revert-pass.change.md b/.hark/changes/2023-02-06_richardm_bugfix-revert-pass.change.md
new file mode 100644
index 000000000..e5163cef1
--- /dev/null
+++ b/.hark/changes/2023-02-06_richardm_bugfix-revert-pass.change.md
@@ -0,0 +1,5 @@
+---
+title: "Bugfix: revert \"Pass params into logger.{info,debug}\""
+pr_url: https://github.com/stripe/stripe-python/pull/923
+released_in_version: 5.1.1
+---
diff --git a/.hark/changes/2023-02-16_anniel_api-updates.change.md b/.hark/changes/2023-02-16_anniel_api-updates.change.md
new file mode 100644
index 000000000..479fd80de
--- /dev/null
+++ b/.hark/changes/2023-02-16_anniel_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/924
+is_stripe_api_change: true
+released_in_version: 5.2.0
+---
+
+* Add support for `refund_payment` method on resource `Terminal.Reader`
diff --git a/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md b/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md
new file mode 100644
index 000000000..f2d4f4c92
--- /dev/null
+++ b/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/947
+is_stripe_api_change: true
+released_in_version: 5.3.0
+---
+
+* Add support for new resources `Tax.CalculationLineItem`, `Tax.Calculation`, `Tax.TransactionLineItem`, and `Tax.Transaction`
+* Add support for `create` and `list_line_items` methods on resource `Calculation`
+* Add support for `create_from_calculation`, `create_reversal`, `create`, `list_line_items`, and `retrieve` methods on resource `Transaction`
diff --git a/.hark/changes/2023-03-30_anniel_update-generated-code.change.md b/.hark/changes/2023-03-30_anniel_update-generated-code.change.md
new file mode 100644
index 000000000..45b786893
--- /dev/null
+++ b/.hark/changes/2023-03-30_anniel_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/951
+is_stripe_api_change: true
+released_in_version: 5.4.0
+---
+
+* Remove support for `create` method on resource `Tax.Transaction`
+  * This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the `create_from_calculation` method.
diff --git a/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9f34d83e3
--- /dev/null
+++ b/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/990
+is_stripe_api_change: true
+released_in_version: 5.5.0
+---
+
+* Add support for new resource `Tax.Settings`
+* Add support for `modify` and `retrieve` methods on resource `Settings`
diff --git a/.hark/changes/2023-08-14_richardm_pin-latest-api.change.md b/.hark/changes/2023-08-14_richardm_pin-latest-api.change.md
new file mode 100644
index 000000000..ae9681093
--- /dev/null
+++ b/.hark/changes/2023-08-14_richardm_pin-latest-api.change.md
@@ -0,0 +1,35 @@
+---
+title: Pin to the latest API version
+pr_url: https://github.com/stripe/stripe-python/pull/987
+semver_level: major
+released_in_version: 6.0.0
+---
+
+In this release, Stripe API Version `2023-08-16` (the latest at time of release) will be sent by default on all requests.
+The previous default was to use your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version).
+
+To successfully upgrade to stripe-python v6, you must either
+
+1. **(Recommended) Upgrade your integration to be compatible with API Version `2023-08-16`.**
+
+   Please read the API Changelog carefully for each API Version from `2023-08-16` back to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe [Test Mode](https://stripe.com/docs/keys#test-live-modes) before deploying them to production.
+
+   You can read the [v6 migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v6) for more detailed instructions.
+
+2. **(Alternative option) Specify a version other than `2023-08-16` when initializing `stripe-python`.**
+
+   If you were previously initializing stripe-python without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). For example:
+
+   ```diff
+     import stripe
+     stripe.api_key = "sk_test_..."
+   + stripe.api_version = '2020-08-27'
+   ```
+
+   If you were already initializing stripe-python with an explicit API Version, upgrading to v6 will not affect your integration.
+
+   Read the [v6 migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v6) for more details.
+
+Going forward, each major release of this library will be *pinned* by default to the latest Stripe API Version at the time of release.
+
+That is, instead of upgrading stripe-python and separately upgrading your Stripe API Version through the Stripe Dashboard, whenever you upgrade major versions of stripe-python, you should also upgrade your integration to be compatible with the latest Stripe API version.
diff --git a/.hark/changes/2023-08-16_richardm_1008-remove-support.change.md b/.hark/changes/2023-08-16_richardm_1008-remove-support.change.md
new file mode 100644
index 000000000..a58f92d5b
--- /dev/null
+++ b/.hark/changes/2023-08-16_richardm_1008-remove-support.change.md
@@ -0,0 +1,7 @@
+---
+title: "[#1008](https://github.com/stripe/stripe-python/pull/1008) Remove support for Python 2."
+pr_url: https://github.com/stripe/stripe-python/pull/1001
+released_in_version: 6.0.0
+---
+
+* The last version of stripe-python that supports Python 2 is 5.5.0. [The Python Software Foundation (PSF)](https://www.python.org/psf-landing/) community [announced the end of support of Python 2](https://www.python.org/doc/sunset-python-2/) on 01 January 2020. To continue to get new features and security updates, please make sure to update your Python runtime to Python 3.6+.
diff --git a/.hark/changes/2023-08-16_richardm_assert-types-pagination.change.md b/.hark/changes/2023-08-16_richardm_assert-types-pagination.change.md
new file mode 100644
index 000000000..e421598be
--- /dev/null
+++ b/.hark/changes/2023-08-16_richardm_assert-types-pagination.change.md
@@ -0,0 +1,8 @@
+---
+title: Assert types of pagination responses
+pr_url: https://github.com/stripe/stripe-python/pull/1015
+semver_level: major
+released_in_version: 6.0.0
+---
+
+* Pagination will raise an exception if the API response is not of the correct type. This should never happen in production use but may break tests that use mock data.
diff --git a/.hark/changes/2023-08-16_richardm_removed-testhelper-decorator.change.md b/.hark/changes/2023-08-16_richardm_removed-testhelper-decorator.change.md
new file mode 100644
index 000000000..b7c4b7b47
--- /dev/null
+++ b/.hark/changes/2023-08-16_richardm_removed-testhelper-decorator.change.md
@@ -0,0 +1,8 @@
+---
+title: Removed @test_helper decorator
+pr_url: https://github.com/stripe/stripe-python/pull/1013
+semver_level: major
+released_in_version: 6.0.0
+---
+
+* This is technically breaking but unlikely to affect most users.
diff --git a/.hark/changes/2023-08-23_richardm_adds-type-annotations.change.md b/.hark/changes/2023-08-23_richardm_adds-type-annotations.change.md
new file mode 100644
index 000000000..4b186f2ce
--- /dev/null
+++ b/.hark/changes/2023-08-23_richardm_adds-type-annotations.change.md
@@ -0,0 +1,5 @@
+---
+title: Adds type annotations, and dependency on `typing_extensions`.
+pr_url: https://github.com/stripe/stripe-python/pull/1020
+released_in_version: 6.1.0
+---
diff --git a/.hark/changes/2023-08-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..11cff6572
--- /dev/null
+++ b/.hark/changes/2023-08-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1016
+is_stripe_api_change: true
+released_in_version: 6.1.0
+---
diff --git a/.hark/changes/2023-08-31_richardm_types-crudl-methods.change.md b/.hark/changes/2023-08-31_richardm_types-crudl-methods.change.md
new file mode 100644
index 000000000..4864f56fc
--- /dev/null
+++ b/.hark/changes/2023-08-31_richardm_types-crudl-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Types for CRUDL methods on parents
+pr_url: https://github.com/stripe/stripe-python/pull/1032
+released_in_version: 6.2.0
+---
diff --git a/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..83a27ab37
--- /dev/null
+++ b/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1024
+is_stripe_api_change: true
+released_in_version: 6.2.0
+---
+
+* Add support for new resource `AccountSession`
+* Add support for `create` method on resource `AccountSession`
diff --git a/.hark/changes/2023-09-01_richardm_types-annotate-resource.change.md b/.hark/changes/2023-09-01_richardm_types-annotate-resource.change.md
new file mode 100644
index 000000000..5a971e4b6
--- /dev/null
+++ b/.hark/changes/2023-09-01_richardm_types-annotate-resource.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: annotate resource properties"
+pr_url: https://github.com/stripe/stripe-python/pull/1026
+released_in_version: 6.3.0
+---
diff --git a/.hark/changes/2023-09-05_anniel_require-typingextens-4.change.md b/.hark/changes/2023-09-05_anniel_require-typingextens-4.change.md
new file mode 100644
index 000000000..0499474db
--- /dev/null
+++ b/.hark/changes/2023-09-05_anniel_require-typingextens-4.change.md
@@ -0,0 +1,5 @@
+---
+title: Require typing_extensions >= 4.0.0
+pr_url: https://github.com/stripe/stripe-python/pull/1042
+released_in_version: 6.3.0
+---
diff --git a/.hark/changes/2023-09-05_richardm_types-listobject.change.md b/.hark/changes/2023-09-05_richardm_types-listobject.change.md
new file mode 100644
index 000000000..882afc77c
--- /dev/null
+++ b/.hark/changes/2023-09-05_richardm_types-listobject.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: ListObject"
+pr_url: https://github.com/stripe/stripe-python/pull/1043
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2023-09-06_richardm_types-expandablefi.change.md b/.hark/changes/2023-09-06_richardm_types-expandablefi.change.md
new file mode 100644
index 000000000..267683156
--- /dev/null
+++ b/.hark/changes/2023-09-06_richardm_types-expandablefi.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: ExpandableField"
+pr_url: https://github.com/stripe/stripe-python/pull/1044
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..26c9578c6
--- /dev/null
+++ b/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1033
+is_stripe_api_change: true
+released_in_version: 6.4.0
+---
+
+* Add support for new resource `PaymentMethodDomain`
+* Add support for `create`, `list`, `modify`, `retrieve`, and `validate` methods on resource `PaymentMethodDomain`
diff --git a/.hark/changes/2023-09-08_richardm_explicitly-define-crudl.change.md b/.hark/changes/2023-09-08_richardm_explicitly-define-crudl.change.md
new file mode 100644
index 000000000..a5584f0bc
--- /dev/null
+++ b/.hark/changes/2023-09-08_richardm_explicitly-define-crudl.change.md
@@ -0,0 +1,5 @@
+---
+title: Explicitly define CRUDL methods in each resource
+pr_url: https://github.com/stripe/stripe-python/pull/1030
+released_in_version: 6.5.0
+---
diff --git a/.hark/changes/2023-09-12_richardm_types-datetimes-ints.change.md b/.hark/changes/2023-09-12_richardm_types-datetimes-ints.change.md
new file mode 100644
index 000000000..ad16265fd
--- /dev/null
+++ b/.hark/changes/2023-09-12_richardm_types-datetimes-ints.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: datetimes to ints, add enum support"
+pr_url: https://github.com/stripe/stripe-python/pull/1049
+released_in_version: 6.5.0
+---
diff --git a/.hark/changes/2023-09-14_richardm_generate-explicit-nested.change.md b/.hark/changes/2023-09-14_richardm_generate-explicit-nested.change.md
new file mode 100644
index 000000000..69ecb4809
--- /dev/null
+++ b/.hark/changes/2023-09-14_richardm_generate-explicit-nested.change.md
@@ -0,0 +1,5 @@
+---
+title: Generate explicit nested resource class methods
+pr_url: https://github.com/stripe/stripe-python/pull/1050
+released_in_version: 6.5.0
+---
diff --git a/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b453d10a6
--- /dev/null
+++ b/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1047
+is_stripe_api_change: true
+released_in_version: 6.5.0
+---
+
+* Add support for `capture`, `create`, `expire`, `increment`, and `reverse` test helper methods on resource `Issuing.Authorization`
+* Add support for `create_force_capture`, `create_unlinked_refund`, and `refund` test helper methods on resource `Issuing.Transaction`
diff --git a/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..2e2d2e8f0
--- /dev/null
+++ b/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1052
+is_stripe_api_change: true
+released_in_version: 6.5.0
+---
+
+* Add support for new resource `PaymentMethodConfiguration`
+* Add support for `create`, `list`, `modify`, and `retrieve` methods on resource `PaymentMethodConfiguration`
diff --git a/.hark/changes/2023-09-21_richardm_add-optional-types.change.md b/.hark/changes/2023-09-21_richardm_add-optional-types.change.md
new file mode 100644
index 000000000..0bfbbe734
--- /dev/null
+++ b/.hark/changes/2023-09-21_richardm_add-optional-types.change.md
@@ -0,0 +1,5 @@
+---
+title: Add optional types to non-required fields
+pr_url: https://github.com/stripe/stripe-python/pull/1057
+released_in_version: 6.6.0
+---
diff --git a/.hark/changes/2023-09-21_richardm_partially-type-resource.change.md b/.hark/changes/2023-09-21_richardm_partially-type-resource.change.md
new file mode 100644
index 000000000..5480306e1
--- /dev/null
+++ b/.hark/changes/2023-09-21_richardm_partially-type-resource.change.md
@@ -0,0 +1,5 @@
+---
+title: Partially type resource methods (no **params)
+pr_url: https://github.com/stripe/stripe-python/pull/1055
+released_in_version: 6.6.0
+---
diff --git a/.hark/changes/2023-09-21_richardm_types-add-deleted.change.md b/.hark/changes/2023-09-21_richardm_types-add-deleted.change.md
new file mode 100644
index 000000000..70c07f45f
--- /dev/null
+++ b/.hark/changes/2023-09-21_richardm_types-add-deleted.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: add deleted field"
+pr_url: https://github.com/stripe/stripe-python/pull/1054
+released_in_version: 6.6.0
+---
diff --git a/.hark/changes/2023-09-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..2ac4a0a7d
--- /dev/null
+++ b/.hark/changes/2023-09-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1056
+is_stripe_api_change: true
+released_in_version: 6.6.0
+---
diff --git a/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..6b9aa2222
--- /dev/null
+++ b/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1065
+is_stripe_api_change: true
+released_in_version: 6.7.0
+---
+
+* Add support for new resource `Issuing.Token`
+* Add support for `list`, `modify`, and `retrieve` methods on resource `Token`
diff --git a/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..bbbe8a108
--- /dev/null
+++ b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1085
+is_stripe_api_change: true
+released_in_version: 7.0.0
+---
+
+- Updated pinned API version
diff --git a/.hark/changes/2023-10-16_unknown_please-read-api.change.md b/.hark/changes/2023-10-16_unknown_please-read-api.change.md
new file mode 100644
index 000000000..d82dc8b38
--- /dev/null
+++ b/.hark/changes/2023-10-16_unknown_please-read-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Please read the [API Changelog](https://docs.stripe.com/changelog/2023-10-16) and carefully review the API changes before upgrading `stripe-python`.
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2023-10-18_richardm_apirequestor-don-t.change.md b/.hark/changes/2023-10-18_richardm_apirequestor-don-t.change.md
new file mode 100644
index 000000000..01a72fe8e
--- /dev/null
+++ b/.hark/changes/2023-10-18_richardm_apirequestor-don-t.change.md
@@ -0,0 +1,5 @@
+---
+title: "APIRequestor: don't mutate incoming multipart headers"
+pr_url: https://github.com/stripe/stripe-python/pull/1091
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2023-10-25_richardm_add-util-deprecated.change.md b/.hark/changes/2023-10-25_richardm_add-util-deprecated.change.md
new file mode 100644
index 000000000..924573273
--- /dev/null
+++ b/.hark/changes/2023-10-25_richardm_add-util-deprecated.change.md
@@ -0,0 +1,5 @@
+---
+title: Add @util.deprecated decorator and deprecate `save`.
+pr_url: https://github.com/stripe/stripe-python/pull/1096
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2023-10-26_richardm_inner-resource-classes.change.md b/.hark/changes/2023-10-26_richardm_inner-resource-classes.change.md
new file mode 100644
index 000000000..5255e5a2c
--- /dev/null
+++ b/.hark/changes/2023-10-26_richardm_inner-resource-classes.change.md
@@ -0,0 +1,9 @@
+---
+title: Inner resource classes
+pr_url: https://github.com/stripe/stripe-python/pull/1103
+semver_level: major
+released_in_version: 7.1.0
+---
+
+* Behavior change: nested json objects will now deserialize into instances of specific classes that subclass `StripeObject`, instead of into generic `StripeObject` instances.
+* ⚠️  Behavior change: `PromotionCode.restrictions.currency_options` will now deserialize into `dict` and not `StripeObject`.
diff --git a/.hark/changes/2023-10-26_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-26_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..f9650ea06
--- /dev/null
+++ b/.hark/changes/2023-10-26_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1090
+is_stripe_api_change: true
+released_in_version: 7.1.0
+---
+
+* Add support for new value `balance_invalid_parameter` on enums `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, and `SetupIntent.LastSetupError`
diff --git a/.hark/changes/2023-10-27_richardm_include-py-typed.change.md b/.hark/changes/2023-10-27_richardm_include-py-typed.change.md
new file mode 100644
index 000000000..ebe89e9c2
--- /dev/null
+++ b/.hark/changes/2023-10-27_richardm_include-py-typed.change.md
@@ -0,0 +1,8 @@
+---
+title: Include `py.typed` and enable type annotations for the package
+pr_url: https://github.com/stripe/stripe-python/pull/1104
+released_in_version: 7.1.0
+---
+
+* This PR includes `py.typed` and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshed for users who use a type checker or IDE.
+* See a detailed guide on the [Github Wiki](https://github.com/stripe/stripe-python/wiki/Inline-type-annotations).
diff --git a/.hark/changes/2023-10-31_richardm_types-add-types.change.md b/.hark/changes/2023-10-31_richardm_types-add-types.change.md
new file mode 100644
index 000000000..51cdb7c1e
--- /dev/null
+++ b/.hark/changes/2023-10-31_richardm_types-add-types.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: Add types for `ErrorObject`."
+pr_url: https://github.com/stripe/stripe-python/pull/1115
+released_in_version: 7.2.0
+---
diff --git a/.hark/changes/2023-10-31_richardm_types-use-staticmethod.change.md b/.hark/changes/2023-10-31_richardm_types-use-staticmethod.change.md
new file mode 100644
index 000000000..505dcb6cb
--- /dev/null
+++ b/.hark/changes/2023-10-31_richardm_types-use-staticmethod.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: Use @staticmethod overloads instead of @classmethod to fix MyPy compatibility."
+pr_url: https://github.com/stripe/stripe-python/pull/1116
+released_in_version: 7.2.0
+---
diff --git a/.hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..caf9a89df
--- /dev/null
+++ b/.hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1112
+is_stripe_api_change: true
+released_in_version: 7.3.0
+---
+
+* Add support for new resource `Tax.Registration`
+* Add support for `create`, `list`, and `modify` methods on resource `Registration`
diff --git a/.hark/changes/2023-11-06_anniel_types-remove-none.change.md b/.hark/changes/2023-11-06_anniel_types-remove-none.change.md
new file mode 100644
index 000000000..66a150126
--- /dev/null
+++ b/.hark/changes/2023-11-06_anniel_types-remove-none.change.md
@@ -0,0 +1,5 @@
+---
+title: "[types] Remove `None` from optional param types"
+pr_url: https://github.com/stripe/stripe-python/pull/1121
+released_in_version: 7.4.0
+---
diff --git a/.hark/changes/2023-11-09_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-09_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..1ff07ff6b
--- /dev/null
+++ b/.hark/changes/2023-11-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1119
+is_stripe_api_change: true
+released_in_version: 7.4.0
+---
+
+* Add support for new value `terminal_reader_hardware_fault` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+* Add support for `metadata` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, and `QuoteUpdateParams.subscription_data`
diff --git a/.hark/changes/2023-11-10_pakrym_add-support-python.change.md b/.hark/changes/2023-11-10_pakrym_add-support-python.change.md
new file mode 100644
index 000000000..d041888e7
--- /dev/null
+++ b/.hark/changes/2023-11-10_pakrym_add-support-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Python 3.11/3.12
+pr_url: https://github.com/stripe/stripe-python/pull/1125
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-10_pakrym_move-python3-venv.change.md b/.hark/changes/2023-11-10_pakrym_move-python3-venv.change.md
new file mode 100644
index 000000000..d33d865d8
--- /dev/null
+++ b/.hark/changes/2023-11-10_pakrym_move-python3-venv.change.md
@@ -0,0 +1,5 @@
+---
+title: Move to python3 venv and update vscode settings
+pr_url: https://github.com/stripe/stripe-python/pull/1123
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-10_richardm_suppress-type-errors.change.md b/.hark/changes/2023-11-10_richardm_suppress-type-errors.change.md
new file mode 100644
index 000000000..8ac5bf4b8
--- /dev/null
+++ b/.hark/changes/2023-11-10_richardm_suppress-type-errors.change.md
@@ -0,0 +1,5 @@
+---
+title: Suppress type errors from latest pyright
+pr_url: https://github.com/stripe/stripe-python/pull/1126
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-15_pakrym_fix-unnecessary-casts.change.md b/.hark/changes/2023-11-15_pakrym_fix-unnecessary-casts.change.md
new file mode 100644
index 000000000..ad627cb34
--- /dev/null
+++ b/.hark/changes/2023-11-15_pakrym_fix-unnecessary-casts.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix unnecessary casts from pyright 1.1.336
+pr_url: https://github.com/stripe/stripe-python/pull/1132
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-15_pakrym_run-pyright-via.change.md b/.hark/changes/2023-11-15_pakrym_run-pyright-via.change.md
new file mode 100644
index 000000000..c4fc6ab6e
--- /dev/null
+++ b/.hark/changes/2023-11-15_pakrym_run-pyright-via.change.md
@@ -0,0 +1,5 @@
+---
+title: Run pyright via tox
+pr_url: https://github.com/stripe/stripe-python/pull/1134
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-15_pakrym_upgrade-black-dependency.change.md b/.hark/changes/2023-11-15_pakrym_upgrade-black-dependency.change.md
new file mode 100644
index 000000000..c88f6a4c3
--- /dev/null
+++ b/.hark/changes/2023-11-15_pakrym_upgrade-black-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade black dependency
+pr_url: https://github.com/stripe/stripe-python/pull/1131
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-16_pakrym_add-initial-tests.change.md b/.hark/changes/2023-11-16_pakrym_add-initial-tests.change.md
new file mode 100644
index 000000000..4f8809dec
--- /dev/null
+++ b/.hark/changes/2023-11-16_pakrym_add-initial-tests.change.md
@@ -0,0 +1,5 @@
+---
+title: Add initial tests for exports and run them in mypy and pyright
+pr_url: https://github.com/stripe/stripe-python/pull/1135
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-16_richardm_mention-types-readme.change.md b/.hark/changes/2023-11-16_richardm_mention-types-readme.change.md
new file mode 100644
index 000000000..32d68e44b
--- /dev/null
+++ b/.hark/changes/2023-11-16_richardm_mention-types-readme.change.md
@@ -0,0 +1,5 @@
+---
+title: Mention types in README.md
+pr_url: https://github.com/stripe/stripe-python/pull/1130
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a928d12af
--- /dev/null
+++ b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1127
+is_stripe_api_change: true
+released_in_version: 7.5.0
+---
+
+* Add support for `bacs_debit_payments` on `Account.CreateParamsSettings`
+* Add support for `service_user_number` on `Account.Settings.BacsDebitPayments`
+* Add support for `capture_before` on `Charge.PaymentMethodDetails.Card.capture_before`
+* Add support for `Paypal` on `Checkout.Session.PaymentMethodOptions`
+* Add support for `tax_amounts` on `CreditNote.CreateParamsLine`, `CreditNote.PreviewParamsLine`, and `CreditNote.PreviewLinesParamsLine`
+* Add support for `network_data` on `Issuing.Transaction`
+* Add support for `status` on `Checkout.Session.ListParams`
diff --git a/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3f198ebe8
--- /dev/null
+++ b/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,17 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1138
+is_stripe_api_change: true
+released_in_version: 7.6.0
+---
+
+* Add support for `electronic_commerce_indicator` on resource classes `Charge.PaymentMethodDetails.Card.ThreeDSecure` and `SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure`
+* Add support for `exemption_indicator` on resource class `Charge.PaymentMethodDetails.Card.ThreeDSecure`
+* Add support for `transaction_id` on resource classes `Charge.PaymentMethodDetails.Card.ThreeDSecure`, `SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure`, `issuing.Authorization.NetworkData`, and `issuing.Transaction.NetworkData`
+* Add support for `offline` on resource class `Charge.PaymentMethodDetails.CardPresent`
+* Add support for `transferred_to_balance` on resource `CustomerCashBalanceTransaction`
+* Add support for `three_d_secure` on parameter classes `PaymentIntent.ConfirmParamsPaymentMethodOptionsCard`, `PaymentIntent.CreateParamsPaymentMethodOptionsCard`, `PaymentIntent.ModifyParamsPaymentMethodOptionsCard`, `SetupIntent.ConfirmParamsPaymentMethodOptionsCard`, `SetupIntent.CreateParamsPaymentMethodOptionsCard`, and `SetupIntent.ModifyParamsPaymentMethodOptionsCard`
+* Add support for `system_trace_audit_number` on resource class `issuing.Authorization.NetworkData`
+* Add support for `network_risk_score` on resource classes `issuing.Authorization.PendingRequest` and `issuing.Authorization.RequestHistory`
+* Add support for `requested_at` on resource class `issuing.Authorization.RequestHistory`
+* Add support for `authorization_code` on resource class `issuing.Transaction.NetworkData`
diff --git a/.hark/changes/2023-11-27_richardm_refactor-integration-test.change.md b/.hark/changes/2023-11-27_richardm_refactor-integration-test.change.md
new file mode 100644
index 000000000..ce8edc0e4
--- /dev/null
+++ b/.hark/changes/2023-11-27_richardm_refactor-integration-test.change.md
@@ -0,0 +1,5 @@
+---
+title: Refactor integration test
+pr_url: https://github.com/stripe/stripe-python/pull/1145
+released_in_version: 7.7.0
+---
diff --git a/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..ca8199dd7
--- /dev/null
+++ b/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1147
+is_stripe_api_change: true
+released_in_version: 7.7.0
+---
+
+* Add support for new resources `Climate.Order`, `Climate.Product`, and `Climate.Supplier`
+* Add support for `cancel`, `create`, `list`, `modify`, and `retrieve` methods on resource `Order`
+* Add support for `list` and `retrieve` methods on resources `Product` and `Supplier`
+* Add support for new value `financial_connections_account_inactive` on enums `Invoice.LastFinalizationError.code`, `PaymentIntent.LastPaymentError.code`, `SetupAttempt.SetupError.code`, and `SetupIntent.LastSetupError.code`
+* Add support for new values `climate_order_purchase` and `climate_order_refund` on enum `BalanceTransaction.type`
+* Add support for `created` on `Checkout.Session.ListParams`
+* Add support for `validate_location` on `Customer.CreateParamsTax` and `Customer.ModifyParamsTax`
+* Add support for new values `climate.order.canceled`, `climate.order.created`, `climate.order.delayed`, `climate.order.delivered`, `climate.order.product_substituted`, `climate.product.created`, and `climate.product.pricing_updated` on enum `Event.type`
+* Add support for new value `challenge` on enums `PaymentIntent. PaymentMethodOptions.Card.request_three_d_secure` and `SetupIntent. PaymentMethodOptions.Card.request_three_d_secure`
+* Add support for new values `climate_order_purchase` and `climate_order_refund` on enum `Reporting.ReportRun. CreateParamsParameters.reporting_category`
+* Add support for new values `climate.order.canceled`, `climate.order.created`, `climate.order.delayed`, `climate.order.delivered`, `climate.order.product_substituted`, `climate.product.created`, and `climate.product.pricing_updated` on enums `WebhookEndpoint.CreateParams.enabled_events[]` and `WebhookEndpoint.ModifyParams.enabled_events[]`
diff --git a/.hark/changes/2023-12-05_pakrym_move-resource-type.change.md b/.hark/changes/2023-12-05_pakrym_move-resource-type.change.md
new file mode 100644
index 000000000..77f83fddd
--- /dev/null
+++ b/.hark/changes/2023-12-05_pakrym_move-resource-type.change.md
@@ -0,0 +1,19 @@
+---
+title: Move resource type exports to stripe.___
+pr_url: https://github.com/stripe/stripe-python/pull/1142
+released_in_version: 7.8.0
+---
+
+- `stripe.error`, `stripe.stripe_object`, `stripe.api_requestor`, `stripe.stripe_response`, `stripe.request_options`, `stripe.api_resources.*`,  `stripe.api_resources.abstract.*` modules are deprecated. All types are available directly from `stripe` module now.
+   Before:
+   ```python
+   from stripe.error import APIError
+   # or
+   stripe.error.APIError
+   ````
+   After:
+   ```python
+   from stripe import APIError
+   # or
+   stripe.APIError
+   ```
diff --git a/.hark/changes/2023-12-07_pakrym_add-missing-explicit.change.md b/.hark/changes/2023-12-07_pakrym_add-missing-explicit.change.md
new file mode 100644
index 000000000..b0f6dc0a4
--- /dev/null
+++ b/.hark/changes/2023-12-07_pakrym_add-missing-explicit.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing explicit reexport for `OAuth`, `Webhook`, `WebhookSignature`
+pr_url: https://github.com/stripe/stripe-python/pull/1157
+released_in_version: 7.8.1
+---
diff --git a/.hark/changes/2023-12-07_pakrym_fix-getattr-raise.change.md b/.hark/changes/2023-12-07_pakrym_fix-getattr-raise.change.md
new file mode 100644
index 000000000..c218aeb2d
--- /dev/null
+++ b/.hark/changes/2023-12-07_pakrym_fix-getattr-raise.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix __getattr__ to raise AttributeError rather than returning None. This fixes a regression in 7.8.0 that caused `stripe.checkout`/`stripe.issuing` etc. to return `None`.
+pr_url: https://github.com/stripe/stripe-python/pull/1159
+released_in_version: 7.8.1
+---
diff --git a/.hark/changes/2023-12-07_pakrym_move-exports-more.change.md b/.hark/changes/2023-12-07_pakrym_move-exports-more.change.md
new file mode 100644
index 000000000..6176e6cb6
--- /dev/null
+++ b/.hark/changes/2023-12-07_pakrym_move-exports-more.change.md
@@ -0,0 +1,20 @@
+---
+title: Move exports for more modules
+pr_url: https://github.com/stripe/stripe-python/pull/1153
+released_in_version: 7.8.0
+---
+
+-  `stripe.app_info`, `stripe.http_client`, `stripe.oauth`, `stripe.util`, `stripe.version`, `stripe.webhook`,  modules are deprecated. All types are available directly from `stripe` module now.
+   Before:
+   ```python
+   from stripe.util import convert_to_stripe_object
+   # or
+   stripe.util.convert_to_stripe_object
+   ````
+   After:
+   ```python
+   from stripe import convert_to_stripe_object
+   # or
+   stripe.convert_to_stripe_object
+   ```
+- `stripe.api_version`, `stripe.multipart_data_generator`, `stripe.request_metrics` are deprecated and will be fully removed in the future.
diff --git a/.hark/changes/2023-12-07_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-12-07_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3d41a2400
--- /dev/null
+++ b/.hark/changes/2023-12-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,17 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1155
+is_stripe_api_change: true
+released_in_version: 7.8.0
+---
+
+* Add support for `payment_details`, `payments`, and `payouts` on `AccountSession.components` and `CreateParams.components`
+* Add support for `features` on `AccountSession.components.account_onboarding` and `CreateParams.components.account_onboarding`
+* Add support for new values `customer_tax_location_invalid` and `financial_connections_no_successful_transaction_refresh` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+* Add support for new values `payment_network_reserve_hold` and `payment_network_reserve_release` on enum `BalanceTransaction.type`
+* Change `Climate.Product.metric_tons_available` to be required
+* Remove support for value `various` from enum `Climate.Supplier.removal_pathway`
+* Remove support for values `challenge_only` and `challenge` from enum `PaymentIntent.payment_method_options.card.request_three_d_secure`
+* Add support for `inactive_message` and `restrictions` on `CreateParams`, `ModifyParams`, and `PaymentLink`
+* Add support for `transfer_group` on `PaymentLink.payment_intent_data`, `CreateParams.payment_intent_data`, and `ModifyParams.payment_intent_data`
+* Add support for `trial_settings` on `PaymentLink.subscription_data`, `CreateParams.subscription_data`, and `ModifyParams.subscription_data`
diff --git a/.hark/changes/2023-12-11_pakrym_do-raise-deprecationw.change.md b/.hark/changes/2023-12-11_pakrym_do-raise-deprecationw.change.md
new file mode 100644
index 000000000..d6d035186
--- /dev/null
+++ b/.hark/changes/2023-12-11_pakrym_do-raise-deprecationw.change.md
@@ -0,0 +1,5 @@
+---
+title: Do not raise a DeprecationWarning in `stripe.app_info`
+pr_url: https://github.com/stripe/stripe-python/pull/1168
+released_in_version: 7.8.2
+---
diff --git a/.hark/changes/2023-12-11_richardm_add-more-types.change.md b/.hark/changes/2023-12-11_richardm_add-more-types.change.md
new file mode 100644
index 000000000..5cd4d2420
--- /dev/null
+++ b/.hark/changes/2023-12-11_richardm_add-more-types.change.md
@@ -0,0 +1,5 @@
+---
+title: Add more types to _http_client.py
+pr_url: https://github.com/stripe/stripe-python/pull/1169
+released_in_version: 7.9.0
+---
diff --git a/.hark/changes/2023-12-12_richardm_mark-defunct-internal.change.md b/.hark/changes/2023-12-12_richardm_mark-defunct-internal.change.md
new file mode 100644
index 000000000..fd7e50315
--- /dev/null
+++ b/.hark/changes/2023-12-12_richardm_mark-defunct-internal.change.md
@@ -0,0 +1,5 @@
+---
+title: Mark defunct and internal methods as deprecated
+pr_url: https://github.com/stripe/stripe-python/pull/1101
+released_in_version: 7.9.0
+---
diff --git a/.hark/changes/2023-12-13_richardm_track-usage-deprecated.change.md b/.hark/changes/2023-12-13_richardm_track-usage-deprecated.change.md
new file mode 100644
index 000000000..7f1ef1317
--- /dev/null
+++ b/.hark/changes/2023-12-13_richardm_track-usage-deprecated.change.md
@@ -0,0 +1,7 @@
+---
+title: Track usage of deprecated `save`
+pr_url: https://github.com/stripe/stripe-python/pull/1146
+released_in_version: 7.9.0
+---
+
+* Reports uses of the deprecated `.save` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `stripe.enable_telemetry = false`, see the [README](https://github.com/stripe/stripe-python/blob/master/README.md#telemetry).)
diff --git a/.hark/changes/2023-12-14_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-12-14_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a75456ad8
--- /dev/null
+++ b/.hark/changes/2023-12-14_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1161
+is_stripe_api_change: true
+released_in_version: 7.9.0
+---
+
+* Add support for `payment_method_reuse_agreement` on resource classes `PaymentLink.ConsentCollection` and `checkout.Session.ConsentCollection` and parameter classes `PaymentLink.CreateParamsConsentCollection` and `checkout.Session.CreateParamsConsentCollection`
+* Add support for `after_submit` on parameter classes `PaymentLink.CreateParamsCustomText`, `PaymentLink.ModifyParamsCustomText`, and `checkout.Session.CreateParamsCustomText` and resource classes `PaymentLink.CustomText` and `checkout.Session.CustomText`
+* Add support for `created` on parameter class `radar.EarlyFraudWarning.ListParams`
diff --git a/.hark/changes/2023-12-18_anniel_support-accessing-reserved.change.md b/.hark/changes/2023-12-18_anniel_support-accessing-reserved.change.md
new file mode 100644
index 000000000..bbbc87d57
--- /dev/null
+++ b/.hark/changes/2023-12-18_anniel_support-accessing-reserved.change.md
@@ -0,0 +1,5 @@
+---
+title: Support accessing reserved word resource properties via attribute
+pr_url: https://github.com/stripe/stripe-python/pull/1178
+released_in_version: 7.10.0
+---
diff --git a/.hark/changes/2023-12-21_anniel_remove-apibase-requestoptio.change.md b/.hark/changes/2023-12-21_anniel_remove-apibase-requestoptio.change.md
new file mode 100644
index 000000000..0d65392e3
--- /dev/null
+++ b/.hark/changes/2023-12-21_anniel_remove-apibase-requestoptio.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove api_base from RequestOptions type
+pr_url: https://github.com/stripe/stripe-python/pull/1184
+released_in_version: 7.10.0
+---
diff --git a/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3a695efa5
--- /dev/null
+++ b/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,24 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1176
+is_stripe_api_change: true
+released_in_version: 7.10.0
+---
+
+* Add support for new resource `FinancialConnections.Transaction`
+* Add support for `list` and `retrieve` methods on resource `Transaction`
+* Add support for `subscribe` and `unsubscribe` methods on resource `FinancialConnections.Account`
+* Add support for `features` on `AccountSessionCreateParams.components.payouts`
+* Add support for `edit_payout_schedule`, `instant_payouts`, and `standard_payouts` on `AccountSession.components.payouts.features`
+* Change type of `Checkout.Session.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]` from `literal('balances')` to `enum('balances'|'transactions')`
+* Add support for new value `financial_connections.account.refreshed_transactions` on enum `Event.type`
+* Add support for new value `transactions` on enum `FinancialConnections.AccountRefreshParams.features[]`
+* Add support for `subscriptions` and `transaction_refresh` on `FinancialConnections.Account`
+* Add support for `next_refresh_available_at` on `FinancialConnections.Account.balance_refresh`
+* Add support for new value `transactions` on enums `FinancialConnections.Session.prefetch[]` and `FinancialConnections.SessionCreateParams.prefetch[]`
+* Add support for new value `unknown` on enums `Issuing.Authorization.verification_data.authentication_exemption.type` and `Issuing.AuthorizationCreateParams.testHelpers.verification_data.authentication_exemption.type`
+* Add support for new value `challenge` on enums `PaymentIntent.payment_method_options.card.request_three_d_secure`, `PaymentIntentConfirmParams.payment_method_options.card.request_three_d_secure`, `PaymentIntentCreateParams.payment_method_options.card.request_three_d_secure`, `PaymentIntentUpdateParams.payment_method_options.card.request_three_d_secure`, `SetupIntent.payment_method_options.card.request_three_d_secure`, `SetupIntentConfirmParams.payment_method_options.card.request_three_d_secure`, `SetupIntentCreateParams.payment_method_options.card.request_three_d_secure`, and `SetupIntentUpdateParams.payment_method_options.card.request_three_d_secure`
+* Add support for `revolut_pay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Change type of `Quote.invoice_settings` from `InvoiceSettingQuoteSetting | null` to `InvoiceSettingQuoteSetting`
+* Add support for `destination_details` on `Refund`
+* Add support for new value `financial_connections.account.refreshed_transactions` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2023-12-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-12-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..32e6b8193
--- /dev/null
+++ b/.hark/changes/2023-12-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1185
+is_stripe_api_change: true
+released_in_version: 7.10.0
+---
diff --git a/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..51dc88831
--- /dev/null
+++ b/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1186
+is_stripe_api_change: true
+released_in_version: 7.11.0
+---
+
+* Add support for `retrieve` on resource `tax.Registration`
+* Change type from `Optional[PaymentDetails]` to `PaymentDetails` of `payment_details` on field `AccountSession.Components`
+* Change type from `Optional[Payments]` to `Payments` of `payments` on field `AccountSession.Components`
+* Change type from `Optional[Payouts]` to `Payouts` of `payouts` on field `AccountSession.Components`
+* Change type from `Optional[Features]` to `Features` of `features` on fields `AccountSession.Components.PaymentDetails`, `AccountSession.Components.Payments`, and `AccountSession.Components.Payouts`
+* Change type from `Optional[InvoiceSettings]` to `InvoiceSettings` of `invoice_settings` on field `SubscriptionSchedule.DefaultSettings`
diff --git a/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a361f7668
--- /dev/null
+++ b/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1188
+is_stripe_api_change: true
+released_in_version: 7.12.0
+---
+
+* Add support for new resource `CustomerSession`
+* Add support for `create` method on resource `CustomerSession`
+* Remove support for values `obligation_inbound`, `obligation_payout_failure`, `obligation_payout`, and `obligation_reversal_outbound` from enum `BalanceTransaction.type`
+* Add support for new values `eps` and `p24` on enums `Invoice.payment_settings.payment_method_types[]`, `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `Subscription.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Remove support for value `obligation` from enum `Reporting.ReportRunCreateParams.parameters.reporting_category`
+* Add support for `billing_cycle_anchor_config` on `SubscriptionCreateParams` and `Subscription`
diff --git a/.hark/changes/2024-01-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..808c571d7
--- /dev/null
+++ b/.hark/changes/2024-01-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1193
+is_stripe_api_change: true
+released_in_version: 7.13.0
+---
+
+* Add support for providing details about `BankAccount`, `Card`, and `CardToken` on `Account.CreateExternalAccountParams.external_account` and `Account.CreateParams.external_account`
+* Add support for new value `nn` on enums `Charge.PaymentMethodDetails.Ideal.bank`, `PaymentIntent.ConfirmParamsPaymentMethodDataIdeal.bank`, `PaymentIntent.CreateParamsPaymenMethodDataIdeal.bank`, `PaymentIntent.UpdateParamsPaymentMethodDataIdeal.bank`, `PaymentMethod.Ideal.bank`, `PaymentMethod.CreateParamsIdeal.bank`, `SetupAttempt.PaymentMethodDetails.Ideal.bank`, `SetupIntent.ConfirmParamsPaymenMethodDataIdeal.bank`, `SetupIntent.CreateParamsPaymenMethodDataIdeal.bank`, and `SetupIntent.UpdateParamsPaymenMethodDataIdeal.bank`
+* Add support for new value `NNBANL2G` on enums `Charge.PaymentMethodDetails.Ideal.bic`, `PaymentMethod.Ideal.bic`, and `SetupAttempt.PaymentMethodDetails.Ideal.bic`
+* Change `CustomerSession.Components.buy_button` and `CustomerSession.Components.pricing_table` to be required
+* Add support for `issuer` on `Invoice.CreateParams`, `Invoice.UpcomingLinesParams`, `Invoice.UpcomingParams`, `Invoice.UpdateParams`, and `Invoice`
+* Add support for `liability` on `Invoice.automatic_tax`, `Invoice.CreateParams.automatic_tax`, `Invoice.UpcomingLinesParams.automatic_tax`, `Invoice.UpcomingParams.automatic_tax`, `Invoice.UpdateParams.automatic_tax`, `Subscription.automatic_tax`, `Subscription.CreateParams.automatic_tax`, and `Subscription.UpdateParams.automatic_tax`
+* Add support for `on_behalf_of` on `Invoice.UpcomingLinesParams` and `Invoice.UpcomingParams`
+* Add support for `pin` on `issuing.Card.CreateParams`
+* Add support for `revocation_reason` on `Mandate.PaymentMethodDetails.bacs_debit`
+* Add support for `customer_balance` on `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.UpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `invoice_settings` on `Subscription.CreateParams` and `Subscription.UpdateParams`
diff --git a/.hark/changes/2024-01-25_anniel_stripe-python-v8.change.md b/.hark/changes/2024-01-25_anniel_stripe-python-v8.change.md
new file mode 100644
index 000000000..2d2488d2f
--- /dev/null
+++ b/.hark/changes/2024-01-25_anniel_stripe-python-v8.change.md
@@ -0,0 +1,50 @@
+---
+title: stripe-python v8 release
+pr_url: https://github.com/stripe/stripe-python/pull/1206
+semver_level: major
+released_in_version: 8.0.0
+---
+
+This release introduces `StripeClient` and a service-based call pattern. This new interface allows you to easily call Stripe APIs and has several benefits over the existing resource-based pattern:
+
+* No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
+* No static methods for easier mocking
+
+For full migration instructions, please refer to the [v8 migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v8-(StripeClient)).
+
+"⚠️" symbol highlights breaking changes
+
+### ⚠️ Changed
+* ⚠️ **Request options like `api_key`, `stripe_account`, `stripe_version`, and `idempotency_key` can no longer be passed in positionally on resource methods. Please pass these in as keyword arguments.**
+
+**BEFORE**
+```python
+stripe.Customer.create(
+  "sk_test_123",  # api key
+  "KG5LxwFBepaKHyUD",  # idempotency key
+  "2022-11-15",  # stripe version
+  "acct_123",  # stripe account
+)
+```
+
+**AFTER**
+```python
+stripe.Customer.create(
+  api_key="sk_test_123",
+  idempotency_key="KG5LxwFBepaKHyUD",
+  stripe_version="2022-11-15",
+  stripe_account="acct_123",
+)
+```
+* ⚠️ Methods that turn a response stream (`Quote.pdf`) now returns a single value of type `StripeResponseStream` instead of a tuple containing `(StripeResponseStream, api_key)`.
+* ⚠️ Removed public access to `APIRequestor`. `APIRequestor`'s main use is internal, and we don't have a good understanding of its external use cases. We had to make several breaking changes to its interface as part of this update, so rather than leaving it public we made it private. If you have a use case for `APIRequestor`, please open up a Github issue describing it. We'd rather you rely on something specifically designed for your use case than having to reach into the library's internals.
+
+
+### ⚠️ Removed
+* ⚠️ Remove `api_version` from `File.create` parameters. Please use `stripe_version` instead.
+* ⚠️ Remove `util.read_special_variable()` utility method (importing directly from `stripe.util` is deprecated as of [v7.8.0](https://github.com/stripe/stripe-python/blob/master/CHANGELOG.md#780---2023-12-07))
+* ⚠️ Remove `StripeError.construct_error_object()`. This method was intended for internal stripe-python use only.
+* ⚠️ Remove `ListObject.empty_list()`. This method was intended for internal stripe-python use only.
+* ⚠️ Remove `SearchResultObject.empty_search_result()`. This method was intended for internal stripe-python use only.
+* ⚠️ Remove `StripeObject.ReprJSONEncoder`. This class was intended for internal stripe-python use only.
+* ⚠️ Remove `StripeObject.api_base`. This property was defunct and returned `None`.
diff --git a/.hark/changes/2024-01-25_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-25_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e4a963912
--- /dev/null
+++ b/.hark/changes/2024-01-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1199
+is_stripe_api_change: true
+released_in_version: 7.14.0
+---
+
+* Add support for `annual_revenue` and `estimated_worker_count` on `Account.business_profile`, `Account.CreateParams.business_profile`, and `Account.UpdateParams.business_profile`
+* Add support for new value `registered_charity` on enums `Account.CreateParams.company.structure`, `Account.UpdateParams.company.structure`, and `Token.CreateParams.account.company.structure`
+* Add support for `collection_options` on `AccountLink.CreateParams`
+* Add support for `liability` on `Checkout.Session.automatic_tax`, `PaymentLink.automatic_tax`, `PaymentLink.CreateParams.automatic_tax`, `PaymentLink.UpdateParams.automatic_tax`, `Quote.automatic_tax`, `Quote.CreateParams.automatic_tax`, `Quote.UpdateParams.automatic_tax`, `SubscriptionSchedule.default_settings.automatic_tax`, `SubscriptionSchedule.phases[].automatic_tax`, `SubscriptionSchedule.CreateParams.default_settings.automatic_tax`, `SubscriptionSchedule.CreateParams.phases[].automatic_tax`, `SubscriptionSchedule.UpdateParams.default_settings.automatic_tax`, `SubscriptionSchedule.UpdateParams.phases[].automatic_tax`, and `checkout.Session.CreateParams.automatic_tax`
+* Add support for `issuer` on `Checkout.Session.invoice_creation.invoice_data`, `PaymentLink.invoice_creation.invoice_data`, `PaymentLink.CreateParams.invoice_creation.invoice_data`, `PaymentLink.UpdateParams.invoice_creation.invoice_data`, `Quote.invoice_settings`, `Quote.CreateParams.invoice_settings`, `Quote.UpdateParams.invoice_settings`, `SubscriptionSchedule.default_settings.invoice_settings`, `SubscriptionSchedule.phases[].invoice_settings`, `SubscriptionSchedule.CreateParams.default_settings.invoice_settings`, `SubscriptionSchedule.CreateParams.phases[].invoice_settings`, `SubscriptionSchedule.UpdateParams.default_settings.invoice_settings`, `SubscriptionSchedule.UpdateParams.phases[].invoice_settings`, and `checkout.Session.CreateParams.invoice_creation.invoice_data`
+* Add support for `invoice_settings` on `PaymentLink.subscription_data`, `PaymentLink.CreateParams.subscription_data`, `PaymentLink.UpdateParams.subscription_data`, and `checkout.Session.CreateParams.subscription_data`
+* Add support for new value `challenge` on enums `Invoice.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure`, `Invoice.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure`, `Subscription.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure`, and `Subscription.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure`
+* Add support for `promotion_code` on `Invoice.UpcomingLinesParams.discounts[]`, `Invoice.UpcomingLinesParams.invoice_items[].discounts[]`, `Invoice.UpcomingParams.discounts[]`, and `Invoice.UpcomingParams.invoice_items[].discounts[]`
+* Add support for `account_type` on `PaymentMethod.UpdateParams.us_bank_account`
diff --git a/.hark/changes/2024-02-01_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-01_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..8a1d6a7e8
--- /dev/null
+++ b/.hark/changes/2024-02-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1213
+is_stripe_api_change: true
+released_in_version: 8.1.0
+---
+
+* Add support for `swish` payment method throughout the API
+* Add support for `relationship` on parameter classes `Account.CreateParamsIndividual` and `Token.CreateParamsAccountIndividual`
+* Add support for `jurisdiction_level` on resource `TaxRate`
+* Change type from `str` to `Literal["offline", "online"]` of `status` on field `terminal.Reader`
diff --git a/.hark/changes/2024-02-02_anniel_measure-stripeclient-usage.change.md b/.hark/changes/2024-02-02_anniel_measure-stripeclient-usage.change.md
new file mode 100644
index 000000000..383c0baef
--- /dev/null
+++ b/.hark/changes/2024-02-02_anniel_measure-stripeclient-usage.change.md
@@ -0,0 +1,5 @@
+---
+title: Measure StripeClient usage
+pr_url: https://github.com/stripe/stripe-python/pull/1220
+released_in_version: 8.2.0
+---
diff --git a/.hark/changes/2024-02-05_richardm_move-stripeclient-usage.change.md b/.hark/changes/2024-02-05_richardm_move-stripeclient-usage.change.md
new file mode 100644
index 000000000..446269b9d
--- /dev/null
+++ b/.hark/changes/2024-02-05_richardm_move-stripeclient-usage.change.md
@@ -0,0 +1,5 @@
+---
+title: Move StripeClient usage collection onto StripeService
+pr_url: https://github.com/stripe/stripe-python/pull/1223
+released_in_version: 8.2.0
+---
diff --git a/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..43b5a46c6
--- /dev/null
+++ b/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1225
+is_stripe_api_change: true
+released_in_version: 8.2.0
+---
+
+* Add support for `invoices` on `Account.Settings`
+* Add support for new value `velobank` on various enums `PaymentMethodDetails.P24.bank`
+* Add support for `setup_future_usage` on `PaymentMethodOptions.Blik`
+* Add support for `require_cvc_recollection` on `PaymentMethodOptions.Card`
+* Add support for `account_tax_ids` on various `InvoiceSettings` request parameters
diff --git a/.hark/changes/2024-02-13_richardm_improve-types-httpclient.change.md b/.hark/changes/2024-02-13_richardm_improve-types-httpclient.change.md
new file mode 100644
index 000000000..5733ab6c6
--- /dev/null
+++ b/.hark/changes/2024-02-13_richardm_improve-types-httpclient.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve types in _http_client.py
+pr_url: https://github.com/stripe/stripe-python/pull/1232
+released_in_version: 8.3.0
+---
diff --git a/.hark/changes/2024-02-15_anniel_remove-broken-child.change.md b/.hark/changes/2024-02-15_anniel_remove-broken-child.change.md
new file mode 100644
index 000000000..62930f62b
--- /dev/null
+++ b/.hark/changes/2024-02-15_anniel_remove-broken-child.change.md
@@ -0,0 +1,7 @@
+---
+title: Remove broken child methods
+pr_url: https://github.com/stripe/stripe-python/pull/1237
+released_in_version: 8.3.0
+---
+
+* Bugfix: remove support for `CreditNoteLineItem.list`, `CustomerCashBalanceTransaction.list`, and `CustomerCashBalanceTransaction.retrieve`. These methods were included in the library unintentionally and never functioned.
diff --git a/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..67718f9d7
--- /dev/null
+++ b/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1230
+is_stripe_api_change: true
+released_in_version: 8.3.0
+---
+
+* Add support for `networks` on `Card`, `PaymentMethod.CreateParamsCard`, `PaymentMethod.ModifyParamsCard`, and `Token.CreateParamsCard`
+* Add support for new value `no_voec` on enums `Checkout.Session.CustomerDetails.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetails.TaxId.type`, `Tax.Transaction.CustomerDetails.TaxId.type`, and `TaxId.type`
+* Add support for new value `no_voec` on enums `Customer.CreateParams.tax_id_data[].type`, `Invoice.UpcomingLinesParams.customer_details.tax_ids[].type`, `Invoice.UpcomingParams.customer_details.tax_ids[].type`,  and `Tax.Calculation.CreateParams.customer_details.tax_ids[].type`
+* Add support for new value `financial_connections.account.refreshed_ownership` on enum `Event.type`
+* Add support for `display_brand` on `PaymentMethod.card`
+* Add support for new value `financial_connections.account.refreshed_ownership` on enums `WebhookEndpoint.CreateParams.enabled_events[]` and `WebhookEndpoint.UpdateParams.enabled_events[]`
diff --git a/.hark/changes/2024-02-16_richardm_testing-unify-http.change.md b/.hark/changes/2024-02-16_richardm_testing-unify-http.change.md
new file mode 100644
index 000000000..0e83dbf7f
--- /dev/null
+++ b/.hark/changes/2024-02-16_richardm_testing-unify-http.change.md
@@ -0,0 +1,5 @@
+---
+title: "Testing: unify http client mock"
+pr_url: https://github.com/stripe/stripe-python/pull/1242
+released_in_version: 8.4.0
+---
diff --git a/.hark/changes/2024-02-20_richardm_remove-http-client.change.md b/.hark/changes/2024-02-20_richardm_remove-http-client.change.md
new file mode 100644
index 000000000..66a029c3f
--- /dev/null
+++ b/.hark/changes/2024-02-20_richardm_remove-http-client.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove http client base
+pr_url: https://github.com/stripe/stripe-python/pull/1243
+released_in_version: 8.4.0
+---
diff --git a/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md b/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md
new file mode 100644
index 000000000..6f656728d
--- /dev/null
+++ b/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md
@@ -0,0 +1,8 @@
+---
+title: Add TaxIds API
+pr_url: https://github.com/stripe/stripe-python/pull/1244
+released_in_version: 8.4.0
+---
+
+* Add support for `create`, `retrieve`, `delete`, and `list` methods on resource `TaxId`
+* The `instance_url` function on resource `TaxId` now returns the top-level `/v1/tax_ids/{id}` path instead of the `/v1/customers/{customer}/tax_ids/{id}` path.
diff --git a/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..08ff01284
--- /dev/null
+++ b/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1241
+is_stripe_api_change: true
+released_in_version: 8.4.0
+---
+
+- Add `InvoiceLineItem.modify` method.
diff --git a/.hark/changes/2024-02-23_anniel_fix-type-errorobject.change.md b/.hark/changes/2024-02-23_anniel_fix-type-errorobject.change.md
new file mode 100644
index 000000000..1c4060158
--- /dev/null
+++ b/.hark/changes/2024-02-23_anniel_fix-type-errorobject.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix type of ErrorObject.code
+pr_url: https://github.com/stripe/stripe-python/pull/1250
+released_in_version: 8.5.0
+---
diff --git a/.hark/changes/2024-02-28_helenye_update-readme-use.change.md b/.hark/changes/2024-02-28_helenye_update-readme-use.change.md
new file mode 100644
index 000000000..841f8236c
--- /dev/null
+++ b/.hark/changes/2024-02-28_helenye_update-readme-use.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README to use add_beta_version
+pr_url: https://github.com/stripe/stripe-python/pull/1260
+released_in_version: 8.5.0
+---
diff --git a/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4393bd6e8
--- /dev/null
+++ b/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1255
+is_stripe_api_change: true
+released_in_version: 8.5.0
+---
+
+* Change `identity.VerificationReport.type` to be required
+* Change type of `identity.VerificationSession.type` from `Optional[Literal["document", "id_number"]]` to `Literal["document", "id_number"]`
+* Add support for `number` on `Invoice.CreateParams` and `Invoice.ModifyParams`
+* Add support for `enable_customer_cancellation` on `terminal.Reader.Action.ProcessPaymentIntent.process_config`, `Terminal.Reader.Action.ProcessSetupIntent.process_config`, `Terminal.Reader.ProcessPaymentIntentParams.process_config`, and `Terminal.Reader.ProcessSetupIntentParams.process_config`
+* Add support for `refund_payment_config` on `Terminal.Reader.Action.refund_payment` and `Terminal.Reader.RefundPaymentParams`
+* Add support for `payment_method` on `Token.CreateParams.bank_account`
+* Add `list_refunds` and `retrieve_refund` methods on resource `Charge`.
diff --git a/.hark/changes/2024-03-07_richardm_update-readme-md.change.md b/.hark/changes/2024-03-07_richardm_update-readme-md.change.md
new file mode 100644
index 000000000..999ce4a96
--- /dev/null
+++ b/.hark/changes/2024-03-07_richardm_update-readme-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README.md
+pr_url: https://github.com/stripe/stripe-python/pull/1268
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2024-03-07_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-03-07_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c606a680f
--- /dev/null
+++ b/.hark/changes/2024-03-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1267
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
+
+* Add support for `documents` on `AccountSession.Components`
+* Add support for `request_three_d_secure` on `Checkout.Session.PaymentMethodOptionsCard` and `Checkout.Session.CreateParams.PaymentMethodOptionsCard`
+* Add support for `created` on `CreditNote.ListParams`
+* Add support for `sepa_debit` on `Invoice.PaymentSettings.PaymentMethodOptions`, `InvoiceCreateParams.PaymentSettings.PaymentMethodOptions`, and `InvoiceUpdateParams.PaymentSettings.PaymentMethodOptions`
diff --git a/.hark/changes/2024-03-14_ramya_update-generated-code.change.md b/.hark/changes/2024-03-14_ramya_update-generated-code.change.md
new file mode 100644
index 000000000..770504bfa
--- /dev/null
+++ b/.hark/changes/2024-03-14_ramya_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1269
+is_stripe_api_change: true
+released_in_version: 8.7.0
+---
+
+* Add support for `personalization_design` on parameter classes `CardService.CreateParams`, `CardService.ListParams`, `CardService.UpdateParams`, `stripe.issuing.Card.CreateParams`, `stripe.issuing.Card.ListParams`, and `stripe.issuing.Card.ModifyParams` and resource `stripe.issuing.Card`
+* Add support for `sepa_debit` on parameter classes `SubscriptionService.CreateParamsPaymentSettingsPaymentMethodOptions`, `SubscriptionService.UpdateParamsPaymentSettingsPaymentMethodOptions`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptions`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptions` and resource class `stripe.Subscription.PaymentSettings.PaymentMethodOptions`
+* Add support for resource `stripe.issuing.PersonalizationDesign`
+* Add support for resource `stripe.issuing.PhysicalBundle`
+* Change type from `float` to `Literal['']|float` of `application_fee_percent` on fields `stripe.Subscription.CreateParams`, `stripe.Subscription.ModifyParams`, `SubscriptionService.UpdateParams`, and `SubscriptionService.CreateParams`
diff --git a/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..aa19852be
--- /dev/null
+++ b/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,20 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1273
+is_stripe_api_change: true
+released_in_version: 8.8.0
+---
+
+* Add support for new resources `ConfirmationToken` and `Forwarding.Request`
+* Add support for `retrieve` method on resource `ConfirmationToken`
+* Add support for `create`, `list`, and `retrieve` methods on resource `Request`
+* Add support for `mobilepay_payments` on `Account.Capabilities`, `Account.CreateParamsCapabilities`, and `Account.UpdateParamsCapabilities`
+* Add support for new values `forwarding_api_inactive`, `forwarding_api_invalid_parameter`, `forwarding_api_upstream_connection_error`, and `forwarding_api_upstream_connection_timeout` on enums `Invoice.LastFinalizationError.code`, `PaymentIntent.LastPaymentError.code`, `SetupAttempt.SetupError.code`, `SetupIntent.LastSetupError.code`, and `StripeError.code`
+* Add support for `payment_reference` on `Charge.PaymentMethodDetails.UsBankAccount`
+* Add support for `payout` on `Treasury.ReceivedDebit.LinkedFlows`
+* Add support for `name` on `ConfigurationService.CreateParams`, `ConfigurationService.UpdateParams`, and `Configuration` for terminal
+ * Add support for `confirmation_token` on `PaymentIntentService.ConfirmParams`, `PaymentIntentService.CreateParams`, `SetupIntentService.ConfirmParams`, and `SetupIntentService.CreateParams`
+ * Add support for new value `mobilepay` on enums `Customer.ListPaymentMethodsParams.type`, `PaymentMethod.CreateParams.type`, and `PaymentMethod.ListParams.type`
+ * Add support for `mobilepay` on `Charge.PaymentMethodDetails`, `PaymentIntent.PaymentMethodOptions`, `PaymentIntentService.ConfirmParamsPaymentMethodData`, `PaymentIntentService.ConfirmParamsPaymentMethodOptions`, `PaymentIntentService.CreateParamsPaymentMethodData`, `PaymentIntentService.CreateParamsPaymentMethodOptions`, `PaymentIntentService.UpdateParamsPaymentMethodData`, `PaymentIntentService.UpdateParamsPaymentMethodOptions`, `PaymentMethod.CreateParams`, `PaymentMethod`, `SetupIntentService.ConfirmParamsPaymentMethodData`, `SetupIntentService.CreateParamsPaymentMethodData`, and `SetupIntentService.UpdateParamsPaymentMethodData`
+ * Add support for new value `mobilepay` on enums `PaymentIntentService.ConfirmParamsPaymentMethodData.type`, `PaymentIntentService.CreateParamsPaymentMethodData.type`, `PaymentIntentService.UpdateParamsPaymentMethodData.type`, `SetupIntentService.ConfirmParamsPaymentMethodData.type`, `SetupIntentService.CreateParamsPaymentMethodData.type`, and `SetupIntentService.UpdateParamsPaymentMethodData.type`
+ * Add support for new value `mobilepay` on enum `PaymentMethod.type`
diff --git a/.hark/changes/2024-03-26_pakrym_update-readme-md.change.md b/.hark/changes/2024-03-26_pakrym_update-readme-md.change.md
new file mode 100644
index 000000000..4b84a2c58
--- /dev/null
+++ b/.hark/changes/2024-03-26_pakrym_update-readme-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README.md
+pr_url: https://github.com/stripe/stripe-python/pull/1279
+released_in_version: 8.9.0
+---
diff --git a/.hark/changes/2024-03-26_richardm_types-remove-unnecessary.change.md b/.hark/changes/2024-03-26_richardm_types-remove-unnecessary.change.md
new file mode 100644
index 000000000..0e31cfa80
--- /dev/null
+++ b/.hark/changes/2024-03-26_richardm_types-remove-unnecessary.change.md
@@ -0,0 +1,5 @@
+---
+title: "Types: remove unnecessary quotes"
+pr_url: https://github.com/stripe/stripe-python/pull/1278
+released_in_version: 8.9.0
+---
diff --git a/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b0f6dfe60
--- /dev/null
+++ b/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1276
+is_stripe_api_change: true
+released_in_version: 8.9.0
+---
+
+* Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`
+* Add support for `create`, `deactivate`, `list`, `modify`, `reactivate`, and `retrieve` methods on resource `Meter`
+* Add support for `create` method on resources `MeterEventAdjustment` and `MeterEvent`
+* Add support for `amazon_pay_payments` on `Account.Capabilities`, `Account.CreateParamsCapabilities`, `Account.UpdateParamsCapabilities`,`AccountService.CreateParamsCapabilities`, and `AccountService.UpdateParamsCapabilities`
+* Add support for new value `verification_failed_representative_authority` on enums `Account.FutureRequirements.Error.code`, `Account.Requirements.Errors.code`, `BankAccount.FutureRequirements.Error.code`, `BankAccount.Requirements.Errors.code`, `Capability.FutureRequirements.Error.code`, `Capability.Requirements.Errors.code`, `Person.FutureRequirements.Error.code`, `Person.Requirements.Errors.code`,
+* Add support for `destination_on_behalf_of_charge_management` on `AccountSession.Components.PaymentDetails.Features`, `AccountSession.Components.Payments.Features`, `AccountSession.CreateParamsComponentsPaymentDetailsFeatures`, `AccountSession.CreateParamsComponentsPaymentsFeatures`, `AccountSessionService.CreateParamsComponentsPaymentDetailsFeatures` and `AccountSessionService.CreateParamsComponentsPaymentsFeatures`
+* Add support for `meter` on `Plan.CreateParams`, `Plan`, `PlanService.CreateParams`, `Price.Recurring`, `Price.CreateParamsRecurring`, `Price.ListParamsRecurring`, `PriceService.CreateParamsRecurring`, and `PriceService.ListParamsRecurring`
+* Add support for `mandate` on `Charge.PaymentMethodDetails.USBankAccount`, `Treasury.InboundTransfer.OriginPaymentMethodDetails.USBankAccount`, `Treasury.OutboundPayment.DestinationPaymentMethodDetails.USBankAccount`, and `Treasury.OutboundTransfer.DestinationPaymentMethodDetails.USBankAccount`
+* Add support for `second_line` on `Issuing.Card.CreateParams`
diff --git a/.hark/changes/2024-04-03_richardm_port-async-support.change.md b/.hark/changes/2024-04-03_richardm_port-async-support.change.md
new file mode 100644
index 000000000..8ad32c933
--- /dev/null
+++ b/.hark/changes/2024-04-03_richardm_port-async-support.change.md
@@ -0,0 +1,12 @@
+---
+title: Port **async support** from beta to the stable channel. To use it, add an `_async` suffix to any request-making method.
+pr_url: https://github.com/stripe/stripe-python/pull/1288
+released_in_version: 8.10.0
+---
+
+```diff
+- cus = stripe.Customer.create(...)
++ cus = await stripe.Customer.create_async(...)
+```
+
+See the [README](./README.md#async) for detailed usage instructions. Support is provided out of the box for async requests via the HTTPX (used by default) and aiohttp libraries. For other libraries, you can also provide your own `stripe.HTTPClient` implementation. Please do not hesitate to [open a Github issue](https://github.com/stripe/stripe-python/issues/new/choose) if you have any feedback on this feature.
diff --git a/.hark/changes/2024-04-04_richardm_bump-aiohttp-3.change.md b/.hark/changes/2024-04-04_richardm_bump-aiohttp-3.change.md
new file mode 100644
index 000000000..5457c7f73
--- /dev/null
+++ b/.hark/changes/2024-04-04_richardm_bump-aiohttp-3.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump aiohttp from 3.9.0 to 3.9.2
+pr_url: https://github.com/stripe/stripe-python/pull/1289
+released_in_version: 8.10.0
+---
diff --git a/.hark/changes/2024-04-04_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-04_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0a6cf0bfa
--- /dev/null
+++ b/.hark/changes/2024-04-04_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,34 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1284
+is_stripe_api_change: true
+released_in_version: 8.10.0
+---
+
+* Add support for `subscription_item` on resource `stripe.Discount`
+* Add support for `promotion_code` on parameter classes `stripe.Invoice.CreateParamsDiscount`, `stripe.Invoice.ModifyParamsDiscount`, `stripe.InvoiceItem.CreateParamsDiscount`, `stripe.InvoiceItem.ModifyParamsDiscount`, `stripe.InvoiceLineItem.ModifyParamsDiscount`, `stripe.Quote.CreateParamsDiscount`, and `stripe.Quote.ModifyParamsDiscount`
+* Add support for `discounts` on parameter classes `stripe.Invoice.UpcomingLinesParamsSubscriptionItem`, `stripe.Invoice.UpcomingParamsSubscriptionItem`, `stripe.Quote.CreateParamsLineItem`, `stripe.Quote.ModifyParamsLineItem`, `stripe.Subscription.CreateParams`, `stripe.Subscription.CreateParamsAddInvoiceItem`, `stripe.Subscription.CreateParamsItem`, `stripe.Subscription.ModifyParams`, `stripe.Subscription.ModifyParamsAddInvoiceItem`, `stripe.Subscription.ModifyParamsItem`, `stripe.SubscriptionItem.CreateParams`, `stripe.SubscriptionItem.ModifyParams`, `stripe.SubscriptionSchedule.CreateParamsPhase`, `stripe.SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem`, `stripe.SubscriptionSchedule.CreateParamsPhaseItem`, `stripe.SubscriptionSchedule.ModifyParamsPhase`, `stripe.SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem`, and `stripe.SubscriptionSchedule.ModifyParamsPhaseItem`, resources `stripe.Subscription` and `stripe.SubscriptionItem`, and resource classes `stripe.SubscriptionSchedule.Phase.AddInvoiceItem`, `stripe.SubscriptionSchedule.Phase.Item`, and `stripe.SubscriptionSchedule.Phase`
+* Add support for `zip` on parameter classes `stripe.PaymentMethodConfiguration.CreateParams` and `stripe.PaymentMethodConfiguration.ModifyParams` and resource `stripe.PaymentMethodConfiguration`
+* Add support for `offline` on resource class `stripe.SetupAttempt.PaymentMethodDetails.CardPresent`
+* Add support for `card_present` on parameter classes `stripe.SetupIntent.ConfirmParamsPaymentMethodOptions`, `stripe.SetupIntent.CreateParamsPaymentMethodOptions`, and `stripe.SetupIntent.ModifyParamsPaymentMethodOptions` and resource class `stripe.SetupIntent.PaymentMethodOptions`
+* Add support for `email` on resource `stripe.identity.VerificationReport`, parameter classes `stripe.identity.VerificationSession.CreateParamsOptions` and `stripe.identity.VerificationSession.ModifyParamsOptions`, and resource classes `stripe.identity.VerificationSession.Options` and `stripe.identity.VerificationSession.VerifiedOutputs`
+* Add support for `phone` on resource `stripe.identity.VerificationReport`, parameter classes `stripe.identity.VerificationSession.CreateParamsOptions` and `stripe.identity.VerificationSession.ModifyParamsOptions`, and resource classes `stripe.identity.VerificationSession.Options` and `stripe.identity.VerificationSession.VerifiedOutputs`
+* Add support for `verification_flow` on resources `stripe.identity.VerificationReport` and `stripe.identity.VerificationSession` and parameter class `stripe.identity.VerificationSession.CreateParams`
+* Add support for `provided_details` on parameter classes `stripe.identity.VerificationSession.CreateParams` and `stripe.identity.VerificationSession.ModifyParams` and resource `stripe.identity.VerificationSession`
+* Add support for `allowed_merchant_countries` on parameter classes `stripe.issuing.Card.CreateParamsSpendingControls`, `stripe.issuing.Card.ModifyParamsSpendingControls`, `stripe.issuing.Cardholder.CreateParamsSpendingControls`, and `stripe.issuing.Cardholder.ModifyParamsSpendingControls` and resource classes `stripe.issuing.Card.SpendingControls` and `stripe.issuing.Cardholder.SpendingControls`
+* Add support for `blocked_merchant_countries` on parameter classes `stripe.issuing.Card.CreateParamsSpendingControls`, `stripe.issuing.Card.ModifyParamsSpendingControls`, `stripe.issuing.Cardholder.CreateParamsSpendingControls`, and `stripe.issuing.Cardholder.ModifyParamsSpendingControls` and resource classes `stripe.issuing.Card.SpendingControls` and `stripe.issuing.Cardholder.SpendingControls`
+* Change type of `reference` on  `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSwish` from `Literal['']|str` to `str`
+* Add support for `verification_flow` on enums `stripe.identity.VerificationReport.type` and `stripe.identity.VerificationSession.type`
+* Add support for `email_unverified_other` on enum `stripe.identity.VerificationSession.LastError.code`
+* Add support for `email_verification_declined` on enum `stripe.identity.VerificationSession.LastError.code`
+* Add support for `phone_unverified_other` on enum `stripe.identity.VerificationSession.LastError.code`
+* Add support for `phone_verification_declined` on enum `stripe.identity.VerificationSession.LastError.code`
+* Add support for `mobile_phone_reader` on enums `stripe.terminal.Reader.device_type` and `stripe.terminal.Reader.ListParams.device_type`
+* Change type of `type` on  `stripe.identity.VerificationSession.CreateParams` from `Literal['document', 'id_number']` to `NotRequired[Literal['document', 'id_number']]`
+* Change type of `discounts` on  `stripe.Invoice` and `stripe.InvoiceLineItem` from `Optional[List[ExpandableField[Discount]]]` to `List[ExpandableField[Discount]]`
+* Change type of `data` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode` from `Optional[str]` to `str`
+* Change type of `image_url_png` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode` from `Optional[str]` to `str`
+* Change type of `image_url_svg` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode` from `Optional[str]` to `str`
+* Change type of `hosted_instructions_url` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[str]` to `str`
+* Change type of `mobile_auth_url` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[str]` to `str`
+* Change type of `qr_code` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[QrCode]` to `QrCode`
diff --git a/.hark/changes/2024-04-05_richardm_fix-readme-md.change.md b/.hark/changes/2024-04-05_richardm_fix-readme-md.change.md
new file mode 100644
index 000000000..30b6da950
--- /dev/null
+++ b/.hark/changes/2024-04-05_richardm_fix-readme-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix README.md
+pr_url: https://github.com/stripe/stripe-python/pull/1299
+released_in_version: 8.11.0
+---
diff --git a/.hark/changes/2024-04-05_richardm_tweak-changelog-python.change.md b/.hark/changes/2024-04-05_richardm_tweak-changelog-python.change.md
new file mode 100644
index 000000000..b2692f7d6
--- /dev/null
+++ b/.hark/changes/2024-04-05_richardm_tweak-changelog-python.change.md
@@ -0,0 +1,5 @@
+---
+title: Tweak changelog for python async note
+pr_url: https://github.com/stripe/stripe-python/pull/1292
+released_in_version: 8.11.0
+---
diff --git a/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3a3f1dcc7
--- /dev/null
+++ b/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1295
+is_stripe_api_change: true
+released_in_version: 8.11.0
+---
+
+* Add support for `fees`, `losses`, `requirement_collection` & `stripe_dashboard` on resource class `stripe.Account.Controller`
+* Add support for `controller` on parameter class `stripe.Account.CreateParams`
+* Add support for `create_feature`, `delete_feature`, `list_features`, `retrieve_feature` on resource `stripe.Product`
+* Add support for resource `stripe.ProductFeature`
+* Add support for `event_name` on parameter class `stripe.billing.MeterEventAdjustment.CreateParams` and resource `stripe.billing.MeterEventAdjustment`
+* Add support for `cancel` and `type` on resource `stripe.billing.MeterEventAdjustment`
+* Add support for resource `stripe.entitlements.ActiveEntitlement`
+* Add support for resource `stripe.entitlements.Feature`
+* Add support for `none` on enum `stripe.Account.type`
diff --git a/.hark/changes/2024-04-10_ramya_api-updates.change.md b/.hark/changes/2024-04-10_ramya_api-updates.change.md
new file mode 100644
index 000000000..e7aa028bc
--- /dev/null
+++ b/.hark/changes/2024-04-10_ramya_api-updates.change.md
@@ -0,0 +1,53 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-python/pull/1286
+released_in_version: 9.0.0
+---
+
+* This release changes the pinned API version to `2024-04-10`. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-04-10) and carefully review the API changes before upgrading.
+
+### ⚠️ Breaking changes
+
+* Remove `FinancialAccountFeaturesService.CreateParams`, `FinancialAccountFeaturesService.ListParams`, `FinancialAccountFeaturesService.create()`, `FinancialAccountFeaturesService.list()` as Financial account features is a singleton and so should have retrieve and update methods instead of create and list methods.
+* Rename `features` to `marketing_features` on parameter classes `stripe.Product.CreateParams` and `stripe.Product.ModifyParams` and resource `stripe.Product`.
+
+#### ⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API
+ * Remove `.subscription_pause` from the below as the feature to pause subscription on the portal has been deprecated
+    * `Configuration.Features`
+    * `ConfigurationService.CreateParamsFeatures`
+    * `ConfigurationService.UpdateParamsFeatures`
+ * Remove the below deprecated values for `BalanceTransaction.type`
+    * `obligation_inbound`
+    * `obligation_payout`
+    * `obligation_payout_failure`
+    * `obligation_reversal_outbound`
+ * Remove the below deprecated events from `Event.type`, `WebhookEndpoint.CreateParams.enabled_events`, `WebhookEndpoint.ModifyParams.enabled_events`, `WebhookEndpointService.CreateParams.enabled_events`, `WebhookEndpointService.ModifyParams.enabled_events`
+   * `invoiceitem.updated`
+   * `order.created`
+   * `recipient.created`
+   * `recipient.deleted`
+   * `recipient.updated`
+   * `sku.created`
+   * `sku.deleted`
+   * `sku.updated`
+ * Remove the deprecated value `include_and_require` for `Invoice.CreateParams.pending_invoice_items_behavior` and `InvoiceService.CreateParams.pending_invoice_items_behavior`
+ * Remove the deprecated value `service_tax` for
+   * `TaxRate.RetrieveParams.tax_type`
+   * `TaxRate.CreateParams.tax_type`
+   * `TaxRate.ModifyParams.tax_type`
+   * `TaxRateService.CreateParams.tax_type`
+   * `TaxRateService.UpdateParams.tax_type`
+   * `InvoiceLineItem.ModifyParamsTaxAmountTaxRateData.tax_type`
+   * `InvoiceLineItemService.UpdateParamsTaxAmountTaxRateData.tax_type`
+ * Remove `request_incremental_authorization` from
+   * `PaymentIntent.ConfirmParamsPaymentMethodOptionsCardPresent`
+   * `PaymentIntent.CreateParamsPaymentMethodOptionsCardPresent`
+   * `PaymentIntent.ModifyParamsPaymentMethodOptionsCardPresent`
+   * `PaymentIntentService.ConfirmParamsPaymentMethodOptionsCardPresent`
+   * `PaymentIntentService.CreateParamsPaymentMethodOptionsCardPresent`
+   * `PaymentIntentService.ModifyParamsPaymentMethodOptionsCardPresent`
+ * Remove support for `id_bank_transfer`, `multibanco`, `netbanking`, `pay_by_bank`, and `upi` on `PaymentMethodConfiguration`
+ * Remove the deprecated value `challenge_only` from `SetupIntent.PaymentMethodOptions.Card.request_three_d_secure`
+ * Remove deprecated value `various` for `Climate.Supplier.removal_pathway`
+ * Remove the deprecated value `obligation` for `ReportRun.CreateParamsParameters.reporting_category` and `ReportRunService.CreateParamsParameters.reporting_category`
+ * Remove the legacy field `rendering_options` on parameter classes `stripe.Invoice.CreateParams` and `stripe.Invoice.ModifyParams` and resource `stripe.Invoice`. Use `rendering` instead.
diff --git a/.hark/changes/2024-04-11_ramya_use-stdlib-asyncmock.change.md b/.hark/changes/2024-04-11_ramya_use-stdlib-asyncmock.change.md
new file mode 100644
index 000000000..f8b1b0987
--- /dev/null
+++ b/.hark/changes/2024-04-11_ramya_use-stdlib-asyncmock.change.md
@@ -0,0 +1,5 @@
+---
+title: Use stdlib AsyncMock when available
+pr_url: https://github.com/stripe/stripe-python/pull/1297
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2024-04-11_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-11_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..6a2074559
--- /dev/null
+++ b/.hark/changes/2024-04-11_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,27 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1300
+is_stripe_api_change: true
+released_in_version: 9.1.0
+---
+
+* Add support for `external_account_collection` on resource class `stripe.AccountSession.Components.AccountOnboarding.Features` and parameter class `stripe.AccountSession.CreateParamsComponentsAccountOnboardingFeatures`
+* Add support for `account_management` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `notification_banner` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `amazon_pay` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.PaymentIntent.PaymentMethodOptions`, `stripe.Refund.DestinationDetails`, `stripe.SetupIntent.PaymentMethodOptions`, and `stripe.checkout.Session.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethodConfiguration.CreateParams`, `stripe.PaymentMethodConfiguration.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptions`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodOptions`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptions`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resources `stripe.PaymentMethod` and `stripe.PaymentMethodConfiguration`
+* Add support for `next_refresh_available_at` on resource class `stripe.financial_connections.Account.OwnershipRefresh`
+* Change type of `cancel` on  `stripe.billing.MeterEventAdjustment` from `Cancel` to `Optional[Cancel]`
+* Change type of `identifier` on  `stripe.billing.MeterEventAdjustment.Cancel` from `str` to `Optional[str]`
+* Change type of `identifier` on  `stripe.billing.MeterEventAdjustment.CreateParamsCancel` from `str` to `NotRequired[str]`
+* Change type of `cancel` on  `stripe.billing.MeterEventAdjustment.CreateParams` from `MeterEventAdjustment.CreateParamsCancel` to `NotRequired[MeterEventAdjustment.CreateParamsCancel]`
+* Change type of `type` on  `stripe.billing.MeterEventAdjustment.CreateParams` from `NotRequired[Literal['cancel']]` to `Literal['cancel']`
+* Add support for `bh_vat` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `kz_bin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `ng_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `om_vat` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `ownership` on enums `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.permissions`, `stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch`, `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.SetupIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.permissions`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch`
+* Add support for `amazon_pay` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `billing_policy_remote_function_response_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* Add support for `billing_policy_remote_function_timeout` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* Add support for `billing_policy_remote_function_unexpected_status_code` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* Add support for `billing_policy_remote_function_unreachable` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
diff --git a/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0ba2e8c94
--- /dev/null
+++ b/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1301
+is_stripe_api_change: true
+released_in_version: 9.2.0
+---
+
+* Add support for `balances` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `payouts_list` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `capture_method` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsRevolutPay`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsRevolutPay`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsRevolutPay` and resource class `stripe.PaymentIntent.PaymentMethodOptions.RevolutPay`
+* Add support for `swish` on parameter classes `stripe.PaymentMethodConfiguration.CreateParams` and `stripe.PaymentMethodConfiguration.ModifyParams` and resource `stripe.PaymentMethodConfiguration`
+* Add support for resource `stripe.entitlements.ActiveEntitlementSummary`
+* Remove support for `config` on parameter class `stripe.forwarding.Request.CreateParams` and resource `stripe.forwarding.Request`. This field is no longer used by the Forwarding Request API.
+* Change type of `destination_on_behalf_of_charge_management` on  `stripe.AccountSession.Components.PaymentDetails.Features` and `stripe.AccountSession.Components.Payments.Features` from `Optional[bool]` to `bool`
+* Change type of `timestamp` on  `stripe.billing.MeterEvent.CreateParams` from `int` to `NotRequired[int]`
+* Add support for `entitlements.active_entitlement_summary.updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
diff --git a/.hark/changes/2024-04-17_prathmesh_update-quote-pdf.change.md b/.hark/changes/2024-04-17_prathmesh_update-quote-pdf.change.md
new file mode 100644
index 000000000..f6725c935
--- /dev/null
+++ b/.hark/changes/2024-04-17_prathmesh_update-quote-pdf.change.md
@@ -0,0 +1,5 @@
+---
+title: "Update `Quote.pdf()` to use the right base address i.e. files.stripe.com instead of api.stripe.com. Fixes [#1303](https://github.com/stripe/stripe-python/issues/1303)"
+pr_url: https://github.com/stripe/stripe-python/pull/1306
+released_in_version: 9.3.0
+---
diff --git a/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..89b1e5341
--- /dev/null
+++ b/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1305
+is_stripe_api_change: true
+released_in_version: 9.3.0
+---
+
+* Add support for `allow_redisplay` on parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.Customer.ListPaymentMethodsParams`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethod.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData`
+* Add support for `schedule_details` on parameter classes `stripe.Invoice.UpcomingLinesParams` and `stripe.Invoice.UpcomingParams`
+* Add support for `subscription_details` on parameter classes `stripe.Invoice.UpcomingLinesParams` and `stripe.Invoice.UpcomingParams`
+* Add support for `create_preview` on resource `stripe.Invoice`
+* Add support for `payment_method_data` on parameter class `stripe.checkout.Session.CreateParams`
+* Add support for `saved_payment_method_options` on parameter class `stripe.checkout.Session.CreateParams` and resource `stripe.checkout.Session`
+* Add support for `mobilepay` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptions` and resource class `stripe.checkout.Session.PaymentMethodOptions`
+* Add support for `mobilepay` on enum `stripe.checkout.Session.CreateParams.payment_method_types`
+* Add support for `other` on enums `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel.unit`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel.unit`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel.unit`
diff --git a/.hark/changes/2024-04-22_helenye_bump-aiohttp-3.change.md b/.hark/changes/2024-04-22_helenye_bump-aiohttp-3.change.md
new file mode 100644
index 000000000..8ff6db765
--- /dev/null
+++ b/.hark/changes/2024-04-22_helenye_bump-aiohttp-3.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump aiohttp from 3.9.2 to 3.9.4
+pr_url: https://github.com/stripe/stripe-python/pull/1307
+released_in_version: 9.4.0
+---
diff --git a/.hark/changes/2024-04-25_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-25_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..6d9778b82
--- /dev/null
+++ b/.hark/changes/2024-04-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1316
+is_stripe_api_change: true
+released_in_version: 9.4.0
+---
+
+* Add support for `amazon_pay` on resource classes `stripe.Mandate.PaymentMethodDetails` and `stripe.SetupAttempt.PaymentMethodDetails`
+* Add support for `revolut_pay` on resource classes `stripe.Mandate.PaymentMethodDetails` and `stripe.SetupAttempt.PaymentMethodDetails`
+* Add support for `setup_future_usage` on resource classes `stripe.PaymentIntent.PaymentMethodOptions.AmazonPay`, `stripe.PaymentIntent.PaymentMethodOptions.RevolutPay`, `stripe.checkout.Session.PaymentMethodOptions.AmazonPay`, and `stripe.checkout.Session.PaymentMethodOptions.RevolutPay`
+* Add support for `mobilepay` on parameter classes `stripe.PaymentMethodConfiguration.CreateParams` and `stripe.PaymentMethodConfiguration.ModifyParams` and resource `stripe.PaymentMethodConfiguration`
+* Add support for `ending_before` on parameter class `stripe.PaymentMethodConfiguration.ListParams`
+* Add support for `limit` on parameter class `stripe.PaymentMethodConfiguration.ListParams`
+* Add support for `starting_after` on parameter class `stripe.PaymentMethodConfiguration.ListParams`
+* Change type of `feature` on  `stripe.entitlements.ActiveEntitlement` from `str` to `ExpandableField[Feature]`
+* Add support for `amazon_pay` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
+* Add support for `revolut_pay` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
+* Remove support for inadvertently released identity verification features `email` and `phone` on parameter classes `stripe.identity.VerificationSession.CreateParamsOptions` and `stripe.identity.VerificationSession.ModifyParamsOptions`
diff --git a/.hark/changes/2024-04-26_anniel_fix-type-change.change.md b/.hark/changes/2024-04-26_anniel_fix-type-change.change.md
new file mode 100644
index 000000000..399151345
--- /dev/null
+++ b/.hark/changes/2024-04-26_anniel_fix-type-change.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix type change entries in Python Changelog
+pr_url: https://github.com/stripe/stripe-python/pull/1319
+released_in_version: 9.5.0
+---
diff --git a/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..dde254e45
--- /dev/null
+++ b/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1317
+is_stripe_api_change: true
+released_in_version: 9.5.0
+---
+
+* Add support for `paypal` on resource class `stripe.Dispute.PaymentMethodDetails`
+* Add support for `payment_method_types` on parameter class `stripe.PaymentIntent.ConfirmParams`
+* Add support for `ship_from_details` on parameter class `stripe.tax.Calculation.CreateParams` and resources `stripe.tax.Calculation` and `stripe.tax.Transaction`
+* Add support for `bh`, `eg`, `ge`, `ke`, `kz`, `ng`, `om` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `paypal` on enum `stripe.Dispute.PaymentMethodDetails.type`
+* Add support for `shipping_address_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* Change type of `metadata` on  `stripe.entitlements.Feature.ModifyParams` from `Dict[str, str]` to `Literal['']|Dict[str, str]`
diff --git a/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4554e9476
--- /dev/null
+++ b/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1323
+is_stripe_api_change: true
+released_in_version: 9.6.0
+---
+
+* Add support for `allow_redisplay` on resource class `stripe.ConfirmationToken.PaymentMethodPreview` and resource `stripe.PaymentMethod`
+* Add support for `preview_mode` on parameter classes `stripe.Invoice.CreatePreviewParams`, `stripe.Invoice.UpcomingLinesParams`, and `stripe.Invoice.UpcomingParams`
+* Add support for `_cls_update` on resources `stripe.treasury.OutboundPayment` and `stripe.treasury.OutboundTransfer`
+* Add support for `tracking_details` on resources `stripe.treasury.OutboundPayment` and `stripe.treasury.OutboundTransfer`
+* Add support for `update` on resources `stripe.treasury.OutboundPayment` and `stripe.treasury.OutboundTransfer`
+* Add support for `treasury.outbound_payment.tracking_details_updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `treasury.outbound_transfer.tracking_details_updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
diff --git a/.hark/changes/2024-05-13_xavdid_switch-black-ruff.change.md b/.hark/changes/2024-05-13_xavdid_switch-black-ruff.change.md
new file mode 100644
index 000000000..b3da1c59a
--- /dev/null
+++ b/.hark/changes/2024-05-13_xavdid_switch-black-ruff.change.md
@@ -0,0 +1,5 @@
+---
+title: Switch from `black` to `ruff` for formatting
+pr_url: https://github.com/stripe/stripe-python/pull/1329
+released_in_version: 9.7.0
+---
diff --git a/.hark/changes/2024-05-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..bbb1e21a5
--- /dev/null
+++ b/.hark/changes/2024-05-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,21 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1328
+is_stripe_api_change: true
+released_in_version: 9.7.0
+---
+
+* Add support for `fee_source` on resource `stripe.ApplicationFee`
+* Add support for `net_available` on resource class `stripe.Balance.InstantAvailable`
+* Add support for `preferred_locales` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent`, and `stripe.PaymentMethod.CardPresent`
+* Add support for `klarna` on resource class `stripe.Dispute.PaymentMethodDetails`
+* Add support for `routing` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCardPresent`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCardPresent`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCardPresent` and resource class `stripe.PaymentIntent.PaymentMethodOptions.CardPresent`
+* Add support for `application_fee` on resource `stripe.Payout`
+* Add support for `archived` on parameter class `stripe.entitlements.Feature.ListParams`
+* Add support for `lookup_key` on parameter class `stripe.entitlements.Feature.ListParams`
+* Add support for `no_valid_authorization` on parameter classes `stripe.issuing.Dispute.CreateParamsEvidence` and `stripe.issuing.Dispute.ModifyParamsEvidence` and resource class `stripe.issuing.Dispute.Evidence`
+* Add support for `loss_reason` on resource `stripe.issuing.Dispute`
+* Add support for `stripe_s700` on parameter classes `stripe.terminal.Configuration.CreateParams` and `stripe.terminal.Configuration.ModifyParams` and resource `stripe.terminal.Configuration`
+* Add support for `klarna` on enum `stripe.Dispute.PaymentMethodDetails.type`
+* Add support for `no_valid_authorization` on enums `stripe.issuing.Dispute.Evidence.reason`, `stripe.issuing.Dispute.CreateParamsEvidence.reason`, and `stripe.issuing.Dispute.ModifyParamsEvidence.reason`
+* Change type of `countries` on  `stripe.financial_connections.Session.CreateParamsFilters` from `List[str]` to `NotRequired[List[str]]`
diff --git a/.hark/changes/2024-05-23_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-23_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..278ac56c8
--- /dev/null
+++ b/.hark/changes/2024-05-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1332
+is_stripe_api_change: true
+released_in_version: 9.8.0
+---
+
+* Add support for `external_account_collection` on resource classes `stripe.AccountSession.Components.Balances.Features` and `stripe.AccountSession.Components.Payouts.Features` and parameter classes `stripe.AccountSession.CreateParamsComponentsBalancesFeatures` and `stripe.AccountSession.CreateParamsComponentsPayoutsFeatures`
+* Add support for `payment_method_remove` on resource class `stripe.checkout.Session.SavedPaymentMethodOptions`
+* Add support for `terminal_reader_invalid_location_for_payment` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
diff --git a/.hark/changes/2024-05-24_ramya_add-method-list.change.md b/.hark/changes/2024-05-24_ramya_add-method-list.change.md
new file mode 100644
index 000000000..5dbf2ba40
--- /dev/null
+++ b/.hark/changes/2024-05-24_ramya_add-method-list.change.md
@@ -0,0 +1,7 @@
+---
+title: Add method to list invoice line items
+pr_url: https://github.com/stripe/stripe-python/pull/1335
+released_in_version: 9.9.0
+---
+
+* Add methods `list_lines()` and `list_lines_async()` on the class `Invoice` to list the invoice line items
diff --git a/.hark/changes/2024-05-30_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-30_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..f0dcd8fa4
--- /dev/null
+++ b/.hark/changes/2024-05-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,17 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1336
+is_stripe_api_change: true
+released_in_version: 9.9.0
+---
+
+* Add support for `generated_from` on resource classes `stripe.ConfirmationToken.PaymentMethodPreview.Card` and `stripe.PaymentMethod.Card`
+* Add support for `default_value` on parameter classes `stripe.checkout.Session.CreateParamsCustomFieldDropdown`, `stripe.checkout.Session.CreateParamsCustomFieldNumeric`, and `stripe.checkout.Session.CreateParamsCustomFieldText` and resource classes `stripe.checkout.Session.CustomField.Dropdown`, `stripe.checkout.Session.CustomField.Numeric`, and `stripe.checkout.Session.CustomField.Text`
+* Add support for `verification_requires_additional_proof_of_registration` on enums `stripe.Account.FutureRequirements.Error.code`, `stripe.Account.Requirements.Error.code`, `stripe.BankAccount.FutureRequirements.Error.code`, `stripe.BankAccount.Requirements.Error.code`, `stripe.Capability.FutureRequirements.Error.code`, `stripe.Capability.Requirements.Error.code`, `stripe.Person.FutureRequirements.Error.code`, and `stripe.Person.Requirements.Error.code`
+* Add support for `issuing_personalization_design.activated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `issuing_personalization_design.deactivated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `issuing_personalization_design.rejected` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `issuing_personalization_design.updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `en-RO` on enums `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsKlarna.preferred_locale`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsKlarna.preferred_locale`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsKlarna.preferred_locale`
+* Add support for `ro-RO` on enums `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsKlarna.preferred_locale`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsKlarna.preferred_locale`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsKlarna.preferred_locale`
+* Change type of `features` on  `stripe.issuing.PhysicalBundle` from `Optional[Features]` to `Features`
diff --git a/.hark/changes/2024-06-06_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-06-06_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..39e419835
--- /dev/null
+++ b/.hark/changes/2024-06-06_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1340
+is_stripe_api_change: true
+released_in_version: 9.10.0
+---
+
+* Add support for `gb_bank_transfer_payments`, `jp_bank_transfer_payments`, `mx_bank_transfer_payments`, `sepa_bank_transfer_payments`, `us_bank_transfer_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `swish` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
diff --git a/.hark/changes/2024-06-13_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-06-13_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c7a0c6c3c
--- /dev/null
+++ b/.hark/changes/2024-06-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1342
+is_stripe_api_change: true
+released_in_version: 9.11.0
+---
+
+* Add support for `multibanco_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `twint_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `twint` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, and `stripe.PaymentIntent.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and resource `stripe.PaymentMethod`
+* Add support for `multibanco` on parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethodConfiguration.CreateParams`, `stripe.PaymentMethodConfiguration.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, resource classes `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.PaymentIntent.PaymentMethodOptions`, `stripe.Refund.DestinationDetails`, and `stripe.checkout.Session.PaymentMethodOptions`, and resources `stripe.PaymentMethod` and `stripe.PaymentMethodConfiguration`
+* Add support for `multibanco_display_details` on resource class `stripe.PaymentIntent.NextAction`
+* Add support for `invoice_settings` on resource `stripe.Subscription`
+* Add support for `de_stn` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `multibanco` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `twint` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
diff --git a/.hark/changes/2024-06-17_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-06-17_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..7d480edf2
--- /dev/null
+++ b/.hark/changes/2024-06-17_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1348
+is_stripe_api_change: true
+released_in_version: 9.12.0
+---
+
+* Add support for `tax_id_collection` on parameter class `stripe.PaymentLink.ModifyParams`
+* Add support for `mobilepay` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
diff --git a/.hark/changes/2024-06-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-06-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..998a813d0
--- /dev/null
+++ b/.hark/changes/2024-06-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,28 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1350
+is_stripe_api_change: true
+released_in_version: 10.0.0
+---
+
+This release changes the pinned API version to 2024-06-20. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-06-20) and carefully review the API changes before upgrading.
+
+### ⚠️ Breaking changes
+
+  * Remove the unused resource `PlatformTaxFee`
+  * Rename `volume_decimal` to `quantity_decimal` on parameter classes `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel` and resource class `stripe.issuing.Transaction.PurchaseDetails.Fuel`
+
+### Additions
+
+* Add support for `fleet` on parameter classes `stripe.issuing.Authorization.CaptureParamsPurchaseDetails`, `stripe.issuing.Authorization.CreateParams`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetails`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetails`, resource `stripe.issuing.Authorization`, and resource class `stripe.issuing.Transaction.PurchaseDetails`
+* Add support for new values `platform_disabled`, `paused.inactivity` and `other` on enums `Capability.Requirements.disabled_reason` and `Capability.FutureRequirements.disabled_reason`
+* Add support for `industry_product_code` on parameter classes `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel` and resource class `stripe.issuing.Transaction.PurchaseDetails.Fuel`
+* Add support for `quantity_decimal` on parameter classes `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel` and resource class `stripe.issuing.Transaction.PurchaseDetails.Fuel`
+* Add support for `fuel` on parameter class `stripe.issuing.Authorization.CreateParams` and resource `stripe.issuing.Authorization`
+* Add support for `_cls_finalize_amount` on resource `stripe.issuing.Authorization`
+* Add support for `finalize_amount` on resource `stripe.issuing.Authorization`
+* Change type of `disabled_reason` on  `stripe.Capability.FutureRequirements` and `stripe.Capability.Requirements` from `str` to `Literal['other', 'paused.inactivity', 'pending.onboarding', 'pending.review', 'platform_disabled', 'platform_paused', 'rejected.inactivity', 'rejected.other', 'rejected.unsupported_business', 'requirements.fields_needed']`
+* Add support for `ch_uid` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `card_canceled`, `card_expired`,  `cardholder_blocked`, `insecure_authorization_method` and `pin_blocked`  on enum `stripe.issuing.Authorization.RequestHistory.reason`
+* Add support for `charging_minute`, `imperial_gallon`, `kilogram`,  `kilowatt_hour`, `pound`, on enums `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel.unit`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel.unit`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel.unit`
+* Add support for `2024-06-20` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
diff --git a/.hark/changes/2024-06-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-06-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..7fc5dbd85
--- /dev/null
+++ b/.hark/changes/2024-06-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1353
+is_stripe_api_change: true
+released_in_version: 10.1.0
+---
+
+* Add support for `email_type` on parameter classes `stripe.CreditNote.CreateParams`, `stripe.CreditNote.PreviewLinesParams`, and `stripe.CreditNote.PreviewParams`
+* Add support for `filters` on parameter classes `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections` and resource classes `stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.SetupIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections`, and `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount.FinancialConnections`
+* Add support for `account_subcategories` on parameter class `stripe.financial_connections.Session.CreateParamsFilters` and resource class `stripe.financial_connections.Session.Filters`
+* Add support for `reboot_window` on parameter classes `stripe.terminal.Configuration.CreateParams` and `stripe.terminal.Configuration.ModifyParams` and resource `stripe.terminal.Configuration`
+* Add support for `day` on enum `stripe.billing.Meter.ListEventSummariesParams.value_grouping_window`
+* Add support for `multibanco` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
+* Add support for `twint` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
+* Add support for `zip` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
diff --git a/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..57e29ecf1
--- /dev/null
+++ b/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1354
+is_stripe_api_change: true
+released_in_version: 10.2.0
+---
+
+* Add support for `_cls_add_lines`, `_cls_remove_lines`, `_cls_update_lines`, `add_lines`, `remove_lines`, `update_lines` on resource `stripe.Invoice`
+* Add support for `posted_at` on parameter class `stripe.tax.Transaction.CreateFromCalculationParams` and resource `stripe.tax.Transaction`
+* Add support for `payment_intent_fx_quote_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
diff --git a/.hark/changes/2024-07-11_prathmesh_update-changelog.change.md b/.hark/changes/2024-07-11_prathmesh_update-changelog.change.md
new file mode 100644
index 000000000..491facb2e
--- /dev/null
+++ b/.hark/changes/2024-07-11_prathmesh_update-changelog.change.md
@@ -0,0 +1,5 @@
+---
+title: Update changelog
+pr_url: https://github.com/stripe/stripe-python/pull/1360
+released_in_version: 10.4.0
+---
diff --git a/.hark/changes/2024-07-11_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-11_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..796714949
--- /dev/null
+++ b/.hark/changes/2024-07-11_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1358
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 10.3.0
+---
+
+* Add support for `payment_method_options` on resource `stripe.ConfirmationToken`
+* Add support for `payment_element` on resource class `stripe.CustomerSession.Components` and parameter class `stripe.CustomerSession.CreateParamsComponents`
+* Add support for `address_validation` on parameter class `stripe.issuing.Card.CreateParamsShipping` and resource class `stripe.issuing.Card.Shipping`
+* Add support for `shipping` on parameter class `stripe.issuing.Card.ModifyParams`
+* ⚠️ Remove support for `billing_policy_remote_function_response_invalid`, `billing_policy_remote_function_timeout`, `billing_policy_remote_function_unexpected_status_code`, and `billing_policy_remote_function_unreachable` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* ⚠️ Remove support for `payment_intent_fx_quote_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`. The property was mistakenly released last week.
+* [#1357](https://github.com/stripe/stripe-python/pull/1357) don't auto-organize imports
diff --git a/.hark/changes/2024-07-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3785f5a21
--- /dev/null
+++ b/.hark/changes/2024-07-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1362
+is_stripe_api_change: true
+released_in_version: 10.4.0
+---
+
+* Add support for `customer` on resource class `stripe.ConfirmationToken.PaymentMethodPreview`
+* Add support for `issuing_dispute.funds_rescinded` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `multibanco` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
+* Add support for `stripe_s700` on enums `stripe.terminal.Reader.device_type` and `stripe.terminal.Reader.ListParams.device_type`
diff --git a/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b3fa5f465
--- /dev/null
+++ b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1368
+is_stripe_api_change: true
+released_in_version: 10.5.0
+---
+
+* Add support for `tax_registrations` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `tax_settings` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
diff --git a/.hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 000000000..8601cd160
--- /dev/null
+++ b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,17 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1364
+is_stripe_api_change: true
+released_in_version: 10.5.0
+---
+
+* Add support for `transaction_id` on resource class `stripe.Charge.PaymentMethodDetails.Affirm`
+* Add support for `buyer_id` on resource class `stripe.Charge.PaymentMethodDetails.Blik`
+* Add support for `authorization_code` on resource class `stripe.Charge.PaymentMethodDetails.Card`
+* Add support for `brand_product` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent`, `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, and `stripe.PaymentMethod.CardPresent`
+* Add support for `network_transaction_id` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent`, `stripe.Charge.PaymentMethodDetails.InteracPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, and `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`
+* Add support for `case_type` on resource class `stripe.Dispute.PaymentMethodDetails.Card`
+* Add support for `twint` on parameter classes `stripe.PaymentMethodConfiguration.CreateParams` and `stripe.PaymentMethodConfiguration.ModifyParams` and resource `stripe.PaymentMethodConfiguration`
+* Add support for `modify` on resource `stripe.checkout.Session`
+* Add support for `invoice.overdue` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `invoice.will_be_due` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
diff --git a/.hark/changes/2024-08-01_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-08-01_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..cbdafb195
--- /dev/null
+++ b/.hark/changes/2024-08-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1369
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 10.6.0
+---
+
+* Add support for resource `stripe.billing.Alert`
+* ⚠️ Remove support for `authorization_code` on resource class `stripe.Charge.PaymentMethodDetails.Card`. This was accidentally released last week.
+* Add support for `billing.alert.triggered` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `charge_exceeds_transaction_limit` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
diff --git a/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a5c83eb37
--- /dev/null
+++ b/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,25 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1371
+is_stripe_api_change: true
+released_in_version: 10.7.0
+---
+
+* Add support for `type` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent.Offline`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent.Offline`, `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent.Offline`, and `stripe.SetupAttempt.PaymentMethodDetails.CardPresent.Offline`
+* Add support for `offline` on resource classes `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent` and `stripe.PaymentMethod.CardPresent`
+* Add support for `_cls_activate` on resource `stripe.billing.Alert`
+* Add support for `_cls_archive` on resource `stripe.billing.Alert`
+* Add support for `_cls_deactivate` on resource `stripe.billing.Alert`
+* Add support for `activate` on resource `stripe.billing.Alert`
+* Add support for `archive` on resource `stripe.billing.Alert`
+* Add support for `create` on resource `stripe.billing.Alert`
+* Add support for `deactivate` on resource `stripe.billing.Alert`
+* Add support for `list` on resource `stripe.billing.Alert`
+* Add support for `retrieve` on resources `stripe.billing.Alert` and `stripe.tax.Calculation`
+* Add support for `related_customer` on parameter classes `stripe.identity.VerificationSession.CreateParams` and `stripe.identity.VerificationSession.ListParams` and resource `stripe.identity.VerificationSession`
+* Add support for `invalid_mandate_reference_prefix_format` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
+* Add support for `girocard` on enums `stripe.PaymentIntent.PaymentMethodOptions.Card.network`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCard.network`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCard.network`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.PaymentMethodOptions.Card.network`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsCard.network`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.Card.network`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsCard.network`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsCard.network`
+* Add support for `financial_addresses.aba.forwarding` on enums `stripe.treasury.FinancialAccount.active_features`, `stripe.treasury.FinancialAccount.pending_features`, and `stripe.treasury.FinancialAccount.restricted_features`
+* Change type of `count` on  `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCardInstallmentsPlan`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCardInstallmentsPlan` from `int` to `NotRequired[int]`
+* Change type of `interval` on  `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCardInstallmentsPlan`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCardInstallmentsPlan` from `Literal['month']` to `NotRequired[Literal['month']]`
+* Change type of `account` on  `stripe.Person.AdditionalTosAcceptances` from `Account` to `Optional[Account]`
diff --git a/.hark/changes/2024-08-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-08-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5c279508a
--- /dev/null
+++ b/.hark/changes/2024-08-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1373
+is_stripe_api_change: true
+released_in_version: 10.8.0
+---
+
+* Add support for `authorization_code` on resource class `stripe.Charge.PaymentMethodDetails.Card`
+* Add support for `wallet` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent`, `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, and `stripe.PaymentMethod.CardPresent`
+* Add support for `mandate_options` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsBacsDebit`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsBacsDebit` and resource class `stripe.PaymentIntent.PaymentMethodOptions.BacsDebit`
+* Add support for `bacs_debit` on parameter classes `stripe.SetupIntent.ConfirmParamsPaymentMethodOptions`, `stripe.SetupIntent.CreateParamsPaymentMethodOptions`, and `stripe.SetupIntent.ModifyParamsPaymentMethodOptions` and resource class `stripe.SetupIntent.PaymentMethodOptions`
+* Add support for `chips` on resource classes `stripe.treasury.OutboundPayment.TrackingDetails.UsDomesticWire` and `stripe.treasury.OutboundTransfer.TrackingDetails.UsDomesticWire` and parameter classes `stripe.treasury.OutboundPayment.UpdateParamsTrackingDetailsUsDomesticWire` and `stripe.treasury.OutboundTransfer.UpdateParamsTrackingDetailsUsDomesticWire`
+* Change type of `imad` on  `stripe.treasury.OutboundPayment.TrackingDetails.UsDomesticWire` and `stripe.treasury.OutboundTransfer.TrackingDetails.UsDomesticWire` from `str` to `Optional[str]`
diff --git a/.hark/changes/2024-08-29_ramya_generate-sdk-openapi.change.md b/.hark/changes/2024-08-29_ramya_generate-sdk-openapi.change.md
new file mode 100644
index 000000000..63d06a727
--- /dev/null
+++ b/.hark/changes/2024-08-29_ramya_generate-sdk-openapi.change.md
@@ -0,0 +1,11 @@
+---
+title: Generate SDK for OpenAPI spec version 1230
+pr_url: https://github.com/stripe/stripe-python/pull/1385
+is_stripe_api_change: true
+released_in_version: 10.9.0
+---
+
+* Add support for `status_details` on resource `stripe.test_helpers.TestClock`
+* Change type of `fields` on  `stripe.AccountLink.CreateParamsCollectionOptions` from `Literal['currently_due', 'eventually_due']` to `NotRequired[Literal['currently_due', 'eventually_due']]`
+* Add support for `hr_oib` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `issuing_regulatory_reporting` on enums `stripe.File.purpose`, `stripe.File.CreateParams.purpose`, and `stripe.File.ListParams.purpose`
diff --git a/.hark/changes/2024-09-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-09-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..07026528d
--- /dev/null
+++ b/.hark/changes/2024-09-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1376
+is_stripe_api_change: true
+released_in_version: 10.10.0
+---
+
+* Add support for `subscription` on parameter class `stripe.billing.Alert.CreateParamsFilter`
+* Change type of `customer_consent_collected` on  `stripe.terminal.Reader.ProcessSetupIntentParams` from `bool` to `NotRequired[bool]`
diff --git a/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..01c6c0c23
--- /dev/null
+++ b/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1391
+is_stripe_api_change: true
+released_in_version: 10.11.0
+---
+
+* Add support for `template` on parameter classes `stripe.Customer.CreateParamsInvoiceSettingsRenderingOptions`, `stripe.Customer.ModifyParamsInvoiceSettingsRenderingOptions`, `stripe.Invoice.CreateParamsRendering`, and `stripe.Invoice.ModifyParamsRendering` and resource classes `stripe.Customer.InvoiceSettings.RenderingOptions` and `stripe.Invoice.Rendering`
+* Add support for resource `stripe.InvoiceRenderingTemplate`
+* Add support for `required` on parameter classes `stripe.PaymentLink.CreateParamsTaxIdCollection`, `stripe.PaymentLink.ModifyParamsTaxIdCollection`, and `stripe.checkout.Session.CreateParamsTaxIdCollection` and resource classes `stripe.PaymentLink.TaxIdCollection` and `stripe.checkout.Session.TaxIdCollection`
+* Add support for `submitted` on enum `stripe.issuing.Card.Shipping.status`
+* Change type of `tax_amounts` on  `stripe.InvoiceLineItem` from `Optional[List[TaxAmount]]` to `List[TaxAmount]`
+* Change type of `tax_rates` on  `stripe.InvoiceLineItem` from `Optional[List[TaxRate]]` to `List[TaxRate]`
+* Change type of `status_details` on  `stripe.test_helpers.TestClock` from `Optional[StatusDetails]` to `StatusDetails`
diff --git a/.hark/changes/2024-09-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..99f5d7518
--- /dev/null
+++ b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1394
+is_stripe_api_change: true
+released_in_version: 10.12.0
+---
+
+* Add support for `international_transaction` on enum `stripe.treasury.ReceivedDebit.failure_code`
diff --git a/.hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 000000000..9b459e770
--- /dev/null
+++ b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1393
+is_stripe_api_change: true
+released_in_version: 10.12.0
+---
+
+* Add support for `payer_details` on resource class `stripe.Charge.PaymentMethodDetails.Klarna`
+* Add support for `amazon_pay` on resource class `stripe.Dispute.PaymentMethodDetails`
+* Add support for `automatically_finalizes_at` on resource `stripe.Invoice`
+* Add support for `state_sales_tax` on resource class `stripe.tax.Registration.CountryOptions.Us` and parameter class `stripe.tax.Registration.CreateParamsCountryOptionsUs`
+* Add support for `verification_supportability` on enums `stripe.Account.FutureRequirements.Error.code`, `stripe.Account.Requirements.Error.code`, `stripe.BankAccount.FutureRequirements.Error.code`, `stripe.BankAccount.Requirements.Error.code`, `stripe.Capability.FutureRequirements.Error.code`, `stripe.Capability.Requirements.Error.code`, `stripe.Person.FutureRequirements.Error.code`, and `stripe.Person.Requirements.Error.code`
+* Add support for `amazon_pay` on enum `stripe.Dispute.PaymentMethodDetails.type`
+* Add support for `terminal_reader_invalid_location_for_activation` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
diff --git a/.hark/changes/2024-10-01_ramya_support-apis-new.change.md b/.hark/changes/2024-10-01_ramya_support-apis-new.change.md
new file mode 100644
index 000000000..724161eb5
--- /dev/null
+++ b/.hark/changes/2024-10-01_ramya_support-apis-new.change.md
@@ -0,0 +1,35 @@
+---
+title: Support for APIs in the new API version 2024-09-30.acacia
+pr_url: https://github.com/stripe/stripe-python/pull/1404
+is_stripe_api_change: true
+released_in_version: 11.0.0
+---
+
+This release changes the pinned API version to `2024-09-30.acacia`. Please read the [API Changelog](https://docs.stripe.com/changelog/acacia#2024-09-30.acacia) and carefully review the API changes before upgrading.
+
+### ⚠️ Breaking changes due to changes in the API
+
+
+* Rename for `usage_threshold_config` to `usage_threshold` on parameter class `stripe.billing.Alert.CreateParams` and resource `stripe.billing.Alert`
+* Remove support for `filter` on parameter class `stripe.billing.Alert.CreateParams` and resource `stripe.billing.Alert`. Use the filters on the `usage_threshold` instead
+* * Remove support for `customer_consent_collected` on parameter class `stripe.terminal.Reader.ProcessSetupIntentParams`
+
+### ⚠️ Other Breaking changes in the SDK
+* Adjusted default values for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
+  - max retries: `0` -> `2`
+  - max timeout (seconds): `2` -> `5`
+
+### Additions
+
+* Add support for `custom_unit_amount` on parameter class `stripe.Product.CreateParamsDefaultPriceData`
+* Add support for `usage_threshold` on parameter class `stripe.billing.Alert.CreateParams` and resource `stripe.billing.Alert`
+* Add support for `allow_redisplay` on parameter classes `stripe.terminal.Reader.ProcessPaymentIntentParamsProcessConfig` and `stripe.terminal.Reader.ProcessSetupIntentParams`
+* Add support for `international_transaction` on enum `stripe.treasury.ReceivedCredit.failure_code`
+* Add support for `2024-09-30.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+* Add support for new Usage Billing APIs `stripe.v2.billing.MeterEvent`, `stripe.v2.billing.MeterEventAdjustments`, `stripe.v2.billing.MeterEventSession`, `stripe.v2.billing.MeterEventStream` and the new Events API `stripe.v2.core.Events` under the [v2 namespace ](https://docs.corp.stripe.com/api-v2-overview)
+* Add method [rawRequest()](https://github.com/stripe/stripe-python/tree/master?tab=readme-ov-file#custom-requests) on the `StripeClient` class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.
+* Add method `parse_thin_event()` on the `StripeClient` class to parse [thin events](https://docs.corp.stripe.com/event-destinations#events-overview)
+
+### Other changes
+* Change type of `default_allowed_updates` on  `stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate` from `Union[Literal[''], List[Literal['price', 'promotion_code', 'quantity']]]` to `NotRequired[Literal['']|List[Literal['price', 'promotion_code', 'quantity']]]`
+* Change type of `products` on  `stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate` from `Union[Literal[''], List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]]` to `NotRequired[Literal['']|List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]]`
diff --git a/.hark/changes/2024-10-03_ramya_update-class-thinevent.change.md b/.hark/changes/2024-10-03_ramya_update-class-thinevent.change.md
new file mode 100644
index 000000000..a7098e926
--- /dev/null
+++ b/.hark/changes/2024-10-03_ramya_update-class-thinevent.change.md
@@ -0,0 +1,5 @@
+---
+title: Update the class for `ThinEvent` to include `livemode`
+pr_url: https://github.com/stripe/stripe-python/pull/1409
+released_in_version: 11.1.0
+---
diff --git a/.hark/changes/2024-10-03_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-10-03_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9ffcd721b
--- /dev/null
+++ b/.hark/changes/2024-10-03_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1408
+is_stripe_api_change: true
+released_in_version: 11.1.0
+---
+
+* Remove the support for resource `Margin` that was accidentally made public in the last release
diff --git a/.hark/changes/2024-10-09_jar_clean-up-examples.change.md b/.hark/changes/2024-10-09_jar_clean-up-examples.change.md
new file mode 100644
index 000000000..8f3115f11
--- /dev/null
+++ b/.hark/changes/2024-10-09_jar_clean-up-examples.change.md
@@ -0,0 +1,5 @@
+---
+title: Clean up examples
+pr_url: https://github.com/stripe/stripe-python/pull/1412
+released_in_version: 11.1.1
+---
diff --git a/.hark/changes/2024-10-18_helenye_deserialize-correct-v2.change.md b/.hark/changes/2024-10-18_helenye_deserialize-correct-v2.change.md
new file mode 100644
index 000000000..6e1a33c56
--- /dev/null
+++ b/.hark/changes/2024-10-18_helenye_deserialize-correct-v2.change.md
@@ -0,0 +1,7 @@
+---
+title: Deserialize into correct v2 EventData types
+pr_url: https://github.com/stripe/stripe-python/pull/1414
+released_in_version: 11.1.1
+---
+
+* Fixes a bug where v2 EventData was not being deserialized into the appropriate type for `V1BillingMeterErrorReportTriggeredEvent` and `V1BillingMeterNoMeterFoundEvent`
diff --git a/.hark/changes/2024-10-18_xavdid_update-object-tags.change.md b/.hark/changes/2024-10-18_xavdid_update-object-tags.change.md
new file mode 100644
index 000000000..60a2fb4e7
--- /dev/null
+++ b/.hark/changes/2024-10-18_xavdid_update-object-tags.change.md
@@ -0,0 +1,7 @@
+---
+title: update object tags for meter-related classes
+pr_url: https://github.com/stripe/stripe-python/pull/1415
+released_in_version: 11.1.1
+---
+
+- fixes a bug where the `object` property of the `MeterEvent`, `MeterEventAdjustment`, and `MeterEventSession` didn't match the server.
diff --git a/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..af9f57305
--- /dev/null
+++ b/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,38 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1411
+is_stripe_api_change: true
+released_in_version: 11.2.0
+---
+
+* Add support for resource `stripe.v2.EventDestinations`
+* Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
+* Add support for `alma_payments`, `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `groups` on parameter class `stripe.Account.CreateParams` and resource `stripe.Account`
+* Add support for `disable_stripe_user_authentication` on resource classes `stripe.AccountSession.Components.AccountManagement.Features`, `stripe.AccountSession.Components.AccountOnboarding.Features`, `stripe.AccountSession.Components.Balances.Features`, `stripe.AccountSession.Components.NotificationBanner.Features`, and `stripe.AccountSession.Components.Payouts.Features` and parameter classes `stripe.AccountSession.CreateParamsComponentsAccountManagementFeatures`, `stripe.AccountSession.CreateParamsComponentsAccountOnboardingFeatures`, `stripe.AccountSession.CreateParamsComponentsBalancesFeatures`, `stripe.AccountSession.CreateParamsComponentsNotificationBannerFeatures`, and `stripe.AccountSession.CreateParamsComponentsPayoutsFeatures`
+* Add support for `alma` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.PaymentIntent.PaymentMethodOptions`, and `stripe.Refund.DestinationDetails`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethodConfiguration.CreateParams`, `stripe.PaymentMethodConfiguration.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and resources `stripe.PaymentMethod` and `stripe.PaymentMethodConfiguration`
+* Add support for `kakao_pay`, `kr_card` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.Mandate.PaymentMethodDetails`, `stripe.PaymentIntent.PaymentMethodOptions`, `stripe.SetupAttempt.PaymentMethodDetails`, and `stripe.checkout.Session.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resource `stripe.PaymentMethod`
+* Add support for `naver_pay` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.PaymentIntent.PaymentMethodOptions`, and `stripe.checkout.Session.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethod.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resource `stripe.PaymentMethod`
+* Add support for `payco`, `samsung_pay` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, `stripe.PaymentIntent.PaymentMethodOptions`, and `stripe.checkout.Session.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resource `stripe.PaymentMethod`
+* Add support for `enhanced_evidence` on resource class `stripe.Dispute.Evidence` and parameter class `stripe.Dispute.ModifyParamsEvidence`
+* Add support for `enhanced_eligibility` on resource class `stripe.Dispute.EvidenceDetails`
+* Add support for `enhanced_eligibility_types` on resource `stripe.Dispute`
+* Add support for `automatically_finalizes_at` on parameter classes `stripe.Invoice.CreateParams` and `stripe.Invoice.ModifyParams`
+* Add support for `amazon_pay` on resource `stripe.PaymentMethodDomain`
+* Add support for `flat_amount`, `rate_type` on resource `stripe.TaxRate` and resource class `stripe.tax.Calculation.TaxBreakdown.TaxRateDetails`
+* Add support for `schedule_at_period_end` on parameter classes `stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate` and `stripe.billing_portal.Configuration.ModifyParamsFeaturesSubscriptionUpdate` and resource class `stripe.billing_portal.Configuration.Features.SubscriptionUpdate`
+* Add support for `metadata` on parameter class `stripe.forwarding.Request.CreateParams` and resource `stripe.forwarding.Request`
+* Add support for `_cls_submit_card` on resource `stripe.issuing.Card`
+* Add support for `submit_card` on resource `stripe.issuing.Card`
+* Add support for `by`, `cr`, `ec`, `ma`, `md`, `rs`, `ru`, `tz`, `uz` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `pln` on parameter classes `stripe.terminal.Configuration.CreateParamsTipping` and `stripe.terminal.Configuration.ModifyParamsTipping` and resource class `stripe.terminal.Configuration.Tipping`
+* Change type of `business_profile` on  `stripe.billing_portal.Configuration.CreateParams` from `Configuration.CreateParamsBusinessProfile` to `NotRequired[Configuration.CreateParamsBusinessProfile]`
+* Add support for `by_tin`, `ma_vat`, `md_vat`, `tz_vat`, `uz_tin`, `uz_vat` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `alma`, `kakao_pay`, `kr_card`, `naver_pay`, `payco` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, `stripe.PaymentLink.ModifyParams.payment_method_types`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `samsung_pay` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `auto` on enum `stripe.Customer.ModifyParamsTax.validate_location`
+* Add support for `issuing_transaction.purchase_details_receipt_updated`, `refund.failed` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for `jp_credit_transfer` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
+* Add support for `retail_delivery_fee` on enums `stripe.Invoice.AddLinesParamsLineTaxAmountTaxRateData.tax_type`, `stripe.Invoice.UpdateLinesParamsLineTaxAmountTaxRateData.tax_type`, `stripe.InvoiceLineItem.ModifyParamsTaxAmountTaxRateData.tax_type`, `stripe.tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.Calculation.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.CalculationLineItem.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.TaxRate.tax_type`, `stripe.TaxRate.CreateParams.tax_type`, and `stripe.TaxRate.ModifyParams.tax_type`
+* Add support for `state_retail_delivery_fee` on enums `stripe.tax.Registration.CountryOptions.Us.type` and `stripe.tax.Registration.CreateParamsCountryOptionsUs.type`
+* Add support for `2024-10-28.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
diff --git a/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c5da18736
--- /dev/null
+++ b/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,28 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1424
+is_stripe_api_change: true
+released_in_version: 11.3.0
+---
+
+* Add support for `authorizer` on parameter classes `stripe.Account.CreatePersonParamsRelationship`, `stripe.Account.ListPersonsParamsRelationship`, `stripe.Account.ModifyPersonParamsRelationship`, `stripe.Account.PersonsParamsRelationship`, and `stripe.Token.CreateParamsPersonRelationship` and resource class `stripe.Person.Relationship`
+* Add support for `account_holder_address`, `account_holder_name`, `account_type` and `bank_address` on resource classes `stripe.FundingInstructions.BankTransfer.FinancialAddress.Aba`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Swift`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Aba`, and `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Swift`
+* Add support for `submit_type` on parameter class `stripe.PaymentLink.ModifyParams`
+* Add support for `trace_id` on resource `stripe.Payout`
+* Add support for `network_decline_code` on resource classes `stripe.Refund.DestinationDetails.Blik` and `stripe.Refund.DestinationDetails.Swish`
+* Add support for `adaptive_pricing` on parameter class `stripe.checkout.Session.CreateParams` and resource `stripe.checkout.Session`
+* Add support for `mandate_options` on parameter classes `stripe.checkout.Session.CreateParamsPaymentMethodOptionsBacsDebit` and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSepaDebit` and resource classes `stripe.checkout.Session.PaymentMethodOptions.BacsDebit` and `stripe.checkout.Session.PaymentMethodOptions.SepaDebit`
+* Add support for `request_extended_authorization`, `request_incremental_authorization`, `request_multicapture` and `request_overcapture` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptionsCard` and resource class `stripe.checkout.Session.PaymentMethodOptions.Card`
+* Add support for `capture_method` on parameter classes `stripe.checkout.Session.CreateParamsPaymentMethodOptionsKakaoPay`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsKrCard`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsNaverPay`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsPayco`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSamsungPay`
+* Add support for `merchant_amount` and `merchant_currency` on parameter class `stripe.issuing.Authorization.CreateParams`
+* Add support for `fraud_challenges`, `verified_by_fraud_challenge` and `respond` on resource `stripe.issuing.Authorization`
+* Change type of `disabled_reason` on  `stripe.Account.FutureRequirements` and `stripe.Account.Requirements` from `str` to `Literal['action_required.requested_capabilities', 'listed', 'other', 'platform_paused', 'rejected.fraud', 'rejected.incomplete_verification', 'rejected.listed', 'rejected.other', 'rejected.platform_fraud', 'rejected.platform_other', 'rejected.platform_terms_of_service', 'rejected.terms_of_service', 'requirements.past_due', 'requirements.pending_verification', 'under_review']`
+* Change type of `disable_stripe_user_authentication` on  `stripe.AccountSession.Components.AccountManagement.Features`, `stripe.AccountSession.Components.AccountOnboarding.Features`, `stripe.AccountSession.Components.Balances.Features`, `stripe.AccountSession.Components.NotificationBanner.Features`, and `stripe.AccountSession.Components.Payouts.Features` from `Optional[bool]` to `bool`
+* Add support for `subscribe` on enums `stripe.checkout.Session.submit_type`, `stripe.checkout.Session.CreateParams.submit_type`, `stripe.PaymentLink.submit_type`, and `stripe.PaymentLink.CreateParams.submit_type`
+* Add support for `li_vat` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `financial_account_statement` on enums `stripe.File.purpose` and `stripe.File.ListParams.purpose`
+* Add support for `service_tax` on enums `stripe.Invoice.AddLinesParamsLineTaxAmountTaxRateData.tax_type`, `stripe.Invoice.UpdateLinesParamsLineTaxAmountTaxRateData.tax_type`, `stripe.InvoiceLineItem.ModifyParamsTaxAmountTaxRateData.tax_type`, `stripe.tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.Calculation.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.CalculationLineItem.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetails.tax_type`, `stripe.TaxRate.tax_type`, `stripe.TaxRate.CreateParams.tax_type`, and `stripe.TaxRate.ModifyParams.tax_type`
+* Add support for `link` on enums `stripe.PaymentIntent.PaymentMethodOptions.Card.network`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCard.network`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCard.network`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.PaymentMethodOptions.Card.network`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsCard.network`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsCard.network`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.Card.network`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsCard.network`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsCard.network`
+* Add support for `2024-11-20.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+* Change type of `amount` on  `stripe.issuing.Authorization.CreateParams` from `int` to `NotRequired[int]`
+* Change type of `origin_payment_method` on  `stripe.treasury.InboundTransfer` from `str` to `Optional[str]`
diff --git a/.hark/changes/2024-12-12_xavdid_fix-deprecation-warning.change.md b/.hark/changes/2024-12-12_xavdid_fix-deprecation-warning.change.md
new file mode 100644
index 000000000..f729ff99b
--- /dev/null
+++ b/.hark/changes/2024-12-12_xavdid_fix-deprecation-warning.change.md
@@ -0,0 +1,5 @@
+---
+title: fix deprecation warning in httpx @ 0.28
+pr_url: https://github.com/stripe/stripe-python/pull/1431
+released_in_version: 11.4.0
+---
diff --git a/.hark/changes/2024-12-16_jar_fix-stripeerror-httpbody.change.md b/.hark/changes/2024-12-16_jar_fix-stripeerror-httpbody.change.md
new file mode 100644
index 000000000..bb67ae249
--- /dev/null
+++ b/.hark/changes/2024-12-16_jar_fix-stripeerror-httpbody.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix StripeError http_body
+pr_url: https://github.com/stripe/stripe-python/pull/1435
+released_in_version: 11.4.0
+---
+
+- Fixes an issue where `StripeError.http_body` may be None even when `json_body` is a valid dictionary.
diff --git a/.hark/changes/2024-12-17_xavdid_fix-using-autopagingit.change.md b/.hark/changes/2024-12-17_xavdid_fix-using-autopagingit.change.md
new file mode 100644
index 000000000..d4f33221e
--- /dev/null
+++ b/.hark/changes/2024-12-17_xavdid_fix-using-autopagingit.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix using `auto_paging_iter()` with `expand: [...]`"
+pr_url: https://github.com/stripe/stripe-python/pull/1434
+released_in_version: 11.4.0
+---
diff --git a/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4b555abf9
--- /dev/null
+++ b/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,68 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1430
+is_stripe_api_change: true
+released_in_version: 11.4.0
+---
+
+* Add support for `allow_redisplay` on resources `stripe.Card` and `stripe.Source`
+* Add support for `regulated_status` on resource `stripe.Card` and resource classes `stripe.Charge.PaymentMethodDetails.Card`, `stripe.ConfirmationToken.PaymentMethodPreview.Card`, and `stripe.PaymentMethod.Card`
+* Add support for `network_advice_code` on resource classes `stripe.Charge.Outcome`, `stripe.Invoice.LastFinalizationError`, `stripe.PaymentIntent.LastPaymentError`, `stripe.SetupAttempt.SetupError`, and `stripe.SetupIntent.LastSetupError`
+* Add support for `network_decline_code` on resource classes `stripe.Charge.Outcome`, `stripe.Invoice.LastFinalizationError`, `stripe.PaymentIntent.LastPaymentError`, `stripe.SetupAttempt.SetupError`, and `stripe.SetupIntent.LastSetupError`
+* Add support for `funding` on resource classes `stripe.Charge.PaymentMethodDetails.AmazonPay` and `stripe.Charge.PaymentMethodDetails.RevolutPay`
+* Add support for `network_transaction_id` on resource class `stripe.Charge.PaymentMethodDetails.Card`
+* Add support for `visa_compliance` on resource classes `stripe.Dispute.Evidence.EnhancedEvidence` and `stripe.Dispute.EvidenceDetails.EnhancedEligibility` and parameter class `stripe.Dispute.ModifyParamsEvidenceEnhancedEvidence`
+* Add support for `account_holder_address` on resource classes `stripe.FundingInstructions.BankTransfer.FinancialAddress.Iban`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.SortCode`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Spei`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Zengin`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Iban`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.SortCode`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Spei`, and `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Zengin`
+* Add support for `bank_address` on resource classes `stripe.FundingInstructions.BankTransfer.FinancialAddress.Iban`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.SortCode`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Spei`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Zengin`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Iban`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.SortCode`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Spei`, and `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Zengin`
+* Add support for `account_holder_name` on resource classes `stripe.FundingInstructions.BankTransfer.FinancialAddress.Spei` and `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Spei`
+* Add support for `disabled_reason` on resource classes `stripe.Invoice.AutomaticTax`, `stripe.Subscription.AutomaticTax`, `stripe.SubscriptionSchedule.DefaultSettings.AutomaticTax`, and `stripe.SubscriptionSchedule.Phase.AutomaticTax`
+* Add support for `reference_prefix` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsBacsDebitMandateOptions`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsSepaDebitMandateOptions`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsBacsDebitMandateOptions`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSepaDebitMandateOptions` and resource classes `stripe.PaymentIntent.PaymentMethodOptions.BacsDebit.MandateOptions`, `stripe.PaymentIntent.PaymentMethodOptions.SepaDebit.MandateOptions`, `stripe.SetupIntent.PaymentMethodOptions.BacsDebit.MandateOptions`, `stripe.SetupIntent.PaymentMethodOptions.SepaDebit.MandateOptions`, `stripe.checkout.Session.PaymentMethodOptions.BacsDebit.MandateOptions`, and `stripe.checkout.Session.PaymentMethodOptions.SepaDebit.MandateOptions`
+* Add support for `trial_period_days` on parameter class `stripe.PaymentLink.ModifyParamsSubscriptionData`
+* Add support for `credits_application_invoice_voided` on resource class `stripe.billing.CreditBalanceTransaction.Credit`
+* Add support for `tax_id` on resource classes `stripe.issuing.Authorization.MerchantData` and `stripe.issuing.Transaction.MerchantData`
+* Add support for `al` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `am` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `ao` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `ba` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `bb` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `bs` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `cd` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `gn` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `kh` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `me` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `mk` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `mr` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `np` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `pe` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `sn` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `sr` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `tj` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `ug` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `uy` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `zm` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `zw` on resource class `stripe.tax.Registration.CountryOptions` and parameter class `stripe.tax.Registration.CreateParamsCountryOptions`
+* Add support for `payout_minimum_balance_hold` on enum `stripe.BalanceTransaction.type`
+* Add support for `payout_minimum_balance_release` on enum `stripe.BalanceTransaction.type`
+* Add support for `credits_application_invoice_voided` on enum `stripe.billing.CreditBalanceTransaction.Credit.type`
+* Add support for `al_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `am_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `ao_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `ba_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `bb_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `bs_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `cd_nif` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `gn_nif` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `kh_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `me_pib` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `mk_vat` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `mr_nif` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `np_pan` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `sn_ninea` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `sr_fin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `tj_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `ug_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `zm_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `zw_tin` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
+* Add support for `request_signature` on enums `stripe.forwarding.Request.replacements` and `stripe.forwarding.Request.CreateParams.replacements`
+* Add support for `2024-12-18.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+* Change type of `schedule_at_period_end` on  `stripe.billing_portal.Configuration.Features.SubscriptionUpdate` from `Optional[ScheduleAtPeriodEnd]` to `ScheduleAtPeriodEnd`
diff --git a/.hark/changes/2024-12-19_jar_fix-regression-using.change.md b/.hark/changes/2024-12-19_jar_fix-regression-using.change.md
new file mode 100644
index 000000000..6f26746ff
--- /dev/null
+++ b/.hark/changes/2024-12-19_jar_fix-regression-using.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix regression when using httpx HTTP client
+pr_url: https://github.com/stripe/stripe-python/pull/1438
+released_in_version: 11.4.1
+---
diff --git a/.hark/changes/2025-01-13_jar_fix-v2-listobject.change.md b/.hark/changes/2025-01-13_jar_fix-v2-listobject.change.md
new file mode 100644
index 000000000..942e27022
--- /dev/null
+++ b/.hark/changes/2025-01-13_jar_fix-v2-listobject.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix V2 ListObject.data type hint
+pr_url: https://github.com/stripe/stripe-python/pull/1442
+released_in_version: 11.6.0
+---
+
+- Change `stripe.v2.ListObject.data` type hint from `List[StripeObject]` to `List[T]` where T is the specific stripe object contained within the list
diff --git a/.hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md b/.hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md
new file mode 100644
index 000000000..6c410d48e
--- /dev/null
+++ b/.hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix V2 ListObject.data type hint
+pr_url: https://github.com/stripe/stripe-python/pull/1442
+released_in_version: 11.5.0
+---
+
+- Change `stripe.v2.ListObject.data` type hint from `List[StripeObject]` to `List[T]` where T is the specific stripe object contained within the list
diff --git a/.hark/changes/2025-01-14_xavdid_add-justfile-update.change.md b/.hark/changes/2025-01-14_xavdid_add-justfile-update.change.md
new file mode 100644
index 000000000..e11e2b767
--- /dev/null
+++ b/.hark/changes/2025-01-14_xavdid_add-justfile-update.change.md
@@ -0,0 +1,5 @@
+---
+title: add justfile, update readme, remove coveralls
+pr_url: https://github.com/stripe/stripe-python/pull/1440
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md b/.hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md
new file mode 100644
index 000000000..35b1b7618
--- /dev/null
+++ b/.hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md
@@ -0,0 +1,5 @@
+---
+title: add justfile, update readme, remove coveralls
+pr_url: https://github.com/stripe/stripe-python/pull/1440
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes.change.md b/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes.change.md
new file mode 100644
index 000000000..e190e466f
--- /dev/null
+++ b/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes.change.md
@@ -0,0 +1,5 @@
+---
+title: minor justfile fixes & pin CI version
+pr_url: https://github.com/stripe/stripe-python/pull/1445
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md b/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md
new file mode 100644
index 000000000..f21af32af
--- /dev/null
+++ b/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md
@@ -0,0 +1,5 @@
+---
+title: minor justfile fixes & pin CI version
+pr_url: https://github.com/stripe/stripe-python/pull/1445
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-17_jar_added-contributing-md.change.md b/.hark/changes/2025-01-17_jar_added-contributing-md.change.md
new file mode 100644
index 000000000..ff23e6d21
--- /dev/null
+++ b/.hark/changes/2025-01-17_jar_added-contributing-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Added CONTRIBUTING.md file
+pr_url: https://github.com/stripe/stripe-python/pull/1444
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-17_jar_added-contributing-md_2.change.md b/.hark/changes/2025-01-17_jar_added-contributing-md_2.change.md
new file mode 100644
index 000000000..ff4aebcc5
--- /dev/null
+++ b/.hark/changes/2025-01-17_jar_added-contributing-md_2.change.md
@@ -0,0 +1,5 @@
+---
+title: Added CONTRIBUTING.md file
+pr_url: https://github.com/stripe/stripe-python/pull/1444
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-21_xavdid_add-just-publish.change.md b/.hark/changes/2025-01-21_xavdid_add-just-publish.change.md
new file mode 100644
index 000000000..020a2055c
--- /dev/null
+++ b/.hark/changes/2025-01-21_xavdid_add-just-publish.change.md
@@ -0,0 +1,5 @@
+---
+title: add just to publish CI
+pr_url: https://github.com/stripe/stripe-python/pull/1446
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md b/.hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md
new file mode 100644
index 000000000..35f2074b9
--- /dev/null
+++ b/.hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md
@@ -0,0 +1,5 @@
+---
+title: add just to publish CI
+pr_url: https://github.com/stripe/stripe-python/pull/1446
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact.change.md b/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact.change.md
new file mode 100644
index 000000000..61e40a949
--- /dev/null
+++ b/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated upload artifact ci action
+pr_url: https://github.com/stripe/stripe-python/pull/1448
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md b/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md
new file mode 100644
index 000000000..db084b3f0
--- /dev/null
+++ b/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated upload artifact ci action
+pr_url: https://github.com/stripe/stripe-python/pull/1448
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-27_helenye_revert-bump-version.change.md b/.hark/changes/2025-01-27_helenye_revert-bump-version.change.md
new file mode 100644
index 000000000..549f19cfb
--- /dev/null
+++ b/.hark/changes/2025-01-27_helenye_revert-bump-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Revert "Bump version to 11.5.0"
+pr_url: https://github.com/stripe/stripe-python/pull/1452
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-27_helenye_upgrade-download-artifact.change.md b/.hark/changes/2025-01-27_helenye_upgrade-download-artifact.change.md
new file mode 100644
index 000000000..f66d9a780
--- /dev/null
+++ b/.hark/changes/2025-01-27_helenye_upgrade-download-artifact.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade to download-artifact@v4
+pr_url: https://github.com/stripe/stripe-python/pull/1451
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md b/.hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md
new file mode 100644
index 000000000..2b6052368
--- /dev/null
+++ b/.hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade to download-artifact@v4
+pr_url: https://github.com/stripe/stripe-python/pull/1451
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e754aa88f
--- /dev/null
+++ b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,32 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1443
+is_stripe_api_change: true
+released_in_version: 11.6.0
+---
+
+* Add support for `pay_by_bank_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `directorship_declaration` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
+* Add support for `ownership_exemption_reason` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
+* Add support for `proof_of_ultimate_beneficial_ownership` on parameter class `stripe.Account.CreateParamsDocuments`
+* Add support for `financial_account` on resource classes `stripe.AccountSession.Components` and `stripe.treasury.OutboundTransfer.DestinationPaymentMethodDetails` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `issuing_card` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `advice_code` on resource classes `stripe.Charge.Outcome`, `stripe.Invoice.LastFinalizationError`, `stripe.PaymentIntent.LastPaymentError`, `stripe.SetupAttempt.SetupError`, and `stripe.SetupIntent.LastSetupError`
+* Add support for `country` on resource classes `stripe.Charge.PaymentMethodDetails.Paypal`, `stripe.ConfirmationToken.PaymentMethodPreview.Paypal`, and `stripe.PaymentMethod.Paypal`
+* Add support for `pay_by_bank` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, and `stripe.PaymentIntent.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethod.ModifyParams`, `stripe.PaymentMethodConfiguration.CreateParams`, `stripe.PaymentMethodConfiguration.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resources `stripe.PaymentMethod` and `stripe.PaymentMethodConfiguration`
+* Add support for `phone_number_collection` on parameter class `stripe.PaymentLink.ModifyParams`
+* Add support for `discounts` on resource `stripe.checkout.Session`
+* Add support for `jpy` on parameter classes `stripe.terminal.Configuration.CreateParamsTipping` and `stripe.terminal.Configuration.ModifyParamsTipping` and resource class `stripe.terminal.Configuration.Tipping`
+* Add support for `nickname` on parameter classes `stripe.treasury.FinancialAccount.CreateParams` and `stripe.treasury.FinancialAccount.ModifyParams` and resource `stripe.treasury.FinancialAccount`
+* Add support for `forwarding_settings` on parameter class `stripe.treasury.FinancialAccount.ModifyParams`
+* Add support for `_cls_close` on resource `stripe.treasury.FinancialAccount`
+* Add support for `close` on resource `stripe.treasury.FinancialAccount`
+* Add support for `is_default` on resource `stripe.treasury.FinancialAccount`
+* Add support for `destination_payment_method_data` on parameter class `stripe.treasury.OutboundTransfer.CreateParams`
+* Add support for `outbound_transfer` on resource class `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails`
+* Add support for `SD` on enums `stripe.checkout.Session.ShippingAddressCollection.allowed_countries`, `stripe.checkout.Session.CreateParamsShippingAddressCollection.allowed_countries`, `stripe.PaymentLink.ShippingAddressCollection.allowed_countries`, `stripe.PaymentLink.CreateParamsShippingAddressCollection.allowed_countries`, and `stripe.PaymentLink.ModifyParamsShippingAddressCollection.allowed_countries`
+* Add support for `pay_by_bank` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, `stripe.PaymentLink.ModifyParams.payment_method_types`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `financial_account` on enum `stripe.treasury.OutboundTransfer.DestinationPaymentMethodDetails.type`
+* Add support for `outbound_transfer` on enums `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails.type` and `stripe.treasury.ReceivedCredit.ListParamsLinkedFlows.source_flow_type`
+* Add support for `2025-01-27.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+* Change type of `pretax_credit_amounts` on  `stripe.CreditNote` and `stripe.CreditNoteLineItem` from `Optional[List[PretaxCreditAmount]]` to `List[PretaxCreditAmount]`
diff --git a/.hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 000000000..494c006c6
--- /dev/null
+++ b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,32 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1443
+is_stripe_api_change: true
+released_in_version: 11.5.0
+---
+
+* Add support for `pay_by_bank_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
+* Add support for `directorship_declaration` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
+* Add support for `ownership_exemption_reason` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
+* Add support for `proof_of_ultimate_beneficial_ownership` on parameter class `stripe.Account.CreateParamsDocuments`
+* Add support for `financial_account` on resource classes `stripe.AccountSession.Components` and `stripe.treasury.OutboundTransfer.DestinationPaymentMethodDetails` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `issuing_card` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
+* Add support for `advice_code` on resource classes `stripe.Charge.Outcome`, `stripe.Invoice.LastFinalizationError`, `stripe.PaymentIntent.LastPaymentError`, `stripe.SetupAttempt.SetupError`, and `stripe.SetupIntent.LastSetupError`
+* Add support for `country` on resource classes `stripe.Charge.PaymentMethodDetails.Paypal`, `stripe.ConfirmationToken.PaymentMethodPreview.Paypal`, and `stripe.PaymentMethod.Paypal`
+* Add support for `pay_by_bank` on resource classes `stripe.Charge.PaymentMethodDetails`, `stripe.ConfirmationToken.PaymentMethodPreview`, and `stripe.PaymentIntent.PaymentMethodOptions`, parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptions`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptions`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethod.ModifyParams`, `stripe.PaymentMethodConfiguration.CreateParams`, `stripe.PaymentMethodConfiguration.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, `stripe.SetupIntent.ModifyParamsPaymentMethodData`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptions`, and resources `stripe.PaymentMethod` and `stripe.PaymentMethodConfiguration`
+* Add support for `phone_number_collection` on parameter class `stripe.PaymentLink.ModifyParams`
+* Add support for `discounts` on resource `stripe.checkout.Session`
+* Add support for `jpy` on parameter classes `stripe.terminal.Configuration.CreateParamsTipping` and `stripe.terminal.Configuration.ModifyParamsTipping` and resource class `stripe.terminal.Configuration.Tipping`
+* Add support for `nickname` on parameter classes `stripe.treasury.FinancialAccount.CreateParams` and `stripe.treasury.FinancialAccount.ModifyParams` and resource `stripe.treasury.FinancialAccount`
+* Add support for `forwarding_settings` on parameter class `stripe.treasury.FinancialAccount.ModifyParams`
+* Add support for `_cls_close` on resource `stripe.treasury.FinancialAccount`
+* Add support for `close` on resource `stripe.treasury.FinancialAccount`
+* Add support for `is_default` on resource `stripe.treasury.FinancialAccount`
+* Add support for `destination_payment_method_data` on parameter class `stripe.treasury.OutboundTransfer.CreateParams`
+* Add support for `outbound_transfer` on resource class `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails`
+* Add support for `SD` on enums `stripe.checkout.Session.ShippingAddressCollection.allowed_countries`, `stripe.checkout.Session.CreateParamsShippingAddressCollection.allowed_countries`, `stripe.PaymentLink.ShippingAddressCollection.allowed_countries`, `stripe.PaymentLink.CreateParamsShippingAddressCollection.allowed_countries`, and `stripe.PaymentLink.ModifyParamsShippingAddressCollection.allowed_countries`
+* Add support for `pay_by_bank` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, `stripe.PaymentLink.ModifyParams.payment_method_types`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
+* Add support for `financial_account` on enum `stripe.treasury.OutboundTransfer.DestinationPaymentMethodDetails.type`
+* Add support for `outbound_transfer` on enums `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails.type` and `stripe.treasury.ReceivedCredit.ListParamsLinkedFlows.source_flow_type`
+* Add support for `2025-01-27.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+* Change type of `pretax_credit_amounts` on  `stripe.CreditNote` and `stripe.CreditNoteLineItem` from `Optional[List[PretaxCreditAmount]]` to `List[PretaxCreditAmount]`
diff --git a/.hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md b/.hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md
new file mode 100644
index 000000000..366f8fcdb
--- /dev/null
+++ b/.hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md
@@ -0,0 +1,5 @@
+---
+title: add codeowners file
+pr_url: https://github.com/stripe/stripe-python/pull/1457
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-02-13_xavdid_upgrade-ruff-version.change.md b/.hark/changes/2025-02-13_xavdid_upgrade-ruff-version.change.md
new file mode 100644
index 000000000..9210d9648
--- /dev/null
+++ b/.hark/changes/2025-02-13_xavdid_upgrade-ruff-version.change.md
@@ -0,0 +1,5 @@
+---
+title: upgrade ruff version
+pr_url: https://github.com/stripe/stripe-python/pull/1456
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-02-18_helenye_remove-incorrect-changelog.change.md b/.hark/changes/2025-02-18_helenye_remove-incorrect-changelog.change.md
new file mode 100644
index 000000000..2a4f8580d
--- /dev/null
+++ b/.hark/changes/2025-02-18_helenye_remove-incorrect-changelog.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove incorrect changelog entry about parse_snapshot_event
+pr_url: https://github.com/stripe/stripe-python/pull/1461
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e67288498
--- /dev/null
+++ b/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1450
+is_stripe_api_change: true
+released_in_version: 11.6.0
+---
+
+* Add support for `target_date` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccount`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSepaDebit`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsUsBankAccount` and resource classes `stripe.PaymentIntent.PaymentMethodOptions.AcssDebit`, `stripe.PaymentIntent.PaymentMethodOptions.AuBecsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.BacsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.SepaDebit`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount`, `stripe.checkout.Session.PaymentMethodOptions.AcssDebit`, `stripe.checkout.Session.PaymentMethodOptions.AuBecsDebit`, `stripe.checkout.Session.PaymentMethodOptions.BacsDebit`, `stripe.checkout.Session.PaymentMethodOptions.SepaDebit`, and `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount`
+* Add support for `metadata` on parameter class `stripe.Product.CreateParamsDefaultPriceData`
+* Add support for `prices` on parameter classes `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` and resource class `stripe.billing.CreditGrant.ApplicabilityConfig.Scope`
+* Add support for `priority` on parameter class `stripe.billing.CreditGrant.CreateParams` and resource `stripe.billing.CreditGrant`
+* Add support for `restrictions` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptionsCard` and resource class `stripe.checkout.Session.PaymentMethodOptions.Card`
+* Add support for `collected_information` on parameter class `stripe.checkout.Session.ModifyParams` and resource `stripe.checkout.Session`
+* Change type of `price_type` on  `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` from `Literal['metered']` to `NotRequired[Literal['metered']]`
+* Change type of `price_type` on  `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` from `Literal['metered']` to `Optional[Literal['metered']]`
+* Add support for `2025-02-24.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
diff --git a/.hark/changes/2025-03-19_ramya_fix-incorrect-property.change.md b/.hark/changes/2025-03-19_ramya_fix-incorrect-property.change.md
new file mode 100644
index 000000000..8bd552b94
--- /dev/null
+++ b/.hark/changes/2025-03-19_ramya_fix-incorrect-property.change.md
@@ -0,0 +1,10 @@
+---
+title: Fix incorrect property name on `ThinEvent.related_object.type`
+pr_url: https://github.com/stripe/stripe-python/pull/1471
+semver_level: major
+section: ⚠️ Other Breaking changes in the SDK
+released_in_version: 12.0.0
+---
+
+* Rename `ThinEvent.related_object.type_` to `ThinEvent.related_object.type`
+  * This was an unintentional typo before. The property name now correctly matches the value you get back from the API
diff --git a/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md b/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md
new file mode 100644
index 000000000..410ba9f83
--- /dev/null
+++ b/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md
@@ -0,0 +1,93 @@
+---
+title: Support for APIs in the new API version 2025-03-31.basil
+pr_url: https://github.com/stripe/stripe-python/pull/1463
+is_stripe_api_change: true
+released_in_version: 12.0.0
+---
+
+This release changes the pinned API version to `2025-03-31.basil`.
+
+### ⚠️ Breaking changes  due to changes in the Stripe API
+
+Please review details for the breaking changes and alternatives in the [Stripe API changelog](https://docs.stripe.com/changelog/basil) before upgrading.
+
+* Remove support for resources `SubscriptionItemUsageRecordSummary` and `SubscriptionItemUsageRecord`
+* Remove support for `create` method on resource `SubscriptionItemUsageRecord`
+* Remove support for `list` method on resource `SubscriptionItemUsageRecordSummary`
+* Remove support for `upcomingLines` and `upcoming` methods on resource `Invoice`
+* Remove support for `invoice` on `Charge` and `PaymentIntent`
+* Remove support for `shipping_details` on `CheckoutSession`
+* Remove support for `carrier`, `phone`, and `tracking_number` on `CheckoutSession.CollectedInformation.ShippingDetail`
+* Remove support for `refund` on `CreditNote.CreateParams`, `CreditNote.PreviewParams`, `CreditNotePreviewLines.ListParams`, and `CreditNote`
+* Remove support for `tax_amounts` on `CreditNoteLineItem`, `CreditNote`, and `InvoiceLineItem`
+* Remove support for `amount_excluding_tax` and `unit_amount_excluding_tax` on `CreditNoteLineItem` and `InvoiceLineItem`
+* Remove support for `coupon` on `Customer.CreateParams`, `Customer.UpdateParams`, `Invoice.CreatePreviewParamsScheduleDetailPhase`, `Invoice.CreatePreviewParams`, `Subscription.CreateParams`, `Subscription.UpdateParams`, `SubscriptionSchedule.CreateParamsPhase`, `SubscriptionSchedule.Phase`, and `SubscriptionSchedule.UpdateParamsPhase`
+* Remove support for `promotion_code` on `Customer.CreateParams`, `Customer.UpdateParams`, `Subscription.CreateParams`, and `Subscription.UpdateParams`
+* Remove support for `price` on `Invoice.AddLinesParamsLine`, `Invoice.UpdateLinesParamsLine`, `InvoiceItem.CreateParams`, `InvoiceItem.UpdateParams`, `InvoiceItem`, `InvoiceLineItem.UpdateParams`, and `InvoiceLineItem`
+* Remove support for `billing_thresholds` on `Invoice.CreatePreviewParamsScheduleDetailPhaseItem`, `Invoice.CreatePreviewParamsScheduleDetailPhase`, `Invoice.CreatePreviewParamsSubscriptionDetailItem`, `Subscription.CreateParamsItem`, `Subscription.CreateParams`, `Subscription.UpdateParamsItem`, `Subscription.UpdateParams`, `SubscriptionItem.CreateParams`, `SubscriptionItem.UpdateParams`, `SubscriptionItem`, `SubscriptionSchedule.CreateParamsDefaultSetting`, `SubscriptionSchedule.CreateParamsPhaseItem`, `SubscriptionSchedule.CreateParamsPhase`, `SubscriptionSchedule.DefaultSetting`, `SubscriptionSchedule.Phase.Item`, `SubscriptionSchedule.Phase`, `SubscriptionSchedule.UpdateParamsDefaultSetting`, `SubscriptionSchedule.UpdateParamsPhaseItem`, `SubscriptionSchedule.UpdateParamsPhase`, and `Subscription`
+* Remove support for `application_fee_amount`, `charge`, `paid_out_of_band`, `paid`, `payment_intent`, `quote`, `subscription`, `subscription_details`, `subscription_proration_date`, `tax`, `total_tax_amounts`, and `transfer_data` on `Invoice`
+* Remove support for `discount` on `Invoice` and `Subscription`
+* Remove support for `invoice_item`, `proration_details`, `proration`, `tax_rates`, and `type` on `InvoiceLineItem`
+* Remove support for `plan` and `subscription_item` on `InvoiceItem` and `InvoiceLineItem`
+* Remove support for `unit_amount` on `InvoiceItem.CreateParams`, `InvoiceItem.UpdateParams`, and `InvoiceItem`
+* Remove support for `subscription` and `unit_amount_decimal` on `InvoiceItem`
+* Remove support for `naver_pay` on `PaymentMethod.UpdateParams`
+* Remove support for `aggregate_usage` on `Plan.CreateParams`, `Plan`, `Price.CreateParamsRecurring`, and `Price.Recurring`
+* Remove support for `current_period_end` and `current_period_start` on `Subscription`
+* Remove support for page on `v2.Event.ListParams` and `v2.EventDestination.ListParams`
+
+### Changes
+* Change `CheckoutSession.collected_information` to be required
+* Change `CheckoutSession.CollectedInformation.shipping_details` to be required
+* Change `CheckoutSession.CollectedInformation.ShippingDetail.address` to be required
+* Change `CheckoutSession.CollectedInformation.ShippingDetail.name` to be required
+* Change `PaymentIntent.ConfirmParamsPaymentMethodOptionWechatPay.client`, `PaymentIntent.CreateParamsPaymentMethodOptionWechatPay.client`, and `PaymentIntent.UpdateParamsPaymentMethodOptionWechatPay.client` to be optional
+* Change `political_exposure` on resources `Person` and `Token` and params `Token.CreateParams` from string to `enum("existing" | "none")`
+
+### Additions
+
+* Add support for new resource `InvoicePayment`
+* Add support for `list` and `retrieve` methods on resource `InvoicePayment`
+* Add support for `billie_payments`, `nz_bank_account_becs_debit_payments`, and `satispay_payments` on `Account.Capability`, `Account.CreateParamsCapability`, and `Account.UpdateParamsCapability`
+* Add support for `hosted_payment_method_save` on `Account.Setting.Invoice` and `Account.UpdateParamsSettingInvoice`
+* Add support for `invoices` on `Account.CreateParamsSetting`
+* Add support for new values `information_missing`, `invalid_signator`, `verification_failed_authorizer_authority`, and `verification_rejected_ownership_exemption_reason` on enums `Account.FutureRequirement.Error.code`, `Account.Requirement.Error.code`, `AccountCapability.FutureRequirement.Error.code`, `AccountCapability.Requirement.Error.code`, `AccountPerson.FutureRequirement.Error.code`, `AccountPerson.Requirement.Error.code`, `BankAccount.FutureRequirement.Error.code`, and `BankAccount.Requirement.Error.code`
+* Add support for new values `forwarding_api_retryable_upstream_error` and `setup_intent_mobile_wallet_unsupported` on enums `Invoice.LastFinalizationError.code`, `PaymentIntent.LastPaymentError.code`, `SetupAttempt.SetupError.code`, `SetupIntent.LastSetupError.code`, and `StripeError.code`
+* Add support for new values `stripe_balance_payment_debit_reversal` and `stripe_balance_payment_debit` on enum `BalanceTransaction.type`
+* Add support for new value `last` on enums `BillingMeter.DefaultAggregation.formula` and `billing.Meter.CreateParamsDefaultAggregation.formula`
+* Add support for `presentment_details` on `Charge`, `CheckoutSession`, `PaymentIntent`, and `Refund`
+* Add support for `billie` and `satispay` on `Charge.PaymentMethodDetail`, `ConfirmationToken.CreateParamsPaymentMethodDatum`, `ConfirmationToken.PaymentMethodPreview`, `CustomerPaymentMethod`, `PaymentIntent.ConfirmParamsPaymentMethodDatum`, `PaymentIntent.CreateParamsPaymentMethodDatum`, `PaymentIntent.UpdateParamsPaymentMethodDatum`, `PaymentMethod.CreateParams`, `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.UpdateParams`, `PaymentMethodConfiguration`, `PaymentMethod`, `SetupIntent.ConfirmParamsPaymentMethodDatum`, `SetupIntent.CreateParamsPaymentMethodDatum`, and `SetupIntent.UpdateParamsPaymentMethodDatum`
+* Add support for `nz_bank_account` on `Charge.PaymentMethodDetail`, `ConfirmationToken.CreateParamsPaymentMethodDatum`, `ConfirmationToken.PaymentMethodPreview`, `CustomerPaymentMethod`, `Mandate.PaymentMethodDetail`, `PaymentIntent.ConfirmParamsPaymentMethodDatum`, `PaymentIntent.ConfirmParamsPaymentMethodOption`, `PaymentIntent.CreateParamsPaymentMethodDatum`, `PaymentIntent.CreateParamsPaymentMethodOption`, `PaymentIntent.PaymentMethodOption`, `PaymentIntent.UpdateParamsPaymentMethodDatum`, `PaymentIntent.UpdateParamsPaymentMethodOption`, `PaymentMethod.CreateParams`, `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.UpdateParams`, `PaymentMethodConfiguration`, `PaymentMethod`, `SetupAttempt.PaymentMethodDetail`, `SetupIntent.ConfirmParamsPaymentMethodDatum`, `SetupIntent.CreateParamsPaymentMethodDatum`, and `SetupIntent.UpdateParamsPaymentMethodDatum`
+* Add support for `optional_items` on `CheckoutSession`, `PaymentLink.CreateParams`, `PaymentLink`, and `checkout.Session.CreateParams`
+* Add support for `permissions` on `CheckoutSession` and `checkout.Session.CreateParams`
+* Add support for new values `billie` and `satispay` on enum `checkout.Session.CreateParams.payment_method_types`
+* Add support for new value `custom` on enums `CheckoutSession.ui_mode` and `checkout.Session.CreateParams.ui_mode`
+* Add support for `shipping_options` on `checkout.Session.UpdateParams`
+* Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `ConfirmationToken.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.ConfirmParamsPaymentMethodDatum.type`, `PaymentIntent.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.UpdateParamsPaymentMethodDatum.type`, `SetupIntent.ConfirmParamsPaymentMethodDatum.type`, `SetupIntent.CreateParamsPaymentMethodDatum.type`, and `SetupIntent.UpdateParamsPaymentMethodDatum.type`
+* Add support for `buyer_id` on `ConfirmationToken.PaymentMethodPreview.NaverPay`, `CustomerPaymentMethod.NaverPay`, and `PaymentMethod.NaverPay`
+* Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `ConfirmationToken.PaymentMethodPreview.type`, `CustomerPaymentMethod.type`, and `PaymentMethod.type`
+* Add support for `refunds` on `CreditNote.CreateParams`, `CreditNote.PreviewParams`, `CreditNotePreviewLines.ListParams`, and `CreditNote`
+* Add support for `total_taxes` on `CreditNote` and `Invoice`
+* Add support for `taxes` on `CreditNoteLineItem` and `InvoiceLineItem`
+* Add support for `checkout_session` on `CustomerBalanceTransaction`
+* Add support for new values `checkout_session_subscription_payment_canceled` and `checkout_session_subscription_payment` on enum `CustomerBalanceTransaction.type`
+* Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `CustomerPaymentMethod.ListParams.type`, `PaymentMethod.CreateParams.type`, and `PaymentMethod.ListParams.type`
+* Add support for new value `invoice.overpaid` on enum `Event.type`
+* Add support for new values `klarna` and `nz_bank_account` on enums `Invoice.CreateParamsPaymentSetting.payment_method_types`, `Invoice.PaymentSetting.payment_method_types`, `Invoice.UpdateParamsPaymentSetting.payment_method_types`, `Subscription.CreateParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, and `Subscription.UpdateParamsPaymentSetting.payment_method_types`
+* Add support for `pricing` on `Invoice.AddLinesParamsLine`, `Invoice.UpdateLinesParamsLine`, `InvoiceItem.CreateParams`, `InvoiceItem.UpdateParams`, `InvoiceItem`, `InvoiceLineItem.UpdateParams`, and `InvoiceLineItem`
+* Add support for `taxability_reason` on `Invoice.AddLinesParamsLineTaxAmount`, `Invoice.UpdateLinesParamsLineTaxAmount`, and `InvoiceLineItem.UpdateParamsTaxAmount`
+* Add support for `jurisdiction_level` on `Invoice.AddLinesParamsLineTaxAmountTaxRateDatum`, `Invoice.UpdateLinesParamsLineTaxAmountTaxRateDatum`, and `InvoiceLineItem.UpdateParamsTaxAmountTaxRateDatum`
+* Add support for `amount_overpaid`, `confirmation_secret`, and `payments` on `Invoice`
+* Add support for `parent` on `InvoiceItem`, `InvoiceLineItem`, and `Invoice`
+* Add support for new value `expired` on enums `IssuingAuthorization.status` and `issuing.Authorization.ListParams.status`
+* Add support for new value `network_fallback` on enum `IssuingAuthorization.RequestHistory.reason`
+* Add support for `naver_pay` on `Mandate.PaymentMethodDetail` and `SetupAttempt.PaymentMethodDetail`
+* Add support for `setup_future_usage` on `PaymentIntent.ConfirmParamsPaymentMethodOptionNaverPay`, `PaymentIntent.CreateParamsPaymentMethodOptionNaverPay`, `PaymentIntent.PaymentMethodOption.NaverPay`, and `PaymentIntent.UpdateParamsPaymentMethodOptionNaverPay`
+* Add support for `default_value` on `PaymentLink.CreateParamsCustomFieldDropdown`, `PaymentLink.CreateParamsCustomFieldNumeric`, `PaymentLink.CreateParamsCustomFieldText`, `PaymentLink.CustomField.Dropdown`, `PaymentLink.CustomField.Numeric`, `PaymentLink.CustomField.Text`, `PaymentLink.UpdateParamsCustomFieldDropdown`, `PaymentLink.UpdateParamsCustomFieldNumeric`, and `PaymentLink.UpdateParamsCustomFieldText`
+* Add support for new values `billie` and `satispay` on enums `PaymentLink.CreateParams.payment_method_types`, `PaymentLink.UpdateParams.payment_method_types`, and `PaymentLink.payment_method_types`
+* Add support for `nz_bank_transfer` on `Refund.DestinationDetail`
+* Add support for new value `canceled` on enum `Review.closed_reason`
+* Add support for `current_period_end` and `current_period_start` on `SubscriptionItem`
+* Add support for `wifi` on `TerminalConfiguration`, `terminal.Configuration.CreateParams`, and `terminal.Configuration.UpdateParams`
+* Add support for new value `invoice.overpaid` on enums `WebhookEndpoint.CreateParams.enabled_events` and `WebhookEndpoint.UpdateParams.enabled_events`
+* Add support for new values `2025-03-01.dashboard` and `2025-03-31.basil` on enum `WebhookEndpoint.CreateParams.api_version`
diff --git a/.hark/changes/2025-03-31_xavdid_rename-stripestream-s.change.md b/.hark/changes/2025-03-31_xavdid_rename-stripestream-s.change.md
new file mode 100644
index 000000000..593603794
--- /dev/null
+++ b/.hark/changes/2025-03-31_xavdid_rename-stripestream-s.change.md
@@ -0,0 +1,11 @@
+---
+title: Rename `StripeStreamResponseAsync`'s `.read()` to `read_async()` for consistency
+pr_url: https://github.com/stripe/stripe-python/pull/1474
+semver_level: major
+section: ⚠️ Other Breaking changes in the SDK
+released_in_version: 12.0.0
+---
+
+* Rename `StripeStreamResponseAsync.read()` to `.read_async()`
+  * This brings the method name in line with the conventions used by every other async method in the package, ensuring consistent `async` usage.
+  * You'll need to update your code if you call `Quote.pdf_async().read()` method. A typechecker will alert you to this change.
diff --git a/.hark/changes/2025-04-09_ramya_update-readme-clarificatio.change.md b/.hark/changes/2025-04-09_ramya_update-readme-clarificatio.change.md
new file mode 100644
index 000000000..47fd791bf
--- /dev/null
+++ b/.hark/changes/2025-04-09_ramya_update-readme-clarificatio.change.md
@@ -0,0 +1,5 @@
+---
+title: Update readme with clarification on resource based call patterns
+pr_url: https://github.com/stripe/stripe-python/pull/1493
+released_in_version: 12.0.1
+---
diff --git a/.hark/changes/2025-04-15_xavdid_fix-type-hint.change.md b/.hark/changes/2025-04-15_xavdid_fix-type-hint.change.md
new file mode 100644
index 000000000..9930dcc48
--- /dev/null
+++ b/.hark/changes/2025-04-15_xavdid_fix-type-hint.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix type hint for SearchResultObject.data
+pr_url: https://github.com/stripe/stripe-python/pull/1401
+released_in_version: 12.0.1
+---
diff --git a/.hark/changes/2025-04-18_mbroshi_encode-bools-lower.change.md b/.hark/changes/2025-04-18_mbroshi_encode-bools-lower.change.md
new file mode 100644
index 000000000..5e6553d96
--- /dev/null
+++ b/.hark/changes/2025-04-18_mbroshi_encode-bools-lower.change.md
@@ -0,0 +1,7 @@
+---
+title: Encode bools with lower case
+pr_url: https://github.com/stripe/stripe-python/pull/1499
+released_in_version: 12.0.1
+---
+
+- Serializes boolean query parameter values to `true`/`false` (lower case) before sending to the Stripe API for compatibility with Stripe V2 endpoints
diff --git a/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..acedec564
--- /dev/null
+++ b/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,29 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1496
+is_stripe_api_change: true
+released_in_version: 12.1.0
+---
+
+* Add support for `minority_owned_business_designation` on `Account.BusinessProfile`, `Account.CreateParamsBusinessProfile`, `Account.ModifyParamsBusinessProfile`, `AccountService.CreateParamsBusinessProfile`, and `AccountService.UpdateParamsBusinessProfile`
+* Add support for `registration_date` on `Account.Company`, `Account.CreateParamsCompany`, `Account.ModifyParamsCompany`, `AccountService.CreateParamsCompany`, `AccountService.UpdateParamsCompany`, `Token.CreateParamsAccountCompany`, and `TokenService.CreateParamsAccountCompany`
+* Add support for `us_cfpb_data` on `Account.CreateParams`, `Account.ModifyParams`, `AccountPersonService.CreateParams`, `AccountPersonService.UpdateParams`, `Person`, `Token.CreateParamsPerson`, and `TokenService.CreateParamsPerson`
+* Add support for new value `verification_legal_entity_structure_mismatch` on enums `Account.FutureRequirement.Error.code`, `Account.Requirement.Error.code`, `BankAccount.FutureRequirement.Error.code`, `BankAccount.Requirement.Error.code`, `Capability.FutureRequirement.Error.code`, `Capability.Requirement.Error.code`, `Person.FutureRequirement.Error.code`, and `Person.Requirement.Error.code`
+* Add support for new value `tax_id_prohibited` on enums `Invoice.LastFinalizationError.code`, `PaymentIntent.LastPaymentError.code`, `SetupAttempt.SetupError.code`, `SetupIntent.LastSetupError.code`, and `StripeError.code`
+* Add support for `tax_id` on `Charge.BillingDetail`, `ConfirmationToken.CreateParamsPaymentMethodDatumBillingDetail`, `ConfirmationToken.PaymentMethodPreview.BillingDetail`, `PaymentIntent.ConfirmParamsPaymentMethodDatumBillingDetail`, `PaymentIntent.CreateParamsPaymentMethodDatumBillingDetail`, `PaymentIntent.ModifyParamsPaymentMethodDatumBillingDetail`, `PaymentIntentService.ConfirmParamsPaymentMethodDatumBillingDetail`, `PaymentIntentService.CreateParamsPaymentMethodDatumBillingDetail`, `PaymentIntentService.UpdateParamsPaymentMethodDatumBillingDetail`, `PaymentMethod.BillingDetail`, `PaymentMethod.CreateParamsBillingDetail`, `PaymentMethod.ModifyParamsBillingDetail`, `PaymentMethodService.CreateParamsBillingDetail`, `PaymentMethodService.UpdateParamsBillingDetail`, `SetupIntent.ConfirmParamsPaymentMethodDatumBillingDetail`, `SetupIntent.CreateParamsPaymentMethodDatumBillingDetail`, `SetupIntent.ModifyParamsPaymentMethodDatumBillingDetail`, `SetupIntentService.ConfirmParamsPaymentMethodDatumBillingDetail`, `SetupIntentService.CreateParamsPaymentMethodDatumBillingDetail`, `SetupIntentService.UpdateParamsPaymentMethodDatumBillingDetail`, `test_helpers.ConfirmationTokenService.CreateParamsPaymentMethodDatumBillingDetail`, `treasury.OutboundPayment.CreateParamsDestinationPaymentMethodDatumBillingDetail`, and `treasury.OutboundPaymentService.CreateParamsDestinationPaymentMethodDatumBillingDetail`
+* Add support for `wallet_options` on `Checkout.Session`, `checkout.Session.CreateParams`, and `checkout.SessionService.CreateParams`
+* Add support for `provider` on `Checkout.Session.AutomaticTax`, `Invoice.AutomaticTax`, and `Quote.AutomaticTax`
+* Add support for new values `aw_tin`, `az_tin`, `bd_bin`, `bf_ifu`, `bj_ifu`, `cm_niu`, `cv_nif`, `et_tin`, `kg_tin`, and `la_tin` on enums `Checkout.Session.CustomerDetail.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetail.TaxId.type`, `Tax.Transaction.CustomerDetail.TaxId.type`, and `TaxId.type`
+* Add support for `payment_method_options` on `ConfirmationToken.CreateParams` and `test_helpers.ConfirmationTokenService.CreateParams`
+* Add support for `installments` on `ConfirmationToken.PaymentMethodOption.Card`
+* Add support for new values `aw_tin`, `az_tin`, `bd_bin`, `bf_ifu`, `bj_ifu`, `cm_niu`, `cv_nif`, `et_tin`, `kg_tin`, and `la_tin` on enums `Customer.CreateParams.type`, `Customer.CreateParamsTaxIdDatum.type`, `CustomerService.CreateParamsTaxIdDatum.type`, `CustomerTaxIdService.CreateParams.type`, `Invoice.CreatePreviewParamsCustomerDetailTaxId.type`, `InvoiceService.CreatePreviewParamsCustomerDetailTaxId.type`, `TaxId.CreateParams.type`, `TaxIdService.CreateParams.type`, `tax.Calculation.CreateParamsCustomerDetailTaxId.type`, and `tax.CalculationService.CreateParamsCustomerDetailTaxId.type`
+* Add support for `context` on `Event`
+* Add support for new value `affirm` on enums `Invoice.CreateParamsPaymentSetting.payment_method_types`, `Invoice.ModifyParamsPaymentSetting.payment_method_types`, `Invoice.PaymentSetting.payment_method_types`, `InvoiceService.CreateParamsPaymentSetting.payment_method_types`, `InvoiceService.UpdateParamsPaymentSetting.payment_method_types`, `Subscription.CreateParamsPaymentSetting.payment_method_types`, `Subscription.ModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionService.CreateParamsPaymentSetting.payment_method_types`, and `SubscriptionService.UpdateParamsPaymentSetting.payment_method_types`
+* Change type of `InvoiceLineItem.Parent.SubscriptionItemDetail.subscription` from `string` to `nullable(string)`
+* Add support for `billie` on `PaymentIntent.ConfirmParamsPaymentMethodOption`, `PaymentIntent.CreateParamsPaymentMethodOption`, `PaymentIntent.ModifyParamsPaymentMethodOption`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentService.ConfirmParamsPaymentMethodOption`, `PaymentIntentService.CreateParamsPaymentMethodOption`, and `PaymentIntentService.UpdateParamsPaymentMethodOption`
+* Add support for `pix` on `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.ModifyParams`, `PaymentMethodConfigurationService.CreateParams`, `PaymentMethodConfigurationService.UpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `klarna` on `PaymentMethodDomain`
+* Add support for `pending_reason` on `Refund`
+* Change type of `Tax.CalculationLineItem.reference` from `nullable(string)` to `string`
+* Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `Tax.Registration.CountryOption`, `tax.Registration.CreateParamsCountryOption`, and `tax.RegistrationService.CreateParamsCountryOption`
+* Add support for new value `2025-04-30.basil` on enums `WebhookEndpoint.CreateParams.api_version` and `WebhookEndpointService.CreateParams.api_version`
diff --git a/.hark/changes/2025-05-02_jar_adds-contributing-md.change.md b/.hark/changes/2025-05-02_jar_adds-contributing-md.change.md
new file mode 100644
index 000000000..e97b7b451
--- /dev/null
+++ b/.hark/changes/2025-05-02_jar_adds-contributing-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Adds CONTRIBUTING.md
+pr_url: https://github.com/stripe/stripe-python/pull/1511
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..ecfe113e4
--- /dev/null
+++ b/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,37 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1517
+is_stripe_api_change: true
+released_in_version: 12.2.0
+---
+
+* Add support for `attach_payment` method on resource `Invoice`
+* Add support for `collect_inputs` method on resource `terminal.Reader`
+* Add support for `succeed_input_collection` and `timeout_input_collection` test helper methods on resource `terminal.Reader`
+* Add support for `pix_payments` on `Account.Capability`, `Account.CreateParamsCapability`, and `Account.ModifyParamsCapability`
+* Add support for `disputes_list` and `payment_disputes` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
+* Add support for `refund_and_dispute_prefunding` on `Balance`
+* Add support for `balance_type` on `BalanceTransaction`
+* Change `billing.Alert.CreateParamsUsageThreshold.meter` to be required
+* Add support for `location` and `reader` on `Charge.PaymentMethodDetail.Affirm` and `Charge.PaymentMethodDetail.WechatPay`
+* Add support for `payment_method_remove` on `checkout.Session.CreateParamsSavedPaymentMethodOption`
+* Add support for `setup_future_usage` on `Checkout.Session.PaymentMethodOption.NaverPay`
+* Change `ConfirmationToken.PaymentMethodPreview.NaverPay.buyer_id` and `PaymentMethod.NaverPay.buyer_id` to be required
+* Add support for `post_payment_amount` and `pre_payment_amount` on `CreditNote`
+* Add support for new value `mixed` on enum `CreditNote.type`
+* Add support for new value `invoice_payment.paid` on enum `Event.type`
+* Add support for `sex`, `unparsed_place_of_birth`, and `unparsed_sex` on `Identity.VerificationReport.Document` and `Identity.VerificationSession.VerifiedOutput`
+* Add support for `billing_thresholds` on `Invoice.CreatePreviewParamsScheduleDetailPhaseItem`, `Invoice.CreatePreviewParamsScheduleDetailPhase`, `Invoice.CreatePreviewParamsSubscriptionDetailItem`, `Subscription.CreateParamsItem`, `Subscription.CreateParams`, `Subscription.ModifyParamsItem`, `Subscription.ModifyParams`, `SubscriptionItem.CreateParams`, `SubscriptionItem.ModifyParams`, `SubscriptionItem`, `SubscriptionSchedule.CreateParamsDefaultSetting`, `SubscriptionSchedule.CreateParamsPhaseItem`, `SubscriptionSchedule.CreateParamsPhase`, `SubscriptionSchedule.DefaultSetting`, `SubscriptionSchedule.ModifyParamsDefaultSetting`, `SubscriptionSchedule.ModifyParamsPhaseItem`, `SubscriptionSchedule.ModifyParamsPhase`, `SubscriptionSchedule.Phase.Item`, `SubscriptionSchedule.Phase`, and `Subscription`
+* Add support for `satispay` on `PaymentIntent.ConfirmParamsPaymentMethodOption`, `PaymentIntent.CreateParamsPaymentMethodOption`, `PaymentIntent.ModifyParamsPaymentMethodOption`, and `PaymentIntent.PaymentMethodOption`
+* Add support for `capture_method` on `PaymentIntent.PaymentMethodOption.Billie`
+* Add support for `kakao_pay`, `kr_card`, `naver_pay`, `payco`, and `samsung_pay` on `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.ModifyParams`, and `PaymentMethodConfiguration`
+* Add support for `network_decline_code` on `Refund.DestinationDetail.Paypal`
+* Add support for `metadata` on `Tax.CalculationLineItem` and `tax.Calculation.CreateParamsLineItem`
+* Add support for new value `simulated_stripe_s700` on enums `Terminal.Reader.device_type` and `terminal.Reader.ListParams.device_type`
+* Add support for `return_url` on `Terminal.Reader.Action.ProcessPaymentIntent.ProcessConfig` and `terminal.Reader.ProcessPaymentIntentParamsProcessConfig`
+* Add support for `collect_inputs` on `Terminal.Reader.Action`
+* Add support for new value `collect_inputs` on enum `Terminal.Reader.Action.type`
+* Add support for new value `invoice_payment.paid` on enums `WebhookEndpoint.CreateParams.enabled_events` and `WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for new value `2025-05-28.basil` on enum `WebhookEndpoint.CreateParams.api_version`
+* Add support for snapshot event `invoice_payment.paid` with resource `InvoicePayment`
+* Add support for error code `forwarding_api_upstream_error` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2025-06-30_ramya_fix-link-releases.change.md b/.hark/changes/2025-06-30_ramya_fix-link-releases.change.md
new file mode 100644
index 000000000..e115f58ca
--- /dev/null
+++ b/.hark/changes/2025-06-30_ramya_fix-link-releases.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix the link to releases page from readme
+pr_url: https://github.com/stripe/stripe-python/pull/1534
+released_in_version: 12.3.0
+---
diff --git a/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0ec1b2a2f
--- /dev/null
+++ b/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,40 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1526
+is_stripe_api_change: true
+released_in_version: 12.3.0
+---
+
+* Add support for `migrate` method on resource `Subscription`
+* Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `terminal.Reader`
+* Add support for `crypto_payments` on `Account.Capability`, `Account.CreateParamsCapability`, and `Account.ModifyParamsCapability`
+* Add support for `proof_of_address` on `Account.CreateParamsDocument` and `Account.ModifyParamsDocument`
+* Add support for `monthly_payout_days` and `weekly_payout_days` on `Account.CreateParamsSettingPayoutSchedule`, `Account.ModifyParamsSettingPayoutSchedule`, and `Account.Setting.Payout.Schedule`
+* Change `Account.Setting.Invoice.hosted_payment_method_save` to be required
+* Add support for `crypto` on `Charge.PaymentMethodDetail`, `ConfirmationToken.CreateParamsPaymentMethodDatum`, `ConfirmationToken.PaymentMethodPreview`, `PaymentIntent.ConfirmParamsPaymentMethodDatum`, `PaymentIntent.ConfirmParamsPaymentMethodOption`, `PaymentIntent.CreateParamsPaymentMethodDatum`, `PaymentIntent.CreateParamsPaymentMethodOption`, `PaymentIntent.ModifyParamsPaymentMethodDatum`, `PaymentIntent.ModifyParamsPaymentMethodOption`, `PaymentIntent.PaymentMethodOption`, `PaymentMethod.CreateParams`, `PaymentMethod`, `SetupIntent.ConfirmParamsPaymentMethodDatum`, `SetupIntent.CreateParamsPaymentMethodDatum`, and `SetupIntent.ModifyParamsPaymentMethodDatum`
+* Change type of `Charge.PaymentMethodDetail.Card.Installment.Plan.type`, `ConfirmationToken.CreateParamsPaymentMethodOptionCardInstallmentPlan.type`, `ConfirmationToken.PaymentMethodOption.Card.Installment.Plan.type`, `Invoice.CreateParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type`, `Invoice.ModifyParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type`, `PaymentIntent.ConfirmParamsPaymentMethodOptionCardInstallmentPlan.type`, `PaymentIntent.CreateParamsPaymentMethodOptionCardInstallmentPlan.type`, `PaymentIntent.ModifyParamsPaymentMethodOptionCardInstallmentPlan.type`, `PaymentIntent.PaymentMethodOption.Card.Installment.AvailablePlan.type`, and `PaymentIntent.PaymentMethodOption.Card.Installment.Plan.type` from `literal('fixed_count')` to `enum('bonus'|'fixed_count'|'revolving')`
+* Add support for new value `buut` on enums `Charge.PaymentMethodDetail.Ideal.bank`, `ConfirmationToken.CreateParamsPaymentMethodDatumIdeal.bank`, `ConfirmationToken.PaymentMethodPreview.Ideal.bank`, `PaymentIntent.ConfirmParamsPaymentMethodDatumIdeal.bank`, `PaymentIntent.CreateParamsPaymentMethodDatumIdeal.bank`, `PaymentIntent.ModifyParamsPaymentMethodDatumIdeal.bank`, `PaymentMethod.CreateParamsIdeal.bank`, `PaymentMethod.Ideal.bank`, `SetupAttempt.PaymentMethodDetail.Ideal.bank`, `SetupIntent.ConfirmParamsPaymentMethodDatumIdeal.bank`, `SetupIntent.CreateParamsPaymentMethodDatumIdeal.bank`, and `SetupIntent.ModifyParamsPaymentMethodDatumIdeal.bank`
+* Add support for new value `BUUTNL2A` on enums `Charge.PaymentMethodDetail.Ideal.bic`, `ConfirmationToken.PaymentMethodPreview.Ideal.bic`, `PaymentMethod.Ideal.bic`, and `SetupAttempt.PaymentMethodDetail.Ideal.bic`
+* Add support for `subscriptions` on `PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna`, `PaymentIntent.CreateParamsPaymentMethodOptionKlarna`, `PaymentIntent.ModifyParamsPaymentMethodOptionKlarna`, and `checkout.Session.CreateParamsPaymentMethodOptionKlarna`
+* Add support for new value `crypto` on enum `checkout.Session.CreateParams.payment_method_types`
+* Add support for `billing_mode` on `Invoice.CreatePreviewParamsScheduleDetail`, `Invoice.CreatePreviewParamsSubscriptionDetail`, `Quote.CreateParamsSubscriptionDatum`, `Quote.SubscriptionDatum`, `Subscription.CreateParams`, `SubscriptionSchedule.CreateParams`, `SubscriptionSchedule`, `Subscription`, and `checkout.Session.CreateParamsSubscriptionDatum`
+* Add support for new value `crypto` on enums `ConfirmationToken.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.ConfirmParamsPaymentMethodDatum.type`, `PaymentIntent.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.ModifyParamsPaymentMethodDatum.type`, `SetupIntent.ConfirmParamsPaymentMethodDatum.type`, `SetupIntent.CreateParamsPaymentMethodDatum.type`, and `SetupIntent.ModifyParamsPaymentMethodDatum.type`
+* Add support for new value `crypto` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for new value `crypto` on enums `Customer.ListPaymentMethodsParams.type`, `PaymentMethod.CreateParams.type`, and `PaymentMethod.ListParams.type`
+* Change type of `Dispute.enhanced_eligibility_types` from `literal('visa_compelling_evidence_3')` to `enum('visa_compelling_evidence_3'|'visa_compliance')`
+* Add support for new value `compliance` on enum `Dispute.PaymentMethodDetail.Card.case_type`
+* Add support for new value `terminal.reader.action_updated` on enum `Event.type`
+* Add support for `related_person` on `Identity.VerificationSession` and `identity.VerificationSession.CreateParams`
+* Add support for `matching` on `Identity.VerificationSession.Option`
+* Add support for new value `crypto` on enums `Invoice.CreateParamsPaymentSetting.payment_method_types`, `Invoice.ModifyParamsPaymentSetting.payment_method_types`, `Invoice.PaymentSetting.payment_method_types`, `Subscription.CreateParamsPaymentSetting.payment_method_types`, `Subscription.ModifyParamsPaymentSetting.payment_method_types`, and `Subscription.PaymentSetting.payment_method_types`
+* Add support for `klarna` on `Mandate.PaymentMethodDetail`, `SetupIntent.ConfirmParamsPaymentMethodOption`, `SetupIntent.CreateParamsPaymentMethodOption`, `SetupIntent.ModifyParamsPaymentMethodOption`, and `SetupIntent.PaymentMethodOption`
+* Add support for `on_demand` on `PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna`, `PaymentIntent.CreateParamsPaymentMethodOptionKlarna`, and `PaymentIntent.ModifyParamsPaymentMethodOptionKlarna`
+* Change type of `PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna.setup_future_usage`, `PaymentIntent.CreateParamsPaymentMethodOptionKlarna.setup_future_usage`, `PaymentIntent.ModifyParamsPaymentMethodOptionKlarna.setup_future_usage`, and `PaymentIntent.PaymentMethodOption.Klarna.setup_future_usage` from `literal('none')` to `enum('none'|'off_session'|'on_session')`
+* Add support for `ua` on `Tax.Registration.CountryOption` and `tax.Registration.CreateParamsCountryOption`
+* Change type of `terminal.Location.ModifyParams.display_name` from `string` to `emptyable(string)`
+* Add support for `collect_payment_method` and `confirm_payment_intent` on `Terminal.Reader.Action`
+* Add support for new values `collect_payment_method` and `confirm_payment_intent` on enum `Terminal.Reader.Action.type`
+* Add support for `status` on `treasury.FinancialAccount.ListParams`
+* Add support for new value `terminal.reader.action_updated` on enums `WebhookEndpoint.CreateParams.enabled_events` and `WebhookEndpoint.ModifyParams.enabled_events`
+* Add support for new value `2025-06-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
+* Add support for snapshot event `terminal.reader.action_updated` with resource `terminal.Reader`
diff --git a/.hark/changes/2025-07-11_helenye_fix-timeout-type.change.md b/.hark/changes/2025-07-11_helenye_fix-timeout-type.change.md
new file mode 100644
index 000000000..c7b10891c
--- /dev/null
+++ b/.hark/changes/2025-07-11_helenye_fix-timeout-type.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix timeout type hint in RequestsClient
+pr_url: https://github.com/stripe/stripe-python/pull/1537
+released_in_version: 12.4.0
+---
diff --git a/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..13791e217
--- /dev/null
+++ b/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1541
+is_stripe_api_change: true
+released_in_version: 12.4.0
+---
+
+* Add support for `instant_payouts_promotion` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
+* Add support for `adjustable_quantity` on `BillingPortal.Configuration.Feature.SubscriptionUpdate.Product`, `billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct`, and `billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProduct`
+* Remove support for value `disabled` from enum `Capability.status`
+* Add support for `transaction_id` on `Charge.PaymentMethodDetail.Cashapp`
+* Add support for `origin_context` on `Checkout.Session` and `checkout.Session.CreateParams`
+* Add support for `template` on `Checkout.Session.InvoiceCreation.InvoiceDatum.RenderingOption`, `PaymentLink.CreateParamsInvoiceCreationInvoiceDatumRenderingOption`, `PaymentLink.InvoiceCreation.InvoiceDatum.RenderingOption`, `PaymentLink.ModifyParamsInvoiceCreationInvoiceDatumRenderingOption`, and `checkout.Session.CreateParamsInvoiceCreationInvoiceDatumRenderingOption`
+* Add support for `setup_future_usage` on `Checkout.Session.PaymentMethodOption.Pix` and `checkout.Session.CreateParamsPaymentMethodOptionPix`
+* Add support for new value `nz_bank_account` on enum `checkout.Session.CreateParams.payment_method_types`
+* Change `Identity.VerificationSession.RelatedPerson.account` to be required
+* Change `Identity.VerificationSession.RelatedPerson.person` to be required
+* Add support for `duration` on `Invoice.CreatePreviewParamsScheduleDetailPhase`, `SubscriptionSchedule.CreateParamsPhase`, and `SubscriptionSchedule.ModifyParamsPhase`
+* Change type of `Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at`, `Subscription.CreateParams.cancel_at`, and `Subscription.ModifyParams.cancel_at` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+* Add support for `price_data` on `PaymentLink.CreateParamsLineItem`
+* Change `PaymentLink.CreateParamsLineItem.price` to be optional
+* Add support for new value `America/Coyhaique` on enum `reporting.ReportRun.CreateParamsParameter.timezone`
+* Add support for `standard` on `Tax.Registration.CountryOption.Ae`, `Tax.Registration.CountryOption.Au`, `Tax.Registration.CountryOption.Ch`, `Tax.Registration.CountryOption.Gb`, `Tax.Registration.CountryOption.Jp`, `Tax.Registration.CountryOption.No`, `Tax.Registration.CountryOption.Nz`, `Tax.Registration.CountryOption.Sg`, `tax.Registration.CreateParamsCountryOptionAe`, `tax.Registration.CreateParamsCountryOptionAl`, `tax.Registration.CreateParamsCountryOptionAo`, `tax.Registration.CreateParamsCountryOptionAu`, `tax.Registration.CreateParamsCountryOptionAw`, `tax.Registration.CreateParamsCountryOptionB`, `tax.Registration.CreateParamsCountryOptionBa`, `tax.Registration.CreateParamsCountryOptionBb`, `tax.Registration.CreateParamsCountryOptionBd`, `tax.Registration.CreateParamsCountryOptionBf`, `tax.Registration.CreateParamsCountryOptionBh`, `tax.Registration.CreateParamsCountryOptionCd`, `tax.Registration.CreateParamsCountryOptionCh`, `tax.Registration.CreateParamsCountryOptionEt`, `tax.Registration.CreateParamsCountryOptionGb`, `tax.Registration.CreateParamsCountryOptionGn`, `tax.Registration.CreateParamsCountryOptionIs`, `tax.Registration.CreateParamsCountryOptionJp`, `tax.Registration.CreateParamsCountryOptionMe`, `tax.Registration.CreateParamsCountryOptionMk`, `tax.Registration.CreateParamsCountryOptionMr`, `tax.Registration.CreateParamsCountryOptionNo`, `tax.Registration.CreateParamsCountryOptionNz`, `tax.Registration.CreateParamsCountryOptionOm`, `tax.Registration.CreateParamsCountryOptionR`, `tax.Registration.CreateParamsCountryOptionSg`, `tax.Registration.CreateParamsCountryOptionSr`, `tax.Registration.CreateParamsCountryOptionUy`, `tax.Registration.CreateParamsCountryOptionZa`, and `tax.Registration.CreateParamsCountryOptionZw`
+* Add support for new value `inbound_goods` on enums `Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme`, and `tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_scheme`
+* Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal.Configuration.Tipping`, `terminal.Configuration.CreateParamsTipping`, and `terminal.Configuration.ModifyParamsTipping`
+* Add support for new value `2025-07-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
diff --git a/.hark/changes/2025-08-21_prathmesh_introduce-v1-namespaces.change.md b/.hark/changes/2025-08-21_prathmesh_introduce-v1-namespaces.change.md
new file mode 100644
index 000000000..a02e5e189
--- /dev/null
+++ b/.hark/changes/2025-08-21_prathmesh_introduce-v1-namespaces.change.md
@@ -0,0 +1,15 @@
+---
+title: Introduce V1 namespaces in StripeClient
+pr_url: https://github.com/stripe/stripe-python/pull/1549
+released_in_version: 12.5.0
+---
+
+- All the top level non-namespaced services under StripeClient services(eg. customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major release and will be removed in a future release. Eg.
+```diff
+client = StripeClient("sk_test...")
+
+# Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
+- client.customers.list()
++ client.v1.customers.list()
+```
+Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
diff --git a/.hark/changes/2025-08-27_ramya_add-section-private.change.md b/.hark/changes/2025-08-27_ramya_add-section-private.change.md
new file mode 100644
index 000000000..bb5664aba
--- /dev/null
+++ b/.hark/changes/2025-08-27_ramya_add-section-private.change.md
@@ -0,0 +1,5 @@
+---
+title: Add section on private preview SDKs in readme
+pr_url: https://github.com/stripe/stripe-python/pull/1554
+released_in_version: 12.5.0
+---
diff --git a/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..ed69aea5a
--- /dev/null
+++ b/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,25 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-python/pull/1544
+is_stripe_api_change: true
+released_in_version: 12.5.0
+---
+
+* Add support for `balance_report`, `payout_details`, and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
+* Add support for `name` on `BillingPortal.Configuration`, `billing_portal.Configuration.CreateParams`, and `billing_portal.Configuration.ModifyParams`
+* Add support for `installments` on `Charge.PaymentMethodDetail.Alma`
+* Add support for `transaction_id` on `Charge.PaymentMethodDetail.Alma`, `Charge.PaymentMethodDetail.AmazonPay`, `Charge.PaymentMethodDetail.Billie`, `Charge.PaymentMethodDetail.KakaoPay`, `Charge.PaymentMethodDetail.KrCard`, `Charge.PaymentMethodDetail.NaverPay`, `Charge.PaymentMethodDetail.Payco`, `Charge.PaymentMethodDetail.RevolutPay`, `Charge.PaymentMethodDetail.SamsungPay`, and `Charge.PaymentMethodDetail.Satispay`
+* Add support for `location` and `reader` on `Charge.PaymentMethodDetail.Paynow`
+* Add support for `amount_includes_iof` on `Checkout.Session.PaymentMethodOption.Pix`, `PaymentIntent.ConfirmParamsPaymentMethodOptionPix`, `PaymentIntent.CreateParamsPaymentMethodOptionPix`, `PaymentIntent.ModifyParamsPaymentMethodOptionPix`, `PaymentIntent.PaymentMethodOption.Pix`, and `checkout.Session.CreateParamsPaymentMethodOptionPix`
+* Add support for new values `block` and `resolution` on enum `Dispute.PaymentMethodDetail.Card.case_type`
+* Add support for new value `terminal_android_apk` on enums `File.ListParams.purpose` and `File.purpose`
+* Add support for new value `terminal_android_apk` on enum `File.CreateParams.purpose`
+* Add support for `metadata` and `period` on `Invoice.CreatePreviewParamsScheduleDetailPhaseAddInvoiceItem`, `Subscription.CreateParamsAddInvoiceItem`, `Subscription.ModifyParamsAddInvoiceItem`, `SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem`, `SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem`, and `SubscriptionSchedule.Phase.AddInvoiceItem`
+* Add support for `exp_month` and `exp_year` on `issuing.Card.CreateParams`
+* Add support for `excluded_payment_method_types` on `PaymentIntent.CreateParams` and `PaymentIntent`
+* Add support for `payout_method` on `Payout.CreateParams` and `Payout`
+* Add support for `mxn` on `Terminal.Configuration.Tipping`, `terminal.Configuration.CreateParamsTipping`, and `terminal.Configuration.ModifyParamsTipping`
+* Add support for `card` on `terminal.Reader.PresentPaymentMethodParams`
+* Add support for new value `card` on enum `terminal.Reader.PresentPaymentMethodParams.type`
+* Add support for new value `2025-08-27.basil` on enum `WebhookEndpoint.CreateParams.api_version`
+* Add support for error codes `customer_session_expired` and `india_recurring_payment_mandate_canceled` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2025-08-27_xavdid_import-available-http.change.md b/.hark/changes/2025-08-27_xavdid_import-available-http.change.md
new file mode 100644
index 000000000..2b4c33e81
--- /dev/null
+++ b/.hark/changes/2025-08-27_xavdid_import-available-http.change.md
@@ -0,0 +1,5 @@
+---
+title: Import available http libraries more efficiently
+pr_url: https://github.com/stripe/stripe-python/pull/1553
+released_in_version: 12.5.0
+---
diff --git a/.hark/changes/2025-09-04_mbroshi_fix-paginate-backwards.change.md b/.hark/changes/2025-09-04_mbroshi_fix-paginate-backwards.change.md
new file mode 100644
index 000000000..e21cb5628
--- /dev/null
+++ b/.hark/changes/2025-09-04_mbroshi_fix-paginate-backwards.change.md
@@ -0,0 +1,7 @@
+---
+title: "fix: Paginate backwards if `starting_after == None`"
+pr_url: https://github.com/stripe/stripe-python/pull/1563
+released_in_version: 12.5.1
+---
+
+* Addresses an [issue](https://github.com/stripe/stripe-python/issues/1562) where List iteration would be forwards when `starting_after` was set to `None` but backwards if it was not set at all. Now, it will paginate backwards in both cases.
diff --git a/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md b/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md
new file mode 100644
index 000000000..08866f23c
--- /dev/null
+++ b/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md
@@ -0,0 +1,9 @@
+---
+title: Build SDK w/ V2 OpenAPI spec
+pr_url: https://github.com/stripe/stripe-python/pull/1565
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- ⚠️ The delete methods for v2 APIs (the ones in the `StripeClient.v2` namespace) now return a `V2DeletedObject` which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
+- ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Dict[str, Any]`. Because there were no params, it's unlikely you were using these classes.
diff --git a/.hark/changes/2025-09-18_xavdid_don-t-use.change.md b/.hark/changes/2025-09-18_xavdid_don-t-use.change.md
new file mode 100644
index 000000000..76c71b65b
--- /dev/null
+++ b/.hark/changes/2025-09-18_xavdid_don-t-use.change.md
@@ -0,0 +1,7 @@
+---
+title: Don't use mutable default arguments
+pr_url: https://github.com/stripe/stripe-python/pull/1570
+released_in_version: 13.0.0
+---
+
+- Service methods now correctly set `None` as the default function argument instead of `{}`
diff --git a/.hark/changes/2025-09-22_prathmesh_renamed-urllib2clien-urllibclient.change.md b/.hark/changes/2025-09-22_prathmesh_renamed-urllib2clien-urllibclient.change.md
new file mode 100644
index 000000000..ef8b938b0
--- /dev/null
+++ b/.hark/changes/2025-09-22_prathmesh_renamed-urllib2clien-urllibclient.change.md
@@ -0,0 +1,8 @@
+---
+title: Renamed Urllib2Client to UrllibClient
+pr_url: https://github.com/stripe/stripe-python/pull/1569
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- ⚠️ Rename `http_client.Urllib2Client` to `http_client.UrllibClient` as Python `urllib2` was renamed to `urllib` in Python 3.
diff --git a/.hark/changes/2025-09-23_stripe-openapi_1593-1607-1605.change.md b/.hark/changes/2025-09-23_stripe-openapi_1593-1607-1605.change.md
new file mode 100644
index 000000000..e65c0b375
--- /dev/null
+++ b/.hark/changes/2025-09-23_stripe-openapi_1593-1607-1605.change.md
@@ -0,0 +1,48 @@
+---
+title: ", [#1593](https://github.com/stripe/stripe-python/pull/1593), [#1607](https://github.com/stripe/stripe-python/pull/1607), [#1605](https://github.com/stripe/stripe-python/pull/1605) Update generated code based on incoming API changes in the `2025-09-30.clover` API version."
+pr_url: https://github.com/stripe/stripe-python/pull/1567
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 13.0.0
+---
+
+* ⚠️ Remove support for `balance_report` and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
+* ⚠️ Remove support for values `saturday` and `sunday` from enums `Account.CreateParamsSettingPayoutSchedule.weekly_payout_days`, `Account.ModifyParamsSettingPayoutSchedule.weekly_payout_days`, and `Account.Setting.Payout.Schedule.weekly_payout_days`
+* ⚠️ Remove support for `iterations` on `Invoice.CreatePreviewParamsScheduleDetailPhase`, `SubscriptionSchedule.CreateParamsPhase`, and `SubscriptionSchedule.ModifyParamsPhase`
+* ⚠️ Remove support for `link` and `pay_by_bank` on `PaymentMethod.ModifyParams`
+* ⚠️ Remove support for `coupon` on `Discount`, `PromotionCode.CreateParams`, and `PromotionCode`. Use `Discount.source.coupon`, `PromotionCode.CreateParams.promotion.coupon`, and `PromotionCode.promotion.coupon` instead.
+* Add support for new value `prevented` on enum `Dispute.status`
+* Change `Invoice.id` to be required.
+* Add support for new resource `BalanceSettings`
+* Add support for `modify` and `retrieve` methods on resource `BalanceSettings`
+* Add support for new values `external_request` and `unsupported_business_type` on enums `Account.FutureRequirement.Error.code`, `Account.Requirement.Error.code`, `BankAccount.FutureRequirement.Error.code`, `BankAccount.Requirement.Error.code`, `Capability.FutureRequirement.Error.code`, `Capability.Requirement.Error.code`, `Person.FutureRequirement.Error.code`, and `Person.Requirement.Error.code`
+* Add support for `source` on `Discount`
+* Add support for `mb_way_payments` on `Account.Capability`, `Account.CreateParamsCapability`, and `Account.ModifyParamsCapability`
+* Add support for `trial_update_behavior` on `BillingPortal.Configuration.Feature.SubscriptionUpdate`, `billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdate`, and `billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdate`
+* Add support for `mb_way` on `Charge.PaymentMethodDetail`, `ConfirmationToken.CreateParamsPaymentMethodDatum`, `ConfirmationToken.PaymentMethodPreview`, `PaymentIntent.ConfirmParamsPaymentMethodDatum`, `PaymentIntent.ConfirmParamsPaymentMethodOption`, `PaymentIntent.CreateParamsPaymentMethodDatum`, `PaymentIntent.CreateParamsPaymentMethodOption`, `PaymentIntent.ModifyParamsPaymentMethodDatum`, `PaymentIntent.ModifyParamsPaymentMethodOption`, `PaymentIntent.PaymentMethodOption`, `PaymentMethod.CreateParams`, `PaymentMethod`, `SetupIntent.ConfirmParamsPaymentMethodDatum`, `SetupIntent.CreateParamsPaymentMethodDatum`, and `SetupIntent.ModifyParamsPaymentMethodDatum`
+* Add support for `branding_settings` and `name_collection` on `Checkout.Session` and `checkout.Session.CreateParams`
+* Add support for `excluded_payment_method_types` on `Checkout.Session`, `PaymentIntent.ConfirmParams`, `PaymentIntent.ModifyParams`, and `checkout.Session.CreateParams`
+* Add support for `unit_label` on `Invoice.AddLinesParamsLinePriceDatumProductDatum`, `Invoice.UpdateLinesParamsLinePriceDatumProductDatum`, `InvoiceLineItem.ModifyParamsPriceDatumProductDatum`, `PaymentLink.CreateParamsLineItemPriceDatumProductDatum`, and `checkout.Session.CreateParamsLineItemPriceDatumProductDatum`
+* Add support for `alma`, `billie`, and `satispay` on `Checkout.Session.PaymentMethodOption` and `checkout.Session.CreateParamsPaymentMethodOption`
+* Add support for `demo_pay` on `checkout.Session.CreateParamsPaymentMethodOption`
+* Add support for `capture_method` on `Checkout.Session.PaymentMethodOption.Affirm`, `Checkout.Session.PaymentMethodOption.AfterpayClearpay`, `Checkout.Session.PaymentMethodOption.AmazonPay`, `Checkout.Session.PaymentMethodOption.Card`, `Checkout.Session.PaymentMethodOption.Cashapp`, `Checkout.Session.PaymentMethodOption.Klarna`, `Checkout.Session.PaymentMethodOption.Link`, `Checkout.Session.PaymentMethodOption.Mobilepay`, `Checkout.Session.PaymentMethodOption.RevolutPay`, `checkout.Session.CreateParamsPaymentMethodOptionAffirm`, `checkout.Session.CreateParamsPaymentMethodOptionAfterpayClearpay`, `checkout.Session.CreateParamsPaymentMethodOptionAmazonPay`, `checkout.Session.CreateParamsPaymentMethodOptionCard`, `checkout.Session.CreateParamsPaymentMethodOptionCashapp`, `checkout.Session.CreateParamsPaymentMethodOptionKlarna`, `checkout.Session.CreateParamsPaymentMethodOptionLink`, `checkout.Session.CreateParamsPaymentMethodOptionMobilepay`, and `checkout.Session.CreateParamsPaymentMethodOptionRevolutPay`
+* Add support for `flexible` on `Invoice.CreatePreviewParamsScheduleDetailBillingMode`, `Invoice.CreatePreviewParamsSubscriptionDetailBillingMode`, `Quote.CreateParamsSubscriptionDatumBillingMode`, `Quote.SubscriptionDatum.BillingMode`, `Subscription.BillingMode`, `Subscription.CreateParamsBillingMode`, `Subscription.MigrateParamsBillingMode`, `SubscriptionSchedule.BillingMode`, `SubscriptionSchedule.CreateParamsBillingMode`, and `checkout.Session.CreateParamsSubscriptionDatumBillingMode`
+* Add support for `business_name` and `individual_name` on `Checkout.Session.CollectedInformation`, `Checkout.Session.CustomerDetail`, `Customer.CreateParams`, `Customer.ModifyParams`, and `Customer`
+* Add support for new values `mb_way` on enums `ConfirmationToken.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.ConfirmParamsPaymentMethodDatum.type`, `PaymentIntent.CreateParamsPaymentMethodDatum.type`, `PaymentIntent.ModifyParamsPaymentMethodDatum.type`, `SetupIntent.ConfirmParamsPaymentMethodDatum.type`, `SetupIntent.CreateParamsPaymentMethodDatum.type`, and `SetupIntent.ModifyParamsPaymentMethodDatum.type`
+* Add support for new values `mb_way` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for new values `mb_way` on enums `Customer.ListPaymentMethodsParams.type`, `PaymentMethod.CreateParams.type`, and `PaymentMethod.ListParams.type`
+* Add support for `chargeback_loss_reason_code` on `Dispute.PaymentMethodDetail.Klarna`
+* Add support for `net_amount` and `proration_details` on `InvoiceItem`
+* Add support for `fraud_disputability_likelihood` and `risk_assessment` on `issuing.Authorization.CreateParams`
+* Add support for `second_line` on `Issuing.Card`
+* Add support for new values `mb_way` on enums `PaymentIntent.CreateParams.excluded_payment_method_types` and `PaymentIntent.excluded_payment_method_types`
+* Add support for `fr_meal_voucher_conecs` on `PaymentMethodConfiguration.CreateParams` and `PaymentMethodConfiguration.ModifyParams`
+* Add support for `promotion` on `PromotionCode.CreateParams` and `PromotionCode`
+* Add support for new values `acknowledged` and `payment_never_settled` on enum `Review.closed_reason`
+* Add support for `provider` on `Tax.Settings.Default`
+* Add support for `bbpos_wisepad3` on `Terminal.Configuration`, `terminal.Configuration.CreateParams`, and `terminal.Configuration.ModifyParams`
+* Add support for `address_kana`, `address_kanji`, `display_name_kana`, `display_name_kanji`, and `phone` on `Terminal.Location`, `terminal.Location.CreateParams`, and `terminal.Location.ModifyParams`
+* Change `terminal.Location.CreateParams.address` to be optional
+* Change `terminal.Location.CreateParams.display_name` to be optional
+* Add support for new value `2025-09-30.clover` on enum `WebhookEndpoint.CreateParams.api_version`
+* Add support for error codes `financial_connections_account_pending_account_numbers` and `financial_connections_account_unavailable_account_numbers` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2025-09-24_xavdid_migrate-setup-py.change.md b/.hark/changes/2025-09-24_xavdid_migrate-setup-py.change.md
new file mode 100644
index 000000000..04118cf7f
--- /dev/null
+++ b/.hark/changes/2025-09-24_xavdid_migrate-setup-py.change.md
@@ -0,0 +1,9 @@
+---
+title: migrate from `setup.py` to `pyproject.toml`
+pr_url: https://github.com/stripe/stripe-python/pull/1572
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- ⚠️ The package has swapped from `setup.py` to `pyproject.toml`. As a result, we're dropping support for `pip < 10.0.0` (released April 2018).
+- Additionally, we're no longer shipping tests or examples in our sdist now, which should offer a small size reduction for the package if installed without the wheel (approx. 2.5MB unzipped)
diff --git a/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md b/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md
new file mode 100644
index 000000000..e03063031
--- /dev/null
+++ b/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md
@@ -0,0 +1,9 @@
+---
+title: Add `StripeContext` object
+pr_url: https://github.com/stripe/stripe-python/pull/1589
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- Add the `StripeContext` class. Previously, one could only pass a string for `stripe_context`. You can now use the new class as well.
+- ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
diff --git a/.hark/changes/2025-09-25_xavdid_add-strongly-typed.change.md b/.hark/changes/2025-09-25_xavdid_add-strongly-typed.change.md
new file mode 100644
index 000000000..61f989c0a
--- /dev/null
+++ b/.hark/changes/2025-09-25_xavdid_add-strongly-typed.change.md
@@ -0,0 +1,12 @@
+---
+title: Add strongly typed EventNotifications
+pr_url: https://github.com/stripe/stripe-python/pull/1538
+semver_level: major
+released_in_version: 13.0.0
+---
+
+We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
+- Added matching `EventNotification` classes to every v2 `Event`. For example, there's now a `V1BillingMeterErrorReportTriggeredEventNotification` to match the existing `V1BillingMeterErrorReportTriggeredEvent`. Each notification class defines a `fetch_event()` method to retrieve its corresponding event. For events with related objects, there's a `fetch_related_object()` method that performs the API call and casts the response to the correct type.
+- ⚠️ Rename function `StripeClient.parse_thin_event` to `StripeClient.parse_event_notification` and remove the `Stripe.ThinEvent` class.
+    - This function now returns a `stripe.v2.core.EventNotification` (which is the shared base class that all of the more specific `stripe.events.*EventNotification` classes  share) instead of `Stripe.ThinEvent`. When applicable, these event notifications will have the `related_object` property and a `fetch_related_object()` function. They also have a `fetch_()` method to retrieve their corresponding `stripe.events.*Event` instance.
+    - If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of `Stripe.Events.UnknownEventNotification` instead of a more specific type. It has both the `relatedObject` property and the `FetchRelatedObject()` function (but they may be/return `null`)
diff --git a/.hark/changes/2025-09-29_prathmesh_fixed-invoicelinei-method.change.md b/.hark/changes/2025-09-29_prathmesh_fixed-invoicelinei-method.change.md
new file mode 100644
index 000000000..668afc8fd
--- /dev/null
+++ b/.hark/changes/2025-09-29_prathmesh_fixed-invoicelinei-method.change.md
@@ -0,0 +1,9 @@
+---
+title: Fixed InvoiceLineItem method definition
+pr_url: https://github.com/stripe/stripe-python/pull/1604
+semver_level: major
+released_in_version: 13.0.0
+---
+
+* ⚠️ `InvoiceLineItem.modify` and `InvoiceLineItem.modify_async` now require `invoice` and `line_item_id` as method parameters.
+  * Removed `InvoiceLineItem.ModifyParam` class. Use a `typing.dict` to type hint instead.
diff --git a/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md b/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md
new file mode 100644
index 000000000..e2fec8607
--- /dev/null
+++ b/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md
@@ -0,0 +1,8 @@
+---
+title: Move `V2.Event` API resources to `V2.Core.Events`
+pr_url: https://github.com/stripe/stripe-python/pull/1602
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- ⚠️ Move `stripe.v2._event` and `stripe.v2._event_destination` to `stripe.v2.core._event` and `stripe.v2.core._event_destination` respectively. They now correctly match their API path
diff --git a/.hark/changes/2025-09-29_xavdid_remove-deprecated-compatibilit.change.md b/.hark/changes/2025-09-29_xavdid_remove-deprecated-compatibilit.change.md
new file mode 100644
index 000000000..d2c592166
--- /dev/null
+++ b/.hark/changes/2025-09-29_xavdid_remove-deprecated-compatibilit.change.md
@@ -0,0 +1,44 @@
+---
+title: Remove deprecated compatibility exports
+pr_url: https://github.com/stripe/stripe-python/pull/1603
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- ⚠️ Removed deprecated module shims. They've long been available in the `stripe` module directly; now that's the only place to import them. Specifically, we removed:
+  - `stripe.stripe_response`
+  - `stripe.stripe_object`
+  - `stripe.error_object`
+  - `stripe.error`
+  - `stripe.http_client`
+  - `stripe.util`
+  - `stripe.oauth`
+  - `stripe.webhook`
+  - `stripe.multipart_data_generator`
+  - `stripe.request_metrics`
+  - `stripe.api_resources.abstract`
+  - `stripe.api_resources`
+
+
+To update your code, follow this pattern:
+
+```diff
+-from stripe.<MODULE> import SomeClass
++from stripe import SomeClass
+
+-stripe.<MODULE>.SomeClass
++stripe.SomeClass
+```
+
+- ⚠️ Removed the `FileUpload` alias
+
+To update your code:
+
+```diff
+-from stripe import FileUpload
+-from stripe.api_resources import FileUpload
++from stripe import File
+```
+
+- ⚠️ Removed the `io` import from `stripe._util`. If you had code relying on `stripe.util.io`, you'll need to import the `io` package directly yourself.
+- added `UrllibClient` to `stripe` to make creating your own HTTP client easier.
diff --git a/.hark/changes/2025-09-30_unknown_deprecated-v1-service.change.md b/.hark/changes/2025-09-30_unknown_deprecated-v1-service.change.md
new file mode 100644
index 000000000..97fec2dfc
--- /dev/null
+++ b/.hark/changes/2025-09-30_unknown_deprecated-v1-service.change.md
@@ -0,0 +1,14 @@
+---
+title: Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our [last release](https://github.com/stripe/stripe-python/releases/tag/v12.5.0). Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
+semver_level: major
+released_in_version: 13.0.0
+---
+
+```diff
+client = StripeClient("sk_test...")
+
+# Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
+- client.customers.list()
++ client.v1.customers.list()
+```
+Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
diff --git a/.hark/changes/2025-09-30_xavdid_drop-support-python.change.md b/.hark/changes/2025-09-30_xavdid_drop-support-python.change.md
new file mode 100644
index 000000000..8e31f3b93
--- /dev/null
+++ b/.hark/changes/2025-09-30_xavdid_drop-support-python.change.md
@@ -0,0 +1,10 @@
+---
+title: drop support for Python 3.6 & clarify version policy
+pr_url: https://github.com/stripe/stripe-python/pull/1606
+semver_level: major
+released_in_version: 13.0.0
+---
+
+- Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=python#stripe-sdk-language-version-support-policy)
+    - ⚠️ In this release, we drop support for Python 3.6
+    - Support for Python 3.7 is deprecated and will be removed in the next scheduled major release (March 2026)
diff --git a/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md b/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md
new file mode 100644
index 000000000..e8f8c7175
--- /dev/null
+++ b/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md
@@ -0,0 +1,10 @@
+---
+title: Unify resource and service method parameters into one class
+pr_url: https://github.com/stripe/stripe-python/pull/1596
+semver_level: major
+released_in_version: 13.0.0
+---
+
+* ⚠️ Resource and service request parameter types have been moved to the top-level and are shared, prepended with their related resource/service
+  * For example, `_stripe._account.Account.CreateParams` and `_stripe._account_service.CreateParams` have moved to `_stripe.params._account_create_params.AccountCreateParams`
+  * This change only affects users who explicitly refer to params types. No migration is necessary for users otherwise
diff --git a/.hark/changes/2025-10-02_helenye_make-new-nested.change.md b/.hark/changes/2025-10-02_helenye_make-new-nested.change.md
new file mode 100644
index 000000000..e0c634e85
--- /dev/null
+++ b/.hark/changes/2025-10-02_helenye_make-new-nested.change.md
@@ -0,0 +1,8 @@
+---
+title: Make the new nested params classes correctly importable
+pr_url: https://github.com/stripe/stripe-python/pull/1626
+released_in_version: 13.0.1
+---
+
+- For example, In SDK `v13.0.0`, `from stripe.params.checkout import SessionCreateParamsDiscount` would raise an error when it shouldn't have. This is fixed.
+- Reported in https://github.com/stripe/stripe-python/issues/1625
diff --git a/.hark/changes/2025-10-02_xavdid_re-add-tests.change.md b/.hark/changes/2025-10-02_xavdid_re-add-tests.change.md
new file mode 100644
index 000000000..cb82c7cad
--- /dev/null
+++ b/.hark/changes/2025-10-02_xavdid_re-add-tests.change.md
@@ -0,0 +1,7 @@
+---
+title: Re-add `tests` to our `sdist`
+pr_url: https://github.com/stripe/stripe-python/pull/1627
+released_in_version: 13.0.1
+---
+
+- Reported in https://github.com/stripe/stripe-python/issues/1616
diff --git a/.hark/changes/2025-10-03_xavdid_add-new-async.change.md b/.hark/changes/2025-10-03_xavdid_add-new-async.change.md
new file mode 100644
index 000000000..9de023201
--- /dev/null
+++ b/.hark/changes/2025-10-03_xavdid_add-new-async.change.md
@@ -0,0 +1,8 @@
+---
+title: Add new `async` optional dependency
+pr_url: https://github.com/stripe/stripe-python/pull/1633
+released_in_version: 13.0.1
+---
+
+- Now, `pip install stripe[async]` gets you everything you need to make async HTTP calls out of the box.
+- Reported in https://github.com/stripe/stripe-python/issues/1558
diff --git a/.hark/changes/2025-10-03_xavdid_remove-gpg-step.change.md b/.hark/changes/2025-10-03_xavdid_remove-gpg-step.change.md
new file mode 100644
index 000000000..385e4562c
--- /dev/null
+++ b/.hark/changes/2025-10-03_xavdid_remove-gpg-step.change.md
@@ -0,0 +1,5 @@
+---
+title: remove gpg step from publish. PyPI has ignored these for years, so we took the opportunity to simplify our build process
+pr_url: https://github.com/stripe/stripe-python/pull/1632
+released_in_version: 13.0.1
+---
diff --git a/.hark/changes/2025-10-17_xavdid_dramatically-improve-performance.change.md b/.hark/changes/2025-10-17_xavdid_dramatically-improve-performance.change.md
new file mode 100644
index 000000000..be68d8f3f
--- /dev/null
+++ b/.hark/changes/2025-10-17_xavdid_dramatically-improve-performance.change.md
@@ -0,0 +1,9 @@
+---
+title: Dramatically improve performance by lazily loading most imports
+pr_url: https://github.com/stripe/stripe-python/pull/1645
+released_in_version: 13.1.0
+---
+
+- move many type imports behind an `if TYPE_CHECKING` block
+- lazily initialize subservices
+- add module-level `__getattr__` functions to most `__init__.py` files
diff --git a/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e75504ee7
--- /dev/null
+++ b/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,49 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1650
+is_stripe_api_change: true
+released_in_version: 13.1.0
+---
+
+* Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
+* Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
+* Add support for `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_payment_attempt`, `report_payment`, `report_refund`, and `retrieve` methods on resource `PaymentRecord`
+* Add support for `list` method on resource `PaymentIntentAmountDetailsLineItem`
+* Add support for `representative_declaration` on `Account.Company`, `AccountCreateParamsCompany`, `AccountModifyParamsCompany`, and `TokenCreateParamsAccountCompany`
+* Change `billing.CreditGrantCreateParams.category` to be optional
+* Add support for `payment_method_configuration` on `billing_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdate` and `billing_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdate`
+* Add support for new value `solana` on enum `Charge.PaymentMethodDetail.Crypto.network`
+* Add support for new value `mb_way` on enum `checkout.SessionCreateParams.excluded_payment_method_types`
+* Add support for `twint` on `Checkout.Session.PaymentMethodOption` and `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for new value `mb_way` on enum `checkout.SessionCreateParams.payment_method_types`
+* Add support for new value `custom` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for `payment_record_refund` and `type` on `CreditNote.Refund`, `CreditNoteCreateParamsRefund`, `CreditNotePreviewLinesParamsRefund`, and `CreditNotePreviewParamsRefund`
+* Add support for `customer_sheet` and `mobile_payment_element` on `CustomerSession.Component` and `CustomerSessionCreateParamsComponent`
+* Add support for new value `custom` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `provider` on `Customer.Tax`
+* Add support for new values `balance_settings.updated` and `invoice.payment_attempt_required` on enum `Event.type`
+* Add support for new value `platform_terms_of_service` on enums `File.purpose` and `FileListParams.purpose`
+* Add support for new value `platform_terms_of_service` on enum `FileCreateParams.purpose`
+* Add support for `payment_record` on `InvoiceAttachPaymentParams`, `InvoicePayment.Payment`, and `InvoicePaymentListParamsPayment`
+* Change type of `InvoicePaymentListParamsPayment.type` from `literal('payment_intent')` to `enum('payment_intent'|'payment_record')`
+* Add support for new value `custom` on enums `Invoice.PaymentSetting.payment_method_types`, `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* Add support for `amount_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, and `PaymentIntentModifyParams`
+* Add support for `payment_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentModifyParams`, and `PaymentIntent`
+* Add support for `discount_amount`, `line_items`, `shipping`, and `tax` on `PaymentIntent.AmountDetail`
+* Add support for `name_collection` on `PaymentLinkCreateParams`, `PaymentLinkModifyParams`, and `PaymentLink`
+* Add support for new value `mb_way` on enums `PaymentLink.payment_method_types`, `PaymentLinkCreateParams.payment_method_types`, and `PaymentLinkModifyParams.payment_method_types`
+* Add support for `crypto` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, and `Refund.DestinationDetail`
+* Add support for `mb_way` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, and `PaymentMethodConfiguration`
+* Add support for `custom` on `PaymentMethodCreateParams` and `PaymentMethod`
+* Add support for `excluded_payment_method_types` on `SetupIntentCreateParams`, `SetupIntentModifyParams`, and `SetupIntent`
+* Change `SetupIntent.flow_directions` to be optional
+* Add support for `tw` on `Tax.Registration.CountryOption` and `tax.RegistrationCreateParamsCountryOption`
+* Add support for `gip` on `Terminal.Configuration.Tipping`, `terminal.ConfigurationCreateParamsTipping`, and `terminal.ConfigurationModifyParamsTipping`
+* Add support for `last_seen_at` on `Terminal.Reader`
+* Add support for new values `balance_settings.updated` and `invoice.payment_attempt_required` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointModifyParams.enabled_events`
+* Add support for new value `2025-10-29.clover` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `gt`, `gte`, `lt`, `lte`, and `types` on `v2.core.EventListParams`
+* Change `v2.core.EventListParams.object_id` to be optional
+* Add support for snapshot event `balance_settings.updated` with resource `BalanceSettings`
+* Add support for snapshot event `invoice.payment_attempt_required` with resource `Invoice`
+* Add support for error code `payment_intent_rate_limit_exceeded` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4e9c325f3
--- /dev/null
+++ b/.hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1656
+is_stripe_api_change: true
+released_in_version: 13.1.0
+---
+
+* Improve docs for PaymentIntent related endpoints
diff --git a/.hark/changes/2025-10-31_xavdid_fix-stripe-context.change.md b/.hark/changes/2025-10-31_xavdid_fix-stripe-context.change.md
new file mode 100644
index 000000000..0b2a54853
--- /dev/null
+++ b/.hark/changes/2025-10-31_xavdid_fix-stripe-context.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `stripe-context` header not being included in paged list requests
+pr_url: https://github.com/stripe/stripe-python/pull/1660
+released_in_version: 13.1.1
+---
diff --git a/.hark/changes/2025-11-04_stripe-openapi_add-support-value.change.md b/.hark/changes/2025-11-04_stripe-openapi_add-support-value.change.md
new file mode 100644
index 000000000..c911e644c
--- /dev/null
+++ b/.hark/changes/2025-11-04_stripe-openapi_add-support-value.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for value `payment_record` to enum `InvoicePayment.payment.type`
+pr_url: https://github.com/stripe/stripe-python/pull/1661
+released_in_version: 13.1.2
+---
diff --git a/.hark/changes/2025-11-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c8efc8b5d
--- /dev/null
+++ b/.hark/changes/2025-11-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1662
+is_stripe_api_change: true
+released_in_version: 13.2.0
+---
+
+* Add support for `capture_method` on `PaymentIntent.PaymentMethodOption.CardPresent`, `PaymentIntentConfirmParamsPaymentMethodOptionCardPresent`, `PaymentIntentCreateParamsPaymentMethodOptionCardPresent`, and `PaymentIntentModifyParamsPaymentMethodOptionCardPresent`
diff --git a/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a5f671e14
--- /dev/null
+++ b/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,25 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1667
+is_stripe_api_change: true
+released_in_version: 14.0.0
+---
+
+* Add support for new resources `tax.Association` and `terminal.OnboardingLink`
+* Add support for `find` method on resource `tax.Association`
+* Add support for `create` method on resource `terminal.OnboardingLink`
+* Add support for `payment_method_configuration` on `BillingPortal.Configuration.Feature.PaymentMethodUpdate`
+* Add support for `transaction_id` on `Charge.PaymentMethodDetail.Ideal`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal`, and `PaymentRecord.PaymentMethodDetail.Ideal`
+* Add support for new value `finom` on enums `Charge.PaymentMethodDetail.Ideal.bank`, `ConfirmationToken.PaymentMethodPreview.Ideal.bank`, `ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank`, `PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank`, `PaymentMethod.Ideal.bank`, `PaymentMethodCreateParamsIdeal.bank`, `PaymentRecord.PaymentMethodDetail.Ideal.bank`, `SetupAttempt.PaymentMethodDetail.Ideal.bank`, `SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `SetupIntentCreateParamsPaymentMethodDatumIdeal.bank`, and `SetupIntentModifyParamsPaymentMethodDatumIdeal.bank`
+* Add support for new value `FNOMNL22` on enums `Charge.PaymentMethodDetail.Ideal.bic`, `ConfirmationToken.PaymentMethodPreview.Ideal.bic`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic`, `PaymentMethod.Ideal.bic`, `PaymentRecord.PaymentMethodDetail.Ideal.bic`, and `SetupAttempt.PaymentMethodDetail.Ideal.bic`
+* Add support for new value `tokenized_account_number_deactivated` on enums `ConfirmationToken.PaymentMethodPreview.UsBankAccount.StatusDetail.Blocked.reason` and `PaymentMethod.UsBankAccount.StatusDetail.Blocked.reason`
+* Add support for `created` on `CustomerListCustomerBalanceTransactionParams` and `InvoicePaymentListParams`
+* Add support for new values `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` on enum `Event.type`
+* Add support for `account_numbers` on `FinancialConnections.Account`
+* Change type of `FinancialConnections.Session.client_secret` from `string` to `nullable(string)`
+* Add support for `fraud_risk` on `issuing.AuthorizationCreateParamsRiskAssessment`
+* Add support for `latest_fraud_warning` on `Issuing.Card`
+* Add support for `hooks` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentModifyParams`, and `PaymentIntent`
+* Add support for `mb_way` and `twint` on `Refund.DestinationDetail`
+* Add support for new values `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointModifyParams.enabled_events`
+* Add support for snapshot events `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` with resource `financial_connections.Account`
diff --git a/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md b/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md
new file mode 100644
index 000000000..9df97ecd0
--- /dev/null
+++ b/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md
@@ -0,0 +1,7 @@
+---
+title: Update v2 array parameter serialization to use indexed format
+pr_url: https://github.com/stripe/stripe-python/pull/1669
+released_in_version: 14.0.0
+---
+
+- `Retrieve` and `List` calls for `/v2` endpoints now use indexed format (e.g., `?include[0]=foo&include[1]=bar`) instead of repeated parameter format (e.g., `?include=foo&include=bar`) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
diff --git a/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..27230f01e
--- /dev/null
+++ b/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1673
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 14.0.0
+---
+
+* ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `v2.core.EventListParams` in favor of `created`.
diff --git a/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md b/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md
new file mode 100644
index 000000000..342e49940
--- /dev/null
+++ b/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md
@@ -0,0 +1,5 @@
+---
+title: Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging.
+pr_url: https://github.com/stripe/stripe-python/pull/1681
+released_in_version: 14.0.1
+---
diff --git a/.hark/changes/2025-11-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..43616e71a
--- /dev/null
+++ b/.hark/changes/2025-11-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1684
+is_stripe_api_change: true
+released_in_version: 14.0.1
+---
+
+* `stripe.error` module is now accessible globally. Fixes [#1682](https://github.com/stripe/stripe-python/issues/1682)
diff --git a/.hark/changes/2025-11-24_ramya_add-createasync-method.change.md b/.hark/changes/2025-11-24_ramya_add-createasync-method.change.md
new file mode 100644
index 000000000..b1be74fc6
--- /dev/null
+++ b/.hark/changes/2025-11-24_ramya_add-createasync-method.change.md
@@ -0,0 +1,5 @@
+---
+title: Add create_async method to EphemeralKey
+pr_url: https://github.com/stripe/stripe-python/pull/1676
+released_in_version: 14.1.0
+---
diff --git a/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md b/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md
new file mode 100644
index 000000000..ca9e8b178
--- /dev/null
+++ b/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated bundled CA certificates
+pr_url: https://github.com/stripe/stripe-python/pull/1692
+released_in_version: 14.1.0
+---
diff --git a/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..859eabfa1
--- /dev/null
+++ b/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,42 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1696
+is_stripe_api_change: true
+released_in_version: 14.1.0
+---
+
+* Add support for new resources `v2.core.AccountLink`, `v2.core.AccountPersonToken`, `v2.core.AccountPerson`, `v2.core.AccountToken`, and `v2.core.Account`
+* Add support for `create` and `retrieve` methods on resources `v2.core.AccountPersonToken` and `v2.core.AccountToken`
+* Add support for `create` method on resource `v2.core.AccountLink`
+* Add support for `close`, `create`, `list`, `modify`, and `retrieve` methods on resource `v2.core.Account`
+* Add support for `create`, `delete`, `list`, `modify`, and `retrieve` methods on resource `v2.core.AccountPerson`
+* Add support for `customer_account` on `Billing.CreditBalanceSummary`, `Billing.CreditGrant`, `BillingPortal.Session`, `CashBalance`, `Checkout.Session`, `ConfirmationToken.PaymentMethodPreview`, `CreditNoteListParams`, `CreditNote`, `CustomerBalanceTransaction`, `CustomerCashBalanceTransaction`, `CustomerSessionCreateParams`, `CustomerSession`, `Customer`, `Discount`, `FinancialConnections.Account.AccountHolder`, `FinancialConnections.Session.AccountHolder`, `InvoiceCreateParams`, `InvoiceCreatePreviewParams`, `InvoiceItemCreateParams`, `InvoiceItemListParams`, `InvoiceItem`, `InvoiceListParams`, `Invoice`, `PaymentIntentCreateParams`, `PaymentIntentListParams`, `PaymentIntentModifyParams`, `PaymentIntent`, `PaymentMethodAttachParams`, `PaymentMethodListParams`, `PaymentMethod`, `PromotionCodeCreateParams`, `PromotionCodeListParams`, `PromotionCode`, `QuoteCreateParams`, `QuoteListParams`, `QuoteModifyParams`, `Quote`, `SetupAttempt`, `SetupIntentCreateParams`, `SetupIntentListParams`, `SetupIntentModifyParams`, `SetupIntent`, `SubscriptionCreateParams`, `SubscriptionListParams`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleListParams`, `SubscriptionSchedule`, `Subscription`, `TaxId.Owner`, `TaxIdCreateParamsOwner`, `TaxIdListParamsOwner`, `TaxId`, `billing.CreditBalanceSummaryRetrieveParams`, `billing.CreditBalanceTransactionListParams`, `billing.CreditGrantCreateParams`, `billing.CreditGrantListParams`, `billing_portal.SessionCreateParams`, `checkout.SessionCreateParams`, `checkout.SessionListParams`, `financial_connections.AccountListParamsAccountHolder`, and `financial_connections.SessionCreateParamsAccountHolder`
+* Add support for `metadata` on `LineItem` and `checkout.SessionCreateParamsLineItem`
+* Add support for `payto_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
+* Add support for `signer` on `AccountCreateParamsDocumentProofOfRegistration`, `AccountCreateParamsDocumentProofOfUltimateBeneficialOwnership`, `AccountModifyParamsDocumentProofOfRegistration`, and `AccountModifyParamsDocumentProofOfUltimateBeneficialOwnership`
+* Change `CustomerSessionCreateParams.customer`, `InvoiceItemCreateParams.customer`, `PaymentMethodAttachParams.customer`, `SubscriptionCreateParams.customer`, `billing.CreditBalanceSummaryRetrieveParams.customer`, `billing.CreditBalanceTransactionListParams.customer`, `billing.CreditGrantCreateParams.customer`, and `billing_portal.SessionCreateParams.customer` to be optional
+* Add support for `billing_cycle_anchor` on `BillingPortal.Configuration.Feature.SubscriptionUpdate`, `billing_portal.ConfigurationCreateParamsFeatureSubscriptionUpdate`, and `billing_portal.ConfigurationModifyParamsFeatureSubscriptionUpdate`
+* Add support for `payto` on `Charge.PaymentMethodDetail`, `Checkout.Session.PaymentMethodOption`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `Invoice.PaymentSetting.PaymentMethodOption`, `InvoiceCreateParamsPaymentSettingPaymentMethodOption`, `InvoiceModifyParamsPaymentSettingPaymentMethodOption`, `Mandate.PaymentMethodDetail`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethodModifyParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupAttempt.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodDatum`, `SetupIntentModifyParamsPaymentMethodOption`, `Subscription.PaymentSetting.PaymentMethodOption`, `SubscriptionCreateParamsPaymentSettingPaymentMethodOption`, `SubscriptionModifyParamsPaymentSettingPaymentMethodOption`, and `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for `expected_debit_date` on `Charge.PaymentMethodDetail.AcssDebit`, `Charge.PaymentMethodDetail.AuBecsDebit`, `Charge.PaymentMethodDetail.BacsDebit`, `Charge.PaymentMethodDetail.NzBankAccount`, `Charge.PaymentMethodDetail.SepaDebit`, `Charge.PaymentMethodDetail.UsBankAccount`, `PaymentAttemptRecord.PaymentMethodDetail.AcssDebit`, `PaymentAttemptRecord.PaymentMethodDetail.AuBecsDebit`, `PaymentAttemptRecord.PaymentMethodDetail.BacsDebit`, `PaymentAttemptRecord.PaymentMethodDetail.NzBankAccount`, `PaymentAttemptRecord.PaymentMethodDetail.SepaDebit`, `PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount`, `PaymentRecord.PaymentMethodDetail.AcssDebit`, `PaymentRecord.PaymentMethodDetail.AuBecsDebit`, `PaymentRecord.PaymentMethodDetail.BacsDebit`, `PaymentRecord.PaymentMethodDetail.NzBankAccount`, `PaymentRecord.PaymentMethodDetail.SepaDebit`, and `PaymentRecord.PaymentMethodDetail.UsBankAccount`
+* Add support for new value `mollie` on enums `Charge.PaymentMethodDetail.Ideal.bank`, `ConfirmationToken.PaymentMethodPreview.Ideal.bank`, `ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank`, `PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank`, `PaymentMethod.Ideal.bank`, `PaymentMethodCreateParamsIdeal.bank`, `PaymentRecord.PaymentMethodDetail.Ideal.bank`, `SetupAttempt.PaymentMethodDetail.Ideal.bank`, `SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `SetupIntentCreateParamsPaymentMethodDatumIdeal.bank`, and `SetupIntentModifyParamsPaymentMethodDatumIdeal.bank`
+* Add support for new value `MLLENL2A` on enums `Charge.PaymentMethodDetail.Ideal.bic`, `ConfirmationToken.PaymentMethodPreview.Ideal.bic`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic`, `PaymentMethod.Ideal.bic`, `PaymentRecord.PaymentMethodDetail.Ideal.bic`, and `SetupAttempt.PaymentMethodDetail.Ideal.bic`
+* Add support for new value `payto` on enums `PaymentIntent.excluded_payment_method_types`, `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentModifyParams.excluded_payment_method_types`, `SetupIntent.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, `SetupIntentModifyParams.excluded_payment_method_types`, and `checkout.SessionCreateParams.excluded_payment_method_types`
+* Add support for new value `payto` on enum `checkout.SessionCreateParams.payment_method_types`
+* Add support for `line_items` on `checkout.SessionModifyParams`
+* Add support for new value `payto` on enums `ConfirmationTokenCreateParamsPaymentMethodDatum.type`, `PaymentIntentConfirmParamsPaymentMethodDatum.type`, `PaymentIntentCreateParamsPaymentMethodDatum.type`, `PaymentIntentModifyParamsPaymentMethodDatum.type`, `SetupIntentConfirmParamsPaymentMethodDatum.type`, `SetupIntentCreateParamsPaymentMethodDatum.type`, and `SetupIntentModifyParamsPaymentMethodDatum.type`
+* Add support for new value `payto` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for new value `payto` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `invoice` on `CustomerListCustomerBalanceTransactionParams`
+* Add support for `related_customer_account` on `Identity.VerificationSession`, `identity.VerificationSessionCreateParams`, and `identity.VerificationSessionListParams`
+* Change type of `InvoiceItem.Pricing.PriceDetail.price` and `InvoiceLineItem.Pricing.PriceDetail.price` from `string` to `expandable($Price)`
+* Add support for new value `payto` on enums `Invoice.PaymentSetting.payment_method_types`, `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* Add support for `subtotal` on `InvoiceLineItem`
+* Add support for `authorization_code`, `description`, `iin`, `installments`, `issuer`, `network_advice_code`, `network_decline_code`, and `stored_credential_usage` on `PaymentAttemptRecord.PaymentMethodDetail.Card` and `PaymentRecord.PaymentMethodDetail.Card`
+* Change `PaymentIntent.transfer_data` to be optional
+* Add support for new value `payto` on enums `PaymentLink.payment_method_types`, `PaymentLinkCreateParams.payment_method_types`, and `PaymentLinkModifyParams.payment_method_types`
+* Add support for `allow_redisplay` on `PaymentMethodListParams`
+* Add support for `reported_by` on `PaymentRecord`
+* Change `Product.tax_code` to be optional
+* Add support for new values `2025-12-15.clover` and `2026-01-28.clover` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `changes` on `V2.Core.Event`
+* Add support for error code `account_token_required_for_v2_account` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2025-12-17_mbroshi_update-ci-run.change.md b/.hark/changes/2025-12-17_mbroshi_update-ci-run.change.md
new file mode 100644
index 000000000..85fee9e5b
--- /dev/null
+++ b/.hark/changes/2025-12-17_mbroshi_update-ci-run.change.md
@@ -0,0 +1,5 @@
+---
+title: Update ci to run on Python 3.14 as well
+pr_url: https://github.com/stripe/stripe-python/pull/1703
+released_in_version: 14.2.0
+---
diff --git a/.hark/changes/2025-12-23_ramya_fix-deprecationw-encoding.change.md b/.hark/changes/2025-12-23_ramya_fix-deprecationw-encoding.change.md
new file mode 100644
index 000000000..66686d7a9
--- /dev/null
+++ b/.hark/changes/2025-12-23_ramya_fix-deprecationw-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix DeprecationWarning when encoding StripeObject metadata (fixes #1651)"
+pr_url: https://github.com/stripe/stripe-python/pull/1687
+released_in_version: 14.2.0
+---
diff --git a/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5b663abd8
--- /dev/null
+++ b/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1720
+is_stripe_api_change: true
+released_in_version: 14.2.0
+---
+
+* Add support for event notifications `V2CoreAccountClosedEvent`, `V2CoreAccountCreatedEvent`, `V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationCustomerUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientUpdatedEvent`, `V2CoreAccountIncludingDefaultsUpdatedEvent`, `V2CoreAccountIncludingFutureRequirementsUpdatedEvent`, `V2CoreAccountIncludingIdentityUpdatedEvent`, `V2CoreAccountIncludingRequirementsUpdatedEvent`, and `V2CoreAccountUpdatedEvent` with related object `v2.core.Account`
+* Add support for event notification `V2CoreAccountLinkReturnedEvent`
+* Add support for event notifications `V2CoreAccountPersonCreatedEvent`, `V2CoreAccountPersonDeletedEvent`, and `V2CoreAccountPersonUpdatedEvent` with related object `v2.core.AccountPerson`
diff --git a/.hark/changes/2026-01-19_ramya_add-documentatio-undocumented.change.md b/.hark/changes/2026-01-19_ramya_add-documentatio-undocumented.change.md
new file mode 100644
index 000000000..51f8d9eb6
--- /dev/null
+++ b/.hark/changes/2026-01-19_ramya_add-documentatio-undocumented.change.md
@@ -0,0 +1,5 @@
+---
+title: Add documentation for undocumented API parameters
+pr_url: https://github.com/stripe/stripe-python/pull/1722
+released_in_version: 14.3.0
+---
diff --git a/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..59ffa56d3
--- /dev/null
+++ b/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1725
+is_stripe_api_change: true
+released_in_version: 14.3.0
+---
+
+* Add support for new resource `radar.PaymentEvaluation`
+* Add support for `create` method on resource `radar.PaymentEvaluation`
+* Add support for `adjustable_quantity` on `LineItem`
+* Add support for new value `risk_reserved` on enum `BalanceTransaction.balance_type`
+* Add support for new values `reserve_hold` and `reserve_release` on enum `BalanceTransaction.type`
+* Add support for new values `2.3.0` and `2.3.1` on enums `Charge.PaymentMethodDetail.Card.ThreeDSecure.version`, `PaymentIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version`, `PaymentIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version`, `PaymentIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version`, `SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.version`, `SetupIntentConfirmParamsPaymentMethodOptionCardThreeDSecure.version`, `SetupIntentCreateParamsPaymentMethodOptionCardThreeDSecure.version`, and `SetupIntentModifyParamsPaymentMethodOptionCardThreeDSecure.version`
+* Add support for new value `adyen` on enums `Charge.PaymentMethodDetail.Ideal.bank`, `ConfirmationToken.PaymentMethodPreview.Ideal.bank`, `ConfirmationTokenCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank`, `PaymentIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentCreateParamsPaymentMethodDatumIdeal.bank`, `PaymentIntentModifyParamsPaymentMethodDatumIdeal.bank`, `PaymentMethod.Ideal.bank`, `PaymentMethodCreateParamsIdeal.bank`, `PaymentRecord.PaymentMethodDetail.Ideal.bank`, `SetupAttempt.PaymentMethodDetail.Ideal.bank`, `SetupIntentConfirmParamsPaymentMethodDatumIdeal.bank`, `SetupIntentCreateParamsPaymentMethodDatumIdeal.bank`, and `SetupIntentModifyParamsPaymentMethodDatumIdeal.bank`
+* Add support for new value `ADYBNL2A` on enums `Charge.PaymentMethodDetail.Ideal.bic`, `ConfirmationToken.PaymentMethodPreview.Ideal.bic`, `PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic`, `PaymentMethod.Ideal.bic`, `PaymentRecord.PaymentMethodDetail.Ideal.bic`, and `SetupAttempt.PaymentMethodDetail.Ideal.bic`
+* Add support for new value `pl_nip` on enums `Checkout.Session.CustomerDetail.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetail.TaxId.type`, `Tax.Transaction.CustomerDetail.TaxId.type`, and `TaxId.type`
+* Add support for new value `pl_nip` on enums `CustomerCreateParamsTaxIdDatum.type`, `CustomerCreateTaxIdParams.type`, `InvoiceCreatePreviewParamsCustomerDetailTaxId.type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParamsCustomerDetailTaxId.type`
+* Change `Invoice.PaymentSetting.PaymentMethodOption.payto` and `Subscription.PaymentSetting.PaymentMethodOption.payto` to be required
+* Add support for `enforce_arithmetic_validation` on `PaymentIntentCaptureParamsAmountDetail`, `PaymentIntentConfirmParamsAmountDetail`, `PaymentIntentCreateParamsAmountDetail`, `PaymentIntentIncrementAuthorizationParamsAmountDetail`, and `PaymentIntentModifyParamsAmountDetail`
+* Add support for `error` on `PaymentIntent.AmountDetail`
+* Remove support for `bgn` on `Terminal.Configuration.Tipping`, `terminal.ConfigurationCreateParamsTipping`, and `terminal.ConfigurationModifyParamsTipping`
+* Add support for `topup` on `Treasury.ReceivedDebit.LinkedFlow`
+* Add support for `contact_phone` on `V2.Core.Account`, `v2.core.AccountCreateParams`, `v2.core.AccountModifyParams`, and `v2.core.AccountTokenCreateParams`
+* Add support for `registration_date` on `V2.Core.Account.Identity.BusinessDetail`, `v2.core.AccountCreateParamsIdentityBusinessDetail`, `v2.core.AccountModifyParamsIdentityBusinessDetail`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetail`
+* Add support for new value `gb_vat` on enums `V2.Core.Account.Identity.BusinessDetail.IdNumber.type`, `v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type`, `v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type`
+* Add support for error code `request_blocked` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2026-02-05_prathmesh_added-instruction-update.change.md b/.hark/changes/2026-02-05_prathmesh_added-instruction-update.change.md
new file mode 100644
index 000000000..a37619284
--- /dev/null
+++ b/.hark/changes/2026-02-05_prathmesh_added-instruction-update.change.md
@@ -0,0 +1,5 @@
+---
+title: Added instruction to update CA certificates in README.
+pr_url: https://github.com/stripe/stripe-python/pull/1731
+released_in_version: 14.4.0
+---
diff --git a/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..cdf90098f
--- /dev/null
+++ b/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1732
+is_stripe_api_change: true
+released_in_version: 14.4.0
+---
+
+* Add support for new resources `reserve.Hold`, `reserve.Plan`, and `reserve.Release`
+* Add support for `location` and `reader` on `Charge.PaymentMethodDetail.CardPresent`, `Charge.PaymentMethodDetail.InteracPresent`, `ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetail.CardPresent`, `PaymentAttemptRecord.PaymentMethodDetail.CardPresent`, `PaymentAttemptRecord.PaymentMethodDetail.InteracPresent`, `PaymentMethod.Card.GeneratedFrom.PaymentMethodDetail.CardPresent`, `PaymentRecord.PaymentMethodDetail.CardPresent`, and `PaymentRecord.PaymentMethodDetail.InteracPresent`
+* Add support for new value `lk_vat` on enums `Checkout.Session.CustomerDetail.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetail.TaxId.type`, `Tax.Transaction.CustomerDetail.TaxId.type`, and `TaxId.type`
+* Add support for new value `lk_vat` on enums `CustomerCreateParamsTaxIdDatum.type`, `CustomerCreateTaxIdParams.type`, `InvoiceCreatePreviewParamsCustomerDetailTaxId.type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParamsCustomerDetailTaxId.type`
+* Add support for new values `reserve.hold.created`, `reserve.hold.updated`, `reserve.plan.created`, `reserve.plan.disabled`, `reserve.plan.expired`, `reserve.plan.updated`, and `reserve.release.created` on enum `Event.type`
+* Add support for new values `terminal_wifi_certificate` and `terminal_wifi_private_key` on enums `File.purpose` and `FileListParams.purpose`
+* Add support for new values `terminal_wifi_certificate` and `terminal_wifi_private_key` on enum `FileCreateParams.purpose`
+* Add support for new value `pay_by_bank` on enums `Invoice.PaymentSetting.payment_method_types`, `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* Add support for `display_name` and `service_user_number` on `Mandate.PaymentMethodDetail.BacsDebit`
+* Change type of `PaymentAttemptRecord.PaymentMethodDetail.Boleto.tax_id` and `PaymentRecord.PaymentMethodDetail.Boleto.tax_id` from `string` to `nullable(string)`
+* Change type of `PaymentAttemptRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date` and `PaymentRecord.PaymentMethodDetail.UsBankAccount.expected_debit_date` from `nullable(string)` to `string`
+* Add support for `transaction_purpose` on `PaymentIntent.PaymentMethodOption.UsBankAccount`, `PaymentIntentConfirmParamsPaymentMethodOptionUsBankAccount`, `PaymentIntentCreateParamsPaymentMethodOptionUsBankAccount`, and `PaymentIntentModifyParamsPaymentMethodOptionUsBankAccount`
+* Add support for `optional_items` on `PaymentLinkModifyParams`
+* Remove support for unused `card_issuer_decline` on `Radar.PaymentEvaluation.Insight`
+* Add support for `payment_behavior` on `SubscriptionItemDeleteParams`
+* Add support for `lk` on `Tax.Registration.CountryOption` and `tax.RegistrationCreateParamsCountryOption`
+* Add support for `cellular` and `stripe_s710` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationModifyParams`
+* Add support for new values `simulated_stripe_s710` and `stripe_s710` on enums `Terminal.Reader.device_type` and `terminal.ReaderListParams.device_type`
+* Add support for new values `reserve.hold.created`, `reserve.hold.updated`, `reserve.plan.created`, `reserve.plan.disabled`, `reserve.plan.expired`, `reserve.plan.updated`, and `reserve.release.created` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointModifyParams.enabled_events`
+* Add support for new value `2026-02-25.clover` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for snapshot events `reserve.hold.created` and `reserve.hold.updated` with resource `reserve.Hold`
+* Add support for snapshot events `reserve.plan.created`, `reserve.plan.disabled`, `reserve.plan.expired`, and `reserve.plan.updated` with resource `reserve.Plan`
+* Add support for snapshot event `reserve.release.created` with resource `reserve.Release`
+* Add support for error codes `storer_capability_missing` and `storer_capability_not_active` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2026-02-24_skukutla_allow-aiohttpclien-accept.change.md b/.hark/changes/2026-02-24_skukutla_allow-aiohttpclien-accept.change.md
new file mode 100644
index 000000000..7a7ec2e3e
--- /dev/null
+++ b/.hark/changes/2026-02-24_skukutla_allow-aiohttpclien-accept.change.md
@@ -0,0 +1,5 @@
+---
+title: "Allow AIOHTTPClient to accept user-provided session or connector. Fixes [#1736](https://github.com/stripe/stripe-python/pull/1736)"
+pr_url: https://github.com/stripe/stripe-python/pull/1737
+released_in_version: 14.4.0
+---
diff --git a/.hark/changes/2026-02-28_xavdid_add-agent-information.change.md b/.hark/changes/2026-02-28_xavdid_add-agent-information.change.md
new file mode 100644
index 000000000..cf4065b1d
--- /dev/null
+++ b/.hark/changes/2026-02-28_xavdid_add-agent-information.change.md
@@ -0,0 +1,5 @@
+---
+title: Add agent information to UserAgent
+pr_url: https://github.com/stripe/stripe-python/pull/1743
+released_in_version: 14.4.1
+---
diff --git a/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md b/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md
new file mode 100644
index 000000000..6239ac3fa
--- /dev/null
+++ b/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md
@@ -0,0 +1,5 @@
+---
+title: Add Stripe-Request-Trigger header
+pr_url: https://github.com/stripe/stripe-python/pull/1748
+released_in_version: 14.4.1
+---
diff --git a/.hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md b/.hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md
new file mode 100644
index 000000000..83571bdf1
--- /dev/null
+++ b/.hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md
@@ -0,0 +1,6 @@
+---
+title: Add runtime support for V2 int64 string-encoded fields
+pr_url: https://github.com/stripe/stripe-python/pull/1756
+section: ⚠️ Breaking changes  due to changes in the Stripe API
+released_in_version: 15.0.0
+---
diff --git a/.hark/changes/2026-03-18_xavdid_drop-support-python.change.md b/.hark/changes/2026-03-18_xavdid_drop-support-python.change.md
new file mode 100644
index 000000000..d7df0018d
--- /dev/null
+++ b/.hark/changes/2026-03-18_xavdid_drop-support-python.change.md
@@ -0,0 +1,6 @@
+---
+title: Drop support for Python 3.7 & 3.8
+pr_url: https://github.com/stripe/stripe-python/pull/1764
+semver_level: major
+released_in_version: 15.0.0
+---
diff --git a/.hark/changes/2026-03-18_xavdid_stripeobject-longer-inherits.change.md b/.hark/changes/2026-03-18_xavdid_stripeobject-longer-inherits.change.md
new file mode 100644
index 000000000..f2f97ceaf
--- /dev/null
+++ b/.hark/changes/2026-03-18_xavdid_stripeobject-longer-inherits.change.md
@@ -0,0 +1,13 @@
+---
+title: "`StripeObject` no longer inherits from `dict`"
+pr_url: https://github.com/stripe/stripe-python/pull/1762
+semver_level: major
+released_in_version: 15.0.0
+---
+
+- `StripeObject` no longer inherits from `dict`, so any `dict` methods will no longer exist, including `.get()` and notably, `.items()`.
+  - For convenience, it's still possible to check key presence with `'some_key' in some_obj`. To replicate `.get()` behavior, use `getattr(obj, 'some_key', None)` for now. We've got some improvements around accessing properties that may not be present planned, but `getattr` works for now.
+  - `.update()` has been retained for easier interaction with `metadata`, but it's not really intended for use on full objects.
+  - Equality between `StripeObject`s still works: it checks for equality between the same class and underlying data.
+- To access the underlying data as a `dict`, call `some_obj.to_dict()`, which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of `to_dict()` won't affect the original object.
+- Write operations can still be done with dot notation (`some_obj.val = 123`) or bracket notation (`some_obj["val"] = 123`). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.
diff --git a/.hark/changes/2026-03-24_xavdid_throw-error-using.change.md b/.hark/changes/2026-03-24_xavdid_throw-error-using.change.md
new file mode 100644
index 000000000..ee6f6256a
--- /dev/null
+++ b/.hark/changes/2026-03-24_xavdid_throw-error-using.change.md
@@ -0,0 +1,6 @@
+---
+title: Throw an error when using the wrong webhook parsing method
+pr_url: https://github.com/stripe/stripe-python/pull/1767
+semver_level: major
+released_in_version: 15.0.0
+---
diff --git a/.hark/changes/2026-03-25_jar_add-decimalstrin-coercion.change.md b/.hark/changes/2026-03-25_jar_add-decimalstrin-coercion.change.md
new file mode 100644
index 000000000..17367b0e7
--- /dev/null
+++ b/.hark/changes/2026-03-25_jar_add-decimalstrin-coercion.change.md
@@ -0,0 +1,18 @@
+---
+title: Add decimal_string coercion for v1 and v2 API fields
+pr_url: https://github.com/stripe/stripe-python/pull/1769
+semver_level: major
+released_in_version: 15.0.0
+---
+
+- All `decimal_string` fields changed type from `str` to `decimal.Decimal` in both request params and response objects. Code that reads or writes these fields as `str` will need to use `Decimal` instead. Affected fields across v1 and v2 APIs:
+  - **checkout.Session**: `fx_rate`
+  - **climate.Order**: `metric_tons`; **climate.Product**: `metric_tons_available`
+  - **CreditNoteLineItem**: `unit_amount_decimal`
+  - **InvoiceItem**: `quantity_decimal`, `unit_amount_decimal`
+  - **InvoiceLineItem**: `quantity_decimal`, `unit_amount_decimal`
+  - **issuing.Authorization** / **issuing.Transaction** (and TestHelpers): `quantity_decimal`, `unit_cost_decimal`, `gross_amount_decimal`, `local_amount_decimal`, `national_amount_decimal`
+  - **Plan**: `amount_decimal`, `flat_amount_decimal`, `unit_amount_decimal`
+  - **Price**: `unit_amount_decimal`, `flat_amount_decimal` (including `currency_options` and `tiers`)
+  - **v2.core.Account** / **v2.core.AccountPerson**: `percent_ownership`
+  - Request params on **Invoice**, **Product**, **Quote**, **Subscription**, **SubscriptionItem**, **SubscriptionSchedule**, **PaymentLink**: `unit_amount_decimal`, `flat_amount_decimal`, `quantity_decimal` (where applicable)
diff --git a/.hark/changes/2026-03-25_unknown_generated-changes-1749.change.md b/.hark/changes/2026-03-25_unknown_generated-changes-1749.change.md
new file mode 100644
index 000000000..bf4ab4edb
--- /dev/null
+++ b/.hark/changes/2026-03-25_unknown_generated-changes-1749.change.md
@@ -0,0 +1,43 @@
+---
+title: "Generated changes from [#1749](https://github.com/stripe/stripe-python/pull/1749), [#1771](https://github.com/stripe/stripe-python/pull/1771), [#1773](https://github.com/stripe/stripe-python/pull/1773), [#1775](https://github.com/stripe/stripe-python/pull/1775)"
+semver_level: major
+is_stripe_api_change: true
+section: ⚠️ Breaking changes  due to changes in the Stripe API
+released_in_version: 15.0.0
+---
+
+* Add support for `upi_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
+* Add support for `upi` on `Charge.PaymentMethodDetail`, `Checkout.Session.PaymentMethodOption`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `Mandate.PaymentMethodDetail`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupAttempt.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodDatum`, `SetupIntentModifyParamsPaymentMethodOption`, and `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for new value `tempo` on enums `Charge.PaymentMethodDetail.Crypto.network`, `PaymentAttemptRecord.PaymentMethodDetail.Crypto.network`, and `PaymentRecord.PaymentMethodDetail.Crypto.network`
+* Add support for `integration_identifier` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Add support for new value `upi` on enums `PaymentIntent.excluded_payment_method_types`, `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentModifyParams.excluded_payment_method_types`, `SetupIntent.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, `SetupIntentModifyParams.excluded_payment_method_types`, and `checkout.SessionCreateParams.excluded_payment_method_types`
+* Add support for `crypto` on `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for new value `upi` on enum `checkout.SessionCreateParams.payment_method_types`
+* Add support for `pending_invoice_item_interval` on `checkout.SessionCreateParamsSubscriptionDatum`
+* Add support for new values `elements`, `embedded_page`, `form`, and `hosted_page` on enums `Checkout.Session.ui_mode` and `checkout.SessionCreateParams.ui_mode`
+* Add support for new value `marine_carbon_removal` on enum `Climate.Supplier.removal_pathway`
+* Add support for new value `upi` on enums `ConfirmationTokenCreateParamsPaymentMethodDatum.type`, `PaymentIntentConfirmParamsPaymentMethodDatum.type`, `PaymentIntentCreateParamsPaymentMethodDatum.type`, `PaymentIntentModifyParamsPaymentMethodDatum.type`, `SetupIntentConfirmParamsPaymentMethodDatum.type`, `SetupIntentCreateParamsPaymentMethodDatum.type`, and `SetupIntentModifyParamsPaymentMethodDatum.type`
+* Add support for new value `upi` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for `metadata` on `CreditNoteCreateParamsLine`, `CreditNoteLineItem`, `CreditNotePreviewLinesParamsLine`, and `CreditNotePreviewParamsLine`
+* Add support for new value `upi` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `quantity_decimal` on `InvoiceAddLinesParamsLine`, `InvoiceCreatePreviewParamsInvoiceItem`, `InvoiceItemCreateParams`, `InvoiceItemModifyParams`, `InvoiceItem`, `InvoiceLineItemModifyParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParamsLine`
+* ⚠️ Add support for `level` on `issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk` and `issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk`
+* ⚠️ Remove support for `risk_level` on `issuing.AuthorizationCreateParamsRiskAssessmentCardTestingRisk` and `issuing.AuthorizationCreateParamsRiskAssessmentMerchantDisputeRisk`
+* Add support for `lifecycle_controls` on `Issuing.Card` and `issuing.CardCreateParams`
+* ⚠️ Change type of `Issuing.Token.NetworkDatum.Visa.card_reference_id` from `string` to `nullable(string)`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.brand` and `PaymentRecord.PaymentMethodDetail.Card.brand` from `enum` to `nullable(enum)`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.exp_month` and `PaymentRecord.PaymentMethodDetail.Card.exp_month` from `longInteger` to `nullable(longInteger)`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.exp_year` and `PaymentRecord.PaymentMethodDetail.Card.exp_year` from `longInteger` to `nullable(longInteger)`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.funding` and `PaymentRecord.PaymentMethodDetail.Card.funding` from `enum('credit'|'debit'|'prepaid'|'unknown')` to `nullable(enum('credit'|'debit'|'prepaid'|'unknown'))`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.last4` and `PaymentRecord.PaymentMethodDetail.Card.last4` from `string` to `nullable(string)`
+* ⚠️ Change type of `PaymentAttemptRecord.PaymentMethodDetail.Card.moto` and `PaymentRecord.PaymentMethodDetail.Card.moto` from `boolean` to `nullable(boolean)`
+* Add support for `cryptogram`, `electronic_commerce_indicator`, `exemption_indicator_applied`, and `exemption_indicator` on `PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure` and `PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure`
+* Add support for `upi_handle_redirect_or_display_qr_code` on `PaymentIntent.NextAction` and `SetupIntent.NextAction`
+* Add support for new value `upi` on enums `PaymentLink.payment_method_types`, `PaymentLinkCreateParams.payment_method_types`, and `PaymentLinkModifyParams.payment_method_types`
+* Add support for `recommended_action` and `signals` on `Radar.PaymentEvaluation`
+* ⚠️ Remove support for `insights` on `Radar.PaymentEvaluation`
+* Add support for new value `crypto_fingerprint` on enums `Radar.ValueList.item_type` and `radar.ValueListCreateParams.item_type`
+* Add support for new value `canceled_by_retention_policy` on enum `Subscription.CancellationDetail.reason`
+* Add support for new value `2026-03-25.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* ⚠️ Change type of `V2.Core.EventDestination.events_from` and `v2.core.EventDestinationCreateParams.events_from` from `enum('other_accounts'|'self')` to `string`
+* Add support for error code `service_period_coupon_with_metered_tiered_item_unsupported` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2026-03-31_xavdid_fix-str-repr.change.md b/.hark/changes/2026-03-31_xavdid_fix-str-repr.change.md
new file mode 100644
index 000000000..7c2acd92d
--- /dev/null
+++ b/.hark/changes/2026-03-31_xavdid_fix-str-repr.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `str` / `repr` for `StripeObjects` with decimals & add support for plain dicts
+pr_url: https://github.com/stripe/stripe-python/pull/1780
+released_in_version: 15.0.1
+---
diff --git a/.hark/changes/2026-04-01_jar_fix-encoding-two.change.md b/.hark/changes/2026-04-01_jar_fix-encoding-two.change.md
new file mode 100644
index 000000000..dfc88bf6b
--- /dev/null
+++ b/.hark/changes/2026-04-01_jar_fix-encoding-two.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix encoding two-dimensional array request params
+pr_url: https://github.com/stripe/stripe-python/pull/1786
+released_in_version: 15.0.1
+---
diff --git a/.hark/changes/2026-04-01_xavdid_improve-types-metadata.change.md b/.hark/changes/2026-04-01_xavdid_improve-types-metadata.change.md
new file mode 100644
index 000000000..ec0a97a56
--- /dev/null
+++ b/.hark/changes/2026-04-01_xavdid_improve-types-metadata.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve types for `metadata` and other dict-like types
+pr_url: https://github.com/stripe/stripe-python/pull/1785
+released_in_version: 15.0.1
+---
diff --git a/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..273414f1b
--- /dev/null
+++ b/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,47 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1793
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 15.1.0
+---
+
+* Add support for `balance_report` and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSessionCreateParamsComponent`
+* Add support for `app_distribution` and `sunbit_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
+* ⚠️ Add support for new values `fee_credit_funding`, `inbound_transfer_reversal`, and `inbound_transfer` on enum `BalanceTransaction.type`
+* Add support for `sunbit` on `Charge.PaymentMethodDetail`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodDatum`, and `SetupIntentModifyParamsPaymentMethodDatum`
+* ⚠️ Add support for new values `phantom_cash` and `usdt` on enums `Charge.PaymentMethodDetail.Crypto.token_currency`, `PaymentAttemptRecord.PaymentMethodDetail.Crypto.token_currency`, and `PaymentRecord.PaymentMethodDetail.Crypto.token_currency`
+* Add support for `location` and `reader` on `Charge.PaymentMethodDetail.Klarna`, `PaymentAttemptRecord.PaymentMethodDetail.Klarna`, and `PaymentRecord.PaymentMethodDetail.Klarna`
+* Add support for `mandate` on `Charge.PaymentMethodDetail.Pix`, `PaymentAttemptRecord.PaymentMethodDetail.Pix`, and `PaymentRecord.PaymentMethodDetail.Pix`
+* Add support for `managed_payments` on `Checkout.Session`, `PaymentIntent`, `PaymentLinkCreateParams`, `PaymentLink`, `SetupIntent`, `Subscription`, and `checkout.SessionCreateParams`
+* Add support for new value `sunbit` on enums `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentModifyParams.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, `SetupIntentModifyParams.excluded_payment_method_types`, and `checkout.SessionCreateParams.excluded_payment_method_types`
+* Add support for `mandate_options` on `Checkout.Session.PaymentMethodOption.Pix`, `PaymentIntent.PaymentMethodOption.Pix`, `PaymentIntentConfirmParamsPaymentMethodOptionPix`, `PaymentIntentCreateParamsPaymentMethodOptionPix`, `PaymentIntentModifyParamsPaymentMethodOptionPix`, and `checkout.SessionCreateParamsPaymentMethodOptionPix`
+* Change type of `PaymentIntentConfirmParamsPaymentMethodOptionPix.setup_future_usage`, `PaymentIntentCreateParamsPaymentMethodOptionPix.setup_future_usage`, `PaymentIntentModifyParamsPaymentMethodOptionPix.setup_future_usage`, and `checkout.SessionCreateParamsPaymentMethodOptionPix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new value `sunbit` on enum `checkout.SessionCreateParams.payment_method_types`
+* ⚠️ Add support for new values `fo_vat`, `gi_tin`, `it_cf`, and `py_ruc` on enums `Checkout.Session.CustomerDetail.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetail.TaxId.type`, `Tax.Transaction.CustomerDetail.TaxId.type`, and `TaxId.type`
+* ⚠️ Change type of `Checkout.Session.PaymentMethodOption.Pix.setup_future_usage` and `PaymentIntent.PaymentMethodOption.Pix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new value `sunbit` on enums `ConfirmationTokenCreateParamsPaymentMethodDatum.type`, `PaymentIntentConfirmParamsPaymentMethodDatum.type`, `PaymentIntentCreateParamsPaymentMethodDatum.type`, `PaymentIntentModifyParamsPaymentMethodDatum.type`, `SetupIntentConfirmParamsPaymentMethodDatum.type`, `SetupIntentCreateParamsPaymentMethodDatum.type`, and `SetupIntentModifyParamsPaymentMethodDatum.type`
+* ⚠️ Add support for new value `sunbit` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for new values `fo_vat`, `gi_tin`, `it_cf`, and `py_ruc` on enums `CustomerCreateParamsTaxIdDatum.type`, `CustomerCreateTaxIdParams.type`, `InvoiceCreatePreviewParamsCustomerDetailTaxId.type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParamsCustomerDetailTaxId.type`
+* Add support for new value `sunbit` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `pix` on `Invoice.PaymentSetting.PaymentMethodOption`, `InvoiceCreateParamsPaymentSettingPaymentMethodOption`, `InvoiceModifyParamsPaymentSettingPaymentMethodOption`, `Mandate.PaymentMethodDetail`, `SetupAttempt.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodOption`, `Subscription.PaymentSetting.PaymentMethodOption`, `SubscriptionCreateParamsPaymentSettingPaymentMethodOption`, and `SubscriptionModifyParamsPaymentSettingPaymentMethodOption`
+* Add support for `upi` on `Invoice.PaymentSetting.PaymentMethodOption`, `InvoiceCreateParamsPaymentSettingPaymentMethodOption`, `InvoiceModifyParamsPaymentSettingPaymentMethodOption`, `Subscription.PaymentSetting.PaymentMethodOption`, `SubscriptionCreateParamsPaymentSettingPaymentMethodOption`, and `SubscriptionModifyParamsPaymentSettingPaymentMethodOption`
+* Add support for new values `pix` and `upi` on enums `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* ⚠️ Add support for new values `pix` and `upi` on enums `Invoice.PaymentSetting.payment_method_types` and `Subscription.PaymentSetting.payment_method_types`
+* Add support for `card_presence` on `Issuing.Authorization`
+* Add support for `allowed_card_presences` and `blocked_card_presences` on `Issuing.Card.SpendingControl`, `Issuing.Cardholder.SpendingControl`, `issuing.CardCreateParamsSpendingControl`, `issuing.CardModifyParamsSpendingControl`, `issuing.CardholderCreateParamsSpendingControl`, and `issuing.CardholderModifyParamsSpendingControl`
+* ⚠️ Add support for new value `fulfillment_error` on enum `Issuing.Card.cancellation_reason`
+* ⚠️ Add support for new value `fulfillment_error` on enum `Issuing.Card.replacement_reason`
+* Add support for `amount` and `currency` on `Mandate.MultiUse`
+* Add support for `amount_to_confirm` on `PaymentIntentConfirmParams`
+* ⚠️ Add support for new value `sunbit` on enums `PaymentIntent.excluded_payment_method_types` and `SetupIntent.excluded_payment_method_types`
+* Add support for `klarna_display_qr_code` on `PaymentIntent.NextAction`
+* Add support for new value `sunbit` on enums `PaymentLinkCreateParams.payment_method_types` and `PaymentLinkModifyParams.payment_method_types`
+* ⚠️ Add support for new value `sunbit` on enum `PaymentLink.payment_method_types`
+* ⚠️ Add support for new values `low`, `not_assessed`, and `unknown` on enum `Radar.PaymentEvaluation.Signal.FraudulentPayment.risk_level`
+* Add support for new value `account` on enum `radar.ValueListCreateParams.item_type`
+* ⚠️ Add support for new value `account` on enum `Radar.ValueList.item_type`
+* Add support for `moto` on `SetupAttempt.PaymentMethodDetail.Card`
+* Add support for `pix_display_qr_code` on `SetupIntent.NextAction`
+* Add support for new value `2026-04-22.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for error codes `action_blocked` and `approval_required` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2026-05-22_xavdid_emit-warning-stripe.change.md b/.hark/changes/2026-05-22_xavdid_emit-warning-stripe.change.md
new file mode 100644
index 000000000..aae29581b
--- /dev/null
+++ b/.hark/changes/2026-05-22_xavdid_emit-warning-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Emit warning when `stripe-notify` header is present in response
+pr_url: https://github.com/stripe/stripe-python/pull/1813
+released_in_version: 15.2.0
+---
diff --git a/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9a171f70d
--- /dev/null
+++ b/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,57 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1816
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 15.2.0
+---
+
+* Add support for new resource `v2.commerce.ProductCatalogImport`
+* Add support for `create` and `retrieve` methods on resource `v2.commerce.ProductCatalogImport`
+* Add support for `bizum_payments` and `scalapay_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
+* Add support for `automatic_transfer_rules_by_currency` on `BalanceSettings.Payment.Payout` and `BalanceSettingsModifyParamsPaymentPayout`
+* Add support for `start_of_day` on `BalanceSettings.Payment.SettlementTiming` and `BalanceSettingsModifyParamsPaymentSettlementTiming`
+* Add support for `description` on `ChargeCreateParamsTransferDatum`, `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, and `PaymentIntentModifyParamsTransferDatum`
+* Add support for `bizum` on `Charge.PaymentMethodDetail`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodDatum`, and `SetupIntentModifyParamsPaymentMethodOption`
+* Add support for `scalapay` on `Charge.PaymentMethodDetail`, `Checkout.Session.PaymentMethodOption`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `Refund.DestinationDetail`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentModifyParamsPaymentMethodDatum`, and `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for `mandate` on `Charge.PaymentMethodDetail.Twint`, `PaymentAttemptRecord.PaymentMethodDetail.Twint`, and `PaymentRecord.PaymentMethodDetail.Twint`
+* Add support for new values `bizum` and `scalapay` on enums `PaymentIntentConfirmParams.excluded_payment_method_types`, `PaymentIntentCreateParams.excluded_payment_method_types`, `PaymentIntentModifyParams.excluded_payment_method_types`, `SetupIntentCreateParams.excluded_payment_method_types`, `SetupIntentModifyParams.excluded_payment_method_types`, and `checkout.SessionCreateParams.excluded_payment_method_types`
+* Change type of `PaymentIntentConfirmParamsPaymentMethodOptionTwint.setup_future_usage`, `PaymentIntentCreateParamsPaymentMethodOptionTwint.setup_future_usage`, `PaymentIntentModifyParamsPaymentMethodOptionTwint.setup_future_usage`, and `checkout.SessionCreateParamsPaymentMethodOptionTwint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new values `bizum` and `scalapay` on enum `checkout.SessionCreateParams.payment_method_types`
+* ⚠️ Change type of `Checkout.Session.PaymentMethodOption.Twint.setup_future_usage` and `PaymentIntent.PaymentMethodOption.Twint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new values `bizum` and `scalapay` on enums `ConfirmationTokenCreateParamsPaymentMethodDatum.type`, `PaymentIntentConfirmParamsPaymentMethodDatum.type`, `PaymentIntentCreateParamsPaymentMethodDatum.type`, `PaymentIntentModifyParamsPaymentMethodDatum.type`, `SetupIntentConfirmParamsPaymentMethodDatum.type`, `SetupIntentCreateParamsPaymentMethodDatum.type`, and `SetupIntentModifyParamsPaymentMethodDatum.type`
+* ⚠️ Add support for new values `bizum` and `scalapay` on enums `ConfirmationToken.PaymentMethodPreview.type` and `PaymentMethod.type`
+* Add support for new values `bizum` and `scalapay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `credited_items` on `InvoiceItem.ProrationDetail`
+* Add support for new value `twint` on enums `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* Add support for `discountable` on `InvoiceCreatePreviewParamsScheduleDetailPhaseAddInvoiceItem`, `SubscriptionCreateParamsAddInvoiceItem`, `SubscriptionModifyParamsAddInvoiceItem`, `SubscriptionSchedule.Phase.AddInvoiceItem`, `SubscriptionScheduleCreateParamsPhaseAddInvoiceItem`, and `SubscriptionScheduleModifyParamsPhaseAddInvoiceItem`
+* Add support for `billing_schedules` on `InvoiceCreatePreviewParamsSubscriptionDetail`, `SubscriptionCreateParams`, `SubscriptionModifyParams`, and `Subscription`
+* Add support for new value `max_billed_until` on enums `InvoiceCreatePreviewParamsSubscriptionDetail.cancel_at`, `SubscriptionCreateParams.cancel_at`, and `SubscriptionModifyParams.cancel_at`
+* Add support for `amount_paid_off_stripe` on `Invoice`
+* ⚠️ Add support for new value `twint` on enums `Invoice.PaymentSetting.payment_method_types` and `Subscription.PaymentSetting.payment_method_types`
+* Add support for `twint` on `Mandate.PaymentMethodDetail` and `SetupAttempt.PaymentMethodDetail`
+* Add support for `metadata` on `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, `PaymentIntentModifyParamsTransferDatum`, and `Subscription.PendingUpdate`
+* Add support for `payment_data` on `PaymentIntent.TransferDatum`, `PaymentIntentCreateParamsTransferDatum`, and `PaymentIntentModifyParamsTransferDatum`
+* ⚠️ Add support for new values `bizum` and `scalapay` on enums `PaymentIntent.excluded_payment_method_types` and `SetupIntent.excluded_payment_method_types`
+* Add support for `blik_authorize` on `PaymentIntent.NextAction` and `SetupIntent.NextAction`
+* Add support for `payment_method_options` on `PaymentLinkCreateParams`, `PaymentLinkModifyParams`, and `PaymentLink`
+* Add support for new value `bizum` on enums `PaymentLinkCreateParams.payment_method_types` and `PaymentLinkModifyParams.payment_method_types`
+* ⚠️ Add support for new value `bizum` on enum `PaymentLink.payment_method_types`
+* Add support for `active` on `PaymentMethodConfigurationListParams`
+* Add support for `billed_until` on `SubscriptionItem`
+* Add support for `discount` and `discounts` on `Subscription.PendingUpdate`
+* Add support for `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationModifyParams`
+* Add support for new values `simulated_verifone_m425`, `simulated_verifone_p630`, `simulated_verifone_ux700`, `simulated_verifone_v660p`, `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on enum `terminal.ReaderListParams.device_type`
+* Add support for `api_error` and `print_content` on `Terminal.Reader.Action`
+* ⚠️ Add support for new value `print_content` on enum `Terminal.Reader.Action.type`
+* ⚠️ Add support for new values `simulated_verifone_m425`, `simulated_verifone_p630`, `simulated_verifone_ux700`, `simulated_verifone_v660p`, `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on enum `Terminal.Reader.device_type`
+* Add support for `customer` on `test_helpers.TestClockCreateParams`
+* Add support for new value `2026-05-27.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `signer` on `V2.Core.Account.Identity.BusinessDetail.Document.ProofOfRegistration`, `V2.Core.Account.Identity.BusinessDetail.Document.ProofOfUltimateBeneficialOwnership`, `v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfRegistration`, `v2.core.AccountCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`, `v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfRegistration`, `v2.core.AccountModifyParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`, `v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfRegistration`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetailDocumentProofOfUltimateBeneficialOwnership`
+* Add support for `azure_event_grid` on `V2.Core.EventDestination` and `v2.core.EventDestinationCreateParams`
+* ⚠️ Add support for new value `no_azure_partner_topic_exists` on enum `V2.Core.EventDestination.StatusDetail.Disabled.reason`
+* ⚠️ Add support for new value `azure_event_grid` on enum `V2.Core.EventDestination.type`
+* Add support for new value `azure_event_grid` on enum `v2.core.EventDestinationCreateParams.type`
+* ⚠️ Add support for new value `meter_event_value_too_many_digits` on enums `EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code` and `EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.code`
+* Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `v2.commerce.ProductCatalogImport`
+* Add support for error codes `payment_method_microdeposit_processing_error` and `siret_invalid` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
diff --git a/.hark/changes/2026-06-05_xavdid_add-source-field.change.md b/.hark/changes/2026-06-05_xavdid_add-source-field.change.md
new file mode 100644
index 000000000..219f158f9
--- /dev/null
+++ b/.hark/changes/2026-06-05_xavdid_add-source-field.change.md
@@ -0,0 +1,5 @@
+---
+title: Add "source" field to user-agent header
+pr_url: https://github.com/stripe/stripe-python/pull/1825
+released_in_version: 15.2.1
+---
diff --git a/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..21ff3e5bd
--- /dev/null
+++ b/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,43 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1836
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 15.3.0
+---
+
+* Add support for `release_details` on `Reserve.Hold`
+* ⚠️ Add support for new value `tax_fund` on enum `BalanceTransaction.type`
+* Change `Billing.CreditGrant.priority` to be required
+* Add support for `buyer_id` on `Charge.PaymentMethodDetail.Bizum`, `ConfirmationToken.PaymentMethodPreview.Bizum`, `ConfirmationToken.PaymentMethodPreview.Blik`, `PaymentAttemptRecord.PaymentMethodDetail.Bizum`, `PaymentMethod.Bizum`, `PaymentMethod.Blik`, and `PaymentRecord.PaymentMethodDetail.Bizum`
+* Add support for `transaction_link_id` on `Charge.PaymentMethodDetail.Card`
+* ⚠️ Add support for new value `sui` on enums `Charge.PaymentMethodDetail.Crypto.network`, `PaymentAttemptRecord.PaymentMethodDetail.Crypto.network`, and `PaymentRecord.PaymentMethodDetail.Crypto.network`
+* ⚠️ Add support for new value `usdsui` on enums `Charge.PaymentMethodDetail.Crypto.token_currency`, `PaymentAttemptRecord.PaymentMethodDetail.Crypto.token_currency`, and `PaymentRecord.PaymentMethodDetail.Crypto.token_currency`
+* Add support for `fingerprint` on `Charge.PaymentMethodDetail.Pix`, `ConfirmationToken.PaymentMethodPreview.Pix`, `PaymentMethod.Pix`, and `SetupAttempt.PaymentMethodDetail.Pix`
+* Add support for `sunbit` on `Checkout.Session.PaymentMethodOption`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodOption`, and `checkout.SessionCreateParamsPaymentMethodOption`
+* Add support for `billing_cycle_anchor_config` on `checkout.SessionCreateParamsSubscriptionDatum`
+* Add support for `wechat_pay` on `Checkout.Session.PaymentMethodOption`
+* Add support for `mastercard_compliance` on `Dispute.Evidence.EnhancedEvidence`, `Dispute.EvidenceDetail.EnhancedEligibility`, and `DisputeModifyParamsEvidenceEnhancedEvidence`
+* ⚠️ Add support for new value `mastercard_compliance` on enum `Dispute.enhanced_eligibility_types`
+* Add support for `status_details` on `FinancialConnections.Account`
+* ⚠️ Add support for new value `validated` on enum `Identity.VerificationSession.Redaction.status`
+* Add support for new value `satispay` on enums `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* ⚠️ Add support for new value `satispay` on enums `Invoice.PaymentSetting.payment_method_types` and `Subscription.PaymentSetting.payment_method_types`
+* ⚠️ Remove support for `stored_credential_usage` on `PaymentAttemptRecord.PaymentMethodDetail.Card` and `PaymentRecord.PaymentMethodDetail.Card`
+* ⚠️ Change `PaymentAttemptRecord.PaymentMethodDetail.Card.description` and `PaymentRecord.PaymentMethodDetail.Card.description` to be optional
+* ⚠️ Change `PaymentAttemptRecord.PaymentMethodDetail.Card.iin` and `PaymentRecord.PaymentMethodDetail.Card.iin` to be optional
+* ⚠️ Change `PaymentAttemptRecord.PaymentMethodDetail.Card.issuer` and `PaymentRecord.PaymentMethodDetail.Card.issuer` to be optional
+* Add support for `setup_future_usage` on `PaymentIntent.PaymentMethodOption.Satispay`, `PaymentIntentConfirmParamsPaymentMethodOptionSatispay`, `PaymentIntentCreateParamsPaymentMethodOptionSatispay`, and `PaymentIntentModifyParamsPaymentMethodOptionSatispay`
+* Change `PaymentRecordReportRefundParams.refunded` to be optional
+* Add support for `satispay` on `SetupAttempt.PaymentMethodDetail`
+* Add support for `custom_fields`, `description`, and `footer` on `Subscription.InvoiceSetting`, `SubscriptionCreateParamsInvoiceSetting`, and `SubscriptionModifyParamsInvoiceSetting`
+* Add support for `payment_method_options` and `payment_method` on `TopupCreateParams`
+* Add support for new value `2026-06-24.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `mode` on `V2.Commerce.ProductCatalogImport`
+* ⚠️ Add support for new value `promotion` on enum `V2.Commerce.ProductCatalogImport.feed_type`
+* Add support for `sunbit_payments` on `V2.Core.Account.Configuration.Merchant.Capability`, `v2.core.AccountCreateParamsConfigurationMerchantCapability`, and `v2.core.AccountModifyParamsConfigurationMerchantCapability`
+* Add support for `crypto_money_manager` and `money_manager` on `v2.core.AccountModifyParamsIdentityAttestationTermsOfService`
+* ⚠️ Remove support for `crypto_storer` and `storer` on `v2.core.AccountModifyParamsIdentityAttestationTermsOfService`
+* Add support for new value `promotion` on enum `v2.commerce.ProductCatalogImportCreateParams.feed_type`
+* ⚠️ Add support for new value `sunbit_payments` on enum `EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability`
+* Add support for error codes `anomalous_money_movement_request`, `failed_tax_calculation`, `financial_account_balance_does_not_support_currency`, `financial_account_capability_not_enabled`, and `financial_account_capability_restricted` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, `StripeError`, and `Terminal.Reader.Action.ApiError`
diff --git a/.hark/changes/2026-07-01_jar_reduce-stripeclient-cold.change.md b/.hark/changes/2026-07-01_jar_reduce-stripeclient-cold.change.md
new file mode 100644
index 000000000..f8939f187
--- /dev/null
+++ b/.hark/changes/2026-07-01_jar_reduce-stripeclient-cold.change.md
@@ -0,0 +1,7 @@
+---
+title: Reduce StripeClient() cold start latency for serverless environments
+pr_url: https://github.com/stripe/stripe-python/pull/1834
+released_in_version: 15.3.1
+---
+
+- Moves HTTP library imports to module load time to better accommodate AWS Lambda and other serverless environments that have separate Init phase and Invoke phase time budgets.
diff --git a/.hark/changes/2026-07-09_xavdid_remove-unused-retry.change.md b/.hark/changes/2026-07-09_xavdid_remove-unused-retry.change.md
new file mode 100644
index 000000000..5fb4b46d8
--- /dev/null
+++ b/.hark/changes/2026-07-09_xavdid_remove-unused-retry.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove unused Retry-After header support
+pr_url: https://github.com/stripe/stripe-python/pull/1843
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2026-07-10_xavdid_make-error-fields.change.md b/.hark/changes/2026-07-10_xavdid_make-error-fields.change.md
new file mode 100644
index 000000000..fb731e206
--- /dev/null
+++ b/.hark/changes/2026-07-10_xavdid_make-error-fields.change.md
@@ -0,0 +1,5 @@
+---
+title: Make Error fields generated
+pr_url: https://github.com/stripe/stripe-python/pull/1845
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2026-07-16_xavdid_replace-source-hash.change.md b/.hark/changes/2026-07-16_xavdid_replace-source-hash.change.md
new file mode 100644
index 000000000..044ce2aa9
--- /dev/null
+++ b/.hark/changes/2026-07-16_xavdid_replace-source-hash.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace source hash with Telemetry UUID
+pr_url: https://github.com/stripe/stripe-python/pull/1846
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2026-07-16_xavdid_use-ip-address.change.md b/.hark/changes/2026-07-16_xavdid_use-ip-address.change.md
new file mode 100644
index 000000000..85b46556c
--- /dev/null
+++ b/.hark/changes/2026-07-16_xavdid_use-ip-address.change.md
@@ -0,0 +1,5 @@
+---
+title: Use ip address directly instead of localhost to speed up windows tests
+pr_url: https://github.com/stripe/stripe-python/pull/1849
+released_in_version: 15.4.0
+---
diff --git a/.hark/changes/2026-07-24_jar_fix-intermittent-windows.change.md b/.hark/changes/2026-07-24_jar_fix-intermittent-windows.change.md
new file mode 100644
index 000000000..9f5f4dde7
--- /dev/null
+++ b/.hark/changes/2026-07-24_jar_fix-intermittent-windows.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix intermittent Windows test flake in async httpx integration tests
+pr_url: https://github.com/stripe/stripe-python/pull/1853
+released_in_version: 15.4.0
+---
diff --git a/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..147d20176
--- /dev/null
+++ b/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,52 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1857
+is_stripe_api_change: true
+released_in_version: 15.4.0
+---
+
+* Add support for new resource `financial_connections.Authorization`
+* Add support for `unreject` method on resource `Account`
+* Add support for `list` method on resource `PaymentRecord`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enums `Tax.Calculation.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type`, `Tax.Calculation.TaxBreakdown.TaxRateDetail.tax_type`, `Tax.CalculationLineItem.TaxBreakdown.TaxRateDetail.tax_type`, and `Tax.Transaction.ShippingCost.TaxBreakdown.TaxRateDetail.tax_type`
+* Add support for new value `chaps` on enums `FundingInstructions.BankTransfer.FinancialAddress.supported_networks` and `PaymentIntent.NextAction.DisplayBankTransferInstruction.FinancialAddress.supported_networks`
+* Add support for `smart_disputes_management` on `AccountSession.Component.DisputesList.Feature`, `AccountSession.Component.Payment.Feature`, `AccountSession.Component.PaymentDetail.Feature`, `AccountSession.Component.PaymentDispute.Feature`, `AccountSessionCreateParamsComponentDisputesListFeature`, `AccountSessionCreateParamsComponentPaymentDetailFeature`, `AccountSessionCreateParamsComponentPaymentDisputeFeature`, and `AccountSessionCreateParamsComponentPaymentFeature`
+* Add support for `administrative_address` and `principal_place_of_business` on `Account.Company`, `AccountCreateParamsCompany`, `AccountModifyParamsCompany`, and `TokenCreateParamsAccountCompany`
+* Add support for `sepa_debit_payments` on `AccountModifyParamsSetting`
+* Remove support for `proof_of_registration` on `AccountCreateParamsDocument`.  This field was limited-use and is being deprecated.
+* Add support for `payouts_action` on `AccountRejectParams`
+* Add support for new value `data_share_only` on enums `Charge.PaymentMethodDetail.Card.ThreeDSecure.result`, `PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure.result`, `PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure.result`, and `SetupAttempt.PaymentMethodDetail.Card.ThreeDSecure.result`
+* Add support for new values `bnp_paribas`, `citibank`, and `mbsb_bank` on enums `Charge.PaymentMethodDetail.Fpx.bank`, `ConfirmationToken.PaymentMethodPreview.Fpx.bank`, `PaymentAttemptRecord.PaymentMethodDetail.Fpx.bank`, `PaymentMethod.Fpx.bank`, and `PaymentRecord.PaymentMethodDetail.Fpx.bank`
+* Remove support for `dynamic_tax_rates` on `checkout.SessionCreateParamsLineItem`.  This field was limited-use and is being deprecated.
+* Add support for `setup_future_usage` on `Checkout.Session.PaymentMethodOption.Payco`, `Checkout.Session.PaymentMethodOption.SamsungPay`, `PaymentIntent.PaymentMethodOption.Payco`, `PaymentIntent.PaymentMethodOption.SamsungPay`, `PaymentIntentConfirmParamsPaymentMethodOptionPayco`, `PaymentIntentConfirmParamsPaymentMethodOptionSamsungPay`, `PaymentIntentCreateParamsPaymentMethodOptionPayco`, `PaymentIntentCreateParamsPaymentMethodOptionSamsungPay`, `PaymentIntentModifyParamsPaymentMethodOptionPayco`, `PaymentIntentModifyParamsPaymentMethodOptionSamsungPay`, `PaymentLinkModifyParamsPaymentIntentDatum`, `checkout.SessionCreateParamsPaymentMethodOptionPayco`, and `checkout.SessionCreateParamsPaymentMethodOptionSamsungPay`
+* Add support for new value `ic_nif` on enums `Checkout.Session.CustomerDetail.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetail.TaxId.type`, `Tax.Transaction.CustomerDetail.TaxId.type`, and `TaxId.type`
+* Add support for new values `bnp_paribas`, `citibank`, and `mbsb_bank` on enums `ConfirmationTokenCreateParamsPaymentMethodDatumFpx.bank`, `PaymentIntentConfirmParamsPaymentMethodDatumFpx.bank`, `PaymentIntentCreateParamsPaymentMethodDatumFpx.bank`, `PaymentIntentModifyParamsPaymentMethodDatumFpx.bank`, `PaymentMethodCreateParamsFpx.bank`, `SetupIntentConfirmParamsPaymentMethodDatumFpx.bank`, `SetupIntentCreateParamsPaymentMethodDatumFpx.bank`, and `SetupIntentModifyParamsPaymentMethodDatumFpx.bank`
+* Add support for new value `ic_nif` on enums `CustomerCreateParamsTaxIdDatum.type`, `CustomerCreateTaxIdParams.type`, `InvoiceCreatePreviewParamsCustomerDetailTaxId.type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParamsCustomerDetailTaxId.type`
+* Add support for `network` on `Dispute.PaymentMethodDetail.Card`
+* Add support for new values `financial_connections.account.expected_deactivation_date_updated`, `financial_connections.account.supported_payment_method_types_updated`, `financial_connections.account.upcoming_deactivation`, `financial_connections.authorization.expected_deactivation_date_updated`, and `financial_connections.authorization.upcoming_deactivation` on enum `Event.type`
+* Add support for `limits` and `manual_entry` on `FinancialConnections.Session` and `financial_connections.SessionCreateParams`
+* Add support for `require_payment_method_support` on `FinancialConnections.Session.Filter` and `financial_connections.SessionCreateParamsFilter`
+* Add support for `bank_account_token` on `FinancialConnections.Session`
+* Add support for new values `alipay` and `mb_way` on enums `Invoice.PaymentSetting.payment_method_types`, `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enums `InvoiceAddLinesParamsLineTaxAmountTaxRateDatum.tax_type`, `InvoiceLineItemModifyParamsTaxAmountTaxRateDatum.tax_type`, `InvoiceUpdateLinesParamsLineTaxAmountTaxRateDatum.tax_type`, `TaxRate.tax_type`, `TaxRateCreateParams.tax_type`, and `TaxRateModifyParams.tax_type`
+* Add support for `metadata` on `InvoiceCreatePreviewParamsSubscriptionDetail`
+* Add support for new value `stripe_internal_error` on enum `Issuing.Authorization.RequestHistory.reason`
+* Add support for `business_name` on `Issuing.Card.Shipping`, `issuing.CardCreateParamsShipping`, and `issuing.CardModifyParamsShipping`
+* Add support for new value `correos` on enum `Issuing.Card.Shipping.carrier`
+* Add support for `allowed_payment_method_types` on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentModifyParams`, `PaymentIntent`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentModifyParams`, and `SetupIntent`
+* Add support for `referrer` on `PaymentIntentConfirmParamsRadarOption` and `PaymentIntentCreateParamsRadarOption`
+* Add support for `consent_collection` and `shipping_options` on `PaymentLinkModifyParams`
+* Add support for `custom_fields`, `description`, and `footer` on `Quote.InvoiceSetting`, `QuoteCreateParamsInvoiceSetting`, `QuoteModifyParamsInvoiceSetting`, `SubscriptionSchedule.DefaultSetting.InvoiceSetting`, `SubscriptionSchedule.Phase.InvoiceSetting`, `SubscriptionScheduleCreateParamsDefaultSettingInvoiceSetting`, `SubscriptionScheduleCreateParamsPhaseInvoiceSetting`, `SubscriptionScheduleModifyParamsDefaultSettingInvoiceSetting`, and `SubscriptionScheduleModifyParamsPhaseInvoiceSetting`
+* Add support for `customer_account` and `customer` on `Refund`
+* Add support for `payment_method` on `Refund` and `Topup`
+* Add support for `trial` on `SubscriptionSchedule.Phase`
+* Add support for `mass_transit_parking_tax` and `parking_tax` on `Tax.Registration.CountryOption.Me` and `tax.RegistrationCreateParamsCountryOptionMe`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enum `tax.RegistrationCreateParamsCountryOptionMe.type`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enum `Tax.Registration.CountryOption.Me.type`
+* Add support for `initiated_by` and `payment_method_options` on `Topup`
+* Add support for new values `financial_connections.account.expected_deactivation_date_updated`, `financial_connections.account.supported_payment_method_types_updated`, `financial_connections.account.upcoming_deactivation`, `financial_connections.authorization.expected_deactivation_date_updated`, and `financial_connections.authorization.upcoming_deactivation` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointModifyParams.enabled_events`
+* Add support for new value `2026-07-29.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `additional_addresses` on `V2.Core.Account.Identity.BusinessDetail`, `v2.core.AccountCreateParamsIdentityBusinessDetail`, `v2.core.AccountModifyParamsIdentityBusinessDetail`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetail`
+* Add support for snapshot events `financial_connections.account.expected_deactivation_date_updated`, `financial_connections.account.supported_payment_method_types_updated`, and `financial_connections.account.upcoming_deactivation` with resource `financial_connections.Account`
+* Add support for snapshot events `financial_connections.authorization.expected_deactivation_date_updated` and `financial_connections.authorization.upcoming_deactivation` with resource `financial_connections.Authorization`
+* Enum type annotations for non-exhaustive ("open") enums are now typed as `Union[Literal[...], str]` instead of plain `Literal[...]`. Many Stripe enums are open, meaning new values may appear in new versions of the API. This change ensures these fields have the correct type for both the values known at SDK release time and other values that may be added later. Refer to the [API Reference](https://docs.stripe.com) for the latest set of allowed values.
diff --git a/.hark/changes/2026-08-03_xavdid_add-stripe-majorapivers.change.md b/.hark/changes/2026-08-03_xavdid_add-stripe-majorapivers.change.md
new file mode 100644
index 000000000..df3ed797d
--- /dev/null
+++ b/.hark/changes/2026-08-03_xavdid_add-stripe-majorapivers.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `stripe.major_api_version` constant
+pr_url: https://github.com/stripe/stripe-python/pull/1863
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2026-08-06_xavdid_add-adjust-event.change.md b/.hark/changes/2026-08-06_xavdid_add-adjust-event.change.md
new file mode 100644
index 000000000..6ece5b15f
--- /dev/null
+++ b/.hark/changes/2026-08-06_xavdid_add-adjust-event.change.md
@@ -0,0 +1,11 @@
+---
+title: add/adjust event parsing helpers
+pr_url: https://github.com/stripe/stripe-python/pull/1855
+released_in_version: 15.5.0
+---
+
+- Added methods that return their respective `Event`/`EventNotification` class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from [AWS EventBridge](https://docs.stripe.com/event-destinations/eventbridge) and [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid) natively.
+  - `Webhook.construct_event_without_verification(payload)`
+  - `StripeClient.construct_event_without_verification(payload)`
+  - `StripeClient.parse_event_notification_without_verification(payload)`
+- Added `WebhookSignature.generate_signature_header(payload, secret, timestamp=None)`, which computes a full `Stripe-Signature` header for the given payload. Useful for unit tests!
diff --git a/.hark/changes/2026-08-07_johno_emit-claude-code.change.md b/.hark/changes/2026-08-07_johno_emit-claude-code.change.md
new file mode 100644
index 000000000..8cef58f27
--- /dev/null
+++ b/.hark/changes/2026-08-07_johno_emit-claude-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Emit Claude Code plugin hint at module load time
+pr_url: https://github.com/stripe/stripe-python/pull/1867
+released_in_version: 15.5.0
+---
+
+- Emits new Claude Code plugin hint when `CLAUDECODE` or `CLAUDE_CODE_CHILD_SESSION` environment variables are detected.
diff --git a/.hark/changes/2026-08-07_xavdid_surface-object-property.change.md b/.hark/changes/2026-08-07_xavdid_surface-object-property.change.md
new file mode 100644
index 000000000..acb211d01
--- /dev/null
+++ b/.hark/changes/2026-08-07_xavdid_surface-object-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Surface `object` property on `EventNotification`
+pr_url: https://github.com/stripe/stripe-python/pull/1869
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2026-08-10_jar_add-async-iteration.change.md b/.hark/changes/2026-08-10_jar_add-async-iteration.change.md
new file mode 100644
index 000000000..28439b470
--- /dev/null
+++ b/.hark/changes/2026-08-10_jar_add-async-iteration.change.md
@@ -0,0 +1,7 @@
+---
+title: Add async iteration to v2 list auto-pagination
+pr_url: https://github.com/stripe/stripe-python/pull/1874
+released_in_version: 15.5.0
+---
+
+- Adds `async for` support to v2 `ListObject.auto_paging_iter()`.
diff --git a/.hark/changes/2026-08-18_xavdid_better-document-stripeobject.change.md b/.hark/changes/2026-08-18_xavdid_better-document-stripeobject.change.md
new file mode 100644
index 000000000..9a26dfad5
--- /dev/null
+++ b/.hark/changes/2026-08-18_xavdid_better-document-stripeobject.change.md
@@ -0,0 +1,5 @@
+---
+title: better document `StripeObject`'s `to_dict` behavior
+pr_url: https://github.com/stripe/stripe-python/pull/1879
+released_in_version: 15.5.1
+---
diff --git a/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md b/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md
new file mode 100644
index 000000000..0d8037b28
--- /dev/null
+++ b/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md
@@ -0,0 +1,11 @@
+---
+title: Add new `EventNotificationHandler` class for better thin event management
+pr_url: https://github.com/stripe/stripe-python/pull/1881
+released_in_version: 15.6.0
+---
+
+- We've been putting a lot of time into rethinking the event handling experience in the SDKs. This new class is the culmination [of that effort](https://stripe.dev/blog/event-notification-handlers-thin-events).
+- They're designed for a tight coupling with both `StripeClient` and the fully-typed nature of [thin events](https://docs.stripe.com/event-destinations#thin-events). This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.
+- Now that we've released [thin event notifications for v1 objects](https://docs.stripe.com/changelog#2026-08-26.dahlia), these new handlers are our recommended path for all integrations using thin event notifications.
+- See more detailed docs here: https://docs.stripe.com/webhooks/event-notification-handlers
+- As part of this work, we've widened some of the types our webhook-related methods take so they play more nicely with the types commonly returned by popular web frameworks ([#1888](https://github.com/stripe/stripe-python/pull/1888))
diff --git a/.hark/changes/2026-08-26_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-08-26_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0d73f02b2
--- /dev/null
+++ b/.hark/changes/2026-08-26_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,30 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-python/pull/1876
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 15.6.0
+---
+
+* Add support for new resource `billing.FeedbackOption`
+* Add support for `create`, `deactivate`, `list`, `modify`, and `retrieve` methods on resource `billing.FeedbackOption`
+* Add support for `payment_method_settings` on `AccountSession.Component` and `AccountSessionCreateParamsComponent`
+* Add support for `feedback_options` on `BillingPortal.Configuration.Feature.SubscriptionCancel.CancellationReason`, `billing_portal.ConfigurationCreateParamsFeatureSubscriptionCancelCancellationReason`, and `billing_portal.ConfigurationModifyParamsFeatureSubscriptionCancelCancellationReason`
+* Add support for new value `customer_update` on enums `BillingPortal.Session.Flow.type` and `billing_portal.SessionCreateParamsFlowDatum.type`
+* Add support for `customer_update` on `BillingPortal.Session.Flow`
+* Add support for `funding_source_group` on `Charge.PaymentMethodDetail.Card.Wallet.Link` and `Charge.PaymentMethodDetail.Link`
+* Add support for `funding_types_blocked` on `Checkout.Session.PaymentMethodOption.Card.Restriction` and `checkout.SessionCreateParamsPaymentMethodOptionCardRestriction`
+* Add support for `metadata` on `ConfirmationToken`
+* Add support for `active_entitlements` and `customer_portal` on `CustomerSession.Component` and `CustomerSessionCreateParamsComponent`
+* Add support for `country` on `FinancialConnections.Session.Filter`
+* Add support for `frozen_fields` on `InvoiceItem`
+* Add support for `billie` on `Invoice.PaymentSetting.PaymentMethodOption`, `InvoiceCreateParamsPaymentSettingPaymentMethodOption`, `InvoiceModifyParamsPaymentSettingPaymentMethodOption`, `Subscription.PaymentSetting.PaymentMethodOption`, `SubscriptionCreateParamsPaymentSettingPaymentMethodOption`, and `SubscriptionModifyParamsPaymentSettingPaymentMethodOption`
+* Add support for new value `billie` on enums `Invoice.PaymentSetting.payment_method_types`, `InvoiceCreateParamsPaymentSetting.payment_method_types`, `InvoiceModifyParamsPaymentSetting.payment_method_types`, `Subscription.PaymentSetting.payment_method_types`, `SubscriptionCreateParamsPaymentSetting.payment_method_types`, and `SubscriptionModifyParamsPaymentSetting.payment_method_types`
+* ⚠️ Remove support for `cryptogram` on `PaymentAttemptRecord.PaymentMethodDetail.Card.ThreeDSecure` and `PaymentRecord.PaymentMethodDetail.Card.ThreeDSecure`
+* Add support for new value `touch_n_go` on enums `PaymentIntent.allowed_payment_method_types`, `PaymentIntentConfirmParams.allowed_payment_method_types`, `PaymentIntentCreateParams.allowed_payment_method_types`, `PaymentIntentModifyParams.allowed_payment_method_types`, `SetupIntent.allowed_payment_method_types`, `SetupIntentConfirmParams.allowed_payment_method_types`, `SetupIntentCreateParams.allowed_payment_method_types`, and `SetupIntentModifyParams.allowed_payment_method_types`
+* Change `PaymentIntent.allowed_payment_method_types` and `SetupIntent.allowed_payment_method_types` to be required
+* Add support for `application_fee_amount`, `application_fee_percent`, `on_behalf_of`, and `transfer_data` on `PaymentLinkModifyParams`
+* Add support for `feedback_option` on `Subscription.CancellationDetail`, `SubscriptionCancelParamsCancellationDetail`, and `SubscriptionModifyParamsCancellationDetail`
+* Add support for `igic` on `Tax.Registration.CountryOption.At`, `Tax.Registration.CountryOption.Be`, `Tax.Registration.CountryOption.Bg`, `Tax.Registration.CountryOption.Cy`, `Tax.Registration.CountryOption.Cz`, `Tax.Registration.CountryOption.De`, `Tax.Registration.CountryOption.Dk`, `Tax.Registration.CountryOption.E`, `Tax.Registration.CountryOption.Ee`, `Tax.Registration.CountryOption.Fi`, `Tax.Registration.CountryOption.Fr`, `Tax.Registration.CountryOption.Gr`, `Tax.Registration.CountryOption.Hr`, `Tax.Registration.CountryOption.Hu`, `Tax.Registration.CountryOption.Ie`, `Tax.Registration.CountryOption.It`, `Tax.Registration.CountryOption.Lt`, `Tax.Registration.CountryOption.Lu`, `Tax.Registration.CountryOption.Lv`, `Tax.Registration.CountryOption.Mt`, `Tax.Registration.CountryOption.Nl`, `Tax.Registration.CountryOption.Pl`, `Tax.Registration.CountryOption.Pt`, `Tax.Registration.CountryOption.Ro`, `Tax.Registration.CountryOption.Se`, `Tax.Registration.CountryOption.Si`, `Tax.Registration.CountryOption.Sk`, `tax.RegistrationCreateParamsCountryOptionAt`, `tax.RegistrationCreateParamsCountryOptionBe`, `tax.RegistrationCreateParamsCountryOptionBg`, `tax.RegistrationCreateParamsCountryOptionCy`, `tax.RegistrationCreateParamsCountryOptionCz`, `tax.RegistrationCreateParamsCountryOptionDe`, `tax.RegistrationCreateParamsCountryOptionDk`, `tax.RegistrationCreateParamsCountryOptionE`, `tax.RegistrationCreateParamsCountryOptionEe`, `tax.RegistrationCreateParamsCountryOptionFi`, `tax.RegistrationCreateParamsCountryOptionFr`, `tax.RegistrationCreateParamsCountryOptionGr`, `tax.RegistrationCreateParamsCountryOptionHr`, `tax.RegistrationCreateParamsCountryOptionHu`, `tax.RegistrationCreateParamsCountryOptionIe`, `tax.RegistrationCreateParamsCountryOptionIt`, `tax.RegistrationCreateParamsCountryOptionLt`, `tax.RegistrationCreateParamsCountryOptionLu`, `tax.RegistrationCreateParamsCountryOptionLv`, `tax.RegistrationCreateParamsCountryOptionMt`, `tax.RegistrationCreateParamsCountryOptionNl`, `tax.RegistrationCreateParamsCountryOptionPl`, `tax.RegistrationCreateParamsCountryOptionPt`, `tax.RegistrationCreateParamsCountryOptionRo`, `tax.RegistrationCreateParamsCountryOptionSe`, `tax.RegistrationCreateParamsCountryOptionSi`, and `tax.RegistrationCreateParamsCountryOptionSk`
+* Add support for new value `2026-08-26.dahlia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for error codes `authentication_failure`, `capability_not_active`, `expired_payment_method`, `incorrect_postal_code`, `invalid_canceled_subscription_fields`, and `payment_method_restricted` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, `StripeError`, and `Terminal.Reader.Action.ApiError`
diff --git a/.hark/changes/2026-08-28_jar_dispatch-discriminate-union.change.md b/.hark/changes/2026-08-28_jar_dispatch-discriminate-union.change.md
new file mode 100644
index 000000000..5f7965574
--- /dev/null
+++ b/.hark/changes/2026-08-28_jar_dispatch-discriminate-union.change.md
@@ -0,0 +1,5 @@
+---
+title: Dispatch discriminated union fields to their variant class
+pr_url: https://github.com/stripe/stripe-python/pull/1860
+released_in_version: 15.6.1
+---
diff --git a/.hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md b/.hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md
new file mode 100644
index 000000000..f7bd1f564
--- /dev/null
+++ b/.hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md
@@ -0,0 +1,5 @@
+---
+title: Harden API requestor code against malicious URLs
+pr_url: https://github.com/stripe/stripe-python/pull/1896
+released_in_version: 15.6.1
+---
diff --git a/.hark/changes/2026-08-31_xavdid_use-cryptographi-secure.change.md b/.hark/changes/2026-08-31_xavdid_use-cryptographi-secure.change.md
new file mode 100644
index 000000000..7cea8916e
--- /dev/null
+++ b/.hark/changes/2026-08-31_xavdid_use-cryptographi-secure.change.md
@@ -0,0 +1,5 @@
+---
+title: Use cryptographically secure boundaries for multipart file uploads
+pr_url: https://github.com/stripe/stripe-python/pull/1898
+released_in_version: 15.6.1
+---
diff --git a/.hark/intros/intro-13.0.0.md b/.hark/intros/intro-13.0.0.md
new file mode 100644
index 000000000..caec7ed1d
--- /dev/null
+++ b/.hark/intros/intro-13.0.0.md
@@ -0,0 +1 @@
+This release contains breaking changes (prefixed with ⚠️ below)
diff --git a/.hark/intros/intro-15.0.0.md b/.hark/intros/intro-15.0.0.md
new file mode 100644
index 000000000..15d781959
--- /dev/null
+++ b/.hark/intros/intro-15.0.0.md
@@ -0,0 +1,3 @@
+This release contains breaking changes (prefixed with ⚠️ below). There's also a [detailed migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v15) to simplify your upgrade process.
+
+Please review details for the breaking changes and alternatives in the [Stripe API changelog](https://docs.stripe.com/changelog/dahlia) before upgrading.
diff --git a/.hark/intros/intro-2.0.0.md b/.hark/intros/intro-2.0.0.md
new file mode 100644
index 000000000..a06109bbe
--- /dev/null
+++ b/.hark/intros/intro-2.0.0.md
@@ -0,0 +1,5 @@
+Major version release. List of backwards incompatible changes to watch out for:
+
+For more information, check out the [migration guide for v2](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v2)
+
+Pull requests included in this release:
diff --git a/.hark/intros/intro-2.29.3.md b/.hark/intros/intro-2.29.3.md
new file mode 100644
index 000000000..4fa52fff8
--- /dev/null
+++ b/.hark/intros/intro-2.29.3.md
@@ -0,0 +1 @@
+Version 2.29.2 was non-functional due to a bugged `version.py` file. This release is identical to 2.29.2 save for the version number.
diff --git a/.hark/intros/intro-4.0.0.md b/.hark/intros/intro-4.0.0.md
new file mode 100644
index 000000000..7f2fa6d44
--- /dev/null
+++ b/.hark/intros/intro-4.0.0.md
@@ -0,0 +1,3 @@
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v4. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
+
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-5.0.0.md b/.hark/intros/intro-5.0.0.md
new file mode 100644
index 000000000..7c0d7a180
--- /dev/null
+++ b/.hark/intros/intro-5.0.0.md
@@ -0,0 +1,3 @@
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
+
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-6.0.0.md b/.hark/intros/intro-6.0.0.md
new file mode 100644
index 000000000..9c37c78db
--- /dev/null
+++ b/.hark/intros/intro-6.0.0.md
@@ -0,0 +1 @@
+**⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
diff --git a/.hark/releases.json b/.hark/releases.json
new file mode 100644
index 000000000..5ccf14f4a
--- /dev/null
+++ b/.hark/releases.json
@@ -0,0 +1,1977 @@
+{
+  "metadata": {
+    "language": "python",
+    "channel": "ga"
+  },
+  "releases": [
+    {
+      "version": "15.6.1",
+      "released_on": "2026-09-01",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.6.0",
+      "released_on": "2026-08-26",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.5.1",
+      "released_on": "2026-08-18",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.5.0",
+      "released_on": "2026-08-10",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.4.0",
+      "released_on": "2026-07-29",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.3.1",
+      "released_on": "2026-07-15",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.3.0",
+      "released_on": "2026-06-24",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.2.1",
+      "released_on": "2026-06-12",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.2.0",
+      "released_on": "2026-05-27",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.1.0",
+      "released_on": "2026-04-23",
+      "pinned_api_version": "2026-04-22.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.0.1",
+      "released_on": "2026-04-01",
+      "pinned_api_version": "2026-03-25.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "15.0.0",
+      "released_on": "2026-03-25",
+      "pinned_api_version": "2026-03-25.dahlia",
+      "minimum_runtime_version": "3.9"
+    },
+    {
+      "version": "14.4.1",
+      "released_on": "2026-03-06",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.4.0",
+      "released_on": "2026-02-25",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.3.0",
+      "released_on": "2026-01-28",
+      "pinned_api_version": "2026-01-28.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.2.0",
+      "released_on": "2026-01-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.1.0",
+      "released_on": "2025-12-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.0.1",
+      "released_on": "2025-11-21",
+      "pinned_api_version": "2025-11-17.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "14.0.0",
+      "released_on": "2025-11-18",
+      "pinned_api_version": "2025-11-17.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.2.0",
+      "released_on": "2025-11-05",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.1.2",
+      "released_on": "2025-11-04",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.1.1",
+      "released_on": "2025-10-31",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.1.0",
+      "released_on": "2025-10-29",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.0.1",
+      "released_on": "2025-10-03",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "13.0.0",
+      "released_on": "2025-09-30",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "3.7"
+    },
+    {
+      "version": "12.5.1",
+      "released_on": "2025-09-05",
+      "pinned_api_version": "2025-08-27.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.5.0",
+      "released_on": "2025-08-27",
+      "pinned_api_version": "2025-08-27.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.4.0",
+      "released_on": "2025-07-30",
+      "pinned_api_version": "2025-07-30.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.3.0",
+      "released_on": "2025-07-01",
+      "pinned_api_version": "2025-06-30.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.2.0",
+      "released_on": "2025-05-29",
+      "pinned_api_version": "2025-05-28.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.1.0",
+      "released_on": "2025-04-30",
+      "pinned_api_version": "2025-04-30.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.0.1",
+      "released_on": "2025-04-21",
+      "pinned_api_version": "2025-03-31.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "12.0.0",
+      "released_on": "2025-04-01",
+      "pinned_api_version": "2025-03-31.basil",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.6.0",
+      "released_on": "2025-02-24",
+      "pinned_api_version": "2025-02-24.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.5.0",
+      "released_on": "2025-01-27",
+      "pinned_api_version": "2025-01-27.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.4.1",
+      "released_on": "2024-12-19",
+      "pinned_api_version": "2024-12-18.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.4.0",
+      "released_on": "2024-12-18",
+      "pinned_api_version": "2024-12-18.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.3.0",
+      "released_on": "2024-11-20",
+      "pinned_api_version": "2024-11-20.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.2.0",
+      "released_on": "2024-10-29",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.1.1",
+      "released_on": "2024-10-18",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.1.0",
+      "released_on": "2024-10-03",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "11.0.0",
+      "released_on": "2024-10-01",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.12.0",
+      "released_on": "2024-09-18",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.11.0",
+      "released_on": "2024-09-12",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.10.0",
+      "released_on": "2024-09-05",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.9.0",
+      "released_on": "2024-08-29",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.8.0",
+      "released_on": "2024-08-15",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.7.0",
+      "released_on": "2024-08-08",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.6.0",
+      "released_on": "2024-08-01",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.5.0",
+      "released_on": "2024-07-25",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.4.0",
+      "released_on": "2024-07-18",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.3.0",
+      "released_on": "2024-07-11",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.2.0",
+      "released_on": "2024-07-05",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.1.0",
+      "released_on": "2024-06-27",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "10.0.0",
+      "released_on": "2024-06-24",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.12.0",
+      "released_on": "2024-06-17",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.11.0",
+      "released_on": "2024-06-13",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.10.0",
+      "released_on": "2024-06-06",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.9.0",
+      "released_on": "2024-05-30",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.8.0",
+      "released_on": "2024-05-23",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.7.0",
+      "released_on": "2024-05-16",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.6.0",
+      "released_on": "2024-05-09",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.5.0",
+      "released_on": "2024-05-02",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.4.0",
+      "released_on": "2024-04-25",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.3.0",
+      "released_on": "2024-04-18",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.2.0",
+      "released_on": "2024-04-16",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.1.0",
+      "released_on": "2024-04-11",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "9.0.0",
+      "released_on": "2024-04-10",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.11.0",
+      "released_on": "2024-04-09",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.10.0",
+      "released_on": "2024-04-04",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.9.0",
+      "released_on": "2024-03-28",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.8.0",
+      "released_on": "2024-03-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.7.0",
+      "released_on": "2024-03-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.6.0",
+      "released_on": "2024-03-07",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.5.0",
+      "released_on": "2024-02-29",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.4.0",
+      "released_on": "2024-02-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.3.0",
+      "released_on": "2024-02-15",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.2.0",
+      "released_on": "2024-02-08",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.1.0",
+      "released_on": "2024-02-01",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "8.0.0",
+      "released_on": "2024-01-25",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.14.0",
+      "released_on": "2024-01-25",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.13.0",
+      "released_on": "2024-01-18",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.12.0",
+      "released_on": "2024-01-12",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.11.0",
+      "released_on": "2024-01-04",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.10.0",
+      "released_on": "2023-12-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.9.0",
+      "released_on": "2023-12-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.8.2",
+      "released_on": "2023-12-11",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.8.1",
+      "released_on": "2023-12-08",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.8.0",
+      "released_on": "2023-12-07",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.7.0",
+      "released_on": "2023-11-30",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.6.0",
+      "released_on": "2023-11-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.5.0",
+      "released_on": "2023-11-16",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.4.0",
+      "released_on": "2023-11-09",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.3.0",
+      "released_on": "2023-11-02",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.2.0",
+      "released_on": "2023-10-31",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.1.0",
+      "released_on": "2023-10-26",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "7.0.0",
+      "released_on": "2023-10-16",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.7.0",
+      "released_on": "2023-10-05",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.6.0",
+      "released_on": "2023-09-21",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.5.0",
+      "released_on": "2023-09-14",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.4.0",
+      "released_on": "2023-09-07",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.3.0",
+      "released_on": "2023-09-05",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.2.0",
+      "released_on": "2023-08-31",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.1.0",
+      "released_on": "2023-08-24",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "6.0.0",
+      "released_on": "2023-08-16",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "3.6"
+    },
+    {
+      "version": "5.5.0",
+      "released_on": "2023-07-13",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.4.0",
+      "released_on": "2023-03-30",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.3.0",
+      "released_on": "2023-03-23",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.2.0",
+      "released_on": "2023-02-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.1.1",
+      "released_on": "2023-02-06",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.1.0",
+      "released_on": "2023-02-02",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "5.0.0",
+      "released_on": "2022-11-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "4.2.0",
+      "released_on": "2022-09-23",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "4.1.0",
+      "released_on": "2022-08-19",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "4.0.2",
+      "released_on": "2022-08-03",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "4.0.1",
+      "released_on": "2022-08-02",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "4.0.0",
+      "released_on": "2022-08-02",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.5.0",
+      "released_on": "2022-06-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.4.0",
+      "released_on": "2022-06-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.3.0",
+      "released_on": "2022-06-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.2.0",
+      "released_on": "2022-05-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.1.0",
+      "released_on": "2022-05-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "3.0.0",
+      "released_on": "2022-05-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.76.0",
+      "released_on": "2022-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.75.0",
+      "released_on": "2022-05-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.74.0",
+      "released_on": "2022-04-21",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.73.0",
+      "released_on": "2022-04-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.72.0",
+      "released_on": "2022-04-13",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.71.0",
+      "released_on": "2022-04-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.70.0",
+      "released_on": "2022-03-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.69.0",
+      "released_on": "2022-03-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.68.0",
+      "released_on": "2022-03-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.67.0",
+      "released_on": "2022-03-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.66.0",
+      "released_on": "2022-02-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.65.0",
+      "released_on": "2022-01-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.64.0",
+      "released_on": "2021-12-21",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.63.0",
+      "released_on": "2021-11-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.62.0",
+      "released_on": "2021-11-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.61.0",
+      "released_on": "2021-10-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.60.0",
+      "released_on": "2021-07-14",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.59.0",
+      "released_on": "2021-07-09",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.58.0",
+      "released_on": "2021-06-04",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.57.0",
+      "released_on": "2021-05-19",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.56.0",
+      "released_on": "2021-02-22",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.55.2",
+      "released_on": "2021-02-05",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.55.1",
+      "released_on": "2020-12-01",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.55.0",
+      "released_on": "2020-10-14",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.54.0",
+      "released_on": "2020-09-29",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.53.0",
+      "released_on": "2020-09-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.52.0",
+      "released_on": "2020-09-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.51.0",
+      "released_on": "2020-09-02",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.50.0",
+      "released_on": "2020-08-05",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.49.0",
+      "released_on": "2020-07-17",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.48.0",
+      "released_on": "2020-05-11",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.47.0",
+      "released_on": "2020-04-29",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.46.0",
+      "released_on": "2020-04-22",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.45.0",
+      "released_on": "2020-04-06",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.44.0",
+      "released_on": "2020-03-23",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.43.0",
+      "released_on": "2020-02-26",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.42.0",
+      "released_on": "2020-01-14",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.41.1",
+      "released_on": "2019-12-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.41.0",
+      "released_on": "2019-11-26",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.40.0",
+      "released_on": "2019-11-08",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.39.0",
+      "released_on": "2019-11-06",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.38.0",
+      "released_on": "2019-10-29",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.37.2",
+      "released_on": "2019-10-04",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.37.1",
+      "released_on": "2019-09-26",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.37.0",
+      "released_on": "2019-09-26",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.36.2",
+      "released_on": "2019-09-12",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.36.1",
+      "released_on": "2019-09-11",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.36.0",
+      "released_on": "2019-09-10",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.35.1",
+      "released_on": "2019-08-20",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.35.0",
+      "released_on": "2019-08-12",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.34.0",
+      "released_on": "2019-08-09",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.33.2",
+      "released_on": "2019-08-06",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.33.1",
+      "released_on": "2019-08-06",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.33.0",
+      "released_on": "2019-07-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.32.1",
+      "released_on": "2019-07-08",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.32.0",
+      "released_on": "2019-06-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.31.0",
+      "released_on": "2019-06-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.30.1",
+      "released_on": "2019-06-20",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.30.0",
+      "released_on": "2019-06-17",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.29.4",
+      "released_on": "2019-06-03",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.29.3",
+      "released_on": "2019-05-31",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.29.2",
+      "released_on": "2019-05-31",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.29.1",
+      "released_on": "2019-05-31",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.29.0",
+      "released_on": "2019-05-23",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.28.2",
+      "released_on": "2019-05-23",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.28.1",
+      "released_on": "2019-05-20",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.28.0",
+      "released_on": "2019-05-14",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.27.0",
+      "released_on": "2019-04-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.26.0",
+      "released_on": "2019-04-22",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.25.0",
+      "released_on": "2019-04-18",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.24.1",
+      "released_on": "2019-04-08",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.24.0",
+      "released_on": "2019-04-03",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.23.0",
+      "released_on": "2019-03-18",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.22.0",
+      "released_on": "2019-03-14",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.21.0",
+      "released_on": "2019-02-12",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.20.3",
+      "released_on": "2019-01-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.20.2",
+      "released_on": "2019-01-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.20.1",
+      "released_on": "2019-01-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.20.0",
+      "released_on": "2019-01-29",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.19.0",
+      "released_on": "2019-01-23",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.18.1",
+      "released_on": "2019-01-21",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.18.0",
+      "released_on": "2019-01-15",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.17.0",
+      "released_on": "2018-12-21",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.16.0",
+      "released_on": "2018-12-10",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.15.0",
+      "released_on": "2018-11-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.14.0",
+      "released_on": "2018-11-28",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.13.0",
+      "released_on": "2018-11-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.12.1",
+      "released_on": "2018-11-22",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.12.0",
+      "released_on": "2018-11-08",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.11.1",
+      "released_on": "2018-11-08",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.11.0",
+      "released_on": "2018-10-30",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.10.1",
+      "released_on": "2018-10-02",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.10.0",
+      "released_on": "2018-09-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.9.0",
+      "released_on": "2018-09-24",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.8.1",
+      "released_on": "2018-09-13",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.8.0",
+      "released_on": "2018-09-10",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.7.0",
+      "released_on": "2018-09-05",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.6.0",
+      "released_on": "2018-08-23",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.5.0",
+      "released_on": "2018-08-16",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.4.0",
+      "released_on": "2018-08-03",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.3.0",
+      "released_on": "2018-07-27",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.2.0",
+      "released_on": "2018-07-26",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.1.0",
+      "released_on": "2018-07-25",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.0.3",
+      "released_on": "2018-07-19",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.0.2",
+      "released_on": "2018-07-18",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.0.1",
+      "released_on": "2018-07-10",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "2.0.0",
+      "released_on": "2018-07-10",
+      "minimum_runtime_version": "2.7"
+    },
+    {
+      "version": "1.84.2",
+      "released_on": "2018-07-06"
+    },
+    {
+      "version": "1.84.1",
+      "released_on": "2018-07-04"
+    },
+    {
+      "version": "1.84.0",
+      "released_on": "2018-06-29"
+    },
+    {
+      "version": "1.83.0",
+      "released_on": "2018-06-28"
+    },
+    {
+      "version": "1.82.2",
+      "released_on": "2018-06-19"
+    },
+    {
+      "version": "1.82.1",
+      "released_on": "2018-05-14"
+    },
+    {
+      "version": "1.82.0",
+      "released_on": "2018-05-13"
+    },
+    {
+      "version": "1.81.0",
+      "released_on": "2018-05-10"
+    },
+    {
+      "version": "1.80.0",
+      "released_on": "2018-04-24"
+    },
+    {
+      "version": "1.79.1",
+      "released_on": "2018-02-27"
+    },
+    {
+      "version": "1.79.0",
+      "released_on": "2018-02-23"
+    },
+    {
+      "version": "1.78.0",
+      "released_on": "2018-02-21"
+    },
+    {
+      "version": "1.77.2",
+      "released_on": "2018-02-08"
+    },
+    {
+      "version": "1.77.1",
+      "released_on": "2018-01-12"
+    },
+    {
+      "version": "1.77.0",
+      "released_on": "2017-12-21"
+    },
+    {
+      "version": "1.76.0",
+      "released_on": "2017-12-21"
+    },
+    {
+      "version": "1.75.3",
+      "released_on": "2017-12-05"
+    },
+    {
+      "version": "1.75.2",
+      "released_on": "2017-12-05"
+    },
+    {
+      "version": "1.75.1",
+      "released_on": "2017-11-29"
+    },
+    {
+      "version": "1.75.0",
+      "released_on": "2017-11-08"
+    },
+    {
+      "version": "1.74.0",
+      "released_on": "2017-11-07"
+    },
+    {
+      "version": "1.73.0",
+      "released_on": "2017-11-02"
+    },
+    {
+      "version": "1.72.0",
+      "released_on": "2017-10-31"
+    },
+    {
+      "version": "1.71.2",
+      "released_on": "2017-10-31"
+    },
+    {
+      "version": "1.71.1",
+      "released_on": "2017-10-27"
+    },
+    {
+      "version": "1.71.0",
+      "released_on": "2017-10-26"
+    },
+    {
+      "version": "1.70.0",
+      "released_on": "2017-10-23"
+    },
+    {
+      "version": "1.69.0",
+      "released_on": "2017-10-20"
+    },
+    {
+      "version": "1.68.0",
+      "released_on": "2017-10-19"
+    },
+    {
+      "version": "1.67.0",
+      "released_on": "2017-10-11"
+    },
+    {
+      "version": "1.66.0",
+      "released_on": "2017-09-29"
+    },
+    {
+      "version": "1.65.1",
+      "released_on": "2017-09-21"
+    },
+    {
+      "version": "1.65.0",
+      "released_on": "2017-09-07"
+    },
+    {
+      "version": "1.64.0",
+      "released_on": "2017-09-01"
+    },
+    {
+      "version": "1.63.1",
+      "released_on": "2017-09-01"
+    },
+    {
+      "version": "1.63.0",
+      "released_on": "2017-08-29"
+    },
+    {
+      "version": "1.62.1",
+      "released_on": "2017-08-07"
+    },
+    {
+      "version": "1.62.0",
+      "released_on": "2017-06-27"
+    },
+    {
+      "version": "1.61.0",
+      "released_on": "2017-06-24"
+    },
+    {
+      "version": "1.60.0",
+      "released_on": "2017-06-19"
+    },
+    {
+      "version": "1.59.0",
+      "released_on": "2017-06-07"
+    },
+    {
+      "version": "1.58.0",
+      "released_on": "2017-06-02"
+    },
+    {
+      "version": "1.57.1",
+      "released_on": "2017-05-31"
+    },
+    {
+      "version": "1.57.0",
+      "released_on": "2017-05-26"
+    },
+    {
+      "version": "1.56.0",
+      "released_on": "2017-05-25"
+    },
+    {
+      "version": "1.55.2",
+      "released_on": "2017-05-11"
+    },
+    {
+      "version": "1.55.1",
+      "released_on": "2017-05-10"
+    },
+    {
+      "version": "1.55.0",
+      "released_on": "2017-04-28"
+    },
+    {
+      "version": "1.54.0",
+      "released_on": "2017-04-28"
+    },
+    {
+      "version": "1.53.0",
+      "released_on": "2017-04-06"
+    },
+    {
+      "version": "1.52.0",
+      "released_on": "2017-04-06"
+    },
+    {
+      "version": "1.51.0",
+      "released_on": "2017-03-20"
+    },
+    {
+      "version": "1.50.0",
+      "released_on": "2017-03-17"
+    },
+    {
+      "version": "1.49.0",
+      "released_on": "2017-03-13"
+    },
+    {
+      "version": "1.48.1",
+      "released_on": "2017-02-21"
+    },
+    {
+      "version": "1.48.0",
+      "released_on": "2017-02-21"
+    },
+    {
+      "version": "1.47.0",
+      "released_on": "2017-01-18"
+    },
+    {
+      "version": "1.46.0",
+      "released_on": "2017-01-06"
+    },
+    {
+      "version": "1.45.0",
+      "released_on": "2017-01-06"
+    },
+    {
+      "version": "1.44.0",
+      "released_on": "2016-12-16"
+    },
+    {
+      "version": "1.43.0",
+      "released_on": "2016-11-30"
+    },
+    {
+      "version": "1.42.0",
+      "released_on": "2016-11-21"
+    },
+    {
+      "version": "1.41.1",
+      "released_on": "2016-10-26"
+    },
+    {
+      "version": "1.41.0",
+      "released_on": "2016-10-12"
+    },
+    {
+      "version": "1.40.1",
+      "released_on": "2016-10-10"
+    },
+    {
+      "version": "1.40.0",
+      "released_on": "2016-10-07"
+    },
+    {
+      "version": "1.39.0",
+      "released_on": "2016-10-06"
+    },
+    {
+      "version": "1.38.0",
+      "released_on": "2016-09-15"
+    },
+    {
+      "version": "1.37.0",
+      "released_on": "2016-07-12"
+    },
+    {
+      "version": "1.36.0",
+      "released_on": "2016-06-29"
+    },
+    {
+      "version": "1.35.0",
+      "released_on": "2016-05-24"
+    },
+    {
+      "version": "1.34.0",
+      "released_on": "2016-05-20"
+    },
+    {
+      "version": "1.33.0",
+      "released_on": "2016-05-04"
+    },
+    {
+      "version": "1.32.2",
+      "released_on": "2016-04-12"
+    },
+    {
+      "version": "1.32.1",
+      "released_on": "2016-04-11"
+    },
+    {
+      "version": "1.32.0",
+      "released_on": "2016-03-31"
+    },
+    {
+      "version": "1.31.1",
+      "released_on": "2016-03-24"
+    },
+    {
+      "version": "1.31.0",
+      "released_on": "2016-03-15"
+    },
+    {
+      "version": "1.30.0",
+      "released_on": "2016-02-27"
+    },
+    {
+      "version": "1.29.1",
+      "released_on": "2016-02-01"
+    },
+    {
+      "version": "1.29.0",
+      "released_on": "2016-01-26"
+    },
+    {
+      "version": "1.28.0",
+      "released_on": "2016-01-04"
+    },
+    {
+      "version": "1.27.1",
+      "released_on": "2015-10-02"
+    },
+    {
+      "version": "1.27.0",
+      "released_on": "2015-09-14"
+    },
+    {
+      "version": "1.26.0",
+      "released_on": "2015-09-11"
+    },
+    {
+      "version": "1.25.0",
+      "released_on": "2015-08-17"
+    },
+    {
+      "version": "1.24.1",
+      "released_on": "2015-08-05"
+    },
+    {
+      "version": "1.24.0",
+      "released_on": "2015-08-03"
+    },
+    {
+      "version": "1.23.0",
+      "released_on": "2015-07-06"
+    },
+    {
+      "version": "1.22.3",
+      "released_on": "2015-06-04"
+    },
+    {
+      "version": "1.22.2",
+      "released_on": "2015-04-08"
+    },
+    {
+      "version": "1.22.1",
+      "released_on": "2015-03-30"
+    },
+    {
+      "version": "1.22.0",
+      "released_on": "2015-03-22"
+    },
+    {
+      "version": "1.21.0",
+      "released_on": "2015-02-19"
+    },
+    {
+      "version": "1.20.2",
+      "released_on": "2015-01-21"
+    },
+    {
+      "version": "1.20.1",
+      "released_on": "2015-01-07"
+    },
+    {
+      "version": "1.20.0",
+      "released_on": "2014-12-23"
+    },
+    {
+      "version": "1.19.1",
+      "released_on": "2014-10-23"
+    },
+    {
+      "version": "1.19.0",
+      "released_on": "2014-07-29"
+    },
+    {
+      "version": "1.18.0",
+      "released_on": "2014-06-17"
+    },
+    {
+      "version": "1.17.0",
+      "released_on": "2014-06-10"
+    },
+    {
+      "version": "1.16.0",
+      "released_on": "2014-05-28"
+    },
+    {
+      "version": "1.15.1",
+      "released_on": "2014-05-22"
+    },
+    {
+      "version": "1.14.1",
+      "released_on": "2014-05-19"
+    },
+    {
+      "version": "1.14.0",
+      "released_on": "2014-04-09"
+    },
+    {
+      "version": "1.13.0",
+      "released_on": "2014-04-09"
+    },
+    {
+      "version": "1.12.2",
+      "released_on": "2014-03-13"
+    },
+    {
+      "version": "1.12.1",
+      "released_on": "2014-03-13"
+    },
+    {
+      "version": "1.12.0",
+      "released_on": "2014-01-29"
+    },
+    {
+      "version": "1.11.0",
+      "released_on": "2013-12-05"
+    },
+    {
+      "version": "1.10.8",
+      "released_on": "2013-12-04"
+    },
+    {
+      "version": "1.9.8",
+      "released_on": "2013-10-17"
+    },
+    {
+      "version": "1.9.7",
+      "released_on": "2013-10-17"
+    },
+    {
+      "version": "1.9.6",
+      "released_on": "2013-10-08"
+    },
+    {
+      "version": "1.9.5",
+      "released_on": "2013-09-18"
+    },
+    {
+      "version": "1.9.4",
+      "released_on": "2013-08-20"
+    },
+    {
+      "version": "1.9.3",
+      "released_on": "2013-08-12"
+    },
+    {
+      "version": "1.9.2",
+      "released_on": "2013-07-12"
+    },
+    {
+      "version": "1.9.1",
+      "released_on": "2013-05-03"
+    },
+    {
+      "version": "1.9.0",
+      "released_on": "2013-04-25"
+    },
+    {
+      "version": "1.8.0",
+      "released_on": "2013-04-11"
+    },
+    {
+      "version": "1.7.10",
+      "released_on": "2013-02-21"
+    },
+    {
+      "version": "1.7.9",
+      "released_on": "2013-02-04"
+    },
+    {
+      "version": "1.7.8",
+      "released_on": "2013-01-15"
+    },
+    {
+      "version": "1.7.7",
+      "released_on": "2012-12-18"
+    },
+    {
+      "version": "1.7.6",
+      "released_on": "2012-11-08"
+    },
+    {
+      "version": "1.7.5",
+      "released_on": "2012-10-30"
+    },
+    {
+      "version": "1.7.4",
+      "released_on": "2012-08-31"
+    },
+    {
+      "version": "1.7.3",
+      "released_on": "2012-08-17"
+    },
+    {
+      "version": "1.7.2",
+      "released_on": "2012-05-31"
+    },
+    {
+      "version": "1.7.1",
+      "released_on": "2012-05-21"
+    },
+    {
+      "version": "1.7.0",
+      "released_on": "2012-05-17"
+    },
+    {
+      "version": "1.6.1",
+      "released_on": "2012-02-04"
+    },
+    {
+      "version": "1.5.36",
+      "released_on": "2012-01-26"
+    },
+    {
+      "version": "1.5.35",
+      "released_on": "2012-01-05"
+    },
+    {
+      "version": "1.5.34",
+      "released_on": "2012-01-05"
+    },
+    {
+      "version": "1.5.33",
+      "released_on": "2012-01-05"
+    },
+    {
+      "version": "1.5.32",
+      "released_on": "2012-01-05"
+    },
+    {
+      "version": "1.5.31",
+      "released_on": "2012-01-05"
+    },
+    {
+      "version": "1.5.30",
+      "released_on": "2011-12-12"
+    },
+    {
+      "version": "1.5.29",
+      "released_on": "2011-11-25"
+    },
+    {
+      "version": "1.5.28",
+      "released_on": "2011-11-23"
+    },
+    {
+      "version": "1.5.27",
+      "released_on": "2011-10-29"
+    },
+    {
+      "version": "1.5.26",
+      "released_on": "2011-10-29"
+    },
+    {
+      "version": "1.5.25",
+      "released_on": "2011-10-29"
+    },
+    {
+      "version": "1.5.24",
+      "released_on": "2011-10-21"
+    },
+    {
+      "version": "1.5.23",
+      "released_on": "2011-10-21"
+    },
+    {
+      "version": "1.5.22",
+      "released_on": "2011-09-14"
+    },
+    {
+      "version": "1.5.21",
+      "released_on": "2011-09-14"
+    },
+    {
+      "version": "1.5.20",
+      "released_on": "2011-08-29"
+    },
+    {
+      "version": "1.5.19",
+      "released_on": "2011-08-27"
+    },
+    {
+      "version": "1.5.18",
+      "released_on": "2011-08-09"
+    },
+    {
+      "version": "1.5.17",
+      "released_on": "2011-07-31"
+    },
+    {
+      "version": "1.5.16",
+      "released_on": "2011-07-29"
+    },
+    {
+      "version": "1.5.15",
+      "released_on": "2011-07-27"
+    },
+    {
+      "version": "1.5.14",
+      "released_on": "2011-07-13"
+    },
+    {
+      "version": "1.5.13",
+      "released_on": "2011-07-12"
+    },
+    {
+      "version": "1.5.12",
+      "released_on": "2011-07-12"
+    },
+    {
+      "version": "1.5.11",
+      "released_on": "2011-07-11"
+    },
+    {
+      "version": "1.5.10",
+      "released_on": "2011-06-26"
+    },
+    {
+      "version": "1.5.9",
+      "released_on": "2011-06-23"
+    },
+    {
+      "version": "1.5.8",
+      "released_on": "2011-06-13"
+    },
+    {
+      "version": "1.5.7",
+      "released_on": "2011-06-13"
+    },
+    {
+      "version": "1.5.6",
+      "released_on": "2011-06-03"
+    },
+    {
+      "version": "1.5.5",
+      "released_on": "2011-06-03"
+    },
+    {
+      "version": "1.5.4",
+      "released_on": "2011-06-03"
+    },
+    {
+      "version": "1.5.3",
+      "released_on": "2011-06-02"
+    },
+    {
+      "version": "1.5.2",
+      "released_on": "2011-06-01"
+    },
+    {
+      "version": "1.5.1",
+      "released_on": "2011-05-30"
+    },
+    {
+      "version": "1.5.0",
+      "released_on": "2011-05-26"
+    }
+  ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9f3327d0f..cb037398e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,20 +1,25 @@
-## 15.6.1 - 2026-09-01
+<!--
+THIS IS A GENERATED FILE. Any changes you make to it directly will be blown away.
+Instead, edit a corresponding `.change.md` file and run `hark build`.
+-->
+
+# Changelog
+
+## <a id="15-6-1"></a>15.6.1 - 2026-09-01
+* [#1860](https://github.com/stripe/stripe-python/pull/1860) Dispatch discriminated union fields to their variant class
 * [#1896](https://github.com/stripe/stripe-python/pull/1896) Harden API requestor code against malicious URLs
 * [#1898](https://github.com/stripe/stripe-python/pull/1898) Use cryptographically secure boundaries for multipart file uploads
-* [#1860](https://github.com/stripe/stripe-python/pull/1860) Dispatch discriminated union fields to their variant class
 
-## 15.6.0 - 2026-08-26
-This release changes the pinned API version to 2026-08-26.dahlia.
+## <a id="15-6-0"></a>15.6.0 - 2026-08-26
+This release changes the pinned API version to `2026-08-26.dahlia`.
 
 * [#1881](https://github.com/stripe/stripe-python/pull/1881) Add new `EventNotificationHandler` class for better thin event management
-  
   - We've been putting a lot of time into rethinking the event handling experience in the SDKs. This new class is the culmination [of that effort](https://stripe.dev/blog/event-notification-handlers-thin-events).
   - They're designed for a tight coupling with both `StripeClient` and the fully-typed nature of [thin events](https://docs.stripe.com/event-destinations#thin-events). This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.
   - Now that we've released [thin event notifications for v1 objects](https://docs.stripe.com/changelog#2026-08-26.dahlia), these new handlers are our recommended path for all integrations using thin event notifications.
   - See more detailed docs here: https://docs.stripe.com/webhooks/event-notification-handlers
   - As part of this work, we've widened some of the types our webhook-related methods take so they play more nicely with the types commonly returned by popular web frameworks ([#1888](https://github.com/stripe/stripe-python/pull/1888))
-
-* [#1876](https://github.com/stripe/stripe-python/pull/1876) Update generated code
+* ⚠️ [#1876](https://github.com/stripe/stripe-python/pull/1876) Update generated code
   * Add support for new resource `billing.FeedbackOption`
   * Add support for `create`, `deactivate`, `list`, `modify`, and `retrieve` methods on resource `billing.FeedbackOption`
   * Add support for `payment_method_settings` on `AccountSession.Component` and `AccountSessionCreateParamsComponent`
@@ -38,28 +43,28 @@ This release changes the pinned API version to 2026-08-26.dahlia.
   * Add support for new value `2026-08-26.dahlia` on enum `WebhookEndpointCreateParams.api_version`
   * Add support for error codes `authentication_failure`, `capability_not_active`, `expired_payment_method`, `incorrect_postal_code`, `invalid_canceled_subscription_fields`, and `payment_method_restricted` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, `StripeError`, and `Terminal.Reader.Action.ApiError`
 
-## 15.5.1 - 2026-08-18
+## <a id="15-5-1"></a>15.5.1 - 2026-08-18
 * [#1879](https://github.com/stripe/stripe-python/pull/1879) better document `StripeObject`'s `to_dict` behavior
 
-## 15.5.0 - 2026-08-10
-* [#1874](https://github.com/stripe/stripe-python/pull/1874) Add async iteration to v2 list auto-pagination
-  - Adds `async for` support to v2 `ListObject.auto_paging_iter()`.
-* [#1869](https://github.com/stripe/stripe-python/pull/1869) Surface `object` property on `EventNotification`
-* [#1867](https://github.com/stripe/stripe-python/pull/1867) Emit Claude Code plugin hint at module load time
-  - Emits new Claude Code plugin hint when `CLAUDECODE` or `CLAUDE_CODE_CHILD_SESSION` environment variables are detected.
+## <a id="15-5-0"></a>15.5.0 - 2026-08-10
+* [#1863](https://github.com/stripe/stripe-python/pull/1863) Add `stripe.major_api_version` constant
 * [#1855](https://github.com/stripe/stripe-python/pull/1855) add/adjust event parsing helpers
-  
   - Added methods that return their respective `Event`/`EventNotification` class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from [AWS EventBridge](https://docs.stripe.com/event-destinations/eventbridge) and [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid) natively.
     - `Webhook.construct_event_without_verification(payload)`
     - `StripeClient.construct_event_without_verification(payload)`
     - `StripeClient.parse_event_notification_without_verification(payload)`
   - Added `WebhookSignature.generate_signature_header(payload, secret, timestamp=None)`, which computes a full `Stripe-Signature` header for the given payload. Useful for unit tests!
-  
-* [#1863](https://github.com/stripe/stripe-python/pull/1863) Add `stripe.major_api_version` constant
+* [#1867](https://github.com/stripe/stripe-python/pull/1867) Emit Claude Code plugin hint at module load time
+  - Emits new Claude Code plugin hint when `CLAUDECODE` or `CLAUDE_CODE_CHILD_SESSION` environment variables are detected.
+* [#1869](https://github.com/stripe/stripe-python/pull/1869) Surface `object` property on `EventNotification`
+* [#1874](https://github.com/stripe/stripe-python/pull/1874) Add async iteration to v2 list auto-pagination
+  - Adds `async for` support to v2 `ListObject.auto_paging_iter()`.
 
-## 15.4.0 - 2026-07-29
-This release changes the pinned API version to 2026-07-29.dahlia.
+## <a id="15-4-0"></a>15.4.0 - 2026-07-29
+This release changes the pinned API version to `2026-07-29.dahlia`.
 
+* [#1849](https://github.com/stripe/stripe-python/pull/1849) Use ip address directly instead of localhost to speed up windows tests
+* [#1853](https://github.com/stripe/stripe-python/pull/1853) Fix intermittent Windows test flake in async httpx integration tests
 * [#1857](https://github.com/stripe/stripe-python/pull/1857) Update generated code
   * Add support for new resource `financial_connections.Authorization`
   * Add support for `unreject` method on resource `Account`
@@ -106,20 +111,18 @@ This release changes the pinned API version to 2026-07-29.dahlia.
   * Add support for snapshot events `financial_connections.account.expected_deactivation_date_updated`, `financial_connections.account.supported_payment_method_types_updated`, and `financial_connections.account.upcoming_deactivation` with resource `financial_connections.Account`
   * Add support for snapshot events `financial_connections.authorization.expected_deactivation_date_updated` and `financial_connections.authorization.upcoming_deactivation` with resource `financial_connections.Authorization`
   * Enum type annotations for non-exhaustive ("open") enums are now typed as `Union[Literal[...], str]` instead of plain `Literal[...]`. Many Stripe enums are open, meaning new values may appear in new versions of the API. This change ensures these fields have the correct type for both the values known at SDK release time and other values that may be added later. Refer to the [API Reference](https://docs.stripe.com) for the latest set of allowed values.
-* [#1853](https://github.com/stripe/stripe-python/pull/1853) Fix intermittent Windows test flake in async httpx integration tests
-* [#1849](https://github.com/stripe/stripe-python/pull/1849) Use ip address directly instead of localhost to speed up windows tests
 
-## 15.3.1 - 2026-07-15
-* [#1846](https://github.com/stripe/stripe-python/pull/1846) Replace source hash with Telemetry UUID
-* [#1845](https://github.com/stripe/stripe-python/pull/1845) Make Error fields generated
-* [#1843](https://github.com/stripe/stripe-python/pull/1843) Remove unused Retry-After header support
+## <a id="15-3-1"></a>15.3.1 - 2026-07-15
 * [#1834](https://github.com/stripe/stripe-python/pull/1834) Reduce StripeClient() cold start latency for serverless environments
   - Moves HTTP library imports to module load time to better accommodate AWS Lambda and other serverless environments that have separate Init phase and Invoke phase time budgets.
+* [#1843](https://github.com/stripe/stripe-python/pull/1843) Remove unused Retry-After header support
+* [#1845](https://github.com/stripe/stripe-python/pull/1845) Make Error fields generated
+* [#1846](https://github.com/stripe/stripe-python/pull/1846) Replace source hash with Telemetry UUID
 
-## 15.3.0 - 2026-06-24
-This release changes the pinned API version to 2026-06-24.dahlia.
+## <a id="15-3-0"></a>15.3.0 - 2026-06-24
+This release changes the pinned API version to `2026-06-24.dahlia`.
 
-* [#1836](https://github.com/stripe/stripe-python/pull/1836) Update generated code
+* ⚠️ [#1836](https://github.com/stripe/stripe-python/pull/1836) Update generated code
   * Add support for `release_details` on `Reserve.Hold`
   * ⚠️ Add support for new value `tax_fund` on enum `BalanceTransaction.type`
   * Change `Billing.CreditGrant.priority` to be required
@@ -156,13 +159,14 @@ This release changes the pinned API version to 2026-06-24.dahlia.
   * ⚠️ Add support for new value `sunbit_payments` on enum `EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updated_capability`
   * Add support for error codes `anomalous_money_movement_request`, `failed_tax_calculation`, `financial_account_balance_does_not_support_currency`, `financial_account_capability_not_enabled`, and `financial_account_capability_restricted` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, `StripeError`, and `Terminal.Reader.Action.ApiError`
 
-## 15.2.1 - 2026-06-12
+## <a id="15-2-1"></a>15.2.1 - 2026-06-12
 * [#1825](https://github.com/stripe/stripe-python/pull/1825) Add "source" field to user-agent header
 
-## 15.2.0 - 2026-05-27
-This release changes the pinned API version to 2026-05-27.dahlia.
+## <a id="15-2-0"></a>15.2.0 - 2026-05-27
+This release changes the pinned API version to `2026-05-27.dahlia`.
 
-* [#1816](https://github.com/stripe/stripe-python/pull/1816) Update generated code
+* [#1813](https://github.com/stripe/stripe-python/pull/1813) Emit warning when `stripe-notify` header is present in response
+* ⚠️ [#1816](https://github.com/stripe/stripe-python/pull/1816) Update generated code
   * Add support for new resource `v2.commerce.ProductCatalogImport`
   * Add support for `create` and `retrieve` methods on resource `v2.commerce.ProductCatalogImport`
   * Add support for `bizum_payments` and `scalapay_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
@@ -212,12 +216,11 @@ This release changes the pinned API version to 2026-05-27.dahlia.
   * ⚠️ Add support for new value `meter_event_value_too_many_digits` on enums `EventsV1BillingMeterErrorReportTriggeredEvent.Reason.ErrorType.code` and `EventsV1BillingMeterNoMeterFoundEvent.Reason.ErrorType.code`
   * Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `v2.commerce.ProductCatalogImport`
   * Add support for error codes `payment_method_microdeposit_processing_error` and `siret_invalid` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1813](https://github.com/stripe/stripe-python/pull/1813) Emit warning when `stripe-notify` header is present in response
 
-## 15.1.0 - 2026-04-23
-This release changes the pinned API version to 2026-04-22.dahlia.
+## <a id="15-1-0"></a>15.1.0 - 2026-04-23
+This release changes the pinned API version to `2026-04-22.dahlia`.
 
-* [#1793](https://github.com/stripe/stripe-python/pull/1793) Update generated code
+* ⚠️ [#1793](https://github.com/stripe/stripe-python/pull/1793) Update generated code
   * Add support for `balance_report` and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSessionCreateParamsComponent`
   * Add support for `app_distribution` and `sunbit_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
   * ⚠️ Add support for new values `fee_credit_funding`, `inbound_transfer_reversal`, and `inbound_transfer` on enum `BalanceTransaction.type`
@@ -258,18 +261,28 @@ This release changes the pinned API version to 2026-04-22.dahlia.
   * Add support for new value `2026-04-22.dahlia` on enum `WebhookEndpointCreateParams.api_version`
   * Add support for error codes `action_blocked` and `approval_required` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
 
-## 15.0.1 - 2026-04-01
+## <a id="15-0-1"></a>15.0.1 - 2026-04-01
+* [#1780](https://github.com/stripe/stripe-python/pull/1780) Fix `str` / `repr` for `StripeObjects` with decimals & add support for plain dicts
 * [#1786](https://github.com/stripe/stripe-python/pull/1786) Fix encoding two-dimensional array request params
 * [#1785](https://github.com/stripe/stripe-python/pull/1785) Improve types for `metadata` and other dict-like types
-* [#1780](https://github.com/stripe/stripe-python/pull/1780) Fix `str` / `repr` for `StripeObjects` with decimals & add support for plain dicts
 
-## 15.0.0 - 2026-03-25
+## <a id="15-0-0"></a>15.0.0 - 2026-03-25
+This release changes the pinned API version to `2026-03-25.dahlia`.
 
-This release changes the pinned API version to `2026-03-25.dahlia` and contains breaking changes (prefixed with ⚠️ below). There's also a [detailed migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v15) to simplify your upgrade process.
+This release contains breaking changes (prefixed with ⚠️ below). There's also a [detailed migration guide](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v15) to simplify your upgrade process.
 
 Please review details for the breaking changes and alternatives in the [Stripe API changelog](https://docs.stripe.com/changelog/dahlia) before upgrading.
 
-* ⚠️ **Breaking change:** [#1769](https://github.com/stripe/stripe-python/pull/1769) Add decimal_string coercion for v1 and v2 API fields
+* ⚠️ [#1764](https://github.com/stripe/stripe-python/pull/1764) Drop support for Python 3.7 & 3.8
+* ⚠️ [#1762](https://github.com/stripe/stripe-python/pull/1762) `StripeObject` no longer inherits from `dict`
+  - `StripeObject` no longer inherits from `dict`, so any `dict` methods will no longer exist, including `.get()` and notably, `.items()`.
+    - For convenience, it's still possible to check key presence with `'some_key' in some_obj`. To replicate `.get()` behavior, use `getattr(obj, 'some_key', None)` for now. We've got some improvements around accessing properties that may not be present planned, but `getattr` works for now.
+    - `.update()` has been retained for easier interaction with `metadata`, but it's not really intended for use on full objects.
+    - Equality between `StripeObject`s still works: it checks for equality between the same class and underlying data.
+  - To access the underlying data as a `dict`, call `some_obj.to_dict()`, which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of `to_dict()` won't affect the original object.
+  - Write operations can still be done with dot notation (`some_obj.val = 123`) or bracket notation (`some_obj["val"] = 123`). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.
+* ⚠️ [#1767](https://github.com/stripe/stripe-python/pull/1767) Throw an error when using the wrong webhook parsing method
+* ⚠️ [#1769](https://github.com/stripe/stripe-python/pull/1769) Add decimal_string coercion for v1 and v2 API fields
   - All `decimal_string` fields changed type from `str` to `decimal.Decimal` in both request params and response objects. Code that reads or writes these fields as `str` will need to use `Decimal` instead. Affected fields across v1 and v2 APIs:
     - **checkout.Session**: `fx_rate`
     - **climate.Order**: `metric_tons`; **climate.Product**: `metric_tons_available`
@@ -281,20 +294,10 @@ Please review details for the breaking changes and alternatives in the [Stripe A
     - **Price**: `unit_amount_decimal`, `flat_amount_decimal` (including `currency_options` and `tiers`)
     - **v2.core.Account** / **v2.core.AccountPerson**: `percent_ownership`
     - Request params on **Invoice**, **Product**, **Quote**, **Subscription**, **SubscriptionItem**, **SubscriptionSchedule**, **PaymentLink**: `unit_amount_decimal`, `flat_amount_decimal`, `quantity_decimal` (where applicable)
-* [⚠️ **Breaking change:**#1767](https://github.com/stripe/stripe-python/pull/1767) Throw an error when using the wrong webhook parsing method
-* ⚠️ **Breaking change:** [#1764](https://github.com/stripe/stripe-python/pull/1764) Drop support for Python 3.7 & 3.8
-* ⚠️ **Breaking change:** [#1762](https://github.com/stripe/stripe-python/pull/1762) `StripeObject` no longer inherits from `dict`
-
-  - `StripeObject` no longer inherits from `dict`, so any `dict` methods will no longer exist, including `.get()` and notably, `.items()`.
-    - For convenience, it's still possible to check key presence with `'some_key' in some_obj`. To replicate `.get()` behavior, use `getattr(obj, 'some_key', None)` for now. We've got some improvements around accessing properties that may not be present planned, but `getattr` works for now.
-    - `.update()` has been retained for easier interaction with `metadata`, but it's not really intended for use on full objects.
-    - Equality between `StripeObject`s still works: it checks for equality between the same class and underlying data.
-  - To access the underlying data as a `dict`, call `some_obj.to_dict()`, which recursively dumps all stripe-provided classes into native Python types. This is a read-only view; changes to the output of `to_dict()` won't affect the original object.
-  - Write operations can still be done with dot notation (`some_obj.val = 123`) or bracket notation (`some_obj["val"] = 123`). Do that instead of trying to interact with the underlying data store, as the implementation is considered private and may change without warning in the future.
 
 ### ⚠️ Breaking changes  due to changes in the Stripe API
-
-* Generated changes from [#1749](https://github.com/stripe/stripe-python/pull/1749), [#1771](https://github.com/stripe/stripe-python/pull/1771), [#1773](https://github.com/stripe/stripe-python/pull/1773), [#1775](https://github.com/stripe/stripe-python/pull/1775)
+* [#1756](https://github.com/stripe/stripe-python/pull/1756) Add runtime support for V2 int64 string-encoded fields
+* ⚠️ Generated changes from [#1749](https://github.com/stripe/stripe-python/pull/1749), [#1771](https://github.com/stripe/stripe-python/pull/1771), [#1773](https://github.com/stripe/stripe-python/pull/1773), [#1775](https://github.com/stripe/stripe-python/pull/1775)
   * Add support for `upi_payments` on `Account.Capability`, `AccountCreateParamsCapability`, and `AccountModifyParamsCapability`
   * Add support for `upi` on `Charge.PaymentMethodDetail`, `Checkout.Session.PaymentMethodOption`, `ConfirmationToken.PaymentMethodPreview`, `ConfirmationTokenCreateParamsPaymentMethodDatum`, `Mandate.PaymentMethodDetail`, `PaymentAttemptRecord.PaymentMethodDetail`, `PaymentIntent.PaymentMethodOption`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodOption`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodOption`, `PaymentIntentModifyParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationModifyParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.PaymentMethodDetail`, `SetupAttempt.PaymentMethodDetail`, `SetupIntent.PaymentMethodOption`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodOption`, `SetupIntentCreateParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodOption`, `SetupIntentModifyParamsPaymentMethodDatum`, `SetupIntentModifyParamsPaymentMethodOption`, and `checkout.SessionCreateParamsPaymentMethodOption`
   * Add support for new value `tempo` on enums `Charge.PaymentMethodDetail.Crypto.network`, `PaymentAttemptRecord.PaymentMethodDetail.Crypto.network`, and `PaymentRecord.PaymentMethodDetail.Crypto.network`
@@ -330,16 +333,15 @@ Please review details for the breaking changes and alternatives in the [Stripe A
   * Add support for new value `2026-03-25.dahlia` on enum `WebhookEndpointCreateParams.api_version`
   * ⚠️ Change type of `V2.Core.EventDestination.events_from` and `v2.core.EventDestinationCreateParams.events_from` from `enum('other_accounts'|'self')` to `string`
   * Add support for error code `service_period_coupon_with_metered_tiered_item_unsupported` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1756](https://github.com/stripe/stripe-python/pull/1756) Add runtime support for V2 int64 string-encoded fields
 
-
-## 14.4.1 - 2026-03-06
-* [#1748](https://github.com/stripe/stripe-python/pull/1748) Add Stripe-Request-Trigger header
+## <a id="14-4-1"></a>14.4.1 - 2026-03-06
 * [#1743](https://github.com/stripe/stripe-python/pull/1743) Add agent information to UserAgent
+* [#1748](https://github.com/stripe/stripe-python/pull/1748) Add Stripe-Request-Trigger header
 
-## 14.4.0 - 2026-02-25
+## <a id="14-4-0"></a>14.4.0 - 2026-02-25
 This release changes the pinned API version to `2026-02-25.clover`.
 
+* [#1731](https://github.com/stripe/stripe-python/pull/1731) Added instruction to update CA certificates in README.
 * [#1737](https://github.com/stripe/stripe-python/pull/1737) Allow AIOHTTPClient to accept user-provided session or connector. Fixes [#1736](https://github.com/stripe/stripe-python/pull/1736)
 * [#1732](https://github.com/stripe/stripe-python/pull/1732) Update generated code
   * Add support for new resources `reserve.Hold`, `reserve.Plan`, and `reserve.Release`
@@ -366,11 +368,11 @@ This release changes the pinned API version to `2026-02-25.clover`.
   * Add support for snapshot events `reserve.plan.created`, `reserve.plan.disabled`, `reserve.plan.expired`, and `reserve.plan.updated` with resource `reserve.Plan`
   * Add support for snapshot event `reserve.release.created` with resource `reserve.Release`
   * Add support for error codes `storer_capability_missing` and `storer_capability_not_active` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1731](https://github.com/stripe/stripe-python/pull/1731) Added instruction to update CA certificates in README.
 
-## 14.3.0 - 2026-01-28
+## <a id="14-3-0"></a>14.3.0 - 2026-01-28
 This release changes the pinned API version to `2026-01-28.clover`.
 
+* [#1722](https://github.com/stripe/stripe-python/pull/1722) Add documentation for undocumented API parameters
 * [#1725](https://github.com/stripe/stripe-python/pull/1725) Update generated code
   * Add support for new resource `radar.PaymentEvaluation`
   * Add support for `create` method on resource `radar.PaymentEvaluation`
@@ -391,19 +393,20 @@ This release changes the pinned API version to `2026-01-28.clover`.
   * Add support for `registration_date` on `V2.Core.Account.Identity.BusinessDetail`, `v2.core.AccountCreateParamsIdentityBusinessDetail`, `v2.core.AccountModifyParamsIdentityBusinessDetail`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetail`
   * Add support for new value `gb_vat` on enums `V2.Core.Account.Identity.BusinessDetail.IdNumber.type`, `v2.core.AccountCreateParamsIdentityBusinessDetailIdNumber.type`, `v2.core.AccountModifyParamsIdentityBusinessDetailIdNumber.type`, and `v2.core.AccountTokenCreateParamsIdentityBusinessDetailIdNumber.type`
   * Add support for error code `request_blocked` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1722](https://github.com/stripe/stripe-python/pull/1722) Add documentation for undocumented API parameters
 
-## 14.2.0 - 2026-01-16
+## <a id="14-2-0"></a>14.2.0 - 2026-01-16
+* [#1703](https://github.com/stripe/stripe-python/pull/1703) Update ci to run on Python 3.14 as well
+* [#1687](https://github.com/stripe/stripe-python/pull/1687) Fix DeprecationWarning when encoding StripeObject metadata (fixes #1651)
 * [#1720](https://github.com/stripe/stripe-python/pull/1720) Update generated code
   * Add support for event notifications `V2CoreAccountClosedEvent`, `V2CoreAccountCreatedEvent`, `V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationCustomerUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientUpdatedEvent`, `V2CoreAccountIncludingDefaultsUpdatedEvent`, `V2CoreAccountIncludingFutureRequirementsUpdatedEvent`, `V2CoreAccountIncludingIdentityUpdatedEvent`, `V2CoreAccountIncludingRequirementsUpdatedEvent`, and `V2CoreAccountUpdatedEvent` with related object `v2.core.Account`
   * Add support for event notification `V2CoreAccountLinkReturnedEvent`
   * Add support for event notifications `V2CoreAccountPersonCreatedEvent`, `V2CoreAccountPersonDeletedEvent`, and `V2CoreAccountPersonUpdatedEvent` with related object `v2.core.AccountPerson`
-* [#1687](https://github.com/stripe/stripe-python/pull/1687) Fix DeprecationWarning when encoding StripeObject metadata (fixes #1651)
-* [#1703](https://github.com/stripe/stripe-python/pull/1703) Update ci to run on Python 3.14 as well
 
-## 14.1.0 - 2025-12-16
+## <a id="14-1-0"></a>14.1.0 - 2025-12-16
 This release changes the pinned API version to `2025-12-15.clover`.
 
+* [#1676](https://github.com/stripe/stripe-python/pull/1676) Add create_async method to EphemeralKey
+* [#1692](https://github.com/stripe/stripe-python/pull/1692) Updated bundled CA certificates
 * [#1696](https://github.com/stripe/stripe-python/pull/1696) Update generated code
   * Add support for new resources `v2.core.AccountLink`, `v2.core.AccountPersonToken`, `v2.core.AccountPerson`, `v2.core.AccountToken`, and `v2.core.Account`
   * Add support for `create` and `retrieve` methods on resources `v2.core.AccountPersonToken` and `v2.core.AccountToken`
@@ -440,19 +443,15 @@ This release changes the pinned API version to `2025-12-15.clover`.
   * Add support for new values `2025-12-15.clover` and `2026-01-28.clover` on enum `WebhookEndpointCreateParams.api_version`
   * Add support for `changes` on `V2.Core.Event`
   * Add support for error code `account_token_required_for_v2_account` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1692](https://github.com/stripe/stripe-python/pull/1692) Updated bundled CA certificates
-* [#1676](https://github.com/stripe/stripe-python/pull/1676) Add create_async method to EphemeralKey
 
-## 14.0.1 - 2025-11-21
+## <a id="14-0-1"></a>14.0.1 - 2025-11-21
+* [#1681](https://github.com/stripe/stripe-python/pull/1681) Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging.
 * [#1684](https://github.com/stripe/stripe-python/pull/1684) Update generated code
   * `stripe.error` module is now accessible globally. Fixes [#1682](https://github.com/stripe/stripe-python/issues/1682)
-* [#1681](https://github.com/stripe/stripe-python/pull/1681) Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging.
 
-## 14.0.0 - 2025-11-18
+## <a id="14-0-0"></a>14.0.0 - 2025-11-18
 This release changes the pinned API version to `2025-11-17.clover`.
 
-* [#1673](https://github.com/stripe/stripe-python/pull/1673) Update generated code
-  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `v2.core.EventListParams` in favor of `created`.
 * [#1669](https://github.com/stripe/stripe-python/pull/1669) Update v2 array parameter serialization to use indexed format
   - `Retrieve` and `List` calls for `/v2` endpoints now use indexed format (e.g., `?include[0]=foo&include[1]=bar`) instead of repeated parameter format (e.g., `?include=foo&include=bar`) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
 * [#1667](https://github.com/stripe/stripe-python/pull/1667) Update generated code
@@ -474,23 +473,26 @@ This release changes the pinned API version to `2025-11-17.clover`.
   * Add support for `mb_way` and `twint` on `Refund.DestinationDetail`
   * Add support for new values `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` on enums `WebhookEndpointCreateParams.enabled_events` and `WebhookEndpointModifyParams.enabled_events`
   * Add support for snapshot events `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` with resource `financial_connections.Account`
+* ⚠️ [#1673](https://github.com/stripe/stripe-python/pull/1673) Update generated code
+  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `v2.core.EventListParams` in favor of `created`.
 
-## 13.2.0 - 2025-11-05
+## <a id="13-2-0"></a>13.2.0 - 2025-11-05
 * [#1662](https://github.com/stripe/stripe-python/pull/1662) Update generated code
   * Add support for `capture_method` on `PaymentIntent.PaymentMethodOption.CardPresent`, `PaymentIntentConfirmParamsPaymentMethodOptionCardPresent`, `PaymentIntentCreateParamsPaymentMethodOptionCardPresent`, and `PaymentIntentModifyParamsPaymentMethodOptionCardPresent`
 
-## 13.1.2 - 2025-11-04
+## <a id="13-1-2"></a>13.1.2 - 2025-11-04
 * [#1661](https://github.com/stripe/stripe-python/pull/1661) Add support for value `payment_record` to enum `InvoicePayment.payment.type`
 
-## 13.1.1 - 2025-10-31
+## <a id="13-1-1"></a>13.1.1 - 2025-10-31
 * [#1660](https://github.com/stripe/stripe-python/pull/1660) Fix `stripe-context` header not being included in paged list requests
 
-## 13.1.0 - 2025-10-29
-
+## <a id="13-1-0"></a>13.1.0 - 2025-10-29
 This release changes the pinned API version to `2025-10-29.clover`.
 
-* [#1656](https://github.com/stripe/stripe-python/pull/1656) Update generated code
-  * Improve docs for PaymentIntent related endpoints
+* [#1645](https://github.com/stripe/stripe-python/pull/1645) Dramatically improve performance by lazily loading most imports
+  - move many type imports behind an `if TYPE_CHECKING` block
+  - lazily initialize subservices
+  - add module-level `__getattr__` functions to most `__init__.py` files
 * [#1650](https://github.com/stripe/stripe-python/pull/1650) Update generated code
   * Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
   * Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
@@ -534,67 +536,50 @@ This release changes the pinned API version to `2025-10-29.clover`.
   * Add support for snapshot event `balance_settings.updated` with resource `BalanceSettings`
   * Add support for snapshot event `invoice.payment_attempt_required` with resource `Invoice`
   * Add support for error code `payment_intent_rate_limit_exceeded` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1645](https://github.com/stripe/stripe-python/pull/1645) Dramatically improve performance by lazily loading most imports
-  - move many type imports behind an `if TYPE_CHECKING` block
-  - lazily initialize subservices
-  - add module-level `__getattr__` functions to most `__init__.py` files
+* [#1656](https://github.com/stripe/stripe-python/pull/1656) Update generated code
+  * Improve docs for PaymentIntent related endpoints
 
-## 13.0.1 - 2025-10-03
+## <a id="13-0-1"></a>13.0.1 - 2025-10-03
 * [#1626](https://github.com/stripe/stripe-python/pull/1626) Make the new nested params classes correctly importable
   - For example, In SDK `v13.0.0`, `from stripe.params.checkout import SessionCreateParamsDiscount` would raise an error when it shouldn't have. This is fixed.
   - Reported in https://github.com/stripe/stripe-python/issues/1625
+* [#1627](https://github.com/stripe/stripe-python/pull/1627) Re-add `tests` to our `sdist`
+  - Reported in https://github.com/stripe/stripe-python/issues/1616
 * [#1633](https://github.com/stripe/stripe-python/pull/1633) Add new `async` optional dependency
   - Now, `pip install stripe[async]` gets you everything you need to make async HTTP calls out of the box.
   - Reported in https://github.com/stripe/stripe-python/issues/1558
-* [#1627](https://github.com/stripe/stripe-python/pull/1627) Re-add `tests` to our `sdist`
-  - Reported in https://github.com/stripe/stripe-python/issues/1616
 * [#1632](https://github.com/stripe/stripe-python/pull/1632) remove gpg step from publish. PyPI has ignored these for years, so we took the opportunity to simplify our build process
 
-## 13.0.0 - 2025-09-30
-This release changes the pinned API version to `2025-09-30.clover` and contains breaking changes (prefixed with ⚠️ below)
+## <a id="13-0-0"></a>13.0.0 - 2025-09-30
+This release changes the pinned API version to `2025-09-30.clover`.
 
-* [#1604](https://github.com/stripe/stripe-python/pull/1604) Fixed InvoiceLineItem method definition
-  * ⚠️ `InvoiceLineItem.modify` and `InvoiceLineItem.modify_async` now require `invoice` and `line_item_id` as method parameters.
-    * Removed `InvoiceLineItem.ModifyParam` class. Use a `typing.dict` to type hint instead.
-* [#1538](https://github.com/stripe/stripe-python/pull/1538) ⚠️ Add strongly typed EventNotifications
+This release contains breaking changes (prefixed with ⚠️ below)
+
+* ⚠️ [#1565](https://github.com/stripe/stripe-python/pull/1565) Build SDK w/ V2 OpenAPI spec
+  - ⚠️ The delete methods for v2 APIs (the ones in the `StripeClient.v2` namespace) now return a `V2DeletedObject` which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
+  - ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Dict[str, Any]`. Because there were no params, it's unlikely you were using these classes.
+* [#1570](https://github.com/stripe/stripe-python/pull/1570) Don't use mutable default arguments
+  - Service methods now correctly set `None` as the default function argument instead of `{}`
+* ⚠️ [#1569](https://github.com/stripe/stripe-python/pull/1569) Renamed Urllib2Client to UrllibClient
+  - ⚠️ Rename `http_client.Urllib2Client` to `http_client.UrllibClient` as Python `urllib2` was renamed to `urllib` in Python 3.
+* ⚠️ [#1572](https://github.com/stripe/stripe-python/pull/1572) migrate from `setup.py` to `pyproject.toml`
+  - ⚠️ The package has swapped from `setup.py` to `pyproject.toml`. As a result, we're dropping support for `pip < 10.0.0` (released April 2018).
+  - Additionally, we're no longer shipping tests or examples in our sdist now, which should offer a small size reduction for the package if installed without the wheel (approx. 2.5MB unzipped)
+* ⚠️ [#1589](https://github.com/stripe/stripe-python/pull/1589) Add `StripeContext` object
+  - Add the `StripeContext` class. Previously, one could only pass a string for `stripe_context`. You can now use the new class as well.
+  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
+* ⚠️ [#1538](https://github.com/stripe/stripe-python/pull/1538) Add strongly typed EventNotifications
   We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
   - Added matching `EventNotification` classes to every v2 `Event`. For example, there's now a `V1BillingMeterErrorReportTriggeredEventNotification` to match the existing `V1BillingMeterErrorReportTriggeredEvent`. Each notification class defines a `fetch_event()` method to retrieve its corresponding event. For events with related objects, there's a `fetch_related_object()` method that performs the API call and casts the response to the correct type.
   - ⚠️ Rename function `StripeClient.parse_thin_event` to `StripeClient.parse_event_notification` and remove the `Stripe.ThinEvent` class.
       - This function now returns a `stripe.v2.core.EventNotification` (which is the shared base class that all of the more specific `stripe.events.*EventNotification` classes  share) instead of `Stripe.ThinEvent`. When applicable, these event notifications will have the `related_object` property and a `fetch_related_object()` function. They also have a `fetch_()` method to retrieve their corresponding `stripe.events.*Event` instance.
       - If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of `Stripe.Events.UnknownEventNotification` instead of a more specific type. It has both the `relatedObject` property and the `FetchRelatedObject()` function (but they may be/return `null`)
-* [#1602](https://github.com/stripe/stripe-python/pull/1602) Move `V2.Event` API resources to `V2.Core.Events`
+* ⚠️ [#1604](https://github.com/stripe/stripe-python/pull/1604) Fixed InvoiceLineItem method definition
+  * ⚠️ `InvoiceLineItem.modify` and `InvoiceLineItem.modify_async` now require `invoice` and `line_item_id` as method parameters.
+    * Removed `InvoiceLineItem.ModifyParam` class. Use a `typing.dict` to type hint instead.
+* ⚠️ [#1602](https://github.com/stripe/stripe-python/pull/1602) Move `V2.Event` API resources to `V2.Core.Events`
   - ⚠️ Move `stripe.v2._event` and `stripe.v2._event_destination` to `stripe.v2.core._event` and `stripe.v2.core._event_destination` respectively. They now correctly match their API path
-* [#1589](https://github.com/stripe/stripe-python/pull/1589) Add `StripeContext` object
-  - Add the `StripeContext` class. Previously, one could only pass a string for `stripe_context`. You can now use the new class as well.
-  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
-* [#1565](https://github.com/stripe/stripe-python/pull/1565) ⚠️ Build SDK w/ V2 OpenAPI spec
-  - ⚠️ The delete methods for v2 APIs (the ones in the `StripeClient.v2` namespace) now return a `V2DeletedObject` which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
-  - ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Dict[str, Any]`. Because there were no params, it's unlikely you were using these classes.
-* [#1569](https://github.com/stripe/stripe-python/pull/1569) Renamed Urllib2Client to UrllibClient
-  - ⚠️ Rename `http_client.Urllib2Client` to `http_client.UrllibClient` as Python `urllib2` was renamed to `urllib` in Python 3.
-* [#1606](https://github.com/stripe/stripe-python/pull/1606) ⚠️ drop support for Python 3.6 & clarify version policy
-  - Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=python#stripe-sdk-language-version-support-policy)
-      - ⚠️ In this release, we drop support for Python 3.6
-      - Support for Python 3.7 is deprecated and will be removed in the next scheduled major release (March 2026)
-* [#1596](https://github.com/stripe/stripe-python/pull/1596) ⚠️ Unify resource and service method parameters into one class
-  * ⚠️ Resource and service request parameter types have been moved to the top-level and are shared, prepended with their related resource/service
-    * For example, `_stripe._account.Account.CreateParams` and `_stripe._account_service.CreateParams` have moved to `_stripe.params._account_create_params.AccountCreateParams`
-    * This change only affects users who explicitly refer to params types. No migration is necessary for users otherwise
-* [#1572](https://github.com/stripe/stripe-python/pull/1572) migrate from `setup.py` to `pyproject.toml`
-  - ⚠️ The package has swapped from `setup.py` to `pyproject.toml`. As a result, we're dropping support for `pip < 10.0.0` (released April 2018).
-  - Additionally, we're no longer shipping tests or examples in our sdist now, which should offer a small size reduction for the package if installed without the wheel (approx. 2.5MB unzipped)
-* [#1570](https://github.com/stripe/stripe-python/pull/1570) Don't use mutable default arguments
-  - Service methods now correctly set `None` as the default function argument instead of `{}`
-* ⚠️ Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our [last release](https://github.com/stripe/stripe-python/releases/tag/v12.5.0). Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
-  ```diff
-  client = StripeClient("sk_test...")
-
-  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
-  - client.customers.list()
-  + client.v1.customers.list()
-  ```
-  Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
-* [#1603](https://github.com/stripe/stripe-python/pull/1603) ⚠️ Remove deprecated compatibility exports
+* ⚠️ [#1603](https://github.com/stripe/stripe-python/pull/1603) Remove deprecated compatibility exports
   - ⚠️ Removed deprecated module shims. They've long been available in the `stripe` module directly; now that's the only place to import them. Specifically, we removed:
     - `stripe.stripe_response`
     - `stripe.stripe_object`
@@ -632,8 +617,24 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
 
   - ⚠️ Removed the `io` import from `stripe._util`. If you had code relying on `stripe.util.io`, you'll need to import the `io` package directly yourself.
   - added `UrllibClient` to `stripe` to make creating your own HTTP client easier.
+* ⚠️ Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our [last release](https://github.com/stripe/stripe-python/releases/tag/v12.5.0). Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
+  ```diff
+  client = StripeClient("sk_test...")
 
-* [#1567](https://github.com/stripe/stripe-python/pull/1567), [#1593](https://github.com/stripe/stripe-python/pull/1593), [#1607](https://github.com/stripe/stripe-python/pull/1607), [#1605](https://github.com/stripe/stripe-python/pull/1605) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
+  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
+  - client.customers.list()
+  + client.v1.customers.list()
+  ```
+  Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
+* ⚠️ [#1606](https://github.com/stripe/stripe-python/pull/1606) drop support for Python 3.6 & clarify version policy
+  - Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=python#stripe-sdk-language-version-support-policy)
+      - ⚠️ In this release, we drop support for Python 3.6
+      - Support for Python 3.7 is deprecated and will be removed in the next scheduled major release (March 2026)
+* ⚠️ [#1596](https://github.com/stripe/stripe-python/pull/1596) Unify resource and service method parameters into one class
+  * ⚠️ Resource and service request parameter types have been moved to the top-level and are shared, prepended with their related resource/service
+    * For example, `_stripe._account.Account.CreateParams` and `_stripe._account_service.CreateParams` have moved to `_stripe.params._account_create_params.AccountCreateParams`
+    * This change only affects users who explicitly refer to params types. No migration is necessary for users otherwise
+* ⚠️ [#1567](https://github.com/stripe/stripe-python/pull/1567) , [#1593](https://github.com/stripe/stripe-python/pull/1593), [#1607](https://github.com/stripe/stripe-python/pull/1607), [#1605](https://github.com/stripe/stripe-python/pull/1605) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
   * ⚠️ Remove support for `balance_report` and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
   * ⚠️ Remove support for values `saturday` and `sunday` from enums `Account.CreateParamsSettingPayoutSchedule.weekly_payout_days`, `Account.ModifyParamsSettingPayoutSchedule.weekly_payout_days`, and `Account.Setting.Payout.Schedule.weekly_payout_days`
   * ⚠️ Remove support for `iterations` on `Invoice.CreatePreviewParamsScheduleDetailPhase`, `SubscriptionSchedule.CreateParamsPhase`, and `SubscriptionSchedule.ModifyParamsPhase`
@@ -675,14 +676,26 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `2025-09-30.clover` on enum `WebhookEndpoint.CreateParams.api_version`
   * Add support for error codes `financial_connections_account_pending_account_numbers` and `financial_connections_account_unavailable_account_numbers` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
 
-
-## 12.5.1 - 2025-09-05
+## <a id="12-5-1"></a>12.5.1 - 2025-09-05
 * [#1563](https://github.com/stripe/stripe-python/pull/1563) fix: Paginate backwards if `starting_after == None`
   * Addresses an [issue](https://github.com/stripe/stripe-python/issues/1562) where List iteration would be forwards when `starting_after` was set to `None` but backwards if it was not set at all. Now, it will paginate backwards in both cases.
 
-## 12.5.0 - 2025-08-27
+## <a id="12-5-0"></a>12.5.0 - 2025-08-27
+This release changes the pinned API version to `2025-08-27.basil`.
+
+* [#1549](https://github.com/stripe/stripe-python/pull/1549) Introduce V1 namespaces in StripeClient
+  - All the top level non-namespaced services under StripeClient services(eg. customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major release and will be removed in a future release. Eg.
+  ```diff
+  client = StripeClient("sk_test...")
+
+  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
+  - client.customers.list()
+  + client.v1.customers.list()
+  ```
+  Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
 * [#1554](https://github.com/stripe/stripe-python/pull/1554) Add section on private preview SDKs in readme
-* [#1544](https://github.com/stripe/stripe-python/pull/1544) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+* [#1553](https://github.com/stripe/stripe-python/pull/1553) Import available http libraries more efficiently
+* [#1544](https://github.com/stripe/stripe-python/pull/1544) Update generated code.
   * Add support for `balance_report`, `payout_details`, and `payout_reconciliation_report` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
   * Add support for `name` on `BillingPortal.Configuration`, `billing_portal.Configuration.CreateParams`, and `billing_portal.Configuration.ModifyParams`
   * Add support for `installments` on `Charge.PaymentMethodDetail.Alma`
@@ -701,21 +714,11 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `card` on enum `terminal.Reader.PresentPaymentMethodParams.type`
   * Add support for new value `2025-08-27.basil` on enum `WebhookEndpoint.CreateParams.api_version`
   * Add support for error codes `customer_session_expired` and `india_recurring_payment_mandate_canceled` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1553](https://github.com/stripe/stripe-python/pull/1553) Import available http libraries more efficiently
-* [#1549](https://github.com/stripe/stripe-python/pull/1549) Introduce V1 namespaces in StripeClient
-  - All the top level non-namespaced services under StripeClient services(eg. customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major release and will be removed in a future release. Eg.
-  ```diff
-  client = StripeClient("sk_test...")
-
-  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
-  - client.customers.list()
-  + client.v1.customers.list()
-  ```
-  Refer to the [migration guide](https://github.com/stripe/stripe-python/wiki/v1-namespace-in-StripeClient) for help upgrading.
 
-## 12.4.0 - 2025-07-30
+## <a id="12-4-0"></a>12.4.0 - 2025-07-30
 This release changes the pinned API version to `2025-07-30.basil`.
 
+* [#1537](https://github.com/stripe/stripe-python/pull/1537) Fix timeout type hint in RequestsClient
 * [#1541](https://github.com/stripe/stripe-python/pull/1541) Update generated code
   * Add support for `instant_payouts_promotion` on `AccountSession.Component` and `AccountSession.CreateParamsComponent`
   * Add support for `adjustable_quantity` on `BillingPortal.Configuration.Feature.SubscriptionUpdate.Product`, `billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct`, and `billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProduct`
@@ -736,11 +739,11 @@ This release changes the pinned API version to `2025-07-30.basil`.
   * Add support for new value `inbound_goods` on enums `Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme`, `Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme`, `tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme`, and `tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_scheme`
   * Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal.Configuration.Tipping`, `terminal.Configuration.CreateParamsTipping`, and `terminal.Configuration.ModifyParamsTipping`
   * Add support for new value `2025-07-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
-* [#1537](https://github.com/stripe/stripe-python/pull/1537) Fix timeout type hint in RequestsClient
 
-## 12.3.0 - 2025-07-01
+## <a id="12-3-0"></a>12.3.0 - 2025-07-01
 This release changes the pinned API version to `2025-06-30.basil`.
 
+* [#1534](https://github.com/stripe/stripe-python/pull/1534) Fix the link to releases page from readme
 * [#1526](https://github.com/stripe/stripe-python/pull/1526) Update generated code
   * Add support for `migrate` method on resource `Subscription`
   * Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `terminal.Reader`
@@ -775,11 +778,11 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for new value `terminal.reader.action_updated` on enums `WebhookEndpoint.CreateParams.enabled_events` and `WebhookEndpoint.ModifyParams.enabled_events`
   * Add support for new value `2025-06-30.basil` on enum `WebhookEndpoint.CreateParams.api_version`
   * Add support for snapshot event `terminal.reader.action_updated` with resource `terminal.Reader`
-* [#1534](https://github.com/stripe/stripe-python/pull/1534) Fix the link to releases page from readme
 
-## 12.2.0 - 2025-05-29
- This release changes the pinned API version to `2025-05-28.basil`.
+## <a id="12-2-0"></a>12.2.0 - 2025-05-29
+This release changes the pinned API version to `2025-05-28.basil`.
 
+* [#1511](https://github.com/stripe/stripe-python/pull/1511) Adds CONTRIBUTING.md
 * [#1517](https://github.com/stripe/stripe-python/pull/1517) Update generated code
   * Add support for `attach_payment` method on resource `Invoice`
   * Add support for `collect_inputs` method on resource `terminal.Reader`
@@ -811,10 +814,8 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for new value `2025-05-28.basil` on enum `WebhookEndpoint.CreateParams.api_version`
   * Add support for snapshot event `invoice_payment.paid` with resource `InvoicePayment`
   * Add support for error code `forwarding_api_upstream_error` on `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, `SetupIntent.LastSetupError`, and `StripeError`
-* [#1511](https://github.com/stripe/stripe-python/pull/1511) Adds CONTRIBUTING.md
-
-## 12.1.0 - 2025-04-30
 
+## <a id="12-1-0"></a>12.1.0 - 2025-04-30
 This release changes the pinned API version to `2025-04-30.basil`.
 
 * [#1496](https://github.com/stripe/stripe-python/pull/1496) Update generated code
@@ -841,15 +842,16 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `Tax.Registration.CountryOption`, `tax.Registration.CreateParamsCountryOption`, and `tax.RegistrationService.CreateParamsCountryOption`
   * Add support for new value `2025-04-30.basil` on enums `WebhookEndpoint.CreateParams.api_version` and `WebhookEndpointService.CreateParams.api_version`
 
-## 12.0.1 - 2025-04-21
+## <a id="12-0-1"></a>12.0.1 - 2025-04-21
+* [#1493](https://github.com/stripe/stripe-python/pull/1493) Update readme with clarification on resource based call patterns
+* [#1401](https://github.com/stripe/stripe-python/pull/1401) Fix type hint for SearchResultObject.data
 * [#1499](https://github.com/stripe/stripe-python/pull/1499) Encode bools with lower case
   - Serializes boolean query parameter values to `true`/`false` (lower case) before sending to the Stripe API for compatibility with Stripe V2 endpoints
-* [#1401](https://github.com/stripe/stripe-python/pull/1401) Fix type hint for SearchResultObject.data
-* [#1493](https://github.com/stripe/stripe-python/pull/1493) Update readme with clarification on resource based call patterns
 
-## 12.0.0 - 2025-04-01
-* [#1463](https://github.com/stripe/stripe-python/pull/1463) Support for APIs in the new API version 2025-03-31.basil
+## <a id="12-0-0"></a>12.0.0 - 2025-04-01
+This release changes the pinned API version to `2025-03-31.basil`.
 
+* [#1463](https://github.com/stripe/stripe-python/pull/1463) Support for APIs in the new API version 2025-03-31.basil
   This release changes the pinned API version to `2025-03-31.basil`.
 
   ### ⚠️ Breaking changes  due to changes in the Stripe API
@@ -938,30 +940,29 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for new values `2025-03-01.dashboard` and `2025-03-31.basil` on enum `WebhookEndpoint.CreateParams.api_version`
 
 ### ⚠️ Other Breaking changes in the SDK
-* [#1474](https://github.com/stripe/stripe-python/pull/1474) Rename `StripeStreamResponseAsync`'s `.read()` to `read_async()` for consistency
+* ⚠️ [#1471](https://github.com/stripe/stripe-python/pull/1471) Fix incorrect property name on `ThinEvent.related_object.type`
+  * Rename `ThinEvent.related_object.type_` to `ThinEvent.related_object.type`
+    * This was an unintentional typo before. The property name now correctly matches the value you get back from the API
+* ⚠️ [#1474](https://github.com/stripe/stripe-python/pull/1474) Rename `StripeStreamResponseAsync`'s `.read()` to `read_async()` for consistency
   * Rename `StripeStreamResponseAsync.read()` to `.read_async()`
     * This brings the method name in line with the conventions used by every other async method in the package, ensuring consistent `async` usage.
     * You'll need to update your code if you call `Quote.pdf_async().read()` method. A typechecker will alert you to this change.
-* [#1471](https://github.com/stripe/stripe-python/pull/1471) Fix incorrect property name on `ThinEvent.related_object.type`
-  * Rename `ThinEvent.related_object.type_` to `ThinEvent.related_object.type`
-    * This was an unintentional typo before. The property name now correctly matches the value you get back from the API
 
-## 11.6.0 - 2025-02-24
-* [#1450](https://github.com/stripe/stripe-python/pull/1450) Update generated code
-  * Add support for `target_date` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccount`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSepaDebit`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsUsBankAccount` and resource classes `stripe.PaymentIntent.PaymentMethodOptions.AcssDebit`, `stripe.PaymentIntent.PaymentMethodOptions.AuBecsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.BacsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.SepaDebit`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount`, `stripe.checkout.Session.PaymentMethodOptions.AcssDebit`, `stripe.checkout.Session.PaymentMethodOptions.AuBecsDebit`, `stripe.checkout.Session.PaymentMethodOptions.BacsDebit`, `stripe.checkout.Session.PaymentMethodOptions.SepaDebit`, and `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount`
-  * Add support for `metadata` on parameter class `stripe.Product.CreateParamsDefaultPriceData`
-  * Add support for `prices` on parameter classes `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` and resource class `stripe.billing.CreditGrant.ApplicabilityConfig.Scope`
-  * Add support for `priority` on parameter class `stripe.billing.CreditGrant.CreateParams` and resource `stripe.billing.CreditGrant`
-  * Add support for `restrictions` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptionsCard` and resource class `stripe.checkout.Session.PaymentMethodOptions.Card`
-  * Add support for `collected_information` on parameter class `stripe.checkout.Session.ModifyParams` and resource `stripe.checkout.Session`
-  * Change type of `price_type` on  `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` from `Literal['metered']` to `NotRequired[Literal['metered']]`
-  * Change type of `price_type` on  `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` from `Literal['metered']` to `Optional[Literal['metered']]`
-  * Add support for `2025-02-24.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
-* [#1461](https://github.com/stripe/stripe-python/pull/1461) Remove incorrect changelog entry about parse_snapshot_event
-* [#1457](https://github.com/stripe/stripe-python/pull/1457) add codeowners file
-* [#1456](https://github.com/stripe/stripe-python/pull/1456) upgrade ruff version
+## <a id="11-6-0"></a>11.6.0 - 2025-02-24
+This release changes the pinned API version to `2025-02-24.acacia`.
+
+* [#1442](https://github.com/stripe/stripe-python/pull/1442) Fix V2 ListObject.data type hint
+  - Change `stripe.v2.ListObject.data` type hint from `List[StripeObject]` to `List[T]` where T is the specific stripe object contained within the list
+* [#1440](https://github.com/stripe/stripe-python/pull/1440) add justfile, update readme, remove coveralls
+* [#1445](https://github.com/stripe/stripe-python/pull/1445) minor justfile fixes & pin CI version
+* [#1444](https://github.com/stripe/stripe-python/pull/1444) Added CONTRIBUTING.md file
+* [#1446](https://github.com/stripe/stripe-python/pull/1446) add just to publish CI
+* [#1448](https://github.com/stripe/stripe-python/pull/1448) Updated upload artifact ci action
 * [#1452](https://github.com/stripe/stripe-python/pull/1452) Revert "Bump version to 11.5.0"
 * [#1451](https://github.com/stripe/stripe-python/pull/1451) Upgrade to download-artifact@v4
+* [#1457](https://github.com/stripe/stripe-python/pull/1457) add codeowners file
+* [#1456](https://github.com/stripe/stripe-python/pull/1456) upgrade ruff version
+* [#1461](https://github.com/stripe/stripe-python/pull/1461) Remove incorrect changelog entry about parse_snapshot_event
 * [#1443](https://github.com/stripe/stripe-python/pull/1443) Update generated code
   * Add support for `pay_by_bank_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
   * Add support for `directorship_declaration` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
@@ -988,15 +989,28 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `outbound_transfer` on enums `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails.type` and `stripe.treasury.ReceivedCredit.ListParamsLinkedFlows.source_flow_type`
   * Add support for `2025-01-27.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
   * Change type of `pretax_credit_amounts` on  `stripe.CreditNote` and `stripe.CreditNoteLineItem` from `Optional[List[PretaxCreditAmount]]` to `List[PretaxCreditAmount]`
-* [#1448](https://github.com/stripe/stripe-python/pull/1448) Updated upload artifact ci action
-* [#1446](https://github.com/stripe/stripe-python/pull/1446) add just to publish CI
-* [#1444](https://github.com/stripe/stripe-python/pull/1444) Added CONTRIBUTING.md file
-* [#1445](https://github.com/stripe/stripe-python/pull/1445) minor justfile fixes & pin CI version
-* [#1440](https://github.com/stripe/stripe-python/pull/1440) add justfile, update readme, remove coveralls
+* [#1450](https://github.com/stripe/stripe-python/pull/1450) Update generated code
+  * Add support for `target_date` on parameter classes `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccount`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAcssDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsAuBecsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsBacsDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsSepaDebit`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccount`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAcssDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsAuBecsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsBacsDebit`, `stripe.checkout.Session.CreateParamsPaymentMethodOptionsSepaDebit`, and `stripe.checkout.Session.CreateParamsPaymentMethodOptionsUsBankAccount` and resource classes `stripe.PaymentIntent.PaymentMethodOptions.AcssDebit`, `stripe.PaymentIntent.PaymentMethodOptions.AuBecsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.BacsDebit`, `stripe.PaymentIntent.PaymentMethodOptions.SepaDebit`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount`, `stripe.checkout.Session.PaymentMethodOptions.AcssDebit`, `stripe.checkout.Session.PaymentMethodOptions.AuBecsDebit`, `stripe.checkout.Session.PaymentMethodOptions.BacsDebit`, `stripe.checkout.Session.PaymentMethodOptions.SepaDebit`, and `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount`
+  * Add support for `metadata` on parameter class `stripe.Product.CreateParamsDefaultPriceData`
+  * Add support for `prices` on parameter classes `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` and resource class `stripe.billing.CreditGrant.ApplicabilityConfig.Scope`
+  * Add support for `priority` on parameter class `stripe.billing.CreditGrant.CreateParams` and resource `stripe.billing.CreditGrant`
+  * Add support for `restrictions` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptionsCard` and resource class `stripe.checkout.Session.PaymentMethodOptions.Card`
+  * Add support for `collected_information` on parameter class `stripe.checkout.Session.ModifyParams` and resource `stripe.checkout.Session`
+  * Change type of `price_type` on  `stripe.billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope` and `stripe.billing.CreditGrant.CreateParamsApplicabilityConfigScope` from `Literal['metered']` to `NotRequired[Literal['metered']]`
+  * Change type of `price_type` on  `stripe.billing.CreditGrant.ApplicabilityConfig.Scope` from `Literal['metered']` to `Optional[Literal['metered']]`
+  * Add support for `2025-02-24.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
+
+## <a id="11-5-0"></a>11.5.0 - 2025-01-27
+This release changes the pinned API version to `2025-01-27.acacia`.
+
 * [#1442](https://github.com/stripe/stripe-python/pull/1442) Fix V2 ListObject.data type hint
   - Change `stripe.v2.ListObject.data` type hint from `List[StripeObject]` to `List[T]` where T is the specific stripe object contained within the list
-
-## 11.5.0 - 2025-01-27
+* [#1440](https://github.com/stripe/stripe-python/pull/1440) add justfile, update readme, remove coveralls
+* [#1445](https://github.com/stripe/stripe-python/pull/1445) minor justfile fixes & pin CI version
+* [#1444](https://github.com/stripe/stripe-python/pull/1444) Added CONTRIBUTING.md file
+* [#1446](https://github.com/stripe/stripe-python/pull/1446) add just to publish CI
+* [#1448](https://github.com/stripe/stripe-python/pull/1448) Updated upload artifact ci action
+* [#1451](https://github.com/stripe/stripe-python/pull/1451) Upgrade to download-artifact@v4
 * [#1443](https://github.com/stripe/stripe-python/pull/1443) Update generated code
   * Add support for `pay_by_bank_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
   * Add support for `directorship_declaration` on resource class `stripe.Account.Company` and parameter classes `stripe.Account.CreateParamsCompany` and `stripe.Token.CreateParamsAccountCompany`
@@ -1023,20 +1037,18 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `outbound_transfer` on enums `stripe.treasury.ReceivedCredit.LinkedFlows.SourceFlowDetails.type` and `stripe.treasury.ReceivedCredit.ListParamsLinkedFlows.source_flow_type`
   * Add support for `2025-01-27.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
   * Change type of `pretax_credit_amounts` on  `stripe.CreditNote` and `stripe.CreditNoteLineItem` from `Optional[List[PretaxCreditAmount]]` to `List[PretaxCreditAmount]`
-* [#1451](https://github.com/stripe/stripe-python/pull/1451) Upgrade to download-artifact@v4
-* [#1448](https://github.com/stripe/stripe-python/pull/1448) Updated upload artifact ci action
-* [#1446](https://github.com/stripe/stripe-python/pull/1446) add just to publish CI
-* [#1444](https://github.com/stripe/stripe-python/pull/1444) Added CONTRIBUTING.md file
-* [#1445](https://github.com/stripe/stripe-python/pull/1445) minor justfile fixes & pin CI version
-* [#1440](https://github.com/stripe/stripe-python/pull/1440) add justfile, update readme, remove coveralls
-* [#1442](https://github.com/stripe/stripe-python/pull/1442) Fix V2 ListObject.data type hint
-  - Change `stripe.v2.ListObject.data` type hint from `List[StripeObject]` to `List[T]` where T is the specific stripe object contained within the list
 
-## 11.4.1 - 2024-12-19
+## <a id="11-4-1"></a>11.4.1 - 2024-12-19
 * [#1438](https://github.com/stripe/stripe-python/pull/1438) Fix regression when using httpx HTTP client
 
-## 11.4.0 - 2024-12-18
-* [#1430](https://github.com/stripe/stripe-python/pull/1430) This release changes the pinned API version to `2024-12-18.acacia`.
+## <a id="11-4-0"></a>11.4.0 - 2024-12-18
+This release changes the pinned API version to `2024-12-18.acacia`.
+
+* [#1431](https://github.com/stripe/stripe-python/pull/1431) fix deprecation warning in httpx @ 0.28
+* [#1435](https://github.com/stripe/stripe-python/pull/1435) Fix StripeError http_body
+  - Fixes an issue where `StripeError.http_body` may be None even when `json_body` is a valid dictionary.
+* [#1434](https://github.com/stripe/stripe-python/pull/1434) Fix using `auto_paging_iter()` with `expand: [...]`
+* [#1430](https://github.com/stripe/stripe-python/pull/1430) Update generated code
   * Add support for `allow_redisplay` on resources `stripe.Card` and `stripe.Source`
   * Add support for `regulated_status` on resource `stripe.Card` and resource classes `stripe.Charge.PaymentMethodDetails.Card`, `stripe.ConfirmationToken.PaymentMethodPreview.Card`, and `stripe.PaymentMethod.Card`
   * Add support for `network_advice_code` on resource classes `stripe.Charge.Outcome`, `stripe.Invoice.LastFinalizationError`, `stripe.PaymentIntent.LastPaymentError`, `stripe.SetupAttempt.SetupError`, and `stripe.SetupIntent.LastSetupError`
@@ -1098,13 +1110,11 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `request_signature` on enums `stripe.forwarding.Request.replacements` and `stripe.forwarding.Request.CreateParams.replacements`
   * Add support for `2024-12-18.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
   * Change type of `schedule_at_period_end` on  `stripe.billing_portal.Configuration.Features.SubscriptionUpdate` from `Optional[ScheduleAtPeriodEnd]` to `ScheduleAtPeriodEnd`
-* [#1434](https://github.com/stripe/stripe-python/pull/1434) Fix using `auto_paging_iter()` with `expand: [...]`
-* [#1435](https://github.com/stripe/stripe-python/pull/1435) Fix StripeError http_body
-  - Fixes an issue where `StripeError.http_body` may be None even when `json_body` is a valid dictionary.
-* [#1431](https://github.com/stripe/stripe-python/pull/1431) fix deprecation warning in httpx @ 0.28
 
-## 11.3.0 - 2024-11-20
-* [#1424](https://github.com/stripe/stripe-python/pull/1424) This release changes the pinned API version to `2024-11-20.acacia`.
+## <a id="11-3-0"></a>11.3.0 - 2024-11-20
+This release changes the pinned API version to `2024-11-20.acacia`.
+
+* [#1424](https://github.com/stripe/stripe-python/pull/1424) Update generated code
   * Add support for `authorizer` on parameter classes `stripe.Account.CreatePersonParamsRelationship`, `stripe.Account.ListPersonsParamsRelationship`, `stripe.Account.ModifyPersonParamsRelationship`, `stripe.Account.PersonsParamsRelationship`, and `stripe.Token.CreateParamsPersonRelationship` and resource class `stripe.Person.Relationship`
   * Add support for `account_holder_address`, `account_holder_name`, `account_type` and `bank_address` on resource classes `stripe.FundingInstructions.BankTransfer.FinancialAddress.Aba`, `stripe.FundingInstructions.BankTransfer.FinancialAddress.Swift`, `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Aba`, and `stripe.PaymentIntent.NextAction.DisplayBankTransferInstructions.FinancialAddress.Swift`
   * Add support for `submit_type` on parameter class `stripe.PaymentLink.ModifyParams`
@@ -1127,8 +1137,10 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `amount` on  `stripe.issuing.Authorization.CreateParams` from `int` to `NotRequired[int]`
   * Change type of `origin_payment_method` on  `stripe.treasury.InboundTransfer` from `str` to `Optional[str]`
 
-## 11.2.0 - 2024-10-29
-* [#1411](https://github.com/stripe/stripe-python/pull/1411) This release changes the pinned API version to `2024-10-28.acacia`.
+## <a id="11-2-0"></a>11.2.0 - 2024-10-29
+This release changes the pinned API version to `2024-10-28.acacia`.
+
+* [#1411](https://github.com/stripe/stripe-python/pull/1411) Update generated code
   * Add support for resource `stripe.v2.EventDestinations`
   * Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
   * Add support for `alma_payments`, `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, `samsung_pay_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
@@ -1161,22 +1173,22 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `state_retail_delivery_fee` on enums `stripe.tax.Registration.CountryOptions.Us.type` and `stripe.tax.Registration.CreateParamsCountryOptionsUs.type`
   * Add support for `2024-10-28.acacia` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
 
-## 11.1.1 - 2024-10-18
+## <a id="11-1-1"></a>11.1.1 - 2024-10-18
+* [#1412](https://github.com/stripe/stripe-python/pull/1412) Clean up examples
 * [#1414](https://github.com/stripe/stripe-python/pull/1414) Deserialize into correct v2 EventData types
   * Fixes a bug where v2 EventData was not being deserialized into the appropriate type for `V1BillingMeterErrorReportTriggeredEvent` and `V1BillingMeterNoMeterFoundEvent`
 * [#1415](https://github.com/stripe/stripe-python/pull/1415) update object tags for meter-related classes
-
   - fixes a bug where the `object` property of the `MeterEvent`, `MeterEventAdjustment`, and `MeterEventSession` didn't match the server.
-* [#1412](https://github.com/stripe/stripe-python/pull/1412) Clean up examples
 
-## 11.1.0 - 2024-10-03
+## <a id="11-1-0"></a>11.1.0 - 2024-10-03
 * [#1409](https://github.com/stripe/stripe-python/pull/1409) Update the class for `ThinEvent` to include `livemode`
 * [#1408](https://github.com/stripe/stripe-python/pull/1408) Update generated code
   * Remove the support for resource `Margin` that was accidentally made public in the last release
 
-## 11.0.0 - 2024-10-01
-* [#1404](https://github.com/stripe/stripe-python/pull/1404) Support for APIs in the new API version 2024-09-30.acacia
+## <a id="11-0-0"></a>11.0.0 - 2024-10-01
+This release changes the pinned API version to `2024-09-30.acacia`.
 
+* [#1404](https://github.com/stripe/stripe-python/pull/1404) Support for APIs in the new API version 2024-09-30.acacia
   This release changes the pinned API version to `2024-09-30.acacia`. Please read the [API Changelog](https://docs.stripe.com/changelog/acacia#2024-09-30.acacia) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes due to changes in the API
@@ -1206,8 +1218,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `default_allowed_updates` on  `stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate` from `Union[Literal[''], List[Literal['price', 'promotion_code', 'quantity']]]` to `NotRequired[Literal['']|List[Literal['price', 'promotion_code', 'quantity']]]`
   * Change type of `products` on  `stripe.billing_portal.Configuration.CreateParamsFeaturesSubscriptionUpdate` from `Union[Literal[''], List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]]` to `NotRequired[Literal['']|List[Configuration.CreateParamsFeaturesSubscriptionUpdateProduct]]`
 
-
-## 10.12.0 - 2024-09-18
+## <a id="10-12-0"></a>10.12.0 - 2024-09-18
 * [#1394](https://github.com/stripe/stripe-python/pull/1394) Update generated code
   * Add support for `international_transaction` on enum `stripe.treasury.ReceivedDebit.failure_code`
 * [#1393](https://github.com/stripe/stripe-python/pull/1393) Update generated code
@@ -1219,7 +1230,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `amazon_pay` on enum `stripe.Dispute.PaymentMethodDetails.type`
   * Add support for `terminal_reader_invalid_location_for_activation` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
 
-## 10.11.0 - 2024-09-12
+## <a id="10-11-0"></a>10.11.0 - 2024-09-12
 * [#1391](https://github.com/stripe/stripe-python/pull/1391) Update generated code
   * Add support for `template` on parameter classes `stripe.Customer.CreateParamsInvoiceSettingsRenderingOptions`, `stripe.Customer.ModifyParamsInvoiceSettingsRenderingOptions`, `stripe.Invoice.CreateParamsRendering`, and `stripe.Invoice.ModifyParamsRendering` and resource classes `stripe.Customer.InvoiceSettings.RenderingOptions` and `stripe.Invoice.Rendering`
   * Add support for resource `stripe.InvoiceRenderingTemplate`
@@ -1229,19 +1240,19 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `tax_rates` on  `stripe.InvoiceLineItem` from `Optional[List[TaxRate]]` to `List[TaxRate]`
   * Change type of `status_details` on  `stripe.test_helpers.TestClock` from `Optional[StatusDetails]` to `StatusDetails`
 
-## 10.10.0 - 2024-09-05
+## <a id="10-10-0"></a>10.10.0 - 2024-09-05
 * [#1376](https://github.com/stripe/stripe-python/pull/1376) Update generated code
   * Add support for `subscription` on parameter class `stripe.billing.Alert.CreateParamsFilter`
   * Change type of `customer_consent_collected` on  `stripe.terminal.Reader.ProcessSetupIntentParams` from `bool` to `NotRequired[bool]`
 
-## 10.9.0 - 2024-08-29
+## <a id="10-9-0"></a>10.9.0 - 2024-08-29
 * [#1385](https://github.com/stripe/stripe-python/pull/1385) Generate SDK for OpenAPI spec version 1230
   * Add support for `status_details` on resource `stripe.test_helpers.TestClock`
   * Change type of `fields` on  `stripe.AccountLink.CreateParamsCollectionOptions` from `Literal['currently_due', 'eventually_due']` to `NotRequired[Literal['currently_due', 'eventually_due']]`
   * Add support for `hr_oib` on enums `stripe.checkout.Session.CustomerDetails.TaxId.type`, `stripe.Customer.CreateParamsTaxIdDatum.type`, `stripe.Customer.CreateTaxIdParams.type`, `stripe.Invoice.CustomerTaxId.type`, `stripe.Invoice.CreatePreviewParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type`, `stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type`, `stripe.tax.Calculation.CustomerDetails.TaxId.type`, `stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type`, `stripe.tax.Transaction.CustomerDetails.TaxId.type`, `stripe.TaxId.type`, and `stripe.TaxId.CreateParams.type`
   * Add support for `issuing_regulatory_reporting` on enums `stripe.File.purpose`, `stripe.File.CreateParams.purpose`, and `stripe.File.ListParams.purpose`
 
-## 10.8.0 - 2024-08-15
+## <a id="10-8-0"></a>10.8.0 - 2024-08-15
 * [#1373](https://github.com/stripe/stripe-python/pull/1373) Update generated code
   * Add support for `authorization_code` on resource class `stripe.Charge.PaymentMethodDetails.Card`
   * Add support for `wallet` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent`, `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent`, and `stripe.PaymentMethod.CardPresent`
@@ -1250,7 +1261,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `chips` on resource classes `stripe.treasury.OutboundPayment.TrackingDetails.UsDomesticWire` and `stripe.treasury.OutboundTransfer.TrackingDetails.UsDomesticWire` and parameter classes `stripe.treasury.OutboundPayment.UpdateParamsTrackingDetailsUsDomesticWire` and `stripe.treasury.OutboundTransfer.UpdateParamsTrackingDetailsUsDomesticWire`
   * Change type of `imad` on  `stripe.treasury.OutboundPayment.TrackingDetails.UsDomesticWire` and `stripe.treasury.OutboundTransfer.TrackingDetails.UsDomesticWire` from `str` to `Optional[str]`
 
-## 10.7.0 - 2024-08-08
+## <a id="10-7-0"></a>10.7.0 - 2024-08-08
 * [#1371](https://github.com/stripe/stripe-python/pull/1371) Update generated code
   * Add support for `type` on resource classes `stripe.Charge.PaymentMethodDetails.CardPresent.Offline`, `stripe.ConfirmationToken.PaymentMethodPreview.Card.GeneratedFrom.PaymentMethodDetails.CardPresent.Offline`, `stripe.PaymentMethod.Card.GeneratedFrom.PaymentMethodDetails.CardPresent.Offline`, and `stripe.SetupAttempt.PaymentMethodDetails.CardPresent.Offline`
   * Add support for `offline` on resource classes `stripe.ConfirmationToken.PaymentMethodPreview.CardPresent` and `stripe.PaymentMethod.CardPresent`
@@ -1271,14 +1282,14 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `interval` on  `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsCardInstallmentsPlan`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsCardInstallmentsPlan`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsCardInstallmentsPlan` from `Literal['month']` to `NotRequired[Literal['month']]`
   * Change type of `account` on  `stripe.Person.AdditionalTosAcceptances` from `Account` to `Optional[Account]`
 
-## 10.6.0 - 2024-08-01
-* [#1369](https://github.com/stripe/stripe-python/pull/1369) Update generated code
+## <a id="10-6-0"></a>10.6.0 - 2024-08-01
+* ⚠️ [#1369](https://github.com/stripe/stripe-python/pull/1369) Update generated code
   * Add support for resource `stripe.billing.Alert`
   * ⚠️ Remove support for `authorization_code` on resource class `stripe.Charge.PaymentMethodDetails.Card`. This was accidentally released last week.
   * Add support for `billing.alert.triggered` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
   * Add support for `charge_exceeds_transaction_limit` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
 
-## 10.5.0 - 2024-07-25
+## <a id="10-5-0"></a>10.5.0 - 2024-07-25
 * [#1368](https://github.com/stripe/stripe-python/pull/1368) Update generated code
   * Add support for `tax_registrations` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
   * Add support for `tax_settings` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
@@ -1294,16 +1305,16 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `invoice.overdue` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
   * Add support for `invoice.will_be_due` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
 
-## 10.4.0 - 2024-07-18
+## <a id="10-4-0"></a>10.4.0 - 2024-07-18
+* [#1360](https://github.com/stripe/stripe-python/pull/1360) Update changelog
 * [#1362](https://github.com/stripe/stripe-python/pull/1362) Update generated code
   * Add support for `customer` on resource class `stripe.ConfirmationToken.PaymentMethodPreview`
   * Add support for `issuing_dispute.funds_rescinded` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
   * Add support for `multibanco` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
   * Add support for `stripe_s700` on enums `stripe.terminal.Reader.device_type` and `stripe.terminal.Reader.ListParams.device_type`
-* [#1360](https://github.com/stripe/stripe-python/pull/1360) Update changelog
 
-## 10.3.0 - 2024-07-11
-* [#1358](https://github.com/stripe/stripe-python/pull/1358) Update generated code
+## <a id="10-3-0"></a>10.3.0 - 2024-07-11
+* ⚠️ [#1358](https://github.com/stripe/stripe-python/pull/1358) Update generated code
   * Add support for `payment_method_options` on resource `stripe.ConfirmationToken`
   * Add support for `payment_element` on resource class `stripe.CustomerSession.Components` and parameter class `stripe.CustomerSession.CreateParamsComponents`
   * Add support for `address_validation` on parameter class `stripe.issuing.Card.CreateParamsShipping` and resource class `stripe.issuing.Card.Shipping`
@@ -1312,13 +1323,13 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * ⚠️ Remove support for `payment_intent_fx_quote_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`. The property was mistakenly released last week.
   * [#1357](https://github.com/stripe/stripe-python/pull/1357) don't auto-organize imports
 
-## 10.2.0 - 2024-07-05
+## <a id="10-2-0"></a>10.2.0 - 2024-07-05
 * [#1354](https://github.com/stripe/stripe-python/pull/1354) Update generated code
   * Add support for `_cls_add_lines`, `_cls_remove_lines`, `_cls_update_lines`, `add_lines`, `remove_lines`, `update_lines` on resource `stripe.Invoice`
   * Add support for `posted_at` on parameter class `stripe.tax.Transaction.CreateFromCalculationParams` and resource `stripe.tax.Transaction`
   * Add support for `payment_intent_fx_quote_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
 
-## 10.1.0 - 2024-06-27
+## <a id="10-1-0"></a>10.1.0 - 2024-06-27
 * [#1353](https://github.com/stripe/stripe-python/pull/1353) Update generated code
   * Add support for `email_type` on parameter classes `stripe.CreditNote.CreateParams`, `stripe.CreditNote.PreviewLinesParams`, and `stripe.CreditNote.PreviewParams`
   * Add support for `filters` on parameter classes `stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.SetupIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections` and resource classes `stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.SetupIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections`, `stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections`, and `stripe.checkout.Session.PaymentMethodOptions.UsBankAccount.FinancialConnections`
@@ -1329,9 +1340,10 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `twint` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
   * Add support for `zip` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
 
-## 10.0.0 - 2024-06-24
-* [#1350](https://github.com/stripe/stripe-python/pull/1350) Update generated code
+## <a id="10-0-0"></a>10.0.0 - 2024-06-24
+This release changes the pinned API version to `2024-06-20`.
 
+* [#1350](https://github.com/stripe/stripe-python/pull/1350) Update generated code
   This release changes the pinned API version to 2024-06-20. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-06-20) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes
@@ -1354,12 +1366,12 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `charging_minute`, `imperial_gallon`, `kilogram`,  `kilowatt_hour`, `pound`, on enums `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel.unit`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel.unit`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel.unit`
   * Add support for `2024-06-20` on enum `stripe.WebhookEndpoint.CreateParams.api_version`
 
-## 9.12.0 - 2024-06-17
+## <a id="9-12-0"></a>9.12.0 - 2024-06-17
 * [#1348](https://github.com/stripe/stripe-python/pull/1348) Update generated code
   * Add support for `tax_id_collection` on parameter class `stripe.PaymentLink.ModifyParams`
   * Add support for `mobilepay` on enums `stripe.PaymentLink.payment_method_types`, `stripe.PaymentLink.CreateParams.payment_method_types`, and `stripe.PaymentLink.ModifyParams.payment_method_types`
 
-## 9.11.0 - 2024-06-13
+## <a id="9-11-0"></a>9.11.0 - 2024-06-13
 * [#1342](https://github.com/stripe/stripe-python/pull/1342) Update generated code
   * Add support for `multibanco_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
   * Add support for `twint_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
@@ -1371,12 +1383,12 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `multibanco` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
   * Add support for `twint` on enums `stripe.checkout.Session.CreateParams.payment_method_types`, `stripe.ConfirmationToken.PaymentMethodPreview.type`, `stripe.ConfirmationToken.CreateParamsPaymentMethodData.type`, `stripe.Customer.ListPaymentMethodsParams.type`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type`, `stripe.PaymentIntent.CreateParamsPaymentMethodData.type`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData.type`, `stripe.PaymentMethod.type`, `stripe.PaymentMethod.CreateParams.type`, `stripe.PaymentMethod.ListParams.type`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData.type`, `stripe.SetupIntent.CreateParamsPaymentMethodData.type`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData.type`
 
-## 9.10.0 - 2024-06-06
+## <a id="9-10-0"></a>9.10.0 - 2024-06-06
 * [#1340](https://github.com/stripe/stripe-python/pull/1340) Update generated code
   * Add support for `gb_bank_transfer_payments`, `jp_bank_transfer_payments`, `mx_bank_transfer_payments`, `sepa_bank_transfer_payments`, `us_bank_transfer_payments` on resource class `stripe.Account.Capabilities` and parameter class `stripe.Account.CreateParamsCapabilities`
   * Add support for `swish` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
 
-## 9.9.0 - 2024-05-30
+## <a id="9-9-0"></a>9.9.0 - 2024-05-30
 * [#1335](https://github.com/stripe/stripe-python/pull/1335) Add method to list invoice line items
   * Add methods `list_lines()` and `list_lines_async()` on the class `Invoice` to list the invoice line items
 * [#1336](https://github.com/stripe/stripe-python/pull/1336) Update generated code
@@ -1391,13 +1403,14 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `ro-RO` on enums `stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsKlarna.preferred_locale`, `stripe.PaymentIntent.CreateParamsPaymentMethodOptionsKlarna.preferred_locale`, and `stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsKlarna.preferred_locale`
   * Change type of `features` on  `stripe.issuing.PhysicalBundle` from `Optional[Features]` to `Features`
 
-## 9.8.0 - 2024-05-23
+## <a id="9-8-0"></a>9.8.0 - 2024-05-23
 * [#1332](https://github.com/stripe/stripe-python/pull/1332) Update generated code
   * Add support for `external_account_collection` on resource classes `stripe.AccountSession.Components.Balances.Features` and `stripe.AccountSession.Components.Payouts.Features` and parameter classes `stripe.AccountSession.CreateParamsComponentsBalancesFeatures` and `stripe.AccountSession.CreateParamsComponentsPayoutsFeatures`
   * Add support for `payment_method_remove` on resource class `stripe.checkout.Session.SavedPaymentMethodOptions`
   * Add support for `terminal_reader_invalid_location_for_payment` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
 
-## 9.7.0 - 2024-05-16
+## <a id="9-7-0"></a>9.7.0 - 2024-05-16
+* [#1329](https://github.com/stripe/stripe-python/pull/1329) Switch from `black` to `ruff` for formatting
 * [#1328](https://github.com/stripe/stripe-python/pull/1328) Update generated code
   * Add support for `fee_source` on resource `stripe.ApplicationFee`
   * Add support for `net_available` on resource class `stripe.Balance.InstantAvailable`
@@ -1413,9 +1426,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `klarna` on enum `stripe.Dispute.PaymentMethodDetails.type`
   * Add support for `no_valid_authorization` on enums `stripe.issuing.Dispute.Evidence.reason`, `stripe.issuing.Dispute.CreateParamsEvidence.reason`, and `stripe.issuing.Dispute.ModifyParamsEvidence.reason`
   * Change type of `countries` on  `stripe.financial_connections.Session.CreateParamsFilters` from `List[str]` to `NotRequired[List[str]]`
-* [#1329](https://github.com/stripe/stripe-python/pull/1329) Switch from `black` to `ruff` for formatting
 
-## 9.6.0 - 2024-05-09
+## <a id="9-6-0"></a>9.6.0 - 2024-05-09
 * [#1323](https://github.com/stripe/stripe-python/pull/1323) Update generated code
   * Add support for `allow_redisplay` on resource class `stripe.ConfirmationToken.PaymentMethodPreview` and resource `stripe.PaymentMethod`
   * Add support for `preview_mode` on parameter classes `stripe.Invoice.CreatePreviewParams`, `stripe.Invoice.UpcomingLinesParams`, and `stripe.Invoice.UpcomingParams`
@@ -1425,7 +1437,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `treasury.outbound_payment.tracking_details_updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
   * Add support for `treasury.outbound_transfer.tracking_details_updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
 
-## 9.5.0 - 2024-05-02
+## <a id="9-5-0"></a>9.5.0 - 2024-05-02
+* [#1319](https://github.com/stripe/stripe-python/pull/1319) Fix type change entries in Python Changelog
 * [#1317](https://github.com/stripe/stripe-python/pull/1317) Update generated code
   * Add support for `paypal` on resource class `stripe.Dispute.PaymentMethodDetails`
   * Add support for `payment_method_types` on parameter class `stripe.PaymentIntent.ConfirmParams`
@@ -1434,9 +1447,9 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `paypal` on enum `stripe.Dispute.PaymentMethodDetails.type`
   * Add support for `shipping_address_invalid` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
   * Change type of `metadata` on  `stripe.entitlements.Feature.ModifyParams` from `Dict[str, str]` to `Literal['']|Dict[str, str]`
-* [#1319](https://github.com/stripe/stripe-python/pull/1319) Fix type change entries in Python Changelog
 
-## 9.4.0 - 2024-04-25
+## <a id="9-4-0"></a>9.4.0 - 2024-04-25
+* [#1307](https://github.com/stripe/stripe-python/pull/1307) Bump aiohttp from 3.9.2 to 3.9.4
 * [#1316](https://github.com/stripe/stripe-python/pull/1316) Update generated code
   * Add support for `amazon_pay` on resource classes `stripe.Mandate.PaymentMethodDetails` and `stripe.SetupAttempt.PaymentMethodDetails`
   * Add support for `revolut_pay` on resource classes `stripe.Mandate.PaymentMethodDetails` and `stripe.SetupAttempt.PaymentMethodDetails`
@@ -1449,9 +1462,9 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `amazon_pay` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
   * Add support for `revolut_pay` on enums `stripe.Invoice.PaymentSettings.payment_method_types`, `stripe.Invoice.CreateParamsPaymentSettings.payment_method_types`, `stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types`, `stripe.Subscription.PaymentSettings.payment_method_types`, `stripe.Subscription.CreateParamsPaymentSettings.payment_method_types`, and `stripe.Subscription.ModifyParamsPaymentSettings.payment_method_types`
   * Remove support for inadvertently released identity verification features `email` and `phone` on parameter classes `stripe.identity.VerificationSession.CreateParamsOptions` and `stripe.identity.VerificationSession.ModifyParamsOptions`
-* [#1307](https://github.com/stripe/stripe-python/pull/1307) Bump aiohttp from 3.9.2 to 3.9.4
 
-## 9.3.0 - 2024-04-18
+## <a id="9-3-0"></a>9.3.0 - 2024-04-18
+* [#1306](https://github.com/stripe/stripe-python/pull/1306) Update `Quote.pdf()` to use the right base address i.e. files.stripe.com instead of api.stripe.com. Fixes [#1303](https://github.com/stripe/stripe-python/issues/1303)
 * [#1305](https://github.com/stripe/stripe-python/pull/1305) Update generated code
   * Add support for `allow_redisplay` on parameter classes `stripe.ConfirmationToken.CreateParamsPaymentMethodData`, `stripe.Customer.ListPaymentMethodsParams`, `stripe.PaymentIntent.ConfirmParamsPaymentMethodData`, `stripe.PaymentIntent.CreateParamsPaymentMethodData`, `stripe.PaymentIntent.ModifyParamsPaymentMethodData`, `stripe.PaymentMethod.CreateParams`, `stripe.PaymentMethod.ModifyParams`, `stripe.SetupIntent.ConfirmParamsPaymentMethodData`, `stripe.SetupIntent.CreateParamsPaymentMethodData`, and `stripe.SetupIntent.ModifyParamsPaymentMethodData`
   * Add support for `schedule_details` on parameter classes `stripe.Invoice.UpcomingLinesParams` and `stripe.Invoice.UpcomingParams`
@@ -1462,9 +1475,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `mobilepay` on parameter class `stripe.checkout.Session.CreateParamsPaymentMethodOptions` and resource class `stripe.checkout.Session.PaymentMethodOptions`
   * Add support for `mobilepay` on enum `stripe.checkout.Session.CreateParams.payment_method_types`
   * Add support for `other` on enums `stripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel.unit`, `stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel.unit`, and `stripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel.unit`
-* [#1306](https://github.com/stripe/stripe-python/pull/1306) Update `Quote.pdf()` to use the right base address i.e. files.stripe.com instead of api.stripe.com. Fixes [#1303](https://github.com/stripe/stripe-python/issues/1303)
 
-## 9.2.0 - 2024-04-16
+## <a id="9-2-0"></a>9.2.0 - 2024-04-16
 * [#1301](https://github.com/stripe/stripe-python/pull/1301) Update generated code
   * Add support for `balances` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
   * Add support for `payouts_list` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
@@ -1476,7 +1488,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `timestamp` on  `stripe.billing.MeterEvent.CreateParams` from `int` to `NotRequired[int]`
   * Add support for `entitlements.active_entitlement_summary.updated` on enums `stripe.Event.type`, `stripe.WebhookEndpoint.CreateParams.enabled_events`, and `stripe.WebhookEndpoint.ModifyParams.enabled_events`
 
-## 9.1.0 - 2024-04-11
+## <a id="9-1-0"></a>9.1.0 - 2024-04-11
+* [#1297](https://github.com/stripe/stripe-python/pull/1297) Use stdlib AsyncMock when available
 * [#1300](https://github.com/stripe/stripe-python/pull/1300) Update generated code
   * Add support for `external_account_collection` on resource class `stripe.AccountSession.Components.AccountOnboarding.Features` and parameter class `stripe.AccountSession.CreateParamsComponentsAccountOnboardingFeatures`
   * Add support for `account_management` on resource class `stripe.AccountSession.Components` and parameter class `stripe.AccountSession.CreateParamsComponents`
@@ -1498,11 +1511,11 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `billing_policy_remote_function_timeout` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
   * Add support for `billing_policy_remote_function_unexpected_status_code` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
   * Add support for `billing_policy_remote_function_unreachable` on enums `stripe.Invoice.LastFinalizationError.code`, `stripe.PaymentIntent.LastPaymentError.code`, `stripe.SetupAttempt.SetupError.code`, and `stripe.SetupIntent.LastSetupError.code`
-* [#1297](https://github.com/stripe/stripe-python/pull/1297) Use stdlib AsyncMock when available
 
-## 9.0.0 - 2024-04-10
-* [#1286](https://github.com/stripe/stripe-python/pull/1286)
+## <a id="9-0-0"></a>9.0.0 - 2024-04-10
+This release changes the pinned API version to `2024-04-10`.
 
+* [#1286](https://github.com/stripe/stripe-python/pull/1286) API Updates
   * This release changes the pinned API version to `2024-04-10`. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-04-10) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes
@@ -1551,10 +1564,9 @@ This release changes the pinned API version to `2025-04-30.basil`.
    * Remove the deprecated value `obligation` for `ReportRun.CreateParamsParameters.reporting_category` and `ReportRunService.CreateParamsParameters.reporting_category`
    * Remove the legacy field `rendering_options` on parameter classes `stripe.Invoice.CreateParams` and `stripe.Invoice.ModifyParams` and resource `stripe.Invoice`. Use `rendering` instead.
 
-
-
-
-## 8.11.0 - 2024-04-09
+## <a id="8-11-0"></a>8.11.0 - 2024-04-09
+* [#1299](https://github.com/stripe/stripe-python/pull/1299) Fix README.md
+* [#1292](https://github.com/stripe/stripe-python/pull/1292) Tweak changelog for python async note
 * [#1295](https://github.com/stripe/stripe-python/pull/1295) Update generated code
   * Add support for `fees`, `losses`, `requirement_collection` & `stripe_dashboard` on resource class `stripe.Account.Controller`
   * Add support for `controller` on parameter class `stripe.Account.CreateParams`
@@ -1566,19 +1578,15 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for resource `stripe.entitlements.Feature`
   * Add support for `none` on enum `stripe.Account.type`
 
-* [#1299](https://github.com/stripe/stripe-python/pull/1299) Fix README.md
-* [#1292](https://github.com/stripe/stripe-python/pull/1292) Tweak changelog for python async note
-
-## 8.10.0 - 2024-04-04
-
+## <a id="8-10-0"></a>8.10.0 - 2024-04-04
 * [#1288](https://github.com/stripe/stripe-python/pull/1288) Port **async support** from beta to the stable channel. To use it, add an `_async` suffix to any request-making method.
+  ```diff
+  - cus = stripe.Customer.create(...)
+  + cus = await stripe.Customer.create_async(...)
+  ```
 
-    ```diff
-    - cus = stripe.Customer.create(...)
-    + cus = await stripe.Customer.create_async(...)
-    ```
-
-    See the [README](./README.md#async) for detailed usage instructions. Support is provided out of the box for async requests via the HTTPX (used by default) and aiohttp libraries. For other libraries, you can also provide your own `stripe.HTTPClient` implementation. Please do not hesitate to [open a Github issue](https://github.com/stripe/stripe-python/issues/new/choose) if you have any feedback on this feature.
+  See the [README](./README.md#async) for detailed usage instructions. Support is provided out of the box for async requests via the HTTPX (used by default) and aiohttp libraries. For other libraries, you can also provide your own `stripe.HTTPClient` implementation. Please do not hesitate to [open a Github issue](https://github.com/stripe/stripe-python/issues/new/choose) if you have any feedback on this feature.
+* [#1289](https://github.com/stripe/stripe-python/pull/1289) Bump aiohttp from 3.9.0 to 3.9.2
 * [#1284](https://github.com/stripe/stripe-python/pull/1284) Update generated code
   * Add support for `subscription_item` on resource `stripe.Discount`
   * Add support for `promotion_code` on parameter classes `stripe.Invoice.CreateParamsDiscount`, `stripe.Invoice.ModifyParamsDiscount`, `stripe.InvoiceItem.CreateParamsDiscount`, `stripe.InvoiceItem.ModifyParamsDiscount`, `stripe.InvoiceLineItem.ModifyParamsDiscount`, `stripe.Quote.CreateParamsDiscount`, and `stripe.Quote.ModifyParamsDiscount`
@@ -1607,10 +1615,10 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `hosted_instructions_url` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[str]` to `str`
   * Change type of `mobile_auth_url` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[str]` to `str`
   * Change type of `qr_code` on  `stripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode` from `Optional[QrCode]` to `QrCode`
-* [#1289](https://github.com/stripe/stripe-python/pull/1289) Bump aiohttp from 3.9.0 to 3.9.2
 
-
-## 8.9.0 - 2024-03-28
+## <a id="8-9-0"></a>8.9.0 - 2024-03-28
+* [#1279](https://github.com/stripe/stripe-python/pull/1279) Update README.md
+* [#1278](https://github.com/stripe/stripe-python/pull/1278) Types: remove unnecessary quotes
 * [#1276](https://github.com/stripe/stripe-python/pull/1276) Update generated code
   * Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`
   * Add support for `create`, `deactivate`, `list`, `modify`, `reactivate`, and `retrieve` methods on resource `Meter`
@@ -1621,10 +1629,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `meter` on `Plan.CreateParams`, `Plan`, `PlanService.CreateParams`, `Price.Recurring`, `Price.CreateParamsRecurring`, `Price.ListParamsRecurring`, `PriceService.CreateParamsRecurring`, and `PriceService.ListParamsRecurring`
   * Add support for `mandate` on `Charge.PaymentMethodDetails.USBankAccount`, `Treasury.InboundTransfer.OriginPaymentMethodDetails.USBankAccount`, `Treasury.OutboundPayment.DestinationPaymentMethodDetails.USBankAccount`, and `Treasury.OutboundTransfer.DestinationPaymentMethodDetails.USBankAccount`
   * Add support for `second_line` on `Issuing.Card.CreateParams`
-* [#1278](https://github.com/stripe/stripe-python/pull/1278) Types: remove unnecessary quotes
-* [#1279](https://github.com/stripe/stripe-python/pull/1279) Update README.md
 
-## 8.8.0 - 2024-03-21
+## <a id="8-8-0"></a>8.8.0 - 2024-03-21
 * [#1273](https://github.com/stripe/stripe-python/pull/1273) Update generated code
   * Add support for new resources `ConfirmationToken` and `Forwarding.Request`
   * Add support for `retrieve` method on resource `ConfirmationToken`
@@ -1640,9 +1646,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
    * Add support for new value `mobilepay` on enums `PaymentIntentService.ConfirmParamsPaymentMethodData.type`, `PaymentIntentService.CreateParamsPaymentMethodData.type`, `PaymentIntentService.UpdateParamsPaymentMethodData.type`, `SetupIntentService.ConfirmParamsPaymentMethodData.type`, `SetupIntentService.CreateParamsPaymentMethodData.type`, and `SetupIntentService.UpdateParamsPaymentMethodData.type`
    * Add support for new value `mobilepay` on enum `PaymentMethod.type`
 
-
-
-## 8.7.0 - 2024-03-14
+## <a id="8-7-0"></a>8.7.0 - 2024-03-14
 * [#1269](https://github.com/stripe/stripe-python/pull/1269) Update generated code
   * Add support for `personalization_design` on parameter classes `CardService.CreateParams`, `CardService.ListParams`, `CardService.UpdateParams`, `stripe.issuing.Card.CreateParams`, `stripe.issuing.Card.ListParams`, and `stripe.issuing.Card.ModifyParams` and resource `stripe.issuing.Card`
   * Add support for `sepa_debit` on parameter classes `SubscriptionService.CreateParamsPaymentSettingsPaymentMethodOptions`, `SubscriptionService.UpdateParamsPaymentSettingsPaymentMethodOptions`, `stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptions`, and `stripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptions` and resource class `stripe.Subscription.PaymentSettings.PaymentMethodOptions`
@@ -1650,16 +1654,17 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for resource `stripe.issuing.PhysicalBundle`
   * Change type from `float` to `Literal['']|float` of `application_fee_percent` on fields `stripe.Subscription.CreateParams`, `stripe.Subscription.ModifyParams`, `SubscriptionService.UpdateParams`, and `SubscriptionService.CreateParams`
 
-
-## 8.6.0 - 2024-03-07
+## <a id="8-6-0"></a>8.6.0 - 2024-03-07
+* [#1268](https://github.com/stripe/stripe-python/pull/1268) Update README.md
 * [#1267](https://github.com/stripe/stripe-python/pull/1267) Update generated code
   * Add support for `documents` on `AccountSession.Components`
   * Add support for `request_three_d_secure` on `Checkout.Session.PaymentMethodOptionsCard` and `Checkout.Session.CreateParams.PaymentMethodOptionsCard`
   * Add support for `created` on `CreditNote.ListParams`
   * Add support for `sepa_debit` on `Invoice.PaymentSettings.PaymentMethodOptions`, `InvoiceCreateParams.PaymentSettings.PaymentMethodOptions`, and `InvoiceUpdateParams.PaymentSettings.PaymentMethodOptions`
-* [#1268](https://github.com/stripe/stripe-python/pull/1268) Update README.md
 
-## 8.5.0 - 2024-02-29
+## <a id="8-5-0"></a>8.5.0 - 2024-02-29
+* [#1250](https://github.com/stripe/stripe-python/pull/1250) Fix type of ErrorObject.code
+* [#1260](https://github.com/stripe/stripe-python/pull/1260) Update README to use add_beta_version
 * [#1255](https://github.com/stripe/stripe-python/pull/1255) Update generated code
   * Change `identity.VerificationReport.type` to be required
   * Change type of `identity.VerificationSession.type` from `Optional[Literal["document", "id_number"]]` to `Literal["document", "id_number"]`
@@ -1668,19 +1673,20 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `refund_payment_config` on `Terminal.Reader.Action.refund_payment` and `Terminal.Reader.RefundPaymentParams`
   * Add support for `payment_method` on `Token.CreateParams.bank_account`
   * Add `list_refunds` and `retrieve_refund` methods on resource `Charge`.
-* [#1260](https://github.com/stripe/stripe-python/pull/1260) Update README to use add_beta_version
-* [#1250](https://github.com/stripe/stripe-python/pull/1250) Fix type of ErrorObject.code
 
-## 8.4.0 - 2024-02-22
-* [#1241](https://github.com/stripe/stripe-python/pull/1241) Update generated code
-  - Add `InvoiceLineItem.modify` method.
+## <a id="8-4-0"></a>8.4.0 - 2024-02-22
+* [#1242](https://github.com/stripe/stripe-python/pull/1242) Testing: unify http client mock
+* [#1243](https://github.com/stripe/stripe-python/pull/1243) Remove http client base
 * [#1244](https://github.com/stripe/stripe-python/pull/1244) Add TaxIds API
   * Add support for `create`, `retrieve`, `delete`, and `list` methods on resource `TaxId`
   * The `instance_url` function on resource `TaxId` now returns the top-level `/v1/tax_ids/{id}` path instead of the `/v1/customers/{customer}/tax_ids/{id}` path.
-* [#1243](https://github.com/stripe/stripe-python/pull/1243) Remove http client base
-* [#1242](https://github.com/stripe/stripe-python/pull/1242) Testing: unify http client mock
+* [#1241](https://github.com/stripe/stripe-python/pull/1241) Update generated code
+  - Add `InvoiceLineItem.modify` method.
 
-## 8.3.0 - 2024-02-15
+## <a id="8-3-0"></a>8.3.0 - 2024-02-15
+* [#1232](https://github.com/stripe/stripe-python/pull/1232) Improve types in _http_client.py
+* [#1237](https://github.com/stripe/stripe-python/pull/1237) Remove broken child methods
+  * Bugfix: remove support for `CreditNoteLineItem.list`, `CustomerCashBalanceTransaction.list`, and `CustomerCashBalanceTransaction.retrieve`. These methods were included in the library unintentionally and never functioned.
 * [#1230](https://github.com/stripe/stripe-python/pull/1230) Update generated code
   * Add support for `networks` on `Card`, `PaymentMethod.CreateParamsCard`, `PaymentMethod.ModifyParamsCard`, and `Token.CreateParamsCard`
   * Add support for new value `no_voec` on enums `Checkout.Session.CustomerDetails.TaxId.type`, `Invoice.CustomerTaxId.type`, `Tax.Calculation.CustomerDetails.TaxId.type`, `Tax.Transaction.CustomerDetails.TaxId.type`, and `TaxId.type`
@@ -1688,29 +1694,26 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for new value `financial_connections.account.refreshed_ownership` on enum `Event.type`
   * Add support for `display_brand` on `PaymentMethod.card`
   * Add support for new value `financial_connections.account.refreshed_ownership` on enums `WebhookEndpoint.CreateParams.enabled_events[]` and `WebhookEndpoint.UpdateParams.enabled_events[]`
-* [#1237](https://github.com/stripe/stripe-python/pull/1237) Remove broken child methods
-  * Bugfix: remove support for `CreditNoteLineItem.list`, `CustomerCashBalanceTransaction.list`, and `CustomerCashBalanceTransaction.retrieve`. These methods were included in the library unintentionally and never functioned.
-* [#1232](https://github.com/stripe/stripe-python/pull/1232) Improve types in _http_client.py
 
-## 8.2.0 - 2024-02-08
+## <a id="8-2-0"></a>8.2.0 - 2024-02-08
+* [#1220](https://github.com/stripe/stripe-python/pull/1220) Measure StripeClient usage
+* [#1223](https://github.com/stripe/stripe-python/pull/1223) Move StripeClient usage collection onto StripeService
 * [#1225](https://github.com/stripe/stripe-python/pull/1225) Update generated code
   * Add support for `invoices` on `Account.Settings`
   * Add support for new value `velobank` on various enums `PaymentMethodDetails.P24.bank`
   * Add support for `setup_future_usage` on `PaymentMethodOptions.Blik`
   * Add support for `require_cvc_recollection` on `PaymentMethodOptions.Card`
   * Add support for `account_tax_ids` on various `InvoiceSettings` request parameters
-* [#1223](https://github.com/stripe/stripe-python/pull/1223) Move StripeClient usage collection onto StripeService
-* [#1220](https://github.com/stripe/stripe-python/pull/1220) Measure StripeClient usage
 
-## 8.1.0 - 2024-02-01
+## <a id="8-1-0"></a>8.1.0 - 2024-02-01
 * [#1213](https://github.com/stripe/stripe-python/pull/1213) Update generated code
   * Add support for `swish` payment method throughout the API
   * Add support for `relationship` on parameter classes `Account.CreateParamsIndividual` and `Token.CreateParamsAccountIndividual`
   * Add support for `jurisdiction_level` on resource `TaxRate`
   * Change type from `str` to `Literal["offline", "online"]` of `status` on field `terminal.Reader`
 
-## 8.0.0 - 2024-01-25
-* [#1206](https://github.com/stripe/stripe-python/pull/1206) stripe-python v8 release
+## <a id="8-0-0"></a>8.0.0 - 2024-01-25
+* ⚠️ [#1206](https://github.com/stripe/stripe-python/pull/1206) stripe-python v8 release
   This release introduces `StripeClient` and a service-based call pattern. This new interface allows you to easily call Stripe APIs and has several benefits over the existing resource-based pattern:
 
   * No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
@@ -1755,7 +1758,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * ⚠️ Remove `StripeObject.ReprJSONEncoder`. This class was intended for internal stripe-python use only.
   * ⚠️ Remove `StripeObject.api_base`. This property was defunct and returned `None`.
 
-## 7.14.0 - 2024-01-25
+## <a id="7-14-0"></a>7.14.0 - 2024-01-25
 * [#1199](https://github.com/stripe/stripe-python/pull/1199) Update generated code
   * Add support for `annual_revenue` and `estimated_worker_count` on `Account.business_profile`, `Account.CreateParams.business_profile`, and `Account.UpdateParams.business_profile`
   * Add support for new value `registered_charity` on enums `Account.CreateParams.company.structure`, `Account.UpdateParams.company.structure`, and `Token.CreateParams.account.company.structure`
@@ -1767,7 +1770,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `promotion_code` on `Invoice.UpcomingLinesParams.discounts[]`, `Invoice.UpcomingLinesParams.invoice_items[].discounts[]`, `Invoice.UpcomingParams.discounts[]`, and `Invoice.UpcomingParams.invoice_items[].discounts[]`
   * Add support for `account_type` on `PaymentMethod.UpdateParams.us_bank_account`
 
-## 7.13.0 - 2024-01-18
+## <a id="7-13-0"></a>7.13.0 - 2024-01-18
 * [#1193](https://github.com/stripe/stripe-python/pull/1193) Update generated code
   * Add support for providing details about `BankAccount`, `Card`, and `CardToken` on `Account.CreateExternalAccountParams.external_account` and `Account.CreateParams.external_account`
   * Add support for new value `nn` on enums `Charge.PaymentMethodDetails.Ideal.bank`, `PaymentIntent.ConfirmParamsPaymentMethodDataIdeal.bank`, `PaymentIntent.CreateParamsPaymenMethodDataIdeal.bank`, `PaymentIntent.UpdateParamsPaymentMethodDataIdeal.bank`, `PaymentMethod.Ideal.bank`, `PaymentMethod.CreateParamsIdeal.bank`, `SetupAttempt.PaymentMethodDetails.Ideal.bank`, `SetupIntent.ConfirmParamsPaymenMethodDataIdeal.bank`, `SetupIntent.CreateParamsPaymenMethodDataIdeal.bank`, and `SetupIntent.UpdateParamsPaymenMethodDataIdeal.bank`
@@ -1781,7 +1784,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `customer_balance` on `PaymentMethodConfiguration.CreateParams`, `PaymentMethodConfiguration.UpdateParams`, and `PaymentMethodConfiguration`
   * Add support for `invoice_settings` on `Subscription.CreateParams` and `Subscription.UpdateParams`
 
-## 7.12.0 - 2024-01-12
+## <a id="7-12-0"></a>7.12.0 - 2024-01-12
 * [#1188](https://github.com/stripe/stripe-python/pull/1188) Update generated code
   * Add support for new resource `CustomerSession`
   * Add support for `create` method on resource `CustomerSession`
@@ -1790,7 +1793,7 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Remove support for value `obligation` from enum `Reporting.ReportRunCreateParams.parameters.reporting_category`
   * Add support for `billing_cycle_anchor_config` on `SubscriptionCreateParams` and `Subscription`
 
-## 7.11.0 - 2024-01-04
+## <a id="7-11-0"></a>7.11.0 - 2024-01-04
 * [#1186](https://github.com/stripe/stripe-python/pull/1186) Update generated code
   * Add support for `retrieve` on resource `tax.Registration`
   * Change type from `Optional[PaymentDetails]` to `PaymentDetails` of `payment_details` on field `AccountSession.Components`
@@ -1799,8 +1802,9 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type from `Optional[Features]` to `Features` of `features` on fields `AccountSession.Components.PaymentDetails`, `AccountSession.Components.Payments`, and `AccountSession.Components.Payouts`
   * Change type from `Optional[InvoiceSettings]` to `InvoiceSettings` of `invoice_settings` on field `SubscriptionSchedule.DefaultSettings`
 
-
-## 7.10.0 - 2023-12-22
+## <a id="7-10-0"></a>7.10.0 - 2023-12-22
+* [#1178](https://github.com/stripe/stripe-python/pull/1178) Support accessing reserved word resource properties via attribute
+* [#1184](https://github.com/stripe/stripe-python/pull/1184) Remove api_base from RequestOptions type
 * [#1176](https://github.com/stripe/stripe-python/pull/1176) Update generated code
   * Add support for new resource `FinancialConnections.Transaction`
   * Add support for `list` and `retrieve` methods on resource `Transaction`
@@ -1819,72 +1823,69 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Change type of `Quote.invoice_settings` from `InvoiceSettingQuoteSetting | null` to `InvoiceSettingQuoteSetting`
   * Add support for `destination_details` on `Refund`
   * Add support for new value `financial_connections.account.refreshed_transactions` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-
 * [#1185](https://github.com/stripe/stripe-python/pull/1185) Update generated code
-* [#1184](https://github.com/stripe/stripe-python/pull/1184) Remove api_base from RequestOptions type
-* [#1178](https://github.com/stripe/stripe-python/pull/1178) Support accessing reserved word resource properties via attribute
 
-## 7.9.0 - 2023-12-14
+## <a id="7-9-0"></a>7.9.0 - 2023-12-14
+* [#1169](https://github.com/stripe/stripe-python/pull/1169) Add more types to _http_client.py
+* [#1101](https://github.com/stripe/stripe-python/pull/1101) Mark defunct and internal methods as deprecated
+* [#1146](https://github.com/stripe/stripe-python/pull/1146) Track usage of deprecated `save`
+  * Reports uses of the deprecated `.save` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `stripe.enable_telemetry = false`, see the [README](https://github.com/stripe/stripe-python/blob/master/README.md#telemetry).)
 * [#1161](https://github.com/stripe/stripe-python/pull/1161) Update generated code
-
   * Add support for `payment_method_reuse_agreement` on resource classes `PaymentLink.ConsentCollection` and `checkout.Session.ConsentCollection` and parameter classes `PaymentLink.CreateParamsConsentCollection` and `checkout.Session.CreateParamsConsentCollection`
   * Add support for `after_submit` on parameter classes `PaymentLink.CreateParamsCustomText`, `PaymentLink.ModifyParamsCustomText`, and `checkout.Session.CreateParamsCustomText` and resource classes `PaymentLink.CustomText` and `checkout.Session.CustomText`
   * Add support for `created` on parameter class `radar.EarlyFraudWarning.ListParams`
-* [#1146](https://github.com/stripe/stripe-python/pull/1146) Track usage of deprecated `save`
-  * Reports uses of the deprecated `.save` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `stripe.enable_telemetry = false`, see the [README](https://github.com/stripe/stripe-python/blob/master/README.md#telemetry).)
-* [#1101](https://github.com/stripe/stripe-python/pull/1101) Mark defunct and internal methods as deprecated
-* [#1169](https://github.com/stripe/stripe-python/pull/1169) Add more types to _http_client.py
 
-## 7.8.2 - 2023-12-11
+## <a id="7-8-2"></a>7.8.2 - 2023-12-11
 * [#1168](https://github.com/stripe/stripe-python/pull/1168) Do not raise a DeprecationWarning in `stripe.app_info`
 
-## 7.8.1 - 2023-12-08
-* [#1159](https://github.com/stripe/stripe-python/pull/1159) Fix __getattr__ to raise AttributeError rather than returning None. This fixes a regression in 7.8.0 that caused `stripe.checkout`/`stripe.issuing` etc. to return `None`.
+## <a id="7-8-1"></a>7.8.1 - 2023-12-08
 * [#1157](https://github.com/stripe/stripe-python/pull/1157) Add missing explicit reexport for `OAuth`, `Webhook`, `WebhookSignature`
+* [#1159](https://github.com/stripe/stripe-python/pull/1159) Fix __getattr__ to raise AttributeError rather than returning None. This fixes a regression in 7.8.0 that caused `stripe.checkout`/`stripe.issuing` etc. to return `None`.
 
-## 7.8.0 - 2023-12-07
-* [#1155](https://github.com/stripe/stripe-python/pull/1155) Update generated code
-  * Add support for `payment_details`, `payments`, and `payouts` on `AccountSession.components` and `CreateParams.components`
-  * Add support for `features` on `AccountSession.components.account_onboarding` and `CreateParams.components.account_onboarding`
-  * Add support for new values `customer_tax_location_invalid` and `financial_connections_no_successful_transaction_refresh` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
-  * Add support for new values `payment_network_reserve_hold` and `payment_network_reserve_release` on enum `BalanceTransaction.type`
-  * Change `Climate.Product.metric_tons_available` to be required
-  * Remove support for value `various` from enum `Climate.Supplier.removal_pathway`
-  * Remove support for values `challenge_only` and `challenge` from enum `PaymentIntent.payment_method_options.card.request_three_d_secure`
-  * Add support for `inactive_message` and `restrictions` on `CreateParams`, `ModifyParams`, and `PaymentLink`
-  * Add support for `transfer_group` on `PaymentLink.payment_intent_data`, `CreateParams.payment_intent_data`, and `ModifyParams.payment_intent_data`
-  * Add support for `trial_settings` on `PaymentLink.subscription_data`, `CreateParams.subscription_data`, and `ModifyParams.subscription_data`
-* [#1153](https://github.com/stripe/stripe-python/pull/1153) Move exports for more modules
-  -  `stripe.app_info`, `stripe.http_client`, `stripe.oauth`, `stripe.util`, `stripe.version`, `stripe.webhook`,  modules are deprecated. All types are available directly from `stripe` module now.
+## <a id="7-8-0"></a>7.8.0 - 2023-12-07
+* [#1142](https://github.com/stripe/stripe-python/pull/1142) Move resource type exports to stripe.___
+  - `stripe.error`, `stripe.stripe_object`, `stripe.api_requestor`, `stripe.stripe_response`, `stripe.request_options`, `stripe.api_resources.*`,  `stripe.api_resources.abstract.*` modules are deprecated. All types are available directly from `stripe` module now.
      Before:
      ```python
-     from stripe.util import convert_to_stripe_object
+     from stripe.error import APIError
      # or
-     stripe.util.convert_to_stripe_object
+     stripe.error.APIError
      ````
      After:
      ```python
-     from stripe import convert_to_stripe_object
+     from stripe import APIError
      # or
-     stripe.convert_to_stripe_object
+     stripe.APIError
      ```
-  - `stripe.api_version`, `stripe.multipart_data_generator`, `stripe.request_metrics` are deprecated and will be fully removed in the future.
-* [#1142](https://github.com/stripe/stripe-python/pull/1142) Move resource type exports to stripe.___
-  - `stripe.error`, `stripe.stripe_object`, `stripe.api_requestor`, `stripe.stripe_response`, `stripe.request_options`, `stripe.api_resources.*`,  `stripe.api_resources.abstract.*` modules are deprecated. All types are available directly from `stripe` module now.
+* [#1153](https://github.com/stripe/stripe-python/pull/1153) Move exports for more modules
+  -  `stripe.app_info`, `stripe.http_client`, `stripe.oauth`, `stripe.util`, `stripe.version`, `stripe.webhook`,  modules are deprecated. All types are available directly from `stripe` module now.
      Before:
      ```python
-     from stripe.error import APIError
+     from stripe.util import convert_to_stripe_object
      # or
-     stripe.error.APIError
+     stripe.util.convert_to_stripe_object
      ````
      After:
      ```python
-     from stripe import APIError
+     from stripe import convert_to_stripe_object
      # or
-     stripe.APIError
+     stripe.convert_to_stripe_object
      ```
+  - `stripe.api_version`, `stripe.multipart_data_generator`, `stripe.request_metrics` are deprecated and will be fully removed in the future.
+* [#1155](https://github.com/stripe/stripe-python/pull/1155) Update generated code
+  * Add support for `payment_details`, `payments`, and `payouts` on `AccountSession.components` and `CreateParams.components`
+  * Add support for `features` on `AccountSession.components.account_onboarding` and `CreateParams.components.account_onboarding`
+  * Add support for new values `customer_tax_location_invalid` and `financial_connections_no_successful_transaction_refresh` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Add support for new values `payment_network_reserve_hold` and `payment_network_reserve_release` on enum `BalanceTransaction.type`
+  * Change `Climate.Product.metric_tons_available` to be required
+  * Remove support for value `various` from enum `Climate.Supplier.removal_pathway`
+  * Remove support for values `challenge_only` and `challenge` from enum `PaymentIntent.payment_method_options.card.request_three_d_secure`
+  * Add support for `inactive_message` and `restrictions` on `CreateParams`, `ModifyParams`, and `PaymentLink`
+  * Add support for `transfer_group` on `PaymentLink.payment_intent_data`, `CreateParams.payment_intent_data`, and `ModifyParams.payment_intent_data`
+  * Add support for `trial_settings` on `PaymentLink.subscription_data`, `CreateParams.subscription_data`, and `ModifyParams.subscription_data`
 
-## 7.7.0 - 2023-11-30
+## <a id="7-7-0"></a>7.7.0 - 2023-11-30
+* [#1145](https://github.com/stripe/stripe-python/pull/1145) Refactor integration test
 * [#1147](https://github.com/stripe/stripe-python/pull/1147) Update generated code
   * Add support for new resources `Climate.Order`, `Climate.Product`, and `Climate.Supplier`
   * Add support for `cancel`, `create`, `list`, `modify`, and `retrieve` methods on resource `Order`
@@ -1897,9 +1898,8 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for new value `challenge` on enums `PaymentIntent. PaymentMethodOptions.Card.request_three_d_secure` and `SetupIntent. PaymentMethodOptions.Card.request_three_d_secure`
   * Add support for new values `climate_order_purchase` and `climate_order_refund` on enum `Reporting.ReportRun. CreateParamsParameters.reporting_category`
   * Add support for new values `climate.order.canceled`, `climate.order.created`, `climate.order.delayed`, `climate.order.delivered`, `climate.order.product_substituted`, `climate.product.created`, and `climate.product.pricing_updated` on enums `WebhookEndpoint.CreateParams.enabled_events[]` and `WebhookEndpoint.ModifyParams.enabled_events[]`
-* [#1145](https://github.com/stripe/stripe-python/pull/1145) Refactor integration test
 
-## 7.6.0 - 2023-11-21
+## <a id="7-6-0"></a>7.6.0 - 2023-11-21
 * [#1138](https://github.com/stripe/stripe-python/pull/1138) Update generated code
   * Add support for `electronic_commerce_indicator` on resource classes `Charge.PaymentMethodDetails.Card.ThreeDSecure` and `SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure`
   * Add support for `exemption_indicator` on resource class `Charge.PaymentMethodDetails.Card.ThreeDSecure`
@@ -1912,7 +1912,15 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `requested_at` on resource class `issuing.Authorization.RequestHistory`
   * Add support for `authorization_code` on resource class `issuing.Transaction.NetworkData`
 
-## 7.5.0 - 2023-11-16
+## <a id="7-5-0"></a>7.5.0 - 2023-11-16
+* [#1125](https://github.com/stripe/stripe-python/pull/1125) Add support for Python 3.11/3.12
+* [#1123](https://github.com/stripe/stripe-python/pull/1123) Move to python3 venv and update vscode settings
+* [#1126](https://github.com/stripe/stripe-python/pull/1126) Suppress type errors from latest pyright
+* [#1132](https://github.com/stripe/stripe-python/pull/1132) Fix unnecessary casts from pyright 1.1.336
+* [#1134](https://github.com/stripe/stripe-python/pull/1134) Run pyright via tox
+* [#1131](https://github.com/stripe/stripe-python/pull/1131) Upgrade black dependency
+* [#1135](https://github.com/stripe/stripe-python/pull/1135) Add initial tests for exports and run them in mypy and pyright
+* [#1130](https://github.com/stripe/stripe-python/pull/1130) Mention types in README.md
 * [#1127](https://github.com/stripe/stripe-python/pull/1127) Update generated code
   * Add support for `bacs_debit_payments` on `Account.CreateParamsSettings`
   * Add support for `service_user_number` on `Account.Settings.BacsDebitPayments`
@@ -1921,100 +1929,90 @@ This release changes the pinned API version to `2025-04-30.basil`.
   * Add support for `tax_amounts` on `CreditNote.CreateParamsLine`, `CreditNote.PreviewParamsLine`, and `CreditNote.PreviewLinesParamsLine`
   * Add support for `network_data` on `Issuing.Transaction`
   * Add support for `status` on `Checkout.Session.ListParams`
-* [#1135](https://github.com/stripe/stripe-python/pull/1135) Add initial tests for exports and run them in mypy and pyright
-* [#1130](https://github.com/stripe/stripe-python/pull/1130) Mention types in README.md
-* [#1134](https://github.com/stripe/stripe-python/pull/1134) Run pyright via tox
-* [#1131](https://github.com/stripe/stripe-python/pull/1131) Upgrade black dependency
-* [#1132](https://github.com/stripe/stripe-python/pull/1132) Fix unnecessary casts from pyright 1.1.336
-* [#1126](https://github.com/stripe/stripe-python/pull/1126) Suppress type errors from latest pyright
-* [#1125](https://github.com/stripe/stripe-python/pull/1125) Add support for Python 3.11/3.12
-* [#1123](https://github.com/stripe/stripe-python/pull/1123) Move to python3 venv and update vscode settings
 
-## 7.4.0 - 2023-11-09
+## <a id="7-4-0"></a>7.4.0 - 2023-11-09
+* [#1121](https://github.com/stripe/stripe-python/pull/1121) [types] Remove `None` from optional param types
 * [#1119](https://github.com/stripe/stripe-python/pull/1119) Update generated code
   * Add support for new value `terminal_reader_hardware_fault` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
   * Add support for `metadata` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, and `QuoteUpdateParams.subscription_data`
-* [#1121](https://github.com/stripe/stripe-python/pull/1121) [types] Remove `None` from optional param types
 
-## 7.3.0 - 2023-11-02
+## <a id="7-3-0"></a>7.3.0 - 2023-11-02
 * [#1112](https://github.com/stripe/stripe-python/pull/1112) Update generated code
   * Add support for new resource `Tax.Registration`
   * Add support for `create`, `list`, and `modify` methods on resource `Registration`
 
-## 7.2.0 - 2023-10-31
+## <a id="7-2-0"></a>7.2.0 - 2023-10-31
 * [#1115](https://github.com/stripe/stripe-python/pull/1115) Types: Add types for `ErrorObject`.
 * [#1116](https://github.com/stripe/stripe-python/pull/1116) Types: Use @staticmethod overloads instead of @classmethod to fix MyPy compatibility.
 
-## 7.1.0 - 2023-10-26
+## <a id="7-1-0"></a>7.1.0 - 2023-10-26
+* [#1091](https://github.com/stripe/stripe-python/pull/1091) APIRequestor: don't mutate incoming multipart headers
+* [#1096](https://github.com/stripe/stripe-python/pull/1096) Add @util.deprecated decorator and deprecate `save`.
+* ⚠️ [#1103](https://github.com/stripe/stripe-python/pull/1103) Inner resource classes
+  * Behavior change: nested json objects will now deserialize into instances of specific classes that subclass `StripeObject`, instead of into generic `StripeObject` instances.
+  * ⚠️  Behavior change: `PromotionCode.restrictions.currency_options` will now deserialize into `dict` and not `StripeObject`.
 * [#1104](https://github.com/stripe/stripe-python/pull/1104) Include `py.typed` and enable type annotations for the package
   * This PR includes `py.typed` and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshed for users who use a type checker or IDE.
   * See a detailed guide on the [Github Wiki](https://github.com/stripe/stripe-python/wiki/Inline-type-annotations).
-* [#1103](https://github.com/stripe/stripe-python/pull/1103) Inner resource classes
-  * Behavior change: nested json objects will now deserialize into instances of specific classes that subclass `StripeObject`, instead of into generic `StripeObject` instances.
-  * ⚠️  Behavior change: `PromotionCode.restrictions.currency_options` will now deserialize into `dict` and not `StripeObject`.
 * [#1090](https://github.com/stripe/stripe-python/pull/1090) Update generated code
   * Add support for new value `balance_invalid_parameter` on enums `Invoice.LastFinalizationError`, `PaymentIntent.LastPaymentError`, `SetupAttempt.SetupError`, and `SetupIntent.LastSetupError`
-* [#1096](https://github.com/stripe/stripe-python/pull/1096) Add @util.deprecated decorator and deprecate `save`.
-* [#1091](https://github.com/stripe/stripe-python/pull/1091) APIRequestor: don't mutate incoming multipart headers
 
+## <a id="7-0-0"></a>7.0.0 - 2023-10-16
+This release changes the pinned API version to `2023-10-16`.
 
-# Changelog
-## 7.0.0 - 2023-10-16
-* This release changes the pinned API version to `2023-10-16`. Please read the [API Changelog](https://docs.stripe.com/changelog/2023-10-16) and carefully review the API changes before upgrading `stripe-python`.
+* Please read the [API Changelog](https://docs.stripe.com/changelog/2023-10-16) and carefully review the API changes before upgrading `stripe-python`.
 * [#1085](https://github.com/stripe/stripe-python/pull/1085) Update generated code
   - Updated pinned API version
 
-## 6.7.0 - 2023-10-05
+## <a id="6-7-0"></a>6.7.0 - 2023-10-05
 * [#1065](https://github.com/stripe/stripe-python/pull/1065) Update generated code
   * Add support for new resource `Issuing.Token`
   * Add support for `list`, `modify`, and `retrieve` methods on resource `Token`
 
-## 6.6.0 - 2023-09-21
-* [#1056](https://github.com/stripe/stripe-python/pull/1056) Update generated code
-
-* [#1055](https://github.com/stripe/stripe-python/pull/1055) Partially type resource methods (no **params)
+## <a id="6-6-0"></a>6.6.0 - 2023-09-21
 * [#1057](https://github.com/stripe/stripe-python/pull/1057) Add optional types to non-required fields
+* [#1055](https://github.com/stripe/stripe-python/pull/1055) Partially type resource methods (no **params)
 * [#1054](https://github.com/stripe/stripe-python/pull/1054) Types: add deleted field
+* [#1056](https://github.com/stripe/stripe-python/pull/1056) Update generated code
 
-## 6.5.0 - 2023-09-14
-* [#1052](https://github.com/stripe/stripe-python/pull/1052) Update generated code
-  * Add support for new resource `PaymentMethodConfiguration`
-  * Add support for `create`, `list`, `modify`, and `retrieve` methods on resource `PaymentMethodConfiguration`
+## <a id="6-5-0"></a>6.5.0 - 2023-09-14
+* [#1030](https://github.com/stripe/stripe-python/pull/1030) Explicitly define CRUDL methods in each resource
+* [#1049](https://github.com/stripe/stripe-python/pull/1049) Types: datetimes to ints, add enum support
+* [#1050](https://github.com/stripe/stripe-python/pull/1050) Generate explicit nested resource class methods
 * [#1047](https://github.com/stripe/stripe-python/pull/1047) Update generated code
   * Add support for `capture`, `create`, `expire`, `increment`, and `reverse` test helper methods on resource `Issuing.Authorization`
   * Add support for `create_force_capture`, `create_unlinked_refund`, and `refund` test helper methods on resource `Issuing.Transaction`
-* [#1049](https://github.com/stripe/stripe-python/pull/1049) Types: datetimes to ints, add enum support
-* [#1030](https://github.com/stripe/stripe-python/pull/1030) Explicitly define CRUDL methods in each resource
-* [#1050](https://github.com/stripe/stripe-python/pull/1050) Generate explicit nested resource class methods
+* [#1052](https://github.com/stripe/stripe-python/pull/1052) Update generated code
+  * Add support for new resource `PaymentMethodConfiguration`
+  * Add support for `create`, `list`, `modify`, and `retrieve` methods on resource `PaymentMethodConfiguration`
 
-## 6.4.0 - 2023-09-07
+## <a id="6-4-0"></a>6.4.0 - 2023-09-07
+* [#1043](https://github.com/stripe/stripe-python/pull/1043) Types: ListObject
+* [#1044](https://github.com/stripe/stripe-python/pull/1044) Types: ExpandableField
 * [#1033](https://github.com/stripe/stripe-python/pull/1033) Update generated code
   * Add support for new resource `PaymentMethodDomain`
   * Add support for `create`, `list`, `modify`, `retrieve`, and `validate` methods on resource `PaymentMethodDomain`
-* [#1044](https://github.com/stripe/stripe-python/pull/1044) Types: ExpandableField
-* [#1043](https://github.com/stripe/stripe-python/pull/1043) Types: ListObject
 
-## 6.3.0 - 2023-09-05
-* [#1042](https://github.com/stripe/stripe-python/pull/1042) Require typing_extensions >= 4.0.0
+## <a id="6-3-0"></a>6.3.0 - 2023-09-05
 * [#1026](https://github.com/stripe/stripe-python/pull/1026) Types: annotate resource properties
+* [#1042](https://github.com/stripe/stripe-python/pull/1042) Require typing_extensions >= 4.0.0
 
-## 6.2.0 - 2023-08-31
+## <a id="6-2-0"></a>6.2.0 - 2023-08-31
+* [#1032](https://github.com/stripe/stripe-python/pull/1032) Types for CRUDL methods on parents
 * [#1024](https://github.com/stripe/stripe-python/pull/1024) Update generated code
   * Add support for new resource `AccountSession`
   * Add support for `create` method on resource `AccountSession`
-* [#1032](https://github.com/stripe/stripe-python/pull/1032) Types for CRUDL methods on parents
 
-## 6.1.0 - 2023-08-24
-* [#1016](https://github.com/stripe/stripe-python/pull/1016) Update generated code
+## <a id="6-1-0"></a>6.1.0 - 2023-08-24
 * [#1020](https://github.com/stripe/stripe-python/pull/1020) Adds type annotations, and dependency on `typing_extensions`.
+* [#1016](https://github.com/stripe/stripe-python/pull/1016) Update generated code
 
+## <a id="6-0-0"></a>6.0.0 - 2023-08-16
+This release changes the pinned API version to `2023-08-16`.
 
-## 6.0.0 - 2023-08-16
 **⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
-* [#1001](https://github.com/stripe/stripe-python/pull/1001) [#1008](https://github.com/stripe/stripe-python/pull/1008) Remove support for Python 2.
-  * The last version of stripe-python that supports Python 2 is 5.5.0. [The Python Software Foundation (PSF)](https://www.python.org/psf-landing/) community [announced the end of support of Python 2](https://www.python.org/doc/sunset-python-2/) on 01 January 2020. To continue to get new features and security updates, please make sure to update your Python runtime to Python 3.6+.
-* [#987](https://github.com/stripe/stripe-python/pull/987) ⚠️⚠️Pin to the latest API version⚠️⚠️
 
+* ⚠️ [#987](https://github.com/stripe/stripe-python/pull/987) Pin to the latest API version
   In this release, Stripe API Version `2023-08-16` (the latest at time of release) will be sent by default on all requests.
   The previous default was to use your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version).
 
@@ -2043,59 +2041,60 @@ This release changes the pinned API version to `2025-04-30.basil`.
   Going forward, each major release of this library will be *pinned* by default to the latest Stripe API Version at the time of release.
 
   That is, instead of upgrading stripe-python and separately upgrading your Stripe API Version through the Stripe Dashboard, whenever you upgrade major versions of stripe-python, you should also upgrade your integration to be compatible with the latest Stripe API version.
-
-* [#1013](https://github.com/stripe/stripe-python/pull/1013) ⚠️Removed @test_helper decorator
-  * This is technically breaking but unlikely to affect most users.
-* [#1015](https://github.com/stripe/stripe-python/pull/1015) ⚠️Assert types of pagination responses
+* [#1001](https://github.com/stripe/stripe-python/pull/1001) [#1008](https://github.com/stripe/stripe-python/pull/1008) Remove support for Python 2.
+  * The last version of stripe-python that supports Python 2 is 5.5.0. [The Python Software Foundation (PSF)](https://www.python.org/psf-landing/) community [announced the end of support of Python 2](https://www.python.org/doc/sunset-python-2/) on 01 January 2020. To continue to get new features and security updates, please make sure to update your Python runtime to Python 3.6+.
+* ⚠️ [#1015](https://github.com/stripe/stripe-python/pull/1015) Assert types of pagination responses
   * Pagination will raise an exception if the API response is not of the correct type. This should never happen in production use but may break tests that use mock data.
+* ⚠️ [#1013](https://github.com/stripe/stripe-python/pull/1013) Removed @test_helper decorator
+  * This is technically breaking but unlikely to affect most users.
 
-## 5.5.0 - 2023-07-13
+## <a id="5-5-0"></a>5.5.0 - 2023-07-13
 * [#990](https://github.com/stripe/stripe-python/pull/990) Update generated code
   * Add support for new resource `Tax.Settings`
   * Add support for `modify` and `retrieve` methods on resource `Settings`
 
-## 5.4.0 - 2023-03-30
+## <a id="5-4-0"></a>5.4.0 - 2023-03-30
 * [#951](https://github.com/stripe/stripe-python/pull/951) Update generated code
   * Remove support for `create` method on resource `Tax.Transaction`
     * This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the `create_from_calculation` method.
 
-## 5.3.0 - 2023-03-23
+## <a id="5-3-0"></a>5.3.0 - 2023-03-23
 * [#947](https://github.com/stripe/stripe-python/pull/947) Update generated code
   * Add support for new resources `Tax.CalculationLineItem`, `Tax.Calculation`, `Tax.TransactionLineItem`, and `Tax.Transaction`
   * Add support for `create` and `list_line_items` methods on resource `Calculation`
   * Add support for `create_from_calculation`, `create_reversal`, `create`, `list_line_items`, and `retrieve` methods on resource `Transaction`
 
-## 5.2.0 - 2023-02-16
+## <a id="5-2-0"></a>5.2.0 - 2023-02-16
 * [#924](https://github.com/stripe/stripe-python/pull/924) API Updates
   * Add support for `refund_payment` method on resource `Terminal.Reader`
 
-## 5.1.1 - 2023-02-06
+## <a id="5-1-1"></a>5.1.1 - 2023-02-06
 * [#923](https://github.com/stripe/stripe-python/pull/923) Bugfix: revert "Pass params into logger.{info,debug}"
 
-## 5.1.0 - 2023-02-02
+## <a id="5-1-0"></a>5.1.0 - 2023-02-02
+* [#913](https://github.com/stripe/stripe-python/pull/913) Pass params into logger.{info,debug}
 * [#920](https://github.com/stripe/stripe-python/pull/920) API Updates
   * Add support for `resume` method on resource `Subscription`
-* [#913](https://github.com/stripe/stripe-python/pull/913) Pass params into logger.{info,debug}
 
-## 5.0.0 - 2022-11-16
+## <a id="5-0-0"></a>5.0.0 - 2022-11-16
+This release changes the pinned API version to `2022-11-15`.
 
 Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
 
 "⚠️" symbol highlights breaking changes.
 
-* [#895](https://github.com/stripe/stripe-python/pull/895) Next major release changes
-* [#889](https://github.com/stripe/stripe-python/pull/889) API Updates
-
-* [#888](https://github.com/stripe/stripe-python/pull/888) Do not run Coveralls if secret token is not available
 * [#875](https://github.com/stripe/stripe-python/pull/875) hide misleading ssl security warning in python>=2.7.9
+* [#888](https://github.com/stripe/stripe-python/pull/888) Do not run Coveralls if secret token is not available
+* [#889](https://github.com/stripe/stripe-python/pull/889) API Updates
+* [#895](https://github.com/stripe/stripe-python/pull/895) Next major release changes
 
 ### ⚠️ Changed
-- Dropped support for Python version 3.4 and 3.5 (#881). We now support Python 2.7 or 3.6+.
-- Fixed mistyped names for two OAuth exceptions: `UnsupportedGrantTypError`->`UnsupportedGrantTypeError` and `UnsupportedResponseTypError`->`UnsupportedResponseTypeError` (#872).
+* ⚠️ [#872](https://github.com/stripe/stripe-python/pull/872) Fixed mistyped names for two OAuth exceptions: `UnsupportedGrantTypError`->`UnsupportedGrantTypeError` and `UnsupportedResponseTypError`->`UnsupportedResponseTypeError`
+* ⚠️ Dropped support for Python version 3.4 and 3.5 (#881). We now support Python 2.7 or 3.6+.
 
 ### Deprecated
-- Deprecate `save` method on resources (#887). Use `modify` instead.
-   ```python
+* Deprecate `save` method on resources (#887). Use `modify` instead.
+  ```python
   # Before
   customer = stripe.Customer.retrieve("cus_123")
   customer.email = "example@test.com"
@@ -2106,87 +2105,87 @@ Breaking changes that arose during code generation of the library that we postpo
    ```
 
 ### ⚠️ Removed
-- Removed `Orders` resource (#882).
-- Removed `SKU` resource (#883).
+* ⚠️ [#882](https://github.com/stripe/stripe-python/pull/882) Removed `Orders` resource
+* ⚠️ [#883](https://github.com/stripe/stripe-python/pull/883) Removed `SKU` resource
 
-## 4.2.0 - 2022-09-23
-* [#877](https://github.com/stripe/stripe-python/pull/877) API Updates
-  * Add `upcoming_lines` method to the `Invoice` resource.
+## <a id="4-2-0"></a>4.2.0 - 2022-09-23
 * [#873](https://github.com/stripe/stripe-python/pull/873) Add abstract methods for SearchableAPIResource
 * [#867](https://github.com/stripe/stripe-python/pull/867) API Updates
   * Update links in documentation to be absolute.
+* [#877](https://github.com/stripe/stripe-python/pull/877) API Updates
+  * Add `upcoming_lines` method to the `Invoice` resource.
 
-## 4.1.0 - 2022-08-19
+## <a id="4-1-0"></a>4.1.0 - 2022-08-19
+* [#717](https://github.com/stripe/stripe-python/pull/717) Fix test TestCharge.test_is_saveable().
+* [#860](https://github.com/stripe/stripe-python/pull/860) Add a support section to the readme
 * [#861](https://github.com/stripe/stripe-python/pull/861) API Updates
   * Add support for new resource `CustomerCashBalanceTransaction`
-* [#860](https://github.com/stripe/stripe-python/pull/860) Add a support section to the readme
-* [#717](https://github.com/stripe/stripe-python/pull/717) Fix test TestCharge.test_is_saveable().
 
-## 4.0.2 - 2022-08-03
+## <a id="4-0-2"></a>4.0.2 - 2022-08-03
 * [#855](https://github.com/stripe/stripe-python/pull/855) Fix issue where auto_paging_iter failed on nested list objects.
 
-## 4.0.1 - 2022-08-02
+## <a id="4-0-1"></a>4.0.1 - 2022-08-02
 * [#850](https://github.com/stripe/stripe-python/pull/850) Fix incorrect handling of additional request parameters
   * Fixes issue where using special parameter like `api_key`, `idempotency_key`, `stripe_version`, `stripe_account`, `headers` can cause a `Received unknown parameter error`.
 
-## 4.0.0 - 2022-08-02
+## <a id="4-0-0"></a>4.0.0 - 2022-08-02
+This release changes the pinned API version to `2022-08-01`.
 
 Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v4. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
 
 "⚠️" symbol highlights breaking changes.
 
-* [#847](https://github.com/stripe/stripe-python/pull/847) API Updates
-* [#845](https://github.com/stripe/stripe-python/pull/845) Next major release changes
-* [#836](https://github.com/stripe/stripe-python/pull/836) API Updates. Add Price.create tests.
 * [#835](https://github.com/stripe/stripe-python/pull/835) API Updates. Use auto-generation for credit_note and invoice methods.
-
-### ⚠️ Removed
-- Removed deprecated `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `IssuerFraudRecord`, `Recipient`, `RecipientTransfer`, and  `ThreeDSecure` classes.
-- Removed deprecated `Charge.update_dispute` and `Charge.close_dispute` methods that were using legacy REST API endpoint. Prefer [Dispute.modify](https://stripe.com/docs/api/disputes/update?lang=python) and [Dispute.close](https://stripe.com/docs/api/disputes/close?lang=python)
-- Removed deprecated `Card.details` method and `CardDetails` resource. The REST API endpoint is not longer supported.
-- Removed the deprecated `Source.source_transactions` method. Prefer `SubscriptionItem.list_source_transactions`
-- Removed the deprecated `SubscriptionItem.usage_record_summaries` method. Prefer `SubscriptionItem.list_usage_record_summaries`
-- Removed the deprecated `Charge.refund` method. Prefer [Refund.create](https://stripe.com/docs/api/refunds/create)
+* [#836](https://github.com/stripe/stripe-python/pull/836) API Updates. Add Price.create tests.
+* [#845](https://github.com/stripe/stripe-python/pull/845) Next major release changes
+* [#847](https://github.com/stripe/stripe-python/pull/847) API Updates
 
 ### ⚠️ Changed
-- To be consistent with other resource methods, `ApplicationFee.refund` returns an instance of `ApplicationFee` and doesn't mutate the instance of `ApplicationFee`.
-- To be consistent with other resource methods, the `Customer.delete_discount` no longer resets the `discount` property to `None` and returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually:
-- The `LineItem` resource now inherits from `StripeObject` as it has no methods of it's own.
-- To be consistent with other resource methods, the `Subscription.delete_discount` returns an instance of deleted discount and doesn't mutate the instance of `Subscription`.
-- Update the CA certificate bundle.
-- Request sending logic unified across standard and custom methods (https://github.com/stripe/stripe-python/pull/832)
-
-## 3.5.0 - 2022-06-30
+* ⚠️ To be consistent with other resource methods, `ApplicationFee.refund` returns an instance of `ApplicationFee` and doesn't mutate the instance of `ApplicationFee`.
+* ⚠️ To be consistent with other resource methods, the `Customer.delete_discount` no longer resets the `discount` property to `None` and returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually:
+* ⚠️ To be consistent with other resource methods, the `Subscription.delete_discount` returns an instance of deleted discount and doesn't mutate the instance of `Subscription`.
+* ⚠️ The `LineItem` resource now inherits from `StripeObject` as it has no methods of it's own.
+* Request sending logic unified across standard and custom methods (https://github.com/stripe/stripe-python/pull/832)
+* Update the CA certificate bundle.
+
+### ⚠️ Removed
+* ⚠️ Removed deprecated `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `IssuerFraudRecord`, `Recipient`, `RecipientTransfer`, and  `ThreeDSecure` classes.
+* ⚠️ Removed deprecated `Card.details` method and `CardDetails` resource. The REST API endpoint is not longer supported.
+* ⚠️ Removed deprecated `Charge.update_dispute` and `Charge.close_dispute` methods that were using legacy REST API endpoint. Prefer [Dispute.modify](https://stripe.com/docs/api/disputes/update?lang=python) and [Dispute.close](https://stripe.com/docs/api/disputes/close?lang=python)
+* ⚠️ Removed the deprecated `Charge.refund` method. Prefer [Refund.create](https://stripe.com/docs/api/refunds/create)
+* ⚠️ Removed the deprecated `Source.source_transactions` method. Prefer `SubscriptionItem.list_source_transactions`
+* ⚠️ Removed the deprecated `SubscriptionItem.usage_record_summaries` method. Prefer `SubscriptionItem.list_usage_record_summaries`
+
+## <a id="3-5-0"></a>3.5.0 - 2022-06-30
 * [#831](https://github.com/stripe/stripe-python/pull/831) API Updates
   * Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
   * Switch from using `instance_url` to computing method path in place for custom methods.
   * Switch from using explicit class methods for test helpers instead of using meta-programming.
 
-## 3.4.0 - 2022-06-17
+## <a id="3-4-0"></a>3.4.0 - 2022-06-17
+* [#823](https://github.com/stripe/stripe-python/pull/823) Trigger workflows on beta branches
 * [#824](https://github.com/stripe/stripe-python/pull/824) API Updates
   * Add support for `fund_cash_balance` test helper method on resource `Customer`
-* [#823](https://github.com/stripe/stripe-python/pull/823) Trigger workflows on beta branches
 
-## 3.3.0 - 2022-06-08
+## <a id="3-3-0"></a>3.3.0 - 2022-06-08
 * [#818](https://github.com/stripe/stripe-python/pull/818) fix: Update cash balance methods to no longer require nested ID.
 
-## 3.2.0 - 2022-05-23
+## <a id="3-2-0"></a>3.2.0 - 2022-05-23
 * [#812](https://github.com/stripe/stripe-python/pull/812) API Updates
   * Add support for new resource `Apps.Secret`
 
-## 3.1.0 - 2022-05-19
+## <a id="3-1-0"></a>3.1.0 - 2022-05-19
+* [#811](https://github.com/stripe/stripe-python/pull/811) Add sanitize_id method
+* [#767](https://github.com/stripe/stripe-python/pull/767) Bump vendored six to 1.16.0
+* [#719](https://github.com/stripe/stripe-python/pull/719) Set daemon attribute instead of using setDaemon method that was deprecated in Python 3.10
+* [#806](https://github.com/stripe/stripe-python/pull/806) Start testing on pypy-3.8
 * [#810](https://github.com/stripe/stripe-python/pull/810) API Updates
   * Add support for new resources `Treasury.CreditReversal`, `Treasury.DebitReversal`, `Treasury.FinancialAccountFeatures`, `Treasury.FinancialAccount`, `Treasury.FlowDetails`, `Treasury.InboundTransfer`, `Treasury.OutboundPayment`, `Treasury.OutboundTransfer`, `Treasury.ReceivedCredit`, `Treasury.ReceivedDebit`, `Treasury.TransactionEntry`, and `Treasury.Transaction`
   * Add support for `retrieve_payment_method` method on resource `Customer`
   * Add support for `list_owners` and `list` methods on resource `FinancialConnections.Account`
-* [#719](https://github.com/stripe/stripe-python/pull/719) Set daemon attribute instead of using setDaemon method that was deprecated in Python 3.10
-* [#767](https://github.com/stripe/stripe-python/pull/767) Bump vendored six to 1.16.0
-* [#806](https://github.com/stripe/stripe-python/pull/806) Start testing on pypy-3.8
-* [#811](https://github.com/stripe/stripe-python/pull/811) Add sanitize_id method
-
 
-## 3.0.0 - 2022-05-09
-* [#809](https://github.com/stripe/stripe-python/pull/809) Release of major version v3.0.0. The [migration guide](https://github.com/stripe/stripe-python/wiki/Migration-Guide-for-v3) contains more information.
+## <a id="3-0-0"></a>3.0.0 - 2022-05-09
+* ⚠️ [#809](https://github.com/stripe/stripe-python/pull/809) Release of major version v3.0.0. The [migration guide](https://github.com/stripe/stripe-python/wiki/Migration-Guide-for-v3) contains more information.
   (⚠️ = breaking changes):
   * ⚠️ Replace the legacy `Order` API with the new `Order` API.
     * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
@@ -2195,372 +2194,373 @@ Breaking changes that arose during code generation of the library that we postpo
   * ⚠️ Rename `financial_connections.account.refresh` to `financial_connections.refresh_account`
   * Add support for `amount_discount`, `amount_tax`, and `product` on `LineItem`
 
-## 2.76.0 - 2022-05-05
+## <a id="2-76-0"></a>2.76.0 - 2022-05-05
 * [#808](https://github.com/stripe/stripe-python/pull/808) API Updates
   * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
 
-## 2.75.0 - 2022-05-03
+## <a id="2-75-0"></a>2.75.0 - 2022-05-03
 * [#805](https://github.com/stripe/stripe-python/pull/805) API Updates
   * Add support for new resource `CashBalance`
 
-## 2.74.0 - 2022-04-21
+## <a id="2-74-0"></a>2.74.0 - 2022-04-21
 * [#796](https://github.com/stripe/stripe-python/pull/796) API Updates
   * Add support for `expire` test helper method on resource `Refund`
 
-## 2.73.0 - 2022-04-18
+## <a id="2-73-0"></a>2.73.0 - 2022-04-18
 * [#792](https://github.com/stripe/stripe-python/pull/792) [#794](https://github.com/stripe/stripe-python/pull/794) [#795](https://github.com/stripe/stripe-python/pull/795) API Updates
   * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
 
-## 2.72.0 - 2022-04-13
+## <a id="2-72-0"></a>2.72.0 - 2022-04-13
 * [#791](https://github.com/stripe/stripe-python/pull/791) API Updates
   * Add support for `increment_authorization` method on resource `PaymentIntent`
 
-## 2.71.0 - 2022-04-08
+## <a id="2-71-0"></a>2.71.0 - 2022-04-08
 * [#788](https://github.com/stripe/stripe-python/pull/788) API Updates
   * Add support for `apply_customer_balance` method on resource `PaymentIntent`
 
-## 2.70.0 - 2022-03-30
+## <a id="2-70-0"></a>2.70.0 - 2022-03-30
 * [#785](https://github.com/stripe/stripe-python/pull/785) API Updates
   * Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
 
-## 2.69.0 - 2022-03-29
+## <a id="2-69-0"></a>2.69.0 - 2022-03-29
+* [#773](https://github.com/stripe/stripe-python/pull/773) Add infrastructure for test-helper methods
+* [#782](https://github.com/stripe/stripe-python/pull/782) Revert Orders to use qualified name for upload_api_base
+* [#784](https://github.com/stripe/stripe-python/pull/784) Pin click dependency to 8.0.4 to avoid breakage in black
 * [#783](https://github.com/stripe/stripe-python/pull/783) API Updates
   * Add support for Search API
     * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
-* [#784](https://github.com/stripe/stripe-python/pull/784) Pin click dependency to 8.0.4 to avoid breakage in black
-* [#773](https://github.com/stripe/stripe-python/pull/773) Add infrastructure for test-helper methods
-* [#782](https://github.com/stripe/stripe-python/pull/782) Revert Orders to use qualified name for upload_api_base
 
-## 2.68.0 - 2022-03-23
+## <a id="2-68-0"></a>2.68.0 - 2022-03-23
+* [#777](https://github.com/stripe/stripe-python/pull/777) Add support for SearchResult.
 * [#781](https://github.com/stripe/stripe-python/pull/781) API Updates
   * Add support for `cancel` method on resource `Refund`
-* [#777](https://github.com/stripe/stripe-python/pull/777) Add support for SearchResult.
 
-## 2.67.0 - 2022-03-01
+## <a id="2-67-0"></a>2.67.0 - 2022-03-01
 * [#774](https://github.com/stripe/stripe-python/pull/774) API Updates
   * Add support for new resource `TestHelpers.TestClock`
 
-## 2.66.0 - 2022-02-16
+## <a id="2-66-0"></a>2.66.0 - 2022-02-16
 * [#771](https://github.com/stripe/stripe-python/pull/771) API Updates
   * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
 
-## 2.65.0 - 2022-01-20
+## <a id="2-65-0"></a>2.65.0 - 2022-01-20
+* [#763](https://github.com/stripe/stripe-python/pull/763) Start testing Python 3.10
 * [#766](https://github.com/stripe/stripe-python/pull/766) API Updates
   * Add support for new resource `PaymentLink`
-* [#763](https://github.com/stripe/stripe-python/pull/763) Start testing Python 3.10
 
-## 2.64.0 - 2021-12-21
-* [#757](https://github.com/stripe/stripe-python/pull/757) Update class custom methods to save list object parameters.
-* [#756](https://github.com/stripe/stripe-python/pull/756) Introduce custom listing methods on objects.
+## <a id="2-64-0"></a>2.64.0 - 2021-12-21
 * [#754](https://github.com/stripe/stripe-python/pull/754) Clarify metadata deletion message.
+* [#756](https://github.com/stripe/stripe-python/pull/756) Introduce custom listing methods on objects.
+* [#757](https://github.com/stripe/stripe-python/pull/757) Update class custom methods to save list object parameters.
 
-## 2.63.0 - 2021-11-16
+## <a id="2-63-0"></a>2.63.0 - 2021-11-16
 * [#748](https://github.com/stripe/stripe-python/pull/748) API Updates
   * Add support for new resource `ShippingRate`
 
-## 2.62.0 - 2021-11-11
+## <a id="2-62-0"></a>2.62.0 - 2021-11-11
 * [#745](https://github.com/stripe/stripe-python/pull/745) API Updates
   * Add support for `expire` method on resource `Checkout.Session`
 
-## 2.61.0 - 2021-10-11
+## <a id="2-61-0"></a>2.61.0 - 2021-10-11
+* [#736](https://github.com/stripe/stripe-python/pull/736) Stop sending raw exception message as part of Stripe user agent.
 * [#738](https://github.com/stripe/stripe-python/pull/738) API Updates
   * Add support for `list_payment_methods` method on resource `Customer`
-* [#736](https://github.com/stripe/stripe-python/pull/736) Stop sending raw exception message as part of Stripe user agent.
 
-## 2.60.0 - 2021-07-14
+## <a id="2-60-0"></a>2.60.0 - 2021-07-14
 * [#728](https://github.com/stripe/stripe-python/pull/728) API Updates
   * Add support for `list_computed_upfront_line_items` method on resource `Quote`
 
-## 2.59.0 - 2021-07-09
+## <a id="2-59-0"></a>2.59.0 - 2021-07-09
 * [#727](https://github.com/stripe/stripe-python/pull/727) [#725](https://github.com/stripe/stripe-python/pull/725) Add support for new `Quote` API.
 
-## 2.58.0 - 2021-06-04
+## <a id="2-58-0"></a>2.58.0 - 2021-06-04
 * [#722](https://github.com/stripe/stripe-python/pull/722) API Updates
   * Add support for new `TaxCode` API.
 
-## 2.57.0 - 2021-05-19
+## <a id="2-57-0"></a>2.57.0 - 2021-05-19
 * [#720](https://github.com/stripe/stripe-python/pull/720) Add support for Identity VerificationSession and VerificationReport APIs
 
-## 2.56.0 - 2021-02-22
+## <a id="2-56-0"></a>2.56.0 - 2021-02-22
 * [#713](https://github.com/stripe/stripe-python/pull/713) Add support for the Billing Portal Configuration API
 
-## 2.55.2 - 2021-02-05
+## <a id="2-55-2"></a>2.55.2 - 2021-02-05
 * [#704](https://github.com/stripe/stripe-python/pull/704) Fix CA bundle path issue
 
-## 2.55.1 - 2020-12-01
-* [#698](https://github.com/stripe/stripe-python/pull/698) Fix issue where StripeObjects in lists would not be converted to dicts
-* [#699](https://github.com/stripe/stripe-python/pull/699) Start testing Python 3.9
+## <a id="2-55-1"></a>2.55.1 - 2020-12-01
 * [#691](https://github.com/stripe/stripe-python/pull/691) Include the examples in the built sources
+* [#699](https://github.com/stripe/stripe-python/pull/699) Start testing Python 3.9
+* [#698](https://github.com/stripe/stripe-python/pull/698) Fix issue where StripeObjects in lists would not be converted to dicts
 
-## 2.55.0 - 2020-10-14
+## <a id="2-55-0"></a>2.55.0 - 2020-10-14
 * [#684](https://github.com/stripe/stripe-python/pull/684) Add support for the Payout Reverse API
 
-## 2.54.0 - 2020-09-29
-* [#681](https://github.com/stripe/stripe-python/pull/681) Add support for the `SetupAttempt` resource and List API
+## <a id="2-54-0"></a>2.54.0 - 2020-09-29
 * 2.52.0 and 2.53.0 were empty releases that contained no additional changes.
+* [#681](https://github.com/stripe/stripe-python/pull/681) Add support for the `SetupAttempt` resource and List API
+
+## <a id="2-53-0"></a>2.53.0 - 2020-09-24
+
+## <a id="2-52-0"></a>2.52.0 - 2020-09-24
 
-## 2.51.0 - 2020-09-02
+## <a id="2-51-0"></a>2.51.0 - 2020-09-02
 * [#676](https://github.com/stripe/stripe-python/pull/676) Add support for the Issuing Dispute Submit API
 
-## 2.50.0 - 2020-08-05
+## <a id="2-50-0"></a>2.50.0 - 2020-08-05
 * [#669](https://github.com/stripe/stripe-python/pull/669) Add support for the `PromotionCode` resource and APIs
 
-## 2.49.0 - 2020-07-17
+## <a id="2-49-0"></a>2.49.0 - 2020-07-17
 * [#665](https://github.com/stripe/stripe-python/pull/665) Support stripe.File.create(stripe_version='...')
 
-## 2.48.0 - 2020-05-11
+## <a id="2-48-0"></a>2.48.0 - 2020-05-11
 * [#655](https://github.com/stripe/stripe-python/pull/655) Add support for the `LineItem` resource and APIs
 
-## 2.47.0 - 2020-04-29
+## <a id="2-47-0"></a>2.47.0 - 2020-04-29
 * [#652](https://github.com/stripe/stripe-python/pull/652) Add support for the `Price` resource and APIs
 
-## 2.46.0 - 2020-04-22
+## <a id="2-46-0"></a>2.46.0 - 2020-04-22
 * [#651](https://github.com/stripe/stripe-python/pull/651) Add support for `billing_portal` namespace and `Session` resource and APIs
 
-## 2.45.0 - 2020-04-06
+## <a id="2-45-0"></a>2.45.0 - 2020-04-06
 * [#648](https://github.com/stripe/stripe-python/pull/648) Add support for Express links in `authorize_url` for `OAuth`
 
-## 2.44.0 - 2020-03-23
+## <a id="2-44-0"></a>2.44.0 - 2020-03-23
 * [#646](https://github.com/stripe/stripe-python/pull/646) Allow overriding API key in OAuth methods
 
-## 2.43.0 - 2020-02-26
+## <a id="2-43-0"></a>2.43.0 - 2020-02-26
 * [#644](https://github.com/stripe/stripe-python/pull/644) Add support for listing Checkout `Session`
 
-## 2.42.0 - 2020-01-14
+## <a id="2-42-0"></a>2.42.0 - 2020-01-14
+* [#637](https://github.com/stripe/stripe-python/pull/637) Start testing Python 3.8
 * [#640](https://github.com/stripe/stripe-python/pull/640) Add support for `CreditNoteLineItem`
 * [#639](https://github.com/stripe/stripe-python/pull/639) Pin black version
-* [#637](https://github.com/stripe/stripe-python/pull/637) Start testing Python 3.8
 
-## 2.41.1 - 2019-12-30
-* [#636](https://github.com/stripe/stripe-python/pull/636) Fix uploading files with Unicode names (Python 2.7)
-* [#635](https://github.com/stripe/stripe-python/pull/635) Update Python API docs inline link
+## <a id="2-41-1"></a>2.41.1 - 2019-12-30
 * [#631](https://github.com/stripe/stripe-python/pull/631) Update `proxy.py`
+* [#635](https://github.com/stripe/stripe-python/pull/635) Update Python API docs inline link
+* [#636](https://github.com/stripe/stripe-python/pull/636) Fix uploading files with Unicode names (Python 2.7)
 
-## 2.41.0 - 2019-11-26
+## <a id="2-41-0"></a>2.41.0 - 2019-11-26
 * [#630](https://github.com/stripe/stripe-python/pull/630) Add support for `CreditNote` preview
 
-## 2.40.0 - 2019-11-08
+## <a id="2-40-0"></a>2.40.0 - 2019-11-08
 * [#627](https://github.com/stripe/stripe-python/pull/627) Add list_usage_record_summaries and list_source_transactions
 
-## 2.39.0 - 2019-11-06
+## <a id="2-39-0"></a>2.39.0 - 2019-11-06
 * [#625](https://github.com/stripe/stripe-python/pull/625) Add support for `Mandate`
 
-## 2.38.0 - 2019-10-29
-* [#623](https://github.com/stripe/stripe-python/pull/623) Add support for reverse pagination
+## <a id="2-38-0"></a>2.38.0 - 2019-10-29
 * [#624](https://github.com/stripe/stripe-python/pull/624) Contributor Convenant
+* [#623](https://github.com/stripe/stripe-python/pull/623) Add support for reverse pagination
 
-## 2.37.2 - 2019-10-04
+## <a id="2-37-2"></a>2.37.2 - 2019-10-04
 * [#621](https://github.com/stripe/stripe-python/pull/621) Implement support for stripe-should-retry and retry-after headers
 
-## 2.37.1 - 2019-09-26
+## <a id="2-37-1"></a>2.37.1 - 2019-09-26
 * [#620](https://github.com/stripe/stripe-python/pull/620) Check that `error` is a dict before trying to use it to create a `StripeError`
 
-## 2.37.0 - 2019-09-26
-* [#619](https://github.com/stripe/stripe-python/pull/619) Add `ErrorObject` to `StripeError` exceptions
+## <a id="2-37-0"></a>2.37.0 - 2019-09-26
 * [#616](https://github.com/stripe/stripe-python/pull/616) Pass `CFLAGS` and `LDFLAGS` when running tests
+* [#619](https://github.com/stripe/stripe-python/pull/619) Add `ErrorObject` to `StripeError` exceptions
 
-## 2.36.2 - 2019-09-12
+## <a id="2-36-2"></a>2.36.2 - 2019-09-12
 * [#614](https://github.com/stripe/stripe-python/pull/614) Use `OrderedDict` to maintain key order in API requests and responses
 
-## 2.36.1 - 2019-09-11
+## <a id="2-36-1"></a>2.36.1 - 2019-09-11
 * [#612](https://github.com/stripe/stripe-python/pull/612) Use `ListObject` properties as default values in request methods
 
-## 2.36.0 - 2019-09-10
+## <a id="2-36-0"></a>2.36.0 - 2019-09-10
 * [#610](https://github.com/stripe/stripe-python/pull/610) Add support for header parameters in `ListObject` request methods
 
-## 2.35.1 - 2019-08-20
-* [#605](https://github.com/stripe/stripe-python/pull/605) Fix automatic retries of failed requests
+## <a id="2-35-1"></a>2.35.1 - 2019-08-20
 * [#606](https://github.com/stripe/stripe-python/pull/606) Clarify what `max_network_retries` does
+* [#605](https://github.com/stripe/stripe-python/pull/605) Fix automatic retries of failed requests
 
-## 2.35.0 - 2019-08-12
+## <a id="2-35-0"></a>2.35.0 - 2019-08-12
 * [#607](https://github.com/stripe/stripe-python/pull/607) Add `SubscriptionItem.create_usage_record` method
 
-## 2.34.0 - 2019-08-09
+## <a id="2-34-0"></a>2.34.0 - 2019-08-09
 * [#604](https://github.com/stripe/stripe-python/pull/604) Remove subscription schedule revisions
   - This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
 
-## 2.33.2 - 2019-08-06
+## <a id="2-33-2"></a>2.33.2 - 2019-08-06
 * [#601](https://github.com/stripe/stripe-python/pull/601) Add support for passing full objects instead of IDs to custom methods
 * [#603](https://github.com/stripe/stripe-python/pull/603) Bump vendored six to latest version
 
-## 2.33.1 - 2019-08-06
+## <a id="2-33-1"></a>2.33.1 - 2019-08-06
 * [#599](https://github.com/stripe/stripe-python/pull/599) Fix `del` statement to not raise `KeyError`
 
-## 2.33.0 - 2019-07-30
+## <a id="2-33-0"></a>2.33.0 - 2019-07-30
 * [#595](https://github.com/stripe/stripe-python/pull/595) Listing `BalanceTransaction` objects now uses `/v1/balance_transactions` instead of `/v1/balance/history`
 
-## 2.32.1 - 2019-07-08
+## <a id="2-32-1"></a>2.32.1 - 2019-07-08
 * [#592](https://github.com/stripe/stripe-python/pull/592) Fix argument name conflict
 
-## 2.32.0 - 2019-06-27
+## <a id="2-32-0"></a>2.32.0 - 2019-06-27
 * [#590](https://github.com/stripe/stripe-python/pull/590) Add support for the `SetupIntent` resource and APIs
 
-## 2.31.0 - 2019-06-24
+## <a id="2-31-0"></a>2.31.0 - 2019-06-24
 * [#587](https://github.com/stripe/stripe-python/pull/587) Enable request latency telemetry by default
 
-## 2.30.1 - 2019-06-20
+## <a id="2-30-1"></a>2.30.1 - 2019-06-20
 * [#589](https://github.com/stripe/stripe-python/pull/589) Fix support for `CustomerBalanceTransaction`
 
-## 2.30.0 - 2019-06-17
+## <a id="2-30-0"></a>2.30.0 - 2019-06-17
 * [#564](https://github.com/stripe/stripe-python/pull/564) Add support for `CustomerBalanceTransaction` resource and APIs
 
-## 2.29.4 - 2019-06-03
+## <a id="2-29-4"></a>2.29.4 - 2019-06-03
 * [#583](https://github.com/stripe/stripe-python/pull/583) Remove Poetry and reinstate `setup.py`
 
-## 2.29.3 - 2019-05-31
+## <a id="2-29-3"></a>2.29.3 - 2019-05-31
 Version 2.29.2 was non-functional due to a bugged `version.py` file. This release is identical to 2.29.2 save for the version number.
 
-## 2.29.2 - 2019-05-31
+## <a id="2-29-2"></a>2.29.2 - 2019-05-31
 * [#561](https://github.com/stripe/stripe-python/pull/561) Replace pipenv with poetry
 
-## 2.29.1 - 2019-05-31
+## <a id="2-29-1"></a>2.29.1 - 2019-05-31
 * [#578](https://github.com/stripe/stripe-python/pull/578) Verify signatures before deserializing events
 
-## 2.29.0 - 2019-05-23
+## <a id="2-29-0"></a>2.29.0 - 2019-05-23
 * [#575](https://github.com/stripe/stripe-python/pull/575) Add support for `radar.early_fraud_warning` resource
 
-## 2.28.2 - 2019-05-23
+## <a id="2-28-2"></a>2.28.2 - 2019-05-23
 * [#574](https://github.com/stripe/stripe-python/pull/574) Fix a few more code quality issues
 
-## 2.28.1 - 2019-05-20
+## <a id="2-28-1"></a>2.28.1 - 2019-05-20
 * [#572](https://github.com/stripe/stripe-python/pull/572) Fix a few code quality issues
 
-## 2.28.0 - 2019-05-14
+## <a id="2-28-0"></a>2.28.0 - 2019-05-14
 * [#566](https://github.com/stripe/stripe-python/pull/566) Add support for the `Capability` resource and APIs
 
-## 2.27.0 - 2019-04-24
+## <a id="2-27-0"></a>2.27.0 - 2019-04-24
 * [#554](https://github.com/stripe/stripe-python/pull/554) Add support for the `TaxRate` resource and APIs
 
-## 2.26.0 - 2019-04-22
+## <a id="2-26-0"></a>2.26.0 - 2019-04-22
 * [#555](https://github.com/stripe/stripe-python/pull/555) Add support for the `TaxId` resource and APIs
 
-## 2.25.0 - 2019-04-18
+## <a id="2-25-0"></a>2.25.0 - 2019-04-18
 * [#551](https://github.com/stripe/stripe-python/pull/551) Add support for the `CreditNote` resource and APIs
 
-## 2.24.1 - 2019-04-08
+## <a id="2-24-1"></a>2.24.1 - 2019-04-08
 * [#550](https://github.com/stripe/stripe-python/pull/550) Fix encoding of nested parameters in multipart requests
 
-## 2.24.0 - 2019-04-03
-* [#543](https://github.com/stripe/stripe-python/pull/543) Add `delete` class method on deletable API resources
+## <a id="2-24-0"></a>2.24.0 - 2019-04-03
 * [#547](https://github.com/stripe/stripe-python/pull/547) Add class methods for all custom API requests (e.g. `Charge.capture`)
+* [#543](https://github.com/stripe/stripe-python/pull/543) Add `delete` class method on deletable API resources
 
-## 2.23.0 - 2019-03-18
+## <a id="2-23-0"></a>2.23.0 - 2019-03-18
+* [#542](https://github.com/stripe/stripe-python/pull/542) Add support for deleting a Terminal `Location` and `Reader`
 * [#537](https://github.com/stripe/stripe-python/pull/537) Add support for the `PaymentMethod` resource and APIs
 * [#540](https://github.com/stripe/stripe-python/pull/540) Add support for retrieving a Checkout `Session`
-* [#542](https://github.com/stripe/stripe-python/pull/542) Add support for deleting a Terminal `Location` and `Reader`
 
-## 2.22.0 - 2019-03-14
+## <a id="2-22-0"></a>2.22.0 - 2019-03-14
 * [#541](https://github.com/stripe/stripe-python/pull/541) Add `stripe.util.convert_to_dict` method for converting `StripeObject` instances to regular `dict`s
 
-## 2.21.0 - 2019-02-12
+## <a id="2-21-0"></a>2.21.0 - 2019-02-12
 * [#532](https://github.com/stripe/stripe-python/pull/532) Add support for subscription schedules
 
-## 2.20.3 - 2019-01-30
+## <a id="2-20-3"></a>2.20.3 - 2019-01-30
 * [#530](https://github.com/stripe/stripe-python/pull/530) Fix client telemetry implementation
 
-## 2.20.2 - 2019-01-30
+## <a id="2-20-2"></a>2.20.2 - 2019-01-30
 * [#534](https://github.com/stripe/stripe-python/pull/534) Fix session initialization for multi-threaded environments
 
-## 2.20.1 - 2019-01-30
+## <a id="2-20-1"></a>2.20.1 - 2019-01-30
 * [#531](https://github.com/stripe/stripe-python/pull/531) Make `RequestsClient` thread-safe
 
-## 2.20.0 - 2019-01-29
+## <a id="2-20-0"></a>2.20.0 - 2019-01-29
 * [#526](https://github.com/stripe/stripe-python/pull/526) Reuse the default HTTP client by default
 
-## 2.19.0 - 2019-01-23
+## <a id="2-19-0"></a>2.19.0 - 2019-01-23
 * [#524](https://github.com/stripe/stripe-python/pull/524) Rename `CheckoutSession` to `Session` and move it under the `checkout` namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.
 
-## 2.18.1 - 2019-01-21
+## <a id="2-18-1"></a>2.18.1 - 2019-01-21
 * [#525](https://github.com/stripe/stripe-python/pull/525) Properly serialize `individual` on `Account` objects
 
-## 2.18.0 - 2019-01-15
+## <a id="2-18-0"></a>2.18.0 - 2019-01-15
 * [#518](https://github.com/stripe/stripe-python/pull/518) Add configurable telemetry to gather information on client-side request latency
 
-## 2.17.0 - 2018-12-21
+## <a id="2-17-0"></a>2.17.0 - 2018-12-21
 * [#510](https://github.com/stripe/stripe-python/pull/510) Add support for Checkout sessions
 
-## 2.16.0 - 2018-12-10
+## <a id="2-16-0"></a>2.16.0 - 2018-12-10
 * [#507](https://github.com/stripe/stripe-python/pull/507) Add support for account links
 
-## 2.15.0 - 2018-11-30
+## <a id="2-15-0"></a>2.15.0 - 2018-11-30
 * [#503](https://github.com/stripe/stripe-python/pull/503) Add support for providing custom CA certificate bundle
 
-## 2.14.0 - 2018-11-28
+## <a id="2-14-0"></a>2.14.0 - 2018-11-28
 * [#500](https://github.com/stripe/stripe-python/pull/500) Add support for `Review` for Radar
 
-## 2.13.0 - 2018-11-27
+## <a id="2-13-0"></a>2.13.0 - 2018-11-27
 * [#489](https://github.com/stripe/stripe-python/pull/489) Add support for `ValueList` and `ValueListItem` for Radar
 
-## 2.12.1 - 2018-11-22
+## <a id="2-12-1"></a>2.12.1 - 2018-11-22
 * [#495](https://github.com/stripe/stripe-python/pull/495) Make `StripeResponse` a new-style class
 
-## 2.12.0 - 2018-11-08
+## <a id="2-12-0"></a>2.12.0 - 2018-11-08
 * [#483](https://github.com/stripe/stripe-python/pull/483) Add new API endpoints for the `Invoice` resource.
 
-## 2.11.1 - 2018-11-08
+## <a id="2-11-1"></a>2.11.1 - 2018-11-08
 * [#491](https://github.com/stripe/stripe-python/pull/491) Bump minimum requests version to 2.20.0 (for [CVE-2018-18074](https://nvd.nist.gov/vuln/detail/CVE-2018-18074))
 
-## 2.11.0 - 2018-10-30
+## <a id="2-11-0"></a>2.11.0 - 2018-10-30
 * [#482](https://github.com/stripe/stripe-python/pull/482) Add support for the `Person` resource
 * [#484](https://github.com/stripe/stripe-python/pull/484) Add support for the `WebhookEndpoint` resource
 
-## 2.10.1 - 2018-10-02
+## <a id="2-10-1"></a>2.10.1 - 2018-10-02
 * [#481](https://github.com/stripe/stripe-python/pull/481) Correct behavior of `stripe.max_network_retries` if it's reset after initial use
 
-## 2.10.0 - 2018-09-24
+## <a id="2-10-0"></a>2.10.0 - 2018-09-24
 * [#478](https://github.com/stripe/stripe-python/pull/478) Add support for Stripe Terminal
 
-## 2.9.0 - 2018-09-24
+## <a id="2-9-0"></a>2.9.0 - 2018-09-24
 * [#477](https://github.com/stripe/stripe-python/pull/477) Rename `FileUpload` to `File`
 
-## 2.8.1 - 2018-09-13
+## <a id="2-8-1"></a>2.8.1 - 2018-09-13
 * [#474](https://github.com/stripe/stripe-python/pull/474) Don't URL-encode square brackets
 * [#473](https://github.com/stripe/stripe-python/pull/473) Integer-index encode all arrays
 
-## 2.8.0 - 2018-09-10
+## <a id="2-8-0"></a>2.8.0 - 2018-09-10
 * [#470](https://github.com/stripe/stripe-python/pull/470) Add support for automatic network retries
 
-## 2.7.0 - 2018-09-05
+## <a id="2-7-0"></a>2.7.0 - 2018-09-05
 * [#469](https://github.com/stripe/stripe-python/pull/469) Add support for reporting resources
 
-## 2.6.0 - 2018-08-23
+## <a id="2-6-0"></a>2.6.0 - 2018-08-23
 * [#467](https://github.com/stripe/stripe-python/pull/467) Add support for usage record summaries
 
-## 2.5.0 - 2018-08-16
+## <a id="2-5-0"></a>2.5.0 - 2018-08-16
 * [#463](https://github.com/stripe/stripe-python/pull/463) Remove unsupported Bitcoin endpoints (this is technically a breaking change, but we're releasing as a minor version because none of these APIs were usable anyway)
 
-## 2.4.0 - 2018-08-03
+## <a id="2-4-0"></a>2.4.0 - 2018-08-03
 * [#460](https://github.com/stripe/stripe-python/pull/460) Add cancel support for topups
 * [#461](https://github.com/stripe/stripe-python/pull/461) Add support for file links
 
-## 2.3.0 - 2018-07-27
+## <a id="2-3-0"></a>2.3.0 - 2018-07-27
 * [#456](https://github.com/stripe/stripe-python/pull/456) Add support for Sigma scheduled query run objects
 
-## 2.2.0 - 2018-07-26
+## <a id="2-2-0"></a>2.2.0 - 2018-07-26
 * [#455](https://github.com/stripe/stripe-python/pull/455) Add support for Stripe Issuing
 
-## 2.1.0 - 2018-07-25
+## <a id="2-1-0"></a>2.1.0 - 2018-07-25
 * [#452](https://github.com/stripe/stripe-python/pull/452) Add `InvoiceLineItem` class
 
-## 2.0.3 - 2018-07-19
+## <a id="2-0-3"></a>2.0.3 - 2018-07-19
 * [#450](https://github.com/stripe/stripe-python/pull/450) Internal improvements to `ApiResource.class_url`
 
-## 2.0.2 - 2018-07-18
+## <a id="2-0-2"></a>2.0.2 - 2018-07-18
 * [#448](https://github.com/stripe/stripe-python/pull/448) Avoid duplicate dependency on `requests` with Python 2.7
 
-## 2.0.1 - 2018-07-10
+## <a id="2-0-1"></a>2.0.1 - 2018-07-10
 * [#445](https://github.com/stripe/stripe-python/pull/445) Fix `setup.py`
 
-## 2.0.0 - 2018-07-10
+## <a id="2-0-0"></a>2.0.0 - 2018-07-10
 Major version release. List of backwards incompatible changes to watch out for:
-* The minimum Python versions are now 2.7 / 3.4. If you're using Python 2.6 or 3.3, consider upgrading to a more recent version.
-* Stripe exception classes should now be accessed via `stripe.error` rather than just `stripe`
-* Some older deprecated methods have been removed
-* Trying to detach an unattached source will now raise a `stripe.error.InvalidRequestError` exception instead of a `NotImplementedError` exception
 
 For more information, check out the [migration guide for v2](https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v2)
 
 Pull requests included in this release:
+
 * [#385](https://github.com/stripe/stripe-python/pull/385) Drop support for Python 2.6 and 3.3
 * [#384](https://github.com/stripe/stripe-python/pull/384) Use py.test for tests
 * [#399](https://github.com/stripe/stripe-python/pull/399) Remove deprecated code
@@ -2568,448 +2568,526 @@ Pull requests included in this release:
 * [#403](https://github.com/stripe/stripe-python/pull/403) Update setup.py and test flow
 * [#410](https://github.com/stripe/stripe-python/pull/410) Use pipenv
 * [#415](https://github.com/stripe/stripe-python/pull/415) Change exception when detaching unattached sources from `NotImplementedError` to `stripe.error.InvalidRequestError`
+* The minimum Python versions are now 2.7 / 3.4. If you're using Python 2.6 or 3.3, consider upgrading to a more recent version.
+* Some older deprecated methods have been removed
+* Stripe exception classes should now be accessed via `stripe.error` rather than just `stripe`
+* Trying to detach an unattached source will now raise a `stripe.error.InvalidRequestError` exception instead of a `NotImplementedError` exception
 
-## 1.84.2 - 2018-07-06
+## <a id="1-84-2"></a>1.84.2 - 2018-07-06
 * [#441](https://github.com/stripe/stripe-python/pull/441) Better (hopefully) fix for serialization of empty `ListObject`s
 
-## 1.84.1 - 2018-07-04
+## <a id="1-84-1"></a>1.84.1 - 2018-07-04
 * [#439](https://github.com/stripe/stripe-python/pull/439) Fix serialization of empty `ListObject`s
 
-## 1.84.0 - 2018-06-29
+## <a id="1-84-0"></a>1.84.0 - 2018-06-29
 * [#436](https://github.com/stripe/stripe-python/pull/436) Add support for payment intents
 
-## 1.83.0 - 2018-06-28
+## <a id="1-83-0"></a>1.83.0 - 2018-06-28
 * [#437](https://github.com/stripe/stripe-python/pull/437) Add support for `partner_id` in `stripe.set_app_info()`
 
-## 1.82.2 - 2018-06-19
+## <a id="1-82-2"></a>1.82.2 - 2018-06-19
 * [#365](https://github.com/stripe/stripe-python/pull/365) Add `__repr__` methods to `StripeError` exception classes
 
-## 1.82.1 - 2018-05-14
+## <a id="1-82-1"></a>1.82.1 - 2018-05-14
 * [#430](https://github.com/stripe/stripe-python/pull/430) Handle the case where request ID is `None` when formatting errors
 
-## 1.82.0 - 2018-05-13
+## <a id="1-82-0"></a>1.82.0 - 2018-05-13
 * [#422](https://github.com/stripe/stripe-python/pull/422) Add `user_mesage` to `StripeError` for a way in Python 3 to avoid the "Request req_...:" string normally appended to error messages
 
-## 1.81.0 - 2018-05-10
+## <a id="1-81-0"></a>1.81.0 - 2018-05-10
 * [#425](https://github.com/stripe/stripe-python/pull/425) Add support for issuer fraud records
 
-## 1.80.0 - 2018-04-24
+## <a id="1-80-0"></a>1.80.0 - 2018-04-24
 * [#421](https://github.com/stripe/stripe-python/pull/421) Add support for flexible billing and usage records
 
-## 1.79.1 - 2018-02-27
+## <a id="1-79-1"></a>1.79.1 - 2018-02-27
 * [#401](https://github.com/stripe/stripe-python/pull/401) Drop conditional dependencies that incorrectly led to an added `simplejson` dependency in Python 3+ after switching to universal wheel
 
-## 1.79.0 - 2018-02-23
-* [#397](https://github.com/stripe/stripe-python/pull/397) Build universal wheels by default
+## <a id="1-79-0"></a>1.79.0 - 2018-02-23
 * [#398](https://github.com/stripe/stripe-python/pull/398) Add support for `code` attribute on all Stripe exceptions
+* [#397](https://github.com/stripe/stripe-python/pull/397) Build universal wheels by default
 
-## 1.78.0 - 2018-02-21
+## <a id="1-78-0"></a>1.78.0 - 2018-02-21
 * [#396](https://github.com/stripe/stripe-python/pull/396) Add support for topups
 
-## 1.77.2 - 2018-02-08
+## <a id="1-77-2"></a>1.77.2 - 2018-02-08
 * [#394](https://github.com/stripe/stripe-python/pull/394) Make `last_response` available after calling `save()`
 
-## 1.77.1 - 2018-01-12
+## <a id="1-77-1"></a>1.77.1 - 2018-01-12
 * [#389](https://github.com/stripe/stripe-python/pull/389) Register unsaved attributes on assignment regardless of new value
 
-## 1.77.0 - 2017-12-21
+## <a id="1-77-0"></a>1.77.0 - 2017-12-21
 * [#371](https://github.com/stripe/stripe-python/pull/371) Add accessor `last_response` on `StripeObject` for accessing request ID and other metadata
 
-## 1.76.0 - 2017-12-21
+## <a id="1-76-0"></a>1.76.0 - 2017-12-21
 * [#382](https://github.com/stripe/stripe-python/pull/382) Add new `IdempotencyError` type
 
-## 1.75.3 - 2017-12-05
+## <a id="1-75-3"></a>1.75.3 - 2017-12-05
 * [#378](https://github.com/stripe/stripe-python/pull/378) Log encoded version of parameters instead of raw POST data
 
-## 1.75.2 - 2017-12-05
+## <a id="1-75-2"></a>1.75.2 - 2017-12-05
 * (Accidental no-op release. See 1.75.3.)
 
-## 1.75.1 - 2017-11-29
+## <a id="1-75-1"></a>1.75.1 - 2017-11-29
 * [#372](https://github.com/stripe/stripe-python/pull/372) Add only changed values to `_unsaved_values` in `StripeObject`
 * [#375](https://github.com/stripe/stripe-python/pull/375) Use a custom JSON encoder to handle `datetime` objects when serializing `StripeObject`s
 
-## 1.75.0 - 2017-11-08
+## <a id="1-75-0"></a>1.75.0 - 2017-11-08
 * [#369](https://github.com/stripe/stripe-python/pull/369) Make custom actions on various resources (e.g. `Account.reject`) more consistent with other APIs
 
-## 1.74.0 - 2017-11-07
+## <a id="1-74-0"></a>1.74.0 - 2017-11-07
 * [#368](https://github.com/stripe/stripe-python/pull/368) Remove API that allowed the creation of new disputes (this was an erroneous addition; it never worked because the API would not allow it)
 
-## 1.73.0 - 2017-11-02
+## <a id="1-73-0"></a>1.73.0 - 2017-11-02
 * [#364](https://github.com/stripe/stripe-python/pull/364) Switch to vendored version of the `six` package for compatibility between Python 2 and 3
 
-## 1.72.0 - 2017-10-31
+## <a id="1-72-0"></a>1.72.0 - 2017-10-31
 * [#361](https://github.com/stripe/stripe-python/pull/361) Support for exchange rates APIs
 
-## 1.71.2 - 2017-10-31
+## <a id="1-71-2"></a>1.71.2 - 2017-10-31
 * [#362](https://github.com/stripe/stripe-python/pull/362) Fix balance transaction and invoice item conversion into `StripeObject`s
 
-## 1.71.1 - 2017-10-27
+## <a id="1-71-1"></a>1.71.1 - 2017-10-27
 * [#360](https://github.com/stripe/stripe-python/pull/360) Fix `BytesWarning` being issued on logging in Python 3
 
-## 1.71.0 - 2017-10-26
+## <a id="1-71-0"></a>1.71.0 - 2017-10-26
 * [#359](https://github.com/stripe/stripe-python/pull/359) Support for listing source transactions
 
-## 1.70.0 - 2017-10-23
+## <a id="1-70-0"></a>1.70.0 - 2017-10-23
 * [#356](https://github.com/stripe/stripe-python/pull/356) Support uploading files with `StringIO` in addition to a file on disk
 
-## 1.69.0 - 2017-10-20
+## <a id="1-69-0"></a>1.69.0 - 2017-10-20
 * [#351](https://github.com/stripe/stripe-python/pull/351) Break resource.py module into separate ones for each type of resource
-    * Classes are still into resource.py for backwards compatibility
+  * Classes are still into resource.py for backwards compatibility
 * [#353](https://github.com/stripe/stripe-python/pull/353) Fix unpickling `StripeObject` in Python 3
 
-## 1.68.0 - 2017-10-19
+## <a id="1-68-0"></a>1.68.0 - 2017-10-19
 * [#350](https://github.com/stripe/stripe-python/pull/350) Add static methods to manipulate resources from parent
-    * `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
-    * `ApplicationFee` gains methods for refunds
-    * `Customer` gains methods for sources
-    * `Transfer` gains methods for reversals
+  * `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
+  * `ApplicationFee` gains methods for refunds
+  * `Customer` gains methods for sources
+  * `Transfer` gains methods for reversals
 
-## 1.67.0 - 2017-10-11
+## <a id="1-67-0"></a>1.67.0 - 2017-10-11
 * [#349](https://github.com/stripe/stripe-python/pull/349) Rename source `delete` to `detach` (and deprecate the former)
 
-## 1.66.0 - 2017-09-29
+## <a id="1-66-0"></a>1.66.0 - 2017-09-29
 * Support length reads on list objects
 
-## 1.65.1 - 2017-09-21
+## <a id="1-65-1"></a>1.65.1 - 2017-09-21
 * Handle `bytearray` and `bytes` (in addition to string) in `Webhook.construct_event`
 
-## 1.65.0 - 2017-09-07
+## <a id="1-65-0"></a>1.65.0 - 2017-09-07
 * Add support for passing a `stripe_version` argument to all API requests
 
-## 1.64.0 - 2017-09-01
+## <a id="1-64-0"></a>1.64.0 - 2017-09-01
 * Error when an invalid type (i.e. non-string) passed as an API method argument
 
-## 1.63.1 - 2017-09-01
+## <a id="1-63-1"></a>1.63.1 - 2017-09-01
 * Fix serialization of `items` on Relay order creation and order return
 
-## 1.63.0 - 2017-08-29
+## <a id="1-63-0"></a>1.63.0 - 2017-08-29
 * Add support for `InvalidClientError` OAuth error
 
-## 1.62.1 - 2017-08-07
+## <a id="1-62-1"></a>1.62.1 - 2017-08-07
 * Change serialization of subscription items on update to encoded as an integer-indexed map
 
-## 1.62.0 - 2017-06-27
+## <a id="1-62-0"></a>1.62.0 - 2017-06-27
 * `pay` on invoice can now take parameter
 
-## 1.61.0 - 2017-06-24
+## <a id="1-61-0"></a>1.61.0 - 2017-06-24
 * Expose `code` on `InvalidRequestError`
 
-## 1.60.0 - 2017-06-19
+## <a id="1-60-0"></a>1.60.0 - 2017-06-19
 * Add support for ephemeral keys
 
-## 1.59.0 - 2017-06-07
+## <a id="1-59-0"></a>1.59.0 - 2017-06-07
 * Refactor OAuth implementation to have dedicated classes for errors
 
-## 1.58.0 - 2017-06-02
+## <a id="1-58-0"></a>1.58.0 - 2017-06-02
 * Re-use connections with Pycurl
 
-## 1.57.1 - 2017-05-31
+## <a id="1-57-1"></a>1.57.1 - 2017-05-31
 * Fix the pycurl client
 
-## 1.57.0 - 2017-05-26
+## <a id="1-57-0"></a>1.57.0 - 2017-05-26
 * Add `api_key` parameter to webhook's `construct_event`
 
-## 1.56.0 - 2017-05-25
+## <a id="1-56-0"></a>1.56.0 - 2017-05-25
 * Add support for account login links
 
-## 1.55.2 - 2017-05-11
+## <a id="1-55-2"></a>1.55.2 - 2017-05-11
 * Remove Requests constraint from 1.55.1 now that they've patched (as of 2.14.2)
 
-## 1.55.1 - 2017-05-10
+## <a id="1-55-1"></a>1.55.1 - 2017-05-10
 * Constrain Requests to < 2.13.0 if on setuptools < 18.0.0
 
-## 1.55.0 - 2017-04-28
+## <a id="1-55-0"></a>1.55.0 - 2017-04-28
 * Support for checking webhook signatures
 
-## 1.54.0 - 2017-04-28
+## <a id="1-54-0"></a>1.54.0 - 2017-04-28
 * Add `stripe.set_app_info` for use by plugin creators
 
-## 1.53.0 - 2017-04-06
+## <a id="1-53-0"></a>1.53.0 - 2017-04-06
 * Add support for payouts and recipient transfers
 
-## 1.52.0 - 2017-04-06
+## <a id="1-52-0"></a>1.52.0 - 2017-04-06
 * No-op release: peg test suite to a specific API version
 
-## 1.51.0 - 2017-03-20
+## <a id="1-51-0"></a>1.51.0 - 2017-03-20
 * Support OAuth operations (getting a token and deauthorizing)
 
-## 1.50.0 - 2017-03-17
+## <a id="1-50-0"></a>1.50.0 - 2017-03-17
 * Support for detaching sources from customers
 
-## 1.49.0 - 2017-03-13
+## <a id="1-49-0"></a>1.49.0 - 2017-03-13
 * Accept `session` argument for `RequestsClient`
 
-## 1.48.1 - 2017-02-21
+## <a id="1-48-1"></a>1.48.1 - 2017-02-21
 * Fix encoding of parameters when fetching upcoming invoices
 
-## 1.48.0 - 2017-02-21
+## <a id="1-48-0"></a>1.48.0 - 2017-02-21
 * Add `Account.modify_external_account` to modify an account in one API call
 * Add `Customer.modify_source` to modify a source in one API call
 
-## 1.47.0 - 2017-01-18
+## <a id="1-47-0"></a>1.47.0 - 2017-01-18
 * Allow sources to be updated
 
-## 1.46.0 - 2017-01-06
+## <a id="1-46-0"></a>1.46.0 - 2017-01-06
 * Use internal session for Requests for connection pooling
 
-## 1.45.0 - 2017-01-06
-* request logging goes to stderr now
-* Logs properly handle unicode
+## <a id="1-45-0"></a>1.45.0 - 2017-01-06
 * Format is now the same between logging logs, and console logs
+* Logs properly handle unicode
+* request logging goes to stderr now
 
-## 1.44.0 - 2016-12-16
+## <a id="1-44-0"></a>1.44.0 - 2016-12-16
 * Add request logging and some mechanisms to enable it when debugging
 
-## 1.43.0 - 2016-11-30
+## <a id="1-43-0"></a>1.43.0 - 2016-11-30
 * Add support for verifying sources
 
-## 1.42.0 - 2016-11-21
+## <a id="1-42-0"></a>1.42.0 - 2016-11-21
 * Add retrieve method for 3-D Secure resources
 
-## 1.41.1 - 2016-10-26
+## <a id="1-41-1"></a>1.41.1 - 2016-10-26
 * Implement __copy__ and __deepcopy__ on StripeObject to fix these operations
 
-## 1.41.0 - 2016-10-12
+## <a id="1-41-0"></a>1.41.0 - 2016-10-12
 * Add `Source` model for generic payment sources
 
-## 1.40.1 - 2016-10-10
+## <a id="1-40-1"></a>1.40.1 - 2016-10-10
 * Return subscription model instance on subscription create/modify
 
-## 1.40.0 - 2016-10-07
+## <a id="1-40-0"></a>1.40.0 - 2016-10-07
 * Add configurable timeout for Requests HTTP library
 
-## 1.39.0 - 2016-10-06
-* Add support for subscription items
+## <a id="1-39-0"></a>1.39.0 - 2016-10-06
 * Add proxy support for pycurl, Requests, urlfetch, and urllib2 libraries
+* Add support for subscription items
 
-## 1.38.0 - 2016-09-15
+## <a id="1-38-0"></a>1.38.0 - 2016-09-15
 * Add support for Apple Pay domains
 
-## 1.37.0 - 2016-07-12
+## <a id="1-37-0"></a>1.37.0 - 2016-07-12
 * Add `ThreeDSecure` model for 3-D secure payments
 
-## 1.36.0 - 2016-06-29
+## <a id="1-36-0"></a>1.36.0 - 2016-06-29
 * Add `update` class method to resources that can be updated
 
-## 1.35.0 - 2016-05-24
+## <a id="1-35-0"></a>1.35.0 - 2016-05-24
 * Add support for returning Relay orders
 
-## 1.34.0 - 2016-05-20
+## <a id="1-34-0"></a>1.34.0 - 2016-05-20
 * Add support for Alipay accounts
 
-## 1.33.0 - 2016-05-04
+## <a id="1-33-0"></a>1.33.0 - 2016-05-04
 * Add support for the new `/v1/subscriptions` endpoint
   * `stripe.Subscription.retrieve`
   * `stripe.Subscription.update`
   * `stripe.Subscription.create`
   * `stripe.Subscription.list`
 
-## 1.32.2 - 2016-04-12
+## <a id="1-32-2"></a>1.32.2 - 2016-04-12
 * Fix bug where file uploads could not be properly listed
 
-## 1.32.1 - 2016-04-11
+## <a id="1-32-1"></a>1.32.1 - 2016-04-11
 * Fix bug where request parameters were not passed between pages with `auto_paging_iter`
 
-## 1.32.0 - 2016-03-31
+## <a id="1-32-0"></a>1.32.0 - 2016-03-31
 * Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
 
-## 1.31.1 - 2016-03-24
+## <a id="1-31-1"></a>1.31.1 - 2016-03-24
 * Fix uploading of binary files in Python 3
 
-## 1.31.0 - 2016-03-15
+## <a id="1-31-0"></a>1.31.0 - 2016-03-15
 * Add `reject` on `Account` to support the new API feature
 
-## 1.30.0 - 2016-02-27
+## <a id="1-30-0"></a>1.30.0 - 2016-02-27
 * Add `CountrySpec` model for looking up country payment information
 
-## 1.29.1 - 2016-02-01
+## <a id="1-29-1"></a>1.29.1 - 2016-02-01
 * Update bundled CA certs
 
-## 1.29.0 - 2016-01-26
+## <a id="1-29-0"></a>1.29.0 - 2016-01-26
 * Add support for deleting Relay products and SKUs
 
-## 1.28.0 - 2016-01-04
+## <a id="1-28-0"></a>1.28.0 - 2016-01-04
 * Add an automatic paginating iterator to lists available via `auto_paging_iter`
-* List objects are now iterable
-* Error messages set to `None` are now handled properly
 * The `all` method on list objects has been deprecated in favor of `list`
 * Calls to `instance_url` are now side effect free
+* Error messages set to `None` are now handled properly
+* List objects are now iterable
 
-## 1.27.1 - 2015-10-02
-* Official Python 3.4 & 3.5 compatibility
-* Add configurable HTTP client
+## <a id="1-27-1"></a>1.27.1 - 2015-10-02
 * Add ability to delete attributes
+* Add configurable HTTP client
+* Official Python 3.4 & 3.5 compatibility
 
-## 1.27.0 - 2015-09-14
+## <a id="1-27-0"></a>1.27.0 - 2015-09-14
 * Products, SKUs, Orders resources
 
-## 1.26.0 - 2015-09-11
+## <a id="1-26-0"></a>1.26.0 - 2015-09-11
 * Add support for new 429 rate limit response
 
-## 1.25.0 - 2015-08-17
+## <a id="1-25-0"></a>1.25.0 - 2015-08-17
 * Added refund listing, creation and retrieval
 
-## 1.24.1 - 2015-08-05
+## <a id="1-24-1"></a>1.24.1 - 2015-08-05
 * Fix error handling for Python 2.6
 
-## 1.24.0 - 2015-08-03
-* Managed accounts can now be deleted
+## <a id="1-24-0"></a>1.24.0 - 2015-08-03
 * Added dispute listing and retrieval
+* Managed accounts can now be deleted
 
-## 1.23.0 - 2015-07-06
+## <a id="1-23-0"></a>1.23.0 - 2015-07-06
 * Include response headers in exceptions
 
-## 1.22.3 - 2015-06-04
+## <a id="1-22-3"></a>1.22.3 - 2015-06-04
 * Fix saving `additional_owners` on managed accounts
 
-## 1.22.2 - 2015-04-08
+## <a id="1-22-2"></a>1.22.2 - 2015-04-08
 * Fix saving manage accounts
 
-## 1.22.1 - 2015-03-30
+## <a id="1-22-1"></a>1.22.1 - 2015-03-30
 * Pass `stripe_account` to Balance.retrieve
 
-## 1.22.0 - 2015-03-22
+## <a id="1-22-0"></a>1.22.0 - 2015-03-22
 * Added methods for updating and saving arrays of objects
 
-## 1.21.0 - 2015-02-19
+## <a id="1-21-0"></a>1.21.0 - 2015-02-19
 * Added Bitcoin Receiver update and delete methods
 
-## 1.20.2 - 2015-01-21
+## <a id="1-20-2"></a>1.20.2 - 2015-01-21
 * Remove support for top-level bitcoin transactions
 
-## 1.20.1 - 2015-01-07
+## <a id="1-20-1"></a>1.20.1 - 2015-01-07
 * Adding bitcoin receiver and transaction objects
 
-## 1.20.0 - 2014-12-23
+## <a id="1-20-0"></a>1.20.0 - 2014-12-23
 * Adding support for file uploads resource
 
-## 1.19.1 - 2014-10-23
+## <a id="1-19-1"></a>1.19.1 - 2014-10-23
 * Remove redundant manual SSL blacklist preflight check
 
-## 1.19.0 - 2014-07-26
+## <a id="1-19-0"></a>1.19.0 - 2014-07-29
 * Application Fee refunds now a list instead of array
 
-## 1.18.0 - 2014-06-17
+## <a id="1-18-0"></a>1.18.0 - 2014-06-17
 * Add metadata for disputes and refunds
 
-## 1.17.0 - 2014-06-10
+## <a id="1-17-0"></a>1.17.0 - 2014-06-10
 * Remove official support for Python 2.5
 
-## 1.16.0 - 2014-05-28
+## <a id="1-16-0"></a>1.16.0 - 2014-05-28
 * Support for canceling transfers
 
-## 1.15.1 - 2014-05-21
+## <a id="1-15-1"></a>1.15.1 - 2014-05-22
 * Support cards for recipients.
 
-## 1.14.1 - 2014-05-19
+## <a id="1-14-1"></a>1.14.1 - 2014-05-19
 * Disable loading the ssl module on the Google App Engine dev server.
 
-## 1.14.0 - 2014-04-09
-* Use DER encoded certificate for checksumming
+## <a id="1-14-0"></a>1.14.0 - 2014-04-09
 * Don't rely on SNI support in integration tests
+* Use DER encoded certificate for checksumming
 
-## 1.13.0 - 2014-04-09
-* Update bundled ca-certificates
+## <a id="1-13-0"></a>1.13.0 - 2014-04-09
 * Add certificate blacklist for CVE-2014-0160 mitigation
+* Update bundled ca-certificates
 
-## 1.12.2 - 2014-03-13
+## <a id="1-12-2"></a>1.12.2 - 2014-03-13
 * Fix syntax errors in setup.py metadata
 
-## 1.12.1 - 2014-03-13
+## <a id="1-12-1"></a>1.12.1 - 2014-03-13
 * Added license and other metadata in setup.py
 * Fix `__repr__` in Python 3
 * Support pickling of responses
 
-## 1.12.0 - 2014-01-29
+## <a id="1-12-0"></a>1.12.0 - 2014-01-29
 * Added support for multiple subscriptions per customer
 
-## 1.11.0 - 2013-12-05
+## <a id="1-11-0"></a>1.11.0 - 2013-12-05
+* Abstracted http library selection and use from the `APIRequestor` into `stripe.http_client`
 * Added extensive unit tests
 * Extended functional test coverage
-* Refactored code into modules and out of stripe/__init__.py
-* Abstracted http library selection and use from the `APIRequestor` into `stripe.http_client`
-* Refactored `StripeObject` to inherit from `dict` and avoid direct access of `__dict__`.
 * PEP8ified the codebase and enforced with a test.
 * Proper encoding of timezone aware datetimes
+* Refactored code into modules and out of stripe/__init__.py
+* Refactored `StripeObject` to inherit from `dict` and avoid direct access of `__dict__`.
 
 ### Backwards incompatible changes
-* The `to_dict` and `values` methods on resources no longer recursively convert objects to plain `dict`s.  All resources now inherit from `dict` but are functionally different in that you cannot set a value to an empty string and cannot delete items.
 * The `previous_metadata` attribute on resources is now protected.
 * Timezone aware `datetime` objects passed to the API will now be encoded in a way that does not depend on the local system time.  If you are passing timezone-aware datetimes to our API and your server time is not already in UTC, this will change the value passed to our API.
+* ⚠️ The `to_dict` and `values` methods on resources no longer recursively convert objects to plain `dict`s.  All resources now inherit from `dict` but are functionally different in that you cannot set a value to an empty string and cannot delete items.
 
-## 1.10.8 - 2013-12-02
+## <a id="1-10-8"></a>1.10.8 - 2013-12-04
 * Add stripe.ApplicationFee resource
 
-## 1.9.8 - 2013-10-17
+## <a id="1-9-8"></a>1.9.8 - 2013-10-17
 * Removed incorrect test.
 
-## 1.9.7 - 2013-10-10
+## <a id="1-9-7"></a>1.9.7 - 2013-10-17
 * Add support for metadata.
 
-## 1.9.6 - 2013-10-08
+## <a id="1-9-6"></a>1.9.6 - 2013-10-08
 * Fix issue with support for closing disputes.
 
-## 1.9.5 - 2013-09-18
+## <a id="1-9-5"></a>1.9.5 - 2013-09-18
 * Add support for closing disputes.
 
-## 1.9.4 - 2013-08-13
+## <a id="1-9-4"></a>1.9.4 - 2013-08-20
 * Add stripe.Balance and stripe.BalanceTransaction resources
 
-## 1.9.3 - 2013-08-12
+## <a id="1-9-3"></a>1.9.3 - 2013-08-12
 * Add support for unsetting attributes by setting to None.
   Setting properties to a blank string is now an error.
 
-## 1.9.2 - 2013-07-12
+## <a id="1-9-2"></a>1.9.2 - 2013-07-12
 * Add support for multiple cards API
 
-## 1.9.1 - 2013-05-03
+## <a id="1-9-1"></a>1.9.1 - 2013-05-03
 * Remove 'id' from the list of permanent attributes
 
-## 1.9.0 - 2013-04-25
+## <a id="1-9-0"></a>1.9.0 - 2013-04-25
 * Support for Python 3 (github issue #32)
 
-## 1.8.0 - 2013-04-11
-* Allow transfers to be creatable
+## <a id="1-8-0"></a>1.8.0 - 2013-04-11
 * Add new stripe.Recipient resource
+* Allow transfers to be creatable
 
-## 1.7.10 - 2013-02-21
+## <a id="1-7-10"></a>1.7.10 - 2013-02-21
 * Add 'id' to the list of permanent attributes
 
-## 1.7.9 - 2013-02-01
+## <a id="1-7-9"></a>1.7.9 - 2013-02-04
 * Add support for passing options when retrieving Stripe objects; e.g., stripe.Charge.retrieve("foo", params={"expand":["customer"]})
 
-## 1.7.8 - 2013-01-15
+## <a id="1-7-8"></a>1.7.8 - 2013-01-15
 * Add support for setting a Stripe API version override
 
-## 1.7.7 - 2012-12-18
+## <a id="1-7-7"></a>1.7.7 - 2012-12-18
 * Update requests version check to work with requests 1.x.x (github issue #24)
 
-## 1.7.6 - 2012-11-08
+## <a id="1-7-6"></a>1.7.6 - 2012-11-08
 * Add support for updating charge disputes
 
-## 1.7.5 - 2012-10-30
+## <a id="1-7-5"></a>1.7.5 - 2012-10-30
 * Add support for creating invoices
 * Add support for new invoice lines return format
 * Add support for new List objects
 
-## 1.7.4 - 2012-08-31
+## <a id="1-7-4"></a>1.7.4 - 2012-08-31
 * Add update and pay methods for Invoice resource
 
-## 1.7.3 - 2012-08-15
+## <a id="1-7-3"></a>1.7.3 - 2012-08-17
 * Add new stripe.Account resource
 * Remove uncaptured_charge tests (this has been deprecated from the API).
 
-## 1.7.2 - 2012-05-31
+## <a id="1-7-2"></a>1.7.2 - 2012-05-31
 * Fix a bug that would cause nested objects to be mis-rendered in __str__ and __repr__ methods (github issues #17, #18)
 
-## 1.7.1 - 2012-05-21
+## <a id="1-7-1"></a>1.7.1 - 2012-05-21
 * Prefer App Engine's urlfetch over requests, as that's the only thing that will work in App Engine's environment. Previously, if requests was available in the App Engine environment, we would attempt to use it.
 
-## 1.7.0 - 2012-05-17
+## <a id="1-7-0"></a>1.7.0 - 2012-05-17
 * Add new delete_discount method to stripe.Customer
 * Add new stripe.Transfer resource
-* Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
 * Numerous test suite improvements
+* Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
 
-## 1.6.1 - 2011-09-14
+## <a id="1-6-1"></a>1.6.1 - 2012-02-04
 * Parameters with value None are no longer included in API requests
+
+## <a id="1-5-36"></a>1.5.36 - 2012-01-26
+
+## <a id="1-5-35"></a>1.5.35 - 2012-01-05
+
+## <a id="1-5-34"></a>1.5.34 - 2012-01-05
+
+## <a id="1-5-33"></a>1.5.33 - 2012-01-05
+
+## <a id="1-5-32"></a>1.5.32 - 2012-01-05
+
+## <a id="1-5-31"></a>1.5.31 - 2012-01-05
+
+## <a id="1-5-30"></a>1.5.30 - 2011-12-12
+
+## <a id="1-5-29"></a>1.5.29 - 2011-11-25
+
+## <a id="1-5-28"></a>1.5.28 - 2011-11-23
+
+## <a id="1-5-27"></a>1.5.27 - 2011-10-29
+
+## <a id="1-5-26"></a>1.5.26 - 2011-10-29
+
+## <a id="1-5-25"></a>1.5.25 - 2011-10-29
+
+## <a id="1-5-24"></a>1.5.24 - 2011-10-21
+
+## <a id="1-5-23"></a>1.5.23 - 2011-10-21
+
+## <a id="1-5-22"></a>1.5.22 - 2011-09-14
+
+## <a id="1-5-21"></a>1.5.21 - 2011-09-14
+
+## <a id="1-5-20"></a>1.5.20 - 2011-08-29
+
+## <a id="1-5-19"></a>1.5.19 - 2011-08-27
+
+## <a id="1-5-18"></a>1.5.18 - 2011-08-09
+
+## <a id="1-5-17"></a>1.5.17 - 2011-07-31
+
+## <a id="1-5-16"></a>1.5.16 - 2011-07-29
+
+## <a id="1-5-15"></a>1.5.15 - 2011-07-27
+
+## <a id="1-5-14"></a>1.5.14 - 2011-07-13
+
+## <a id="1-5-13"></a>1.5.13 - 2011-07-12
+
+## <a id="1-5-12"></a>1.5.12 - 2011-07-12
+
+## <a id="1-5-11"></a>1.5.11 - 2011-07-11
+
+## <a id="1-5-10"></a>1.5.10 - 2011-06-26
+
+## <a id="1-5-9"></a>1.5.9 - 2011-06-23
+
+## <a id="1-5-8"></a>1.5.8 - 2011-06-13
+
+## <a id="1-5-7"></a>1.5.7 - 2011-06-13
+
+## <a id="1-5-6"></a>1.5.6 - 2011-06-03
+
+## <a id="1-5-5"></a>1.5.5 - 2011-06-03
+
+## <a id="1-5-4"></a>1.5.4 - 2011-06-03
+
+## <a id="1-5-3"></a>1.5.3 - 2011-06-02
+
+## <a id="1-5-2"></a>1.5.2 - 2011-06-01
+
+## <a id="1-5-1"></a>1.5.1 - 2011-05-30
+
+## <a id="1-5-0"></a>1.5.0 - 2011-05-26
diff --git a/justfile b/justfile
index c9a7a6800..b156e797c 100644
--- a/justfile
+++ b/justfile
@@ -103,3 +103,10 @@ profile-imports name:
 profile name:
     python -m cProfile -o {{ name }}.prof stripe/main.py
     tuna {{ name }}.prof
+
+# ⭐ print the API version this SDK pins and the lowest runtime it supports
+print-version-info:
+    #!/usr/bin/env bash
+    set -euo pipefail
+    echo "pinned-api-version: $(rg -N --color never -m1 -o '[0-9]{4}-[0-9]{2}-[0-9]{2}[.\w-]*' stripe/_api_version.py)"
+    echo "minimum-runtime-version: $(rg -N --color never -o 'requires-python = ">=([^"]+)"' --replace '$1' pyproject.toml)"

From a7bb4e3c65c84ff0ac7c5693c71c82b52762d14d Mon Sep 17 00:00:00 2001
From: David Brownman <xavdid@stripe.com>
Date: Wed, 16 Sep 2026 10:32:48 -0700
Subject: [PATCH 4/8] rename changefiles that don't adhere to new naming rules

---
 ..._2.change.md => 2012-10-30_unknown_add-support-new2.change.md} | 0
 ...md => 2022-08-02_unknown_consistent-other-resource2.change.md} | 0
 ...md => 2022-08-02_unknown_consistent-other-resource3.change.md} | 0
 ...md => 2022-08-02_unknown_removed-deprecated-charge2.change.md} | 0
 ...=> 2024-07-25_stripe-openapi_update-generated-code2.change.md} | 0
 ...=> 2024-09-18_stripe-openapi_update-generated-code2.change.md} | 0
 ...ct_2.change.md => 2025-01-13_jar_fix-v2-listobject2.change.md} | 0
 ...change.md => 2025-01-14_xavdid_add-justfile-update2.change.md} | 0
 ...hange.md => 2025-01-16_xavdid_minor-justfile-fixes2.change.md} | 0
 ....change.md => 2025-01-17_jar_added-contributing-md2.change.md} | 0
 ..._2.change.md => 2025-01-21_xavdid_add-just-publish2.change.md} | 0
 ...md => 2025-01-25_prathmesh_updated-upload-artifact2.change.md} | 0
 ...md => 2025-01-27_helenye_upgrade-download-artifact2.change.md} | 0
 ...=> 2025-01-27_stripe-openapi_update-generated-code2.change.md} | 0
 14 files changed, 0 insertions(+), 0 deletions(-)
 rename .hark/changes/{2012-10-30_unknown_add-support-new_2.change.md => 2012-10-30_unknown_add-support-new2.change.md} (100%)
 rename .hark/changes/{2022-08-02_unknown_consistent-other-resource_2.change.md => 2022-08-02_unknown_consistent-other-resource2.change.md} (100%)
 rename .hark/changes/{2022-08-02_unknown_consistent-other-resource_3.change.md => 2022-08-02_unknown_consistent-other-resource3.change.md} (100%)
 rename .hark/changes/{2022-08-02_unknown_removed-deprecated-charge_2.change.md => 2022-08-02_unknown_removed-deprecated-charge2.change.md} (100%)
 rename .hark/changes/{2024-07-25_stripe-openapi_update-generated-code_2.change.md => 2024-07-25_stripe-openapi_update-generated-code2.change.md} (100%)
 rename .hark/changes/{2024-09-18_stripe-openapi_update-generated-code_2.change.md => 2024-09-18_stripe-openapi_update-generated-code2.change.md} (100%)
 rename .hark/changes/{2025-01-13_jar_fix-v2-listobject_2.change.md => 2025-01-13_jar_fix-v2-listobject2.change.md} (100%)
 rename .hark/changes/{2025-01-14_xavdid_add-justfile-update_2.change.md => 2025-01-14_xavdid_add-justfile-update2.change.md} (100%)
 rename .hark/changes/{2025-01-16_xavdid_minor-justfile-fixes_2.change.md => 2025-01-16_xavdid_minor-justfile-fixes2.change.md} (100%)
 rename .hark/changes/{2025-01-17_jar_added-contributing-md_2.change.md => 2025-01-17_jar_added-contributing-md2.change.md} (100%)
 rename .hark/changes/{2025-01-21_xavdid_add-just-publish_2.change.md => 2025-01-21_xavdid_add-just-publish2.change.md} (100%)
 rename .hark/changes/{2025-01-25_prathmesh_updated-upload-artifact_2.change.md => 2025-01-25_prathmesh_updated-upload-artifact2.change.md} (100%)
 rename .hark/changes/{2025-01-27_helenye_upgrade-download-artifact_2.change.md => 2025-01-27_helenye_upgrade-download-artifact2.change.md} (100%)
 rename .hark/changes/{2025-01-27_stripe-openapi_update-generated-code_2.change.md => 2025-01-27_stripe-openapi_update-generated-code2.change.md} (100%)

diff --git a/.hark/changes/2012-10-30_unknown_add-support-new_2.change.md b/.hark/changes/2012-10-30_unknown_add-support-new2.change.md
similarity index 100%
rename from .hark/changes/2012-10-30_unknown_add-support-new_2.change.md
rename to .hark/changes/2012-10-30_unknown_add-support-new2.change.md
diff --git a/.hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md b/.hark/changes/2022-08-02_unknown_consistent-other-resource2.change.md
similarity index 100%
rename from .hark/changes/2022-08-02_unknown_consistent-other-resource_2.change.md
rename to .hark/changes/2022-08-02_unknown_consistent-other-resource2.change.md
diff --git a/.hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md b/.hark/changes/2022-08-02_unknown_consistent-other-resource3.change.md
similarity index 100%
rename from .hark/changes/2022-08-02_unknown_consistent-other-resource_3.change.md
rename to .hark/changes/2022-08-02_unknown_consistent-other-resource3.change.md
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge2.change.md
similarity index 100%
rename from .hark/changes/2022-08-02_unknown_removed-deprecated-charge_2.change.md
rename to .hark/changes/2022-08-02_unknown_removed-deprecated-charge2.change.md
diff --git a/.hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code2.change.md
similarity index 100%
rename from .hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md
rename to .hark/changes/2024-07-25_stripe-openapi_update-generated-code2.change.md
diff --git a/.hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code2.change.md
similarity index 100%
rename from .hark/changes/2024-09-18_stripe-openapi_update-generated-code_2.change.md
rename to .hark/changes/2024-09-18_stripe-openapi_update-generated-code2.change.md
diff --git a/.hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md b/.hark/changes/2025-01-13_jar_fix-v2-listobject2.change.md
similarity index 100%
rename from .hark/changes/2025-01-13_jar_fix-v2-listobject_2.change.md
rename to .hark/changes/2025-01-13_jar_fix-v2-listobject2.change.md
diff --git a/.hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md b/.hark/changes/2025-01-14_xavdid_add-justfile-update2.change.md
similarity index 100%
rename from .hark/changes/2025-01-14_xavdid_add-justfile-update_2.change.md
rename to .hark/changes/2025-01-14_xavdid_add-justfile-update2.change.md
diff --git a/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md b/.hark/changes/2025-01-16_xavdid_minor-justfile-fixes2.change.md
similarity index 100%
rename from .hark/changes/2025-01-16_xavdid_minor-justfile-fixes_2.change.md
rename to .hark/changes/2025-01-16_xavdid_minor-justfile-fixes2.change.md
diff --git a/.hark/changes/2025-01-17_jar_added-contributing-md_2.change.md b/.hark/changes/2025-01-17_jar_added-contributing-md2.change.md
similarity index 100%
rename from .hark/changes/2025-01-17_jar_added-contributing-md_2.change.md
rename to .hark/changes/2025-01-17_jar_added-contributing-md2.change.md
diff --git a/.hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md b/.hark/changes/2025-01-21_xavdid_add-just-publish2.change.md
similarity index 100%
rename from .hark/changes/2025-01-21_xavdid_add-just-publish_2.change.md
rename to .hark/changes/2025-01-21_xavdid_add-just-publish2.change.md
diff --git a/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md b/.hark/changes/2025-01-25_prathmesh_updated-upload-artifact2.change.md
similarity index 100%
rename from .hark/changes/2025-01-25_prathmesh_updated-upload-artifact_2.change.md
rename to .hark/changes/2025-01-25_prathmesh_updated-upload-artifact2.change.md
diff --git a/.hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md b/.hark/changes/2025-01-27_helenye_upgrade-download-artifact2.change.md
similarity index 100%
rename from .hark/changes/2025-01-27_helenye_upgrade-download-artifact_2.change.md
rename to .hark/changes/2025-01-27_helenye_upgrade-download-artifact2.change.md
diff --git a/.hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code2.change.md
similarity index 100%
rename from .hark/changes/2025-01-27_stripe-openapi_update-generated-code_2.change.md
rename to .hark/changes/2025-01-27_stripe-openapi_update-generated-code2.change.md

From fb045bdb3e87d1a0a0c5a74077c4bc3f4b6e636d Mon Sep 17 00:00:00 2001
From: David Brownman <1231935+xavdid@users.noreply.github.com>
Date: Wed, 16 Sep 2026 13:32:58 -0700
Subject: [PATCH 5/8] Support `EventNotification`s with singleton related
 objects (#1904)

* support related singleton objects

* add missing changefile
---
 ..._xavdid_singleton-related-object.change.md |  6 ++++++
 stripe/v2/core/__init__.py                    |  1 +
 stripe/v2/core/_event.py                      | 12 ++++++++++++
 tests/test_exports.py                         | 10 ++++++++++
 tests/test_v2_event.py                        | 19 ++++++++++++++++++-
 5 files changed, 47 insertions(+), 1 deletion(-)
 create mode 100644 .hark/changes/2026-09-11_xavdid_singleton-related-object.change.md

diff --git a/.hark/changes/2026-09-11_xavdid_singleton-related-object.change.md b/.hark/changes/2026-09-11_xavdid_singleton-related-object.change.md
new file mode 100644
index 000000000..878dbb765
--- /dev/null
+++ b/.hark/changes/2026-09-11_xavdid_singleton-related-object.change.md
@@ -0,0 +1,6 @@
+---
+title: Support `EventNotification`s with singleton related objects
+pr_url: https://github.com/stripe/stripe-python/pull/1904
+jira_tickets_closed:
+- RUN_DEVSDK-2825
+---
diff --git a/stripe/v2/core/__init__.py b/stripe/v2/core/__init__.py
index 8ff2aeb1e..4a5b9ff11 100644
--- a/stripe/v2/core/__init__.py
+++ b/stripe/v2/core/__init__.py
@@ -4,6 +4,7 @@
 from stripe.v2.core._event import (
     EventNotification as EventNotification,
     RelatedObject as RelatedObject,
+    RelatedSingletonObject as RelatedSingletonObject,
     Reason as Reason,
     ReasonRequest as ReasonRequest,
 )
diff --git a/stripe/v2/core/_event.py b/stripe/v2/core/_event.py
index fe014db67..fb6ab6e09 100644
--- a/stripe/v2/core/_event.py
+++ b/stripe/v2/core/_event.py
@@ -123,6 +123,18 @@ def __repr__(self) -> str:
         return f"<RelatedObject id={self.id} type={self.type} url={self.url}>"
 
 
+class RelatedSingletonObject:
+    type: str
+    url: str
+
+    def __init__(self, d) -> None:
+        self.type = d["type"]
+        self.url = d["url"]
+
+    def __repr__(self) -> str:
+        return f"<RelatedSingletonObject type={self.type} url={self.url}>"
+
+
 class EventNotification:
     """
     EventNotification represents the json that's delivered from an Event Destination. It's a basic struct-like object with a few convenience methods. Use `fetch_event()` to get the full event object.
diff --git a/tests/test_exports.py b/tests/test_exports.py
index 3aff0a530..e9c3a04cd 100644
--- a/tests/test_exports.py
+++ b/tests/test_exports.py
@@ -45,6 +45,16 @@ def test_can_import_webhook_members() -> None:
     )
 
 
+def test_can_import_event_notification_members() -> None:
+    from stripe.v2.core import (
+        EventNotification,  # pyright: ignore[reportUnusedImport]
+        Reason,  # pyright: ignore[reportUnusedImport]
+        ReasonRequest,  # pyright: ignore[reportUnusedImport]
+        RelatedObject,  # pyright: ignore[reportUnusedImport]
+        RelatedSingletonObject,  # pyright: ignore[reportUnusedImport]
+    )
+
+
 def test_can_import_abstract() -> None:
     from stripe import (
         APIResource,  # pyright: ignore[reportUnusedImport]
diff --git a/tests/test_v2_event.py b/tests/test_v2_event.py
index 694b591af..54a1f2e2d 100644
--- a/tests/test_v2_event.py
+++ b/tests/test_v2_event.py
@@ -14,7 +14,11 @@
     V1BillingMeterErrorReportTriggeredEventNotification,
     V1BillingMeterErrorReportTriggeredEvent,
 )
-from stripe.v2.core._event import EventNotification, UnknownEventNotification
+from stripe.v2.core._event import (
+    EventNotification,
+    RelatedSingletonObject,
+    UnknownEventNotification,
+)
 from stripe.events._event_classes import ALL_EVENT_NOTIFICATIONS
 from stripe._webhook import WebhookPayload, WebhookSignature
 from tests.test_webhook import DUMMY_WEBHOOK_SECRET
@@ -198,6 +202,19 @@ def test_parses_unknown_event_notif(self, parse_event_notif: EventParser):
         assert type(event) is UnknownEventNotification
         assert event.related_object
 
+    def test_related_singleton_object_omits_id(self):
+        """
+        events whose related object is a singleton get a `RelatedSingletonObject`,
+        which has no `id` at all (instead of a perpetually-`None` one)
+        """
+        related_object = RelatedSingletonObject(
+            {"type": "balance", "url": "/v1/balance"}
+        )
+
+        assert related_object.type == "balance"
+        assert related_object.url == "/v1/balance"
+        assert not hasattr(related_object, "id")
+
     def test_raise_on_v1_payload(self, parse_event_notif: EventParser):
         v1_payload = json.dumps(
             {

From c097e20b4912524bfcd9afab14e30cc7f673d866 Mon Sep 17 00:00:00 2001
From: jar-stripe <jar@stripe.com>
Date: Wed, 16 Sep 2026 15:24:25 -0700
Subject: [PATCH 6/8] disabled reportUnnecessaryTypeIgnoreComment (#1912)

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 5ba581723..c92f7279e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -76,7 +76,7 @@ reportUnnecessaryComparison = true
 reportUnnecessaryContains = true
 reportUnnecessaryIsInstance = true
 reportPrivateImportUsage = true
-reportUnnecessaryTypeIgnoreComment = true
+reportUnnecessaryTypeIgnoreComment = false
 
 [tool.mypy]
 follow_imports = "silent"

From 439568d30792d4e205944666ebae43005314b657 Mon Sep 17 00:00:00 2001
From: zacchua-stripe <zacchua@stripe.com>
Date: Wed, 16 Sep 2026 17:15:36 -0700
Subject: [PATCH 7/8] Add option to suppress Stripe notices (#1909)

* Add option to suppress Stripe notices

Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>

* Add changelog entry for notice suppression

Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>

* Clarify Stripe notice suppression instructions

Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>

---------

Co-authored-by: codex <noreply@openai.com>
---
 ...chua_add-stripe-suppress-notices.change.md |  7 +++
 stripe/_api_requestor.py                      | 27 +++++++--
 tests/test_api_requestor.py                   | 55 ++++++++++++++++++-
 3 files changed, 84 insertions(+), 5 deletions(-)
 create mode 100644 .hark/changes/2026-09-15_zacchua_add-stripe-suppress-notices.change.md

diff --git a/.hark/changes/2026-09-15_zacchua_add-stripe-suppress-notices.change.md b/.hark/changes/2026-09-15_zacchua_add-stripe-suppress-notices.change.md
new file mode 100644
index 000000000..40261bc43
--- /dev/null
+++ b/.hark/changes/2026-09-15_zacchua_add-stripe-suppress-notices.change.md
@@ -0,0 +1,7 @@
+---
+title: Allow suppressing Stripe notices
+pr_url: https://github.com/stripe/stripe-python/pull/1909
+semver_level: minor
+---
+
+Set the `STRIPE_SUPPRESS_NOTICES` environment variable to `true` to suppress Stripe notices in test and sandbox environments when not running under a detected AI agent. Notices remain enabled by default and continue to be shown to AI agents.
diff --git a/stripe/_api_requestor.py b/stripe/_api_requestor.py
index e0f22186d..37f2011db 100644
--- a/stripe/_api_requestor.py
+++ b/stripe/_api_requestor.py
@@ -72,12 +72,31 @@
 _default_proxy: Optional[str] = None
 
 
-def _maybe_emit_stripe_notice(rheaders: Mapping[str, str]) -> None:
+def _maybe_emit_stripe_notice(
+    rheaders: Mapping[str, str],
+    environ: Optional[Mapping[str, str]] = None,
+) -> None:
     notice = rheaders.get("Stripe-Notice")
-    if notice:
-        import warnings
+    if not notice:
+        return
+
+    environ = os.environ if environ is None else environ
+    ai_agent = _APIRequestor._detect_ai_agent(environ)
+    if (
+        not ai_agent
+        and environ.get("STRIPE_SUPPRESS_NOTICES", "").lower() == "true"
+    ):
+        return
+
+    if not ai_agent:
+        notice += (
+            "\nTo suppress Stripe notices in test and sandbox environments, "
+            "set the STRIPE_SUPPRESS_NOTICES environment variable to true."
+        )
+
+    import warnings
 
-        warnings.warn(notice)
+    warnings.warn(notice)
 
 
 def is_v2_delete_resp(method: str, api_mode: ApiMode) -> bool:
diff --git a/tests/test_api_requestor.py b/tests/test_api_requestor.py
index c49803c46..744930ed9 100644
--- a/tests/test_api_requestor.py
+++ b/tests/test_api_requestor.py
@@ -11,7 +11,11 @@
 
 import stripe
 import io
-from stripe._api_requestor import _api_encode, _APIRequestor
+from stripe._api_requestor import (
+    _api_encode,
+    _APIRequestor,
+    _maybe_emit_stripe_notice,
+)
 from stripe._customer import Customer
 from stripe._request_options import RequestOptions
 from stripe._requestor_options import (
@@ -1077,6 +1081,55 @@ def test_stripe_notice_header_emits_warning(
         with pytest.warns(UserWarning, match="test notice value"):
             requestor.request("get", self.v1_path, {}, base_address="api")
 
+    def test_stripe_notice_tells_humans_how_to_suppress_notices(self):
+        with pytest.warns(UserWarning) as warning:
+            _maybe_emit_stripe_notice(
+                {"Stripe-Notice": "test notice value"}, {}
+            )
+
+        assert str(warning[0].message) == (
+            "test notice value\n"
+            "To suppress Stripe notices in test and sandbox environments, "
+            "set the STRIPE_SUPPRESS_NOTICES environment variable to true."
+        )
+
+    @pytest.mark.parametrize("suppression_value", ["true", "TRUE"])
+    def test_stripe_notice_can_be_suppressed_for_humans(
+        self, suppression_value
+    ):
+        import warnings
+
+        with warnings.catch_warnings():
+            warnings.simplefilter("error")
+            _maybe_emit_stripe_notice(
+                {"Stripe-Notice": "test notice value"},
+                {"STRIPE_SUPPRESS_NOTICES": suppression_value},
+            )
+
+    @pytest.mark.parametrize(
+        "suppression_value", ["", "false", "1", "invalid"]
+    )
+    def test_stripe_notice_is_not_suppressed_for_other_values(
+        self, suppression_value
+    ):
+        with pytest.warns(UserWarning):
+            _maybe_emit_stripe_notice(
+                {"Stripe-Notice": "test notice value"},
+                {"STRIPE_SUPPRESS_NOTICES": suppression_value},
+            )
+
+    def test_stripe_notice_is_not_suppressed_for_ai_agents(self):
+        with pytest.warns(UserWarning) as warning:
+            _maybe_emit_stripe_notice(
+                {"Stripe-Notice": "test notice value"},
+                {
+                    "STRIPE_SUPPRESS_NOTICES": "true",
+                    "CODEX_SANDBOX": "1",
+                },
+            )
+
+        assert str(warning[0].message) == "test notice value"
+
     @pytest.mark.anyio
     async def test_stripe_notice_header_emits_warning_async(
         self, requestor, http_client_mock

From 329c70233d07db9176d36b2792cb7c432a7ffb7b Mon Sep 17 00:00:00 2001
From: zacchua-stripe <zacchua@stripe.com>
Date: Thu, 17 Sep 2026 11:30:49 -0700
Subject: [PATCH 8/8] Fix event handler account scoping (#1911)

* Fix event handler account scoping

Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>

* Add PR URL to changefile

Committed-By-Agent: codex
Co-authored-by: codex <noreply@openai.com>

---------

Co-authored-by: codex <noreply@openai.com>
---
 ...16_zacchua_fix-event-handler-account-scoping.change.md | 8 ++++++++
 stripe/_stripe_client.py                                  | 1 -
 tests/test_event_notification_handler.py                  | 6 +++++-
 3 files changed, 13 insertions(+), 2 deletions(-)
 create mode 100644 .hark/changes/2026-09-16_zacchua_fix-event-handler-account-scoping.change.md

diff --git a/.hark/changes/2026-09-16_zacchua_fix-event-handler-account-scoping.change.md b/.hark/changes/2026-09-16_zacchua_fix-event-handler-account-scoping.change.md
new file mode 100644
index 000000000..c8cc29ced
--- /dev/null
+++ b/.hark/changes/2026-09-16_zacchua_fix-event-handler-account-scoping.change.md
@@ -0,0 +1,8 @@
+---
+title: Fix account scoping for event notification handler callback clients
+pr_url: https://github.com/stripe/stripe-python/pull/1911
+semver_level: patch
+---
+
+- Fix callback clients to use the event's Stripe context and preserve the original client's non-account configuration.
+- Fix API errors when using an event notification handler with a client configured with a Stripe account.
diff --git a/stripe/_stripe_client.py b/stripe/_stripe_client.py
index f2c01b076..1db63f0c1 100644
--- a/stripe/_stripe_client.py
+++ b/stripe/_stripe_client.py
@@ -353,7 +353,6 @@ def with_stripe_context(
         """
         return StripeClient(
             api_key=self._requestor.api_key,  # type: ignore
-            stripe_account=self._requestor._options.stripe_account,
             stripe_context=stripe_context,
             stripe_version=self._requestor._options.stripe_version,
             base_addresses=self._requestor._options.base_addresses,
diff --git a/tests/test_event_notification_handler.py b/tests/test_event_notification_handler.py
index c47460589..74dad1855 100644
--- a/tests/test_event_notification_handler.py
+++ b/tests/test_event_notification_handler.py
@@ -29,6 +29,7 @@ class TestEventNotificationHandler:
     def stripe_client(self, http_client_mock: HTTPClientMock) -> StripeClient:
         return StripeClient(
             api_key="sk_test_1234",
+            stripe_account="acct_123",
             stripe_context=StripeContext.parse("original_context_123"),
             http_client=http_client_mock.get_mock_http_client(),
         )
@@ -249,12 +250,14 @@ def test_handler_uses_event_stripe_context(
     ) -> None:
         """Test that the handler receives a client with stripe_context from the event"""
         received_context: Optional[StripeContext | str] = None
+        received_account: Optional[str] = None
 
         def handler(
             event: V1BillingMeterErrorReportTriggeredEventNotification,
             client: StripeClient,
         ) -> None:
-            nonlocal received_context
+            nonlocal received_account, received_context
+            received_account = client._requestor._options.stripe_account
             received_context = client._requestor._options.stripe_context
 
         event_handler.on_v1_billing_meter_error_report_triggered(handler)
@@ -268,6 +271,7 @@ def handler(
         event_handler.handle(v1_billing_meter_payload, sig_header)
 
         assert str(received_context) == "event_context_456"
+        assert received_account is None
 
     def test_stripe_context_restored_after_handler_success(
         self,