diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 4e1cbb2de01..c7d166a31c6 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 00000000000..aed1225806e
--- /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 25cd8201cc6..c0f321f1aa7 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-05-16_unknown_add-missing-fields.change.md b/.hark/changes/2012-05-16_unknown_add-missing-fields.change.md
new file mode 100644
index 00000000000..3d59937c08a
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_add-missing-fields.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add missing fields to Charge, Coupon, Discount, Event, and Invoice models (github issue #12)"
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_add-new-deletediscou.change.md b/.hark/changes/2012-05-16_unknown_add-new-deletediscou.change.md
new file mode 100644
index 00000000000..c6b31e44682
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_add-new-deletediscou.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new deleteDiscount method to com.stripe.model.Customer
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_change-type-cvccheck.change.md b/.hark/changes/2012-05-16_unknown_change-type-cvccheck.change.md
new file mode 100644
index 00000000000..52b6294a2b9
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_change-type-cvccheck.change.md
@@ -0,0 +1,4 @@
+---
+title: "Change type of cvcCheck, addressZipCheck, and addressLine1Check attributes on com.stripe.model.Card; values of those fields will be \"pass\", \"fail\", \"unchecked\", or null (github issue #11)"
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_include-parameters-passed.change.md b/.hark/changes/2012-05-16_unknown_include-parameters-passed.change.md
new file mode 100644
index 00000000000..67856e46fc8
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_include-parameters-passed.change.md
@@ -0,0 +1,4 @@
+---
+title: "Include parameters passed to any object's delete method in actual API requests (github issue #10)"
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_numerous-test-suite.change.md b/.hark/changes/2012-05-16_unknown_numerous-test-suite.change.md
new file mode 100644
index 00000000000..7080670414e
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_numerous-test-suite.change.md
@@ -0,0 +1,4 @@
+---
+title: Numerous test suite improvements
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_remove-code-percentoff.change.md b/.hark/changes/2012-05-16_unknown_remove-code-percentoff.change.md
new file mode 100644
index 00000000000..e7d82275388
--- /dev/null
+++ b/.hark/changes/2012-05-16_unknown_remove-code-percentoff.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove code and percentOff attributes from com.stripe.model.Discount. Stripe never returned these values for Discount objects, so they would previously always be null
+released_in_version: 1.1.0
+---
diff --git a/.hark/changes/2012-05-16_unknown_switch-using-http.change.md b/.hark/changes/2012-05-16_unknown_switch-using-http.change.md
new file mode 100644
index 00000000000..7fe9ad0d7d1
--- /dev/null
+++ b/.hark/changes/2012-05-16_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.1.0
+---
diff --git a/.hark/changes/2012-05-24_unknown_use-string-length.change.md b/.hark/changes/2012-05-24_unknown_use-string-length.change.md
new file mode 100644
index 00000000000..138a30a2830
--- /dev/null
+++ b/.hark/changes/2012-05-24_unknown_use-string-length.change.md
@@ -0,0 +1,4 @@
+---
+title: Use String.length() == 0 instead of String.isEmpty() for compatibility with JDK 1.5 (needed for Android 2.2)
+released_in_version: 1.1.1
+---
diff --git a/.hark/changes/2012-08-06_unknown_allow-specificatio-api.change.md b/.hark/changes/2012-08-06_unknown_allow-specificatio-api.change.md
new file mode 100644
index 00000000000..aadb469a98c
--- /dev/null
+++ b/.hark/changes/2012-08-06_unknown_allow-specificatio-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow specification of API key at the API call level
+released_in_version: 1.1.2
+---
diff --git a/.hark/changes/2012-08-17_unknown_add-account-api.change.md b/.hark/changes/2012-08-17_unknown_add-account-api.change.md
new file mode 100644
index 00000000000..2baff7cb982
--- /dev/null
+++ b/.hark/changes/2012-08-17_unknown_add-account-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Add the Account API resource
+released_in_version: 1.1.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 00000000000..05c8427dae8
--- /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.1.4
+---
diff --git a/.hark/changes/2012-09-26_unknown_pass-query-parameters.change.md b/.hark/changes/2012-09-26_unknown_pass-query-parameters.change.md
new file mode 100644
index 00000000000..d7b58e5a4d0
--- /dev/null
+++ b/.hark/changes/2012-09-26_unknown_pass-query-parameters.change.md
@@ -0,0 +1,4 @@
+---
+title: "Pass query parameters to DELETE-based methods when using Google App Engine (github issue #17)"
+released_in_version: 1.1.5
+---
diff --git a/.hark/changes/2012-10-15_unknown_add-fee-api.change.md b/.hark/changes/2012-10-15_unknown_add-fee-api.change.md
new file mode 100644
index 00000000000..a5d365685da
--- /dev/null
+++ b/.hark/changes/2012-10-15_unknown_add-fee-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Add Fee API resource, add feeDetails to Charge API resource.
+released_in_version: 1.1.6
+---
diff --git a/.hark/changes/2012-10-24_unknown_add-quantity-subscription.change.md b/.hark/changes/2012-10-24_unknown_add-quantity-subscription.change.md
new file mode 100644
index 00000000000..8fa82a94e43
--- /dev/null
+++ b/.hark/changes/2012-10-24_unknown_add-quantity-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Add quantity to Subscription
+released_in_version: 1.1.7
+---
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 00000000000..56184c8155d
--- /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.1.8
+---
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 00000000000..5bcfda0e81b
--- /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.1.8
+---
diff --git a/.hark/changes/2012-11-08_unknown_add-new-dispute.change.md b/.hark/changes/2012-11-08_unknown_add-new-dispute.change.md
new file mode 100644
index 00000000000..6db3d58467e
--- /dev/null
+++ b/.hark/changes/2012-11-08_unknown_add-new-dispute.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new Dispute resource
+released_in_version: 1.1.9
+---
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 00000000000..9336a377b1a
--- /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.1.9
+---
diff --git a/.hark/changes/2012-11-15_unknown_add-amountoff-currency.change.md b/.hark/changes/2012-11-15_unknown_add-amountoff-currency.change.md
new file mode 100644
index 00000000000..4c82d16afd6
--- /dev/null
+++ b/.hark/changes/2012-11-15_unknown_add-amountoff-currency.change.md
@@ -0,0 +1,4 @@
+---
+title: Add amountOff and currency to Coupon resource
+released_in_version: 1.1.10
+---
diff --git a/.hark/changes/2012-11-15_unknown_add-currency-invoice.change.md b/.hark/changes/2012-11-15_unknown_add-currency-invoice.change.md
new file mode 100644
index 00000000000..787be63b8b5
--- /dev/null
+++ b/.hark/changes/2012-11-15_unknown_add-currency-invoice.change.md
@@ -0,0 +1,4 @@
+---
+title: Add currency to Invoice resource
+released_in_version: 1.1.10
+---
diff --git a/.hark/changes/2012-11-17_unknown_explict-cast-javax.change.md b/.hark/changes/2012-11-17_unknown_explict-cast-javax.change.md
new file mode 100644
index 00000000000..a11e1749f92
--- /dev/null
+++ b/.hark/changes/2012-11-17_unknown_explict-cast-javax.change.md
@@ -0,0 +1,4 @@
+---
+title: Explict cast to javax.net.ssl.HttpsURLConnection to prevent issues with user imports
+released_in_version: 1.1.11
+---
diff --git a/.hark/changes/2012-12-24_unknown_add-option-provide.change.md b/.hark/changes/2012-12-24_unknown_add-option-provide.change.md
new file mode 100644
index 00000000000..02d6987792d
--- /dev/null
+++ b/.hark/changes/2012-12-24_unknown_add-option-provide.change.md
@@ -0,0 +1,4 @@
+---
+title: Add option to provide custom URL handler
+released_in_version: 1.1.12
+---
diff --git a/.hark/changes/2012-12-29_unknown_add-addresscity-card.change.md b/.hark/changes/2012-12-29_unknown_add-addresscity-card.change.md
new file mode 100644
index 00000000000..83bc28643de
--- /dev/null
+++ b/.hark/changes/2012-12-29_unknown_add-addresscity-card.change.md
@@ -0,0 +1,4 @@
+---
+title: Add address_city to card
+released_in_version: 1.1.13
+---
diff --git a/.hark/changes/2012-12-29_unknown_upgrade-google-gson.change.md b/.hark/changes/2012-12-29_unknown_upgrade-google-gson.change.md
new file mode 100644
index 00000000000..606cfb6854b
--- /dev/null
+++ b/.hark/changes/2012-12-29_unknown_upgrade-google-gson.change.md
@@ -0,0 +1,4 @@
+---
+title: Upgrade Google GSON to 2.2.2
+released_in_version: 1.1.13
+---
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 00000000000..eb61c46d497
--- /dev/null
+++ b/.hark/changes/2013-01-15_unknown_add-support-setting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for setting Stripe API version override.
+released_in_version: 1.1.14
+---
diff --git a/.hark/changes/2013-02-01_unknown_add-support-plan.change.md b/.hark/changes/2013-02-01_unknown_add-support-plan.change.md
new file mode 100644
index 00000000000..2ab18b84a55
--- /dev/null
+++ b/.hark/changes/2013-02-01_unknown_add-support-plan.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for plan interval count.
+released_in_version: 1.1.15
+---
diff --git a/.hark/changes/2013-02-01_unknown_list-all-checked.change.md b/.hark/changes/2013-02-01_unknown_list-all-checked.change.md
new file mode 100644
index 00000000000..2d32ec80b2a
--- /dev/null
+++ b/.hark/changes/2013-02-01_unknown_list-all-checked.change.md
@@ -0,0 +1,4 @@
+---
+title: List all checked exceptions throws by methods.
+released_in_version: 1.1.15
+---
diff --git a/.hark/changes/2013-02-15_unknown_fix-off-one.change.md b/.hark/changes/2013-02-15_unknown_fix-off-one.change.md
new file mode 100644
index 00000000000..3d4c5796eed
--- /dev/null
+++ b/.hark/changes/2013-02-15_unknown_fix-off-one.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix off-by-one error in deserializing events (github issue #27)."
+released_in_version: 1.1.16
+---
diff --git a/.hark/changes/2013-02-18_unknown_add-ability-deserialize.change.md b/.hark/changes/2013-02-18_unknown_add-ability-deserialize.change.md
new file mode 100644
index 00000000000..66dab9e4c5a
--- /dev/null
+++ b/.hark/changes/2013-02-18_unknown_add-ability-deserialize.change.md
@@ -0,0 +1,4 @@
+---
+title: Add ability to deserialize account-related events.
+released_in_version: 1.1.17
+---
diff --git a/.hark/changes/2013-02-18_unknown_add-user-id.change.md b/.hark/changes/2013-02-18_unknown_add-user-id.change.md
new file mode 100644
index 00000000000..303ce429fae
--- /dev/null
+++ b/.hark/changes/2013-02-18_unknown_add-user-id.change.md
@@ -0,0 +1,4 @@
+---
+title: Add user ID to Event object.
+released_in_version: 1.1.17
+---
diff --git a/.hark/changes/2013-03-18_unknown_add-support-charge.change.md b/.hark/changes/2013-03-18_unknown_add-support-charge.change.md
new file mode 100644
index 00000000000..5e884052ea6
--- /dev/null
+++ b/.hark/changes/2013-03-18_unknown_add-support-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for charge capture.
+released_in_version: 1.1.18
+---
diff --git a/.hark/changes/2013-04-20_unknown_add-new-recipient.change.md b/.hark/changes/2013-04-20_unknown_add-new-recipient.change.md
new file mode 100644
index 00000000000..f64ced4d9d0
--- /dev/null
+++ b/.hark/changes/2013-04-20_unknown_add-new-recipient.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new Recipient resource
+released_in_version: 1.2.0
+---
diff --git a/.hark/changes/2013-04-20_unknown_allow-transfers-creatable.change.md b/.hark/changes/2013-04-20_unknown_allow-transfers-creatable.change.md
new file mode 100644
index 00000000000..aacc3c4912c
--- /dev/null
+++ b/.hark/changes/2013-04-20_unknown_allow-transfers-creatable.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow Transfers to be creatable
+released_in_version: 1.2.0
+---
diff --git a/.hark/changes/2013-04-20_unknown_fix-transfertran-fee.change.md b/.hark/changes/2013-04-20_unknown_fix-transfertran-fee.change.md
new file mode 100644
index 00000000000..0e513486938
--- /dev/null
+++ b/.hark/changes/2013-04-20_unknown_fix-transfertran-fee.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix TransferTransaction fee retrieval
+released_in_version: 1.2.1
+---
diff --git a/.hark/changes/2013-04-25_unknown_add-more-objects.change.md b/.hark/changes/2013-04-25_unknown_add-more-objects.change.md
new file mode 100644
index 00000000000..7d091221e52
--- /dev/null
+++ b/.hark/changes/2013-04-25_unknown_add-more-objects.change.md
@@ -0,0 +1,4 @@
+---
+title: Add more objects to Deserializer
+released_in_version: 1.2.2
+---
diff --git a/.hark/changes/2013-05-07_unknown_rename-bankaccount-property.change.md b/.hark/changes/2013-05-07_unknown_rename-bankaccount-property.change.md
new file mode 100644
index 00000000000..5c0de52e95a
--- /dev/null
+++ b/.hark/changes/2013-05-07_unknown_rename-bankaccount-property.change.md
@@ -0,0 +1,4 @@
+---
+title: Rename BankAccount property `valid` to `validated`
+released_in_version: 1.2.3
+---
diff --git a/.hark/changes/2013-06-22_unknown_add-more-balance.change.md b/.hark/changes/2013-06-22_unknown_add-more-balance.change.md
new file mode 100644
index 00000000000..32d8e1b0fae
--- /dev/null
+++ b/.hark/changes/2013-06-22_unknown_add-more-balance.change.md
@@ -0,0 +1,4 @@
+---
+title: Add more Balance API resource, and add to deserializer.
+released_in_version: 1.2.4
+---
diff --git a/.hark/changes/2013-07-15_unknown_add-money-class.change.md b/.hark/changes/2013-07-15_unknown_add-money-class.change.md
new file mode 100644
index 00000000000..210aea3099a
--- /dev/null
+++ b/.hark/changes/2013-07-15_unknown_add-money-class.change.md
@@ -0,0 +1,4 @@
+---
+title: Add a Money class for representing account balances in individual currencies
+released_in_version: 1.2.5
+---
diff --git a/.hark/changes/2013-07-15_unknown_add-striperawjso-type.change.md b/.hark/changes/2013-07-15_unknown_add-striperawjso-type.change.md
new file mode 100644
index 00000000000..f185292743d
--- /dev/null
+++ b/.hark/changes/2013-07-15_unknown_add-striperawjso-type.change.md
@@ -0,0 +1,4 @@
+---
+title: Add a StripeRawJsonObject type for deserializing webhook events we don't recognize
+released_in_version: 1.2.5
+---
diff --git a/.hark/changes/2013-07-15_unknown_add-support-new.change.md b/.hark/changes/2013-07-15_unknown_add-support-new.change.md
new file mode 100644
index 00000000000..98fdd4a7a8b
--- /dev/null
+++ b/.hark/changes/2013-07-15_unknown_add-support-new.change.md
@@ -0,0 +1,6 @@
+---
+title: Add support for new cards API.
+released_in_version: 1.2.5
+---
+
+* You will probably need to upgrade the Stripe API version on your account to 2013-07-05 or explicitly specify an API version with com.stripe.Stripe.apiVersion when you switch to this release of the bindings. More information about the relevant changes can be found at https://docs.stripe.com/changelog/2013-07-05 and http://bit.ly/13miHM8
diff --git a/.hark/changes/2013-07-30_unknown_add-createcard-customer.change.md b/.hark/changes/2013-07-30_unknown_add-createcard-customer.change.md
new file mode 100644
index 00000000000..576e6cd0ae2
--- /dev/null
+++ b/.hark/changes/2013-07-30_unknown_add-createcard-customer.change.md
@@ -0,0 +1,4 @@
+---
+title: Add 'createCard' to Customer
+released_in_version: 1.2.6
+---
diff --git a/.hark/changes/2013-07-30_unknown_parse-card-objects.change.md b/.hark/changes/2013-07-30_unknown_parse-card-objects.change.md
new file mode 100644
index 00000000000..76fa343e855
--- /dev/null
+++ b/.hark/changes/2013-07-30_unknown_parse-card-objects.change.md
@@ -0,0 +1,4 @@
+---
+title: Parse card objects when receiving customer.card.created events
+released_in_version: 1.2.6
+---
diff --git a/.hark/changes/2013-07-30_unknown_update-card-collections.change.md b/.hark/changes/2013-07-30_unknown_update-card-collections.change.md
new file mode 100644
index 00000000000..18d4f1227df
--- /dev/null
+++ b/.hark/changes/2013-07-30_unknown_update-card-collections.change.md
@@ -0,0 +1,4 @@
+---
+title: Update card collections bindings
+released_in_version: 1.2.6
+---
diff --git a/.hark/changes/2013-07-31_unknown_enable-createcard-use.change.md b/.hark/changes/2013-07-31_unknown_enable-createcard-use.change.md
new file mode 100644
index 00000000000..4b07fad2c37
--- /dev/null
+++ b/.hark/changes/2013-07-31_unknown_enable-createcard-use.change.md
@@ -0,0 +1,4 @@
+---
+title: Enable createCard() to use a token
+released_in_version: 1.2.7
+---
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 00000000000..ecface1a489
--- /dev/null
+++ b/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for unsetting attributes by updating with a null value. Setting properties to a blank string is now an error.
+released_in_version: 1.2.8
+---
diff --git a/.hark/changes/2013-08-19_unknown_add-balancetrans-api.change.md b/.hark/changes/2013-08-19_unknown_add-balancetrans-api.change.md
new file mode 100644
index 00000000000..c80c69c1082
--- /dev/null
+++ b/.hark/changes/2013-08-19_unknown_add-balancetrans-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Add BalanceTransaction API resource
+released_in_version: 1.3.0
+---
diff --git a/.hark/changes/2013-08-19_unknown_add-refund-resource.change.md b/.hark/changes/2013-08-19_unknown_add-refund-resource.change.md
new file mode 100644
index 00000000000..208150814e5
--- /dev/null
+++ b/.hark/changes/2013-08-19_unknown_add-refund-resource.change.md
@@ -0,0 +1,4 @@
+---
+title: Add Refund resource
+released_in_version: 1.3.0
+---
diff --git a/.hark/changes/2013-08-19_unknown_resource-updates.change.md b/.hark/changes/2013-08-19_unknown_resource-updates.change.md
new file mode 100644
index 00000000000..c762105cdd3
--- /dev/null
+++ b/.hark/changes/2013-08-19_unknown_resource-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: Resource updates
+released_in_version: 1.3.0
+---
+
+* Remove `fee`, `feeDetails` from Transfer and Charge resources
+* Add `balanceTransaction` to Transfer, Charge, and Dispute resources
+* Add `refunds` to Charge resource
diff --git a/.hark/changes/2013-08-21_unknown_patch-release-missing.change.md b/.hark/changes/2013-08-21_unknown_patch-release-missing.change.md
new file mode 100644
index 00000000000..57d0080bb8e
--- /dev/null
+++ b/.hark/changes/2013-08-21_unknown_patch-release-missing.change.md
@@ -0,0 +1,4 @@
+---
+title: Patch release with missing field, added tests
+released_in_version: 1.3.1
+---
diff --git a/.hark/changes/2013-08-30_unknown_add-id-field.change.md b/.hark/changes/2013-08-30_unknown_add-id-field.change.md
new file mode 100644
index 00000000000..c9f286602ef
--- /dev/null
+++ b/.hark/changes/2013-08-30_unknown_add-id-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `id` field to `Subscription`
+released_in_version: 1.3.2
+---
diff --git a/.hark/changes/2013-08-30_unknown_add-missing-fields.change.md b/.hark/changes/2013-08-30_unknown_add-missing-fields.change.md
new file mode 100644
index 00000000000..639ef39fd63
--- /dev/null
+++ b/.hark/changes/2013-08-30_unknown_add-missing-fields.change.md
@@ -0,0 +1,9 @@
+---
+title: Add missing fields to `BalanceTransaction`
+released_in_version: 1.3.2
+---
+
+* `id`
+* `fee`
+* `fee_details`
+* `description`
diff --git a/.hark/changes/2013-08-30_unknown_add-missing-retrieve.change.md b/.hark/changes/2013-08-30_unknown_add-missing-retrieve.change.md
new file mode 100644
index 00000000000..76935581cdf
--- /dev/null
+++ b/.hark/changes/2013-08-30_unknown_add-missing-retrieve.change.md
@@ -0,0 +1,4 @@
+---
+title: Add missing `retrieve` method to `BalanceTransaction`
+released_in_version: 1.3.2
+---
diff --git a/.hark/changes/2013-09-03_unknown_tweak-card-create.change.md b/.hark/changes/2013-09-03_unknown_tweak-card-create.change.md
new file mode 100644
index 00000000000..0e16a2772d1
--- /dev/null
+++ b/.hark/changes/2013-09-03_unknown_tweak-card-create.change.md
@@ -0,0 +1,4 @@
+---
+title: Tweak card create to align it with docs
+released_in_version: 1.4.0
+---
diff --git a/.hark/changes/2013-09-04_unknown_fix-return-type.change.md b/.hark/changes/2013-09-04_unknown_fix-return-type.change.md
new file mode 100644
index 00000000000..40430a5481b
--- /dev/null
+++ b/.hark/changes/2013-09-04_unknown_fix-return-type.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix return type of CustomerCardCollection.retrieve
+released_in_version: 1.4.1
+---
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 00000000000..87720bab7da
--- /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.4.2
+---
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 00000000000..f83f70bb298
--- /dev/null
+++ b/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for metadata API
+released_in_version: 1.5.0
+---
diff --git a/.hark/changes/2013-10-17_unknown_added-field-transferenab.change.md b/.hark/changes/2013-10-17_unknown_added-field-transferenab.change.md
new file mode 100644
index 00000000000..6ccb54dcfee
--- /dev/null
+++ b/.hark/changes/2013-10-17_unknown_added-field-transferenab.change.md
@@ -0,0 +1,4 @@
+---
+title: Added field transfer_enabled to Account API object (thanks, kurguzov)
+released_in_version: 1.5.1
+---
diff --git a/.hark/changes/2013-12-04_unknown_add-applicationf-api.change.md b/.hark/changes/2013-12-04_unknown_add-applicationf-api.change.md
new file mode 100644
index 00000000000..65ad72bb093
--- /dev/null
+++ b/.hark/changes/2013-12-04_unknown_add-applicationf-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Add ApplicationFee API resource
+released_in_version: 1.6.1
+---
diff --git a/.hark/changes/2014-01-08_unknown_fix-return-type.change.md b/.hark/changes/2014-01-08_unknown_fix-return-type.change.md
new file mode 100644
index 00000000000..ea30d5c285d
--- /dev/null
+++ b/.hark/changes/2014-01-08_unknown_fix-return-type.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix return type of Coupon.getRedeemBy
+released_in_version: 1.6.2
+---
diff --git a/.hark/changes/2014-01-13_unknown_add-default-currency.change.md b/.hark/changes/2014-01-13_unknown_add-default-currency.change.md
new file mode 100644
index 00000000000..b6939434223
--- /dev/null
+++ b/.hark/changes/2014-01-13_unknown_add-default-currency.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add default currency to Account object (fixes #46)"
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2014-01-13_unknown_add-metadata-plan.change.md b/.hark/changes/2014-01-13_unknown_add-metadata-plan.change.md
new file mode 100644
index 00000000000..d02e9cdfa65
--- /dev/null
+++ b/.hark/changes/2014-01-13_unknown_add-metadata-plan.change.md
@@ -0,0 +1,4 @@
+---
+title: Add metadata to plan object (thanks, desirable-objects)
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2014-01-13_unknown_remove-plan-customer.change.md b/.hark/changes/2014-01-13_unknown_remove-plan-customer.change.md
new file mode 100644
index 00000000000..b38f1457502
--- /dev/null
+++ b/.hark/changes/2014-01-13_unknown_remove-plan-customer.change.md
@@ -0,0 +1,4 @@
+---
+title: "Remove plan from Customer (fixes #42)"
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2014-01-13_unknown_style-improvements-see.change.md b/.hark/changes/2014-01-13_unknown_style-improvements-see.change.md
new file mode 100644
index 00000000000..c7d1445072a
--- /dev/null
+++ b/.hark/changes/2014-01-13_unknown_style-improvements-see.change.md
@@ -0,0 +1,4 @@
+---
+title: "Style improvements (see #30) (thanks, steve-nester-uk)"
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2014-01-13_unknown_support-overriding-base.change.md b/.hark/changes/2014-01-13_unknown_support-overriding-base.change.md
new file mode 100644
index 00000000000..e83712b620a
--- /dev/null
+++ b/.hark/changes/2014-01-13_unknown_support-overriding-base.change.md
@@ -0,0 +1,4 @@
+---
+title: Support overriding base url (for testing) (user request)
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2014-01-16_unknown_added-metadata-invoiceitem.change.md b/.hark/changes/2014-01-16_unknown_added-metadata-invoiceitem.change.md
new file mode 100644
index 00000000000..4af9d5817c9
--- /dev/null
+++ b/.hark/changes/2014-01-16_unknown_added-metadata-invoiceitem.change.md
@@ -0,0 +1,4 @@
+---
+title: "Added metadata to InvoiceItem and InvoiceLineItem (fixes #59)"
+released_in_version: 1.6.4
+---
diff --git a/.hark/changes/2014-01-22_unknown_dry-d-some.change.md b/.hark/changes/2014-01-22_unknown_dry-d-some.change.md
new file mode 100644
index 00000000000..05a9148c17d
--- /dev/null
+++ b/.hark/changes/2014-01-22_unknown_dry-d-some.change.md
@@ -0,0 +1,4 @@
+---
+title: DRY'd some of the application fee urls
+released_in_version: 1.6.5
+---
diff --git a/.hark/changes/2014-01-22_unknown_fixed-url-refund.change.md b/.hark/changes/2014-01-22_unknown_fixed-url-refund.change.md
new file mode 100644
index 00000000000..3dfab1a11ba
--- /dev/null
+++ b/.hark/changes/2014-01-22_unknown_fixed-url-refund.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fixed url to refund application fees (fixes #60)"
+released_in_version: 1.6.5
+---
diff --git a/.hark/changes/2014-01-29_unknown_add-support-multiple.change.md b/.hark/changes/2014-01-29_unknown_add-support-multiple.change.md
new file mode 100644
index 00000000000..19bff0391ea
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_add-support-multiple.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for multiple subscriptions per customer
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2014-01-31_unknown_fix-subscription-cancel.change.md b/.hark/changes/2014-01-31_unknown_fix-subscription-cancel.change.md
new file mode 100644
index 00000000000..f044e585e1e
--- /dev/null
+++ b/.hark/changes/2014-01-31_unknown_fix-subscription-cancel.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix Subscription cancel method call
+released_in_version: 1.7.1
+---
diff --git a/.hark/changes/2014-01-31_unknown_miscellaneou-field-fixups.change.md b/.hark/changes/2014-01-31_unknown_miscellaneou-field-fixups.change.md
new file mode 100644
index 00000000000..51d8d144f19
--- /dev/null
+++ b/.hark/changes/2014-01-31_unknown_miscellaneou-field-fixups.change.md
@@ -0,0 +1,8 @@
+---
+title: Miscellaneous field fixups
+released_in_version: 1.7.1
+---
+
+* Discount on Subscription is an expanded Discount, not string
+* Add missing application_fee_percent field on Subscription
+* Add missing application_fee field on Invoice
diff --git a/.hark/changes/2014-02-27_unknown_add-valid-field.change.md b/.hark/changes/2014-02-27_unknown_add-valid-field.change.md
new file mode 100644
index 00000000000..37edb1ddae6
--- /dev/null
+++ b/.hark/changes/2014-02-27_unknown_add-valid-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Add 'valid' field to coupon
+released_in_version: 1.7.2
+---
diff --git a/.hark/changes/2014-03-12_unknown_upgrade-google-gson.change.md b/.hark/changes/2014-03-12_unknown_upgrade-google-gson.change.md
new file mode 100644
index 00000000000..55ed72c011e
--- /dev/null
+++ b/.hark/changes/2014-03-12_unknown_upgrade-google-gson.change.md
@@ -0,0 +1,4 @@
+---
+title: Upgrade Google GSON to 2.2.4
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2014-03-12_unknown_url-encode-object.change.md b/.hark/changes/2014-03-12_unknown_url-encode-object.change.md
new file mode 100644
index 00000000000..fb2582c21fd
--- /dev/null
+++ b/.hark/changes/2014-03-12_unknown_url-encode-object.change.md
@@ -0,0 +1,4 @@
+---
+title: "URL-encode object ids (fixes #62)"
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2014-03-17_unknown_preserve-original-threaqd.change.md b/.hark/changes/2014-03-17_unknown_preserve-original-threaqd.change.md
new file mode 100644
index 00000000000..421e6ade17e
--- /dev/null
+++ b/.hark/changes/2014-03-17_unknown_preserve-original-threaqd.change.md
@@ -0,0 +1,4 @@
+---
+title: Preserve original 'threaqd null ids through to requests' behavior
+released_in_version: 1.9.0
+---
diff --git a/.hark/changes/2014-03-17_unknown_support-dynamic-statement.change.md b/.hark/changes/2014-03-17_unknown_support-dynamic-statement.change.md
new file mode 100644
index 00000000000..0f6f61214c3
--- /dev/null
+++ b/.hark/changes/2014-03-17_unknown_support-dynamic-statement.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for dynamic statement descriptions
+released_in_version: 1.9.0
+---
diff --git a/.hark/changes/2014-03-28_unknown_support-newstyle-pagination.change.md b/.hark/changes/2014-03-28_unknown_support-newstyle-pagination.change.md
new file mode 100644
index 00000000000..76be3a96fe1
--- /dev/null
+++ b/.hark/changes/2014-03-28_unknown_support-newstyle-pagination.change.md
@@ -0,0 +1,4 @@
+---
+title: "Support for newstyle pagination API (https://groups.google.com/a/lists.stripe.com/forum/#!topic/api-announce/29sLxmICA9E)"
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-04-07_unknown_add-missing-fields.change.md b/.hark/changes/2014-04-07_unknown_add-missing-fields.change.md
new file mode 100644
index 00000000000..c3162d3b527
--- /dev/null
+++ b/.hark/changes/2014-04-07_unknown_add-missing-fields.change.md
@@ -0,0 +1,4 @@
+---
+title: Add missing fields to Account object
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2014-04-07_unknown_upgrade-customer-charge.change.md b/.hark/changes/2014-04-07_unknown_upgrade-customer-charge.change.md
new file mode 100644
index 00000000000..35e392f1797
--- /dev/null
+++ b/.hark/changes/2014-04-07_unknown_upgrade-customer-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: Upgrade customer, charge, and coupon collections to new pagination style
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2014-04-09_unknown_test-ssl-certificate.change.md b/.hark/changes/2014-04-09_unknown_test-ssl-certificate.change.md
new file mode 100644
index 00000000000..84900ca0436
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_test-ssl-certificate.change.md
@@ -0,0 +1,4 @@
+---
+title: Test SSL certificate against blacklist
+released_in_version: 1.12.0
+---
diff --git a/.hark/changes/2014-05-21_unknown_support-cards-recipients.change.md b/.hark/changes/2014-05-21_unknown_support-cards-recipients.change.md
new file mode 100644
index 00000000000..7e8ebfcbb68
--- /dev/null
+++ b/.hark/changes/2014-05-21_unknown_support-cards-recipients.change.md
@@ -0,0 +1,4 @@
+---
+title: Support cards for recipients.
+released_in_version: 1.13.0
+---
diff --git a/.hark/changes/2014-05-23_unknown_fix-bug-retrieving.change.md b/.hark/changes/2014-05-23_unknown_fix-bug-retrieving.change.md
new file mode 100644
index 00000000000..9cc47aa3ec1
--- /dev/null
+++ b/.hark/changes/2014-05-23_unknown_fix-bug-retrieving.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug with retrieving lines of upcoming invoice.
+released_in_version: 1.13.1
+---
diff --git a/.hark/changes/2014-05-28_unknown_add-support-canceling.change.md b/.hark/changes/2014-05-28_unknown_add-support-canceling.change.md
new file mode 100644
index 00000000000..fe8087b4ee3
--- /dev/null
+++ b/.hark/changes/2014-05-28_unknown_add-support-canceling.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for canceling transfers
+released_in_version: 1.14.0
+---
diff --git a/.hark/changes/2014-06-04_unknown_added-metadata-subscription.change.md b/.hark/changes/2014-06-04_unknown_added-metadata-subscription.change.md
new file mode 100644
index 00000000000..efdeb53262b
--- /dev/null
+++ b/.hark/changes/2014-06-04_unknown_added-metadata-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Added metadata to Subscription
+released_in_version: 1.14.1
+---
diff --git a/.hark/changes/2014-06-17_unknown_added-metadata-dispute.change.md b/.hark/changes/2014-06-17_unknown_added-metadata-dispute.change.md
new file mode 100644
index 00000000000..4b82f645f9f
--- /dev/null
+++ b/.hark/changes/2014-06-17_unknown_added-metadata-dispute.change.md
@@ -0,0 +1,4 @@
+---
+title: Added metadata to Dispute
+released_in_version: 1.15.0
+---
diff --git a/.hark/changes/2014-06-17_unknown_added-metadata-refund.change.md b/.hark/changes/2014-06-17_unknown_added-metadata-refund.change.md
new file mode 100644
index 00000000000..46bb7259746
--- /dev/null
+++ b/.hark/changes/2014-06-17_unknown_added-metadata-refund.change.md
@@ -0,0 +1,4 @@
+---
+title: Added metadata to Refund
+released_in_version: 1.15.0
+---
diff --git a/.hark/changes/2014-06-17_unknown_fixed-incorrect-return.change.md b/.hark/changes/2014-06-17_unknown_fixed-incorrect-return.change.md
new file mode 100644
index 00000000000..f76c63c0dd6
--- /dev/null
+++ b/.hark/changes/2014-06-17_unknown_fixed-incorrect-return.change.md
@@ -0,0 +1,4 @@
+---
+title: Fixed incorrect return types for certain collection resources
+released_in_version: 1.15.0
+---
diff --git a/.hark/changes/2014-06-25_unknown_added-brand-funding.change.md b/.hark/changes/2014-06-25_unknown_added-brand-funding.change.md
new file mode 100644
index 00000000000..c00e281b1c0
--- /dev/null
+++ b/.hark/changes/2014-06-25_unknown_added-brand-funding.change.md
@@ -0,0 +1,4 @@
+---
+title: Added brand and funding to Card
+released_in_version: 1.15.1
+---
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 00000000000..0ce7bd1a58b
--- /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.16.0
+---
diff --git a/.hark/changes/2014-08-19_unknown_added-metadata-coupons.change.md b/.hark/changes/2014-08-19_unknown_added-metadata-coupons.change.md
new file mode 100644
index 00000000000..9691bd7b0a0
--- /dev/null
+++ b/.hark/changes/2014-08-19_unknown_added-metadata-coupons.change.md
@@ -0,0 +1,4 @@
+---
+title: Added metadata to Coupons
+released_in_version: 1.17.0
+---
diff --git a/.hark/changes/2014-08-25_unknown_added-ischargerefu-balancetrans.change.md b/.hark/changes/2014-08-25_unknown_added-ischargerefu-balancetrans.change.md
new file mode 100644
index 00000000000..ee4dc876148
--- /dev/null
+++ b/.hark/changes/2014-08-25_unknown_added-ischargerefu-balancetrans.change.md
@@ -0,0 +1,4 @@
+---
+title: Added isChargeRefundable and balanceTransactions to Dispute https://docs.stripe.com/changelog/2014-08-20
+released_in_version: 1.18.0
+---
diff --git a/.hark/changes/2014-09-29_unknown_add-statementdes-field.change.md b/.hark/changes/2014-09-29_unknown_add-statementdes-field.change.md
new file mode 100644
index 00000000000..31b24941650
--- /dev/null
+++ b/.hark/changes/2014-09-29_unknown_add-statementdes-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Add statementDescription field to transfer
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2014-09-29_unknown_few-non-breaking.change.md b/.hark/changes/2014-09-29_unknown_few-non-breaking.change.md
new file mode 100644
index 00000000000..7d793e57b26
--- /dev/null
+++ b/.hark/changes/2014-09-29_unknown_few-non-breaking.change.md
@@ -0,0 +1,4 @@
+---
+title: A few non-breaking general cleanups
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2014-10-02_unknown_add-back-explict.change.md b/.hark/changes/2014-10-02_unknown_add-back-explict.change.md
new file mode 100644
index 00000000000..4ae80e0649c
--- /dev/null
+++ b/.hark/changes/2014-10-02_unknown_add-back-explict.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add back explict autoboxing for Google App Engine reflected HTTP method (fixes issue #106)"
+released_in_version: 1.19.1
+---
diff --git a/.hark/changes/2014-11-06_unknown_add-id-currency.change.md b/.hark/changes/2014-11-06_unknown_add-id-currency.change.md
new file mode 100644
index 00000000000..335d2428e08
--- /dev/null
+++ b/.hark/changes/2014-11-06_unknown_add-id-currency.change.md
@@ -0,0 +1,4 @@
+---
+title: Add id, currency, status, fingerprint, and defaultForCurrency to BankAccount
+released_in_version: 1.20.0
+---
diff --git a/.hark/changes/2014-11-06_unknown_change-chargeenable-chargesenabl.change.md b/.hark/changes/2014-11-06_unknown_change-chargeenable-chargesenabl.change.md
new file mode 100644
index 00000000000..4aa21886690
--- /dev/null
+++ b/.hark/changes/2014-11-06_unknown_change-chargeenable-chargesenabl.change.md
@@ -0,0 +1,4 @@
+---
+title: Change chargeEnabled to chargesEnabled
+released_in_version: 1.20.0
+---
diff --git a/.hark/changes/2014-11-06_unknown_change-transferenab-transfersena.change.md b/.hark/changes/2014-11-06_unknown_change-transferenab-transfersena.change.md
new file mode 100644
index 00000000000..46d49276324
--- /dev/null
+++ b/.hark/changes/2014-11-06_unknown_change-transferenab-transfersena.change.md
@@ -0,0 +1,4 @@
+---
+title: Change transferEnabled to transfersEnabled
+released_in_version: 1.20.0
+---
diff --git a/.hark/changes/2014-11-14_unknown_created-charge-receiptemail.change.md b/.hark/changes/2014-11-14_unknown_created-charge-receiptemail.change.md
new file mode 100644
index 00000000000..3ee6c7bda1b
--- /dev/null
+++ b/.hark/changes/2014-11-14_unknown_created-charge-receiptemail.change.md
@@ -0,0 +1,4 @@
+---
+title: Created Charge.receiptEmail field
+released_in_version: 1.21.0
+---
diff --git a/.hark/changes/2014-11-14_unknown_created-charge-receiptnumbe.change.md b/.hark/changes/2014-11-14_unknown_created-charge-receiptnumbe.change.md
new file mode 100644
index 00000000000..1dea226b68f
--- /dev/null
+++ b/.hark/changes/2014-11-14_unknown_created-charge-receiptnumbe.change.md
@@ -0,0 +1,4 @@
+---
+title: Created Charge.receiptNumber field
+released_in_version: 1.21.0
+---
diff --git a/.hark/changes/2014-12-03_unknown_add-shipping-address.change.md b/.hark/changes/2014-12-03_unknown_add-shipping-address.change.md
new file mode 100644
index 00000000000..7dd97ce8f81
--- /dev/null
+++ b/.hark/changes/2014-12-03_unknown_add-shipping-address.change.md
@@ -0,0 +1,4 @@
+---
+title: Add shipping and address to the charge object
+released_in_version: 1.22.0
+---
diff --git a/.hark/changes/2014-12-03_unknown_all-requests-involve.change.md b/.hark/changes/2014-12-03_unknown_all-requests-involve.change.md
new file mode 100644
index 00000000000..0f739e0d0d0
--- /dev/null
+++ b/.hark/changes/2014-12-03_unknown_all-requests-involve.change.md
@@ -0,0 +1,7 @@
+---
+title: "All requests that involve passing the apiKey directly to the method are now deprecated in favor of using RequestOptions instead. Use RequestOptions as follows:"
+section: Deprecation
+released_in_version: 1.22.0
+---
+
+RequestOptions.builder().setApiKey(apiKey).build()
diff --git a/.hark/changes/2014-12-03_unknown_convention-call-methods.change.md b/.hark/changes/2014-12-03_unknown_convention-call-methods.change.md
new file mode 100644
index 00000000000..a62cd4c4983
--- /dev/null
+++ b/.hark/changes/2014-12-03_unknown_convention-call-methods.change.md
@@ -0,0 +1,4 @@
+---
+title: Convention is to call methods with a RequestOptions object, instead of an API Key directly
+released_in_version: 1.22.0
+---
diff --git a/.hark/changes/2014-12-03_unknown_support-setting-stripe.change.md b/.hark/changes/2014-12-03_unknown_support-setting-stripe.change.md
new file mode 100644
index 00000000000..ee98e32501a
--- /dev/null
+++ b/.hark/changes/2014-12-03_unknown_support-setting-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Support setting the stripe version on a per-request level, via the RequestOptions object
+released_in_version: 1.22.0
+---
diff --git a/.hark/changes/2014-12-08_unknown_dispute-evidence-updated.change.md b/.hark/changes/2014-12-08_unknown_dispute-evidence-updated.change.md
new file mode 100644
index 00000000000..c10eec74ec4
--- /dev/null
+++ b/.hark/changes/2014-12-08_unknown_dispute-evidence-updated.change.md
@@ -0,0 +1,4 @@
+---
+title: Dispute Evidence has been updated to reflect the new version of Dispute evidence format introduced as part of api version 2014-12-08. See https://docs.stripe.com/changelog/2014-12-08 for details
+released_in_version: 1.23.0
+---
diff --git a/.hark/changes/2014-12-08_unknown_java-1-5.change.md b/.hark/changes/2014-12-08_unknown_java-1-5.change.md
new file mode 100644
index 00000000000..1de9ff737dc
--- /dev/null
+++ b/.hark/changes/2014-12-08_unknown_java-1-5.change.md
@@ -0,0 +1,4 @@
+---
+title: Java 1.5 support dropped. We strongly suggest using newer versions of Java due to runtime, VM, language, and syntax improvements
+released_in_version: 1.23.0
+---
diff --git a/.hark/changes/2014-12-23_unknown_ability-post-multipart.change.md b/.hark/changes/2014-12-23_unknown_ability-post-multipart.change.md
new file mode 100644
index 00000000000..9af053985e3
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_ability-post-multipart.change.md
@@ -0,0 +1,4 @@
+---
+title: The ability to post multipart/form-data was added
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2014-12-23_unknown_requests-can-now.change.md b/.hark/changes/2014-12-23_unknown_requests-can-now.change.md
new file mode 100644
index 00000000000..7286a035656
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_requests-can-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Requests can now hit different base endpoints, by passing in `apiBase` when creating URLs
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2014-12-23_unknown_support-file-upload.change.md b/.hark/changes/2014-12-23_unknown_support-file-upload.change.md
new file mode 100644
index 00000000000..e05512b7046
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_support-file-upload.change.md
@@ -0,0 +1,4 @@
+---
+title: "Support for the file upload endpoints was added. Documentation is available at https://stripe.com/docs/api#file_uploads"
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2014-12-23_unknown_support-fraud-reporting.change.md b/.hark/changes/2014-12-23_unknown_support-fraud-reporting.change.md
new file mode 100644
index 00000000000..17da3782462
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_support-fraud-reporting.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for fraud reporting (marking charges as safe or fraudulent) was added
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-01-05_unknown_support-fraud-reporting.change.md b/.hark/changes/2015-01-05_unknown_support-fraud-reporting.change.md
new file mode 100644
index 00000000000..977ba5b16ad
--- /dev/null
+++ b/.hark/changes/2015-01-05_unknown_support-fraud-reporting.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for fraud reporting methods was added
+released_in_version: 1.24.1
+---
diff --git a/.hark/changes/2015-01-22_unknown_support-making-bitcoin.change.md b/.hark/changes/2015-01-22_unknown_support-making-bitcoin.change.md
new file mode 100644
index 00000000000..63d22a2e21b
--- /dev/null
+++ b/.hark/changes/2015-01-22_unknown_support-making-bitcoin.change.md
@@ -0,0 +1,4 @@
+---
+title: Support making bitcoin charges through BitcoinReceiver source object
+released_in_version: 1.25.0
+---
diff --git a/.hark/changes/2015-01-23_unknown_test-new-stripe.change.md b/.hark/changes/2015-01-23_unknown_test-new-stripe.change.md
new file mode 100644
index 00000000000..6c1c1e11d85
--- /dev/null
+++ b/.hark/changes/2015-01-23_unknown_test-new-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Test of new stripe-java release process.
+released_in_version: 1.25.1
+---
diff --git a/.hark/changes/2015-02-19_unknown_added-update-delete.change.md b/.hark/changes/2015-02-19_unknown_added-update-delete.change.md
new file mode 100644
index 00000000000..f57e995f20b
--- /dev/null
+++ b/.hark/changes/2015-02-19_unknown_added-update-delete.change.md
@@ -0,0 +1,4 @@
+---
+title: Added Update and Delete for Bitcoin Receivers
+released_in_version: 1.26.0
+---
diff --git a/.hark/changes/2015-02-19_unknown_support-new-api.change.md b/.hark/changes/2015-02-19_unknown_support-new-api.change.md
new file mode 100644
index 00000000000..d0dbac14089
--- /dev/null
+++ b/.hark/changes/2015-02-19_unknown_support-new-api.change.md
@@ -0,0 +1,6 @@
+---
+title: Support new API version (2015-02-18) by providing source type properties
+released_in_version: 1.26.0
+---
+
+on Customer and Charge in addition to card type properties
diff --git a/.hark/changes/2015-03-19_unknown_added-stripe-account.change.md b/.hark/changes/2015-03-19_unknown_added-stripe-account.change.md
new file mode 100644
index 00000000000..89b4c27ddd3
--- /dev/null
+++ b/.hark/changes/2015-03-19_unknown_added-stripe-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Added STRIPE-ACCOUNT header options in RequestOptions
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-03-19_unknown_added-support-account.change.md b/.hark/changes/2015-03-19_unknown_added-support-account.change.md
new file mode 100644
index 00000000000..a953ea36094
--- /dev/null
+++ b/.hark/changes/2015-03-19_unknown_added-support-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for account creation/updating/retrieval by ID
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-03-19_unknown_added-support-transfer.change.md b/.hark/changes/2015-03-19_unknown_added-support-transfer.change.md
new file mode 100644
index 00000000000..93cf2d55ae3
--- /dev/null
+++ b/.hark/changes/2015-03-19_unknown_added-support-transfer.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for transfer reversals
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-03-19_unknown_customer-objects-now.change.md b/.hark/changes/2015-03-19_unknown_customer-objects-now.change.md
new file mode 100644
index 00000000000..581866a41ea
--- /dev/null
+++ b/.hark/changes/2015-03-19_unknown_customer-objects-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Customer objects now support currency
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-03-30_unknown_charge-objects-now.change.md b/.hark/changes/2015-03-30_unknown_charge-objects-now.change.md
new file mode 100644
index 00000000000..ae3d956ffff
--- /dev/null
+++ b/.hark/changes/2015-03-30_unknown_charge-objects-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Charge objects now support status
+released_in_version: 1.27.1
+---
diff --git a/.hark/changes/2015-05-08_unknown_added-default-source.change.md b/.hark/changes/2015-05-08_unknown_added-default-source.change.md
new file mode 100644
index 00000000000..c16b078be1e
--- /dev/null
+++ b/.hark/changes/2015-05-08_unknown_added-default-source.change.md
@@ -0,0 +1,4 @@
+---
+title: Added default source when type is unknown
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-05-08_unknown_added-support-alipay.change.md b/.hark/changes/2015-05-08_unknown_added-support-alipay.change.md
new file mode 100644
index 00000000000..f7c2568905a
--- /dev/null
+++ b/.hark/changes/2015-05-08_unknown_added-support-alipay.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for Alipay accounts
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-05-08_unknown_added-support-dynamiclast4.change.md b/.hark/changes/2015-05-08_unknown_added-support-dynamiclast4.change.md
new file mode 100644
index 00000000000..5aca1fe65e8
--- /dev/null
+++ b/.hark/changes/2015-05-08_unknown_added-support-dynamiclast4.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support dynamicLast4 on Card for Apple Pay integrations
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-05-21_unknown_added-tax-percent.change.md b/.hark/changes/2015-05-21_unknown_added-tax-percent.change.md
new file mode 100644
index 00000000000..dd548fcf6ed
--- /dev/null
+++ b/.hark/changes/2015-05-21_unknown_added-tax-percent.change.md
@@ -0,0 +1,4 @@
+---
+title: Added tax percent field to subscriptions
+released_in_version: 1.29.0
+---
diff --git a/.hark/changes/2015-05-21_unknown_added-tax-tax.change.md b/.hark/changes/2015-05-21_unknown_added-tax-tax.change.md
new file mode 100644
index 00000000000..9dafcd720f9
--- /dev/null
+++ b/.hark/changes/2015-05-21_unknown_added-tax-tax.change.md
@@ -0,0 +1,4 @@
+---
+title: Added tax and tax percent fields to invoices
+released_in_version: 1.29.0
+---
diff --git a/.hark/changes/2015-05-28_unknown_add-declinecode-charge.change.md b/.hark/changes/2015-05-28_unknown_add-declinecode-charge.change.md
new file mode 100644
index 00000000000..3eb930557fb
--- /dev/null
+++ b/.hark/changes/2015-05-28_unknown_add-declinecode-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: Add decline_code, charge to CardException
+released_in_version: 1.30.0
+---
diff --git a/.hark/changes/2015-06-01_unknown_account-now-supports.change.md b/.hark/changes/2015-06-01_unknown_account-now-supports.change.md
new file mode 100644
index 00000000000..e748e371e11
--- /dev/null
+++ b/.hark/changes/2015-06-01_unknown_account-now-supports.change.md
@@ -0,0 +1,4 @@
+---
+title: "`Account` now supports `getExternalAccounts`, which allows both `BankAccount` and `Card` attachment."
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2015-06-01_unknown_bankaccounts-can-now.change.md b/.hark/changes/2015-06-01_unknown_bankaccounts-can-now.change.md
new file mode 100644
index 00000000000..c87a92e8c8b
--- /dev/null
+++ b/.hark/changes/2015-06-01_unknown_bankaccounts-can-now.change.md
@@ -0,0 +1,4 @@
+---
+title: "`BankAccount`s can now be deleted from `Customer`s (private beta feature) and `Account`s"
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2015-06-01_unknown_concretepaym-paymentsourc-interface.change.md b/.hark/changes/2015-06-01_unknown_concretepaym-paymentsourc-interface.change.md
new file mode 100644
index 00000000000..a6b497f0340
--- /dev/null
+++ b/.hark/changes/2015-06-01_unknown_concretepaym-paymentsourc-interface.change.md
@@ -0,0 +1,4 @@
+---
+title: "`ConcretePaymentSource` and the `PaymentSource` interface have been combined into one `ExternalAccount` class"
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2015-06-01_unknown_paymentsourc-renamed-externalacco.change.md b/.hark/changes/2015-06-01_unknown_paymentsourc-renamed-externalacco.change.md
new file mode 100644
index 00000000000..ce65a1f74a6
--- /dev/null
+++ b/.hark/changes/2015-06-01_unknown_paymentsourc-renamed-externalacco.change.md
@@ -0,0 +1,4 @@
+---
+title: "`PaymentSourceCollection` was renamed `ExternalAccountCollection`"
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2015-07-06_unknown_added-getrequestid-method.change.md b/.hark/changes/2015-07-06_unknown_added-getrequestid-method.change.md
new file mode 100644
index 00000000000..0f9e5a1079e
--- /dev/null
+++ b/.hark/changes/2015-07-06_unknown_added-getrequestid-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Added `getRequestId` method to `StripeException`.
+released_in_version: 1.32.0
+---
diff --git a/.hark/changes/2015-07-24_unknown_added-account-applicationf.change.md b/.hark/changes/2015-07-24_unknown_added-account-applicationf.change.md
new file mode 100644
index 00000000000..94c6ad896b8
--- /dev/null
+++ b/.hark/changes/2015-07-24_unknown_added-account-applicationf.change.md
@@ -0,0 +1,4 @@
+---
+title: Added `account` to `ApplicationFee`.
+released_in_version: 1.32.1
+---
diff --git a/.hark/changes/2015-08-03_unknown_added-delete-method.change.md b/.hark/changes/2015-08-03_unknown_added-delete-method.change.md
new file mode 100644
index 00000000000..f2559e1b1de
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_added-delete-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Added `delete` method to managed `Account`s
+released_in_version: 1.33.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_added-retrieve-all.change.md b/.hark/changes/2015-08-03_unknown_added-retrieve-all.change.md
new file mode 100644
index 00000000000..384ac3e3cc4
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_added-retrieve-all.change.md
@@ -0,0 +1,4 @@
+---
+title: Added `retrieve`, `all`, `update` and `close` methods to `Dispute`
+released_in_version: 1.33.0
+---
diff --git a/.hark/changes/2015-08-17_unknown_added-retrieve-all.change.md b/.hark/changes/2015-08-17_unknown_added-retrieve-all.change.md
new file mode 100644
index 00000000000..80a21cea939
--- /dev/null
+++ b/.hark/changes/2015-08-17_unknown_added-retrieve-all.change.md
@@ -0,0 +1,4 @@
+---
+title: Added `retrieve`, `all`, `update`, `create` methods to `Refund`
+released_in_version: 1.34.0
+---
diff --git a/.hark/changes/2015-08-31_unknown_add-bankaccount-token.change.md b/.hark/changes/2015-08-31_unknown_add-bankaccount-token.change.md
new file mode 100644
index 00000000000..186e1fdb05b
--- /dev/null
+++ b/.hark/changes/2015-08-31_unknown_add-bankaccount-token.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `bankAccount` to `Token`
+released_in_version: 1.35.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 00000000000..74136e29a33
--- /dev/null
+++ b/.hark/changes/2015-09-11_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new rate limiting responses.
+released_in_version: 1.36.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 00000000000..7b6ac1eef3c
--- /dev/null
+++ b/.hark/changes/2015-09-14_unknown_products-skus-orders.change.md
@@ -0,0 +1,4 @@
+---
+title: "Products, SKUs, and Orders -- https://stripe.com/relay"
+released_in_version: 1.37.0
+---
diff --git a/.hark/changes/2015-10-07_unknown_bugfix-settransfer-reversal.change.md b/.hark/changes/2015-10-07_unknown_bugfix-settransfer-reversal.change.md
new file mode 100644
index 00000000000..fcb0631a2e0
--- /dev/null
+++ b/.hark/changes/2015-10-07_unknown_bugfix-settransfer-reversal.change.md
@@ -0,0 +1,4 @@
+---
+title: Bugfix `setTransfer` on `Reversal`
+released_in_version: 1.37.1
+---
diff --git a/.hark/changes/2015-10-27_unknown_add-pagination-through.change.md b/.hark/changes/2015-10-27_unknown_add-pagination-through.change.md
new file mode 100644
index 00000000000..5aaa683a843
--- /dev/null
+++ b/.hark/changes/2015-10-27_unknown_add-pagination-through.change.md
@@ -0,0 +1,4 @@
+---
+title: Add pagination through the use of calling `AutoPagingIterable()` for a page
+released_in_version: 1.38.0
+---
diff --git a/.hark/changes/2015-10-27_unknown_fix-bug-where.change.md b/.hark/changes/2015-10-27_unknown_fix-bug-where.change.md
new file mode 100644
index 00000000000..b9b0530444a
--- /dev/null
+++ b/.hark/changes/2015-10-27_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where arrays were not being properly encoded when sent to the API
+released_in_version: 1.38.0
+---
diff --git a/.hark/changes/2015-10-27_unknown_fix-bug-where_2.change.md b/.hark/changes/2015-10-27_unknown_fix-bug-where_2.change.md
new file mode 100644
index 00000000000..d10d07f1f73
--- /dev/null
+++ b/.hark/changes/2015-10-27_unknown_fix-bug-where_2.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where setting a `List` to `null` wasn't encoding to an empty string (which is required to unset an array)
+released_in_version: 1.38.0
+---
diff --git a/.hark/changes/2015-11-30_unknown_fix-bug-using.change.md b/.hark/changes/2015-11-30_unknown_fix-bug-using.change.md
new file mode 100644
index 00000000000..a51eb43ab5d
--- /dev/null
+++ b/.hark/changes/2015-11-30_unknown_fix-bug-using.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug when using lazy-paging collection across multiple pages
+released_in_version: 1.38.1
+---
diff --git a/.hark/changes/2015-12-01_unknown_add-verification-routine.change.md b/.hark/changes/2015-12-01_unknown_add-verification-routine.change.md
new file mode 100644
index 00000000000..2652ee9c2f6
--- /dev/null
+++ b/.hark/changes/2015-12-01_unknown_add-verification-routine.change.md
@@ -0,0 +1,4 @@
+---
+title: Add a verification routine for external accounts
+released_in_version: 1.39.0
+---
diff --git a/.hark/changes/2015-12-03_unknown_add-missing-shippingdeta.change.md b/.hark/changes/2015-12-03_unknown_add-missing-shippingdeta.change.md
new file mode 100644
index 00000000000..43e98dee786
--- /dev/null
+++ b/.hark/changes/2015-12-03_unknown_add-missing-shippingdeta.change.md
@@ -0,0 +1,4 @@
+---
+title: Add missing `ShippingDetails` to `Customer` model
+released_in_version: 1.40.0
+---
diff --git a/.hark/changes/2016-01-07_unknown_fix-casting-newer.change.md b/.hark/changes/2016-01-07_unknown_fix-casting-newer.change.md
new file mode 100644
index 00000000000..5b045491485
--- /dev/null
+++ b/.hark/changes/2016-01-07_unknown_fix-casting-newer.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix casting of newer objects to *typed* models
+released_in_version: 1.40.1
+---
diff --git a/.hark/changes/2016-01-13_unknown_add-lots-missing.change.md b/.hark/changes/2016-01-13_unknown_add-lots-missing.change.md
new file mode 100644
index 00000000000..9ad1a248f4c
--- /dev/null
+++ b/.hark/changes/2016-01-13_unknown_add-lots-missing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add lots of missing fields to Account, Event, and Refund
+released_in_version: 1.41.0
+---
diff --git a/.hark/changes/2016-01-15_unknown_fix-serializatio-bug.change.md b/.hark/changes/2016-01-15_unknown_fix-serializatio-bug.change.md
new file mode 100644
index 00000000000..54c0093d8b6
--- /dev/null
+++ b/.hark/changes/2016-01-15_unknown_fix-serializatio-bug.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix serialization bug in `LegalEntity`'s `ssnLast4Provided`
+released_in_version: 1.41.1
+---
diff --git a/.hark/changes/2016-01-21_unknown_add-detailscode-legalentity.change.md b/.hark/changes/2016-01-21_unknown_add-detailscode-legalentity.change.md
new file mode 100644
index 00000000000..beb3a39a978
--- /dev/null
+++ b/.hark/changes/2016-01-21_unknown_add-detailscode-legalentity.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `details_code` to `LegalEntity`
+released_in_version: 1.42.0
+---
diff --git a/.hark/changes/2016-01-21_unknown_add-disabledreas-verification.change.md b/.hark/changes/2016-01-21_unknown_add-disabledreas-verification.change.md
new file mode 100644
index 00000000000..e08c76e972c
--- /dev/null
+++ b/.hark/changes/2016-01-21_unknown_add-disabledreas-verification.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `disabled_reason` to `Verification`
+released_in_version: 1.42.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 00000000000..b60874ceeab
--- /dev/null
+++ b/.hark/changes/2016-01-26_unknown_add-support-deleting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for deleting Relay SKUs and products
+released_in_version: 1.43.0
+---
diff --git a/.hark/changes/2016-02-11_unknown_add-businesstaxi-legalentity.change.md b/.hark/changes/2016-02-11_unknown_add-businesstaxi-legalentity.change.md
new file mode 100644
index 00000000000..cee8eea1fdc
--- /dev/null
+++ b/.hark/changes/2016-02-11_unknown_add-businesstaxi-legalentity.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `businessTaxIdProvided` to `LegalEntity`
+released_in_version: 1.44.0
+---
diff --git a/.hark/changes/2016-02-18_unknown_add-countryspec-model.change.md b/.hark/changes/2016-02-18_unknown_add-countryspec-model.change.md
new file mode 100644
index 00000000000..b3c2ebff9b0
--- /dev/null
+++ b/.hark/changes/2016-02-18_unknown_add-countryspec-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `CountrySpec` model for looking up country payment information
+released_in_version: 1.45.0
+---
diff --git a/.hark/changes/2016-03-15_unknown_add-reject-action.change.md b/.hark/changes/2016-03-15_unknown_add-reject-action.change.md
new file mode 100644
index 00000000000..3770cb668fe
--- /dev/null
+++ b/.hark/changes/2016-03-15_unknown_add-reject-action.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `reject` action on account
+released_in_version: 1.46.0
+---
diff --git a/.hark/changes/2016-03-15_unknown_expose-creating-bank.change.md b/.hark/changes/2016-03-15_unknown_expose-creating-bank.change.md
new file mode 100644
index 00000000000..6a3eb4dfd93
--- /dev/null
+++ b/.hark/changes/2016-03-15_unknown_expose-creating-bank.change.md
@@ -0,0 +1,4 @@
+---
+title: Expose creating bank accounts on customer
+released_in_version: 1.46.0
+---
diff --git a/.hark/changes/2016-03-21_unknown_allow-request-params.change.md b/.hark/changes/2016-03-21_unknown_allow-request-params.change.md
new file mode 100644
index 00000000000..2d53177b098
--- /dev/null
+++ b/.hark/changes/2016-03-21_unknown_allow-request-params.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow request params and options to be overridden for `autoPagingIterable`
+released_in_version: 1.47.0
+---
diff --git a/.hark/changes/2016-03-29_unknown_add-accessors-defaultcurre.change.md b/.hark/changes/2016-03-29_unknown_add-accessors-defaultcurre.change.md
new file mode 100644
index 00000000000..c766413d037
--- /dev/null
+++ b/.hark/changes/2016-03-29_unknown_add-accessors-defaultcurre.change.md
@@ -0,0 +1,4 @@
+---
+title: Add accessors for `default_currency` to `CountrySpec` model
+released_in_version: 1.48.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-getbusinessu-getbusinessu.change.md b/.hark/changes/2016-04-08_unknown_change-getbusinessu-getbusinessu.change.md
new file mode 100644
index 00000000000..151e15a01d6
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-getbusinessu-getbusinessu.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `getBusinessUrl` to `getBusinessURL` in `Account` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-getsupportur-getsupportur.change.md b/.hark/changes/2016-04-08_unknown_change-getsupportur-getsupportur.change.md
new file mode 100644
index 00000000000..2981c17ff44
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-getsupportur-getsupportur.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `getSupportUrl` to `getSupportURL` in `Account` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-geturl-geturl.change.md b/.hark/changes/2016-04-08_unknown_change-geturl-geturl.change.md
new file mode 100644
index 00000000000..cffdfc486f7
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-geturl-geturl.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `getUrl` to `getURL` in `Product` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-geturl-geturl_2.change.md b/.hark/changes/2016-04-08_unknown_change-geturl-geturl_2.change.md
new file mode 100644
index 00000000000..84ef03c9613
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-geturl-geturl_2.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `getUrl` to `getURL` in `StripeCollection` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-geturl-geturl_3.change.md b/.hark/changes/2016-04-08_unknown_change-geturl-geturl_3.change.md
new file mode 100644
index 00000000000..315c38f3005
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-geturl-geturl_3.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `getUrl` to `getURL` in `StripeCollectionInterface`
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-seturl-seturl.change.md b/.hark/changes/2016-04-08_unknown_change-seturl-seturl.change.md
new file mode 100644
index 00000000000..6d547701a28
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-seturl-seturl.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `setUrl` to `setURL` in `Product` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_change-seturl-seturl_2.change.md b/.hark/changes/2016-04-08_unknown_change-seturl-seturl_2.change.md
new file mode 100644
index 00000000000..a4f2f62c4ef
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_change-seturl-seturl_2.change.md
@@ -0,0 +1,4 @@
+---
+title: Change `setUrl` to `setURL` in `StripeCollection` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-08_unknown_remove-previously-deprecated.change.md b/.hark/changes/2016-04-08_unknown_remove-previously-deprecated.change.md
new file mode 100644
index 00000000000..1dcb386d8f9
--- /dev/null
+++ b/.hark/changes/2016-04-08_unknown_remove-previously-deprecated.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove previously-deprecated `getUrl` in `StripeCollectionAPIResource` model
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_add-outcome-charge.change.md b/.hark/changes/2016-04-12_unknown_add-outcome-charge.change.md
new file mode 100644
index 00000000000..76a013fba53
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_add-outcome-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Outcome` to the `Charge` model
+released_in_version: 2.2.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_deprecate-getaccount-setaccount.change.md b/.hark/changes/2016-04-12_unknown_deprecate-getaccount-setaccount.change.md
new file mode 100644
index 00000000000..85684880a0f
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_deprecate-getaccount-setaccount.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecate `getAccount` and `setAccount` on `Transfer`
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_deprecate-getcard-setcard.change.md b/.hark/changes/2016-04-12_unknown_deprecate-getcard-setcard.change.md
new file mode 100644
index 00000000000..f9825e7e12a
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_deprecate-getcard-setcard.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecate `getCard` and `setCard` on `Charge`
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_deprecate-getothertran-setothertran.change.md b/.hark/changes/2016-04-12_unknown_deprecate-getothertran-setothertran.change.md
new file mode 100644
index 00000000000..0c67ff55654
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_deprecate-getothertran-setothertran.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecate `getOtherTransfers` and `setOtherTransfers` on `Transfer`
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_deprecate-getsummary-setsummary.change.md b/.hark/changes/2016-04-12_unknown_deprecate-getsummary-setsummary.change.md
new file mode 100644
index 00000000000..ab23ac9aa39
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_deprecate-getsummary-setsummary.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecate `getSummary` and `setSummary` on `Transfer`
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2016-04-12_unknown_deprecate-getuser-setuser.change.md b/.hark/changes/2016-04-12_unknown_deprecate-getuser-setuser.change.md
new file mode 100644
index 00000000000..80516804364
--- /dev/null
+++ b/.hark/changes/2016-04-12_unknown_deprecate-getuser-setuser.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecate `getUser` and `setUser` on `ApplicationFee`
+released_in_version: 2.1.0
+---
diff --git a/.hark/changes/2016-04-18_unknown_add-source-types.change.md b/.hark/changes/2016-04-18_unknown_add-source-types.change.md
new file mode 100644
index 00000000000..956b1a35e53
--- /dev/null
+++ b/.hark/changes/2016-04-18_unknown_add-source-types.change.md
@@ -0,0 +1,4 @@
+---
+title: Add source types to `Money` model under the `Balance` model
+released_in_version: 2.3.0
+---
diff --git a/.hark/changes/2016-04-21_unknown_add-many-missing.change.md b/.hark/changes/2016-04-21_unknown_add-many-missing.change.md
new file mode 100644
index 00000000000..25c0a31da78
--- /dev/null
+++ b/.hark/changes/2016-04-21_unknown_add-many-missing.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add many missing fields to many models (see #285 for details)"
+released_in_version: 2.4.0
+---
diff --git a/.hark/changes/2016-05-04_unknown_add-retrieve-update.change.md b/.hark/changes/2016-05-04_unknown_add-retrieve-update.change.md
new file mode 100644
index 00000000000..7700a9e1094
--- /dev/null
+++ b/.hark/changes/2016-05-04_unknown_add-retrieve-update.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `retrieve`, `update`, `create`, `all`, and `delete` methods to the Subscription class
+released_in_version: 2.5.0
+---
diff --git a/.hark/changes/2016-05-23_unknown_give-all-collection.change.md b/.hark/changes/2016-05-23_unknown_give-all-collection.change.md
new file mode 100644
index 00000000000..8d0c76d4754
--- /dev/null
+++ b/.hark/changes/2016-05-23_unknown_give-all-collection.change.md
@@ -0,0 +1,4 @@
+---
+title: Give all collection classes access to auto-paginating helpers that work beyond first page
+released_in_version: 2.5.1
+---
diff --git a/.hark/changes/2016-05-25_unknown_add-support-returning.change.md b/.hark/changes/2016-05-25_unknown_add-support-returning.change.md
new file mode 100644
index 00000000000..882a2e9ab60
--- /dev/null
+++ b/.hark/changes/2016-05-25_unknown_add-support-returning.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for returning Relay orders
+released_in_version: 2.6.0
+---
diff --git a/.hark/changes/2016-06-13_unknown_fix-serializatio-businessurl.change.md b/.hark/changes/2016-06-13_unknown_fix-serializatio-businessurl.change.md
new file mode 100644
index 00000000000..9c1d7ed9a33
--- /dev/null
+++ b/.hark/changes/2016-06-13_unknown_fix-serializatio-businessurl.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix serialization of `businessURL` and `supportURL` in `Account` model
+released_in_version: 2.6.1
+---
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 00000000000..35520b56dd2
--- /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: 2.7.0
+---
diff --git a/.hark/changes/2016-08-05_unknown_add-source-model.change.md b/.hark/changes/2016-08-05_unknown_add-source-model.change.md
new file mode 100644
index 00000000000..23c4537e9f5
--- /dev/null
+++ b/.hark/changes/2016-08-05_unknown_add-source-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Source` model (prototype)
+released_in_version: 2.8.0
+---
diff --git a/.hark/changes/2016-09-07_unknown_add-description-iin.change.md b/.hark/changes/2016-09-07_unknown_add-description-iin.change.md
new file mode 100644
index 00000000000..d2086728325
--- /dev/null
+++ b/.hark/changes/2016-09-07_unknown_add-description-iin.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `description`, `iin`, and `issuer` attributes to `Card` model
+released_in_version: 2.9.0
+---
diff --git a/.hark/changes/2016-09-16_unknown_add-support-apple.change.md b/.hark/changes/2016-09-16_unknown_add-support-apple.change.md
new file mode 100644
index 00000000000..b1018ea3895
--- /dev/null
+++ b/.hark/changes/2016-09-16_unknown_add-support-apple.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for Apple Pay domains
+released_in_version: 2.10.0
+---
diff --git a/.hark/changes/2016-10-06_unknown_fix-bug-where.change.md b/.hark/changes/2016-10-06_unknown_fix-bug-where.change.md
new file mode 100644
index 00000000000..bc8b22a34fe
--- /dev/null
+++ b/.hark/changes/2016-10-06_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where the Transfer transactions method wasn't using requestCollection
+released_in_version: 2.10.1
+---
diff --git a/.hark/changes/2016-10-13_unknown_fix-nullpointere-sourcedeseri.change.md b/.hark/changes/2016-10-13_unknown_fix-nullpointere-sourcedeseri.change.md
new file mode 100644
index 00000000000..ba52900b03b
--- /dev/null
+++ b/.hark/changes/2016-10-13_unknown_fix-nullpointere-sourcedeseri.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix NullPointerException in SourceDeserializer for bitcoin receivers, and refactor tests.
+released_in_version: 2.10.2
+---
diff --git a/.hark/changes/2016-10-17_unknown_change-representati-money.change.md b/.hark/changes/2016-10-17_unknown_change-representati-money.change.md
new file mode 100644
index 00000000000..287a1a06e17
--- /dev/null
+++ b/.hark/changes/2016-10-17_unknown_change-representati-money.change.md
@@ -0,0 +1,4 @@
+---
+title: Change representations of money (e.g. "amounts" or "balances") from `Integer` to `Long`
+released_in_version: 3.0.0
+---
diff --git a/.hark/changes/2016-10-18_unknown_add-risklevel-attribute.change.md b/.hark/changes/2016-10-18_unknown_add-risklevel-attribute.change.md
new file mode 100644
index 00000000000..35140d14add
--- /dev/null
+++ b/.hark/changes/2016-10-18_unknown_add-risklevel-attribute.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `risk_level` attribute to `ChargeOutcome` model
+released_in_version: 3.2.0
+---
diff --git a/.hark/changes/2016-10-18_unknown_support-403-status.change.md b/.hark/changes/2016-10-18_unknown_support-403-status.change.md
new file mode 100644
index 00000000000..31dde2c19d6
--- /dev/null
+++ b/.hark/changes/2016-10-18_unknown_support-403-status.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for 403 status codes (permission denied)
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2016-11-22_unknown_add-retrieve-method.change.md b/.hark/changes/2016-11-22_unknown_add-retrieve-method.change.md
new file mode 100644
index 00000000000..563b95acb34
--- /dev/null
+++ b/.hark/changes/2016-11-22_unknown_add-retrieve-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Add retrieve method for 3-D Secure resources
+released_in_version: 3.3.0
+---
diff --git a/.hark/changes/2016-12-08_unknown_add-expandable-charge.change.md b/.hark/changes/2016-12-08_unknown_add-expandable-charge.change.md
new file mode 100644
index 00000000000..d663eab889c
--- /dev/null
+++ b/.hark/changes/2016-12-08_unknown_add-expandable-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: Add expandable Charge to Invoice
+released_in_version: 3.5.0
+---
diff --git a/.hark/changes/2017-01-03_unknown_add-non-public.change.md b/.hark/changes/2017-01-03_unknown_add-non-public.change.md
new file mode 100644
index 00000000000..60b00c8b301
--- /dev/null
+++ b/.hark/changes/2017-01-03_unknown_add-non-public.change.md
@@ -0,0 +1,4 @@
+---
+title: Add non-public `network_reason_code` to `Dispute` model
+released_in_version: 3.6.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_add-getobject-setobject.change.md b/.hark/changes/2017-01-06_unknown_add-getobject-setobject.change.md
new file mode 100644
index 00000000000..3de973f7f1d
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_add-getobject-setobject.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `getObject`/`setObject` to a number of models where it was missing
+released_in_version: 3.7.0
+---
diff --git a/.hark/changes/2017-01-06_unknown_add-tojson-method.change.md b/.hark/changes/2017-01-06_unknown_add-tojson-method.change.md
new file mode 100644
index 00000000000..5da5cc9c3ac
--- /dev/null
+++ b/.hark/changes/2017-01-06_unknown_add-tojson-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `toJson` method to `StripeObject`
+released_in_version: 3.7.0
+---
diff --git a/.hark/changes/2017-01-23_unknown_add-chargeoutcom-chargeoutcom.change.md b/.hark/changes/2017-01-23_unknown_add-chargeoutcom-chargeoutcom.change.md
new file mode 100644
index 00000000000..92df5949887
--- /dev/null
+++ b/.hark/changes/2017-01-23_unknown_add-chargeoutcom-chargeoutcom.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `ChargeOutcomeRule` to `ChargeOutcome`
+released_in_version: 3.8.0
+---
diff --git a/.hark/changes/2017-02-02_unknown_add-variant-account.change.md b/.hark/changes/2017-02-02_unknown_add-variant-account.change.md
new file mode 100644
index 00000000000..d3b873361fe
--- /dev/null
+++ b/.hark/changes/2017-02-02_unknown_add-variant-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Add variant of account `delete` that doesn't require parameters
+released_in_version: 3.9.0
+---
diff --git a/.hark/changes/2017-02-13_unknown_deprecated-sourced-transfers.change.md b/.hark/changes/2017-02-13_unknown_deprecated-sourced-transfers.change.md
new file mode 100644
index 00000000000..52b1d9c1cc5
--- /dev/null
+++ b/.hark/changes/2017-02-13_unknown_deprecated-sourced-transfers.change.md
@@ -0,0 +1,4 @@
+---
+title: Deprecated sourced transfers under balance transactions
+released_in_version: 3.10.0
+---
diff --git a/.hark/changes/2017-02-21_unknown_add-missing-api.change.md b/.hark/changes/2017-02-21_unknown_add-missing-api.change.md
new file mode 100644
index 00000000000..0a5fa3f124a
--- /dev/null
+++ b/.hark/changes/2017-02-21_unknown_add-missing-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Add missing API resources to object deserializer
+released_in_version: 3.10.2
+---
diff --git a/.hark/changes/2017-02-21_unknown_release-inadvertentl-empty.change.md b/.hark/changes/2017-02-21_unknown_release-inadvertentl-empty.change.md
new file mode 100644
index 00000000000..0378eb52a6a
--- /dev/null
+++ b/.hark/changes/2017-02-21_unknown_release-inadvertentl-empty.change.md
@@ -0,0 +1,4 @@
+---
+title: This release was inadvertently empty. See 3.10.2 for changes.
+released_in_version: 3.10.1
+---
diff --git a/.hark/changes/2017-02-22_unknown_add-new-parameters.change.md b/.hark/changes/2017-02-22_unknown_add-new-parameters.change.md
new file mode 100644
index 00000000000..2769b57ad90
--- /dev/null
+++ b/.hark/changes/2017-02-22_unknown_add-new-parameters.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new parameters for invoices and subscriptions
+released_in_version: 3.11.0
+---
diff --git a/.hark/changes/2017-03-13_unknown_add-missing-fields.change.md b/.hark/changes/2017-03-13_unknown_add-missing-fields.change.md
new file mode 100644
index 00000000000..b0a08ef5552
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_add-missing-fields.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add missing fields on order: `amountReturned`, `returns`, and `upstreamId`"
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2017-03-13_unknown_charge-order-becomes.change.md b/.hark/changes/2017-03-13_unknown_charge-order-becomes.change.md
new file mode 100644
index 00000000000..cbff39c98da
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_charge-order-becomes.change.md
@@ -0,0 +1,4 @@
+---
+title: Charge on order becomes expandable field (not expanded by default)
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2017-03-13_unknown_customer-order-becomes.change.md b/.hark/changes/2017-03-13_unknown_customer-order-becomes.change.md
new file mode 100644
index 00000000000..cfee9543ba0
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_customer-order-becomes.change.md
@@ -0,0 +1,4 @@
+---
+title: Customer on order becomes expandable field (not expanded by default)
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2017-03-13_unknown_dispute-charge-becomes.change.md b/.hark/changes/2017-03-13_unknown_dispute-charge-becomes.change.md
new file mode 100644
index 00000000000..dc02d1adf34
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_dispute-charge-becomes.change.md
@@ -0,0 +1,4 @@
+---
+title: Dispute on charge becomes expandable field (not expanded by default)
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2017-03-13_unknown_fix-type-orderreturnc.change.md b/.hark/changes/2017-03-13_unknown_fix-type-orderreturnc.change.md
new file mode 100644
index 00000000000..1cb3dece6f0
--- /dev/null
+++ b/.hark/changes/2017-03-13_unknown_fix-type-orderreturnc.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix type of `OrderReturnCollection` (now actually an order return)
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2017-04-04_unknown_make-rule-under.change.md b/.hark/changes/2017-04-04_unknown_make-rule-under.change.md
new file mode 100644
index 00000000000..363f334718c
--- /dev/null
+++ b/.hark/changes/2017-04-04_unknown_make-rule-under.change.md
@@ -0,0 +1,4 @@
+---
+title: Make `rule` under `ChargeOutcome` expandable
+released_in_version: 4.1.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 00000000000..d70dd448e72
--- /dev/null
+++ b/.hark/changes/2017-04-06_unknown_add-support-payouts.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add support for payouts; see: https://docs.stripe.com/changelog/2017-04-06"
+released_in_version: 4.2.0
+---
diff --git a/.hark/changes/2017-04-12_unknown_add-support-availablepay.change.md b/.hark/changes/2017-04-12_unknown_add-support-availablepay.change.md
new file mode 100644
index 00000000000..a94c2b5520b
--- /dev/null
+++ b/.hark/changes/2017-04-12_unknown_add-support-availablepay.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for `available_payout_methods` to `Card` model
+released_in_version: 4.3.0
+---
diff --git a/.hark/changes/2017-04-24_unknown_add-payout-properties.change.md b/.hark/changes/2017-04-24_unknown_add-payout-properties.change.md
new file mode 100644
index 00000000000..eed48662db6
--- /dev/null
+++ b/.hark/changes/2017-04-24_unknown_add-payout-properties.change.md
@@ -0,0 +1,4 @@
+---
+title: Add payout properties to `Account` model
+released_in_version: 4.4.0
+---
diff --git a/.hark/changes/2017-04-28_unknown_make-connect-read.change.md b/.hark/changes/2017-04-28_unknown_make-connect-read.change.md
new file mode 100644
index 00000000000..03bbbcdf314
--- /dev/null
+++ b/.hark/changes/2017-04-28_unknown_make-connect-read.change.md
@@ -0,0 +1,4 @@
+---
+title: Make connect and read timeouts configurable (see README for details)
+released_in_version: 4.5.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 00000000000..1284ad83686
--- /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: 4.6.0
+---
diff --git a/.hark/changes/2017-05-02_unknown_add-threedsecure-accessors.change.md b/.hark/changes/2017-05-02_unknown_add-threedsecure-accessors.change.md
new file mode 100644
index 00000000000..c895f0d25d4
--- /dev/null
+++ b/.hark/changes/2017-05-02_unknown_add-threedsecure-accessors.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `three_d_secure` accessors to `Card` model
+released_in_version: 4.7.0
+---
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 00000000000..4e4f093dec0
--- /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: 4.8.0
+---
diff --git a/.hark/changes/2017-05-25_unknown_release-should-5.change.md b/.hark/changes/2017-05-25_unknown_release-should-5.change.md
new file mode 100644
index 00000000000..3866be1fdda
--- /dev/null
+++ b/.hark/changes/2017-05-25_unknown_release-should-5.change.md
@@ -0,0 +1,4 @@
+---
+title: This release should have been 5.0.0, see notes for that
+released_in_version: 4.9.0
+---
diff --git a/.hark/changes/2017-05-30_unknown_release-should-5.change.md b/.hark/changes/2017-05-30_unknown_release-should-5.change.md
new file mode 100644
index 00000000000..265618282b8
--- /dev/null
+++ b/.hark/changes/2017-05-30_unknown_release-should-5.change.md
@@ -0,0 +1,4 @@
+---
+title: This release should have been 5.0.0, see notes for that
+released_in_version: 4.9.1
+---
diff --git a/.hark/changes/2017-05-31_unknown_clarify-tolerance-parameter.change.md b/.hark/changes/2017-05-31_unknown_clarify-tolerance-parameter.change.md
new file mode 100644
index 00000000000..b922388da7c
--- /dev/null
+++ b/.hark/changes/2017-05-31_unknown_clarify-tolerance-parameter.change.md
@@ -0,0 +1,4 @@
+---
+title: Clarify tolerance parameter for webhook signatures is in seconds
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2017-05-31_unknown_support-expanded-request.change.md b/.hark/changes/2017-05-31_unknown_support-expanded-request.change.md
new file mode 100644
index 00000000000..1274bc7ff14
--- /dev/null
+++ b/.hark/changes/2017-05-31_unknown_support-expanded-request.change.md
@@ -0,0 +1,4 @@
+---
+title: Support expanded request in `Event` model (now with idempotency key)
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2017-06-07_unknown_add-account-field.change.md b/.hark/changes/2017-06-07_unknown_add-account-field.change.md
new file mode 100644
index 00000000000..06280c697ee
--- /dev/null
+++ b/.hark/changes/2017-06-07_unknown_add-account-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `account` field to the event model
+released_in_version: 5.1.0
+---
diff --git a/.hark/changes/2017-06-09_unknown_support-expandable-sources.change.md b/.hark/changes/2017-06-09_unknown_support-expandable-sources.change.md
new file mode 100644
index 00000000000..2844c6edebe
--- /dev/null
+++ b/.hark/changes/2017-06-09_unknown_support-expandable-sources.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for expandable sources in balance transactions
+released_in_version: 5.2.0
+---
diff --git a/.hark/changes/2017-06-14_unknown_add-missing-expandable.change.md b/.hark/changes/2017-06-14_unknown_add-missing-expandable.change.md
new file mode 100644
index 00000000000..911c855b513
--- /dev/null
+++ b/.hark/changes/2017-06-14_unknown_add-missing-expandable.change.md
@@ -0,0 +1,4 @@
+---
+title: Add missing expandable fields on every model
+released_in_version: 5.3.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 00000000000..6647620db92
--- /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: 5.4.0
+---
diff --git a/.hark/changes/2017-06-23_unknown_add-support-alternate.change.md b/.hark/changes/2017-06-23_unknown_add-support-alternate.change.md
new file mode 100644
index 00000000000..5568d638028
--- /dev/null
+++ b/.hark/changes/2017-06-23_unknown_add-support-alternate.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for alternate statement descriptors on charge
+released_in_version: 5.5.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 00000000000..e7bc641f02c
--- /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 parameters"
+released_in_version: 5.6.0
+---
diff --git a/.hark/changes/2017-07-11_unknown_force-utf-8.change.md b/.hark/changes/2017-07-11_unknown_force-utf-8.change.md
new file mode 100644
index 00000000000..4f07af8d62e
--- /dev/null
+++ b/.hark/changes/2017-07-11_unknown_force-utf-8.change.md
@@ -0,0 +1,4 @@
+---
+title: Force UTF-8 encoding for webhook signature verification
+released_in_version: 5.7.1
+---
diff --git a/.hark/changes/2017-07-11_unknown_use-standard-library.change.md b/.hark/changes/2017-07-11_unknown_use-standard-library.change.md
new file mode 100644
index 00000000000..694b30f4081
--- /dev/null
+++ b/.hark/changes/2017-07-11_unknown_use-standard-library.change.md
@@ -0,0 +1,4 @@
+---
+title: Use standard library comparison for webhook signature verification
+released_in_version: 5.7.0
+---
diff --git a/.hark/changes/2017-08-31_unknown_add-support-all.change.md b/.hark/changes/2017-08-31_unknown_add-support-all.change.md
new file mode 100644
index 00000000000..3772e2d4fa8
--- /dev/null
+++ b/.hark/changes/2017-08-31_unknown_add-support-all.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for all OAuth actions
+released_in_version: 5.8.0
+---
diff --git a/.hark/changes/2017-09-25_unknown_support-java-9.change.md b/.hark/changes/2017-09-25_unknown_support-java-9.change.md
new file mode 100644
index 00000000000..6f0680f8eaa
--- /dev/null
+++ b/.hark/changes/2017-09-25_unknown_support-java-9.change.md
@@ -0,0 +1,4 @@
+---
+title: Support Java 9 (just involves upgrading a few Maven plugins)
+released_in_version: 5.9.0
+---
diff --git a/.hark/changes/2017-10-03_unknown_longer-clobber-global.change.md b/.hark/changes/2017-10-03_unknown_longer-clobber-global.change.md
new file mode 100644
index 00000000000..5d262163412
--- /dev/null
+++ b/.hark/changes/2017-10-03_unknown_longer-clobber-global.change.md
@@ -0,0 +1,4 @@
+---
+title: No longer clobber global value of DNS cache TTL if it has not been set
+released_in_version: 5.9.1
+---
diff --git a/.hark/changes/2017-10-04_unknown_add-failurereaso-field.change.md b/.hark/changes/2017-10-04_unknown_add-failurereaso-field.change.md
new file mode 100644
index 00000000000..0909b4d076a
--- /dev/null
+++ b/.hark/changes/2017-10-04_unknown_add-failurereaso-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `failure_reason` field to the source redirect flow model
+released_in_version: 5.10.0
+---
diff --git a/.hark/changes/2017-10-09_brandur_add-support-detaching.change.md b/.hark/changes/2017-10-09_brandur_add-support-detaching.change.md
new file mode 100644
index 00000000000..153f0cbebc8
--- /dev/null
+++ b/.hark/changes/2017-10-09_brandur_add-support-detaching.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for detaching sources from customers
+pr_url: https://github.com/stripe/stripe-java/pull/412
+released_in_version: 5.21.0
+---
diff --git a/.hark/changes/2017-10-09_brandur_rename-verification-code.change.md b/.hark/changes/2017-10-09_brandur_rename-verification-code.change.md
new file mode 100644
index 00000000000..82e5a4699ef
--- /dev/null
+++ b/.hark/changes/2017-10-09_brandur_rename-verification-code.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename "verification" to "code verification" for sources (should have been unused up to this point)
+pr_url: https://github.com/stripe/stripe-java/pull/410
+released_in_version: 5.21.0
+---
diff --git a/.hark/changes/2017-10-09_unknown_note-some-minor.change.md b/.hark/changes/2017-10-09_unknown_note-some-minor.change.md
new file mode 100644
index 00000000000..61a243ac66f
--- /dev/null
+++ b/.hark/changes/2017-10-09_unknown_note-some-minor.change.md
@@ -0,0 +1,4 @@
+---
+title: Note that some minor versions (5.11 through 5.20) were accidentally skipped for this release. I'm leaving as is to minimize churn, but please don't be alarmed!
+released_in_version: 5.21.0
+---
diff --git a/.hark/changes/2017-10-27_brandur_support-listing-source.change.md b/.hark/changes/2017-10-27_brandur_support-listing-source.change.md
new file mode 100644
index 00000000000..26849eb40cb
--- /dev/null
+++ b/.hark/changes/2017-10-27_brandur_support-listing-source.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for listing source transactions
+pr_url: https://github.com/stripe/stripe-java/pull/417
+released_in_version: 5.22.0
+---
diff --git a/.hark/changes/2017-10-27_mrmcduff_move-build-release.change.md b/.hark/changes/2017-10-27_mrmcduff_move-build-release.change.md
new file mode 100644
index 00000000000..41490bf3976
--- /dev/null
+++ b/.hark/changes/2017-10-27_mrmcduff_move-build-release.change.md
@@ -0,0 +1,5 @@
+---
+title: Move build and release system from Maven to Gradle
+pr_url: https://github.com/stripe/stripe-java/pull/418
+released_in_version: 5.22.1
+---
diff --git a/.hark/changes/2017-10-31_brandur_support-exchange-rate.change.md b/.hark/changes/2017-10-31_brandur_support-exchange-rate.change.md
new file mode 100644
index 00000000000..dc74e0bbe88
--- /dev/null
+++ b/.hark/changes/2017-10-31_brandur_support-exchange-rate.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for exchange rate APIs
+pr_url: https://github.com/stripe/stripe-java/pull/419
+released_in_version: 5.23.0
+---
diff --git a/.hark/changes/2017-11-09_brandur_fix-json-encoding.change.md b/.hark/changes/2017-11-09_brandur_fix-json-encoding.change.md
new file mode 100644
index 00000000000..064df3c7c55
--- /dev/null
+++ b/.hark/changes/2017-11-09_brandur_fix-json-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix JSON encoding for expandable fields by adding customer encoder
+pr_url: https://github.com/stripe/stripe-java/pull/423
+released_in_version: 5.23.1
+---
diff --git a/.hark/changes/2017-11-28_ob_add-automatic-property.change.md b/.hark/changes/2017-11-28_ob_add-automatic-property.change.md
new file mode 100644
index 00000000000..40a23e0f3a8
--- /dev/null
+++ b/.hark/changes/2017-11-28_ob_add-automatic-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `automatic` property on `Payout` model
+pr_url: https://github.com/stripe/stripe-java/pull/427
+released_in_version: 5.24.0
+---
diff --git a/.hark/changes/2017-11-28_ob_expose-response-objects.change.md b/.hark/changes/2017-11-28_ob_expose-response-objects.change.md
new file mode 100644
index 00000000000..23e652b4c7f
--- /dev/null
+++ b/.hark/changes/2017-11-28_ob_expose-response-objects.change.md
@@ -0,0 +1,5 @@
+---
+title: Expose response objects
+pr_url: https://github.com/stripe/stripe-java/pull/421
+released_in_version: 5.24.0
+---
diff --git a/.hark/changes/2017-12-06_brandur_make-charge-dispute.change.md b/.hark/changes/2017-12-06_brandur_make-charge-dispute.change.md
new file mode 100644
index 00000000000..b547f756d91
--- /dev/null
+++ b/.hark/changes/2017-12-06_brandur_make-charge-dispute.change.md
@@ -0,0 +1,5 @@
+---
+title: Make charge on `Dispute` expandable
+pr_url: https://github.com/stripe/stripe-java/pull/432
+released_in_version: 5.25.0
+---
diff --git a/.hark/changes/2017-12-18_brandur_add-proper-set.change.md b/.hark/changes/2017-12-18_brandur_add-proper-set.change.md
new file mode 100644
index 00000000000..1c882efd27e
--- /dev/null
+++ b/.hark/changes/2017-12-18_brandur_add-proper-set.change.md
@@ -0,0 +1,5 @@
+---
+title: Add the proper set of overloads for account reject method
+pr_url: https://github.com/stripe/stripe-java/pull/436
+released_in_version: 5.26.0
+---
diff --git a/.hark/changes/2017-12-18_brandur_fix-bug-where.change.md b/.hark/changes/2017-12-18_brandur_fix-bug-where.change.md
new file mode 100644
index 00000000000..c70a4f1704c
--- /dev/null
+++ b/.hark/changes/2017-12-18_brandur_fix-bug-where.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix bug where `options` were not being plumbed through in an account delete method
+pr_url: https://github.com/stripe/stripe-java/pull/436
+released_in_version: 5.26.0
+---
diff --git a/.hark/changes/2017-12-22_brandur_add-support-passing.change.md b/.hark/changes/2017-12-22_brandur_add-support-passing.change.md
new file mode 100644
index 00000000000..415c9c8abfb
--- /dev/null
+++ b/.hark/changes/2017-12-22_brandur_add-support-passing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for passing parameters to `SubscriptionItem.delete()`
+pr_url: https://github.com/stripe/stripe-java/pull/438
+released_in_version: 5.27.0
+---
diff --git a/.hark/changes/2018-01-02_brandur_upgrade-gson-dependency.change.md b/.hark/changes/2018-01-02_brandur_upgrade-gson-dependency.change.md
new file mode 100644
index 00000000000..8de23665c30
--- /dev/null
+++ b/.hark/changes/2018-01-02_brandur_upgrade-gson-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade GSON dependency to 2.8.2
+pr_url: https://github.com/stripe/stripe-java/pull/439
+released_in_version: 5.28.0
+---
diff --git a/.hark/changes/2018-02-08_pantera_update-plan-product.change.md b/.hark/changes/2018-02-08_pantera_update-plan-product.change.md
new file mode 100644
index 00000000000..c23f40ebabc
--- /dev/null
+++ b/.hark/changes/2018-02-08_pantera_update-plan-product.change.md
@@ -0,0 +1,5 @@
+---
+title: Update `Plan`, `Product` and `Subscription` models for latest API version
+pr_url: https://github.com/stripe/stripe-java/pull/447
+released_in_version: 5.29.0
+---
diff --git a/.hark/changes/2018-02-13_ob_add-stripe-setappinfo.change.md b/.hark/changes/2018-02-13_ob_add-stripe-setappinfo.change.md
new file mode 100644
index 00000000000..aa30160a831
--- /dev/null
+++ b/.hark/changes/2018-02-13_ob_add-stripe-setappinfo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `Stripe.setAppInfo()` for passing custom application information in headers
+pr_url: https://github.com/stripe/stripe-java/pull/449
+released_in_version: 5.30.0
+---
diff --git a/.hark/changes/2018-02-13_ob_add-support-deserializin.change.md b/.hark/changes/2018-02-13_ob_add-support-deserializin.change.md
new file mode 100644
index 00000000000..4b34e6d5cc1
--- /dev/null
+++ b/.hark/changes/2018-02-13_ob_add-support-deserializin.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for deserializing `source_mandate_notification` objects
+pr_url: https://github.com/stripe/stripe-java/pull/446
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2018-02-21_ob_add-support-topups.change.md b/.hark/changes/2018-02-21_ob_add-support-topups.change.md
new file mode 100644
index 00000000000..40403b11368
--- /dev/null
+++ b/.hark/changes/2018-02-21_ob_add-support-topups.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for topups
+pr_url: https://github.com/stripe/stripe-java/pull/453
+released_in_version: 5.32.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 00000000000..e4479912bd7
--- /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-java/pull/455
+released_in_version: 5.33.0
+---
diff --git a/.hark/changes/2018-02-27_ob_add-title-version.change.md b/.hark/changes/2018-02-27_ob_add-title-version.change.md
new file mode 100644
index 00000000000..4f3076fae42
--- /dev/null
+++ b/.hark/changes/2018-02-27_ob_add-title-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Add title, version and vendor in JAR manifest file
+pr_url: https://github.com/stripe/stripe-java/pull/457
+released_in_version: 5.33.1
+---
diff --git a/.hark/changes/2018-02-28_ob_remove-deprecation-markers.change.md b/.hark/changes/2018-02-28_ob_remove-deprecation-markers.change.md
new file mode 100644
index 00000000000..908a9df4a30
--- /dev/null
+++ b/.hark/changes/2018-02-28_ob_remove-deprecation-markers.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove deprecation markers from `sourceTransaction` accessors on `Transfer` model
+pr_url: https://github.com/stripe/stripe-java/pull/458
+released_in_version: 5.33.2
+---
diff --git a/.hark/changes/2018-03-21_ob_add-osgi-headers.change.md b/.hark/changes/2018-03-21_ob_add-osgi-headers.change.md
new file mode 100644
index 00000000000..f5aec944d3f
--- /dev/null
+++ b/.hark/changes/2018-03-21_ob_add-osgi-headers.change.md
@@ -0,0 +1,5 @@
+---
+title: Add OSGi headers to manifest file
+pr_url: https://github.com/stripe/stripe-java/pull/464
+released_in_version: 5.33.3
+---
diff --git a/.hark/changes/2018-03-22_ob_add-support-passing.change.md b/.hark/changes/2018-03-22_ob_add-support-passing.change.md
new file mode 100644
index 00000000000..ca8bc9b4037
--- /dev/null
+++ b/.hark/changes/2018-03-22_ob_add-support-passing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for passing parameters to `autoPagingIterable()`
+pr_url: https://github.com/stripe/stripe-java/pull/459
+released_in_version: 5.34.0
+---
diff --git a/.hark/changes/2018-03-22_ob_fix-serializatio-null.change.md b/.hark/changes/2018-03-22_ob_fix-serializatio-null.change.md
new file mode 100644
index 00000000000..66af5f078c2
--- /dev/null
+++ b/.hark/changes/2018-03-22_ob_fix-serializatio-null.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix serialization of null expandable attributes
+pr_url: https://github.com/stripe/stripe-java/pull/466
+released_in_version: 5.34.0
+---
diff --git a/.hark/changes/2018-03-23_ob_add-support-expanding.change.md b/.hark/changes/2018-03-23_ob_add-support-expanding.change.md
new file mode 100644
index 00000000000..d21148f1772
--- /dev/null
+++ b/.hark/changes/2018-03-23_ob_add-support-expanding.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for expanding `product` attribute on `Plan` model
+pr_url: https://github.com/stripe/stripe-java/pull/469
+released_in_version: 5.34.1
+---
diff --git a/.hark/changes/2018-04-04_alexander_add-support-flexible.change.md b/.hark/changes/2018-04-04_alexander_add-support-flexible.change.md
new file mode 100644
index 00000000000..cf6e19e254b
--- /dev/null
+++ b/.hark/changes/2018-04-04_alexander_add-support-flexible.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for flexible billing primitives
+pr_url: https://github.com/stripe/stripe-java/pull/462
+released_in_version: 5.35.0
+---
diff --git a/.hark/changes/2018-04-06_ob_fix-two-bugs.change.md b/.hark/changes/2018-04-06_ob_fix-two-bugs.change.md
new file mode 100644
index 00000000000..9ed843a73bb
--- /dev/null
+++ b/.hark/changes/2018-04-06_ob_fix-two-bugs.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix two bugs found by Error Prone
+pr_url: https://github.com/stripe/stripe-java/pull/498
+released_in_version: 5.35.1
+---
diff --git a/.hark/changes/2018-05-09_brandur_add-support-issuer.change.md b/.hark/changes/2018-05-09_brandur_add-support-issuer.change.md
new file mode 100644
index 00000000000..e2cb0d66993
--- /dev/null
+++ b/.hark/changes/2018-05-09_brandur_add-support-issuer.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for issuer fraud records
+pr_url: https://github.com/stripe/stripe-java/pull/505
+released_in_version: 5.36.0
+---
diff --git a/.hark/changes/2018-06-04_ob_library-now-uses.change.md b/.hark/changes/2018-06-04_ob_library-now-uses.change.md
new file mode 100644
index 00000000000..4329ef4b152
--- /dev/null
+++ b/.hark/changes/2018-06-04_ob_library-now-uses.change.md
@@ -0,0 +1,5 @@
+---
+title: The library now uses Project Lombok. All API resource classes now have `equals` and `hashCode` methods.
+pr_url: https://github.com/stripe/stripe-java/pull/302
+released_in_version: 5.37.0
+---
diff --git a/.hark/changes/2018-06-06_brandur_add-active-property.change.md b/.hark/changes/2018-06-06_brandur_add-active-property.change.md
new file mode 100644
index 00000000000..c03a35ebd72
--- /dev/null
+++ b/.hark/changes/2018-06-06_brandur_add-active-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `active` property to `Plan` model
+pr_url: https://github.com/stripe/stripe-java/pull/516
+released_in_version: 5.38.0
+---
diff --git a/.hark/changes/2018-06-06_ob_add-onbehalfof-property.change.md b/.hark/changes/2018-06-06_ob_add-onbehalfof-property.change.md
new file mode 100644
index 00000000000..5e174bc18bf
--- /dev/null
+++ b/.hark/changes/2018-06-06_ob_add-onbehalfof-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `on_behalf_of` property on `Charge` model
+pr_url: https://github.com/stripe/stripe-java/pull/513
+released_in_version: 5.37.0
+---
diff --git a/.hark/changes/2018-06-06_ob_fix-update-methods.change.md b/.hark/changes/2018-06-06_ob_fix-update-methods.change.md
new file mode 100644
index 00000000000..72bc7921d3a
--- /dev/null
+++ b/.hark/changes/2018-06-06_ob_fix-update-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `update()` methods for `FeeRefund` and `Reversal`
+pr_url: https://github.com/stripe/stripe-java/pull/512
+released_in_version: 5.37.0
+---
diff --git a/.hark/changes/2018-06-07_ob_add-hostedinvoic-invoicepdf.change.md b/.hark/changes/2018-06-07_ob_add-hostedinvoic-invoicepdf.change.md
new file mode 100644
index 00000000000..fd7efb23a9c
--- /dev/null
+++ b/.hark/changes/2018-06-07_ob_add-hostedinvoic-invoicepdf.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `hosted_invoice_url` and `invoice_pdf` properties to `Invoice` model
+pr_url: https://github.com/stripe/stripe-java/pull/515
+released_in_version: 5.39.0
+---
diff --git a/.hark/changes/2018-06-13_ob_add-documentback-property.change.md b/.hark/changes/2018-06-13_ob_add-documentback-property.change.md
new file mode 100644
index 00000000000..2f84f334407
--- /dev/null
+++ b/.hark/changes/2018-06-13_ob_add-documentback-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `documentBack` property to `LegalEntity` model
+pr_url: https://github.com/stripe/stripe-java/pull/521
+released_in_version: 5.40.0
+---
diff --git a/.hark/changes/2018-06-14_ob_add-amountpaid-amountremain.change.md b/.hark/changes/2018-06-14_ob_add-amountpaid-amountremain.change.md
new file mode 100644
index 00000000000..034abc11a92
--- /dev/null
+++ b/.hark/changes/2018-06-14_ob_add-amountpaid-amountremain.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `amountPaid`, `amountRemaining` and `billingReason` to `Invoice` model
+pr_url: https://github.com/stripe/stripe-java/pull/522
+released_in_version: 5.41.0
+---
diff --git a/.hark/changes/2018-06-16_ob_add-name-coupon.change.md b/.hark/changes/2018-06-16_ob_add-name-coupon.change.md
new file mode 100644
index 00000000000..671e9b2bbbc
--- /dev/null
+++ b/.hark/changes/2018-06-16_ob_add-name-coupon.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `name` to `Coupon` model
+pr_url: https://github.com/stripe/stripe-java/pull/528
+released_in_version: 5.41.1
+---
diff --git a/.hark/changes/2018-06-19_ob_annotate-lot-methods.change.md b/.hark/changes/2018-06-19_ob_annotate-lot-methods.change.md
new file mode 100644
index 00000000000..8d9abf40c02
--- /dev/null
+++ b/.hark/changes/2018-06-19_ob_annotate-lot-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Annotate a lot of methods as deprecated and flagged for removal in the next major release
+pr_url: https://github.com/stripe/stripe-java/pull/529
+released_in_version: 5.42.0
+---
diff --git a/.hark/changes/2018-06-20_ob_remove-deprecated-methods.change.md b/.hark/changes/2018-06-20_ob_remove-deprecated-methods.change.md
new file mode 100644
index 00000000000..21a597b6144
--- /dev/null
+++ b/.hark/changes/2018-06-20_ob_remove-deprecated-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove deprecated methods
+pr_url: https://github.com/stripe/stripe-java/pull/532
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-22_ob_change-signatures-throw.change.md b/.hark/changes/2018-06-22_ob_change-signatures-throw.change.md
new file mode 100644
index 00000000000..bd692a69344
--- /dev/null
+++ b/.hark/changes/2018-06-22_ob_change-signatures-throw.change.md
@@ -0,0 +1,5 @@
+---
+title: Change signatures to throw StripeException
+pr_url: https://github.com/stripe/stripe-java/pull/535
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-22_ob_only-capitalize-first.change.md b/.hark/changes/2018-06-22_ob_only-capitalize-first.change.md
new file mode 100644
index 00000000000..133fae55d83
--- /dev/null
+++ b/.hark/changes/2018-06-22_ob_only-capitalize-first.change.md
@@ -0,0 +1,5 @@
+---
+title: Only capitalize the first letter of acronyms per Google's style rules
+pr_url: https://github.com/stripe/stripe-java/pull/534
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-25_ob_add-level3-property.change.md b/.hark/changes/2018-06-25_ob_add-level3-property.change.md
new file mode 100644
index 00000000000..87dabff899b
--- /dev/null
+++ b/.hark/changes/2018-06-25_ob_add-level3-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `level3` property on `Charge` model
+pr_url: https://github.com/stripe/stripe-java/pull/537
+released_in_version: 5.43.0
+---
diff --git a/.hark/changes/2018-06-25_ob_change-all-integer.change.md b/.hark/changes/2018-06-25_ob_change-all-integer.change.md
new file mode 100644
index 00000000000..359b8bfe194
--- /dev/null
+++ b/.hark/changes/2018-06-25_ob_change-all-integer.change.md
@@ -0,0 +1,5 @@
+---
+title: Change all integer types to `Long` and all floating point types to `Double`
+pr_url: https://github.com/stripe/stripe-java/pull/538
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-27_ob_add-customerrefe-shippingfrom.change.md b/.hark/changes/2018-06-27_ob_add-customerrefe-shippingfrom.change.md
new file mode 100644
index 00000000000..ee99c0a3e4a
--- /dev/null
+++ b/.hark/changes/2018-06-27_ob_add-customerrefe-shippingfrom.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `customerReference` and `shippingFromZip` properties on `ChargeLevel3` model
+pr_url: https://github.com/stripe/stripe-java/pull/539
+released_in_version: 5.44.0
+---
diff --git a/.hark/changes/2018-06-27_ob_add-support-idempotency.change.md b/.hark/changes/2018-06-27_ob_add-support-idempotency.change.md
new file mode 100644
index 00000000000..0e1528c6f04
--- /dev/null
+++ b/.hark/changes/2018-06-27_ob_add-support-idempotency.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for idempotency errors
+pr_url: https://github.com/stripe/stripe-java/pull/540
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-27_ob_minor-fixes.change.md b/.hark/changes/2018-06-27_ob_minor-fixes.change.md
new file mode 100644
index 00000000000..cd2c36d6d5c
--- /dev/null
+++ b/.hark/changes/2018-06-27_ob_minor-fixes.change.md
@@ -0,0 +1,5 @@
+---
+title: Minor fixes
+pr_url: https://github.com/stripe/stripe-java/pull/541
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-06-28_spastorelli_fix-account-application.change.md b/.hark/changes/2018-06-28_spastorelli_fix-account-application.change.md
new file mode 100644
index 00000000000..857fd879a40
--- /dev/null
+++ b/.hark/changes/2018-06-28_spastorelli_fix-account-application.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `account.application.*` event data deserialization issue
+pr_url: https://github.com/stripe/stripe-java/pull/542
+released_in_version: 5.45.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 00000000000..8c914082a2c
--- /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-java/pull/543
+released_in_version: 5.46.0
+---
diff --git a/.hark/changes/2018-07-02_ob_add-setclientid-requestoptio.change.md b/.hark/changes/2018-07-02_ob_add-setclientid-requestoptio.change.md
new file mode 100644
index 00000000000..6308e9a4c22
--- /dev/null
+++ b/.hark/changes/2018-07-02_ob_add-setclientid-requestoptio.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `setClientId()` to `RequestOptionsBuilder`
+pr_url: https://github.com/stripe/stripe-java/pull/546
+released_in_version: 5.47.0
+---
diff --git a/.hark/changes/2018-07-03_ob_add-support-streams.change.md b/.hark/changes/2018-07-03_ob_add-support-streams.change.md
new file mode 100644
index 00000000000..8f651cb97e4
--- /dev/null
+++ b/.hark/changes/2018-07-03_ob_add-support-streams.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for streams when uploading files
+pr_url: https://github.com/stripe/stripe-java/pull/544
+released_in_version: 5.48.0
+---
diff --git a/.hark/changes/2018-07-06_ob_add-subscription-property.change.md b/.hark/changes/2018-07-06_ob_add-subscription-property.change.md
new file mode 100644
index 00000000000..021985c89f0
--- /dev/null
+++ b/.hark/changes/2018-07-06_ob_add-subscription-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `subscriptionItem` property to `InvoiceItem` and `InvoiceLineItem`
+pr_url: https://github.com/stripe/stripe-java/pull/548
+released_in_version: 5.49.0
+---
diff --git a/.hark/changes/2018-07-06_ob_move-nested-objects.change.md b/.hark/changes/2018-07-06_ob_move-nested-objects.change.md
new file mode 100644
index 00000000000..ea8a05c1637
--- /dev/null
+++ b/.hark/changes/2018-07-06_ob_move-nested-objects.change.md
@@ -0,0 +1,5 @@
+---
+title: Move nested objects into inner static classes
+pr_url: https://github.com/stripe/stripe-java/pull/547
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-07-12_brandur_rename-applicationf-applicationf.change.md b/.hark/changes/2018-07-12_brandur_rename-applicationf-applicationf.change.md
new file mode 100644
index 00000000000..04cf0ca74ed
--- /dev/null
+++ b/.hark/changes/2018-07-12_brandur_rename-applicationf-applicationf.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `ApplicationFee` to `ApplicationFeeAmount` on `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/552
+released_in_version: 5.50.0
+---
diff --git a/.hark/changes/2018-07-12_ob_add-autoadvance-property.change.md b/.hark/changes/2018-07-12_ob_add-autoadvance-property.change.md
new file mode 100644
index 00000000000..d044684bb9e
--- /dev/null
+++ b/.hark/changes/2018-07-12_ob_add-autoadvance-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `autoAdvance` property to `Invoice`
+pr_url: https://github.com/stripe/stripe-java/pull/551
+released_in_version: 5.51.0
+---
diff --git a/.hark/changes/2018-07-26_ob_add-riskscore-property.change.md b/.hark/changes/2018-07-26_ob_add-riskscore-property.change.md
new file mode 100644
index 00000000000..a5c3b893e08
--- /dev/null
+++ b/.hark/changes/2018-07-26_ob_add-riskscore-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `riskScore` property to `ChargeOutcome`
+pr_url: https://github.com/stripe/stripe-java/pull/556
+released_in_version: 5.52.0
+---
diff --git a/.hark/changes/2018-07-26_ob_add-support-stripeissuin.change.md b/.hark/changes/2018-07-26_ob_add-support-stripeissuin.change.md
new file mode 100644
index 00000000000..fb53204dac4
--- /dev/null
+++ b/.hark/changes/2018-07-26_ob_add-support-stripeissuin.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for StripeIssuing
+pr_url: https://github.com/stripe/stripe-java/pull/557
+released_in_version: 5.52.0
+---
diff --git a/.hark/changes/2018-07-27_ob_remove-deleted-models.change.md b/.hark/changes/2018-07-27_ob_remove-deleted-models.change.md
new file mode 100644
index 00000000000..5ae15e709f8
--- /dev/null
+++ b/.hark/changes/2018-07-27_ob_remove-deleted-models.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove `Deleted*` models and add `deleted` attribute instead
+pr_url: https://github.com/stripe/stripe-java/pull/553
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-07-28_ob_add-support-scheduled.change.md b/.hark/changes/2018-07-28_ob_add-support-scheduled.change.md
new file mode 100644
index 00000000000..16d5d54c9f7
--- /dev/null
+++ b/.hark/changes/2018-07-28_ob_add-support-scheduled.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for scheduled query runs (`com.stripe.model.sigma.ScheduledQueryRun`) for Sigma
+pr_url: https://github.com/stripe/stripe-java/pull/560
+released_in_version: 5.53.0
+---
diff --git a/.hark/changes/2018-07-28_ob_use-bigdecimal-floating.change.md b/.hark/changes/2018-07-28_ob_use-bigdecimal-floating.change.md
new file mode 100644
index 00000000000..0966980de57
--- /dev/null
+++ b/.hark/changes/2018-07-28_ob_use-bigdecimal-floating.change.md
@@ -0,0 +1,5 @@
+---
+title: Use `BigDecimal` for floating point values
+pr_url: https://github.com/stripe/stripe-java/pull/558
+released_in_version: 6.0.0
+---
diff --git a/.hark/changes/2018-07-30_ob_add-created-account.change.md b/.hark/changes/2018-07-30_ob_add-created-account.change.md
new file mode 100644
index 00000000000..60286263a45
--- /dev/null
+++ b/.hark/changes/2018-07-30_ob_add-created-account.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `created` to `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/561
+released_in_version: 6.1.0
+---
diff --git a/.hark/changes/2018-08-01_ob_add-object-attribute.change.md b/.hark/changes/2018-08-01_ob_add-object-attribute.change.md
new file mode 100644
index 00000000000..42bb4428c8b
--- /dev/null
+++ b/.hark/changes/2018-08-01_ob_add-object-attribute.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `object` attribute and accessors to `StripeCollection`
+pr_url: https://github.com/stripe/stripe-java/pull/566
+released_in_version: 6.2.0
+---
diff --git a/.hark/changes/2018-08-01_ob_add-retrieve-method.change.md b/.hark/changes/2018-08-01_ob_add-retrieve-method.change.md
new file mode 100644
index 00000000000..1daca4511a5
--- /dev/null
+++ b/.hark/changes/2018-08-01_ob_add-retrieve-method.change.md
@@ -0,0 +1,5 @@
+---
+title: Add a `retrieve()` method that accepts parameters (e.g. for expansion) to all resource classes
+pr_url: https://github.com/stripe/stripe-java/pull/565
+released_in_version: 6.2.0
+---
diff --git a/.hark/changes/2018-08-02_ob_use-delomboked-sources.change.md b/.hark/changes/2018-08-02_ob_use-delomboked-sources.change.md
new file mode 100644
index 00000000000..4cdd84d4c16
--- /dev/null
+++ b/.hark/changes/2018-08-02_ob_use-delomboked-sources.change.md
@@ -0,0 +1,5 @@
+---
+title: Use delomboked sources when creating sources JAR
+pr_url: https://github.com/stripe/stripe-java/pull/567
+released_in_version: 6.2.1
+---
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 00000000000..35bc6b399e3
--- /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-java/pull/568
+released_in_version: 6.3.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 00000000000..f6d2f538014
--- /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-java/pull/569
+released_in_version: 6.3.0
+---
diff --git a/.hark/changes/2018-08-15_brandur_serialize-all-arrays.change.md b/.hark/changes/2018-08-15_brandur_serialize-all-arrays.change.md
new file mode 100644
index 00000000000..e63dc4be344
--- /dev/null
+++ b/.hark/changes/2018-08-15_brandur_serialize-all-arrays.change.md
@@ -0,0 +1,5 @@
+---
+title: Serialize all arrays/lists with integer-indexed encoding
+pr_url: https://github.com/stripe/stripe-java/pull/572
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2018-08-16_brandur_add-unitlabel-product.change.md b/.hark/changes/2018-08-16_brandur_add-unitlabel-product.change.md
new file mode 100644
index 00000000000..87e8708fce1
--- /dev/null
+++ b/.hark/changes/2018-08-16_brandur_add-unitlabel-product.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `unitLabel` to `Product`
+pr_url: https://github.com/stripe/stripe-java/pull/574
+released_in_version: 6.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 00000000000..0631e3145ef
--- /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-java/pull/576
+released_in_version: 6.6.0
+---
diff --git a/.hark/changes/2018-08-27_tomer_remove-support-bitcoinrecei.change.md b/.hark/changes/2018-08-27_tomer_remove-support-bitcoinrecei.change.md
new file mode 100644
index 00000000000..cec1ba4ae5c
--- /dev/null
+++ b/.hark/changes/2018-08-27_tomer_remove-support-bitcoinrecei.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove support for `BitcoinReceiver` write-actions
+pr_url: https://github.com/stripe/stripe-java/pull/575
+released_in_version: 6.7.0
+---
diff --git a/.hark/changes/2018-08-28_ob_add-authorizatio-charge.change.md b/.hark/changes/2018-08-28_ob_add-authorizatio-charge.change.md
new file mode 100644
index 00000000000..5404444b732
--- /dev/null
+++ b/.hark/changes/2018-08-28_ob_add-authorizatio-charge.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `authorizationCode` to `Charge`
+pr_url: https://github.com/stripe/stripe-java/pull/579
+released_in_version: 6.8.0
+---
diff --git a/.hark/changes/2018-08-28_ob_update-customer-plan.change.md b/.hark/changes/2018-08-28_ob_update-customer-plan.change.md
new file mode 100644
index 00000000000..894685bfada
--- /dev/null
+++ b/.hark/changes/2018-08-28_ob_update-customer-plan.change.md
@@ -0,0 +1,5 @@
+---
+title: Update `Customer` and `Plan` models for API version [2018-08-23](https://docs.stripe.com/changelog/2018-08-23)
+pr_url: https://github.com/stripe/stripe-java/pull/577
+released_in_version: 6.8.0
+---
diff --git a/.hark/changes/2018-08-29_ob_add-missing-attributes.change.md b/.hark/changes/2018-08-29_ob_add-missing-attributes.change.md
new file mode 100644
index 00000000000..2fb0eccf422
--- /dev/null
+++ b/.hark/changes/2018-08-29_ob_add-missing-attributes.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing attributes to `Account` and `LegalEntity`
+pr_url: https://github.com/stripe/stripe-java/pull/580
+released_in_version: 6.9.0
+---
diff --git a/.hark/changes/2018-08-29_ob_add-topup-cancel.change.md b/.hark/changes/2018-08-29_ob_add-topup-cancel.change.md
new file mode 100644
index 00000000000..3050d056983
--- /dev/null
+++ b/.hark/changes/2018-08-29_ob_add-topup-cancel.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `Topup.cancel()` overload with no arguments
+pr_url: https://github.com/stripe/stripe-java/pull/581
+released_in_version: 6.9.0
+---
diff --git a/.hark/changes/2018-09-05_ob_add-exchangerate-balancetrans.change.md b/.hark/changes/2018-09-05_ob_add-exchangerate-balancetrans.change.md
new file mode 100644
index 00000000000..a139e8dd006
--- /dev/null
+++ b/.hark/changes/2018-09-05_ob_add-exchangerate-balancetrans.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `exchangeRate` to `BalanceTransaction`
+pr_url: https://github.com/stripe/stripe-java/pull/583
+released_in_version: 6.10.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 00000000000..9afdfd268bf
--- /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-java/pull/584
+released_in_version: 6.11.0
+---
diff --git a/.hark/changes/2018-09-06_ob_add-invoiceprefi-customer.change.md b/.hark/changes/2018-09-06_ob_add-invoiceprefi-customer.change.md
new file mode 100644
index 00000000000..371cf70d898
--- /dev/null
+++ b/.hark/changes/2018-09-06_ob_add-invoiceprefi-customer.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `invoicePrefix` to `Customer`
+pr_url: https://github.com/stripe/stripe-java/pull/586
+released_in_version: 6.12.0
+---
diff --git a/.hark/changes/2018-09-22_ob_compatibilit-latest-api.change.md b/.hark/changes/2018-09-22_ob_compatibilit-latest-api.change.md
new file mode 100644
index 00000000000..ab3986c6d9f
--- /dev/null
+++ b/.hark/changes/2018-09-22_ob_compatibilit-latest-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Compatibility with latest API version
+pr_url: https://github.com/stripe/stripe-java/pull/598
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2018-09-22_ob_replace-fileupload-class.change.md b/.hark/changes/2018-09-22_ob_replace-fileupload-class.change.md
new file mode 100644
index 00000000000..6fbef5bba84
--- /dev/null
+++ b/.hark/changes/2018-09-22_ob_replace-fileupload-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace `FileUpload` class with `File` class
+pr_url: https://github.com/stripe/stripe-java/pull/593
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2018-09-24_ob_support-terminal-endpoints.change.md b/.hark/changes/2018-09-24_ob_support-terminal-endpoints.change.md
new file mode 100644
index 00000000000..adb4a057dcc
--- /dev/null
+++ b/.hark/changes/2018-09-24_ob_support-terminal-endpoints.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for terminal endpoints
+pr_url: https://github.com/stripe/stripe-java/pull/592
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2018-10-10_ob_adds-support-partnerid.change.md b/.hark/changes/2018-10-10_ob_adds-support-partnerid.change.md
new file mode 100644
index 00000000000..4ecd872cb35
--- /dev/null
+++ b/.hark/changes/2018-10-10_ob_adds-support-partnerid.change.md
@@ -0,0 +1,5 @@
+---
+title: Adds support for `partnerId` in `setAppInfo()`
+pr_url: https://github.com/stripe/stripe-java/pull/602
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2018-10-31_remi_add-support-person.change.md b/.hark/changes/2018-10-31_remi_add-support-person.change.md
new file mode 100644
index 00000000000..0004d59da32
--- /dev/null
+++ b/.hark/changes/2018-10-31_remi_add-support-person.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Person` resource
+pr_url: https://github.com/stripe/stripe-java/pull/603
+released_in_version: 7.2.0
+---
diff --git a/.hark/changes/2018-10-31_remi_add-support-webhookendpo.change.md b/.hark/changes/2018-10-31_remi_add-support-webhookendpo.change.md
new file mode 100644
index 00000000000..f69b6eb1b2b
--- /dev/null
+++ b/.hark/changes/2018-10-31_remi_add-support-webhookendpo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `WebhookEndpoint` resource
+pr_url: https://github.com/stripe/stripe-java/pull/606
+released_in_version: 7.2.0
+---
diff --git a/.hark/changes/2018-11-07_remi_add-flatamount-plan.change.md b/.hark/changes/2018-11-07_remi_add-flatamount-plan.change.md
new file mode 100644
index 00000000000..fa12573c76f
--- /dev/null
+++ b/.hark/changes/2018-11-07_remi_add-flatamount-plan.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `flatAmount` to `Plan.Tier`
+pr_url: https://github.com/stripe/stripe-java/pull/610
+released_in_version: 7.3.0
+---
diff --git a/.hark/changes/2018-11-07_remi_add-supportaddre-account.change.md b/.hark/changes/2018-11-07_remi_add-supportaddre-account.change.md
new file mode 100644
index 00000000000..e895aa076b1
--- /dev/null
+++ b/.hark/changes/2018-11-07_remi_add-supportaddre-account.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `supportAddress` to `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/611
+released_in_version: 7.3.0
+---
diff --git a/.hark/changes/2018-11-07_remi_add-supportedtra-countryspec.change.md b/.hark/changes/2018-11-07_remi_add-supportedtra-countryspec.change.md
new file mode 100644
index 00000000000..47092f0405f
--- /dev/null
+++ b/.hark/changes/2018-11-07_remi_add-supportedtra-countryspec.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `supportedTransferCountries` to `CountrySpec`
+pr_url: https://github.com/stripe/stripe-java/pull/611
+released_in_version: 7.3.0
+---
diff --git a/.hark/changes/2018-11-08_remi_support-new-shape.change.md b/.hark/changes/2018-11-08_remi_support-new-shape.change.md
new file mode 100644
index 00000000000..a1e088fade4
--- /dev/null
+++ b/.hark/changes/2018-11-08_remi_support-new-shape.change.md
@@ -0,0 +1,5 @@
+---
+title: Support new shape of the `PaymentIntent` resource.
+pr_url: https://github.com/stripe/stripe-java/pull/609
+released_in_version: 7.4.0
+---
diff --git a/.hark/changes/2018-11-09_ob_throw-apiexception-malformed.change.md b/.hark/changes/2018-11-09_ob_throw-apiexception-malformed.change.md
new file mode 100644
index 00000000000..80a8f1a6d82
--- /dev/null
+++ b/.hark/changes/2018-11-09_ob_throw-apiexception-malformed.change.md
@@ -0,0 +1,7 @@
+---
+title: Throw `ApiException` on malformed JSON responses
+pr_url: https://github.com/stripe/stripe-java/pull/613
+released_in_version: 7.6.0
+---
+
+- Previously, the library would throw `com.google.gson.JsonSyntaxException` in this case. We've chosen to release this as a minor update because we assume that most users are already catching Stripe exceptions.
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 00000000000..58f25fa58b6
--- /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-java/pull/604
+released_in_version: 7.5.0
+---
diff --git a/.hark/changes/2018-11-14_remi_add-lastpaymente-paymentinten.change.md b/.hark/changes/2018-11-14_remi_add-lastpaymente-paymentinten.change.md
new file mode 100644
index 00000000000..8589cae68c6
--- /dev/null
+++ b/.hark/changes/2018-11-14_remi_add-lastpaymente-paymentinten.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `last_payment_error` to `PaymentIntent`.
+pr_url: https://github.com/stripe/stripe-java/pull/615
+released_in_version: 7.7.0
+---
diff --git a/.hark/changes/2018-11-19_remi_add-missing-properties.change.md b/.hark/changes/2018-11-19_remi_add-missing-properties.change.md
new file mode 100644
index 00000000000..63f4b3090bd
--- /dev/null
+++ b/.hark/changes/2018-11-19_remi_add-missing-properties.change.md
@@ -0,0 +1,9 @@
+---
+title: "Add missing properties to a few resources:"
+pr_url: https://github.com/stripe/stripe-java/pull/616
+released_in_version: 7.8.0
+---
+
+* Add `default_source` to `Invoice` and `Subscription`
+* Add `livemode` to Subscription
+* Add `metadata` and `subscription` to `SubscriptionItem`
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 00000000000..986b3fa6f81
--- /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-java/pull/614
+released_in_version: 7.9.0
+---
diff --git a/.hark/changes/2018-11-28_remi_add-missing-properties.change.md b/.hark/changes/2018-11-28_remi_add-missing-properties.change.md
new file mode 100644
index 00000000000..700e22059db
--- /dev/null
+++ b/.hark/changes/2018-11-28_remi_add-missing-properties.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing properties on the `Refund` resource.
+pr_url: https://github.com/stripe/stripe-java/pull/621
+released_in_version: 7.10.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 00000000000..092a934f2ab
--- /dev/null
+++ b/.hark/changes/2018-11-28_remi_add-support-review.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Review` APIs.
+pr_url: https://github.com/stripe/stripe-java/pull/623
+released_in_version: 7.10.0
+---
diff --git a/.hark/changes/2018-12-27_remi_add-support-actionable.change.md b/.hark/changes/2018-12-27_remi_add-support-actionable.change.md
new file mode 100644
index 00000000000..a721a265848
--- /dev/null
+++ b/.hark/changes/2018-12-27_remi_add-support-actionable.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `actionable` and `has_liability_shift` on `IssuerFraudRecord`
+pr_url: https://github.com/stripe/stripe-java/pull/629
+released_in_version: 7.11.0
+---
diff --git a/.hark/changes/2019-01-08_remi_add-support-walletprovid.change.md b/.hark/changes/2019-01-08_remi_add-support-walletprovid.change.md
new file mode 100644
index 00000000000..57225dc85b0
--- /dev/null
+++ b/.hark/changes/2019-01-08_remi_add-support-walletprovid.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `wallet_provider` on `Issuing.Authorization`.
+pr_url: https://github.com/stripe/stripe-java/pull/634
+released_in_version: 7.12.0
+---
diff --git a/.hark/changes/2019-01-09_remi_add-support-accountlink.change.md b/.hark/changes/2019-01-09_remi_add-support-accountlink.change.md
new file mode 100644
index 00000000000..95bf5a52a5d
--- /dev/null
+++ b/.hark/changes/2019-01-09_remi_add-support-accountlink.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `AccountLink` APIs.
+pr_url: https://github.com/stripe/stripe-java/pull/626
+released_in_version: 7.13.0
+---
diff --git a/.hark/changes/2019-01-11_remi_add-support-deserializin.change.md b/.hark/changes/2019-01-11_remi_add-support-deserializin.change.md
new file mode 100644
index 00000000000..957cda453a2
--- /dev/null
+++ b/.hark/changes/2019-01-11_remi_add-support-deserializin.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for deserializing `IssuerFraudRecord` in events.
+pr_url: https://github.com/stripe/stripe-java/pull/647
+released_in_version: 7.14.0
+---
diff --git a/.hark/changes/2019-01-11_remi_add-support-transferdata.change.md b/.hark/changes/2019-01-11_remi_add-support-transferdata.change.md
new file mode 100644
index 00000000000..95aacf658aa
--- /dev/null
+++ b/.hark/changes/2019-01-11_remi_add-support-transferdata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `transfer_data` and `application_fee_amount` on `Charge` and `transfer_data[destination] on `PaymentIntent`.
+pr_url: https://github.com/stripe/stripe-java/pull/632
+released_in_version: 7.14.0
+---
diff --git a/.hark/changes/2019-01-14_remi_add-support-expandable.change.md b/.hark/changes/2019-01-14_remi_add-support-expandable.change.md
new file mode 100644
index 00000000000..1dcc352d35f
--- /dev/null
+++ b/.hark/changes/2019-01-14_remi_add-support-expandable.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for expandable `transfer_data[destination]` on `Charge` and `PaymentIntent`.
+pr_url: https://github.com/stripe/stripe-java/pull/652
+released_in_version: 7.15.0
+---
diff --git a/.hark/changes/2019-01-17_remi_add-support-billing.change.md b/.hark/changes/2019-01-17_remi_add-support-billing.change.md
new file mode 100644
index 00000000000..540cf283b13
--- /dev/null
+++ b/.hark/changes/2019-01-17_remi_add-support-billing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for billing thresholds.
+pr_url: https://github.com/stripe/stripe-java/pull/655
+released_in_version: 7.16.0
+---
diff --git a/.hark/changes/2019-01-17_remi_add-support-customfields.change.md b/.hark/changes/2019-01-17_remi_add-support-customfields.change.md
new file mode 100644
index 00000000000..aa06e75ed27
--- /dev/null
+++ b/.hark/changes/2019-01-17_remi_add-support-customfields.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `custom_fields` and `footer` on `Invoice`.
+pr_url: https://github.com/stripe/stripe-java/pull/653
+released_in_version: 7.16.0
+---
diff --git a/.hark/changes/2019-01-18_remi_added-receipturl-property.change.md b/.hark/changes/2019-01-18_remi_added-receipturl-property.change.md
new file mode 100644
index 00000000000..2dae48a776c
--- /dev/null
+++ b/.hark/changes/2019-01-18_remi_added-receipturl-property.change.md
@@ -0,0 +1,5 @@
+---
+title: Added `receipt_url` property to `Charge`.
+pr_url: https://github.com/stripe/stripe-java/pull/656
+released_in_version: 7.17.0
+---
diff --git a/.hark/changes/2019-01-25_remi_add-support-destinationp.change.md b/.hark/changes/2019-01-25_remi_add-support-destinationp.change.md
new file mode 100644
index 00000000000..b43359bd16d
--- /dev/null
+++ b/.hark/changes/2019-01-25_remi_add-support-destinationp.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `destination_payment_refund` and `source_refund` on the `Reversal` resource.
+pr_url: https://github.com/stripe/stripe-java/pull/649
+released_in_version: 7.18.0
+---
diff --git a/.hark/changes/2019-02-04_ob_better-handling-namespaced.change.md b/.hark/changes/2019-02-04_ob_better-handling-namespaced.change.md
new file mode 100644
index 00000000000..f7ae2e316ec
--- /dev/null
+++ b/.hark/changes/2019-02-04_ob_better-handling-namespaced.change.md
@@ -0,0 +1,5 @@
+---
+title: Better handling of namespaced resources
+pr_url: https://github.com/stripe/stripe-java/pull/657
+released_in_version: 7.18.1
+---
diff --git a/.hark/changes/2019-02-04_ob_configure-gradle-signing.change.md b/.hark/changes/2019-02-04_ob_configure-gradle-signing.change.md
new file mode 100644
index 00000000000..e0113384e3c
--- /dev/null
+++ b/.hark/changes/2019-02-04_ob_configure-gradle-signing.change.md
@@ -0,0 +1,5 @@
+---
+title: Configure Gradle signing plugin to use gpg-agent
+pr_url: https://github.com/stripe/stripe-java/pull/665
+released_in_version: 7.18.1
+---
diff --git a/.hark/changes/2019-02-06_ob_add-configurable-telemetry.change.md b/.hark/changes/2019-02-06_ob_add-configurable-telemetry.change.md
new file mode 100644
index 00000000000..d7537c5d1f5
--- /dev/null
+++ b/.hark/changes/2019-02-06_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-java/pull/661
+released_in_version: 7.19.0
+---
diff --git a/.hark/changes/2019-02-12_remi_add-support-api.change.md b/.hark/changes/2019-02-12_remi_add-support-api.change.md
new file mode 100644
index 00000000000..15912903132
--- /dev/null
+++ b/.hark/changes/2019-02-12_remi_add-support-api.change.md
@@ -0,0 +1,8 @@
+---
+title: Add support for API version `2019-02-11` with changes to Payment Intents
+pr_url: https://github.com/stripe/stripe-java/pull/670
+released_in_version: 7.20.0
+---
+
+* `PaymentIntentSourceAction`, `PaymentIntentSourceActionValueAuthorizeWithUrl` and `next_source_action` are now depreacated. Use `PaymentIntent.NextAction`, `PaymentIntent.NextActionRedirectToUrl` and `next_action` instead.
+* `allowed_source_types` is now depreacated. Use `payment_method_types` instead.
diff --git a/.hark/changes/2019-02-12_remi_add-support-subscription.change.md b/.hark/changes/2019-02-12_remi_add-support-subscription.change.md
new file mode 100644
index 00000000000..0958d68ad82
--- /dev/null
+++ b/.hark/changes/2019-02-12_remi_add-support-subscription.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `SubscriptionSchedule` and `SubscriptionScheduleRevision`. Also add support for `invoice_settings` on `Customer`.
+pr_url: https://github.com/stripe/stripe-java/pull/673
+released_in_version: 7.20.0
+---
diff --git a/.hark/changes/2019-02-12_remi_add-support-transferdata.change.md b/.hark/changes/2019-02-12_remi_add-support-transferdata.change.md
new file mode 100644
index 00000000000..dd91a6532ec
--- /dev/null
+++ b/.hark/changes/2019-02-12_remi_add-support-transferdata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `transfer_data[amount]` on `Charge`.
+pr_url: https://github.com/stripe/stripe-java/pull/677
+released_in_version: 7.20.0
+---
diff --git a/.hark/changes/2019-02-12_remi_customer-property-now.change.md b/.hark/changes/2019-02-12_remi_customer-property-now.change.md
new file mode 100644
index 00000000000..ee3d49342be
--- /dev/null
+++ b/.hark/changes/2019-02-12_remi_customer-property-now.change.md
@@ -0,0 +1,5 @@
+---
+title: The `customer` property is now expandable on `Invoice`.
+pr_url: https://github.com/stripe/stripe-java/pull/675
+released_in_version: 7.20.0
+---
diff --git a/.hark/changes/2019-02-13_remi_add-support-transferdata.change.md b/.hark/changes/2019-02-13_remi_add-support-transferdata.change.md
new file mode 100644
index 00000000000..9ec0974108b
--- /dev/null
+++ b/.hark/changes/2019-02-13_remi_add-support-transferdata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `transfer_data[destination]` on `Invoice` and `Subscription`.
+pr_url: https://github.com/stripe/stripe-java/pull/648
+released_in_version: 7.21.0
+---
diff --git a/.hark/changes/2019-02-16_ob_add-stripeexcept-getstripeerr.change.md b/.hark/changes/2019-02-16_ob_add-stripeexcept-getstripeerr.change.md
new file mode 100644
index 00000000000..0809ecabfbd
--- /dev/null
+++ b/.hark/changes/2019-02-16_ob_add-stripeexcept-getstripeerr.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `StripeException.getStripeError()` and `OAuthException.getOauthError()` accessors
+pr_url: https://github.com/stripe/stripe-java/pull/678
+released_in_version: 7.22.0
+---
diff --git a/.hark/changes/2019-02-19_remi_add-support-api.change.md b/.hark/changes/2019-02-19_remi_add-support-api.change.md
new file mode 100644
index 00000000000..48e12e8b099
--- /dev/null
+++ b/.hark/changes/2019-02-19_remi_add-support-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for API version `2019-02-19` and related changes to `Account` and `Person`.
+pr_url: https://github.com/stripe/stripe-java/pull/660
+released_in_version: 7.23.0
+---
diff --git a/.hark/changes/2019-02-22_remi_add-support-statustransi.change.md b/.hark/changes/2019-02-22_remi_add-support-statustransi.change.md
new file mode 100644
index 00000000000..9e179df326b
--- /dev/null
+++ b/.hark/changes/2019-02-22_remi_add-support-statustransi.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `status_transitions` and marked `date` as deprecated on `Invoice`.
+pr_url: https://github.com/stripe/stripe-java/pull/681
+released_in_version: 7.24.0
+---
diff --git a/.hark/changes/2019-02-28_remi_add-apiversion-webhookendpo.change.md b/.hark/changes/2019-02-28_remi_add-apiversion-webhookendpo.change.md
new file mode 100644
index 00000000000..7613ff03400
--- /dev/null
+++ b/.hark/changes/2019-02-28_remi_add-apiversion-webhookendpo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `api_version` to the `WebhookEndpoint` resource.
+pr_url: https://github.com/stripe/stripe-java/pull/685
+released_in_version: 7.25.0
+---
diff --git a/.hark/changes/2019-02-28_remi_add-support-latestinvoic.change.md b/.hark/changes/2019-02-28_remi_add-support-latestinvoic.change.md
new file mode 100644
index 00000000000..0f86b5fa373
--- /dev/null
+++ b/.hark/changes/2019-02-28_remi_add-support-latestinvoic.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `latest_invoice` on `Subscription`.
+pr_url: https://github.com/stripe/stripe-java/pull/684
+released_in_version: 7.25.0
+---
diff --git a/.hark/changes/2019-03-07_remi_add-support-cancelat.change.md b/.hark/changes/2019-03-07_remi_add-support-cancelat.change.md
new file mode 100644
index 00000000000..f16f588610f
--- /dev/null
+++ b/.hark/changes/2019-03-07_remi_add-support-cancelat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `cancel_at` on `Subscription`.
+pr_url: https://github.com/stripe/stripe-java/pull/686
+released_in_version: 7.26.0
+---
diff --git a/.hark/changes/2019-03-14_remi_add-support-columns.change.md b/.hark/changes/2019-03-14_remi_add-support-columns.change.md
new file mode 100644
index 00000000000..a1d2d211307
--- /dev/null
+++ b/.hark/changes/2019-03-14_remi_add-support-columns.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `columns` on `ReportRun` and `default_columns` on `ReportType`.
+pr_url: https://github.com/stripe/stripe-java/pull/689
+released_in_version: 7.27.0
+---
diff --git a/.hark/changes/2019-03-19_mickjermsurawong_major-version-release.change.md b/.hark/changes/2019-03-19_mickjermsurawong_major-version-release.change.md
new file mode 100644
index 00000000000..5bb5941df75
--- /dev/null
+++ b/.hark/changes/2019-03-19_mickjermsurawong_major-version-release.change.md
@@ -0,0 +1,5 @@
+---
+title: Major version release. Supports a pinned API version [2019-03-14](https://docs.stripe.com/changelog/2019-03-14). Refer to our [migration guide for v8](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v8) for API upgrade guide and lists of backwards incompatible changes to watch out for.
+pr_url: https://github.com/stripe/stripe-java/pull/662
+released_in_version: 8.0.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 00000000000..c38ae5d2d68
--- /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-java/pull/691
+released_in_version: 7.28.0
+---
diff --git a/.hark/changes/2019-03-19_remi_add-support-paymentinten.change.md b/.hark/changes/2019-03-19_remi_add-support-paymentinten.change.md
new file mode 100644
index 00000000000..82467f926b7
--- /dev/null
+++ b/.hark/changes/2019-03-19_remi_add-support-paymentinten.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_intent` on `Charge`.
+pr_url: https://github.com/stripe/stripe-java/pull/695
+released_in_version: 7.29.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 00000000000..86b5e41b06d
--- /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-java/pull/688
+released_in_version: 7.28.0
+---
diff --git a/.hark/changes/2019-03-20_mickjermsurawong_fix-java-doc.change.md b/.hark/changes/2019-03-20_mickjermsurawong_fix-java-doc.change.md
new file mode 100644
index 00000000000..b87f2029f61
--- /dev/null
+++ b/.hark/changes/2019-03-20_mickjermsurawong_fix-java-doc.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix java doc on deprecated `EventData#getObject` and `Event#getDataObjectDeserializer`"
+pr_url: https://github.com/stripe/stripe-java/pull/701
+released_in_version: 8.0.1
+---
diff --git a/.hark/changes/2019-03-20_mickjermsurawong_fix-test-compiler.change.md b/.hark/changes/2019-03-20_mickjermsurawong_fix-test-compiler.change.md
new file mode 100644
index 00000000000..b2c56e28aee
--- /dev/null
+++ b/.hark/changes/2019-03-20_mickjermsurawong_fix-test-compiler.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix test compiler error by removing an accidental line
+pr_url: https://github.com/stripe/stripe-java/pull/704
+released_in_version: 8.0.2
+---
diff --git a/.hark/changes/2019-03-20_ob_dev-dependency-version.change.md b/.hark/changes/2019-03-20_ob_dev-dependency-version.change.md
new file mode 100644
index 00000000000..b81958ff715
--- /dev/null
+++ b/.hark/changes/2019-03-20_ob_dev-dependency-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Dev dependency version upgrades
+pr_url: https://github.com/stripe/stripe-java/pull/702
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-03-20_ob_dev-dependency-version_2.change.md b/.hark/changes/2019-03-20_ob_dev-dependency-version_2.change.md
new file mode 100644
index 00000000000..595e486ffaf
--- /dev/null
+++ b/.hark/changes/2019-03-20_ob_dev-dependency-version_2.change.md
@@ -0,0 +1,5 @@
+---
+title: Dev dependency version upgrades (Junit 5)
+pr_url: https://github.com/stripe/stripe-java/pull/706
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-03-20_ob_drop-support-java.change.md b/.hark/changes/2019-03-20_ob_drop-support-java.change.md
new file mode 100644
index 00000000000..2a1a5f02ad0
--- /dev/null
+++ b/.hark/changes/2019-03-20_ob_drop-support-java.change.md
@@ -0,0 +1,5 @@
+---
+title: Drop support for Java 1.7
+pr_url: https://github.com/stripe/stripe-java/pull/698
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-03-25_mickjermsurawong_add-support-paymentmetho.change.md b/.hark/changes/2019-03-25_mickjermsurawong_add-support-paymentmetho.change.md
new file mode 100644
index 00000000000..647b20fdb98
--- /dev/null
+++ b/.hark/changes/2019-03-25_mickjermsurawong_add-support-paymentmetho.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `PaymentMethod.BillingDetails` on `Charge`.
+pr_url: https://github.com/stripe/stripe-java/pull/710
+released_in_version: 8.1.0
+---
diff --git a/.hark/changes/2019-03-25_ob_fix-issues-reported.change.md b/.hark/changes/2019-03-25_ob_fix-issues-reported.change.md
new file mode 100644
index 00000000000..0f6a936881b
--- /dev/null
+++ b/.hark/changes/2019-03-25_ob_fix-issues-reported.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix issues reported by `ErrorProne` Nothing major or user visible.
+pr_url: https://github.com/stripe/stripe-java/pull/708
+released_in_version: 8.1.0
+---
diff --git a/.hark/changes/2019-04-08_mickjermsurawong_add-support-typed.change.md b/.hark/changes/2019-04-08_mickjermsurawong_add-support-typed.change.md
new file mode 100644
index 00000000000..e6e26b9d8f8
--- /dev/null
+++ b/.hark/changes/2019-04-08_mickjermsurawong_add-support-typed.change.md
@@ -0,0 +1,5 @@
+---
+title: "Add support for typed parameters, change deserialization of array in `Event#previousAttributes` from `Object[]` to `List<Object>`"
+pr_url: https://github.com/stripe/stripe-java/pull/705
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-08_mickjermsurawong_use-optional-unsafe.change.md b/.hark/changes/2019-04-08_mickjermsurawong_use-optional-unsafe.change.md
new file mode 100644
index 00000000000..bbd3e7118e3
--- /dev/null
+++ b/.hark/changes/2019-04-08_mickjermsurawong_use-optional-unsafe.change.md
@@ -0,0 +1,5 @@
+---
+title: Use `Optional` for unsafe event data object deserialization
+pr_url: https://github.com/stripe/stripe-java/pull/723
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-08_ob_use-errorprone-builds.change.md b/.hark/changes/2019-04-08_ob_use-errorprone-builds.change.md
new file mode 100644
index 00000000000..c0d64639e02
--- /dev/null
+++ b/.hark/changes/2019-04-08_ob_use-errorprone-builds.change.md
@@ -0,0 +1,5 @@
+---
+title: Use ErrorProne in builds
+pr_url: https://github.com/stripe/stripe-java/pull/713
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-09_mickjermsurawong_add-support-typed.change.md b/.hark/changes/2019-04-09_mickjermsurawong_add-support-typed.change.md
new file mode 100644
index 00000000000..67d9a20281a
--- /dev/null
+++ b/.hark/changes/2019-04-09_mickjermsurawong_add-support-typed.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for typed parameters for non-autogenerated classes (`EphemeralKey`, `Event` and `File`)
+pr_url: https://github.com/stripe/stripe-java/pull/730
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-09_mickjermsurawong_major-version-release.change.md b/.hark/changes/2019-04-09_mickjermsurawong_major-version-release.change.md
new file mode 100644
index 00000000000..8ebee9fceb7
--- /dev/null
+++ b/.hark/changes/2019-04-09_mickjermsurawong_major-version-release.change.md
@@ -0,0 +1,7 @@
+---
+title: Major version release. Refer to our [migration guide for v9](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v9) for a list of backward incompatible changes to watch out for.
+pr_url: https://github.com/stripe/stripe-java/pull/700
+released_in_version: 9.0.0
+---
+
+Pull requests included in this release:
diff --git a/.hark/changes/2019-04-09_ob_add-missing-javadoc.change.md b/.hark/changes/2019-04-09_ob_add-missing-javadoc.change.md
new file mode 100644
index 00000000000..6e6eccf6eac
--- /dev/null
+++ b/.hark/changes/2019-04-09_ob_add-missing-javadoc.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing Javadoc for non-autogenerated classes (`EphemeralKey`, `Event` and `File`)
+pr_url: https://github.com/stripe/stripe-java/pull/729
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-09_ob_dev-dependency-version.change.md b/.hark/changes/2019-04-09_ob_dev-dependency-version.change.md
new file mode 100644
index 00000000000..c322bdbe609
--- /dev/null
+++ b/.hark/changes/2019-04-09_ob_dev-dependency-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Dev dependency version upgrades
+pr_url: https://github.com/stripe/stripe-java/pull/728
+released_in_version: 9.0.0
+---
diff --git a/.hark/changes/2019-04-11_mickjermsurawong_fix-encoding-nested.change.md b/.hark/changes/2019-04-11_mickjermsurawong_fix-encoding-nested.change.md
new file mode 100644
index 00000000000..873d60a3a6b
--- /dev/null
+++ b/.hark/changes/2019-04-11_mickjermsurawong_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-java/pull/735
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2019-04-11_mickjermsurawong_upgrade-gradle-5.change.md b/.hark/changes/2019-04-11_mickjermsurawong_upgrade-gradle-5.change.md
new file mode 100644
index 00000000000..e1c4e8482c0
--- /dev/null
+++ b/.hark/changes/2019-04-11_mickjermsurawong_upgrade-gradle-5.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Gradle to 5.3.1
+pr_url: https://github.com/stripe/stripe-java/pull/734
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2019-04-12_mickjermsurawong_add-support-confirmation.change.md b/.hark/changes/2019-04-12_mickjermsurawong_add-support-confirmation.change.md
new file mode 100644
index 00000000000..c2d41e8aba1
--- /dev/null
+++ b/.hark/changes/2019-04-12_mickjermsurawong_add-support-confirmation.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `ConfirmationMethod` in `PaymentIntentCreateParams`, `AuthorizationControls` in cardholders mode/params
+pr_url: https://github.com/stripe/stripe-java/pull/739
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2019-04-12_mickjermsurawong_fix-issue-736.change.md b/.hark/changes/2019-04-12_mickjermsurawong_fix-issue-736.change.md
new file mode 100644
index 00000000000..c136b4226a7
--- /dev/null
+++ b/.hark/changes/2019-04-12_mickjermsurawong_fix-issue-736.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix issue #736 on un-encoded ID in url path"
+pr_url: https://github.com/stripe/stripe-java/pull/737
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2019-04-16_mickjermsurawong_update-generated-code.change.md b/.hark/changes/2019-04-16_mickjermsurawong_update-generated-code.change.md
new file mode 100644
index 00000000000..39212400c48
--- /dev/null
+++ b/.hark/changes/2019-04-16_mickjermsurawong_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/744
+released_in_version: 9.2.0
+---
+
+* Make `paymentIntent` on `Invoice` expandable instead of full-model
+* Add support for issuing `SpendingLimit` in `Card` and `CardHolder`
+* Add support for fields in `PaymentMethodDetails.Card.ThreeDSecure`
diff --git a/.hark/changes/2019-04-17_remi_add-support-checkout.change.md b/.hark/changes/2019-04-17_remi_add-support-checkout.change.md
new file mode 100644
index 00000000000..2961b8f667f
--- /dev/null
+++ b/.hark/changes/2019-04-17_remi_add-support-checkout.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Checkout `Session` resource and APIs
+pr_url: https://github.com/stripe/stripe-java/pull/745
+released_in_version: 9.3.0
+---
diff --git a/.hark/changes/2019-04-18_remi_update-generated-code.change.md b/.hark/changes/2019-04-18_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..9a2ec6fe2f3
--- /dev/null
+++ b/.hark/changes/2019-04-18_remi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/748
+is_stripe_api_change: true
+released_in_version: 9.4.0
+---
+
+* Add support for `address`, `name`, `phone` and `preferredLocales` on `Customer`
+* Add support for the `CreditNote` resource and APIs
+* Add support for account and customer related fields on the `Invoice` resource
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 00000000000..ef92899e0a8
--- /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-java/pull/750
+released_in_version: 9.5.0
+---
diff --git a/.hark/changes/2019-04-24_mickjermsurawong_add-support-cardissuing.change.md b/.hark/changes/2019-04-24_mickjermsurawong_add-support-cardissuing.change.md
new file mode 100644
index 00000000000..8070858adfe
--- /dev/null
+++ b/.hark/changes/2019-04-24_mickjermsurawong_add-support-cardissuing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CARD_ISSUING` enum in `RequestedCapability` for Account create/update params.
+pr_url: https://github.com/stripe/stripe-java/pull/755
+released_in_version: 9.6.0
+---
diff --git a/.hark/changes/2019-04-24_mickjermsurawong_fix-form-encoding.change.md b/.hark/changes/2019-04-24_mickjermsurawong_fix-form-encoding.change.md
new file mode 100644
index 00000000000..4da3ed607df
--- /dev/null
+++ b/.hark/changes/2019-04-24_mickjermsurawong_fix-form-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix form-encoding to support `Collection` in untyped params as array. Previously only `List` is form-encoded as array.
+pr_url: https://github.com/stripe/stripe-java/pull/756
+released_in_version: 9.6.0
+---
diff --git a/.hark/changes/2019-04-25_mickjermsurawong_add-support-taxrate.change.md b/.hark/changes/2019-04-25_mickjermsurawong_add-support-taxrate.change.md
new file mode 100644
index 00000000000..9854aacb174
--- /dev/null
+++ b/.hark/changes/2019-04-25_mickjermsurawong_add-support-taxrate.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `TaxRate` resource and APIs
+pr_url: https://github.com/stripe/stripe-java/pull/761
+released_in_version: 9.7.0
+---
diff --git a/.hark/changes/2019-04-30_remi_add-support-acss.change.md b/.hark/changes/2019-04-30_remi_add-support-acss.change.md
new file mode 100644
index 00000000000..44cebc5ceab
--- /dev/null
+++ b/.hark/changes/2019-04-30_remi_add-support-acss.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for ACSS debit Sources
+pr_url: https://github.com/stripe/stripe-java/pull/766
+released_in_version: 9.8.0
+---
diff --git a/.hark/changes/2019-05-04_remi_update-generated-code.change.md b/.hark/changes/2019-05-04_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..1b7de34817c
--- /dev/null
+++ b/.hark/changes/2019-05-04_remi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/768
+released_in_version: 9.9.0
+---
+
+* Add support for `customer` filter when listing `PaymentIntent`
+* Add support for `replacement_for` and `replacement_reason` on Issuing `card` creation
diff --git a/.hark/changes/2019-05-07_mickjermsurawong_update-generated-code.change.md b/.hark/changes/2019-05-07_mickjermsurawong_update-generated-code.change.md
new file mode 100644
index 00000000000..48b85212dd9
--- /dev/null
+++ b/.hark/changes/2019-05-07_mickjermsurawong_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/773
+is_stripe_api_change: true
+released_in_version: 9.10.0
+---
+
+* Add support for `extraParams` in all sub-classes of ApiRequestParams their nested classes
+* Add support for webhook event `payment_method.updated`
+* Add support for `payment_intent` filter when listing `Charge`
+* Add support for `legacy_payments` enum `RequestedCapability` in `AccountCreateParams` and `AccountUpdateParams`
diff --git a/.hark/changes/2019-05-11_mickjermsurawong_update-generated-code.change.md b/.hark/changes/2019-05-11_mickjermsurawong_update-generated-code.change.md
new file mode 100644
index 00000000000..d6f4b40c09d
--- /dev/null
+++ b/.hark/changes/2019-05-11_mickjermsurawong_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/776
+released_in_version: 9.11.0
+---
+
+* Add support for `startDate` in `Subscription`
+* Removed one unsupported enum on `PaymentIntentCancelParams`
diff --git a/.hark/changes/2019-05-15_mickjermsurawong_update-generated-code.change.md b/.hark/changes/2019-05-15_mickjermsurawong_update-generated-code.change.md
new file mode 100644
index 00000000000..1593995d4b5
--- /dev/null
+++ b/.hark/changes/2019-05-15_mickjermsurawong_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/777
+released_in_version: 9.12.0
+---
+
+* Add support for `Capability`
+* Add enum `off_session` for `PaymentIntentConfirmParams` and `PaymentIntentCreateParams`
+* Add enum `abandoned` for `PaymentIntentCancellationParams`.
+* Add support for `statementDescriptorKana` and `statementDescriptorKanji` in `Account.SettingsPayments`
diff --git a/.hark/changes/2019-05-23_ob_update-generated-code.change.md b/.hark/changes/2019-05-23_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..864d0d7c4f1
--- /dev/null
+++ b/.hark/changes/2019-05-23_ob_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/780
+released_in_version: 9.13.0
+---
+
+* Add support for new `radar.early_fraud_warning` resource and methods
+* Add new in_gst and no_vat tax ID types
+* Add `spending_limits_currency` attribute and parameter in Issuing resources
diff --git a/.hark/changes/2019-05-24_ob_pin-library-api.change.md b/.hark/changes/2019-05-24_ob_pin-library-api.change.md
new file mode 100644
index 00000000000..45ebd62d7e8
--- /dev/null
+++ b/.hark/changes/2019-05-24_ob_pin-library-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Pin library to API version `2019-05-16`
+pr_url: https://github.com/stripe/stripe-java/pull/781
+released_in_version: 10.0.0
+---
diff --git a/.hark/changes/2019-05-28_mickjermsurawong_fix-url-encoding.change.md b/.hark/changes/2019-05-28_mickjermsurawong_fix-url-encoding.change.md
new file mode 100644
index 00000000000..ea225311874
--- /dev/null
+++ b/.hark/changes/2019-05-28_mickjermsurawong_fix-url-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix url-encoding for string id to throw exception on passing null
+pr_url: https://github.com/stripe/stripe-java/pull/783
+released_in_version: 10.0.1
+---
diff --git a/.hark/changes/2019-05-30_brandur_make-headers-access.change.md b/.hark/changes/2019-05-30_brandur_make-headers-access.change.md
new file mode 100644
index 00000000000..84fcd840fc7
--- /dev/null
+++ b/.hark/changes/2019-05-30_brandur_make-headers-access.change.md
@@ -0,0 +1,5 @@
+---
+title: Make headers access case insensitive
+pr_url: https://github.com/stripe/stripe-java/pull/784
+released_in_version: 10.0.2
+---
diff --git a/.hark/changes/2019-06-19_ob_update-generated-code.change.md b/.hark/changes/2019-06-19_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..f07d0a13df1
--- /dev/null
+++ b/.hark/changes/2019-06-19_ob_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/789
+released_in_version: 10.1.0
+---
+
+* Add support for SEPA Credit Transfer sources
+* Add support for `CustomerBalanceTransaction` resource and APIs
+* Add `balance` property on `Customer`
+* Add `submitType` property on `checkout.Session`
+* Add `merchantAmount` and `merchantCurrency` properties on `issuing.Transaction`
+* Add `location` property on `terminal.ConnectionToken`
diff --git a/.hark/changes/2019-06-24_remi_update-generated-code.change.md b/.hark/changes/2019-06-24_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..eefa3dd6a1b
--- /dev/null
+++ b/.hark/changes/2019-06-24_remi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/794
+released_in_version: 10.2.0
+---
+
+* Add `collection_method` to `Invoice`, `Subscription` and `SubscriptionSchedule`
+* Add `unified_propration` to `InvoiceLineItem`
+* Support unsetting `dob` on an `Account`
+* Removed `native_url` from WeChat `Source`. While technically breaking, this field has never been used
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 00000000000..4974e8eea33
--- /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-java/pull/792
+released_in_version: 10.3.0
+---
diff --git a/.hark/changes/2019-07-01_remi_update-generated-code.change.md b/.hark/changes/2019-07-01_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..ee03a26cb69
--- /dev/null
+++ b/.hark/changes/2019-07-01_remi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/796
+released_in_version: 10.4.0
+---
+
+* Add support for the `SetupIntent` resource and APIs
+* Add support for `PlatformTaxFee` resource
+* Add `unified_proration` on `InvoiceItem` and `InvoiceLineItem`
+* Add `default_payment_method` and `default_source` to `SubscriptionSchedule`
diff --git a/.hark/changes/2019-07-09_remi_update-generated-code.change.md b/.hark/changes/2019-07-09_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..f460909f22b
--- /dev/null
+++ b/.hark/changes/2019-07-09_remi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/798
+is_stripe_api_change: true
+released_in_version: 10.5.0
+---
+
+* Add support for `transfer_data[amount]` on PaymentIntent
+* Add support for passing `setup_future_usage` on PaymentIntent Update and Confirm APIs
+* Add support for `confirm` and `return_url` on SetupIntent creation
+* Add support for `setup_future_usage` on Checkout Session creation
+* Add support for `subscription_start_date` on the Upcoming Invoice API
diff --git a/.hark/changes/2019-07-12_ob_add-getrawjsonob-accessor.change.md b/.hark/changes/2019-07-12_ob_add-getrawjsonob-accessor.change.md
new file mode 100644
index 00000000000..2d221cd349a
--- /dev/null
+++ b/.hark/changes/2019-07-12_ob_add-getrawjsonob-accessor.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `getRawJsonObject()` accessor
+pr_url: https://github.com/stripe/stripe-java/pull/799
+released_in_version: 10.6.0
+---
diff --git a/.hark/changes/2019-07-15_remi_update-generated-code.change.md b/.hark/changes/2019-07-15_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..e9e24303895
--- /dev/null
+++ b/.hark/changes/2019-07-15_remi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/801
+released_in_version: 10.8.0
+---
+
+* Add support for `pending_setup_intent` on Subscription
+* Add support for `off_session` on Subscription creation and update and Invoice pay
diff --git a/.hark/changes/2019-07-15_remi_update-generated-code_2.change.md b/.hark/changes/2019-07-15_remi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..3c16bab3650
--- /dev/null
+++ b/.hark/changes/2019-07-15_remi_update-generated-code_2.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/800
+released_in_version: 10.7.0
+---
+
+* Add support for Sources of type `klarna`
+* Add support for `payment_behavior` on Subscription and SubscriptionItem to control their behaviour on creation or update.
diff --git a/.hark/changes/2019-07-16_ob_add-support-unsetting.change.md b/.hark/changes/2019-07-16_ob_add-support-unsetting.change.md
new file mode 100644
index 00000000000..0019673a990
--- /dev/null
+++ b/.hark/changes/2019-07-16_ob_add-support-unsetting.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for unsetting metadata keys
+pr_url: https://github.com/stripe/stripe-java/pull/804
+released_in_version: 10.9.1
+---
diff --git a/.hark/changes/2019-07-16_ob_bump-dependencies.change.md b/.hark/changes/2019-07-16_ob_bump-dependencies.change.md
new file mode 100644
index 00000000000..aabdd9b2ddd
--- /dev/null
+++ b/.hark/changes/2019-07-16_ob_bump-dependencies.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump dependencies
+pr_url: https://github.com/stripe/stripe-java/pull/805
+released_in_version: 10.9.1
+---
diff --git a/.hark/changes/2019-07-16_remi_add-support-paymentmetho.change.md b/.hark/changes/2019-07-16_remi_add-support-paymentmetho.change.md
new file mode 100644
index 00000000000..ffa0833c343
--- /dev/null
+++ b/.hark/changes/2019-07-16_remi_add-support-paymentmetho.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_method_options` on `PaymentIntent` and `SetupIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/802
+released_in_version: 10.9.0
+---
diff --git a/.hark/changes/2019-07-17_remi_add-support-voidedat.change.md b/.hark/changes/2019-07-17_remi_add-support-voidedat.change.md
new file mode 100644
index 00000000000..4f11a25bdf4
--- /dev/null
+++ b/.hark/changes/2019-07-17_remi_add-support-voidedat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `voided_at` on `CreditNote`
+pr_url: https://github.com/stripe/stripe-java/pull/806
+released_in_version: 10.10.0
+---
diff --git a/.hark/changes/2019-07-22_remi_update-generated-code.change.md b/.hark/changes/2019-07-22_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..c3b29db8b34
--- /dev/null
+++ b/.hark/changes/2019-07-22_remi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/809
+released_in_version: 10.12.0
+---
+
+* Add support for `statement_descriptor` on `PaymentIntent` capture
+* Add support for unsetting `setup_future_usage` on `PaymentIntent`
diff --git a/.hark/changes/2019-07-30_ob_fix-potential-nullpointere.change.md b/.hark/changes/2019-07-30_ob_fix-potential-nullpointere.change.md
new file mode 100644
index 00000000000..fa04207ce2c
--- /dev/null
+++ b/.hark/changes/2019-07-30_ob_fix-potential-nullpointere.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix potential `NullPointerException` when calling `getRawJsonObject()`
+pr_url: https://github.com/stripe/stripe-java/pull/812
+released_in_version: 10.12.1
+---
diff --git a/.hark/changes/2019-08-07_ob_set-default-timeouts.change.md b/.hark/changes/2019-08-07_ob_set-default-timeouts.change.md
new file mode 100644
index 00000000000..b0dc68bee91
--- /dev/null
+++ b/.hark/changes/2019-08-07_ob_set-default-timeouts.change.md
@@ -0,0 +1,5 @@
+---
+title: Set default timeouts in `RequestOptionsBuilder`
+pr_url: https://github.com/stripe/stripe-java/pull/818
+released_in_version: 10.12.2
+---
diff --git a/.hark/changes/2019-08-08_remi_update-generated-code.change.md b/.hark/changes/2019-08-08_remi_update-generated-code.change.md
new file mode 100644
index 00000000000..d84ccf13af1
--- /dev/null
+++ b/.hark/changes/2019-08-08_remi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/819
+released_in_version: 10.13.0
+---
+
+* Add support for `payment_method_details[card][moto]` on `Charge`
+* Add support for `statement_descriptor_suffix` on `Charge` and `PaymentIntent`
+* Add support `subscription_data[application_fee_percent]` on Checkout `Session`
+* Rename `uk_credit_transfer` to `gbp_credit_transfer` on Source. This is technically a breaking change, but we've chosen to release this as a minor version as the previous name was virtually unused.
diff --git a/.hark/changes/2019-08-09_ob_update-generated-code.change.md b/.hark/changes/2019-08-09_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..e2ba1e7c3af
--- /dev/null
+++ b/.hark/changes/2019-08-09_ob_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/820
+released_in_version: 10.14.0
+---
+
+* Add support for unsetting `receipt_email` on `PaymentIntent`
+* Remove support for `SubscriptionScheduleRevision`. This is technicall a breaking change, but we've chosen to release this as a minor version as this resource and its APIs were virtually unused.
diff --git a/.hark/changes/2019-08-14_ob_move-api-version.change.md b/.hark/changes/2019-08-14_ob_move-api-version.change.md
new file mode 100644
index 00000000000..8295500725d
--- /dev/null
+++ b/.hark/changes/2019-08-14_ob_move-api-version.change.md
@@ -0,0 +1,8 @@
+---
+title: Move to API version [`2019-08-14`](https://docs.stripe.com/changelog/2019-08-14)
+pr_url: https://github.com/stripe/stripe-java/pull/825
+released_in_version: 11.0.0
+---
+
+* Rename `platform_payments` to `transfers` in `Account`
+* Introduce `executive` as a relationship on `Person`
diff --git a/.hark/changes/2019-08-14_ob_update-generated-code.change.md b/.hark/changes/2019-08-14_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..db0b48f1890
--- /dev/null
+++ b/.hark/changes/2019-08-14_ob_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/824
+is_stripe_api_change: true
+released_in_version: 10.15.0
+---
+
+* Add support for `au_becs_debit` sources
+* Add support for `mandate` parameter in source creation and update requests
+* Add support for `amount` in source update requests
+* Add support for `pin` attribute on `issuing.card` objects
+* Add support for `digital_goods_applications` category for Issuing
diff --git a/.hark/changes/2019-08-15_remi_add-support-executive.change.md b/.hark/changes/2019-08-15_remi_add-support-executive.change.md
new file mode 100644
index 00000000000..61c93560288
--- /dev/null
+++ b/.hark/changes/2019-08-15_remi_add-support-executive.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `executive` on `Person` create, update and list
+pr_url: https://github.com/stripe/stripe-java/pull/826
+released_in_version: 11.1.0
+---
diff --git a/.hark/changes/2019-08-21_richardm_update-generated-code.change.md b/.hark/changes/2019-08-21_richardm_update-generated-code.change.md
new file mode 100644
index 00000000000..8d52c3066cf
--- /dev/null
+++ b/.hark/changes/2019-08-21_richardm_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/828
+is_stripe_api_change: true
+released_in_version: 11.2.0
+---
+
+* Add support for `schedule` on `Subscription`
+* Add support for `defaultPaymentMethod`, `invoiceSettings`, `collectionMethod` and `billingThresholds` to `SubscriptionSchedule` and its update and create APIs
+* Add support for `mode` and `setupIntent` on Checkout `Session` and its create API
+* Add support for `schedule` and `subscriptionCancelAt` to the `Invoice` Upcoming API
+* Add support for new event types `subscription_schedule.*`
diff --git a/.hark/changes/2019-08-23_ob_update-generated-code.change.md b/.hark/changes/2019-08-23_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..4f6ed965ca1
--- /dev/null
+++ b/.hark/changes/2019-08-23_ob_update-generated-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/829
+released_in_version: 11.3.0
+---
+
+* Release support for decimal values on Billing resources such as `Plan` or `InvoiceItem`
diff --git a/.hark/changes/2019-08-28_remi_add-support-pendingverif.change.md b/.hark/changes/2019-08-28_remi_add-support-pendingverif.change.md
new file mode 100644
index 00000000000..483443e88f8
--- /dev/null
+++ b/.hark/changes/2019-08-28_remi_add-support-pendingverif.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `pendingVerification` on `Account`, `Person` and `Capability`
+pr_url: https://github.com/stripe/stripe-java/pull/830
+released_in_version: 11.4.0
+---
diff --git a/.hark/changes/2019-08-29_remi_add-support-endbehavior.change.md b/.hark/changes/2019-08-29_remi_add-support-endbehavior.change.md
new file mode 100644
index 00000000000..000ab6b2d7d
--- /dev/null
+++ b/.hark/changes/2019-08-29_remi_add-support-endbehavior.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `endBehavior` on `SubscriptionSchedule`
+pr_url: https://github.com/stripe/stripe-java/pull/833
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2019-08-30_ob_make-stripeerror-transient.change.md b/.hark/changes/2019-08-30_ob_make-stripeerror-transient.change.md
new file mode 100644
index 00000000000..a63ca679697
--- /dev/null
+++ b/.hark/changes/2019-08-30_ob_make-stripeerror-transient.change.md
@@ -0,0 +1,5 @@
+---
+title: Make `stripeError` transient on `StripeException`
+pr_url: https://github.com/stripe/stripe-java/pull/834
+released_in_version: 11.5.1
+---
diff --git a/.hark/changes/2019-09-03_ob_deprecate-totalcount.change.md b/.hark/changes/2019-09-03_ob_deprecate-totalcount.change.md
new file mode 100644
index 00000000000..a859495c26c
--- /dev/null
+++ b/.hark/changes/2019-09-03_ob_deprecate-totalcount.change.md
@@ -0,0 +1,5 @@
+---
+title: Deprecate `total_count`
+pr_url: https://github.com/stripe/stripe-java/pull/839
+released_in_version: 11.6.1
+---
diff --git a/.hark/changes/2019-09-03_remi_support-authenticati-issuing.change.md b/.hark/changes/2019-09-03_remi_support-authenticati-issuing.change.md
new file mode 100644
index 00000000000..cfe13a804b1
--- /dev/null
+++ b/.hark/changes/2019-09-03_remi_support-authenticati-issuing.change.md
@@ -0,0 +1,5 @@
+---
+title: Support `authentication` on Issuing `Authorization` and `url` on `MerchantData`
+pr_url: https://github.com/stripe/stripe-java/pull/838
+released_in_version: 11.6.0
+---
diff --git a/.hark/changes/2019-09-05_ob_update-generated-code.change.md b/.hark/changes/2019-09-05_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..9bcd30a6a89
--- /dev/null
+++ b/.hark/changes/2019-09-05_ob_update-generated-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/841
+released_in_version: 11.7.0
+---
+
+* Just a trivial comment update
diff --git a/.hark/changes/2019-09-05_richardm_switch-new-prettier.change.md b/.hark/changes/2019-09-05_richardm_switch-new-prettier.change.md
new file mode 100644
index 00000000000..f054999caad
--- /dev/null
+++ b/.hark/changes/2019-09-05_richardm_switch-new-prettier.change.md
@@ -0,0 +1,5 @@
+---
+title: Switch to new "prettier" codegen
+pr_url: https://github.com/stripe/stripe-java/pull/827
+released_in_version: 11.7.0
+---
diff --git a/.hark/changes/2019-09-09_ob_update-generated-code.change.md b/.hark/changes/2019-09-09_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..ca0fea2e946
--- /dev/null
+++ b/.hark/changes/2019-09-09_ob_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/842
+released_in_version: 11.8.0
+---
+
+* Add support for `company[verification]` on `Account`
+* Add support for `verification[additional_document]` on `Person`
diff --git a/.hark/changes/2019-09-10_ob_update-api-version.change.md b/.hark/changes/2019-09-10_ob_update-api-version.change.md
new file mode 100644
index 00000000000..4d035a97ca7
--- /dev/null
+++ b/.hark/changes/2019-09-10_ob_update-api-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Update to API version 2019-09-09
+pr_url: https://github.com/stripe/stripe-java/pull/844
+released_in_version: 12.0.0
+---
diff --git a/.hark/changes/2019-09-27_richardm_add-add-addall.change.md b/.hark/changes/2019-09-27_richardm_add-add-addall.change.md
new file mode 100644
index 00000000000..129f43ccfa6
--- /dev/null
+++ b/.hark/changes/2019-09-27_richardm_add-add-addall.change.md
@@ -0,0 +1,13 @@
+---
+title: Add add/addAll support for "emptyable" params
+pr_url: https://github.com/stripe/stripe-java/pull/849
+released_in_version: 12.1.0
+---
+
+* Add `addAttribute` and `addAllAttribute` methods to `ProductUpdateParams`
+* Add `addCustomField` and `addAllCustomField` methods to `CustomerCreateParams`, `CustomerUpdateParams`, `InvoiceCreateParams` and `InvoiceUpdateParams`
+* Add `addDefaultTaxRate` and `addAllDefaultTaxRate` methods to `InvoiceUpdateParams`, `SubscriptionCreateParams`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleUpdateParams` and `SubscriptionUpdateParams`
+* Add `addImage` and `addAllImage` methods to `ProductUpdateParams`
+* Add `addItem` and `addAllItem` methods to `OrderReturnOrderParams`
+* Add `addSubscriptionDefaultTaxRate` and `addAllSubscriptionDefaultTaxRate` methods to `InvoiceUpcomingParams`
+* Add `addTaxRate` and `addAllTaxRate` methods to `InvoiceItemUpdateParams`, `InvoiceUpcomingParams`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleUpdateParams` and `SubscriptionUpdateParams`
diff --git a/.hark/changes/2019-09-27_richardm_codegen-openapi-4d4a107.change.md b/.hark/changes/2019-09-27_richardm_codegen-openapi-4d4a107.change.md
new file mode 100644
index 00000000000..f4c3adba678
--- /dev/null
+++ b/.hark/changes/2019-09-27_richardm_codegen-openapi-4d4a107.change.md
@@ -0,0 +1,13 @@
+---
+title: Codegen for openapi 4d4a107
+pr_url: https://github.com/stripe/stripe-java/pull/850
+released_in_version: 12.1.0
+---
+
+* Add support for `mandate` on `Charge`.
+* Add support for `reference` on `SourceTransaction`.
+* Add support for `person` on `TokenCreateParams`.
+* Add support for new event types `payment_intent.canceled` and `setup_intent.canceled`
+* Add support for `metadata` on `AuthorizationApproveParams` and `AuthorizationDeclineParams`
+* Add `setMetadata` method on `AuthorizationUpdateParams`
+* Rename `chidrens_and_infants_wear_stores` to `childrens_and_infants_wear_stores`. This is technically a breaking change, but we've chosen to release this as a minor version as the previous name was virtually unused.
diff --git a/.hark/changes/2019-10-07_ob_update-readme-md.change.md b/.hark/changes/2019-10-07_ob_update-readme-md.change.md
new file mode 100644
index 00000000000..19453edd7a7
--- /dev/null
+++ b/.hark/changes/2019-10-07_ob_update-readme-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update `README.md`
+pr_url: https://github.com/stripe/stripe-java/pull/851
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2019-10-08_ob_bump-dependencies.change.md b/.hark/changes/2019-10-08_ob_bump-dependencies.change.md
new file mode 100644
index 00000000000..13adb07300d
--- /dev/null
+++ b/.hark/changes/2019-10-08_ob_bump-dependencies.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump dependencies
+pr_url: https://github.com/stripe/stripe-java/pull/835
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2019-10-08_ob_setters-string-properties.change.md b/.hark/changes/2019-10-08_ob_setters-string-properties.change.md
new file mode 100644
index 00000000000..2180714ed2b
--- /dev/null
+++ b/.hark/changes/2019-10-08_ob_setters-string-properties.change.md
@@ -0,0 +1,5 @@
+---
+title: Setters for string properties in update params now all accept `EmptyParam`
+pr_url: https://github.com/stripe/stripe-java/pull/852
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2019-10-09_ob_upgrade-new-api.change.md b/.hark/changes/2019-10-09_ob_upgrade-new-api.change.md
new file mode 100644
index 00000000000..25dfdaae8ef
--- /dev/null
+++ b/.hark/changes/2019-10-09_ob_upgrade-new-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade to new API version [`2019-10-08`](https://docs.stripe.com/changelog/2019-10-08)
+pr_url: https://github.com/stripe/stripe-java/pull/853
+released_in_version: 13.0.0
+---
diff --git a/.hark/changes/2019-10-10_ob_update-generated-code.change.md b/.hark/changes/2019-10-10_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..f033c1e52d4
--- /dev/null
+++ b/.hark/changes/2019-10-10_ob_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/854
+released_in_version: 13.1.0
+---
+
+* Add support for `description`, `iin` and `issuer` on `Source.Card`, `Source.CardPresent` and `Source.ThreeDSecure`
+* Add support for `deviceType` on `ReaderListParams`
diff --git a/.hark/changes/2019-10-16_ob_add-getters-parameters.change.md b/.hark/changes/2019-10-16_ob_add-getters-parameters.change.md
new file mode 100644
index 00000000000..30b3b9dc389
--- /dev/null
+++ b/.hark/changes/2019-10-16_ob_add-getters-parameters.change.md
@@ -0,0 +1,5 @@
+---
+title: Add getters to parameters classes
+pr_url: https://github.com/stripe/stripe-java/pull/861
+released_in_version: 13.2.0
+---
diff --git a/.hark/changes/2019-10-16_ob_stop-propagating-unsupportede.change.md b/.hark/changes/2019-10-16_ob_stop-propagating-unsupportede.change.md
new file mode 100644
index 00000000000..a6f0e47095b
--- /dev/null
+++ b/.hark/changes/2019-10-16_ob_stop-propagating-unsupportede.change.md
@@ -0,0 +1,5 @@
+---
+title: Stop propagating UnsupportedEncodingException
+pr_url: https://github.com/stripe/stripe-java/pull/858
+released_in_version: 13.3.0
+---
diff --git a/.hark/changes/2019-10-17_remi_codegen-update-api.change.md b/.hark/changes/2019-10-17_remi_codegen-update-api.change.md
new file mode 100644
index 00000000000..8792293ea73
--- /dev/null
+++ b/.hark/changes/2019-10-17_remi_codegen-update-api.change.md
@@ -0,0 +1,12 @@
+---
+title: "[codegen] Update API Resources"
+pr_url: https://github.com/stripe/stripe-java/pull/862
+released_in_version: 13.3.0
+---
+
+* `requirements` on Issuing `Cardholder`
+* `payment_method_details[au_becs_debit][mandate]` on `Charge`
+* new types of tax id for Customer `TaxId`.
+* `payment_behavior` on `Subscription` creation can now take the value `pending_if_incomplete`.
+* `payment_behavior` on `SubscriptionItem` creation and update is now supported.
+* `subscription_data[trial_from_plan]` is now supported on Checkout `Session` creation.
diff --git a/.hark/changes/2019-10-18_ob_upgrade-new-api.change.md b/.hark/changes/2019-10-18_ob_upgrade-new-api.change.md
new file mode 100644
index 00000000000..f6c0a5e57dc
--- /dev/null
+++ b/.hark/changes/2019-10-18_ob_upgrade-new-api.change.md
@@ -0,0 +1,12 @@
+---
+title: Upgrade to new API version [`2019-10-17`](https://docs.stripe.com/changelog/2019-10-17)
+pr_url: https://github.com/stripe/stripe-java/pull/863
+released_in_version: 14.0.0
+---
+
+* Pin to API version `2019-10-17`
+* Remove `account_balance` from Customer model and parameter classes
+* Remove `billing` from Invoice, Subscription and Subscription Schedule model and parameter classes
+* Remove `start` from Subscription model
+* Remove `renewal_behavior` from Subscription Schedule parameter classes
+* **Note:** This release was missing some breaking changes. Please use 14.0.1 instead.
diff --git a/.hark/changes/2019-10-19_ob_update-generated-code.change.md b/.hark/changes/2019-10-19_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..83c3cf44dd7
--- /dev/null
+++ b/.hark/changes/2019-10-19_ob_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/864
+released_in_version: 14.0.1
+---
+
+* Remove `renewal_behavior` on Subscription Schedule model class
+* Remove `renewal_interval` on Subscription Schedule parameter classes
+* The above are technically breaking changes and should have been released with 14.0.0.
diff --git a/.hark/changes/2019-10-23_remi_various-api-changes.change.md b/.hark/changes/2019-10-23_remi_various-api-changes.change.md
new file mode 100644
index 00000000000..caab2ec096d
--- /dev/null
+++ b/.hark/changes/2019-10-23_remi_various-api-changes.change.md
@@ -0,0 +1,12 @@
+---
+title: Various API changes
+pr_url: https://github.com/stripe/stripe-java/pull/866
+is_stripe_api_change: true
+released_in_version: 14.1.0
+---
+
+* Add support for `mx_rfc` on `TaxId`
+* Add support for `pending_invoice_item_interval` on  `Subscription` creation and update
+* Add support for `next_pending_invoice_item_invoice` on `Subscription
+* Add support for `installments` which is a feature on `PaymentIntent` and `PaymentMethod` available on MX Stripe accounts. It's also added inside `payment_method_details[card]` on `Charge`
+* Add support for `next_pending_invoice_item_invoice` as a new `Capability`
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 00000000000..0063e3ea5f2
--- /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-java/pull/867
+released_in_version: 14.2.0
+---
diff --git a/.hark/changes/2019-10-24_ob_refactor-form-encoding.change.md b/.hark/changes/2019-10-24_ob_refactor-form-encoding.change.md
new file mode 100644
index 00000000000..7f017313470
--- /dev/null
+++ b/.hark/changes/2019-10-24_ob_refactor-form-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: Refactor form encoding
+pr_url: https://github.com/stripe/stripe-java/pull/857
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-10-24_ob_update-generated-code.change.md b/.hark/changes/2019-10-24_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..69806368021
--- /dev/null
+++ b/.hark/changes/2019-10-24_ob_update-generated-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/868
+released_in_version: 14.2.0
+---
+
+* Add support for typed parameters in `Event.retrieve` method
diff --git a/.hark/changes/2019-10-25_ob_refactor-request-telemetry.change.md b/.hark/changes/2019-10-25_ob_refactor-request-telemetry.change.md
new file mode 100644
index 00000000000..0dacf9df44f
--- /dev/null
+++ b/.hark/changes/2019-10-25_ob_refactor-request-telemetry.change.md
@@ -0,0 +1,6 @@
+---
+title: Refactor request telemetry
+pr_url: https://github.com/stripe/stripe-java/pull/870
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-10-25_remi_codegen-openapi-d8f9ddf.change.md b/.hark/changes/2019-10-25_remi_codegen-openapi-d8f9ddf.change.md
new file mode 100644
index 00000000000..03577e667a3
--- /dev/null
+++ b/.hark/changes/2019-10-25_remi_codegen-openapi-d8f9ddf.change.md
@@ -0,0 +1,7 @@
+---
+title: Codegen for openapi d8f9ddf
+pr_url: https://github.com/stripe/stripe-java/pull/871
+released_in_version: 14.3.0
+---
+
+* Remove `max_amount` from Issuing `Card`. This is technically a breaking change but only one integration was using this feature which changed a while ago
diff --git a/.hark/changes/2019-10-26_ob_move-http-request.change.md b/.hark/changes/2019-10-26_ob_move-http-request.change.md
new file mode 100644
index 00000000000..d062df416a5
--- /dev/null
+++ b/.hark/changes/2019-10-26_ob_move-http-request.change.md
@@ -0,0 +1,5 @@
+---
+title: Move HTTP request methods into new `HttpClient` class
+pr_url: https://github.com/stripe/stripe-java/pull/872
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-10-26_ob_suppress-unchecked-cast.change.md b/.hark/changes/2019-10-26_ob_suppress-unchecked-cast.change.md
new file mode 100644
index 00000000000..2c4254480a4
--- /dev/null
+++ b/.hark/changes/2019-10-26_ob_suppress-unchecked-cast.change.md
@@ -0,0 +1,5 @@
+---
+title: Suppress unchecked cast warnings in test
+pr_url: https://github.com/stripe/stripe-java/pull/873
+released_in_version: 14.4.0
+---
diff --git a/.hark/changes/2019-10-30_remi_add-support-invoicecusto.change.md b/.hark/changes/2019-10-30_remi_add-support-invoicecusto.change.md
new file mode 100644
index 00000000000..2d1e8e7c3cb
--- /dev/null
+++ b/.hark/changes/2019-10-30_remi_add-support-invoicecusto.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `invoice_customer_balance_settings` on `Invoice`
+pr_url: https://github.com/stripe/stripe-java/pull/876
+released_in_version: 14.4.0
+---
diff --git a/.hark/changes/2019-10-31_remi_fix-docstring-parameter.change.md b/.hark/changes/2019-10-31_remi_fix-docstring-parameter.change.md
new file mode 100644
index 00000000000..0de9ee55d21
--- /dev/null
+++ b/.hark/changes/2019-10-31_remi_fix-docstring-parameter.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix docstring for a parameter to reflect the correct behaviour
+pr_url: https://github.com/stripe/stripe-java/pull/877
+released_in_version: 14.4.1
+---
diff --git a/.hark/changes/2019-11-01_ob_add-httpclient-abstract.change.md b/.hark/changes/2019-11-01_ob_add-httpclient-abstract.change.md
new file mode 100644
index 00000000000..0aab6955788
--- /dev/null
+++ b/.hark/changes/2019-11-01_ob_add-httpclient-abstract.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `HttpClient` abstract class
+pr_url: https://github.com/stripe/stripe-java/pull/879
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-01_ob_add-stripereques-object.change.md b/.hark/changes/2019-11-01_ob_add-stripereques-object.change.md
new file mode 100644
index 00000000000..913a7872f11
--- /dev/null
+++ b/.hark/changes/2019-11-01_ob_add-stripereques-object.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `StripeRequest` object
+pr_url: https://github.com/stripe/stripe-java/pull/878
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-01_ob_stop-disabling-dns.change.md b/.hark/changes/2019-11-01_ob_stop-disabling-dns.change.md
new file mode 100644
index 00000000000..ddcefd4f3e4
--- /dev/null
+++ b/.hark/changes/2019-11-01_ob_stop-disabling-dns.change.md
@@ -0,0 +1,6 @@
+---
+title: Stop disabling the DNS cache
+pr_url: https://github.com/stripe/stripe-java/pull/880
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-04_remi_add-support-usestripesdk.change.md b/.hark/changes/2019-11-04_remi_add-support-usestripesdk.change.md
new file mode 100644
index 00000000000..a81e818cd69
--- /dev/null
+++ b/.hark/changes/2019-11-04_remi_add-support-usestripesdk.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `use_stripe_sdk` on `PaymentIntent` creation and confirmation
+pr_url: https://github.com/stripe/stripe-java/pull/881
+released_in_version: 14.5.0
+---
diff --git a/.hark/changes/2019-11-06_ob_add-support-sepa.change.md b/.hark/changes/2019-11-06_ob_add-support-sepa.change.md
new file mode 100644
index 00000000000..5c7a05d8441
--- /dev/null
+++ b/.hark/changes/2019-11-06_ob_add-support-sepa.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for SEPA and iDEAL on `PaymentMethod` and `Mandate`
+pr_url: https://github.com/stripe/stripe-java/pull/888
+released_in_version: 15.1.0
+---
diff --git a/.hark/changes/2019-11-06_remi_move-latest-api.change.md b/.hark/changes/2019-11-06_remi_move-latest-api.change.md
new file mode 100644
index 00000000000..5998aa3367a
--- /dev/null
+++ b/.hark/changes/2019-11-06_remi_move-latest-api.change.md
@@ -0,0 +1,10 @@
+---
+title: Move to the latest API version and add new changes
+pr_url: https://github.com/stripe/stripe-java/pull/886
+released_in_version: 15.0.0
+---
+
+* Move to API version `2019-11-05`
+* Add `default_settings` on `SubscritionSchedule`
+* Remove `billing_thresholds`, `collection_method`, `default_payment_method`, `default_source` and `invoice_settings` from `SubscriptionSchedule
+* Add `charge` filter when listing `Dispute`
diff --git a/.hark/changes/2019-11-07_remi_multiple-api-changes.change.md b/.hark/changes/2019-11-07_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..176dd74dc8a
--- /dev/null
+++ b/.hark/changes/2019-11-07_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: "Multiple API changes:"
+pr_url: https://github.com/stripe/stripe-java/pull/889
+released_in_version: 15.2.0
+---
+
+* Add `disputed` on `Charge`.
+* Add `payment_intent` on ` Dispute` and `Refund`.
+* Add `payment_intent` when creating a `Refund`.
+* Add `payment_intent` filter when listing `Refund` and `Dispute`.
diff --git a/.hark/changes/2019-11-08_ob_replace-cobertura-jacoco.change.md b/.hark/changes/2019-11-08_ob_replace-cobertura-jacoco.change.md
new file mode 100644
index 00000000000..c77222e63d1
--- /dev/null
+++ b/.hark/changes/2019-11-08_ob_replace-cobertura-jacoco.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace Cobertura with JaCoCo
+pr_url: https://github.com/stripe/stripe-java/pull/891
+released_in_version: 15.3.0
+---
diff --git a/.hark/changes/2019-11-08_remi_multiple-api-changes.change.md b/.hark/changes/2019-11-08_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..ff5c0af969a
--- /dev/null
+++ b/.hark/changes/2019-11-08_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/890
+is_stripe_api_change: true
+released_in_version: 15.3.0
+---
+
+* Add `company` and `individual` to Issuing `Cardholder`
+* Add `sepa_debit` to `PaymentMethodUpdateParams`
diff --git a/.hark/changes/2019-11-11_ob_fix-deprecation-warnings.change.md b/.hark/changes/2019-11-11_ob_fix-deprecation-warnings.change.md
new file mode 100644
index 00000000000..18197291f23
--- /dev/null
+++ b/.hark/changes/2019-11-11_ob_fix-deprecation-warnings.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix deprecation warnings
+pr_url: https://github.com/stripe/stripe-java/pull/895
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-11_ob_upgrade-gradle-other.change.md b/.hark/changes/2019-11-11_ob_upgrade-gradle-other.change.md
new file mode 100644
index 00000000000..c75b39c730a
--- /dev/null
+++ b/.hark/changes/2019-11-11_ob_upgrade-gradle-other.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Gradle and other dependencies
+pr_url: https://github.com/stripe/stripe-java/pull/894
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2019-11-12_ob_add-httpcontent-class.change.md b/.hark/changes/2019-11-12_ob_add-httpcontent-class.change.md
new file mode 100644
index 00000000000..6cf0743628c
--- /dev/null
+++ b/.hark/changes/2019-11-12_ob_add-httpcontent-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `HttpContent` class
+pr_url: https://github.com/stripe/stripe-java/pull/896
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-12_ob_add-stopwatch-class.change.md b/.hark/changes/2019-11-12_ob_add-stopwatch-class.change.md
new file mode 100644
index 00000000000..099d1820abd
--- /dev/null
+++ b/.hark/changes/2019-11-12_ob_add-stopwatch-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `Stopwatch` class
+pr_url: https://github.com/stripe/stripe-java/pull/897
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-13_ob_move-all-request.change.md b/.hark/changes/2019-11-13_ob_move-all-request.change.md
new file mode 100644
index 00000000000..df1fbf61a07
--- /dev/null
+++ b/.hark/changes/2019-11-13_ob_move-all-request.change.md
@@ -0,0 +1,5 @@
+---
+title: Move all request properties in `StripeRequest`
+pr_url: https://github.com/stripe/stripe-java/pull/898
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-13_ob_remove-apiresource-requesttype.change.md b/.hark/changes/2019-11-13_ob_remove-apiresource-requesttype.change.md
new file mode 100644
index 00000000000..8714cb483ab
--- /dev/null
+++ b/.hark/changes/2019-11-13_ob_remove-apiresource-requesttype.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `ApiResource.RequestType`
+pr_url: https://github.com/stripe/stripe-java/pull/899
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-14_ob_add-support-automatic.change.md b/.hark/changes/2019-11-14_ob_add-support-automatic.change.md
new file mode 100644
index 00000000000..24a433226e7
--- /dev/null
+++ b/.hark/changes/2019-11-14_ob_add-support-automatic.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for automatic request retries
+pr_url: https://github.com/stripe/stripe-java/pull/900
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-15_ob_minor-code-quality.change.md b/.hark/changes/2019-11-15_ob_minor-code-quality.change.md
new file mode 100644
index 00000000000..bb6ebc963a0
--- /dev/null
+++ b/.hark/changes/2019-11-15_ob_minor-code-quality.change.md
@@ -0,0 +1,5 @@
+---
+title: Minor code quality fixes
+pr_url: https://github.com/stripe/stripe-java/pull/901
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2019-11-15_ob_minor-fixes.change.md b/.hark/changes/2019-11-15_ob_minor-fixes.change.md
new file mode 100644
index 00000000000..9b9f51087e5
--- /dev/null
+++ b/.hark/changes/2019-11-15_ob_minor-fixes.change.md
@@ -0,0 +1,5 @@
+---
+title: Minor fixes
+pr_url: https://github.com/stripe/stripe-java/pull/902
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2019-11-16_ob_serialize-null-values.change.md b/.hark/changes/2019-11-16_ob_serialize-null-values.change.md
new file mode 100644
index 00000000000..f99facf558a
--- /dev/null
+++ b/.hark/changes/2019-11-16_ob_serialize-null-values.change.md
@@ -0,0 +1,5 @@
+---
+title: Serialize null values in all maps
+pr_url: https://github.com/stripe/stripe-java/pull/903
+released_in_version: 15.3.1
+---
diff --git a/.hark/changes/2019-11-18_remi_add-support-violatedauth.change.md b/.hark/changes/2019-11-18_remi_add-support-violatedauth.change.md
new file mode 100644
index 00000000000..ebd6bfdda47
--- /dev/null
+++ b/.hark/changes/2019-11-18_remi_add-support-violatedauth.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `violated_authorization_controls` on Issuing `Authorization`
+pr_url: https://github.com/stripe/stripe-java/pull/904
+released_in_version: 15.4.0
+---
diff --git a/.hark/changes/2019-11-21_remi_add-support-paymentinten.change.md b/.hark/changes/2019-11-21_remi_add-support-paymentinten.change.md
new file mode 100644
index 00000000000..8c32c3c8150
--- /dev/null
+++ b/.hark/changes/2019-11-21_remi_add-support-paymentinten.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_intent` filter when listing `Dispute`s.
+pr_url: https://github.com/stripe/stripe-java/pull/905
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2019-11-25_remi_add-support-outofbandamo.change.md b/.hark/changes/2019-11-25_remi_add-support-outofbandamo.change.md
new file mode 100644
index 00000000000..ea9634c5dce
--- /dev/null
+++ b/.hark/changes/2019-11-25_remi_add-support-outofbandamo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `out_of_band_amount` on `CreditNote` creation
+pr_url: https://github.com/stripe/stripe-java/pull/907
+released_in_version: 15.6.0
+---
diff --git a/.hark/changes/2019-11-26_ob_add-support-preview.change.md b/.hark/changes/2019-11-26_ob_add-support-preview.change.md
new file mode 100644
index 00000000000..889a63ccf9a
--- /dev/null
+++ b/.hark/changes/2019-11-26_ob_add-support-preview.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Preview endpoint on CreditNote
+pr_url: https://github.com/stripe/stripe-java/pull/908
+released_in_version: 15.7.0
+---
diff --git a/.hark/changes/2019-12-04_remi_add-support-network.change.md b/.hark/changes/2019-12-04_remi_add-support-network.change.md
new file mode 100644
index 00000000000..60875eb6e5e
--- /dev/null
+++ b/.hark/changes/2019-12-04_remi_add-support-network.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `network` on `Charge` and `funding_method` on `SourceTransaction`
+pr_url: https://github.com/stripe/stripe-java/pull/912
+released_in_version: 16.1.0
+---
diff --git a/.hark/changes/2019-12-04_remi_multiple-api-changes.change.md b/.hark/changes/2019-12-04_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..bf933bcfc87
--- /dev/null
+++ b/.hark/changes/2019-12-04_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/911
+is_stripe_api_change: true
+released_in_version: 16.0.0
+---
+
+* Pin to API version `2019-12-03`
+* Remove `tax_info` and `tax_info_verification` on `Customer`
+* Remove `cardholder` on Issuing `Card` update
+* Remove `invoice_customer_balance_settings` from `Subscription`
diff --git a/.hark/changes/2019-12-04_remi_use-global-timeouts.change.md b/.hark/changes/2019-12-04_remi_use-global-timeouts.change.md
new file mode 100644
index 00000000000..fb07dc8458b
--- /dev/null
+++ b/.hark/changes/2019-12-04_remi_use-global-timeouts.change.md
@@ -0,0 +1,5 @@
+---
+title: Use global timeouts in RequestOptions
+pr_url: https://github.com/stripe/stripe-java/pull/910
+released_in_version: 16.0.0
+---
diff --git a/.hark/changes/2019-12-05_richardm_add-documentatio-enum.change.md b/.hark/changes/2019-12-05_richardm_add-documentatio-enum.change.md
new file mode 100644
index 00000000000..8143eb18b57
--- /dev/null
+++ b/.hark/changes/2019-12-05_richardm_add-documentatio-enum.change.md
@@ -0,0 +1,5 @@
+---
+title: Add documentation for enum values
+pr_url: https://github.com/stripe/stripe-java/pull/906
+released_in_version: 16.2.0
+---
diff --git a/.hark/changes/2019-12-09_remi_add-support-au.change.md b/.hark/changes/2019-12-09_remi_add-support-au.change.md
new file mode 100644
index 00000000000..d33564d3eb3
--- /dev/null
+++ b/.hark/changes/2019-12-09_remi_add-support-au.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for AU BECS Debit on `PaymentMethod`
+pr_url: https://github.com/stripe/stripe-java/pull/914
+released_in_version: 16.2.0
+---
diff --git a/.hark/changes/2019-12-20_remi_add-executivespr-account.change.md b/.hark/changes/2019-12-20_remi_add-executivespr-account.change.md
new file mode 100644
index 00000000000..db56f16c9f2
--- /dev/null
+++ b/.hark/changes/2019-12-20_remi_add-executivespr-account.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `executives_provided` on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/921
+released_in_version: 16.4.0
+---
diff --git a/.hark/changes/2019-12-20_remi_multiple-api-changes.change.md b/.hark/changes/2019-12-20_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..972e5903c95
--- /dev/null
+++ b/.hark/changes/2019-12-20_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/918
+is_stripe_api_change: true
+released_in_version: 16.3.0
+---
+
+* Adds `livemode` and `metadata` to Terminal `Reader` and `Location`
+* Adds `ms` as a valid locale on Checkout `Session`
diff --git a/.hark/changes/2020-01-08_richardm_codegen-openapi-c896d1f.change.md b/.hark/changes/2020-01-08_richardm_codegen-openapi-c896d1f.change.md
new file mode 100644
index 00000000000..2ade8e06b77
--- /dev/null
+++ b/.hark/changes/2020-01-08_richardm_codegen-openapi-c896d1f.change.md
@@ -0,0 +1,10 @@
+---
+title: Codegen for openapi c896d1f
+pr_url: https://github.com/stripe/stripe-java/pull/922
+is_stripe_api_change: true
+released_in_version: 16.5.0
+---
+
+* Add support for custom properties on `Source.detach` method
+* Add support for property expansion in `Subscription.cancel` method.
+* Add support for `sg_uen` on `TaxId`
diff --git a/.hark/changes/2020-01-10_remi_doc-changes-core.change.md b/.hark/changes/2020-01-10_remi_doc-changes-core.change.md
new file mode 100644
index 00000000000..db7840d42d4
--- /dev/null
+++ b/.hark/changes/2020-01-10_remi_doc-changes-core.change.md
@@ -0,0 +1,5 @@
+---
+title: Doc changes for core properties or parameters such as `metadata` or `livemode`
+pr_url: https://github.com/stripe/stripe-java/pull/924
+released_in_version: 16.5.1
+---
diff --git a/.hark/changes/2020-01-13_ob_remove-support-custom.change.md b/.hark/changes/2020-01-13_ob_remove-support-custom.change.md
new file mode 100644
index 00000000000..d5b373f7145
--- /dev/null
+++ b/.hark/changes/2020-01-13_ob_remove-support-custom.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove support for custom `URLStreamHandler`
+pr_url: https://github.com/stripe/stripe-java/pull/927
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-13_ob_stringutils-class-better.change.md b/.hark/changes/2020-01-13_ob_stringutils-class-better.change.md
new file mode 100644
index 00000000000..0ba4a10e932
--- /dev/null
+++ b/.hark/changes/2020-01-13_ob_stringutils-class-better.change.md
@@ -0,0 +1,5 @@
+---
+title: "`StringUtils` class & better API key validation"
+pr_url: https://github.com/stripe/stripe-java/pull/928
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-14_ob_bump-stripe-mock.change.md b/.hark/changes/2020-01-14_ob_bump-stripe-mock.change.md
new file mode 100644
index 00000000000..97049b45933
--- /dev/null
+++ b/.hark/changes/2020-01-14_ob_bump-stripe-mock.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump stripe-mock to 0.79.0
+pr_url: https://github.com/stripe/stripe-java/pull/930
+released_in_version: 16.7.0
+---
diff --git a/.hark/changes/2020-01-14_ob_modernize-striperespon.change.md b/.hark/changes/2020-01-14_ob_modernize-striperespon.change.md
new file mode 100644
index 00000000000..250a46b6fd0
--- /dev/null
+++ b/.hark/changes/2020-01-14_ob_modernize-striperespon.change.md
@@ -0,0 +1,6 @@
+---
+title: Modernize `StripeResponse`
+pr_url: https://github.com/stripe/stripe-java/pull/932
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-14_ob_refactor-http-headers.change.md b/.hark/changes/2020-01-14_ob_refactor-http-headers.change.md
new file mode 100644
index 00000000000..bbccc015e52
--- /dev/null
+++ b/.hark/changes/2020-01-14_ob_refactor-http-headers.change.md
@@ -0,0 +1,6 @@
+---
+title: Refactor HTTP headers handling
+pr_url: https://github.com/stripe/stripe-java/pull/931
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-14_remi_add-support-creditnoteli.change.md b/.hark/changes/2020-01-14_remi_add-support-creditnoteli.change.md
new file mode 100644
index 00000000000..10839b6f16a
--- /dev/null
+++ b/.hark/changes/2020-01-14_remi_add-support-creditnoteli.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CreditNoteLineItem`
+pr_url: https://github.com/stripe/stripe-java/pull/929
+released_in_version: 16.6.0
+---
diff --git a/.hark/changes/2020-01-15_ob_add-maxnetworkre-global.change.md b/.hark/changes/2020-01-15_ob_add-maxnetworkre-global.change.md
new file mode 100644
index 00000000000..f4a71eb50a3
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_add-maxnetworkre-global.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `maxNetworkRetries` as a global and per-request setting
+pr_url: https://github.com/stripe/stripe-java/pull/934
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_ob_add-streamutils-class.change.md b/.hark/changes/2020-01-15_ob_add-streamutils-class.change.md
new file mode 100644
index 00000000000..a86a7faeee2
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_add-streamutils-class.change.md
@@ -0,0 +1,6 @@
+---
+title: Add `StreamUtils` class
+pr_url: https://github.com/stripe/stripe-java/pull/935
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_ob_major-version-release.change.md b/.hark/changes/2020-01-15_ob_major-version-release.change.md
new file mode 100644
index 00000000000..3e5db7843ae
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_major-version-release.change.md
@@ -0,0 +1,5 @@
+---
+title: Major version release. Refer to our [migration guide for v17](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v17) for a list of new features and backwards incompatible changes to watch out for.
+pr_url: https://github.com/stripe/stripe-java/pull/869
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_ob_remove-deprecated-properties.change.md b/.hark/changes/2020-01-15_ob_remove-deprecated-properties.change.md
new file mode 100644
index 00000000000..987e43f73a2
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_remove-deprecated-properties.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove deprecated properties and parameters
+pr_url: https://github.com/stripe/stripe-java/pull/938
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_ob_remove-support-count.change.md b/.hark/changes/2020-01-15_ob_remove-support-count.change.md
new file mode 100644
index 00000000000..55e01bee6bb
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_remove-support-count.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove support for `count` and `total_count` in list objects
+pr_url: https://github.com/stripe/stripe-java/pull/936
+semver_level: major
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_ob_update-readme.change.md b/.hark/changes/2020-01-15_ob_update-readme.change.md
new file mode 100644
index 00000000000..3e62b0ac1c2
--- /dev/null
+++ b/.hark/changes/2020-01-15_ob_update-readme.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README
+pr_url: https://github.com/stripe/stripe-java/pull/939
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2020-01-15_remi_add-support-pendingupdat.change.md b/.hark/changes/2020-01-15_remi_add-support-pendingupdat.change.md
new file mode 100644
index 00000000000..f07a08c4a01
--- /dev/null
+++ b/.hark/changes/2020-01-15_remi_add-support-pendingupdat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `pending_update` on `Subscription`
+pr_url: https://github.com/stripe/stripe-java/pull/933
+released_in_version: 16.7.0
+---
diff --git a/.hark/changes/2020-01-15_remi_adding-missing-events.change.md b/.hark/changes/2020-01-15_remi_adding-missing-events.change.md
new file mode 100644
index 00000000000..6093f705313
--- /dev/null
+++ b/.hark/changes/2020-01-15_remi_adding-missing-events.change.md
@@ -0,0 +1,5 @@
+---
+title: Adding missing events for pending updates on `Subscription`
+pr_url: https://github.com/stripe/stripe-java/pull/937
+released_in_version: 16.8.0
+---
diff --git a/.hark/changes/2020-01-16_ob_add-stripeobject-interface.change.md b/.hark/changes/2020-01-16_ob_add-stripeobject-interface.change.md
new file mode 100644
index 00000000000..92db694d10d
--- /dev/null
+++ b/.hark/changes/2020-01-16_ob_add-stripeobject-interface.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `StripeObjectInterface` interface
+pr_url: https://github.com/stripe/stripe-java/pull/940
+released_in_version: 17.1.0
+---
diff --git a/.hark/changes/2020-01-18_remi_add-support-metadata.change.md b/.hark/changes/2020-01-18_remi_add-support-metadata.change.md
new file mode 100644
index 00000000000..52befdc5022
--- /dev/null
+++ b/.hark/changes/2020-01-18_remi_add-support-metadata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `metadata` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/943
+released_in_version: 17.1.0
+---
diff --git a/.hark/changes/2020-01-22_remi_improve-docstrings-many.change.md b/.hark/changes/2020-01-22_remi_improve-docstrings-many.change.md
new file mode 100644
index 00000000000..b2f2aa2f97c
--- /dev/null
+++ b/.hark/changes/2020-01-22_remi_improve-docstrings-many.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve docstrings for many properties and parameters
+pr_url: https://github.com/stripe/stripe-java/pull/944
+released_in_version: 17.1.1
+---
diff --git a/.hark/changes/2020-01-24_ob_changes-custom-http.change.md b/.hark/changes/2020-01-24_ob_changes-custom-http.change.md
new file mode 100644
index 00000000000..bb30366dd8d
--- /dev/null
+++ b/.hark/changes/2020-01-24_ob_changes-custom-http.change.md
@@ -0,0 +1,5 @@
+---
+title: Changes for custom HTTP clients
+pr_url: https://github.com/stripe/stripe-java/pull/947
+released_in_version: 17.2.0
+---
diff --git a/.hark/changes/2020-01-24_remi_add-support-shipping.change.md b/.hark/changes/2020-01-24_remi_add-support-shipping.change.md
new file mode 100644
index 00000000000..69c61cc7141
--- /dev/null
+++ b/.hark/changes/2020-01-24_remi_add-support-shipping.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `shipping.speed` on Issuing `Card` and new `TaxID` types
+pr_url: https://github.com/stripe/stripe-java/pull/948
+released_in_version: 17.3.0
+---
diff --git a/.hark/changes/2020-01-27_remi_move-examples-customer.change.md b/.hark/changes/2020-01-27_remi_move-examples-customer.change.md
new file mode 100644
index 00000000000..cc1c3ff41cf
--- /dev/null
+++ b/.hark/changes/2020-01-27_remi_move-examples-customer.change.md
@@ -0,0 +1,5 @@
+---
+title: Move examples to Customer instead of Charge
+pr_url: https://github.com/stripe/stripe-java/pull/949
+released_in_version: 17.4.0
+---
diff --git a/.hark/changes/2020-01-28_remi_add-new-type.change.md b/.hark/changes/2020-01-28_remi_add-new-type.change.md
new file mode 100644
index 00000000000..cf9ceec002a
--- /dev/null
+++ b/.hark/changes/2020-01-28_remi_add-new-type.change.md
@@ -0,0 +1,5 @@
+---
+title: Add new type for `TaxId` and `sender_account_name` on `SourceTransaction`
+pr_url: https://github.com/stripe/stripe-java/pull/953
+released_in_version: 17.4.0
+---
diff --git a/.hark/changes/2020-01-30_remi_add-support-fpx.change.md b/.hark/changes/2020-01-30_remi_add-support-fpx.change.md
new file mode 100644
index 00000000000..3e885386c37
--- /dev/null
+++ b/.hark/changes/2020-01-30_remi_add-support-fpx.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for FPX as a `PaymentMethod`
+pr_url: https://github.com/stripe/stripe-java/pull/955
+released_in_version: 17.5.0
+---
diff --git a/.hark/changes/2020-01-31_remi_add-support-company.change.md b/.hark/changes/2020-01-31_remi_add-support-company.change.md
new file mode 100644
index 00000000000..5372afdc7fc
--- /dev/null
+++ b/.hark/changes/2020-01-31_remi_add-support-company.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `company.structure` on `Account` and new types of `TaxId`
+pr_url: https://github.com/stripe/stripe-java/pull/959
+released_in_version: 17.6.0
+---
diff --git a/.hark/changes/2020-02-03_remi_add-additional-verification.change.md b/.hark/changes/2020-02-03_remi_add-additional-verification.change.md
new file mode 100644
index 00000000000..ebb5bed9737
--- /dev/null
+++ b/.hark/changes/2020-02-03_remi_add-additional-verification.change.md
@@ -0,0 +1,5 @@
+---
+title: Add additional verification file purpose
+pr_url: https://github.com/stripe/stripe-java/pull/957
+released_in_version: 17.7.0
+---
diff --git a/.hark/changes/2020-02-04_ob_rename-sortcode-sendersortco.change.md b/.hark/changes/2020-02-04_ob_rename-sortcode-sendersortco.change.md
new file mode 100644
index 00000000000..2655ab45040
--- /dev/null
+++ b/.hark/changes/2020-02-04_ob_rename-sortcode-sendersortco.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `sort_code` to `sender_sort_code` on `SourceTransaction` for BACS debit. (This is technically a breaking change.)
+pr_url: https://github.com/stripe/stripe-java/pull/961
+released_in_version: 17.8.0
+---
diff --git a/.hark/changes/2020-02-04_remi_add-support-erroronrequi.change.md b/.hark/changes/2020-02-04_remi_add-support-erroronrequi.change.md
new file mode 100644
index 00000000000..51ba0a0bfeb
--- /dev/null
+++ b/.hark/changes/2020-02-04_remi_add-support-erroronrequi.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `error_on_requires_action` on `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/960
+released_in_version: 17.7.0
+---
diff --git a/.hark/changes/2020-02-11_ob_add-gradle-plugin.change.md b/.hark/changes/2020-02-11_ob_add-gradle-plugin.change.md
new file mode 100644
index 00000000000..433b092b1b2
--- /dev/null
+++ b/.hark/changes/2020-02-11_ob_add-gradle-plugin.change.md
@@ -0,0 +1,5 @@
+---
+title: Add Gradle plugin for publishing JavaDoc to GitHub Pages
+pr_url: https://github.com/stripe/stripe-java/pull/965
+released_in_version: 17.9.1
+---
diff --git a/.hark/changes/2020-02-11_ob_convert-markdown-html.change.md b/.hark/changes/2020-02-11_ob_convert-markdown-html.change.md
new file mode 100644
index 00000000000..7cde736a6b3
--- /dev/null
+++ b/.hark/changes/2020-02-11_ob_convert-markdown-html.change.md
@@ -0,0 +1,5 @@
+---
+title: Convert Markdown to HTML in Javadoc
+pr_url: https://github.com/stripe/stripe-java/pull/964
+released_in_version: 17.9.1
+---
diff --git a/.hark/changes/2020-02-11_remi_multiple-api-changes.change.md b/.hark/changes/2020-02-11_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..838fdb7f05b
--- /dev/null
+++ b/.hark/changes/2020-02-11_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/963
+is_stripe_api_change: true
+released_in_version: 17.9.0
+---
+
+* Add support for new `type` values for `TaxId`.
+* Add support for `payment_intent_data[statement_descriptor_suffix]` on Checkout `Session`.
diff --git a/.hark/changes/2020-02-12_remi_add-support-paymentinten.change.md b/.hark/changes/2020-02-12_remi_add-support-paymentinten.change.md
new file mode 100644
index 00000000000..6f2d803175f
--- /dev/null
+++ b/.hark/changes/2020-02-12_remi_add-support-paymentinten.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_intent_data[transfer_data][amount]` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/968
+released_in_version: 17.11.0
+---
diff --git a/.hark/changes/2020-02-12_remi_multiple-api-changes.change.md b/.hark/changes/2020-02-12_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..143df692132
--- /dev/null
+++ b/.hark/changes/2020-02-12_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/967
+is_stripe_api_change: true
+released_in_version: 17.10.0
+---
+
+* Add `fpx` as a valid `source_type` on `Balance`, `Payout` and `Transfer`
+* Add `fpx` support on Checkout `Session`
+* Fields inside `verification_data` on Issuing `Authorization` are now enums
+* Support updating `payment_method_options` on `PaymentIntent` and `SetupIntent`
diff --git a/.hark/changes/2020-02-21_remi_multiple-api-changes.change.md b/.hark/changes/2020-02-21_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..a0c6caaab73
--- /dev/null
+++ b/.hark/changes/2020-02-21_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/970
+is_stripe_api_change: true
+released_in_version: 17.12.0
+---
+
+* Add support for `timezone` on `ReportRun`
+* Add support for `proration_behavior` on `SubscriptionSchedule`
diff --git a/.hark/changes/2020-02-24_remi_add-support-listing.change.md b/.hark/changes/2020-02-24_remi_add-support-listing.change.md
new file mode 100644
index 00000000000..a43e3ddc974
--- /dev/null
+++ b/.hark/changes/2020-02-24_remi_add-support-listing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for listing Checkout `Session` and passing tax rate information
+pr_url: https://github.com/stripe/stripe-java/pull/973
+released_in_version: 17.13.0
+---
diff --git a/.hark/changes/2020-02-25_remi_add-new-enum.change.md b/.hark/changes/2020-02-25_remi_add-new-enum.change.md
new file mode 100644
index 00000000000..7c66281d7e3
--- /dev/null
+++ b/.hark/changes/2020-02-25_remi_add-new-enum.change.md
@@ -0,0 +1,5 @@
+---
+title: Add new enum values in `reason` for Issuing `Dispute` creation
+pr_url: https://github.com/stripe/stripe-java/pull/974
+released_in_version: 17.14.0
+---
diff --git a/.hark/changes/2020-02-27_remi_make-type-accountlink.change.md b/.hark/changes/2020-02-27_remi_make-type-accountlink.change.md
new file mode 100644
index 00000000000..686e3279ada
--- /dev/null
+++ b/.hark/changes/2020-02-27_remi_make-type-accountlink.change.md
@@ -0,0 +1,5 @@
+---
+title: Make `type` on `AccountLink` an enum
+pr_url: https://github.com/stripe/stripe-java/pull/975
+released_in_version: 17.15.0
+---
diff --git a/.hark/changes/2020-02-28_remi_add-mysst-valid.change.md b/.hark/changes/2020-02-28_remi_add-mysst-valid.change.md
new file mode 100644
index 00000000000..788d2aa2806
--- /dev/null
+++ b/.hark/changes/2020-02-28_remi_add-mysst-valid.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `my_sst` as a valid value for `type` on `TaxId`
+pr_url: https://github.com/stripe/stripe-java/pull/976
+released_in_version: 17.16.0
+---
diff --git a/.hark/changes/2020-03-03_remi_multiple-api-changes.change.md b/.hark/changes/2020-03-03_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..20f89aefbb1
--- /dev/null
+++ b/.hark/changes/2020-03-03_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: "Multiple API changes:"
+pr_url: https://github.com/stripe/stripe-java/pull/977
+released_in_version: 18.0.0
+---
+
+* Pin to API version `2020-03-02`
+* Remove `uob_regional` as a value on `bank` for FPX as this is deprecated and was never used
+* Add support for `next_invoice_sequence` on `Customer`
+* Add support for `proration_behavior` on `SubscriptionItem` delete
diff --git a/.hark/changes/2020-03-04_remi_multiple-api-changes.change.md b/.hark/changes/2020-03-04_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..136df0939e1
--- /dev/null
+++ b/.hark/changes/2020-03-04_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/979
+is_stripe_api_change: true
+released_in_version: 18.2.0
+---
+
+* Add support for `account` as a parameter on `Token` to create Account tokens
+* Add support for `verification_data.expiry_check` on Issuing `Authorization`
+* Add support for `incorrect_cvc` and `incorrect_expiry` as a value for `request_history.reason` on Issuing `Authorization`
diff --git a/.hark/changes/2020-03-04_remi_multiple-api-changes_2.change.md b/.hark/changes/2020-03-04_remi_multiple-api-changes_2.change.md
new file mode 100644
index 00000000000..d4cf32f3fa3
--- /dev/null
+++ b/.hark/changes/2020-03-04_remi_multiple-api-changes_2.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/978
+is_stripe_api_change: true
+released_in_version: 18.1.0
+---
+
+* Add support for `errors` in `requirements` on `Account`, `Capability` and `Person`
+* Add support for `payment_intent.processing` as a new `type` on `Event`.
diff --git a/.hark/changes/2020-03-05_remi_add-support-metadata.change.md b/.hark/changes/2020-03-05_remi_add-support-metadata.change.md
new file mode 100644
index 00000000000..ce8ddcbb5d5
--- /dev/null
+++ b/.hark/changes/2020-03-05_remi_add-support-metadata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `metadata` on `WebhookEndpoint`
+pr_url: https://github.com/stripe/stripe-java/pull/980
+released_in_version: 18.3.0
+---
diff --git a/.hark/changes/2020-03-06_remi_make-metadata-nullable.change.md b/.hark/changes/2020-03-06_remi_make-metadata-nullable.change.md
new file mode 100644
index 00000000000..50947a20680
--- /dev/null
+++ b/.hark/changes/2020-03-06_remi_make-metadata-nullable.change.md
@@ -0,0 +1,5 @@
+---
+title: Make metadata nullable in many methods
+pr_url: https://github.com/stripe/stripe-java/pull/981
+released_in_version: 18.4.0
+---
diff --git a/.hark/changes/2020-03-12_remi_add-support-shipping.change.md b/.hark/changes/2020-03-12_remi_add-support-shipping.change.md
new file mode 100644
index 00000000000..9506f5ba556
--- /dev/null
+++ b/.hark/changes/2020-03-12_remi_add-support-shipping.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `shipping` and `shipping_address_collection` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/985
+released_in_version: 18.6.0
+---
diff --git a/.hark/changes/2020-03-12_remi_add-support-threedsecure.change.md b/.hark/changes/2020-03-12_remi_add-support-threedsecure.change.md
new file mode 100644
index 00000000000..a3a1c3fc0be
--- /dev/null
+++ b/.hark/changes/2020-03-12_remi_add-support-threedsecure.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `ThreeDSecure` on Issuing `Authorization`
+pr_url: https://github.com/stripe/stripe-java/pull/984
+released_in_version: 18.5.0
+---
diff --git a/.hark/changes/2020-03-13_remi_multiple-api-changes.change.md b/.hark/changes/2020-03-13_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..34c2b10729c
--- /dev/null
+++ b/.hark/changes/2020-03-13_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: "Multiple API changes for Issuing:"
+pr_url: https://github.com/stripe/stripe-java/pull/986
+released_in_version: 18.7.0
+---
+
+* Rename `speed` to `service` on Issuing `Card`
+* Rename `wallet_provider` to `wallet` and `address_zip_check` to `address_postal_code_check` on Issuing `Authorization`
+* Mark `is_default` as deprecated on Issuing `Cardholder`
diff --git a/.hark/changes/2020-03-20_remi_multiple-api-changes.change.md b/.hark/changes/2020-03-20_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..d5ba8a154a5
--- /dev/null
+++ b/.hark/changes/2020-03-20_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: "Multiple API changes for Issuing:"
+pr_url: https://github.com/stripe/stripe-java/pull/989
+released_in_version: 18.8.0
+---
+
+* Add `amount`, `currency`, `merchant_amount` and `merchant_currency` on `Authorization`
+* Add `amount`, `currency`, `merchant_amount` and `merchant_currency` inside `request_history` on `Authorization`
+* Add `pending_request` on `Authorization`
+* Add `amount` when approving an `Authorization`
+* Add `replaced_by` on `Card`.
diff --git a/.hark/changes/2020-03-24_remi_add-support-capabilities.change.md b/.hark/changes/2020-03-24_remi_add-support-capabilities.change.md
new file mode 100644
index 00000000000..a14ffbb6e1a
--- /dev/null
+++ b/.hark/changes/2020-03-24_remi_add-support-capabilities.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for capabilities for AU Becs Debit and Tax reporting
+pr_url: https://github.com/stripe/stripe-java/pull/991
+released_in_version: 18.9.0
+---
diff --git a/.hark/changes/2020-03-24_remi_add-support-pausecollect.change.md b/.hark/changes/2020-03-24_remi_add-support-pausecollect.change.md
new file mode 100644
index 00000000000..41d5f53f7a1
--- /dev/null
+++ b/.hark/changes/2020-03-24_remi_add-support-pausecollect.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `pause_collection` on `Subscription`
+pr_url: https://github.com/stripe/stripe-java/pull/992
+released_in_version: 18.10.0
+---
diff --git a/.hark/changes/2020-03-25_remi_multiple-api-changes.change.md b/.hark/changes/2020-03-25_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..f115922943e
--- /dev/null
+++ b/.hark/changes/2020-03-25_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/993
+is_stripe_api_change: true
+released_in_version: 18.11.0
+---
+
+* Add support for `pt-BR` as a `locale` on Checkout `Session`
+* Add support for `company` as a `type` on Issuing `Cardholder`
diff --git a/.hark/changes/2020-03-26_remi_add-support-spendingcont.change.md b/.hark/changes/2020-03-26_remi_add-support-spendingcont.change.md
new file mode 100644
index 00000000000..564039ed38c
--- /dev/null
+++ b/.hark/changes/2020-03-26_remi_add-support-spendingcont.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `spending_controls` on Issuing `Card` and `Cardholder`
+pr_url: https://github.com/stripe/stripe-java/pull/994
+released_in_version: 18.12.0
+---
diff --git a/.hark/changes/2020-04-03_remi_add-support-calculatedst.change.md b/.hark/changes/2020-04-03_remi_add-support-calculatedst.change.md
new file mode 100644
index 00000000000..aee97020d4e
--- /dev/null
+++ b/.hark/changes/2020-04-03_remi_add-support-calculatedst.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `calculatedStatementDescriptor` on `Charge`
+pr_url: https://github.com/stripe/stripe-java/pull/998
+released_in_version: 18.13.0
+---
diff --git a/.hark/changes/2020-04-04_ob_bump-gradle-other.change.md b/.hark/changes/2020-04-04_ob_bump-gradle-other.change.md
new file mode 100644
index 00000000000..96fe3249375
--- /dev/null
+++ b/.hark/changes/2020-04-04_ob_bump-gradle-other.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump Gradle and other dependencies
+pr_url: https://github.com/stripe/stripe-java/pull/999
+released_in_version: 18.13.1
+---
diff --git a/.hark/changes/2020-04-04_ob_update-generated-code.change.md b/.hark/changes/2020-04-04_ob_update-generated-code.change.md
new file mode 100644
index 00000000000..6c6af181e49
--- /dev/null
+++ b/.hark/changes/2020-04-04_ob_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/999
+released_in_version: 10.11.0
+---
+
+* Add `off_session` to `SubscriptionItem` update
+* Add `customer` when listing `CreditNote`
+* Remove `challenge_only` enum value. This is technically a breaking change, but we've chosen to release this as a minor version in light of the fact that this value was virtually unused.
diff --git a/.hark/changes/2020-04-06_ob_improve-connection-reuse.change.md b/.hark/changes/2020-04-06_ob_improve-connection-reuse.change.md
new file mode 100644
index 00000000000..97618d4e96a
--- /dev/null
+++ b/.hark/changes/2020-04-06_ob_improve-connection-reuse.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve connection reuse
+pr_url: https://github.com/stripe/stripe-java/pull/971
+released_in_version: 18.13.1
+---
diff --git a/.hark/changes/2020-04-10_remi_multiple-api-changes.change.md b/.hark/changes/2020-04-10_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..f3992a8eebf
--- /dev/null
+++ b/.hark/changes/2020-04-10_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1002
+is_stripe_api_change: true
+released_in_version: 18.14.0
+---
+
+* Make `payment_intent` expandable on `Charge`
+* Add support for `sg_gst` as a value for `type` on `TaxId` and related APIs
+* Add `cancellation_reason` and new enum values for `replacement_reason` on Issuing `Card`
diff --git a/.hark/changes/2020-04-14_remi_add-support-description.change.md b/.hark/changes/2020-04-14_remi_add-support-description.change.md
new file mode 100644
index 00000000000..1e5a349758d
--- /dev/null
+++ b/.hark/changes/2020-04-14_remi_add-support-description.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `description` on `WebhookEndpoint`
+pr_url: https://github.com/stripe/stripe-java/pull/1003
+released_in_version: 18.15.0
+---
diff --git a/.hark/changes/2020-04-14_remi_add-support-settings.change.md b/.hark/changes/2020-04-14_remi_add-support-settings.change.md
new file mode 100644
index 00000000000..1a17f39bee3
--- /dev/null
+++ b/.hark/changes/2020-04-14_remi_add-support-settings.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `settings[branding][secondary_color]` on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1006
+released_in_version: 18.16.0
+---
diff --git a/.hark/changes/2020-04-15_remi_multiple-breaking-api.change.md b/.hark/changes/2020-04-15_remi_multiple-breaking-api.change.md
new file mode 100644
index 00000000000..3d5a7fb11fd
--- /dev/null
+++ b/.hark/changes/2020-04-15_remi_multiple-breaking-api.change.md
@@ -0,0 +1,38 @@
+---
+title: "Multiple breaking API changes while removing deprecated Issuing features:"
+pr_url: https://github.com/stripe/stripe-java/pull/1009
+released_in_version: 19.0.0
+---
+
+* Moved `SettingsBranding` on `Account` is now `Branding` inside the `Settings` on `Account`
+* Removed `percentage` filter from the List `TaxRate` API
+* Remove `country` and `routing_number` from `payment_method_details.acss_debit` on `Charge` as this is going to be reworked
+* Moved `transfer_data` on `Subscription` to its own class separate from the one on `Invoice`
+* Removing all deprecated features on Issuing:
+  * Remove `renewal_interval` on `SubscriptionSchedule` which was deprecated
+  * Remove `email` on `Token` as this was only supported for an internal product
+  * Removed deprecated properties and parameters on Issuing `Authorization` that have been renamed or replaced:
+    * `authorized_amount`, `authorized_currency`, `held_amount`, `held_currency`, `is_held_amount_controllable`, `pending_authorized_amount`, `pending_held_amount`, `wallet_provider`
+    * Removed `url` inside `merchant_data`
+    * Removed `address_zip_check`, `authentication` and `three_d_secure` inside `verification_data`
+    * Removed `authorized_amount`, `authorized_currency`, `held_amount`, `held_currency`, `violated_authorization_controls` from `pending_request`
+  * Removed deprecated properties and parameters on Issuing `Card`:
+    * Removed `authorization_controls`, `name`, `pin` and `speed`
+    * Renamed the inner class from `AuthorizationControls` to `SpendingControls`
+    * Moved `SpendingLimit` as an inner class inside `SpendingControls`.
+    * Moved `MerchantData` from being its own class to being an inner class inside `Authorization`
+    * Removed the `details()` API method
+  * Removed `CardDetails` API resource
+  * Removed deprecated properties and parameters on Issuing `Cardholder`:
+    * Removed `authorization_controls`, `is_default`
+    * Removed `name` inside `billing`
+    * Renamed the inner class from `AuthorizationControls` to `SpendingControls`
+    * Moved `MerchantData` from being its own class to being an inner class inside `Authorization`
+    * Moved `SpendingLimit` as an inner class inside `SpendingControls`
+    * Removed the `details()` API method
+  * Clean up the `Dispute` resource and APIs to remove most features as this is still in beta and not yet stable
+  * Removed `issuing_dispute.*` and `issuing_settlement.*` events as those are not public yet
+  * Removed deprecated properties and parameters on Issuing `Transaction`:
+    * Removed `dispute`
+    * Reference `merchant_data` from the inner class in `Authorization`
+    * Removed enum values for `type` to only have `capture` and `refund`
diff --git a/.hark/changes/2020-04-16_remi_multiple-api-changes.change.md b/.hark/changes/2020-04-16_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..952af67adbe
--- /dev/null
+++ b/.hark/changes/2020-04-16_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1010
+is_stripe_api_change: true
+released_in_version: 19.1.0
+---
+
+* Add `institution_number` and `transit_number` in `payment_method_details[acss]` on `Charge`
+* Add `cvc` and `number` as properties that can be included when retrieving an Issuing `Card`
diff --git a/.hark/changes/2020-04-18_remi_multiple-api-changes.change.md b/.hark/changes/2020-04-18_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..0df4155e8ff
--- /dev/null
+++ b/.hark/changes/2020-04-18_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1013
+is_stripe_api_change: true
+released_in_version: 19.2.0
+---
+
+* Add support for `cardholder_name` in `payment_method_details[card_present]` on `Charge`
+* Add new enum values for `company[structure]` on `Account`
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 00000000000..486fbde02d0
--- /dev/null
+++ b/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `billingportal` namespace and `Session` resource and APIs
+pr_url: https://github.com/stripe/stripe-java/pull/1014
+released_in_version: 19.3.0
+---
diff --git a/.hark/changes/2020-04-22_remi_add-support-coupon.change.md b/.hark/changes/2020-04-22_remi_add-support-coupon.change.md
new file mode 100644
index 00000000000..a9f5f82ee57
--- /dev/null
+++ b/.hark/changes/2020-04-22_remi_add-support-coupon.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `coupon` for subscriptions on Checkout
+pr_url: https://github.com/stripe/stripe-java/pull/1015
+released_in_version: 19.4.0
+---
diff --git a/.hark/changes/2020-04-24_remi_add-support-jcbpayments.change.md b/.hark/changes/2020-04-24_remi_add-support-jcbpayments.change.md
new file mode 100644
index 00000000000..8482484acc5
--- /dev/null
+++ b/.hark/changes/2020-04-24_remi_add-support-jcbpayments.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `jcb_payments` as a `Capability`
+pr_url: https://github.com/stripe/stripe-java/pull/1016
+released_in_version: 19.5.0
+---
diff --git a/.hark/changes/2020-04-29_remi_add-support-brcpf.change.md b/.hark/changes/2020-04-29_remi_add-support-brcpf.change.md
new file mode 100644
index 00000000000..6d2a00be5fd
--- /dev/null
+++ b/.hark/changes/2020-04-29_remi_add-support-brcpf.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `br_cpf` and `br_cnpj` as `type` on `TaxId`
+pr_url: https://github.com/stripe/stripe-java/pull/1020
+released_in_version: 19.7.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 00000000000..a97e09af9b7
--- /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-java/pull/1019
+released_in_version: 19.6.0
+---
diff --git a/.hark/changes/2020-05-01_remi_add-support-issuing.change.md b/.hark/changes/2020-05-01_remi_add-support-issuing.change.md
new file mode 100644
index 00000000000..b52c4d58f09
--- /dev/null
+++ b/.hark/changes/2020-05-01_remi_add-support-issuing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `issuing` on `Balance`
+pr_url: https://github.com/stripe/stripe-java/pull/1022
+released_in_version: 19.8.0
+---
diff --git a/.hark/changes/2020-05-07_remi_multiple-api-changes.change.md b/.hark/changes/2020-05-07_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..1e5a581ef7b
--- /dev/null
+++ b/.hark/changes/2020-05-07_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1025
+is_stripe_api_change: true
+released_in_version: 19.9.0
+---
+
+* Remove parameters in `price_data[recurring]` across APIs as they were never supported
+* Move `payment_method_details[card][three_d_secure]` to a list of enum values on `Charge`
+* Add support for for `business_profile[support_address]` on `Account` create and update
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 00000000000..8f155711f0a
--- /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-java/pull/1028
+released_in_version: 19.10.0
+---
diff --git a/.hark/changes/2020-05-13_remi_add-support-purchasedeta.change.md b/.hark/changes/2020-05-13_remi_add-support-purchasedeta.change.md
new file mode 100644
index 00000000000..f7b571647be
--- /dev/null
+++ b/.hark/changes/2020-05-13_remi_add-support-purchasedeta.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `purchase_details` on Issuing `Transaction`
+pr_url: https://github.com/stripe/stripe-java/pull/1030
+released_in_version: 19.11.0
+---
diff --git a/.hark/changes/2020-05-19_remi_multiple-api-changes.change.md b/.hark/changes/2020-05-19_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..b8b60c24af9
--- /dev/null
+++ b/.hark/changes/2020-05-19_remi_multiple-api-changes.change.md
@@ -0,0 +1,13 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1032
+is_stripe_api_change: true
+released_in_version: 19.12.0
+---
+
+* Add support for `issuing_dispute` as a `type` on `BalanceTransaction`
+* Add `balance_transactions` as an array of `BalanceTransaction` on Issuing `Dispute`
+* Add `fingerprint` and `transaction_id` in `payment_method_details[alipay]` on `Charge`
+* Add `transfer_data[amount]` on `Invoice`
+* Add `transfer_data[amount_percent]` on `Subscription`
+* Add `price.created`, `price.deleted` and `price.updated` on `Event`.
diff --git a/.hark/changes/2020-05-20_remi_multiple-api-changes.change.md b/.hark/changes/2020-05-20_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..5c0ad40e7e2
--- /dev/null
+++ b/.hark/changes/2020-05-20_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1033
+is_stripe_api_change: true
+released_in_version: 19.13.0
+---
+
+* Add `anticipation_repayment` as a `type` on `BalanceTransaction`
+* Add `interac_present` as a `type` on `PaymentMethod`
+* Add `payment_method_details[interac_present]` on `Charge`
+* Add `transfer_data` on `SubscriptionSchedule`
diff --git a/.hark/changes/2020-05-22_remi_multiple-api-changes.change.md b/.hark/changes/2020-05-22_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..b09d7b1397a
--- /dev/null
+++ b/.hark/changes/2020-05-22_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1034
+is_stripe_api_change: true
+released_in_version: 19.14.0
+---
+
+* Add support for `ae_trn`, `cl_tin` and `sa_vat` as `type` on `TaxId`
+* Add `result` and `result_reason` inside `payment_method_details[card][three_d_secure]` on `Charge`
diff --git a/.hark/changes/2020-05-28_remi_multiple-api-changes.change.md b/.hark/changes/2020-05-28_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..b3fb00eac14
--- /dev/null
+++ b/.hark/changes/2020-05-28_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1035
+is_stripe_api_change: true
+released_in_version: 19.15.0
+---
+
+* Add `payment_method_details[card][three_d_secure][authentication_flow]` on `Charge`
+* Add `line_items[][price_data][product_data]` on Checkout `Session` creation
diff --git a/.hark/changes/2020-05-29_remi_add-support-bacs.change.md b/.hark/changes/2020-05-29_remi_add-support-bacs.change.md
new file mode 100644
index 00000000000..8862fb7d73c
--- /dev/null
+++ b/.hark/changes/2020-05-29_remi_add-support-bacs.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for BACS Debit as a `PaymentMethod`
+pr_url: https://github.com/stripe/stripe-java/pull/1036
+released_in_version: 19.16.0
+---
diff --git a/.hark/changes/2020-06-03_remi_add-support-bancontact.change.md b/.hark/changes/2020-06-03_remi_add-support-bancontact.change.md
new file mode 100644
index 00000000000..63c54c24276
--- /dev/null
+++ b/.hark/changes/2020-06-03_remi_add-support-bancontact.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Bancontact, EPS, Giropay and P24 on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/1040
+released_in_version: 19.19.0
+---
diff --git a/.hark/changes/2020-06-03_remi_add-support-paymentinten.change.md b/.hark/changes/2020-06-03_remi_add-support-paymentinten.change.md
new file mode 100644
index 00000000000..897c7dedaa3
--- /dev/null
+++ b/.hark/changes/2020-06-03_remi_add-support-paymentinten.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_intent_data[transfer_group]` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/1041
+released_in_version: 19.20.0
+---
diff --git a/.hark/changes/2020-06-03_remi_multiple-api-changes.change.md b/.hark/changes/2020-06-03_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..00faaaa62ef
--- /dev/null
+++ b/.hark/changes/2020-06-03_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1039
+is_stripe_api_change: true
+released_in_version: 19.18.0
+---
+
+* Add `bacs_debit_payments` as a `Capability`
+* Add support for BACS Debit on Checkout `Session`
+* Add support for `checkout.session.async_payment_failed` and `checkout.session.async_payment_succeeded` as `type` on `Event`
diff --git a/.hark/changes/2020-06-03_remi_multiple-api-changes_2.change.md b/.hark/changes/2020-06-03_remi_multiple-api-changes_2.change.md
new file mode 100644
index 00000000000..fb10bab1ce6
--- /dev/null
+++ b/.hark/changes/2020-06-03_remi_multiple-api-changes_2.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1038
+is_stripe_api_change: true
+released_in_version: 19.17.0
+---
+
+* Add support for bg, cs, el, et, hu, lt, lv, mt, ro, ru, sk, sl and tr as new locale on Checkout `Session`
+* Add `settings[sepa_debit_payments][creditor_id]` on `Account`
+* Add support for Bancontact, EPS, Giropay and P24 on `PaymentMethod`, `PaymentIntent` and `SetupIntent`
+* Add support for `order_item[parent]` on `Source` for Klarna
diff --git a/.hark/changes/2020-06-09_remi_add-support-idnpwp.change.md b/.hark/changes/2020-06-09_remi_add-support-idnpwp.change.md
new file mode 100644
index 00000000000..9985ac7011e
--- /dev/null
+++ b/.hark/changes/2020-06-09_remi_add-support-idnpwp.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `id_npwp` and `my_frp` as `type` on `TaxId`
+pr_url: https://github.com/stripe/stripe-java/pull/1042
+released_in_version: 19.21.0
+---
diff --git a/.hark/changes/2020-06-11_remi_add-support-cartes.change.md b/.hark/changes/2020-06-11_remi_add-support-cartes.change.md
new file mode 100644
index 00000000000..b758d85f1a5
--- /dev/null
+++ b/.hark/changes/2020-06-11_remi_add-support-cartes.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Cartes Bancaires payments on `PaymentIntent` and `Pay…
+pr_url: https://github.com/stripe/stripe-java/pull/1043
+released_in_version: 19.22.0
+---
diff --git a/.hark/changes/2020-06-11_remi_multiple-api-changes.change.md b/.hark/changes/2020-06-11_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..976f9e87a7b
--- /dev/null
+++ b/.hark/changes/2020-06-11_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1044
+is_stripe_api_change: true
+released_in_version: 19.23.0
+---
+
+* Add `transaction` on Issuing `Dispute`
+* Add `payment_method_details[acss_debit][mandate]` on `Charge`
diff --git a/.hark/changes/2020-06-18_remi_multiple-api-changes.change.md b/.hark/changes/2020-06-18_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..478be343f29
--- /dev/null
+++ b/.hark/changes/2020-06-18_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1047
+is_stripe_api_change: true
+released_in_version: 19.24.0
+---
+
+* Add support for `refresh_url` and `return_url` on `AccountLink`
+* Add support for `issuing_dispute.*` events
diff --git a/.hark/changes/2020-06-23_remi_multiple-api-changes.change.md b/.hark/changes/2020-06-23_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..51ccdb83bff
--- /dev/null
+++ b/.hark/changes/2020-06-23_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1048
+is_stripe_api_change: true
+released_in_version: 19.25.0
+---
+
+* Add `discounts` on `LineItem`
+* Add `document_provider_identity_document` as a `purpose` on `File`
+* Support nullable `metadata` on Issuing `Dispute`
+* Add `klarna[shipping_delay]` on `Source`
diff --git a/.hark/changes/2020-06-24_remi_add-support-paymentmetho.change.md b/.hark/changes/2020-06-24_remi_add-support-paymentmetho.change.md
new file mode 100644
index 00000000000..885f0a5cca6
--- /dev/null
+++ b/.hark/changes/2020-06-24_remi_add-support-paymentmetho.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_method_data` on `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/1049
+released_in_version: 19.26.0
+---
diff --git a/.hark/changes/2020-06-25_remi_add-support-invoice.change.md b/.hark/changes/2020-06-25_remi_add-support-invoice.change.md
new file mode 100644
index 00000000000..bfe860c011e
--- /dev/null
+++ b/.hark/changes/2020-06-25_remi_add-support-invoice.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `invoice.paid` event
+pr_url: https://github.com/stripe/stripe-java/pull/1052
+released_in_version: 19.27.0
+---
diff --git a/.hark/changes/2020-07-13_cjavilla_multiple-api-changes.change.md b/.hark/changes/2020-07-13_cjavilla_multiple-api-changes.change.md
new file mode 100644
index 00000000000..e64ac37b739
--- /dev/null
+++ b/.hark/changes/2020-07-13_cjavilla_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1055
+is_stripe_api_change: true
+released_in_version: 19.28.0
+---
+
+* Adds `es-419` as a `locale` to Checkout `Session`
+* Adds `billing_cycle_anchor` to `default_settings` and `phases` for `SubscriptionSchedule`
diff --git a/.hark/changes/2020-07-16_remi_add-support-amounttotal.change.md b/.hark/changes/2020-07-16_remi_add-support-amounttotal.change.md
new file mode 100644
index 00000000000..aee6bbbdadd
--- /dev/null
+++ b/.hark/changes/2020-07-16_remi_add-support-amounttotal.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `amount_total`, `amount_subtotal`, `currency` and `total_details` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/1057
+released_in_version: 19.29.0
+---
diff --git a/.hark/changes/2020-07-16_remi_add-support-en.change.md b/.hark/changes/2020-07-16_remi_add-support-en.change.md
new file mode 100644
index 00000000000..5d18dac8d13
--- /dev/null
+++ b/.hark/changes/2020-07-16_remi_add-support-en.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `en-GB`, `fr-CA` and `id` as `locale` on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/1058
+released_in_version: 19.30.0
+---
diff --git a/.hark/changes/2020-07-17_remi_add-support-politicalexp.change.md b/.hark/changes/2020-07-17_remi_add-support-politicalexp.change.md
new file mode 100644
index 00000000000..2c65bbc71b1
--- /dev/null
+++ b/.hark/changes/2020-07-17_remi_add-support-politicalexp.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `political_exposure` on `Person`
+pr_url: https://github.com/stripe/stripe-java/pull/1062
+released_in_version: 19.32.0
+---
diff --git a/.hark/changes/2020-07-17_remi_multiple-api-changes.change.md b/.hark/changes/2020-07-17_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..5a0aa5b9fe9
--- /dev/null
+++ b/.hark/changes/2020-07-17_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1061
+is_stripe_api_change: true
+released_in_version: 19.31.0
+---
+
+* Add `deleted` on `LineItem`
+* Add support for `account_onboarding` and `account_update` as `type` on `AccountLink`
diff --git a/.hark/changes/2020-07-20_remi_add-support-capabilities.change.md b/.hark/changes/2020-07-20_remi_add-support-capabilities.change.md
new file mode 100644
index 00000000000..391ef3ffa1f
--- /dev/null
+++ b/.hark/changes/2020-07-20_remi_add-support-capabilities.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `capabilities` as a parameter on `Account` create and update
+pr_url: https://github.com/stripe/stripe-java/pull/1066
+released_in_version: 19.33.0
+---
diff --git a/.hark/changes/2020-07-22_remi_add-support-cartesbancai.change.md b/.hark/changes/2020-07-22_remi_add-support-cartesbancai.change.md
new file mode 100644
index 00000000000..83a5faa487c
--- /dev/null
+++ b/.hark/changes/2020-07-22_remi_add-support-cartesbancai.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `cartes_bancaires_payments` as a `Capability`
+pr_url: https://github.com/stripe/stripe-java/pull/1067
+released_in_version: 19.34.0
+---
diff --git a/.hark/changes/2020-07-25_remi_add-capabilities-fpxpayments.change.md b/.hark/changes/2020-07-25_remi_add-capabilities-fpxpayments.change.md
new file mode 100644
index 00000000000..c8dedfa1eab
--- /dev/null
+++ b/.hark/changes/2020-07-25_remi_add-capabilities-fpxpayments.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `capabilities[fpx_payments]` on `Account` create and update
+pr_url: https://github.com/stripe/stripe-java/pull/1068
+released_in_version: 19.35.0
+---
diff --git a/.hark/changes/2020-07-29_remi_multiple-api-changes.change.md b/.hark/changes/2020-07-29_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..d4eb388f4d5
--- /dev/null
+++ b/.hark/changes/2020-07-29_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1070
+is_stripe_api_change: true
+released_in_version: 19.36.0
+---
+
+* Add support for `id`, `invoice` and `invoice_item` on `Discount`
+* Add support for `discount_amounts` on `CreditNote`, `CreditNoteLineItem`, `InvoiceLineItem`
+* Add support for `discounts` on `InvoiceItem`, `InvoiceLineItem` and `Invoice`
+* Add support for `total_discount_amounts` on `Invoice`
diff --git a/.hark/changes/2020-07-30_richardm_socket-timeout-exceptions.change.md b/.hark/changes/2020-07-30_richardm_socket-timeout-exceptions.change.md
new file mode 100644
index 00000000000..08614f032ab
--- /dev/null
+++ b/.hark/changes/2020-07-30_richardm_socket-timeout-exceptions.change.md
@@ -0,0 +1,5 @@
+---
+title: Socket timeout exceptions are now also subject to retries
+pr_url: https://github.com/stripe/stripe-java/pull/1072
+released_in_version: 19.37.0
+---
diff --git a/.hark/changes/2020-07-31_richardm_support-setting-proxy.change.md b/.hark/changes/2020-07-31_richardm_support-setting-proxy.change.md
new file mode 100644
index 00000000000..8fa8c8180ef
--- /dev/null
+++ b/.hark/changes/2020-07-31_richardm_support-setting-proxy.change.md
@@ -0,0 +1,5 @@
+---
+title: Support setting "proxy" per-request
+pr_url: https://github.com/stripe/stripe-java/pull/1065
+released_in_version: 19.37.0
+---
diff --git a/.hark/changes/2020-08-04_remi_multiple-api-changes.change.md b/.hark/changes/2020-08-04_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..da86e3c3b4a
--- /dev/null
+++ b/.hark/changes/2020-08-04_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1076
+is_stripe_api_change: true
+released_in_version: 19.38.0
+---
+
+* Add `zh-HK` and `zh-TW` as `locale` on Checkout `Session`.
+* Add `payment_method_details[card_present][receipt][account_type]` on `Charge`
diff --git a/.hark/changes/2020-08-05_remi_multiple-api-changes.change.md b/.hark/changes/2020-08-05_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..81fc2b28604
--- /dev/null
+++ b/.hark/changes/2020-08-05_remi_multiple-api-changes.change.md
@@ -0,0 +1,12 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1077
+is_stripe_api_change: true
+released_in_version: 19.39.0
+---
+
+* Add support for the `PromotionCode` resource and APIs
+* Add support for `allow_promotion_codes` on Checkout `Session`
+* Add support for `applies_to[products]` on `Coupon`
+* Add support for `promotion_code` on `Customer` and `Subscription`
+* Add support for `promotion_code` on `Discount`
diff --git a/.hark/changes/2020-08-07_remi_add-support-alipay.change.md b/.hark/changes/2020-08-07_remi_add-support-alipay.change.md
new file mode 100644
index 00000000000..2e5bef52d85
--- /dev/null
+++ b/.hark/changes/2020-08-07_remi_add-support-alipay.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Alipay on `PaymentMethod` and `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/1078
+released_in_version: 19.40.0
+---
diff --git a/.hark/changes/2020-08-13_richardm_add-paymentmetho-acssdebit.change.md b/.hark/changes/2020-08-13_richardm_add-paymentmetho-acssdebit.change.md
new file mode 100644
index 00000000000..7ac791e66b5
--- /dev/null
+++ b/.hark/changes/2020-08-13_richardm_add-paymentmetho-acssdebit.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `payment_method_details[acss_debit][bank_name]` on `Charge`
+pr_url: https://github.com/stripe/stripe-java/pull/1081
+released_in_version: 19.41.0
+---
diff --git a/.hark/changes/2020-08-14_remi_add-support-alipay.change.md b/.hark/changes/2020-08-14_remi_add-support-alipay.change.md
new file mode 100644
index 00000000000..b26ca0ea780
--- /dev/null
+++ b/.hark/changes/2020-08-14_remi_add-support-alipay.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Alipay on Checkout `Session`
+pr_url: https://github.com/stripe/stripe-java/pull/1082
+released_in_version: 19.42.0
+---
diff --git a/.hark/changes/2020-08-17_remi_multiple-api-changes.change.md b/.hark/changes/2020-08-17_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..d29d932f97f
--- /dev/null
+++ b/.hark/changes/2020-08-17_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1083
+is_stripe_api_change: true
+released_in_version: 19.43.0
+---
+
+* Add `alipay` on `type` for the List PaymentMethods API
+* Add `payment_intent.requires_action` as a new `type` on `Event`
diff --git a/.hark/changes/2020-08-18_remi_add-support-amountdetail.change.md b/.hark/changes/2020-08-18_remi_add-support-amountdetail.change.md
new file mode 100644
index 00000000000..6f59e01da0b
--- /dev/null
+++ b/.hark/changes/2020-08-18_remi_add-support-amountdetail.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `amount_details` on Issuing `Authorization` and `Transaction`
+pr_url: https://github.com/stripe/stripe-java/pull/1084
+released_in_version: 19.44.0
+---
diff --git a/.hark/changes/2020-08-19_remi_add-support-expiresat.change.md b/.hark/changes/2020-08-19_remi_add-support-expiresat.change.md
new file mode 100644
index 00000000000..fb85a071ae5
--- /dev/null
+++ b/.hark/changes/2020-08-19_remi_add-support-expiresat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `expires_at` on `File`
+pr_url: https://github.com/stripe/stripe-java/pull/1085
+released_in_version: 19.45.0
+---
diff --git a/.hark/changes/2020-08-27_matthewling_fix-retrieval-upcoming.change.md b/.hark/changes/2020-08-27_matthewling_fix-retrieval-upcoming.change.md
new file mode 100644
index 00000000000..4b90c2a84ce
--- /dev/null
+++ b/.hark/changes/2020-08-27_matthewling_fix-retrieval-upcoming.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix retrieval of upcoming Invoice line items
+pr_url: https://github.com/stripe/stripe-java/pull/1087
+released_in_version: 20.0.0
+---
diff --git a/.hark/changes/2020-08-31_remi_add-support-paymentmetho.change.md b/.hark/changes/2020-08-31_remi_add-support-paymentmetho.change.md
new file mode 100644
index 00000000000..db5303f8d2d
--- /dev/null
+++ b/.hark/changes/2020-08-31_remi_add-support-paymentmetho.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `payment_method.automatically_updated` on `WebhookEndpoint`
+pr_url: https://github.com/stripe/stripe-java/pull/1089
+released_in_version: 20.1.0
+---
diff --git a/.hark/changes/2020-08-31_remi_multiple-api-changes.change.md b/.hark/changes/2020-08-31_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..134375eacc5
--- /dev/null
+++ b/.hark/changes/2020-08-31_remi_multiple-api-changes.change.md
@@ -0,0 +1,20 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1088
+is_stripe_api_change: true
+released_in_version: 20.0.0
+---
+
+* Pin to API version `2020-08-27`
+* Removed `authenticated` and `succeeded` on `payment_method_details[card][three_d_secure]` on `Charge`
+* Removed `tax_percent` and `prorate` across all Billing APIs
+* Renamed `plans` to `items` on `SubscriptionSchedule`
+* Removed `display_items` on Checkout `Session`
+* Removed `save_payment_method` and `source` on `PaymentIntent` confirm, create and update. Those parameters still work in the API but are removed from the library
+* Removed `payment_method_details[bitcoin]` on `Charge`
+* Removed `unified_proration` on Billing API as this is a deprecated feature that never shipped publicly
+* Removed `plan` and `quantity` from `Subscription`, use `items` instead
+* Removed `requested_capabilities` on `Account` creation, use `capabilities` instead
+* Removed `failure_url` and `success_url` from `AccountLink`, use `refresh_url` and `return_url` instead
+* Removed `invoice.payment_succeeded` and `payment_method.card_automatically_updated` events
+* `sources` and `tax_ids` on `Customer` are now includable sub-lists and not returned by default when retrieving a customer. You need to explicitly expand those properties to call `getTaxIds()` or `getSources()` now to create those sub-resources. Our API Reference has been updated to reflect this.
diff --git a/.hark/changes/2020-09-02_remi_multiple-api-changes.change.md b/.hark/changes/2020-09-02_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..f8a2cb59504
--- /dev/null
+++ b/.hark/changes/2020-09-02_remi_multiple-api-changes.change.md
@@ -0,0 +1,11 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1092
+is_stripe_api_change: true
+released_in_version: 20.2.0
+---
+
+* Improve support for the Issuing `Dispute` APIs. Added the Submit API, missing parameters on creation, update and list and returned evidence details
+* Add support for `dispute` on Issuing `Transaction`
+* Add `available_payout_methods` on `BankAccount`
+* Add `payment_status` on Checkout `Session`
diff --git a/.hark/changes/2020-09-08_remi_add-support-sofort.change.md b/.hark/changes/2020-09-08_remi_add-support-sofort.change.md
new file mode 100644
index 00000000000..493c6a90819
--- /dev/null
+++ b/.hark/changes/2020-09-08_remi_add-support-sofort.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Sofort on `PaymentMethod` and `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/1096
+released_in_version: 20.3.0
+---
diff --git a/.hark/changes/2020-09-09_remi_multiple-api-changes.change.md b/.hark/changes/2020-09-09_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..e941b9f7fa1
--- /dev/null
+++ b/.hark/changes/2020-09-09_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1098
+is_stripe_api_change: true
+released_in_version: 20.4.0
+---
+
+* Add support for `sofort` as a `type` on the List PaymentMethods API
+* Add back support for `invoice.payment_succeeded`
diff --git a/.hark/changes/2020-09-09_suz_oauth-deauthorize-longer.change.md b/.hark/changes/2020-09-09_suz_oauth-deauthorize-longer.change.md
new file mode 100644
index 00000000000..122184dd7fe
--- /dev/null
+++ b/.hark/changes/2020-09-09_suz_oauth-deauthorize-longer.change.md
@@ -0,0 +1,5 @@
+---
+title: OAuth.deauthorize no longer mutates params
+pr_url: https://github.com/stripe/stripe-java/pull/1095
+released_in_version: 20.3.1
+---
diff --git a/.hark/changes/2020-09-09_unknown_increase-delaybetween-deploy.change.md b/.hark/changes/2020-09-09_unknown_increase-delaybetween-deploy.change.md
new file mode 100644
index 00000000000..eb40b25abd8
--- /dev/null
+++ b/.hark/changes/2020-09-09_unknown_increase-delaybetween-deploy.change.md
@@ -0,0 +1,4 @@
+---
+title: Increase `delayBetweenRetriesInMillis` deploy property from default of 2000 to 4000 to help mitigate close timeouts
+released_in_version: 20.3.2
+---
diff --git a/.hark/changes/2020-09-10_remi_add-support-sepa.change.md b/.hark/changes/2020-09-10_remi_add-support-sepa.change.md
new file mode 100644
index 00000000000..c64681a10e6
--- /dev/null
+++ b/.hark/changes/2020-09-10_remi_add-support-sepa.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for SEPA debit on Checkout
+pr_url: https://github.com/stripe/stripe-java/pull/1099
+released_in_version: 20.5.0
+---
diff --git a/.hark/changes/2020-09-13_remi_add-support-promotioncod.change.md b/.hark/changes/2020-09-13_remi_add-support-promotioncod.change.md
new file mode 100644
index 00000000000..55d4400aa27
--- /dev/null
+++ b/.hark/changes/2020-09-13_remi_add-support-promotioncod.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `promotion_code.created` and `promotion_code.updated` on `Event`
+pr_url: https://github.com/stripe/stripe-java/pull/1102
+released_in_version: 20.6.0
+---
diff --git a/.hark/changes/2020-09-21_remi_multiple-api-changes.change.md b/.hark/changes/2020-09-21_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..27a4f48222b
--- /dev/null
+++ b/.hark/changes/2020-09-21_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1106
+is_stripe_api_change: true
+released_in_version: 20.7.0
+---
+
+* Add support for `amount_captured` on `Charge`
+* Add `checkout_session` on `Discount`
diff --git a/.hark/changes/2020-09-23_remi_multiple-api-changes.change.md b/.hark/changes/2020-09-23_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..74dbee49dd6
--- /dev/null
+++ b/.hark/changes/2020-09-23_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1109
+is_stripe_api_change: true
+released_in_version: 20.8.0
+---
+
+* Add support for `issuing_dispute.closed` and `issuing_dispute.submitted` events
+* Add support for `instant_available` on `Balance`
diff --git a/.hark/changes/2020-09-25_ctrudeau_add-support-oxxo.change.md b/.hark/changes/2020-09-25_ctrudeau_add-support-oxxo.change.md
new file mode 100644
index 00000000000..e3a34d9995f
--- /dev/null
+++ b/.hark/changes/2020-09-25_ctrudeau_add-support-oxxo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for OXXO on `PaymentMethod` and `PaymentIntent`
+pr_url: https://github.com/stripe/stripe-java/pull/1112
+released_in_version: 20.9.0
+---
diff --git a/.hark/changes/2020-09-25_remi_add-support-oxxo.change.md b/.hark/changes/2020-09-25_remi_add-support-oxxo.change.md
new file mode 100644
index 00000000000..04756ead0d2
--- /dev/null
+++ b/.hark/changes/2020-09-25_remi_add-support-oxxo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `oxxo` as a valid `type` on the List PaymentMethod API
+pr_url: https://github.com/stripe/stripe-java/pull/1113
+released_in_version: 20.10.0
+---
diff --git a/.hark/changes/2020-09-29_remi_add-support-contribution.change.md b/.hark/changes/2020-09-29_remi_add-support-contribution.change.md
new file mode 100644
index 00000000000..6c76479c501
--- /dev/null
+++ b/.hark/changes/2020-09-29_remi_add-support-contribution.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `contribution` in `reporting_category` on `ReportRun`
+pr_url: https://github.com/stripe/stripe-java/pull/1117
+released_in_version: 20.12.0
+---
diff --git a/.hark/changes/2020-09-29_remi_add-support-oxxopayments.change.md b/.hark/changes/2020-09-29_remi_add-support-oxxopayments.change.md
new file mode 100644
index 00000000000..67d0ada92da
--- /dev/null
+++ b/.hark/changes/2020-09-29_remi_add-support-oxxopayments.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `oxxo_payments` capability on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1116
+released_in_version: 20.11.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 00000000000..eb241fd6c0f
--- /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-java/pull/1118
+released_in_version: 20.13.0
+---
diff --git a/.hark/changes/2020-10-02_remi_add-support-new.change.md b/.hark/changes/2020-10-02_remi_add-support-new.change.md
new file mode 100644
index 00000000000..ab5513a7c6e
--- /dev/null
+++ b/.hark/changes/2020-10-02_remi_add-support-new.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for new payments capabilities on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1119
+released_in_version: 20.14.0
+---
diff --git a/.hark/changes/2020-10-02_remi_add-support-tosacceptanc.change.md b/.hark/changes/2020-10-02_remi_add-support-tosacceptanc.change.md
new file mode 100644
index 00000000000..63057ad1474
--- /dev/null
+++ b/.hark/changes/2020-10-02_remi_add-support-tosacceptanc.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `TosAcceptance.ServiceAgreement` on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1120
+released_in_version: 20.14.0
+---
diff --git a/.hark/changes/2020-10-08_unknown_add-support-generatedfro.change.md b/.hark/changes/2020-10-08_unknown_add-support-generatedfro.change.md
new file mode 100644
index 00000000000..35fa53267c1
--- /dev/null
+++ b/.hark/changes/2020-10-08_unknown_add-support-generatedfro.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for `generated_from` on `PaymentMethod.sepa_debit`
+released_in_version: 20.15.0
+---
diff --git a/.hark/changes/2020-10-08_unknown_add-support-generatedsep.change.md b/.hark/changes/2020-10-08_unknown_add-support-generatedsep.change.md
new file mode 100644
index 00000000000..7bb09f6b875
--- /dev/null
+++ b/.hark/changes/2020-10-08_unknown_add-support-generatedsep.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for `generated_sepa_debit` and `generated_sepa_debit_mandate` on `Charge.payment_method_details.ideal`, `Charge.payment_method_details.bancontact` and `Charge.payment_method_details.sofort`
+released_in_version: 20.15.0
+---
diff --git a/.hark/changes/2020-10-08_unknown_add-support-ideal.change.md b/.hark/changes/2020-10-08_unknown_add-support-ideal.change.md
new file mode 100644
index 00000000000..db28177dbfe
--- /dev/null
+++ b/.hark/changes/2020-10-08_unknown_add-support-ideal.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for `ideal`, `bancontact` and `sofort` on `SetupAttempt.payment_method_details`
+released_in_version: 20.15.0
+---
diff --git a/.hark/changes/2020-10-09_richardm_add-support-internal.change.md b/.hark/changes/2020-10-09_richardm_add-support-internal.change.md
new file mode 100644
index 00000000000..55e4c0a89d7
--- /dev/null
+++ b/.hark/changes/2020-10-09_richardm_add-support-internal.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for internal-only `description`, `iin`, and `issuer` for `card_present` and `interac_present` on `Charge.payment_method_details`.
+pr_url: https://github.com/stripe/stripe-java/pull/1126
+released_in_version: 20.16.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 00000000000..4d8d807b19d
--- /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-java/pull/1129
+released_in_version: 20.18.0
+---
diff --git a/.hark/changes/2020-10-14_richardm_add-support-discounts.change.md b/.hark/changes/2020-10-14_richardm_add-support-discounts.change.md
new file mode 100644
index 00000000000..405f41e30ba
--- /dev/null
+++ b/.hark/changes/2020-10-14_richardm_add-support-discounts.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `discounts` to SessionCreateParams
+pr_url: https://github.com/stripe/stripe-java/pull/1130
+released_in_version: 20.19.0
+---
diff --git a/.hark/changes/2020-10-20_remi_add-support-jprn.change.md b/.hark/changes/2020-10-20_remi_add-support-jprn.change.md
new file mode 100644
index 00000000000..a5d49db4891
--- /dev/null
+++ b/.hark/changes/2020-10-20_remi_add-support-jprn.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `jp_rn` and `ru_kpp` as a `type` on `TaxId`
+pr_url: https://github.com/stripe/stripe-java/pull/1133
+released_in_version: 20.20.0
+---
diff --git a/.hark/changes/2020-10-21_ob_bump-spotless-plugin.change.md b/.hark/changes/2020-10-21_ob_bump-spotless-plugin.change.md
new file mode 100644
index 00000000000..4f404bffb08
--- /dev/null
+++ b/.hark/changes/2020-10-21_ob_bump-spotless-plugin.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump Spotless plugin version
+pr_url: https://github.com/stripe/stripe-java/pull/1137
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-21_ob_fix-deprecation-warning.change.md b/.hark/changes/2020-10-21_ob_fix-deprecation-warning.change.md
new file mode 100644
index 00000000000..6a4aaac81e9
--- /dev/null
+++ b/.hark/changes/2020-10-21_ob_fix-deprecation-warning.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix deprecation warning in test file
+pr_url: https://github.com/stripe/stripe-java/pull/1135
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-22_ob_bump-errorprone-latest.change.md b/.hark/changes/2020-10-22_ob_bump-errorprone-latest.change.md
new file mode 100644
index 00000000000..52c787fb46b
--- /dev/null
+++ b/.hark/changes/2020-10-22_ob_bump-errorprone-latest.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump ErrorProne to latest version
+pr_url: https://github.com/stripe/stripe-java/pull/1138
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-22_ob_upgrade-gradle-6.change.md b/.hark/changes/2020-10-22_ob_upgrade-gradle-6.change.md
new file mode 100644
index 00000000000..0ae3bc571c3
--- /dev/null
+++ b/.hark/changes/2020-10-22_ob_upgrade-gradle-6.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Gradle to 6.7
+pr_url: https://github.com/stripe/stripe-java/pull/1134
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-22_ob_upgrade-lombok-plugin.change.md b/.hark/changes/2020-10-22_ob_upgrade-lombok-plugin.change.md
new file mode 100644
index 00000000000..2613cf6b534
--- /dev/null
+++ b/.hark/changes/2020-10-22_ob_upgrade-lombok-plugin.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Lombok plugin
+pr_url: https://github.com/stripe/stripe-java/pull/1139
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-23_remi_add-support-passing.change.md b/.hark/changes/2020-10-23_remi_add-support-passing.change.md
new file mode 100644
index 00000000000..5c8294c0442
--- /dev/null
+++ b/.hark/changes/2020-10-23_remi_add-support-passing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for passing `p24[bank]` for P24 on `PaymentIntent` or `PaymentMethod`
+pr_url: https://github.com/stripe/stripe-java/pull/1142
+released_in_version: 20.22.0
+---
diff --git a/.hark/changes/2020-10-23_remi_support-passing-taxrates.change.md b/.hark/changes/2020-10-23_remi_support-passing-taxrates.change.md
new file mode 100644
index 00000000000..21776e980c0
--- /dev/null
+++ b/.hark/changes/2020-10-23_remi_support-passing-taxrates.change.md
@@ -0,0 +1,5 @@
+---
+title: Support passing `tax_rates` when creating invoice items through `Subscription` or `SubscriptionSchedule`
+pr_url: https://github.com/stripe/stripe-java/pull/1141
+released_in_version: 20.21.0
+---
diff --git a/.hark/changes/2020-10-26_remi_multiple-api-changes.change.md b/.hark/changes/2020-10-26_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..076f07ab6d7
--- /dev/null
+++ b/.hark/changes/2020-10-26_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1143
+is_stripe_api_change: true
+released_in_version: 20.23.0
+---
+
+* Add support for `payment_method_options[card][cvc_token]` on `PaymentIntent`
+* Add support for `cvc_update[cvc]` on `Token` creation
diff --git a/.hark/changes/2020-10-27_remi_add-paymentmetho-interacprese.change.md b/.hark/changes/2020-10-27_remi_add-paymentmetho-interacprese.change.md
new file mode 100644
index 00000000000..6c8405b87a5
--- /dev/null
+++ b/.hark/changes/2020-10-27_remi_add-paymentmetho-interacprese.change.md
@@ -0,0 +1,5 @@
+---
+title: Add  `payment_method_details[interac_present][preferred_locales]` on `Charge`
+pr_url: https://github.com/stripe/stripe-java/pull/1144
+released_in_version: 20.24.0
+---
diff --git a/.hark/changes/2020-11-04_remi_add-support-company.change.md b/.hark/changes/2020-11-04_remi_add-support-company.change.md
new file mode 100644
index 00000000000..850f7db4148
--- /dev/null
+++ b/.hark/changes/2020-11-04_remi_add-support-company.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `company[registration_number]` on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1147
+released_in_version: 20.25.0
+---
diff --git a/.hark/changes/2020-11-09_remi_add-invoice-finalization.change.md b/.hark/changes/2020-11-09_remi_add-invoice-finalization.change.md
new file mode 100644
index 00000000000..7f74abb967e
--- /dev/null
+++ b/.hark/changes/2020-11-09_remi_add-invoice-finalization.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `invoice.finalization_error` as a `type` on `Event`
+pr_url: https://github.com/stripe/stripe-java/pull/1149
+released_in_version: 20.26.0
+---
diff --git a/.hark/changes/2020-11-09_remi_multiple-api-changes.change.md b/.hark/changes/2020-11-09_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..9ce16c31c08
--- /dev/null
+++ b/.hark/changes/2020-11-09_remi_multiple-api-changes.change.md
@@ -0,0 +1,10 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1148
+is_stripe_api_change: true
+released_in_version: 20.26.0
+---
+
+* Add support for `last_finalization_error` on `Invoice`
+* Add support for deserializing Issuing `Dispute` as a `source` on `BalanceTransaction`
+* Add support for `payment_method_type` on `StripeError` used by other API resources
diff --git a/.hark/changes/2020-11-17_ctrudeau_multiple-api-changes.change.md b/.hark/changes/2020-11-17_ctrudeau_multiple-api-changes.change.md
new file mode 100644
index 00000000000..aae395d2628
--- /dev/null
+++ b/.hark/changes/2020-11-17_ctrudeau_multiple-api-changes.change.md
@@ -0,0 +1,8 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1152
+is_stripe_api_change: true
+released_in_version: 20.27.0
+---
+
+* Add support for sepa_debit on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntentConfirmParams.
diff --git a/.hark/changes/2020-11-17_unknown_identical-7-29.change.md b/.hark/changes/2020-11-17_unknown_identical-7-29.change.md
new file mode 100644
index 00000000000..f684c51ee2a
--- /dev/null
+++ b/.hark/changes/2020-11-17_unknown_identical-7-29.change.md
@@ -0,0 +1,4 @@
+---
+title: Identical to 7.29.0
+released_in_version: 7.63.1
+---
diff --git a/.hark/changes/2020-11-17_unknown_published-error-do.change.md b/.hark/changes/2020-11-17_unknown_published-error-do.change.md
new file mode 100644
index 00000000000..73e629e3f71
--- /dev/null
+++ b/.hark/changes/2020-11-17_unknown_published-error-do.change.md
@@ -0,0 +1,4 @@
+---
+title: Published in error. Do not use. This is identical to 20.27.0.
+released_in_version: 7.63.0
+---
diff --git a/.hark/changes/2020-11-18_richardm_add-support-grabpay.change.md b/.hark/changes/2020-11-18_richardm_add-support-grabpay.change.md
new file mode 100644
index 00000000000..4f01404e4f2
--- /dev/null
+++ b/.hark/changes/2020-11-18_richardm_add-support-grabpay.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `grabpay` on `PaymentMethod`.
+pr_url: https://github.com/stripe/stripe-java/pull/1154
+released_in_version: 20.28.0
+---
diff --git a/.hark/changes/2020-11-19_richardm_add-support-mandateoptio.change.md b/.hark/changes/2020-11-19_richardm_add-support-mandateoptio.change.md
new file mode 100644
index 00000000000..00c040681c8
--- /dev/null
+++ b/.hark/changes/2020-11-19_richardm_add-support-mandateoptio.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `mandate_options` on `SetupIntent.payment_method_options.sepa_debit`
+pr_url: https://github.com/stripe/stripe-java/pull/1156
+released_in_version: 20.29.0
+---
diff --git a/.hark/changes/2020-11-20_remi_add-support-capabilities.change.md b/.hark/changes/2020-11-20_remi_add-support-capabilities.change.md
new file mode 100644
index 00000000000..e2f541a053f
--- /dev/null
+++ b/.hark/changes/2020-11-20_remi_add-support-capabilities.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `capabilities[grabpay_payments]` on `Account`
+pr_url: https://github.com/stripe/stripe-java/pull/1157
+released_in_version: 20.29.0
+---
diff --git a/.hark/changes/2020-11-24_remi_better-log-error.change.md b/.hark/changes/2020-11-24_remi_better-log-error.change.md
new file mode 100644
index 00000000000..2cf917932e3
--- /dev/null
+++ b/.hark/changes/2020-11-24_remi_better-log-error.change.md
@@ -0,0 +1,5 @@
+---
+title: Better log the error causing the JSON parsing to fail on deserialization
+pr_url: https://github.com/stripe/stripe-java/pull/1158
+released_in_version: 20.30.0
+---
diff --git a/.hark/changes/2020-11-24_remi_multiple-api-changes.change.md b/.hark/changes/2020-11-24_remi_multiple-api-changes.change.md
new file mode 100644
index 00000000000..9026f838e2b
--- /dev/null
+++ b/.hark/changes/2020-11-24_remi_multiple-api-changes.change.md
@@ -0,0 +1,9 @@
+---
+title: Multiple API changes
+pr_url: https://github.com/stripe/stripe-java/pull/1159
+is_stripe_api_change: true
+released_in_version: 20.30.0
+---
+
+* Add support for `account_tax_ids` on `Invoice`
+* Add support for `payment_method_options[sepa_debit]` on `PaymentIntent`
diff --git a/.hark/changes/2020-12-04_remi_add-support-documents.change.md b/.hark/changes/2020-12-04_remi_add-support-documents.change.md
new file mode 100644
index 00000000000..4db37744422
--- /dev/null
+++ b/.hark/changes/2020-12-04_remi_add-support-documents.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `documents` on `Account` create and update
+pr_url: https://github.com/stripe/stripe-java/pull/1161
+released_in_version: 20.31.0
+---
diff --git a/.hark/changes/2020-12-11_ctrudeau_codegen-multiple-api.change.md b/.hark/changes/2020-12-11_ctrudeau_codegen-multiple-api.change.md
new file mode 100644
index 00000000000..dfd262e1d79
--- /dev/null
+++ b/.hark/changes/2020-12-11_ctrudeau_codegen-multiple-api.change.md
@@ -0,0 +1,8 @@
+---
+title: "[codegen] Multiple API changes"
+pr_url: https://github.com/stripe/stripe-java/pull/1163
+released_in_version: 20.32.0
+---
+
+* Add support for `bank` on `PaymentMethod`
+* Add support for `tos_shown_and_accepted` to `payment_method_options[p24]` on `PaymentMethod`.
diff --git a/.hark/changes/2020-12-15_suz_pass-mutated-copy.change.md b/.hark/changes/2020-12-15_suz_pass-mutated-copy.change.md
new file mode 100644
index 00000000000..223ccdd0d77
--- /dev/null
+++ b/.hark/changes/2020-12-15_suz_pass-mutated-copy.change.md
@@ -0,0 +1,5 @@
+---
+title: Pass mutated copy of params into oauth request
+pr_url: https://github.com/stripe/stripe-java/pull/1162
+released_in_version: 20.33.0
+---
diff --git a/.hark/changes/2020-12-16_ctrudeau_api-updates.change.md b/.hark/changes/2020-12-16_ctrudeau_api-updates.change.md
new file mode 100644
index 00000000000..bbd9f53c9aa
--- /dev/null
+++ b/.hark/changes/2020-12-16_ctrudeau_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1165
+is_stripe_api_change: true
+released_in_version: 20.33.0
+---
+
+* Add support for card_present on SetupAttempt.payment_method_details
diff --git a/.hark/changes/2021-01-04_ctrudeau_adding-getusermessa-exceptions.change.md b/.hark/changes/2021-01-04_ctrudeau_adding-getusermessa-exceptions.change.md
new file mode 100644
index 00000000000..030e7606d05
--- /dev/null
+++ b/.hark/changes/2021-01-04_ctrudeau_adding-getusermessa-exceptions.change.md
@@ -0,0 +1,5 @@
+---
+title: Adding getUserMessage() to exceptions
+pr_url: https://github.com/stripe/stripe-java/pull/1167
+released_in_version: 20.34.0
+---
diff --git a/.hark/changes/2021-01-07_ctrudeau_api-updates.change.md b/.hark/changes/2021-01-07_ctrudeau_api-updates.change.md
new file mode 100644
index 00000000000..a6f3ba18209
--- /dev/null
+++ b/.hark/changes/2021-01-07_ctrudeau_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1169
+is_stripe_api_change: true
+released_in_version: 20.34.0
+---
+
+* Add support for `company_registration_verification`, `company_ministerial_decree`, `company_memorandum_of_association`, `company_license` and `company_tax_id_verification` on `AccountUpdateParams.documents` and `AccountCreateParams.documents`
diff --git a/.hark/changes/2021-01-15_richardm_api-updates.change.md b/.hark/changes/2021-01-15_richardm_api-updates.change.md
new file mode 100644
index 00000000000..d191bb80cfb
--- /dev/null
+++ b/.hark/changes/2021-01-15_richardm_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1171
+is_stripe_api_change: true
+released_in_version: 20.35.0
+---
+
+* Add support for `dynamic_tax_rates` on `SessionCreateParams.line_items[]`
+* Add support for `customer_details` on `Checkout.Session`
+* Add support for `type` on `TransactionListParams`
+* Add support for `country` and `state` on `TaxRateUpdateParams`, `TaxRateCreateParams` and `TaxRate`
diff --git a/.hark/changes/2021-01-23_cjavilla_add-link-youtube.change.md b/.hark/changes/2021-01-23_cjavilla_add-link-youtube.change.md
new file mode 100644
index 00000000000..c03f828129a
--- /dev/null
+++ b/.hark/changes/2021-01-23_cjavilla_add-link-youtube.change.md
@@ -0,0 +1,5 @@
+---
+title: Add link to YouTube from readme
+pr_url: https://github.com/stripe/stripe-java/pull/1173
+released_in_version: 20.36.0
+---
diff --git a/.hark/changes/2021-02-03_richardm_update-generated-code.change.md b/.hark/changes/2021-02-03_richardm_update-generated-code.change.md
new file mode 100644
index 00000000000..64efafa705d
--- /dev/null
+++ b/.hark/changes/2021-02-03_richardm_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1179
+released_in_version: 20.36.0
+---
+
+* Add support for `nationality` on `Person`, `PersonUpdateParams`, `PersonCreateParams` and `TokenCreateParams.person`
+* Add `gb_vat` to `TaxId.type` enum
diff --git a/.hark/changes/2021-02-09_richardm_api-updates.change.md b/.hark/changes/2021-02-09_richardm_api-updates.change.md
new file mode 100644
index 00000000000..84109b6f354
--- /dev/null
+++ b/.hark/changes/2021-02-09_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1182
+is_stripe_api_change: true
+released_in_version: 20.37.0
+---
+
+* Add support for `afterpay_clearpay_payments` on `Account.capabilities`
+* Add support for `payment_settings` on `Invoice`
diff --git a/.hark/changes/2021-02-10_richardm_accept-all-inputstreams.change.md b/.hark/changes/2021-02-10_richardm_accept-all-inputstreams.change.md
new file mode 100644
index 00000000000..b64f9d6ccb6
--- /dev/null
+++ b/.hark/changes/2021-02-10_richardm_accept-all-inputstreams.change.md
@@ -0,0 +1,5 @@
+---
+title: Accept all InputStreams for FileCreateParams.setFile
+pr_url: https://github.com/stripe/stripe-java/pull/1180
+released_in_version: 20.38.0
+---
diff --git a/.hark/changes/2021-02-17_richardm_api-updates.change.md b/.hark/changes/2021-02-17_richardm_api-updates.change.md
new file mode 100644
index 00000000000..bf16f5e1456
--- /dev/null
+++ b/.hark/changes/2021-02-17_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1186
+is_stripe_api_change: true
+released_in_version: 20.40.0
+---
+
+* Add support for `on_behalf_of` to `Invoice`
+* Add support `revolut` as an enum member on `PaymentMethodCreateParams.Ideal.Bank`, `PaymentIntentConfirmParams.Ideal.Bank`, `PaymentIntentUpdateParams.Ideal.Bank`, and `PaymentIntentCreateParams.Ideal.Bank`
diff --git a/.hark/changes/2021-02-17_richardm_api-updates_2.change.md b/.hark/changes/2021-02-17_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..3d267e72b7a
--- /dev/null
+++ b/.hark/changes/2021-02-17_richardm_api-updates_2.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1185
+is_stripe_api_change: true
+released_in_version: 20.39.0
+---
+
+* Add support for `afterpay_clearpay` on `PaymentMethod`, `PaymentIntent.payment_method_data`, and `Charge.payment_method_details`.
+* Add support for `afterpay_clearpay` as a payment method type on `PaymentMethod.type`, `PaymentIntent.PaymentMethodData.type`, and `Checkout.SessionCreateParams.payment_method_types`.
+* Add support for `adjustable_quantity` on `SessionCreateParams.LineItem`
+* Add support for `bacs_debit`, `au_becs_debit` and `sepa_debit` on `SetupAttempt.payment_method_details`
diff --git a/.hark/changes/2021-02-22_richardm_api-updates.change.md b/.hark/changes/2021-02-22_richardm_api-updates.change.md
new file mode 100644
index 00000000000..4439862ce8a
--- /dev/null
+++ b/.hark/changes/2021-02-22_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1187
+is_stripe_api_change: true
+released_in_version: 20.41.0
+---
+
+* Add support for Billing Portal Configuration API
diff --git a/.hark/changes/2021-03-22_richardm_api-updates.change.md b/.hark/changes/2021-03-22_richardm_api-updates.change.md
new file mode 100644
index 00000000000..ee949a0323f
--- /dev/null
+++ b/.hark/changes/2021-03-22_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1189
+is_stripe_api_change: true
+released_in_version: 20.42.0
+---
+
+* Add support for `shipping_rates` on `Checkout.SessionCreateParams`
+* Add support for `amount_shipping` on `Checkout.Session.total_details`
diff --git a/.hark/changes/2021-03-25_richardm_api-updates.change.md b/.hark/changes/2021-03-25_richardm_api-updates.change.md
new file mode 100644
index 00000000000..b612342e49f
--- /dev/null
+++ b/.hark/changes/2021-03-25_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1191
+is_stripe_api_change: true
+released_in_version: 20.43.0
+---
+
+* Add support for new locale `th` on `SessionCreateParams`.
diff --git a/.hark/changes/2021-03-26_richardm_api-updates.change.md b/.hark/changes/2021-03-26_richardm_api-updates.change.md
new file mode 100644
index 00000000000..147643b3ef6
--- /dev/null
+++ b/.hark/changes/2021-03-26_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1192
+is_stripe_api_change: true
+released_in_version: 20.44.0
+---
+
+* Add support for `card_issuing` on `AccountCreateParams.settings`, `AccountUpdateParams.settings` and `Account.settings`
diff --git a/.hark/changes/2021-03-31_richardm_api-updates.change.md b/.hark/changes/2021-03-31_richardm_api-updates.change.md
new file mode 100644
index 00000000000..72006105a87
--- /dev/null
+++ b/.hark/changes/2021-03-31_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1193
+is_stripe_api_change: true
+released_in_version: 20.45.0
+---
+
+* Add support for `transfer_data` on `Checkout.SessionCreateParams.subscription_data`
diff --git a/.hark/changes/2021-04-02_richardm_api-updates.change.md b/.hark/changes/2021-04-02_richardm_api-updates.change.md
new file mode 100644
index 00000000000..8078ea7880e
--- /dev/null
+++ b/.hark/changes/2021-04-02_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1194
+is_stripe_api_change: true
+released_in_version: 20.46.0
+---
+
+* Add support for `subscription_pause` on `BillingPortal.ConfigurationUpdateParams.features`, `BillingPortalCreateParams.features` and `BillingPortal.Configuration.features`
diff --git a/.hark/changes/2021-04-12_richardm_add-support-acss.change.md b/.hark/changes/2021-04-12_richardm_add-support-acss.change.md
new file mode 100644
index 00000000000..16f1d8ebf65
--- /dev/null
+++ b/.hark/changes/2021-04-12_richardm_add-support-acss.change.md
@@ -0,0 +1,12 @@
+---
+title: Add support for ACSS Debit
+pr_url: https://github.com/stripe/stripe-java/pull/1195
+is_stripe_api_change: true
+released_in_version: 20.47.0
+---
+
+* Add support for `acss_debit_payments` on `Account.capabilities`
+* Add support for `payment_method_options` on `Checkout.Session`
+* Add support for `acss_debit` on `SetupIntent.payment_method_options`, `SetupAttempt.payment_method_details`, `PaymentMethod`, `PaymentIntent.payment_method_options`,  `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `Mandate.payment_method_details` and `SetupIntent.payment_method_options`
+* Add support for `verify_with_microdeposits` on `PaymentIntent.next_action` and `SetupIntent.next_action`
+* Add support for `acss_debit` as member of the `type` enum on `PaymentMethod` and `PaymentIntent`, and inside `Checkout.SessionCreateParams.payment_method_types[]`.
diff --git a/.hark/changes/2021-04-22_richardm_fix-gson-error.change.md b/.hark/changes/2021-04-22_richardm_fix-gson-error.change.md
new file mode 100644
index 00000000000..d54667e9aff
--- /dev/null
+++ b/.hark/changes/2021-04-22_richardm_fix-gson-error.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix GSON error in JDK16 (#1190) by marking RequestOptions transient"
+pr_url: https://github.com/stripe/stripe-java/pull/1197
+released_in_version: 20.47.1
+---
diff --git a/.hark/changes/2021-05-05_richardm_api-updates.change.md b/.hark/changes/2021-05-05_richardm_api-updates.change.md
new file mode 100644
index 00000000000..550f337390e
--- /dev/null
+++ b/.hark/changes/2021-05-05_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1202
+is_stripe_api_change: true
+released_in_version: 20.49.0
+---
+
+* Add support for `payment_intent` on `EarlyFraudWarning`
diff --git a/.hark/changes/2021-05-05_richardm_api-updates_2.change.md b/.hark/changes/2021-05-05_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..6b20508c809
--- /dev/null
+++ b/.hark/changes/2021-05-05_richardm_api-updates_2.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1201
+is_stripe_api_change: true
+released_in_version: 20.48.0
+---
+
+* Add support for `card_present` on `PaymentIntent.payment_method_options`
+* Add support for `default_incomplete` as a `payment_behavior` on `SubscriptionItemCreateParams`, `SubscriptionUpdateParams`, and `SubscriptionCreateParams`.
+* Add support for `single_member_llc` as a `structure` on `AccountCreateParams.company` and `AccountUpdateParams.company`.
diff --git a/.hark/changes/2021-05-06_richardm_api-updates.change.md b/.hark/changes/2021-05-06_richardm_api-updates.change.md
new file mode 100644
index 00000000000..fb1e285d660
--- /dev/null
+++ b/.hark/changes/2021-05-06_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1204
+is_stripe_api_change: true
+released_in_version: 20.50.0
+---
+
+* Add support for `reference` on `Charge.payment_method_details.afterpay_clearpay`
+* Add support for `afterpay_clearpay` on `PaymentIntent.payment_method_options`
diff --git a/.hark/changes/2021-05-06_richardm_fix-flaky-test.change.md b/.hark/changes/2021-05-06_richardm_fix-flaky-test.change.md
new file mode 100644
index 00000000000..2d51cf63901
--- /dev/null
+++ b/.hark/changes/2021-05-06_richardm_fix-flaky-test.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix flaky test: no telemetry by default in test suite"
+pr_url: https://github.com/stripe/stripe-java/pull/1203
+released_in_version: 20.50.0
+---
diff --git a/.hark/changes/2021-05-11_richardm_api-updates.change.md b/.hark/changes/2021-05-11_richardm_api-updates.change.md
new file mode 100644
index 00000000000..d6e249173db
--- /dev/null
+++ b/.hark/changes/2021-05-11_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1206
+is_stripe_api_change: true
+released_in_version: 20.51.0
+---
+
+* Add support for setting `AccountUpdateParams.business_profile.support_url` and `AccountCreateParams.support_url` to `EmptyParam`.
diff --git a/.hark/changes/2021-05-20_richardm_1205-api-updates.change.md b/.hark/changes/2021-05-20_richardm_1205-api-updates.change.md
new file mode 100644
index 00000000000..b32bb801ce4
--- /dev/null
+++ b/.hark/changes/2021-05-20_richardm_1205-api-updates.change.md
@@ -0,0 +1,7 @@
+---
+title: ", [#1205](https://github.com/stripe/stripe-java/pull/1205) API Updates"
+pr_url: https://github.com/stripe/stripe-java/pull/1211
+released_in_version: 20.51.0
+---
+
+* Add support for the `Identity.VerificationSession` and `Identity.VerificationReport` APIs.
diff --git a/.hark/changes/2021-05-26_dcr_api-updates.change.md b/.hark/changes/2021-05-26_dcr_api-updates.change.md
new file mode 100644
index 00000000000..b12e319d74b
--- /dev/null
+++ b/.hark/changes/2021-05-26_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1212
+is_stripe_api_change: true
+released_in_version: 20.52.0
+---
+
+* Added support for `documents` on `PersonUpdateParams`, `PersonCollectionCreateParams` and `TokenCreateParams.person`
diff --git a/.hark/changes/2021-06-02_richardm_api-updates.change.md b/.hark/changes/2021-06-02_richardm_api-updates.change.md
new file mode 100644
index 00000000000..b2b1d175661
--- /dev/null
+++ b/.hark/changes/2021-06-02_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1214
+is_stripe_api_change: true
+released_in_version: 20.53.0
+---
+
+* Added support for `llc`, `free_zone_llc`, `free_zone_establishment` and `sole_establishment` to the `structure` enum on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company` and `TokenCreateParams.account.company`.
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 00000000000..ad9147227f3
--- /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-java/pull/1217
+is_stripe_api_change: true
+released_in_version: 20.55.0
+---
+
+* Added support for `controller` on `Account`
diff --git a/.hark/changes/2021-06-04_richardm_api-updates_2.change.md b/.hark/changes/2021-06-04_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..3dd1aeeee11
--- /dev/null
+++ b/.hark/changes/2021-06-04_richardm_api-updates_2.change.md
@@ -0,0 +1,22 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1215
+is_stripe_api_change: true
+released_in_version: 20.54.0
+---
+
+* Add support for new `TaxCode` API.
+* Add support for `tax_code` on `Product`, `ProductCreateParams`, `ProductUpdateParams`, `PriceCreateParams.product_data`, `PlanCreateParams.product`, and Checkout `SessionCreateParams.line_items[].price_data.product_data`.
+* Add support for `tax` to `Customer`, `CustomerCreateParams`, `CustomerUpdateParams`.
+* Add support for `default_settings[automatic_tax]` and `phases[].automatic_tax` on `SubscriptionSchedule`, `SubscriptionScheduleCreateParams`, and `SubscriptionScheduleUpdateParams`.
+* Add support for `automatic_tax` on `Subscription`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`; `Invoice`, `InvoiceCreateParams`, and `InvoiceUpcomingParams`; Checkout `Session` and Checkout `SessionCreateParams`.
+* Add support for `tax_behavior` to `Price`, `PriceCreateParams`, `PriceUpdateParams` and to the many Param objects that contain `price_data`:
+    - `SubscriptionScheduleCreateParams` and `SubscriptionScheduleUpdateParams`, beneath `phases[].add_invoice_items[]` and `phases[].items[]`
+    - `SubscriptionItemCreateParams` and `SubscriptionItemUpdateParams`, on the top-level
+    - `SubscriptionCreateParams` create and `UpdateCreateParams`, beneath `items[]` and `add_invoice_items[]`
+    - `InvoiceItemCreateParams` and `InvoiceItemUpdateParams`,  on the top-level
+    - `InvoiceUpcomingParams` and `InvoiceUpcomingLinesParams` beneath `subscription_items[]` and `invoice_items[]`.
+    - Checkout `SessionCreateParams`, beneath `line_items[]`.
+* Add support for `customer_update` to Checkout `SessionCreateParams`.
+* Add support for `customer_details` to `InvoiceUpcomingParams`.
+* Add support for `tax_type` to `TaxRate`, `TaxRateCreateParams`, and `TaxRateUpdateParams`.
diff --git a/.hark/changes/2021-06-07_dcr_api-updates.change.md b/.hark/changes/2021-06-07_dcr_api-updates.change.md
new file mode 100644
index 00000000000..b7584c28671
--- /dev/null
+++ b/.hark/changes/2021-06-07_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1219
+is_stripe_api_change: true
+released_in_version: 20.56.0
+---
+
+* Added support for `TaxIdCollection` on `SessionCreateParams` and `Session.taxIdCollection`
+* Update `Location` to be expandable on `Reader`
diff --git a/.hark/changes/2021-06-16_richardm_api-updates.change.md b/.hark/changes/2021-06-16_richardm_api-updates.change.md
new file mode 100644
index 00000000000..328c8128d94
--- /dev/null
+++ b/.hark/changes/2021-06-16_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1221
+is_stripe_api_change: true
+released_in_version: 20.57.0
+---
+
+* Add support for `url` on Checkout `Session`
diff --git a/.hark/changes/2021-06-18_richardm_api-updates.change.md b/.hark/changes/2021-06-18_richardm_api-updates.change.md
new file mode 100644
index 00000000000..9fef6411843
--- /dev/null
+++ b/.hark/changes/2021-06-18_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1222
+is_stripe_api_change: true
+released_in_version: 20.58.0
+---
+
+* Add support for new TaxId types: `ca_pst_mb`, `ca_pst_bc`, `ca_gst_hst`, and `ca_pst_sk`.
diff --git a/.hark/changes/2021-06-24_richardm_remove-travis-ci.change.md b/.hark/changes/2021-06-24_richardm_remove-travis-ci.change.md
new file mode 100644
index 00000000000..4e0f6982fb5
--- /dev/null
+++ b/.hark/changes/2021-06-24_richardm_remove-travis-ci.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove Travis CI
+pr_url: https://github.com/stripe/stripe-java/pull/1218
+released_in_version: 20.59.0
+---
diff --git a/.hark/changes/2021-06-25_richardm_api-updates.change.md b/.hark/changes/2021-06-25_richardm_api-updates.change.md
new file mode 100644
index 00000000000..42a731abf39
--- /dev/null
+++ b/.hark/changes/2021-06-25_richardm_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1225
+is_stripe_api_change: true
+released_in_version: 20.59.0
+---
+
+* Added support for `boleto` on `PaymentMethodCreateParams`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `Charge.payment_method_details` and `PaymentMethod`
+* `PaymentMethodListParams.type`, `PaymentMethodCreateParams.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`  added new enum members: `boleto`
+* Added support for `boleto_display_details` on `PaymentIntent.next_action`
+* `TaxIdCreateParams.type`, `InvoiceLineItemListUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `CustomerCreateParams.tax_id_data[].type`, added new enum members: `il_vat`.
diff --git a/.hark/changes/2021-06-25_richardm_streaming-requests.change.md b/.hark/changes/2021-06-25_richardm_streaming-requests.change.md
new file mode 100644
index 00000000000..a7de5823b4f
--- /dev/null
+++ b/.hark/changes/2021-06-25_richardm_streaming-requests.change.md
@@ -0,0 +1,5 @@
+---
+title: Streaming requests
+pr_url: https://github.com/stripe/stripe-java/pull/1207
+released_in_version: 20.60.0
+---
diff --git a/.hark/changes/2021-06-29_dcr_api-updates.change.md b/.hark/changes/2021-06-29_dcr_api-updates.change.md
new file mode 100644
index 00000000000..9064196d2f8
--- /dev/null
+++ b/.hark/changes/2021-06-29_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1227
+is_stripe_api_change: true
+released_in_version: 20.60.0
+---
+
+* Added support for `boleto_payments` on `Account.capabilities`
+* Added support for `boleto` and `oxxo` on `SessionCreateParams` and `Session`
diff --git a/.hark/changes/2021-06-30_dcr_api-updates.change.md b/.hark/changes/2021-06-30_dcr_api-updates.change.md
new file mode 100644
index 00000000000..8901d91424e
--- /dev/null
+++ b/.hark/changes/2021-06-30_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1229
+is_stripe_api_change: true
+released_in_version: 20.62.0
+---
+
+* Add support for new value `boleto` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, and `InvoiceUpdateParams.payment_settings.payment_method_types[]`.
diff --git a/.hark/changes/2021-06-30_dcr_api-updates_2.change.md b/.hark/changes/2021-06-30_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..d716ae7fd3c
--- /dev/null
+++ b/.hark/changes/2021-06-30_dcr_api-updates_2.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1228
+is_stripe_api_change: true
+released_in_version: 20.61.0
+---
+
+* Add support for `wechat_pay` on `Charge.payment_method_details`, `checkout.SessionCreateParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentMethodCreateParams`, and `PaymentMethod`
+* Add support for new value `wechat_pay` on enums `checkout.SessionCreateParams.payment_method_types[]` `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`,`PaymentIntentConfirmParams.payment_method_data.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `wechat_pay_display_qr_code`, `wechat_pay_redirect_to_android_app`, and `wechat_pay_redirect_to_ios_app` on `PaymentIntent.next_action`
diff --git a/.hark/changes/2021-07-09_richardm_api-updates.change.md b/.hark/changes/2021-07-09_richardm_api-updates.change.md
new file mode 100644
index 00000000000..63986debccb
--- /dev/null
+++ b/.hark/changes/2021-07-09_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1231
+is_stripe_api_change: true
+released_in_version: 20.63.0
+---
+
+* Add support for new resource `Quote`
+* Add support for `quote` on `Invoice`
diff --git a/.hark/changes/2021-07-09_richardm_remove-inappropriat-list.change.md b/.hark/changes/2021-07-09_richardm_remove-inappropriat-list.change.md
new file mode 100644
index 00000000000..57e23d82db9
--- /dev/null
+++ b/.hark/changes/2021-07-09_richardm_remove-inappropriat-list.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove inappropriate list method from QuoteCollection
+pr_url: https://github.com/stripe/stripe-java/pull/1233
+released_in_version: 20.63.1
+---
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 00000000000..3416ba9c910
--- /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-java/pull/1237
+is_stripe_api_change: true
+released_in_version: 20.64.0
+---
+
+* Add support for `quote.accepted`, `quote.canceled`, `quote.created`, and `quote.finalized` events.
diff --git a/.hark/changes/2021-07-14_dcr_api-updates_2.change.md b/.hark/changes/2021-07-14_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..47726803047
--- /dev/null
+++ b/.hark/changes/2021-07-14_dcr_api-updates_2.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1236
+is_stripe_api_change: true
+released_in_version: 20.64.0
+---
+
+* Add support for `list_computed_upfront_line_items` method on resource `Quote`
diff --git a/.hark/changes/2021-07-21_richardm_api-updates.change.md b/.hark/changes/2021-07-21_richardm_api-updates.change.md
new file mode 100644
index 00000000000..93211d53330
--- /dev/null
+++ b/.hark/changes/2021-07-21_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1238
+is_stripe_api_change: true
+released_in_version: 20.65.0
+---
+
+* Add support for `wallet` on `Issuing.Transaction`
+* Add support for `ideal` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
diff --git a/.hark/changes/2021-07-22_dcr_api-updates.change.md b/.hark/changes/2021-07-22_dcr_api-updates.change.md
new file mode 100644
index 00000000000..75dc7dc4088
--- /dev/null
+++ b/.hark/changes/2021-07-22_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1239
+is_stripe_api_change: true
+released_in_version: 20.66.0
+---
+
+* Add support for new values `hr`, `ko`, and `vi` on enum `checkout.SessionCreateParams.locale`
+* Add support for `payment_settings` on `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
diff --git a/.hark/changes/2021-07-27_richardm_api-updates.change.md b/.hark/changes/2021-07-27_richardm_api-updates.change.md
new file mode 100644
index 00000000000..6ce25a94a10
--- /dev/null
+++ b/.hark/changes/2021-07-27_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1241
+is_stripe_api_change: true
+released_in_version: 20.67.0
+---
+
+* Add support for `category_code` on `Issuing.Authorization.merchant_data` and `Issuing.Transaction.merchant_data`
diff --git a/.hark/changes/2021-07-28_dcr_api-updates.change.md b/.hark/changes/2021-07-28_dcr_api-updates.change.md
new file mode 100644
index 00000000000..6598af1f9d2
--- /dev/null
+++ b/.hark/changes/2021-07-28_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1242
+is_stripe_api_change: true
+released_in_version: 20.67.0
+---
+
+* Add support for `account_type` on `BankAccount`, `ExternalAccountUpdateParams`, and `TokenCreateParams.bank_account`
diff --git a/.hark/changes/2021-08-04_richardm_api-updates.change.md b/.hark/changes/2021-08-04_richardm_api-updates.change.md
new file mode 100644
index 00000000000..ba9aa331469
--- /dev/null
+++ b/.hark/changes/2021-08-04_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1246
+is_stripe_api_change: true
+released_in_version: 20.68.0
+---
+
+* Change type of `PaymentIntentCreateParams.payment_method_options.sofort.preferred_language`, `PaymentIntentUpdateParams.payment_method_options.sofort.preferred_language`, and `PaymentIntentConfirmParams.payment_method_options.sofort.preferred_language` from `enum` to `emptyStringable(enum)`
diff --git a/.hark/changes/2021-08-11_dcr_api-updates.change.md b/.hark/changes/2021-08-11_dcr_api-updates.change.md
new file mode 100644
index 00000000000..87a0b550960
--- /dev/null
+++ b/.hark/changes/2021-08-11_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1248
+is_stripe_api_change: true
+released_in_version: 20.69.0
+---
+
+* Add support for `locale` on `billingportal.SessionCreateParams` and `BillingPortal.Session`
diff --git a/.hark/changes/2021-08-19_dcr_api-updates.change.md b/.hark/changes/2021-08-19_dcr_api-updates.change.md
new file mode 100644
index 00000000000..ce3b6005fd5
--- /dev/null
+++ b/.hark/changes/2021-08-19_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1249
+is_stripe_api_change: true
+released_in_version: 20.70.0
+---
+
+* Add support for new value `fil` on enum `checkout.SessionCreateParams.locale`
+* Add support for new value `au_arn` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
diff --git a/.hark/changes/2021-08-27_richardm_api-updates.change.md b/.hark/changes/2021-08-27_richardm_api-updates.change.md
new file mode 100644
index 00000000000..08253711090
--- /dev/null
+++ b/.hark/changes/2021-08-27_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1250
+is_stripe_api_change: true
+released_in_version: 20.71.0
+---
+
+* Add support for `cancellation_reason` on `billingportal.ConfigurationCreateParams.features.subscription_cancel`, `billingportal.ConfigurationUpdateParams.features.subscription_cancel`, and `BillingPortal.Configuration.features.subscription_cancel`
diff --git a/.hark/changes/2021-08-31_richardm_add-support-auto.change.md b/.hark/changes/2021-08-31_richardm_add-support-auto.change.md
new file mode 100644
index 00000000000..317f4cc295d
--- /dev/null
+++ b/.hark/changes/2021-08-31_richardm_add-support-auto.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for auto-paginatable `SearchResult` type
+pr_url: https://github.com/stripe/stripe-java/pull/1252
+released_in_version: 20.72.0
+---
diff --git a/.hark/changes/2021-09-01_richardm_api-updates.change.md b/.hark/changes/2021-09-01_richardm_api-updates.change.md
new file mode 100644
index 00000000000..5fc2ef3e5b6
--- /dev/null
+++ b/.hark/changes/2021-09-01_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1254
+is_stripe_api_change: true
+released_in_version: 20.72.0
+---
+
+* Add support for `after_expiration`, `consent_collection`, and `expires_at` on `checkout.SessionCreateParams` and `Checkout.Session`
+* Add support for `consent` and `recovered_from` on `Checkout.Session`
diff --git a/.hark/changes/2021-09-02_richardm_api-updates.change.md b/.hark/changes/2021-09-02_richardm_api-updates.change.md
new file mode 100644
index 00000000000..4503ce0c9fb
--- /dev/null
+++ b/.hark/changes/2021-09-02_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1255
+is_stripe_api_change: true
+released_in_version: 20.73.0
+---
+
+* Add support for `future_requirements` on `Account`, `Capability`, and `Person`
+* Add support for `alternatives` on `Account.requirements`, `Capability.requirements`, and `Person.requirements`
diff --git a/.hark/changes/2021-09-07_richardm_api-updates.change.md b/.hark/changes/2021-09-07_richardm_api-updates.change.md
new file mode 100644
index 00000000000..cc0861ced3b
--- /dev/null
+++ b/.hark/changes/2021-09-07_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1257
+is_stripe_api_change: true
+released_in_version: 20.74.0
+---
+
+* Add support for new value `rst` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
+* Add support for new value `checkout.session.expired` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2021-09-09_richardm_add-missing-constant.change.md b/.hark/changes/2021-09-09_richardm_add-missing-constant.change.md
new file mode 100644
index 00000000000..1e2805360fa
--- /dev/null
+++ b/.hark/changes/2021-09-09_richardm_add-missing-constant.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing constant for `account_requirement` as a `purpose` on File create and List APIs
+pr_url: https://github.com/stripe/stripe-java/pull/1259
+released_in_version: 20.75.0
+---
diff --git a/.hark/changes/2021-09-15_richardm_api-updates.change.md b/.hark/changes/2021-09-15_richardm_api-updates.change.md
new file mode 100644
index 00000000000..45b799be3d6
--- /dev/null
+++ b/.hark/changes/2021-09-15_richardm_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1263
+is_stripe_api_change: true
+released_in_version: 20.76.0
+---
+
+* Add support for `default_for` on `checkout.SessionCreateParams.payment_method_options.acss_debit.mandate_options`, `Checkout.Session.payment_method_options.acss_debit.mandate_options`, `Mandate.payment_method_details.acss_debit`, `SetupIntentCreateParams.payment_method_options.acss_debit.mandate_options`, `SetupIntentUpdateParams.payment_method_options.acss_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.acss_debit.mandate_options`, and `SetupIntent.payment_method_options.acss_debit.mandate_options`
+* Add support for `acss_debit` on `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Invoice.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, `SubscriptionUpdateParams.payment_settings.payment_method_options`, and `Subscription.payment_settings.payment_method_options`
+* Add support for new value `acss_debit` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for `livemode` on `Reporting.ReportType`
diff --git a/.hark/changes/2021-09-16_dcr_api-updates.change.md b/.hark/changes/2021-09-16_dcr_api-updates.change.md
new file mode 100644
index 00000000000..359bd3ed2ae
--- /dev/null
+++ b/.hark/changes/2021-09-16_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1264
+is_stripe_api_change: true
+released_in_version: 20.77.0
+---
+
+* Add support for `full_name_aliases` on `AccountUpdateParams.individual`, `AccountCreateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
diff --git a/.hark/changes/2021-09-20_richardm_fix-typo-readme.change.md b/.hark/changes/2021-09-20_richardm_fix-typo-readme.change.md
new file mode 100644
index 00000000000..68fb21c1a10
--- /dev/null
+++ b/.hark/changes/2021-09-20_richardm_fix-typo-readme.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix typo in README.md
+pr_url: https://github.com/stripe/stripe-java/pull/1209
+released_in_version: 20.78.0
+---
diff --git a/.hark/changes/2021-09-20_richardm_upgrade-gradle.change.md b/.hark/changes/2021-09-20_richardm_upgrade-gradle.change.md
new file mode 100644
index 00000000000..2584ec54cb6
--- /dev/null
+++ b/.hark/changes/2021-09-20_richardm_upgrade-gradle.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Gradle
+pr_url: https://github.com/stripe/stripe-java/pull/1261
+released_in_version: 20.78.0
+---
diff --git a/.hark/changes/2021-09-24_richardm_api-updates.change.md b/.hark/changes/2021-09-24_richardm_api-updates.change.md
new file mode 100644
index 00000000000..4ed67616a3f
--- /dev/null
+++ b/.hark/changes/2021-09-24_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1265
+is_stripe_api_change: true
+released_in_version: 20.78.0
+---
+
+* Add support for `amount_authorized` and `overcapture_supported` on `Charge.payment_method_details.card_present`
diff --git a/.hark/changes/2021-09-29_dcr_api-updates.change.md b/.hark/changes/2021-09-29_dcr_api-updates.change.md
new file mode 100644
index 00000000000..3411b9f75ac
--- /dev/null
+++ b/.hark/changes/2021-09-29_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1266
+is_stripe_api_change: true
+released_in_version: 20.79.0
+---
+
+* Add support for `klarna_payments` on `AccountUpdateParams.capabilities`, `AccountCreateParams.capabilities`, and `Account.capabilities`
diff --git a/.hark/changes/2021-10-07_richardm_api-updates.change.md b/.hark/changes/2021-10-07_richardm_api-updates.change.md
new file mode 100644
index 00000000000..18e27be3bff
--- /dev/null
+++ b/.hark/changes/2021-10-07_richardm_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1268
+is_stripe_api_change: true
+released_in_version: 20.80.0
+---
+
+* Add support for `phone_number_collection` on `checkout.SessionCreateParams` and `Checkout.Session`
+* Add support for `phone` on `Checkout.Session.customer_details`
+* Change `PaymentMethodListParams.customer` to be optional
+* Add support for new value `customer_id` on enum `radar.ValueListCreateParams.item_type`
+* Add support for new value `bbpos_wisepos_e` on enum `terminal.ReaderListParams.device_type`
diff --git a/.hark/changes/2021-10-11_dcr_api-updates.change.md b/.hark/changes/2021-10-11_dcr_api-updates.change.md
new file mode 100644
index 00000000000..5928e637956
--- /dev/null
+++ b/.hark/changes/2021-10-11_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1269
+is_stripe_api_change: true
+released_in_version: 20.81.0
+---
+
+* Add support for `list_payment_methods` method on resource `Customer`
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 00000000000..4f40a1263a4
--- /dev/null
+++ b/.hark/changes/2021-10-11_richardm_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1271
+is_stripe_api_change: true
+released_in_version: 20.82.0
+---
+
+* Add support for `payment_method_category` and `preferred_locale` on `Charge.payment_method_details.klarna`
+* Add support for new value `klarna` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for `klarna` on `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentMethodCreateParams`, and `PaymentMethod`
+* Add support for new value `klarna` on enums `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, and `PaymentIntentConfirmParams.payment_method_data.type`
+* Add support for new value `klarna` on enum `PaymentMethodCreateParams.type`
diff --git a/.hark/changes/2021-10-14_richardm_api-updates.change.md b/.hark/changes/2021-10-14_richardm_api-updates.change.md
new file mode 100644
index 00000000000..b2054d3360f
--- /dev/null
+++ b/.hark/changes/2021-10-14_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1272
+is_stripe_api_change: true
+released_in_version: 20.83.0
+---
+
+* Add support for new value `klarna` on enum `checkout.SessionCreateParams.payment_method_types[]`
diff --git a/.hark/changes/2021-10-15_dcr_api-updates.change.md b/.hark/changes/2021-10-15_dcr_api-updates.change.md
new file mode 100644
index 00000000000..f86a7708cad
--- /dev/null
+++ b/.hark/changes/2021-10-15_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1273
+is_stripe_api_change: true
+released_in_version: 20.84.0
+---
+
+* Change type of `UsageRecordCreateParams.timestamp` from `integer` to `literal('now') | integer`
+* Change `UsageRecordCreateParams.timestamp` to be optional
diff --git a/.hark/changes/2021-10-20_richardm_api-updates.change.md b/.hark/changes/2021-10-20_richardm_api-updates.change.md
new file mode 100644
index 00000000000..43655187e25
--- /dev/null
+++ b/.hark/changes/2021-10-20_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1274
+is_stripe_api_change: true
+released_in_version: 20.85.0
+---
+
+* Add support for `buyer_id` on `Charge.payment_method_details.alipay`
diff --git a/.hark/changes/2021-10-20_richardm_reorder-fields.change.md b/.hark/changes/2021-10-20_richardm_reorder-fields.change.md
new file mode 100644
index 00000000000..1dca40686cc
--- /dev/null
+++ b/.hark/changes/2021-10-20_richardm_reorder-fields.change.md
@@ -0,0 +1,5 @@
+---
+title: Reorder fields
+pr_url: https://github.com/stripe/stripe-java/pull/1275
+released_in_version: 20.85.0
+---
diff --git a/.hark/changes/2021-11-01_dcr_api-updates.change.md b/.hark/changes/2021-11-01_dcr_api-updates.change.md
new file mode 100644
index 00000000000..cd0000c1cab
--- /dev/null
+++ b/.hark/changes/2021-11-01_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1278
+is_stripe_api_change: true
+released_in_version: 20.86.0
+---
+
+* Add support for `ownership_declaration` on `AccountUpdateParams.company`, `AccountCreateParams.company`, `Account.company`, and `TokenCreateParams.account.company`
+* Add support for `proof_of_registration` on `AccountUpdateParams.documents` and `AccountCreateParams.documents`
+* Add support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account`
diff --git a/.hark/changes/2021-11-04_dcr_api-updates.change.md b/.hark/changes/2021-11-04_dcr_api-updates.change.md
new file mode 100644
index 00000000000..6a2ef09f969
--- /dev/null
+++ b/.hark/changes/2021-11-04_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1279
+is_stripe_api_change: true
+released_in_version: 20.86.1
+---
+
+* Remove support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account`. This API was unused.
+* Add support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account.company`
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 00000000000..6ba33fc09b8
--- /dev/null
+++ b/.hark/changes/2021-11-11_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1281
+is_stripe_api_change: true
+released_in_version: 20.87.0
+---
+
+* Add support for `expire` method on resource `Checkout.Session`
+* Add support for `status` on `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 00000000000..8f7ab5c3d3a
--- /dev/null
+++ b/.hark/changes/2021-11-16_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1284
+is_stripe_api_change: true
+released_in_version: 20.88.0
+---
+
+* Add support for new resource `ShippingRate`
+* Add support for `shipping_options` on `checkout.SessionCreateParams` and `Checkout.Session`
+* Add support for `shipping_rate` on `Checkout.Session`
diff --git a/.hark/changes/2021-11-17_dcr_api-updates.change.md b/.hark/changes/2021-11-17_dcr_api-updates.change.md
new file mode 100644
index 00000000000..ab404a0ff84
--- /dev/null
+++ b/.hark/changes/2021-11-17_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1286
+is_stripe_api_change: true
+released_in_version: 20.89.0
+---
+
+* Add support for `automatic_payment_methods` on `PaymentIntentCreateParams` and `PaymentIntent`
diff --git a/.hark/changes/2021-11-19_richardm_api-updates.change.md b/.hark/changes/2021-11-19_richardm_api-updates.change.md
new file mode 100644
index 00000000000..a5bcc9c1ee5
--- /dev/null
+++ b/.hark/changes/2021-11-19_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1289
+is_stripe_api_change: true
+released_in_version: 20.90.0
+---
+
+* Add support for `wallets` on `Issuing.Card`
diff --git a/.hark/changes/2021-11-19_richardm_api-updates_2.change.md b/.hark/changes/2021-11-19_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..80f4c00ce3c
--- /dev/null
+++ b/.hark/changes/2021-11-19_richardm_api-updates_2.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1288
+is_stripe_api_change: true
+released_in_version: 20.90.0
+---
+
+* Add support for `interac_present` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+* Add support for new value `jct` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2021-11-29_richardm_update-javadoc-task.change.md b/.hark/changes/2021-11-29_richardm_update-javadoc-task.change.md
new file mode 100644
index 00000000000..0a25c5f03cc
--- /dev/null
+++ b/.hark/changes/2021-11-29_richardm_update-javadoc-task.change.md
@@ -0,0 +1,5 @@
+---
+title: Update Javadoc task to not use module directories.
+pr_url: https://github.com/stripe/stripe-java/pull/1290
+released_in_version: 20.91.0
+---
diff --git a/.hark/changes/2021-12-03_dcr_pass-credentials-nexusstaging.change.md b/.hark/changes/2021-12-03_dcr_pass-credentials-nexusstaging.change.md
new file mode 100644
index 00000000000..bbf95801bbd
--- /dev/null
+++ b/.hark/changes/2021-12-03_dcr_pass-credentials-nexusstaging.change.md
@@ -0,0 +1,5 @@
+---
+title: Pass credentials to nexusStaging rule.
+pr_url: https://github.com/stripe/stripe-java/pull/1292
+released_in_version: 20.91.0
+---
diff --git a/.hark/changes/2021-12-04_ob_test-java-16.change.md b/.hark/changes/2021-12-04_ob_test-java-16.change.md
new file mode 100644
index 00000000000..06e4a37fb2e
--- /dev/null
+++ b/.hark/changes/2021-12-04_ob_test-java-16.change.md
@@ -0,0 +1,5 @@
+---
+title: Test Java 16 and 17
+pr_url: https://github.com/stripe/stripe-java/pull/1291
+released_in_version: 20.91.0
+---
diff --git a/.hark/changes/2021-12-09_dcr_api-updates.change.md b/.hark/changes/2021-12-09_dcr_api-updates.change.md
new file mode 100644
index 00000000000..b5a6030e0f8
--- /dev/null
+++ b/.hark/changes/2021-12-09_dcr_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1294
+is_stripe_api_change: true
+released_in_version: 20.91.0
+---
+
+* Add support for new values `ge_vat` and `ua_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+* Change type of `PaymentIntentCreateParams.payment_method_data.billing_details.email`, `PaymentIntentUpdateParams.payment_method_data.billing_details.email`, `PaymentIntentConfirmParams.payment_method_data.billing_details.email`, `PaymentMethodCreateParams.billing_details.email`, and `PaymentMethodUpdateParams.billing_details.email` from `string` to `emptyStringable(string)`
+* Add support for `giropay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+* Add support for new value `en-IE` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
diff --git a/.hark/changes/2021-12-09_yejia_api-updates.change.md b/.hark/changes/2021-12-09_yejia_api-updates.change.md
new file mode 100644
index 00000000000..29a296b42d9
--- /dev/null
+++ b/.hark/changes/2021-12-09_yejia_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1295
+is_stripe_api_change: true
+released_in_version: 20.92.0
+---
+
+* Add support for `metadata` on `billingportal.ConfigurationCreateParams`, `billingportal.ConfigurationUpdateParams`, and `BillingPortal.Configuration`
diff --git a/.hark/changes/2021-12-15_yejia_api-updates.change.md b/.hark/changes/2021-12-15_yejia_api-updates.change.md
new file mode 100644
index 00000000000..5235479455c
--- /dev/null
+++ b/.hark/changes/2021-12-15_yejia_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1296
+is_stripe_api_change: true
+released_in_version: 20.93.0
+---
+
+* Add support for new resource `PaymentIntentTypeSpecificPaymentMethodOptionsClient`
+* Add support for `setup_future_usage` on `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, and `PaymentIntent.payment_method_options.card`
diff --git a/.hark/changes/2021-12-21_dcr_api-updates.change.md b/.hark/changes/2021-12-21_dcr_api-updates.change.md
new file mode 100644
index 00000000000..54dad9454c2
--- /dev/null
+++ b/.hark/changes/2021-12-21_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1297
+is_stripe_api_change: true
+released_in_version: 20.94.0
+---
+
+* Add support for `processing` on `PaymentIntent`
diff --git a/.hark/changes/2021-12-22_dcr_api-updates.change.md b/.hark/changes/2021-12-22_dcr_api-updates.change.md
new file mode 100644
index 00000000000..81ce0626ae0
--- /dev/null
+++ b/.hark/changes/2021-12-22_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1299
+is_stripe_api_change: true
+released_in_version: 20.94.0
+---
+
+* Add support for `au_becs_debit` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
diff --git a/.hark/changes/2021-12-22_dcr_api-updates_2.change.md b/.hark/changes/2021-12-22_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..c05ef7e097f
--- /dev/null
+++ b/.hark/changes/2021-12-22_dcr_api-updates_2.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1298
+is_stripe_api_change: true
+released_in_version: 20.94.0
+---
+
+* Add support for new values `en-FR`, `es-US`, and `fr-FR` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
+* Add support for `boleto` on `SetupAttempt.payment_method_details`
diff --git a/.hark/changes/2022-01-12_dcr_api-updates.change.md b/.hark/changes/2022-01-12_dcr_api-updates.change.md
new file mode 100644
index 00000000000..f2a24510f7a
--- /dev/null
+++ b/.hark/changes/2022-01-12_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1301
+is_stripe_api_change: true
+released_in_version: 20.95.0
+---
+
+* Add support for `customer_creation` on `checkout.SessionCreateParams` and `Checkout.Session`
+* Add support for `fpx` and `grabpay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+* Add support for `PaidOutOfBand` on `Invoice`
diff --git a/.hark/changes/2022-01-12_dcr_api-updates_2.change.md b/.hark/changes/2022-01-12_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..7ca080206ea
--- /dev/null
+++ b/.hark/changes/2022-01-12_dcr_api-updates_2.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1300
+is_stripe_api_change: true
+released_in_version: 20.95.0
+---
+
+* Add support for `mandate_options` on `SubscriptionCreateParams.payment_settings.payment_method_options.card`, `SubscriptionUpdateParams.payment_settings.payment_method_options.card`, and `Subscription.payment_settings.payment_method_options.card`
diff --git a/.hark/changes/2022-01-19_dcr_api-updates.change.md b/.hark/changes/2022-01-19_dcr_api-updates.change.md
new file mode 100644
index 00000000000..b51c687c0de
--- /dev/null
+++ b/.hark/changes/2022-01-19_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1302
+is_stripe_api_change: true
+released_in_version: 20.96.0
+---
+
+* Add support for `bacs_debit` and `eps` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+* Add support for `image_url_png` and `image_url_svg` on `PaymentIntent.next_action.wechat_pay_display_qr_code`
diff --git a/.hark/changes/2022-01-19_richardm_api-updates.change.md b/.hark/changes/2022-01-19_richardm_api-updates.change.md
new file mode 100644
index 00000000000..a233901f7c5
--- /dev/null
+++ b/.hark/changes/2022-01-19_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1304
+is_stripe_api_change: true
+released_in_version: 20.97.0
+---
+
+* Add support for new resource `PaymentLink`
+* Add support for `payment_link` on `Checkout.Session`
diff --git a/.hark/changes/2022-01-25_yejia_api-updates.change.md b/.hark/changes/2022-01-25_yejia_api-updates.change.md
new file mode 100644
index 00000000000..cfb75ea4405
--- /dev/null
+++ b/.hark/changes/2022-01-25_yejia_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1306
+is_stripe_api_change: true
+released_in_version: 20.98.0
+---
+
+* Add support for `phone_number_collection` on `PaymentLinkCreateParams` and `PaymentLink`
+* Add support for new values `payment_link.created` and `payment_link.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+* Add support for new value `is_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
diff --git a/.hark/changes/2022-02-03_yejia_api-updates.change.md b/.hark/changes/2022-02-03_yejia_api-updates.change.md
new file mode 100644
index 00000000000..0a5394dea9a
--- /dev/null
+++ b/.hark/changes/2022-02-03_yejia_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1307
+is_stripe_api_change: true
+released_in_version: 20.99.0
+---
+
+* Add support for new value `au_becs_debit` on enum `checkout.SessionCreateParams.payment_method_types[]`
diff --git a/.hark/changes/2022-02-09_dcr_pin-grgit-version.change.md b/.hark/changes/2022-02-09_dcr_pin-grgit-version.change.md
new file mode 100644
index 00000000000..d1084d8904d
--- /dev/null
+++ b/.hark/changes/2022-02-09_dcr_pin-grgit-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Pin grgit version to 4.1.1.
+pr_url: https://github.com/stripe/stripe-java/pull/1311
+released_in_version: 20.100.0
+---
diff --git a/.hark/changes/2022-02-09_richardm_api-updates.change.md b/.hark/changes/2022-02-09_richardm_api-updates.change.md
new file mode 100644
index 00000000000..698f926dd3a
--- /dev/null
+++ b/.hark/changes/2022-02-09_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1310
+is_stripe_api_change: true
+released_in_version: 20.100.0
+---
+
+* Add support for `pin` on `issuing.CardUpdateParams`
diff --git a/.hark/changes/2022-02-14_richardm_api-updates.change.md b/.hark/changes/2022-02-14_richardm_api-updates.change.md
new file mode 100644
index 00000000000..b3f802918b4
--- /dev/null
+++ b/.hark/changes/2022-02-14_richardm_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1312
+is_stripe_api_change: true
+released_in_version: 20.100.0
+---
+
+* Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
+* Add support for new value `grabpay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]
+`
diff --git a/.hark/changes/2022-02-23_yejia_api-updates.change.md b/.hark/changes/2022-02-23_yejia_api-updates.change.md
new file mode 100644
index 00000000000..85ef86f44ea
--- /dev/null
+++ b/.hark/changes/2022-02-23_yejia_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1313
+is_stripe_api_change: true
+released_in_version: 20.101.0
+---
+
+* Add support for `setup_future_usage` on `PaymentIntentCreateParams.payment_method_options.acss_debit`, `PaymentIntentCreateParams.payment_method_options.afterpay_clearpay`, `PaymentIntentCreateParams.payment_method_options.alipay`, `PaymentIntentCreateParams.payment_method_options.au_becs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.bancontact`, `PaymentIntentCreateParams.payment_method_options.boleto`, `PaymentIntentCreateParams.payment_method_options.eps`, `PaymentIntentCreateParams.payment_method_options.fpx`, `PaymentIntentCreateParams.payment_method_options.giropay`, `PaymentIntentCreateParams.payment_method_options.grabpay`, `PaymentIntentCreateParams.payment_method_options.ideal`, `PaymentIntentCreateParams.payment_method_options.klarna`, `PaymentIntentCreateParams.payment_method_options.oxxo`, `PaymentIntentCreateParams.payment_method_options.p24`, `PaymentIntentCreateParams.payment_method_options.sepa_debit`, `PaymentIntentCreateParams.payment_method_options.sofort`, `PaymentIntentCreateParams.payment_method_options.wechat_pay`, `PaymentIntentUpdateParams.payment_method_options.acss_debit`, `PaymentIntentUpdateParams.payment_method_options.afterpay_clearpay`, `PaymentIntentUpdateParams.payment_method_options.alipay`, `PaymentIntentUpdateParams.payment_method_options.au_becs_debit`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit`, `PaymentIntentUpdateParams.payment_method_options.bancontact`, `PaymentIntentUpdateParams.payment_method_options.boleto`, `PaymentIntentUpdateParams.payment_method_options.eps`, `PaymentIntentUpdateParams.payment_method_options.fpx`, `PaymentIntentUpdateParams.payment_method_options.giropay`, `PaymentIntentUpdateParams.payment_method_options.grabpay`, `PaymentIntentUpdateParams.payment_method_options.ideal`, `PaymentIntentUpdateParams.payment_method_options.klarna`, `PaymentIntentUpdateParams.payment_method_options.oxxo`, `PaymentIntentUpdateParams.payment_method_options.p24`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit`, `PaymentIntentUpdateParams.payment_method_options.sofort`, `PaymentIntentUpdateParams.payment_method_options.wechat_pay`, `PaymentIntentConfirmParams.payment_method_options.acss_debit`, `PaymentIntentConfirmParams.payment_method_options.afterpay_clearpay`, `PaymentIntentConfirmParams.payment_method_options.alipay`, `PaymentIntentConfirmParams.payment_method_options.au_becs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.bancontact`, `PaymentIntentConfirmParams.payment_method_options.boleto`, `PaymentIntentConfirmParams.payment_method_options.eps`, `PaymentIntentConfirmParams.payment_method_options.fpx`, `PaymentIntentConfirmParams.payment_method_options.giropay`, `PaymentIntentConfirmParams.payment_method_options.grabpay`, `PaymentIntentConfirmParams.payment_method_options.ideal`, `PaymentIntentConfirmParams.payment_method_options.klarna`, `PaymentIntentConfirmParams.payment_method_options.oxxo`, `PaymentIntentConfirmParams.payment_method_options.p24`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit`, `PaymentIntentConfirmParams.payment_method_options.sofort`, `PaymentIntentConfirmParams.payment_method_options.wechat_pay`, `PaymentIntent.payment_method_options.acss_debit`, `PaymentIntent.payment_method_options.afterpay_clearpay`, `PaymentIntent.payment_method_options.alipay`, `PaymentIntent.payment_method_options.au_becs_debit`, `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntent.payment_method_options.bancontact`, `PaymentIntent.payment_method_options.boleto`, `PaymentIntent.payment_method_options.eps`, `PaymentIntent.payment_method_options.fpx`, `PaymentIntent.payment_method_options.giropay`, `PaymentIntent.payment_method_options.grabpay`, `PaymentIntent.payment_method_options.ideal`, `PaymentIntent.payment_method_options.klarna`, `PaymentIntent.payment_method_options.oxxo`, `PaymentIntent.payment_method_options.p24`, `PaymentIntent.payment_method_options.sepa_debit`, `PaymentIntent.payment_method_options.sofort`, and `PaymentIntent.payment_method_options.wechat_pay`
+* Add support for new values `bbpos_wisepad3` and `stripe_m2` on enum `terminal.ReaderListParams.device_type`
+* Add generated test for the endpoints introduced in #1312
diff --git a/.hark/changes/2022-02-26_richardm_api-updates.change.md b/.hark/changes/2022-02-26_richardm_api-updates.change.md
new file mode 100644
index 00000000000..34cf3c95438
--- /dev/null
+++ b/.hark/changes/2022-02-26_richardm_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1315
+is_stripe_api_change: true
+released_in_version: 20.102.0
+---
+
+* Add support for `konbini_payments` on `AccountUpdateParams.capabilities`, `AccountCreateParams.capabilities`, and `Account.capabilities`
+* Add support for .payment_method_options.konbini and .payment_method_data.konbini on the PaymentIntent API.
+* Add support for .payment_settings.payment_method_options.konbini on the Invoice API.
+* Add support for .payment_method_options.konbini on the Subscription API
+* Add support for .payment_method_options.konbini on the checkout.Session API
+* Add support for `konbini_display_details` on `PaymentIntent.next_action`
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 00000000000..1aa6f2091aa
--- /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-java/pull/1319
+is_stripe_api_change: true
+released_in_version: 20.103.0
+---
+
+* Add support for `deletes_after` on `TestHelpers.TestClock`
diff --git a/.hark/changes/2022-03-01_richardm_api-updates_2.change.md b/.hark/changes/2022-03-01_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..ece215f4979
--- /dev/null
+++ b/.hark/changes/2022-03-01_richardm_api-updates_2.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1318
+is_stripe_api_change: true
+released_in_version: 20.103.0
+---
+
+* Add support for new resource `TestHelpers.TestClock`
+* Add support for `test_clock` on `CustomerCreateParams`, `Customer`, `Invoice`, `InvoiceItem`, `QuoteCreateParams`, `Quote`, `Subscription`, and `SubscriptionSchedule`
+* Add support for `pending_invoice_items_behavior` on `InvoiceCreateParams`
+* Change type of `ProductUpdateParams.url` from `string` to `emptyStringable(string)`
+* Add support for `next_action` on `Refund`
diff --git a/.hark/changes/2022-03-02_dcr_api-updates.change.md b/.hark/changes/2022-03-02_dcr_api-updates.change.md
new file mode 100644
index 00000000000..cd0a9e6b1c0
--- /dev/null
+++ b/.hark/changes/2022-03-02_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1320
+is_stripe_api_change: true
+released_in_version: 20.104.0
+---
+
+* Add support for new resources `CreditedItems` and `ProrationDetails`
+* Add support for `proration_details` on `InvoiceLineItem`
diff --git a/.hark/changes/2022-03-09_dcr_api-updates.change.md b/.hark/changes/2022-03-09_dcr_api-updates.change.md
new file mode 100644
index 00000000000..49a25a05e8b
--- /dev/null
+++ b/.hark/changes/2022-03-09_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1323
+is_stripe_api_change: true
+released_in_version: 20.105.0
+---
+
+* Add support for `test_clock` on `CustomerListParams`
diff --git a/.hark/changes/2022-03-11_richardm_api-updates.change.md b/.hark/changes/2022-03-11_richardm_api-updates.change.md
new file mode 100644
index 00000000000..20481c80780
--- /dev/null
+++ b/.hark/changes/2022-03-11_richardm_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1324
+is_stripe_api_change: true
+released_in_version: 20.106.0
+---
+
+* Add support for `mandate` on `Charge.payment_method_details.card`
+* Add support for `mandate_options` on `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntent.payment_method_options.card`, `SetupIntentCreateParams.payment_method_options.card`, `SetupIntentUpdateParams.payment_method_options.card`, `SetupIntentConfirmParams.payment_method_options.card`, and `SetupIntent.payment_method_options.card`
+* Add support for `card_await_notification` on `PaymentIntent.next_action`
+* Add support for `customer_notification` on `PaymentIntent.processing.card`
+* Change `PaymentLinkCreateParams.line_items` to be required
diff --git a/.hark/changes/2022-03-11_yejia_delete-paymentinten-java.change.md b/.hark/changes/2022-03-11_yejia_delete-paymentinten-java.change.md
new file mode 100644
index 00000000000..9c8195345c1
--- /dev/null
+++ b/.hark/changes/2022-03-11_yejia_delete-paymentinten-java.change.md
@@ -0,0 +1,5 @@
+---
+title: Delete PaymentIntentTypeSpecificPaymentMethodOptionsClient.java
+pr_url: https://github.com/stripe/stripe-java/pull/1321
+released_in_version: 20.106.0
+---
diff --git a/.hark/changes/2022-03-17_pakrym_update-searchresult-pagination.change.md b/.hark/changes/2022-03-17_pakrym_update-searchresult-pagination.change.md
new file mode 100644
index 00000000000..4558a26c8b4
--- /dev/null
+++ b/.hark/changes/2022-03-17_pakrym_update-searchresult-pagination.change.md
@@ -0,0 +1,5 @@
+---
+title: Update SearchResult pagination to match new API shape. This is a breaking change but the object shape is not exposed in the API currently and is therefore not being used.
+pr_url: https://github.com/stripe/stripe-java/pull/1326
+released_in_version: 20.107.0
+---
diff --git a/.hark/changes/2022-03-18_dcr_api-updates.change.md b/.hark/changes/2022-03-18_dcr_api-updates.change.md
new file mode 100644
index 00000000000..48c43c578fe
--- /dev/null
+++ b/.hark/changes/2022-03-18_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1327
+is_stripe_api_change: true
+released_in_version: 20.107.0
+---
+
+* Add support for `status` on `Card`
diff --git a/.hark/changes/2022-03-18_dcr_upgrade-gson-dependency.change.md b/.hark/changes/2022-03-18_dcr_upgrade-gson-dependency.change.md
new file mode 100644
index 00000000000..5be64ac227d
--- /dev/null
+++ b/.hark/changes/2022-03-18_dcr_upgrade-gson-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade GSON dependency to 2.9.0
+pr_url: https://github.com/stripe/stripe-java/pull/1322
+released_in_version: 20.107.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 00000000000..4afae46fe5a
--- /dev/null
+++ b/.hark/changes/2022-03-23_dcr_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1328
+is_stripe_api_change: true
+released_in_version: 20.108.0
+---
+
+* Add support for `cancel` method on resource `Refund`
+* Add support for new values `bg_uic`, `hu_tin`, and `si_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+* Add support for `test_clock` on `QuoteListParams`
+* Add support for new values `test_helpers.test_clock.advancing`, `test_helpers.test_clock.created`, `test_helpers.test_clock.deleted`, `test_helpers.test_clock.internal_failure`, and `test_helpers.test_clock.ready` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2022-03-25_yejia_api-updates.change.md b/.hark/changes/2022-03-25_yejia_api-updates.change.md
new file mode 100644
index 00000000000..d0a0d76e29a
--- /dev/null
+++ b/.hark/changes/2022-03-25_yejia_api-updates.change.md
@@ -0,0 +1,45 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1329
+is_stripe_api_change: true
+released_in_version: 20.109.0
+---
+
+* Add support for PayNow and US Bank Accounts Debits payments
+    * **Charge** ([API ref](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details))
+        * Add support for `paynow` and `us_bank_account` on `Charge.payment_method_details`
+    * **Customer** ([API ref](https://stripe.com/docs/api/payment_methods/customer_list#list_customer_payment_methods-type))
+        * Add support for new values `paynow` and `us_bank_account` on enum `CustomerListPaymentMethodsParams.type`
+    * **Mandate** ([API ref](https://stripe.com/docs/api/mandates/object#mandate_object-payment_method_details))
+        * Add support for `us_bank_account` on `Mandate.payment_method_details`
+    * **Payment Intent** ([API ref](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method_options))
+        * Add support for `paynow` and `us_bank_account` on `payment_method_options` on `PaymentIntent`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, and `PaymentIntentConfirmParams`
+        * Add support for `paynow` and `us_bank_account` on `payment_method_data` on `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, and `PaymentIntentConfirmParams`
+        * Add support for `paynow_display_qr_code` on `PaymentIntent.next_action`
+        * Add support for new values `paynow` and `us_bank_account` on enums `payment_method_data.type` on `PaymentIntentCreateParams`, and `PaymentIntentUpdateParams`, and `PaymentIntentConfirmParams`
+    * **Setup Intent** ([API ref](https://stripe.com/docs/api/setup_intents/object#setup_intent_object-payment_method_options))
+        * Add support for `us_bank_account` on `payment_method_options` on `SetupIntent`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntentConfirmParams`
+    * **Setup Attempt** ([API ref](https://stripe.com/docs/api/setup_attempts/object#setup_attempt_object-payment_method_details))
+        * Add support for `us_bank_account` on `SetupAttempt.payment_method_details`
+    * **Payment Method** ([API ref](https://stripe.com/docs/api/payment_methods/object#payment_method_object-paynow))
+        * Add support for `paynow` and `us_bank_account` on `PaymentMethod` and `PaymentMethodCreateParams`
+        * Add support for `us_bank_account` on `PaymentMethodUpdateParams`
+        * Add support for new values `paynow` and `us_bank_account` on enums `PaymentMethod.type`, `PaymentMethodCreateParams.type`. and `PaymentMethodListParams.type`
+    * **Checkout Session** ([API ref](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_method_types))
+        * Add support for `us_bank_account` on `payment_method_options` on `Checkout.Session` and `checkout.SessionCreateParams`
+        * Add support for new values `paynow` and `us_bank_account` on enum `checkout.SessionCreateParams.payment_method_types[]`
+    * **Invoice** ([API ref](https://stripe.com/docs/api/invoices/object#invoice_object-payment_settings-payment_method_types))
+        * Add support for `us_bank_account` on `payment_settings.payment_method_options` on `Invoice`, `InvoiceCreateParams`, and `InvoiceUpdateParams`
+        * Add support for new values `paynow` and `us_bank_account` on enums `payment_settings.payment_method_types[]` on `Invoice`, `InvoiceCreateParams`, and `InvoiceUpdateParams`
+    * **Subscription** ([API ref](https://stripe.com/docs/api/subscriptions/object#subscription_object-payment_settings-payment_method_types))
+        * Add support for `us_bank_account` on `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
+        * Add support for new values `paynow` and `us_bank_account` on enums `payment_settings.payment_method_types[]` on `Subscription`, `SubscriptionCreateParams`, and `SubscriptionUpdateParams`
+    * **Account capabilities** ([API ref](https://stripe.com/docs/api/accounts/object#account_object-capabilities))
+        * Add support for `paynow_payments` on `capabilities` on `Account`, `AccountCreateParams`, and `AccountUpdateParams`
+* Add support for `failure_balance_transaction` on `Charge`
+* Add support for `capture_method` on `afterpay_clearpay`, `card`, and `klarna` on `payment_method_options` on
+`PaymentIntent`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, and `PaymentIntentConfirmParams` ([API ref](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method_options-afterpay_clearpay-capture_method))
+* Add additional support for verify microdeposits on Payment Intent and Setup Intent ([API ref](https://stripe.com/docs/api/payment_intents/verify_microdeposits))
+    * Add support for `microdeposit_type` on `next_action.verify_with_microdeposits` on `PaymentIntent` and `SetupIntent`
+    * Add support for `descriptor_code` on `PaymentIntentVerifyMicrodepositsParams` and `SetupIntentVerifyMicrodepositsParams`
+* Add support for `test_clock` on `SubscriptionListParams` ([API ref](https://stripe.com/docs/api/subscriptions/list#list_subscriptions-test_clock))
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 00000000000..1d230115f5e
--- /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-java/pull/1330
+is_stripe_api_change: true
+released_in_version: 20.110.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-29_pakrym_api-updates.change.md b/.hark/changes/2022-03-29_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..b68d6f3a058
--- /dev/null
+++ b/.hark/changes/2022-03-29_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1332
+is_stripe_api_change: true
+released_in_version: 20.111.0
+---
+
+* Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
+* Add support for `action` on `Terminal.Reader`
diff --git a/.hark/changes/2022-03-30_pakrym_pin-jdk-version.change.md b/.hark/changes/2022-03-30_pakrym_pin-jdk-version.change.md
new file mode 100644
index 00000000000..f60763a3fcb
--- /dev/null
+++ b/.hark/changes/2022-03-30_pakrym_pin-jdk-version.change.md
@@ -0,0 +1,7 @@
+---
+title: Pin JDK version and always build using Java 18
+pr_url: https://github.com/stripe/stripe-java/pull/1331
+released_in_version: 20.112.0
+---
+
+* This only impacts development and it's not a breaking change for users. We still support Java 1.8 and later.
diff --git a/.hark/changes/2022-04-01_kamil_api-updates.change.md b/.hark/changes/2022-04-01_kamil_api-updates.change.md
new file mode 100644
index 00000000000..a469f9f18e6
--- /dev/null
+++ b/.hark/changes/2022-04-01_kamil_api-updates.change.md
@@ -0,0 +1,14 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1333
+is_stripe_api_change: true
+released_in_version: 20.112.0
+---
+
+* Add support for `bank_transfer_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `capture_before` on `Charge.payment_method_details.card_present`
+* Add support for `address` and `name` on `Checkout.Session.customer_details`
+* Add support for `customer_balance` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
+* Add support for new value `customer_balance` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for `request_extended_authorization` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
+* Add support for new values `payment_intent.partially_funded`, `terminal.reader.action_failed`, and `terminal.reader.action_succeeded` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..9e32ad1e676
--- /dev/null
+++ b/.hark/changes/2022-04-08_kamil_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1335
+is_stripe_api_change: true
+released_in_version: 20.113.0
+---
+
+* Add support for `apply_customer_balance` method on resource `PaymentIntent`
+* Add support for new value `cash_balance.funds_available` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..8d15fe3f5df
--- /dev/null
+++ b/.hark/changes/2022-04-13_richardm_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1336
+is_stripe_api_change: true
+released_in_version: 20.114.0
+---
+
+* Add support for `increment_authorization` method on resource `PaymentIntent`
+* Add support for `incremental_authorization_supported` on `Charge.payment_method_details.card_present`
+* Add support for `request_incremental_authorization_support` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
diff --git a/.hark/changes/2022-04-14_richardm_add-support-putextrapara.change.md b/.hark/changes/2022-04-14_richardm_add-support-putextrapara.change.md
new file mode 100644
index 00000000000..4e2df019769
--- /dev/null
+++ b/.hark/changes/2022-04-14_richardm_add-support-putextrapara.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for putExtraParam on EphemeralKeyCreateParams
+pr_url: https://github.com/stripe/stripe-java/pull/1338
+released_in_version: 20.114.0
+---
diff --git a/.hark/changes/2022-04-20_richardm_api-updates.change.md b/.hark/changes/2022-04-20_richardm_api-updates.change.md
new file mode 100644
index 00000000000..7b65c824484
--- /dev/null
+++ b/.hark/changes/2022-04-20_richardm_api-updates.change.md
@@ -0,0 +1,16 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1339
+is_stripe_api_change: true
+released_in_version: 20.115.0
+---
+
+* Add support for new resources `FundingInstructions` and `Terminal.Configuration`
+* Add support for `create_funding_instructions` method on resource `Customer`
+* Add support for `customer_balance` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntent<Method>Params.payment_method_data`, `PaymentIntent<Method>Params.payment_method_options`, `PaymentMethodCreateParams`, and `PaymentMethod`
+* Add support for `cash_balance` on `CustomerCreateParams` and `CustomerUpdateParams`
+* Add support for new value `customer_balance` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodListParams.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, and `PaymentIntentUpdateParams.payment_method_data.type`
+* Add support for `amount_details` on `PaymentIntent`
+* Add support for `display_bank_transfer_instructions` on `PaymentIntent.next_action`
+* Add support for new value `customer_balance` on enum `PaymentMethodCreateParams.type`
+* Add support for `configuration_overrides` on `Terminal.Location`, `terminal.LocationCreateParams`, and `terminal.LocationUpdateParams`
diff --git a/.hark/changes/2022-04-21_dcr_add-null-checks.change.md b/.hark/changes/2022-04-21_dcr_add-null-checks.change.md
new file mode 100644
index 00000000000..06190835926
--- /dev/null
+++ b/.hark/changes/2022-04-21_dcr_add-null-checks.change.md
@@ -0,0 +1,5 @@
+---
+title: Add null checks before streaming expandable IDs in setters.
+pr_url: https://github.com/stripe/stripe-java/pull/1342
+released_in_version: 20.116.0
+---
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 00000000000..de0faa9fa73
--- /dev/null
+++ b/.hark/changes/2022-04-21_richardm_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1345
+is_stripe_api_change: true
+released_in_version: 20.116.0
+---
+
+* Add support for `expire` test helper method on resource `Refund`
+* Change type of `BillingPortal.Configuration.application` from `string` to `expandable($Application)`
+* Change `issuing.DisputeCreateParams.transaction` to be optional
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 00000000000..3b3d0a267bd
--- /dev/null
+++ b/.hark/changes/2022-05-03_dcr_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1346
+is_stripe_api_change: true
+released_in_version: 20.117.0
+---
+
+* Add support for new resource `CashBalance`
+* Change type of `BillingPortal.Configuration.application` from `$Application` to `deletable($Application)`
+* Add support for `alipay` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `eu_oss_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+* Add support for `cash_balance` on `Customer`
+* Add support for `application` on `Invoice`, `Quote`, `SubscriptionSchedule`, and `Subscription`
diff --git a/.hark/changes/2022-05-04_dcr_api-updates.change.md b/.hark/changes/2022-05-04_dcr_api-updates.change.md
new file mode 100644
index 00000000000..a2f9d1915c3
--- /dev/null
+++ b/.hark/changes/2022-05-04_dcr_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1347
+is_stripe_api_change: true
+released_in_version: 20.118.0
+---
+
+* Add support for `registered_address` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+* Add support for `payment_method_data` on `SetupIntentConfirmParams`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
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 00000000000..02be87ea5f9
--- /dev/null
+++ b/.hark/changes/2022-05-05_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1349
+is_stripe_api_change: true
+released_in_version: 20.119.0
+---
+
+* Add support for `default_price_data` on `ProductCreateParams`
+* Add support for `default_price` on `ProductUpdateParams` and `Product`
+* Add support for `instructions_email` on `RefundCreateParams` and `Refund`
diff --git a/.hark/changes/2022-05-05_dcr_api-updates_2.change.md b/.hark/changes/2022-05-05_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..a5bde955411
--- /dev/null
+++ b/.hark/changes/2022-05-05_dcr_api-updates_2.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1348
+is_stripe_api_change: true
+released_in_version: 20.118.0
+---
+
+* Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
+* Add support for `financial_connections` on `Checkout.Session.payment_method_options.us_bank_account`, `checkout.SessionCreateParams.payment_method_options.us_bank_account`, `Invoice.payment_settings.payment_method_options.us_bank_account`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `SetupIntent.payment_method_options.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, `SetupIntentUpdateParams.payment_method_options.us_bank_account`, `Subscription.payment_settings.payment_method_options.us_bank_account`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account`
+* Add support for `financial_connections_account` on `PaymentIntentConfirmParams.payment_method_data.us_bank_account`, `PaymentIntentCreateParams.payment_method_data.us_bank_account`, `PaymentIntentUpdateParams.payment_method_data.us_bank_account`, `PaymentMethod.us_bank_account`, `PaymentMethodCreateParams.us_bank_account`, `SetupIntentConfirmParams.payment_method_data.us_bank_account`, `SetupIntentCreateParams.payment_method_data.us_bank_account`, and `SetupIntentUpdateParams.payment_method_data.us_bank_account`
diff --git a/.hark/changes/2022-05-11_richardm_api-updates.change.md b/.hark/changes/2022-05-11_richardm_api-updates.change.md
new file mode 100644
index 00000000000..c597c827362
--- /dev/null
+++ b/.hark/changes/2022-05-11_richardm_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1351
+is_stripe_api_change: true
+released_in_version: 20.120.0
+---
+
+* Add support for `description` on `checkout.SessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `consent_collection`, `payment_intent_data`, `shipping_options`, `submit_type`, and `tax_id_collection` on `PaymentLinkCreateParams` and `PaymentLink`
+* Add support for `customer_creation` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `metadata` on `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, and `SubscriptionScheduleUpdateParams.phases[]`
+* Add support for new value `billing_portal.session.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2022-05-11_richardm_api-updates_2.change.md b/.hark/changes/2022-05-11_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..d47c99048a1
--- /dev/null
+++ b/.hark/changes/2022-05-11_richardm_api-updates_2.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1350
+is_stripe_api_change: true
+released_in_version: 20.120.0
+---
+
+* Add support for `amount_discount`, `amount_tax`, and `product` on `LineItem`
diff --git a/.hark/changes/2022-05-12_pakrym_publish-java-package.change.md b/.hark/changes/2022-05-12_pakrym_publish-java-package.change.md
new file mode 100644
index 00000000000..c4a57e432ea
--- /dev/null
+++ b/.hark/changes/2022-05-12_pakrym_publish-java-package.change.md
@@ -0,0 +1,5 @@
+---
+title: Publish Java package from Github actions
+pr_url: https://github.com/stripe/stripe-java/pull/1340
+released_in_version: 20.121.0
+---
diff --git a/.hark/changes/2022-05-13_pakrym_finish-automated-java.change.md b/.hark/changes/2022-05-13_pakrym_finish-automated-java.change.md
new file mode 100644
index 00000000000..e3d9bedaba7
--- /dev/null
+++ b/.hark/changes/2022-05-13_pakrym_finish-automated-java.change.md
@@ -0,0 +1,5 @@
+---
+title: Finish automated Java releases
+pr_url: https://github.com/stripe/stripe-java/pull/1352
+released_in_version: 20.121.0
+---
diff --git a/.hark/changes/2022-05-13_pakrym_update-readme-new.change.md b/.hark/changes/2022-05-13_pakrym_update-readme-new.change.md
new file mode 100644
index 00000000000..24b1088f649
--- /dev/null
+++ b/.hark/changes/2022-05-13_pakrym_update-readme-new.change.md
@@ -0,0 +1,5 @@
+---
+title: Update readme with new jar download URL
+pr_url: https://github.com/stripe/stripe-java/pull/1353
+released_in_version: 20.121.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 00000000000..7a5def59189
--- /dev/null
+++ b/.hark/changes/2022-05-20_dcr_api-updates.change.md
@@ -0,0 +1,20 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1354
+is_stripe_api_change: true
+released_in_version: 20.121.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`
+* Change `billingportal.ConfigurationCreateParams.features.customer_update.allowed_updates` to be optional
+* Add support for `afterpay_clearpay`, `au_becs_debit`, `bacs_debit`, `eps`, `fpx`, `giropay`, `grabpay`, `klarna`, `paynow`, and `sepa_debit` on `Checkout.Session.payment_method_options`
+* Add support for `treasury` on `Issuing.Authorization`, `Issuing.Dispute`, `Issuing.Transaction`, and `issuing.DisputeCreateParams`
+* Add support for `financial_account` on `Issuing.Card` and `issuing.CardCreateParams`
+* Add support for `client_secret` on `Order`
+* Add support for `networks` on `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `PaymentMethod.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, and `SetupIntentUpdateParams.payment_method_options.us_bank_account`
+* Add support for `attach_to_self` and `flow_directions` on `SetupIntent`
+* Add support for `save_default_payment_method` on `Subscription.payment_settings`, `SubscriptionCreateParams.payment_settings`, and `SubscriptionUpdateParams.payment_settings`
+* Add support for `czk` on `Terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for new values `treasury.credit_reversal.created`, `treasury.credit_reversal.posted`, `treasury.debit_reversal.completed`, `treasury.debit_reversal.created`, `treasury.debit_reversal.initial_credit_granted`, `treasury.financial_account.closed`, `treasury.financial_account.created`, `treasury.financial_account.features_status_updated`, `treasury.inbound_transfer.canceled`, `treasury.inbound_transfer.created`, `treasury.inbound_transfer.failed`, `treasury.inbound_transfer.succeeded`, `treasury.outbound_payment.canceled`, `treasury.outbound_payment.created`, `treasury.outbound_payment.expected_arrival_date_updated`, `treasury.outbound_payment.failed`, `treasury.outbound_payment.posted`, `treasury.outbound_payment.returned`, `treasury.outbound_transfer.canceled`, `treasury.outbound_transfer.created`, `treasury.outbound_transfer.expected_arrival_date_updated`, `treasury.outbound_transfer.failed`, `treasury.outbound_transfer.posted`, `treasury.outbound_transfer.returned`, `treasury.received_credit.created`, `treasury.received_credit.failed`, `treasury.received_credit.reversed`, `treasury.received_credit.succeeded`, and `treasury.received_debit.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2022-05-20_pakrym_revert-master-trigger.change.md b/.hark/changes/2022-05-20_pakrym_revert-master-trigger.change.md
new file mode 100644
index 00000000000..71ffe2a64b4
--- /dev/null
+++ b/.hark/changes/2022-05-20_pakrym_revert-master-trigger.change.md
@@ -0,0 +1,5 @@
+---
+title: Revert master trigger
+pr_url: https://github.com/stripe/stripe-java/pull/1357
+released_in_version: 20.122.0
+---
diff --git a/.hark/changes/2022-05-20_pakrym_temporary-allow-triggering.change.md b/.hark/changes/2022-05-20_pakrym_temporary-allow-triggering.change.md
new file mode 100644
index 00000000000..33b206e7d33
--- /dev/null
+++ b/.hark/changes/2022-05-20_pakrym_temporary-allow-triggering.change.md
@@ -0,0 +1,5 @@
+---
+title: Temporary allow triggering docs push from master
+pr_url: https://github.com/stripe/stripe-java/pull/1356
+released_in_version: 20.122.0
+---
diff --git a/.hark/changes/2022-05-20_pakrym_use-github-actor.change.md b/.hark/changes/2022-05-20_pakrym_use-github-actor.change.md
new file mode 100644
index 00000000000..ccce0dc0824
--- /dev/null
+++ b/.hark/changes/2022-05-20_pakrym_use-github-actor.change.md
@@ -0,0 +1,5 @@
+---
+title: Use github.actor as GRGIT_USER
+pr_url: https://github.com/stripe/stripe-java/pull/1355
+released_in_version: 20.122.0
+---
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 00000000000..7ef559f0138
--- /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-java/pull/1360
+is_stripe_api_change: true
+released_in_version: 20.124.0
+---
+
+* Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
diff --git a/.hark/changes/2022-05-23_pakrym_api-updates_2.change.md b/.hark/changes/2022-05-23_pakrym_api-updates_2.change.md
new file mode 100644
index 00000000000..c8ef2a2423e
--- /dev/null
+++ b/.hark/changes/2022-05-23_pakrym_api-updates_2.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1360
+is_stripe_api_change: true
+released_in_version: 20.123.0
+---
+
+* Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
diff --git a/.hark/changes/2022-05-23_pakrym_api-updates_3.change.md b/.hark/changes/2022-05-23_pakrym_api-updates_3.change.md
new file mode 100644
index 00000000000..57cbce62927
--- /dev/null
+++ b/.hark/changes/2022-05-23_pakrym_api-updates_3.change.md
@@ -0,0 +1,14 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1359
+is_stripe_api_change: true
+released_in_version: 20.122.0
+---
+
+* Add support for new resource `Apps.Secret`
+* Add support for `affirm` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `link` on `Charge.payment_method_details`, `Mandate.payment_method_details`, `OrderCreateParams.payment.settings.payment_method_options`, `OrderUpdateParams.payment.settings.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for new values `affirm` and `link` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for new value `link` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for new values `affirm` and `link` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new values `affirm` and `link` on enum `PaymentMethodCreateParams.type`
diff --git a/.hark/changes/2022-05-23_pakrym_fix-version-update.change.md b/.hark/changes/2022-05-23_pakrym_fix-version-update.change.md
new file mode 100644
index 00000000000..187db4327c0
--- /dev/null
+++ b/.hark/changes/2022-05-23_pakrym_fix-version-update.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix version update script and the version in README.md
+pr_url: https://github.com/stripe/stripe-java/pull/1361
+released_in_version: 20.124.0
+---
diff --git a/.hark/changes/2022-05-26_pakrym_api-updates.change.md b/.hark/changes/2022-05-26_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..3372e9b0c0c
--- /dev/null
+++ b/.hark/changes/2022-05-26_pakrym_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1363
+is_stripe_api_change: true
+released_in_version: 20.124.0
+---
+
+* Add support for `affirm_payments` and `link_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `id_number_secondary` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+* Add support for new value `affirm` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for `hosted_instructions_url` on `PaymentIntent.next_action.display_bank_transfer_instructions`
+* Add support for `id_number_secondary_provided` on `Person`
+* Add support for `card_issuing` on `treasury.FinancialAccountCreateParams.features`, `treasury.FinancialAccountUpdateFeaturesParams`, and `treasury.FinancialAccountUpdateParams.features`
diff --git a/.hark/changes/2022-06-01_dcr_api-updates.change.md b/.hark/changes/2022-06-01_dcr_api-updates.change.md
new file mode 100644
index 00000000000..7597ed64883
--- /dev/null
+++ b/.hark/changes/2022-06-01_dcr_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1366
+is_stripe_api_change: true
+released_in_version: 20.125.0
+---
+
+* Add support for `radar_options` on `ChargeCreateParams`, `Charge`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `account_holder_name`, `account_number`, `account_type`, `bank_code`, `bank_name`, `branch_code`, and `branch_name` on `FundingInstructions.bank_transfer.financial_addresses[].zengin` and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin`
+* Add support for new values `en-AU` and `en-NZ` on enums `OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
+* Change type of `Order.payment.settings.payment_method_options.customer_balance.bank_transfer.type` and `PaymentIntent.payment_method_options.customer_balance.bank_transfer.type` from `enum` to `literal('jp_bank_transfer')`
+* Add support for `network` on `SetupIntent.payment_method_options.card`
+* Add support for new value `simulated_wisepos_e` on enum `terminal.ReaderListParams.device_type`
diff --git a/.hark/changes/2022-06-02_pakrym_api-updates.change.md b/.hark/changes/2022-06-02_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..0b8736b6d96
--- /dev/null
+++ b/.hark/changes/2022-06-02_pakrym_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1367
+is_stripe_api_change: true
+released_in_version: 20.126.0
+---
+
+* Add support for `create` test helper on `ReceivedCredit`.
+* Add support for `create` test helper on `ReceivedDebit`.
+* Deprecates the ability to directly create instances of inner `TestHelper` classes.
diff --git a/.hark/changes/2022-06-08_pakrym_api-updates.change.md b/.hark/changes/2022-06-08_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..e7e08d515fe
--- /dev/null
+++ b/.hark/changes/2022-06-08_pakrym_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1369
+is_stripe_api_change: true
+released_in_version: 20.127.0
+---
+
+* Add support for `affirm`, `bancontact`, `card`, `ideal`, `p24`, and `sofort` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `afterpay_clearpay`, `au_becs_debit`, `bacs_debit`, `eps`, `fpx`, `giropay`, `grabpay`, `klarna`, `paynow`, and `sepa_debit` on `checkout.SessionCreateParams.payment_method_options`
+* Add support for `setup_future_usage` on `Checkout.Session.payment_method_options.acss_debit`, `Checkout.Session.payment_method_options.afterpay_clearpay`, `Checkout.Session.payment_method_options.alipay`, `Checkout.Session.payment_method_options.au_becs_debit`, `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.boleto`, `Checkout.Session.payment_method_options.eps`, `Checkout.Session.payment_method_options.fpx`, `Checkout.Session.payment_method_options.giropay`, `Checkout.Session.payment_method_options.grabpay`, `Checkout.Session.payment_method_options.klarna`, `Checkout.Session.payment_method_options.konbini`, `Checkout.Session.payment_method_options.oxxo`, `Checkout.Session.payment_method_options.paynow`, `Checkout.Session.payment_method_options.sepa_debit`, `Checkout.Session.payment_method_options.us_bank_account`, `checkout.SessionCreateParams.payment_method_options.acss_debit`, `checkout.SessionCreateParams.payment_method_options.alipay`, `checkout.SessionCreateParams.payment_method_options.boleto`, `checkout.SessionCreateParams.payment_method_options.konbini`, `checkout.SessionCreateParams.payment_method_options.oxxo`, `checkout.SessionCreateParams.payment_method_options.us_bank_account`, and `checkout.SessionCreateParams.payment_method_options.wechat_pay`
+* Add support for `attach_to_self` on `SetupAttempt`, `SetupIntentCreateParams`, `SetupIntentListParams`, and `SetupIntentUpdateParams`
+* Add support for `flow_directions` on `SetupAttempt`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
diff --git a/.hark/changes/2022-06-09_pakrym_api-updates.change.md b/.hark/changes/2022-06-09_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..0540cba10c9
--- /dev/null
+++ b/.hark/changes/2022-06-09_pakrym_api-updates.change.md
@@ -0,0 +1,15 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1370
+is_stripe_api_change: true
+released_in_version: 20.128.0
+---
+
+* Add support for `treasury` on `Account.settings`, `AccountCreateParams.settings`, and `AccountUpdateParams.settings`
+* Add support for `rendering_options` on `CustomerCreateParams.invoice_settings` and `CustomerUpdateParams.invoice_settings`
+* Add support for `eu_bank_transfer` on `CustomerCreateFundingInstructionsParams.bank_transfer`, `Invoice.payment_settings.payment_method_options.customer_balance.bank_transfer`, `InvoiceCreateParams.payment_settings.payment_method_options.customer_balance.bank_transfer`, `InvoiceUpdateParams.payment_settings.payment_method_options.customer_balance.bank_transfer`, `Order.payment.settings.payment_method_options.customer_balance.bank_transfer`, `OrderCreateParams.payment.settings.payment_method_options.customer_balance.bank_transfer`, `OrderUpdateParams.payment.settings.payment_method_options.customer_balance.bank_transfer`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer`, `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer`, `Subscription.payment_settings.payment_method_options.customer_balance.bank_transfer`, `SubscriptionCreateParams.payment_settings.payment_method_options.customer_balance.bank_transfer`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.customer_balance.bank_transfer`
+* Change type of `CustomerCreateFundingInstructionsParams.bank_transfer.requested_address_types[]` from `literal('zengin')` to `enum('iban'|'sort_code'|'spei'|'zengin')`
+* Change type of `CustomerCreateFundingInstructionsParams.bank_transfer.type`, `Order.payment.settings.payment_method_options.customer_balance.bank_transfer.type`, `OrderCreateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.type`, `OrderUpdateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntent.next_action.display_bank_transfer_instructions.type`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.type`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.type` from `literal('jp_bank_transfer')` to `enum('eu_bank_transfer'|'gb_bank_transfer'|'jp_bank_transfer'|'mx_bank_transfer')`
+* Add support for `iban`, `sort_code`, and `spei` on `FundingInstructions.bank_transfer.financial_addresses[]` and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[]`
+* Change type of `Order.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderCreateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderUpdateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]` from `literal('zengin')` to `enum`
+* Add support for `custom_unit_amount` on `PriceCreateParams` and `Price`
diff --git a/.hark/changes/2022-06-13_dcr_update-readme-example.change.md b/.hark/changes/2022-06-13_dcr_update-readme-example.change.md
new file mode 100644
index 00000000000..4581c81a234
--- /dev/null
+++ b/.hark/changes/2022-06-13_dcr_update-readme-example.change.md
@@ -0,0 +1,5 @@
+---
+title: Update readme example to use typed params.
+pr_url: https://github.com/stripe/stripe-java/pull/1372
+released_in_version: 20.129.0
+---
diff --git a/.hark/changes/2022-06-14_pakrym_trigger-workflows-beta.change.md b/.hark/changes/2022-06-14_pakrym_trigger-workflows-beta.change.md
new file mode 100644
index 00000000000..83427d004b1
--- /dev/null
+++ b/.hark/changes/2022-06-14_pakrym_trigger-workflows-beta.change.md
@@ -0,0 +1,5 @@
+---
+title: Trigger workflows on beta branches
+pr_url: https://github.com/stripe/stripe-java/pull/1373
+released_in_version: 20.129.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 00000000000..3990a1d80e2
--- /dev/null
+++ b/.hark/changes/2022-06-17_kamil_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1375
+is_stripe_api_change: true
+released_in_version: 20.129.0
+---
+
+* Add support for `fund_cash_balance` test helper method on resource `Customer`
+* Add support for `statement_descriptor_prefix_kana` and `statement_descriptor_prefix_kanji` on `Account.settings.card_payments`, `Account.settings.payments`, `AccountCreateParams.settings.card_payments`, and `AccountUpdateParams.settings.card_payments`
+* Add support for `statement_descriptor_suffix_kana` and `statement_descriptor_suffix_kanji` on `Checkout.Session.payment_method_options.card`, `checkout.SessionCreateParams.payment_method_options.card`, `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, and `PaymentIntentUpdateParams.payment_method_options.card`
+* Add support for `total_excluding_tax` on `CreditNote`
+* Change type of `CustomerCreateParams.invoice_settings.rendering_options` and `CustomerUpdateParams.invoice_settings.rendering_options` from `rendering_options_param` to `emptyStringable(rendering_options_param)`
+* Add support for `rendering_options` on `Customer.invoice_settings` and `Invoice`
diff --git a/.hark/changes/2022-06-17_remi_document-how-access.change.md b/.hark/changes/2022-06-17_remi_document-how-access.change.md
new file mode 100644
index 00000000000..3a42dae9dba
--- /dev/null
+++ b/.hark/changes/2022-06-17_remi_document-how-access.change.md
@@ -0,0 +1,5 @@
+---
+title: Document how to access unsupported parameters and properties
+pr_url: https://github.com/stripe/stripe-java/pull/1376
+released_in_version: 20.130.0
+---
diff --git a/.hark/changes/2022-06-22_pakrym_use-generated-api.change.md b/.hark/changes/2022-06-22_pakrym_use-generated-api.change.md
new file mode 100644
index 00000000000..40867dda9e2
--- /dev/null
+++ b/.hark/changes/2022-06-22_pakrym_use-generated-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Use the generated API version
+pr_url: https://github.com/stripe/stripe-java/pull/1379
+released_in_version: 20.130.0
+---
diff --git a/.hark/changes/2022-06-23_dcr_api-updates.change.md b/.hark/changes/2022-06-23_dcr_api-updates.change.md
new file mode 100644
index 00000000000..00f41c40503
--- /dev/null
+++ b/.hark/changes/2022-06-23_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1380
+is_stripe_api_change: true
+released_in_version: 20.130.0
+---
+
+* Add support for `capture_method` on `PaymentIntentConfirmParams` and `PaymentIntentUpdateParams`
diff --git a/.hark/changes/2022-06-23_dcr_api-updates_2.change.md b/.hark/changes/2022-06-23_dcr_api-updates_2.change.md
new file mode 100644
index 00000000000..948b31e239f
--- /dev/null
+++ b/.hark/changes/2022-06-23_dcr_api-updates_2.change.md
@@ -0,0 +1,20 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1378
+is_stripe_api_change: true
+released_in_version: 20.130.0
+---
+
+* Add support for `promptpay_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `promptpay` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for new value `promptpay` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for `subtotal_excluding_tax` on `CreditNote` and `Invoice`
+* Add support for `amount_excluding_tax` and `unit_amount_excluding_tax` on `CreditNoteLineItem` and `InvoiceLineItem`
+* Add support for new value `promptpay` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for `rendering_options` on `InvoiceCreateParams` and `InvoiceUpdateParams`
+* Add support for new value `promptpay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for `total_excluding_tax` on `Invoice`
+* Add support for `automatic_payment_methods` on `Order.payment.settings`
+* Add support for new value `promptpay` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for `promptpay_display_qr_code` on `PaymentIntent.next_action`
+* Add support for new value `promptpay` on enum `PaymentMethodCreateParams.type`
diff --git a/.hark/changes/2022-06-29_dcr_api-updates.change.md b/.hark/changes/2022-06-29_dcr_api-updates.change.md
new file mode 100644
index 00000000000..bcb4997476f
--- /dev/null
+++ b/.hark/changes/2022-06-29_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1384
+is_stripe_api_change: true
+released_in_version: 20.131.0
+---
+
+* Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
+* Change type of `PaymentLink.payment_method_types[]`, `PaymentLinkCreateParams.payment_method_types[]`, and `PaymentLinkUpdateParams.payment_method_types[]` from `literal('card')` to `enum`
+* Add support for `hosted_regulatory_receipt_url` on `Treasury.ReceivedCredit` and `Treasury.ReceivedDebit`
diff --git a/.hark/changes/2022-07-05_pakrym_support-serializing-nested.change.md b/.hark/changes/2022-07-05_pakrym_support-serializing-nested.change.md
new file mode 100644
index 00000000000..f0dff9f6f7e
--- /dev/null
+++ b/.hark/changes/2022-07-05_pakrym_support-serializing-nested.change.md
@@ -0,0 +1,5 @@
+---
+title: Support serializing nested objects in map
+pr_url: https://github.com/stripe/stripe-java/pull/1386
+released_in_version: 20.132.0
+---
diff --git a/.hark/changes/2022-07-06_pakrym_api-updates.change.md b/.hark/changes/2022-07-06_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..194448ce0a2
--- /dev/null
+++ b/.hark/changes/2022-07-06_pakrym_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1387
+is_stripe_api_change: true
+released_in_version: 20.132.0
+---
+
+* Add support for `customer` on `checkout.SessionListParams` and `RefundCreateParams`
+* Add support for `currency` and `origin` on `RefundCreateParams`
+* Add support for new values `financial_connections.account.created`, `financial_connections.account.deactivated`, `financial_connections.account.disconnected`, `financial_connections.account.reactivated`, and `financial_connections.account.refreshed_balance` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2022-07-07_pakrym_api-updates.change.md b/.hark/changes/2022-07-07_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..d8a7d9896b8
--- /dev/null
+++ b/.hark/changes/2022-07-07_pakrym_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1388
+is_stripe_api_change: true
+released_in_version: 20.132.0
+---
+
+* Add support for `currency` on `checkout.SessionCreateParams`, `InvoiceUpcomingLinesParams`, `InvoiceUpcomingParams`, `PaymentLinkCreateParams`, `SubscriptionCreateParams`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[]`, and `Subscription`
+* Add support for `currency_options` on `checkout.SessionCreateParams.shipping_options[].shipping_rate_data.fixed_amount`, `CouponCreateParams`, `CouponUpdateParams`, `Coupon`, `OrderCreateParams.shipping_cost.shipping_rate_data.fixed_amount`, `OrderUpdateParams.shipping_cost.shipping_rate_data.fixed_amount`, `PriceCreateParams`, `PriceUpdateParams`, `Price`, `ProductCreateParams.default_price_data`, `PromotionCode.restrictions`, `PromotionCodeCreateParams.restrictions`, `ShippingRate.fixed_amount`, and `ShippingRateCreateParams.fixed_amount`
+* Add support for `restrictions` on `PromotionCodeUpdateParams`
+* Add support for `fixed_amount` and `tax_behavior` on `ShippingRateUpdateParams`
diff --git a/.hark/changes/2022-07-12_yejia_api-updates.change.md b/.hark/changes/2022-07-12_yejia_api-updates.change.md
new file mode 100644
index 00000000000..e2a65ab4eca
--- /dev/null
+++ b/.hark/changes/2022-07-12_yejia_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1390
+is_stripe_api_change: true
+released_in_version: 20.133.0
+---
+
+* Add support for `customer_details` on `checkout.SessionListParams`
diff --git a/.hark/changes/2022-07-18_pakrym_api-updates.change.md b/.hark/changes/2022-07-18_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..767028ce9b5
--- /dev/null
+++ b/.hark/changes/2022-07-18_pakrym_api-updates.change.md
@@ -0,0 +1,15 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1391
+is_stripe_api_change: true
+released_in_version: 20.134.0
+---
+
+* Add support for `blik_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `blik` on `Charge.payment_method_details`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+* Change type of `Checkout.Session.consent_collection.promotions`, `checkout.SessionCreateParams.consent_collection.promotions`, `PaymentLink.consent_collection.promotions`, and `PaymentLinkCreateParams.consent_collection.promotions` from `literal('auto')` to `enum('auto'|'none')`
+* Add support for new value `blik` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new value `blik` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for new value `blik` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `blik` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for new value `blik` on enum `PaymentMethodCreateParams.type`
diff --git a/.hark/changes/2022-07-25_dcr_api-updates.change.md b/.hark/changes/2022-07-25_dcr_api-updates.change.md
new file mode 100644
index 00000000000..65a4ae297ec
--- /dev/null
+++ b/.hark/changes/2022-07-25_dcr_api-updates.change.md
@@ -0,0 +1,12 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1402
+is_stripe_api_change: true
+released_in_version: 20.135.0
+---
+
+* Add support for `installments` on `Checkout.Session.payment_method_options.card`, `checkout.SessionCreateParams.payment_method_options.card`, `Invoice.payment_settings.payment_method_options.card`, `InvoiceCreateParams.payment_settings.payment_method_options.card`, and `InvoiceUpdateParams.payment_settings.payment_method_options.card`
+* Add support for `default_currency` and `invoice_credit_balance` on `Customer`
+* Add support for `currency` on `InvoiceCreateParams`
+* Add support for `default_mandate` on `Invoice.payment_settings`, `InvoiceCreateParams.payment_settings`, and `InvoiceUpdateParams.payment_settings`
+* Add support for `mandate` on `InvoicePayParams`
diff --git a/.hark/changes/2022-07-26_dcr_api-updates.change.md b/.hark/changes/2022-07-26_dcr_api-updates.change.md
new file mode 100644
index 00000000000..5d85342cd51
--- /dev/null
+++ b/.hark/changes/2022-07-26_dcr_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1406
+is_stripe_api_change: true
+released_in_version: 20.136.0
+---
+
+* Add support for `customer_balance` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `customer_balance` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new values `en-CA` and `fr-CA` on enums `OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
diff --git a/.hark/changes/2022-07-26_dcr_chore-update-gson.change.md b/.hark/changes/2022-07-26_dcr_chore-update-gson.change.md
new file mode 100644
index 00000000000..5fb44c6e5ed
--- /dev/null
+++ b/.hark/changes/2022-07-26_dcr_chore-update-gson.change.md
@@ -0,0 +1,5 @@
+---
+title: "chore: Update gson version in README."
+pr_url: https://github.com/stripe/stripe-java/pull/1405
+released_in_version: 20.136.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 00000000000..b57110c642c
--- /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-java/pull/1407
+is_stripe_api_change: true
+released_in_version: 21.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 00000000000..f2f560523a6
--- /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-java/pull/1409
+is_stripe_api_change: true
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-apikeymissin.change.md b/.hark/changes/2022-08-02_unknown_add-apikeymissin.change.md
new file mode 100644
index 00000000000..f19d2f4174f
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-apikeymissin.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `ApiKeyMissingException`.
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-shippingcost-shippingdeta.change.md b/.hark/changes/2022-08-02_unknown_add-shippingcost-shippingdeta.change.md
new file mode 100644
index 00000000000..0c059609b0e
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-shippingcost-shippingdeta.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `shippingCost`, `shippingDetails`, and `shippingOptions` properties to `checkout.Session` resource.
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-support-new.change.md b/.hark/changes/2022-08-02_unknown_add-support-new.change.md
new file mode 100644
index 00000000000..b97e0bc2438
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-support-new.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for new value `2022-08-01` on enum `WebhookEndpointCreateParams.api_version`
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-support-shippingcost.change.md b/.hark/changes/2022-08-02_unknown_add-support-shippingcost.change.md
new file mode 100644
index 00000000000..fdb88825271
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-support-shippingcost.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `shipping_cost` and `shipping_details` on `Checkout.Session`
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-validate-field.change.md b/.hark/changes/2022-08-02_unknown_add-validate-field.change.md
new file mode 100644
index 00000000000..53dc98f278d
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-validate-field.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `validate` field to `CustomerCreateParams`.
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-validate-field_2.change.md b/.hark/changes/2022-08-02_unknown_add-validate-field_2.change.md
new file mode 100644
index 00000000000..da69a2d3a54
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-validate-field_2.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `validate` field to `CustomerUpdateParams`.
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_add-validate-field_3.change.md b/.hark/changes/2022-08-02_unknown_add-validate-field_3.change.md
new file mode 100644
index 00000000000..8161264600d
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_add-validate-field_3.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `validate` field to `PaymentSourceCollectionCreateParams`.
+section: Added
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_changed-cashbalance-retrieve.change.md b/.hark/changes/2022-08-02_unknown_changed-cashbalance-retrieve.change.md
new file mode 100644
index 00000000000..5c9bcdecf19
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_changed-cashbalance-retrieve.change.md
@@ -0,0 +1,6 @@
+---
+title: Changed `CashBalance.retrieve` method from an instance to a static.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_changed-type-businesstype.change.md b/.hark/changes/2022-08-02_unknown_changed-type-businesstype.change.md
new file mode 100644
index 00000000000..36bc54bcf3d
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_changed-type-businesstype.change.md
@@ -0,0 +1,6 @@
+---
+title: Changed type of `businessType` field in `AccountCreateParams` from `Object` to `BusinessType`
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_check-apikey-set.change.md b/.hark/changes/2022-08-02_unknown_check-apikey-set.change.md
new file mode 100644
index 00000000000..08aff6d40d4
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_check-apikey-set.change.md
@@ -0,0 +1,6 @@
+---
+title: Check that apiKey is set (either globally or via request options) in `StripeCollection.autoPagingIterable` and `StripeSearchResult.autoPagingIterable`, and throw an exception if it is not.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_cleaning-up-sdk.change.md b/.hark/changes/2022-08-02_unknown_cleaning-up-sdk.change.md
new file mode 100644
index 00000000000..ee94810d920
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_cleaning-up-sdk.change.md
@@ -0,0 +1,4 @@
+---
+title: Cleaning up the SDK to remove deprecated/unused APIs and rename classes/methods/properties to sync with product APIs. Read more detailed description at https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v21.
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_default-api-version.change.md b/.hark/changes/2022-08-02_unknown_default-api-version.change.md
new file mode 100644
index 00000000000..d8c57f7b4eb
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_default-api-version.change.md
@@ -0,0 +1,6 @@
+---
+title: Default API version changed to "2022-07-28".
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_moving-use-new.change.md b/.hark/changes/2022-08-02_unknown_moving-use-new.change.md
new file mode 100644
index 00000000000..94d5f8ea9d1
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_moving-use-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Moving to use the new API version "2022-08-01". To learn more about these changes to Stripe products, see https://docs.stripe.com/changelog/2022-08-01
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-cashbalance-retrievecash.change.md b/.hark/changes/2022-08-02_unknown_removed-cashbalance-retrievecash.change.md
new file mode 100644
index 00000000000..f76609c2302
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-cashbalance-retrievecash.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `CashBalance.retrieveCashBalance` method. Prefer `CashBalance.retrieve`.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-defaultcurre-property.change.md b/.hark/changes/2022-08-02_unknown_removed-defaultcurre-property.change.md
new file mode 100644
index 00000000000..d073d4ceaca
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-defaultcurre-property.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `defaultCurrency` property from `Customer` resource. Please use `Currency` property instead.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.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 00000000000..657edb91b95
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-alipayaccoun.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `AlipayAccount` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcoinrecei.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcoinrecei.change.md
new file mode 100644
index 00000000000..9f684cf1217
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcoinrecei.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `BitcoinReceiver` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcointrans.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcointrans.change.md
new file mode 100644
index 00000000000..1f4e14beb88
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-bitcointrans.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `BitcoinTransaction` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.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 00000000000..f333891b7f9
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-card.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Card.recipient` property.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.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 00000000000..de17af7e3de
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-charge.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Charge.order` property.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-issuerfraudr.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-issuerfraudr.change.md
new file mode 100644
index 00000000000..4a85cd6eae1
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-issuerfraudr.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `IssuerFraudRecord` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-loginlink.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-loginlink.change.md
new file mode 100644
index 00000000000..2c2ec816107
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-loginlink.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `LoginLink.redirectUrl` property.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-order.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-order.change.md
new file mode 100644
index 00000000000..4e8473f8fb9
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-order.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Order` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-recipient.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-recipient.change.md
new file mode 100644
index 00000000000..64db72f66d7
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-recipient.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Recipient` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-threedsecure.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-threedsecure.change.md
new file mode 100644
index 00000000000..65898c5d5f7
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-threedsecure.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `ThreeDSecure` and related classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-deprecated-treasuryrece.change.md b/.hark/changes/2022-08-02_unknown_removed-deprecated-treasuryrece.change.md
new file mode 100644
index 00000000000..9b4656e7521
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-deprecated-treasuryrece.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `TREASURY__RECEIVED_CREDIT__REVERSED`, `TREASURY__RECEIVED_DEBIT__CREATED`, `ORDER__UPDATED`, `ORDER_RETURN__CREATED`, `ORDER__PAYMENT_SUCCEEDED`, `TRANSFER__FAILED`, `TRANSFER__PAID` webhook events.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-initiatingpa-class.change.md b/.hark/changes/2022-08-02_unknown_removed-initiatingpa-class.change.md
new file mode 100644
index 00000000000..af1eab6dcea
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-initiatingpa-class.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `InitiatingPaymentMethodDetails` class
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-instance-account.change.md b/.hark/changes/2022-08-02_unknown_removed-instance-account.change.md
new file mode 100644
index 00000000000..bbd53e5343f
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-instance-account.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed instance `Account.refresh`, `Account.disconnect` methods.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-lineitem-getdeleted.change.md b/.hark/changes/2022-08-02_unknown_removed-lineitem-getdeleted.change.md
new file mode 100644
index 00000000000..22ab7f7b1a4
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-lineitem-getdeleted.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `LineItem.getDeleted` method. The property was never populated and always had the default value of `false`.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-public-constructors.change.md b/.hark/changes/2022-08-02_unknown_removed-public-constructors.change.md
new file mode 100644
index 00000000000..7df3dff80c0
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-public-constructors.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed public constructors from `TestHelper` inner classes and made them static.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-rule-getdeleted.change.md b/.hark/changes/2022-08-02_unknown_removed-rule-getdeleted.change.md
new file mode 100644
index 00000000000..aaeffb11f93
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-rule-getdeleted.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `Rule.getDeleted` method. The property was never populated and always had the default value of `false`.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-shipping-shippingopti.change.md b/.hark/changes/2022-08-02_unknown_removed-shipping-shippingopti.change.md
new file mode 100644
index 00000000000..8d733676c9b
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-shipping-shippingopti.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `shipping` and `shippingOptions` properties from `checkout.Session` resource. Please use `shippingCost`, `shippingDetails`, and `shippingOptions` properties instead.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-unused-billingdetai.change.md b/.hark/changes/2022-08-02_unknown_removed-unused-billingdetai.change.md
new file mode 100644
index 00000000000..ed40328d966
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-unused-billingdetai.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed unused `BillingDetails` class.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_removed-unused-quotefinaliz.change.md b/.hark/changes/2022-08-02_unknown_removed-unused-quotefinaliz.change.md
new file mode 100644
index 00000000000..a13eb8114d6
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_removed-unused-quotefinaliz.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed unused `QuoteFinalizeParams`, `QuoteCollectionListParams` classes.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_renamed-paymentinten-financialadd.change.md b/.hark/changes/2022-08-02_unknown_renamed-paymentinten-financialadd.change.md
new file mode 100644
index 00000000000..5d72432e1ec
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_renamed-paymentinten-financialadd.change.md
@@ -0,0 +1,6 @@
+---
+title: Renamed `PaymentIntent.FinancialAddresses` class to `FinancialAddress`.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 21.0.0
+---
diff --git a/.hark/changes/2022-08-05_pakrym_api-updates.change.md b/.hark/changes/2022-08-05_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..f42c147cae5
--- /dev/null
+++ b/.hark/changes/2022-08-05_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1412
+is_stripe_api_change: true
+released_in_version: 21.1.0
+---
+
+* Add support for `expires_at` on `Apps.Secret` and `apps.SecretCreateParams`
diff --git a/.hark/changes/2022-08-09_yejia_api-updates.change.md b/.hark/changes/2022-08-09_yejia_api-updates.change.md
new file mode 100644
index 00000000000..977de3e2911
--- /dev/null
+++ b/.hark/changes/2022-08-09_yejia_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1413
+is_stripe_api_change: true
+released_in_version: 21.1.0
+---
+
+* Add support for `process_config` on `Terminal.Reader.action.process_payment_intent`
diff --git a/.hark/changes/2022-08-09_yejia_stop-publishing-javadoc.change.md b/.hark/changes/2022-08-09_yejia_stop-publishing-javadoc.change.md
new file mode 100644
index 00000000000..ad9e870eaa2
--- /dev/null
+++ b/.hark/changes/2022-08-09_yejia_stop-publishing-javadoc.change.md
@@ -0,0 +1,5 @@
+---
+title: Stop publishing javadoc for beta Java SDKs
+pr_url: https://github.com/stripe/stripe-java/pull/1414
+released_in_version: 21.2.0
+---
diff --git a/.hark/changes/2022-08-11_anniel_api-updates.change.md b/.hark/changes/2022-08-11_anniel_api-updates.change.md
new file mode 100644
index 00000000000..84c897a8604
--- /dev/null
+++ b/.hark/changes/2022-08-11_anniel_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1416
+is_stripe_api_change: true
+released_in_version: 21.2.0
+---
+
+* Add support for `payment_method_collection` on `Checkout.Session`, `checkout.SessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
diff --git a/.hark/changes/2022-08-16_kamil_fix-latest-jar.change.md b/.hark/changes/2022-08-16_kamil_fix-latest-jar.change.md
new file mode 100644
index 00000000000..3ab2e8617aa
--- /dev/null
+++ b/.hark/changes/2022-08-16_kamil_fix-latest-jar.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix latest JAR hyperlink and related tests
+pr_url: https://github.com/stripe/stripe-java/pull/1418
+released_in_version: 21.3.0
+---
diff --git a/.hark/changes/2022-08-16_kamil_fix-makefile-indentation.change.md b/.hark/changes/2022-08-16_kamil_fix-makefile-indentation.change.md
new file mode 100644
index 00000000000..a9b8b071572
--- /dev/null
+++ b/.hark/changes/2022-08-16_kamil_fix-makefile-indentation.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix makefile indentation and improve regex
+pr_url: https://github.com/stripe/stripe-java/pull/1419
+released_in_version: 21.3.0
+---
diff --git a/.hark/changes/2022-08-17_kamil_fix-outdated-test.change.md b/.hark/changes/2022-08-17_kamil_fix-outdated-test.change.md
new file mode 100644
index 00000000000..e71b4b30e9d
--- /dev/null
+++ b/.hark/changes/2022-08-17_kamil_fix-outdated-test.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix outdated test comment
+pr_url: https://github.com/stripe/stripe-java/pull/1420
+released_in_version: 21.3.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 00000000000..3efc3a93d05
--- /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-java/pull/1421
+released_in_version: 21.3.0
+---
diff --git a/.hark/changes/2022-08-19_dcr_chore-remove-unused.change.md b/.hark/changes/2022-08-19_dcr_chore-remove-unused.change.md
new file mode 100644
index 00000000000..028be789f7a
--- /dev/null
+++ b/.hark/changes/2022-08-19_dcr_chore-remove-unused.change.md
@@ -0,0 +1,5 @@
+---
+title: "chore: Remove unused variable from SearchPagingIteratorTest."
+pr_url: https://github.com/stripe/stripe-java/pull/1423
+released_in_version: 21.3.0
+---
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 00000000000..f44e40eea8c
--- /dev/null
+++ b/.hark/changes/2022-08-23_dcr_api-updates.change.md
@@ -0,0 +1,15 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1422
+is_stripe_api_change: true
+released_in_version: 21.3.0
+---
+
+* Add support for new resource `CustomerCashBalanceTransaction`
+* Remove support for value `paypal` from enums `OrderCreateParams.payment.settings.payment_method_types[]` and `OrderUpdateParams.payment.settings.payment_method_types[]`
+* Add support for `currency` on `PaymentLink`
+* Add support for `network` on `SetupIntentConfirmParams.payment_method_options.card`, `SetupIntentCreateParams.payment_method_options.card`, `SetupIntentUpdateParams.payment_method_options.card`, `Subscription.payment_settings.payment_method_options.card`, `SubscriptionCreateParams.payment_settings.payment_method_options.card`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card`
+* Change `treasury.OutboundTransferCreateParams.destination_payment_method` to be optional
+* Add support for new value `customer_cash_balance_transaction.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+* Change the return type of `Customer.fundCashBalance` test helper from `CustomerBalanceTransaction` to `CustomerCashBalanceTransaction`.
+  * This would generally be considered a breaking change, but we've worked with all existing users to migrate and are comfortable releasing this as a minor as it is solely a test helper method. This was essentially broken prior to this change.
diff --git a/.hark/changes/2022-08-23_pakrym_add-beta-readme.change.md b/.hark/changes/2022-08-23_pakrym_add-beta-readme.change.md
new file mode 100644
index 00000000000..756fc7706f2
--- /dev/null
+++ b/.hark/changes/2022-08-23_pakrym_add-beta-readme.change.md
@@ -0,0 +1,5 @@
+---
+title: Add beta readme.md section
+pr_url: https://github.com/stripe/stripe-java/pull/1425
+released_in_version: 21.3.0
+---
diff --git a/.hark/changes/2022-08-24_anniel_show-test-coverage.change.md b/.hark/changes/2022-08-24_anniel_show-test-coverage.change.md
new file mode 100644
index 00000000000..88c7c960a36
--- /dev/null
+++ b/.hark/changes/2022-08-24_anniel_show-test-coverage.change.md
@@ -0,0 +1,5 @@
+---
+title: Show test coverage in README
+pr_url: https://github.com/stripe/stripe-java/pull/1428
+released_in_version: 21.4.0
+---
diff --git a/.hark/changes/2022-08-24_pakrym_update-readme-md.change.md b/.hark/changes/2022-08-24_pakrym_update-readme-md.change.md
new file mode 100644
index 00000000000..7bbda6daae8
--- /dev/null
+++ b/.hark/changes/2022-08-24_pakrym_update-readme-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README.md to clarify that API version can only be change in beta
+pr_url: https://github.com/stripe/stripe-java/pull/1427
+released_in_version: 21.4.0
+---
diff --git a/.hark/changes/2022-08-26_anniel_update-coveralls-only.change.md b/.hark/changes/2022-08-26_anniel_update-coveralls-only.change.md
new file mode 100644
index 00000000000..4b15bbfc3d2
--- /dev/null
+++ b/.hark/changes/2022-08-26_anniel_update-coveralls-only.change.md
@@ -0,0 +1,5 @@
+---
+title: Update coveralls to only run for one java version
+pr_url: https://github.com/stripe/stripe-java/pull/1431
+released_in_version: 21.5.0
+---
diff --git a/.hark/changes/2022-08-26_dcr_api-updates.change.md b/.hark/changes/2022-08-26_dcr_api-updates.change.md
new file mode 100644
index 00000000000..8c7c669fa40
--- /dev/null
+++ b/.hark/changes/2022-08-26_dcr_api-updates.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1430
+is_stripe_api_change: true
+released_in_version: 21.4.0
+---
+
+* Add support for `login_page` on `BillingPortal.Configuration`, `billingportal.ConfigurationCreateParams`, and `billingportal.ConfigurationUpdateParams`
+* Add support for `customs` and `phone_number` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
+* Add support for new value `deutsche_bank_ag` on enums `PaymentIntentConfirmParams.payment_method_data.eps.bank`, `PaymentIntentCreateParams.payment_method_data.eps.bank`, `PaymentIntentUpdateParams.payment_method_data.eps.bank`, `PaymentMethodCreateParams.eps.bank`, `SetupIntentConfirmParams.payment_method_data.eps.bank`, `SetupIntentCreateParams.payment_method_data.eps.bank`, and `SetupIntentUpdateParams.payment_method_data.eps.bank`
+* Add support for `description` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, `QuoteUpdateParams.subscription_data`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, and `SubscriptionScheduleUpdateParams.phases[]`
diff --git a/.hark/changes/2022-08-29_anniel_update-readme-badge.change.md b/.hark/changes/2022-08-29_anniel_update-readme-badge.change.md
new file mode 100644
index 00000000000..89a5645b340
--- /dev/null
+++ b/.hark/changes/2022-08-29_anniel_update-readme-badge.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README badge
+pr_url: https://github.com/stripe/stripe-java/pull/1432
+released_in_version: 21.5.0
+---
diff --git a/.hark/changes/2022-08-31_pakrym_api-updates.change.md b/.hark/changes/2022-08-31_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..cfd47ad682e
--- /dev/null
+++ b/.hark/changes/2022-08-31_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1433
+is_stripe_api_change: true
+released_in_version: 21.5.0
+---
+
+* Add support for new values `de-CH`, `en-CH`, `en-PL`, `en-PT`, `fr-CH`, `it-CH`, `pl-PL`, and `pt-PT` on enums `OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
+* Add support for `description` on `PaymentLink.subscription_data` and `PaymentLinkCreateParams.subscription_data`
diff --git a/.hark/changes/2022-09-06_yejia_api-updates.change.md b/.hark/changes/2022-09-06_yejia_api-updates.change.md
new file mode 100644
index 00000000000..7ae4365b077
--- /dev/null
+++ b/.hark/changes/2022-09-06_yejia_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1434
+is_stripe_api_change: true
+released_in_version: 21.6.0
+---
+
+* Add support for new value `terminal_reader_splashscreen` on enum `FileListParams.purpose`
+* Fix `LineItem.Discount.discount` to reference the correct `Discount` class (`com.stripe.model.Discount`)
diff --git a/.hark/changes/2022-09-09_yejia_api-updates.change.md b/.hark/changes/2022-09-09_yejia_api-updates.change.md
new file mode 100644
index 00000000000..7093b9aedad
--- /dev/null
+++ b/.hark/changes/2022-09-09_yejia_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1435
+is_stripe_api_change: true
+released_in_version: 21.7.0
+---
+
+* Add support for `require_signature` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
diff --git a/.hark/changes/2022-09-15_kamil_api-updates.change.md b/.hark/changes/2022-09-15_kamil_api-updates.change.md
new file mode 100644
index 00000000000..75d6aaeabd0
--- /dev/null
+++ b/.hark/changes/2022-09-15_kamil_api-updates.change.md
@@ -0,0 +1,17 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1444
+is_stripe_api_change: true
+released_in_version: 21.8.0
+---
+
+* Add support for `pix` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `checkout.SessionCreateParams.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for new value `pix` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new value `pix` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for `from_invoice` on `InvoiceCreateParams` and `Invoice`
+* Add support for `latest_revision` on `Invoice`
+* Add support for new value `pix` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for `pix_display_qr_code` on `PaymentIntent.next_action`
+* Add support for new value `pix` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for new value `pix` on enum `PaymentMethodCreateParams.type`
+* Add support for `created` on `Treasury.CreditReversal` and `Treasury.DebitReversal`
diff --git a/.hark/changes/2022-09-22_pakrym_api-updates.change.md b/.hark/changes/2022-09-22_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..6553fcc8678
--- /dev/null
+++ b/.hark/changes/2022-09-22_pakrym_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1445
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 21.9.0
+---
+
+* Add support for `terms_of_service` on `Checkout.Session.consent_collection`, `Checkout.Session.consent`, `checkout.SessionCreateParams.consent_collection`, `PaymentLink.consent_collection`, and `PaymentLinkCreateParams.consent_collection`
+* ⚠️ Remove support for `plan` on `checkout.SessionCreateParams.payment_method_options.card.installments`. The property was mistakenly released and never worked.
+* Add support for `amount` on `issuing.DisputeCreateParams` and `issuing.DisputeUpdateParams`
+* Add support for `statement_descriptor` on `PaymentIntentIncrementAuthorizationParams`
+* Add `upcomingLines` method to `Invoice` resource.
diff --git a/.hark/changes/2022-09-29_yejia_api-updates.change.md b/.hark/changes/2022-09-29_yejia_api-updates.change.md
new file mode 100644
index 00000000000..d7511487474
--- /dev/null
+++ b/.hark/changes/2022-09-29_yejia_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1448
+is_stripe_api_change: true
+released_in_version: 21.10.0
+---
+
+* Add support for `created` on `Checkout.Session`
+* Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
+* Deprecate `SessionCreateParams.subscription_data.items` (use the `line_items` param instead). This will be removed in the next major version.
diff --git a/.hark/changes/2022-10-04_kamil_set-jdk-17.change.md b/.hark/changes/2022-10-04_kamil_set-jdk-17.change.md
new file mode 100644
index 00000000000..9075f83eb1f
--- /dev/null
+++ b/.hark/changes/2022-10-04_kamil_set-jdk-17.change.md
@@ -0,0 +1,5 @@
+---
+title: Set JDK to 17 LTS
+pr_url: https://github.com/stripe/stripe-java/pull/1450
+released_in_version: 21.11.0
+---
diff --git a/.hark/changes/2022-10-06_kamil_api-updates.change.md b/.hark/changes/2022-10-06_kamil_api-updates.change.md
new file mode 100644
index 00000000000..c45e0ef65d9
--- /dev/null
+++ b/.hark/changes/2022-10-06_kamil_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1451
+is_stripe_api_change: true
+released_in_version: 21.11.0
+---
+
+* Add support for new value `bank_of_china` on enums `PaymentIntentConfirmParams.payment_method_data.fpx.bank`, `PaymentIntentCreateParams.payment_method_data.fpx.bank`, `PaymentIntentUpdateParams.payment_method_data.fpx.bank`, `PaymentMethodCreateParams.fpx.bank`, `SetupIntentConfirmParams.payment_method_data.fpx.bank`, `SetupIntentCreateParams.payment_method_data.fpx.bank`, and `SetupIntentUpdateParams.payment_method_data.fpx.bank`
+* Add support for new values `America/Nuuk`, `Europe/Kyiv`, and `Pacific/Kanton` on enum `reporting.ReportRunCreateParams.parameters.timezone`
+* Add support for `klarna` on `SetupAttempt.payment_method_details`
diff --git a/.hark/changes/2022-10-12_anniel_removed-lineitem-product.change.md b/.hark/changes/2022-10-12_anniel_removed-lineitem-product.change.md
new file mode 100644
index 00000000000..ac97ec56deb
--- /dev/null
+++ b/.hark/changes/2022-10-12_anniel_removed-lineitem-product.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `LineItem.Product` property that was released by mistake.
+pr_url: https://github.com/stripe/stripe-java/pull/1456
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-10-12_pakrym_inline-several-shared.change.md b/.hark/changes/2022-10-12_pakrym_inline-several-shared.change.md
new file mode 100644
index 00000000000..b4b2e1c5cc7
--- /dev/null
+++ b/.hark/changes/2022-10-12_pakrym_inline-several-shared.change.md
@@ -0,0 +1,6 @@
+---
+title: Inline several "shared" classes for consistency
+pr_url: https://github.com/stripe/stripe-java/pull/1455
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-10-13_richardm_api-updates.change.md b/.hark/changes/2022-10-13_richardm_api-updates.change.md
new file mode 100644
index 00000000000..ee4e61f2eb0
--- /dev/null
+++ b/.hark/changes/2022-10-13_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1458
+is_stripe_api_change: true
+released_in_version: 21.12.0
+---
+
+* Add support for `request_log_url` on `StripeError`
+* Add support for `network_data` on `Issuing.Authorization`
diff --git a/.hark/changes/2022-10-14_richardm_bugfix-don-t.change.md b/.hark/changes/2022-10-14_richardm_bugfix-don-t.change.md
new file mode 100644
index 00000000000..4c6f3c3d5e8
--- /dev/null
+++ b/.hark/changes/2022-10-14_richardm_bugfix-don-t.change.md
@@ -0,0 +1,5 @@
+---
+title: "Bugfix: Don't require global API Key when API Key is propagated from list request"
+pr_url: https://github.com/stripe/stripe-java/pull/1457
+released_in_version: 21.12.0
+---
diff --git a/.hark/changes/2022-10-17_anniel_removed-deprecated-sku.change.md b/.hark/changes/2022-10-17_anniel_removed-deprecated-sku.change.md
new file mode 100644
index 00000000000..2edc9244625
--- /dev/null
+++ b/.hark/changes/2022-10-17_anniel_removed-deprecated-sku.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Sku` resource
+pr_url: https://github.com/stripe/stripe-java/pull/1459
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-10-20_richardm_api-updates.change.md b/.hark/changes/2022-10-20_richardm_api-updates.change.md
new file mode 100644
index 00000000000..cc49050d750
--- /dev/null
+++ b/.hark/changes/2022-10-20_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1461
+is_stripe_api_change: true
+released_in_version: 21.13.0
+---
+
+* Add support for new values `jp_trn` and `ke_pin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `OrderCreateParams.tax_details.tax_ids[].type`, `OrderUpdateParams.tax_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+* Add support for `tipping` on `Terminal.Reader.action.process_payment_intent.process_config` and `terminal.ReaderProcessPaymentIntentParams.process_config`
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 00000000000..5b8a483f4fd
--- /dev/null
+++ b/.hark/changes/2022-11-02_kamil_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1466
+is_stripe_api_change: true
+released_in_version: 21.14.0
+---
+
+* Add support for `on_behalf_of` on `checkout.SessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `tax_behavior` and `tax_code` on `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceUpcomingLinesParams.invoice_items[]`, and `InvoiceUpcomingParams.invoice_items[]`
diff --git a/.hark/changes/2022-11-04_richardm_removed-requestoptio-getstripever.change.md b/.hark/changes/2022-11-04_richardm_removed-requestoptio-getstripever.change.md
new file mode 100644
index 00000000000..831d5fc38b1
--- /dev/null
+++ b/.hark/changes/2022-11-04_richardm_removed-requestoptio-getstripever.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `RequestOptions.getStripeVersionOverride`, `RequestOptions.setStripeVersionOverride`,  and `RequestOptions.clearStripeVersionOverride`
+pr_url: https://github.com/stripe/stripe-java/pull/1464
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-07_pakrym_api-updates.change.md b/.hark/changes/2022-11-07_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..66b6852db13
--- /dev/null
+++ b/.hark/changes/2022-11-07_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1472
+is_stripe_api_change: true
+released_in_version: 21.15.0
+---
+
+* Add support for new values `eg_tin`, `ph_tin`, and `tr_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `OrderCreateParams.tax_details.tax_ids[].type`, `OrderUpdateParams.tax_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+* Add support for `reason_message` on `Issuing.Authorization.request_history[]`
diff --git a/.hark/changes/2022-11-07_richardm_removed-deprecated-ephemeralkey.change.md b/.hark/changes/2022-11-07_richardm_removed-deprecated-ephemeralkey.change.md
new file mode 100644
index 00000000000..9fb534a8f7f
--- /dev/null
+++ b/.hark/changes/2022-11-07_richardm_removed-deprecated-ephemeralkey.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `EphemeralKey.associatedObjects` field.
+pr_url: https://github.com/stripe/stripe-java/pull/1470
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-09_richardm_remove-support-tosshownanda.change.md b/.hark/changes/2022-11-09_richardm_remove-support-tosshownanda.change.md
new file mode 100644
index 00000000000..13d44e98adf
--- /dev/null
+++ b/.hark/changes/2022-11-09_richardm_remove-support-tosshownanda.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow`
+pr_url: https://github.com/stripe/stripe-java/pull/1473
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-09_richardm_removed-charges-property.change.md b/.hark/changes/2022-11-09_richardm_removed-charges-property.change.md
new file mode 100644
index 00000000000..1e6acb736aa
--- /dev/null
+++ b/.hark/changes/2022-11-09_richardm_removed-charges-property.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed `Charges` property on `PaymentIntent` and replace it with `LatestCharge`
+pr_url: https://github.com/stripe/stripe-java/pull/1473
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-09_richardm_removed-deprecated-amount.change.md b/.hark/changes/2022-11-09_richardm_removed-deprecated-amount.change.md
new file mode 100644
index 00000000000..6470951e033
--- /dev/null
+++ b/.hark/changes/2022-11-09_richardm_removed-deprecated-amount.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Amount`, `Currency`, `Description`, `Images`, `Name` properties from `SessionCreateParams.LineItem`
+pr_url: https://github.com/stripe/stripe-java/pull/1473
+semver_level: major
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-10_anniel_api-updates.change.md b/.hark/changes/2022-11-10_anniel_api-updates.change.md
new file mode 100644
index 00000000000..45251834ff4
--- /dev/null
+++ b/.hark/changes/2022-11-10_anniel_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1474
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 22.0.0
+---
+
+* ⚠️ Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow`. The property was mistakenly released and never worked.
diff --git a/.hark/changes/2022-11-16_richardm_next-major-release.change.md b/.hark/changes/2022-11-16_richardm_next-major-release.change.md
new file mode 100644
index 00000000000..c0b75bfc4b0
--- /dev/null
+++ b/.hark/changes/2022-11-16_richardm_next-major-release.change.md
@@ -0,0 +1,6 @@
+---
+title: Next major release changes
+pr_url: https://github.com/stripe/stripe-java/pull/1471
+is_stripe_api_change: true
+released_in_version: 22.0.0
+---
diff --git a/.hark/changes/2022-11-17_pakrym_api-updates.change.md b/.hark/changes/2022-11-17_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..87ee92f4a88
--- /dev/null
+++ b/.hark/changes/2022-11-17_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1480
+is_stripe_api_change: true
+released_in_version: 22.1.0
+---
+
+* Add support for `hosted_instructions_url` on `PaymentIntent.next_action.wechat_pay_display_qr_code`
diff --git a/.hark/changes/2022-11-17_pakrym_api-updates_2.change.md b/.hark/changes/2022-11-17_pakrym_api-updates_2.change.md
new file mode 100644
index 00000000000..2d4252dfe36
--- /dev/null
+++ b/.hark/changes/2022-11-17_pakrym_api-updates_2.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1479
+is_stripe_api_change: true
+released_in_version: 22.1.0
+---
+
+* Add support for `custom_text` on `Checkout.Session`, `checkout.SessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `hosted_instructions_url` on `PaymentIntent.next_action.paynow_display_qr_code`
diff --git a/.hark/changes/2022-12-06_richardm_api-updates.change.md b/.hark/changes/2022-12-06_richardm_api-updates.change.md
new file mode 100644
index 00000000000..0a0e1b495a0
--- /dev/null
+++ b/.hark/changes/2022-12-06_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1484
+is_stripe_api_change: true
+released_in_version: 22.2.0
+---
+
+* Add support for `flow_data` on `billingportal.SessionCreateParams`
+* Add support for `flow` on `BillingPortal.Session`
diff --git a/.hark/changes/2022-12-06_richardm_api-updates_2.change.md b/.hark/changes/2022-12-06_richardm_api-updates_2.change.md
new file mode 100644
index 00000000000..8af1767989a
--- /dev/null
+++ b/.hark/changes/2022-12-06_richardm_api-updates_2.change.md
@@ -0,0 +1,11 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1483
+is_stripe_api_change: true
+released_in_version: 22.2.0
+---
+
+* Add support for `india_international_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `invoice_creation` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Add support for `invoice` on `Checkout.Session`
+* Add support for `metadata` on `SubscriptionSchedule.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[].items[]`, and `SubscriptionScheduleUpdateParams.phases[].items[]`
diff --git a/.hark/changes/2022-12-08_pakrym_api-updates.change.md b/.hark/changes/2022-12-08_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..79ed615e9d3
--- /dev/null
+++ b/.hark/changes/2022-12-08_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1487
+is_stripe_api_change: true
+released_in_version: 22.3.0
+---
+
+* Change `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`.
+* Added parameterless overload of `Customer.listPaymentMethods`.
diff --git a/.hark/changes/2022-12-13_richardm_don-t-delombok.change.md b/.hark/changes/2022-12-13_richardm_don-t-delombok.change.md
new file mode 100644
index 00000000000..7b5468c8191
--- /dev/null
+++ b/.hark/changes/2022-12-13_richardm_don-t-delombok.change.md
@@ -0,0 +1,5 @@
+---
+title: Don't delombok sources
+pr_url: https://github.com/stripe/stripe-java/pull/1491
+released_in_version: 22.4.0
+---
diff --git a/.hark/changes/2022-12-21_richardm_replace-reflectionch-reflectionac.change.md b/.hark/changes/2022-12-21_richardm_replace-reflectionch-reflectionac.change.md
new file mode 100644
index 00000000000..aa86a87f8c7
--- /dev/null
+++ b/.hark/changes/2022-12-21_richardm_replace-reflectionch-reflectionac.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace ReflectionCheckingTypeAdapterFactory with a ReflectionAccessFilter
+pr_url: https://github.com/stripe/stripe-java/pull/1496
+released_in_version: 22.4.0
+---
diff --git a/.hark/changes/2022-12-22_anniel_fix-publish-command.change.md b/.hark/changes/2022-12-22_anniel_fix-publish-command.change.md
new file mode 100644
index 00000000000..c9e7e9714aa
--- /dev/null
+++ b/.hark/changes/2022-12-22_anniel_fix-publish-command.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix publish command
+pr_url: https://github.com/stripe/stripe-java/pull/1499
+released_in_version: 22.5.0
+---
diff --git a/.hark/changes/2022-12-22_richardm_api-updates.change.md b/.hark/changes/2022-12-22_richardm_api-updates.change.md
new file mode 100644
index 00000000000..7fe03d88d29
--- /dev/null
+++ b/.hark/changes/2022-12-22_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1497
+is_stripe_api_change: true
+released_in_version: 22.4.0
+---
+
+* Add support for new value `merchant_default` on enums `CashBalanceUpdateParams.settings.reconciliation_mode`, `CustomerCreateParams.cash_balance.settings.reconciliation_mode`, and `CustomerUpdateParams.cash_balance.settings.reconciliation_mode`
+* Add support for `using_merchant_default` on `CashBalance.settings`
diff --git a/.hark/changes/2022-12-23_richardm_deprecate-apiresource-classurl.change.md b/.hark/changes/2022-12-23_richardm_deprecate-apiresource-classurl.change.md
new file mode 100644
index 00000000000..3853c482ea3
--- /dev/null
+++ b/.hark/changes/2022-12-23_richardm_deprecate-apiresource-classurl.change.md
@@ -0,0 +1,7 @@
+---
+title: Deprecate ApiResource.classUrl, etc.
+pr_url: https://github.com/stripe/stripe-java/pull/1500
+released_in_version: 22.5.0
+---
+
+* Mark `ApiResource.className`, `ApiResource.singleClassUrl`, `ApiResource.classUrl`, `ApiResource.instanceUrl`, and `ApiResource.subresourceUrl` as deprecated
diff --git a/.hark/changes/2022-12-29_richardm_solution-regarding-ability.change.md b/.hark/changes/2022-12-29_richardm_solution-regarding-ability.change.md
new file mode 100644
index 00000000000..35224abd481
--- /dev/null
+++ b/.hark/changes/2022-12-29_richardm_solution-regarding-ability.change.md
@@ -0,0 +1,5 @@
+---
+title: Solution For "Regarding ability to override stripe api url per API re…
+pr_url: https://github.com/stripe/stripe-java/pull/1476
+released_in_version: 22.5.0
+---
diff --git a/.hark/changes/2023-01-04_richardm_add-fix-per.change.md b/.hark/changes/2023-01-04_richardm_add-fix-per.change.md
new file mode 100644
index 00000000000..1f681cce73c
--- /dev/null
+++ b/.hark/changes/2023-01-04_richardm_add-fix-per.change.md
@@ -0,0 +1,5 @@
+---
+title: Add fix for per-request ApiBase
+pr_url: https://github.com/stripe/stripe-java/pull/1501
+released_in_version: 22.5.0
+---
diff --git a/.hark/changes/2023-01-05_anniel_api-updates.change.md b/.hark/changes/2023-01-05_anniel_api-updates.change.md
new file mode 100644
index 00000000000..018b4847a9e
--- /dev/null
+++ b/.hark/changes/2023-01-05_anniel_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1502
+is_stripe_api_change: true
+released_in_version: 22.5.0
+---
+
+* Add support for `card_issuing` on `Issuing.Cardholder.individual`
diff --git a/.hark/changes/2023-01-11_richardm_bump-gson-2.change.md b/.hark/changes/2023-01-11_richardm_bump-gson-2.change.md
new file mode 100644
index 00000000000..3734ef54404
--- /dev/null
+++ b/.hark/changes/2023-01-11_richardm_bump-gson-2.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump Gson to 2.10.1
+pr_url: https://github.com/stripe/stripe-java/pull/1505
+released_in_version: 22.5.1
+---
diff --git a/.hark/changes/2023-01-19_pakrym_api-updates.change.md b/.hark/changes/2023-01-19_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..f08088ba95f
--- /dev/null
+++ b/.hark/changes/2023-01-19_pakrym_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1507
+is_stripe_api_change: true
+released_in_version: 22.6.0
+---
+
+* Add support for `verification_session` on `EphemeralKeyCreateParams`
+* Add support for new values `refund.created` and `refund.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2023-01-26_anniel_api-updates.change.md b/.hark/changes/2023-01-26_anniel_api-updates.change.md
new file mode 100644
index 00000000000..d48be1cc6f3
--- /dev/null
+++ b/.hark/changes/2023-01-26_anniel_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1510
+is_stripe_api_change: true
+released_in_version: 22.7.0
+---
+
+* Add support for new values `cs-CZ`, `el-GR`, `en-CZ`, and `en-GR` on enums `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
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 00000000000..a0a473c903e
--- /dev/null
+++ b/.hark/changes/2023-02-02_richardm_api-updates.change.md
@@ -0,0 +1,19 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1512
+is_stripe_api_change: true
+released_in_version: 22.8.0
+---
+
+* Add support for `resume` method on resource `Subscription`
+* Add support for `payment_link` on `checkout.SessionListParams`
+* Add support for `trial_settings` on `checkout.SessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `shipping_cost` on `CreditNoteCreateParams`, `CreditNotePreviewLinesParams`, `CreditNotePreviewParams`, `CreditNote`, `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
+* Add support for `amount_shipping` on `CreditNote` and `Invoice`
+* Add support for `shipping_details` on `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
+* Add support for `subscription_resume_at` on `InvoiceUpcomingLinesParams` and `InvoiceUpcomingParams`
+* Change `issuing.CardholderCreateParams.individual.first_name`, `issuing.CardholderCreateParams.individual.last_name`, `issuing.CardholderUpdateParams.individual.first_name`, and `issuing.CardholderUpdateParams.individual.last_name` to be optional
+* Add support for `invoice_creation` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for new value `America/Ciudad_Juarez` on enum `reporting.ReportRunCreateParams.parameters.timezone`
+* Add support for new value `paused` on enum `SubscriptionListParams.status`
+* Add support for new values `customer.subscription.paused` and `customer.subscription.resumed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..411f660f5a6
--- /dev/null
+++ b/.hark/changes/2023-02-16_anniel_api-updates.change.md
@@ -0,0 +1,13 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1514
+is_stripe_api_change: true
+released_in_version: 22.9.0
+---
+
+* Add support for `refund_payment` method on resource `Terminal.Reader`
+* Add support for new value `name` on enums `billingportal.ConfigurationCreateParams.features.customer_update.allowed_updates[]` and `billingportal.ConfigurationUpdateParams.features.customer_update.allowed_updates[]`
+* Add support for `custom_fields` on `Checkout.Session`, `checkout.SessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `interac_present` on `terminal.ReaderPresentPaymentMethodParams`
+* Change type of `terminal.ReaderPresentPaymentMethodParams.type` from `literal('card_present')` to `enum('card_present'|'interac_present')`
+* Add support for `refund_payment` on `Terminal.Reader.action`
diff --git a/.hark/changes/2023-02-23_richardm_api-updates.change.md b/.hark/changes/2023-02-23_richardm_api-updates.change.md
new file mode 100644
index 00000000000..6883d922c08
--- /dev/null
+++ b/.hark/changes/2023-02-23_richardm_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1517
+is_stripe_api_change: true
+released_in_version: 22.10.0
+---
+
+* Add support for new value `yoursafe` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for new value `igst` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2023-03-02_pakrym_api-updates.change.md b/.hark/changes/2023-03-02_pakrym_api-updates.change.md
new file mode 100644
index 00000000000..d85282a80ac
--- /dev/null
+++ b/.hark/changes/2023-03-02_pakrym_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1520
+is_stripe_api_change: true
+released_in_version: 22.11.0
+---
+
+* Add support for new values `electric_vehicle_charging`, `emergency_services_gcas_visa_use_only`, `government_licensed_horse_dog_racing_us_region_only`, `government_licensed_online_casions_online_gambling_us_region_only`, `government_owned_lotteries_non_us_region`, `government_owned_lotteries_us_region_only`, and `marketplaces` on enums `issuing.CardCreateParams.spending_controls.allowed_categories[]`, `issuing.CardCreateParams.spending_controls.blocked_categories[]`, `issuing.CardCreateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardUpdateParams.spending_controls.allowed_categories[]`, `issuing.CardUpdateParams.spending_controls.blocked_categories[]`, `issuing.CardUpdateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardholderCreateParams.spending_controls.allowed_categories[]`, `issuing.CardholderCreateParams.spending_controls.blocked_categories[]`, `issuing.CardholderCreateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardholderUpdateParams.spending_controls.allowed_categories[]`, `issuing.CardholderUpdateParams.spending_controls.blocked_categories[]`, and `issuing.CardholderUpdateParams.spending_controls.spending_limits[].categories[]`
+* Add support for `reconciliation_status` on `Payout`
+* Add support for new value `lease_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2023-03-09_anniel_api-updates.change.md b/.hark/changes/2023-03-09_anniel_api-updates.change.md
new file mode 100644
index 00000000000..56c9f51eded
--- /dev/null
+++ b/.hark/changes/2023-03-09_anniel_api-updates.change.md
@@ -0,0 +1,9 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1523
+is_stripe_api_change: true
+released_in_version: 22.12.0
+---
+
+* Add support for `card_issuing` on `issuing.CardholderCreateParams.individual` and `issuing.CardholderUpdateParams.individual`
+* Add support for `cancellation_details` on `SubscriptionCancelParams`, `SubscriptionUpdateParams`, and `Subscription`
diff --git a/.hark/changes/2023-03-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-03-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..7c4f931ab2a
--- /dev/null
+++ b/.hark/changes/2023-03-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code (new)
+pr_url: https://github.com/stripe/stripe-java/pull/1526
+is_stripe_api_change: true
+released_in_version: 22.13.0
+---
+
+Release specs are identical.
diff --git a/.hark/changes/2023-03-17_richardm_api-updates.change.md b/.hark/changes/2023-03-17_richardm_api-updates.change.md
new file mode 100644
index 00000000000..0e8c959e476
--- /dev/null
+++ b/.hark/changes/2023-03-17_richardm_api-updates.change.md
@@ -0,0 +1,15 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-java/pull/1529
+is_stripe_api_change: true
+released_in_version: 22.13.0
+---
+
+* Add support for `cashapp_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `future_requirements` and `requirements` on `BankAccount`
+* Add support for `cashapp` as a new payment method type throughout the API.
+* Add support for `country` on `Charge.payment_method_details.link`
+* Add support for new value `automatic_async` on enums `checkout.SessionCreateParams.payment_intent_data.capture_method`, `PaymentIntentConfirmParams.capture_method`, `PaymentIntentCreateParams.capture_method`, `PaymentIntentUpdateParams.capture_method`, and `PaymentLinkCreateParams.payment_intent_data.capture_method`
+* Add support for `preferred_locale` on `PaymentIntent.payment_method_options.affirm`, `PaymentIntentConfirmParams.payment_method_options.affirm`, `PaymentIntentCreateParams.payment_method_options.affirm`, and `PaymentIntentUpdateParams.payment_method_options.affirm`
+* Add support for `cashapp_handle_redirect_or_display_qr_code` on `PaymentIntent.next_action` and `SetupIntent.next_action`
+* Add support for new value `payout.reconciliation_completed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..d1d5f1f0be6
--- /dev/null
+++ b/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1531
+is_stripe_api_change: true
+released_in_version: 22.14.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`
+* Add support for new value `link` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for `currency_conversion` on `Checkout.Session`
+* Add support for new value `link` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `automatic_payment_methods` on `SetupIntentCreateParams` and `SetupIntent`
diff --git a/.hark/changes/2023-03-30_anniel_add-missing-file.change.md b/.hark/changes/2023-03-30_anniel_add-missing-file.change.md
new file mode 100644
index 00000000000..f064301e802
--- /dev/null
+++ b/.hark/changes/2023-03-30_anniel_add-missing-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing file purpose terminal_reader_splashscreen
+pr_url: https://github.com/stripe/stripe-java/pull/1538
+released_in_version: 22.15.0
+---
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 00000000000..98b1e74ee39
--- /dev/null
+++ b/.hark/changes/2023-03-30_anniel_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1536
+is_stripe_api_change: true
+released_in_version: 22.15.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 `createFromCalculation` method.
+* Add support for `export_license_id` and `export_purpose_code` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+* Add support for `amount_tip` on `terminal.ReaderPresentPaymentMethodParams`
diff --git a/.hark/changes/2023-04-06_richardm_update-generated-code.change.md b/.hark/changes/2023-04-06_richardm_update-generated-code.change.md
new file mode 100644
index 00000000000..f28e12cb007
--- /dev/null
+++ b/.hark/changes/2023-04-06_richardm_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1540
+is_stripe_api_change: true
+released_in_version: 22.16.0
+---
+
+* Add support for `country` on `PaymentMethod.link`
+* Add support for `status_details` on `PaymentMethod.us_bank_account`
diff --git a/.hark/changes/2023-04-13_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-04-13_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..3fb6bd934d7
--- /dev/null
+++ b/.hark/changes/2023-04-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1544
+is_stripe_api_change: true
+released_in_version: 22.17.0
+---
diff --git a/.hark/changes/2023-04-20_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-04-20_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..e3777cc576c
--- /dev/null
+++ b/.hark/changes/2023-04-20_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1547
+is_stripe_api_change: true
+released_in_version: 22.17.0
+---
diff --git a/.hark/changes/2023-04-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-04-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..fe59316c388
--- /dev/null
+++ b/.hark/changes/2023-04-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1551
+is_stripe_api_change: true
+released_in_version: 22.17.0
+---
+
+* Add support for `billing_cycle_anchor` and `proration_behavior` on `checkout.SessionCreateParams.subscription_data`
+* Add support for `terminal_id` on `Issuing.Authorization.merchant_data` and `Issuing.Transaction.merchant_data`
+* Add support for `metadata` on `PaymentIntentCaptureParams`
+* Add support for `checks` on `SetupAttempt.payment_method_details.card`
+* Add support for `tax_breakdown` on `Tax.Calculation.shipping_cost` and `Tax.Transaction.shipping_cost`
diff --git a/.hark/changes/2023-05-04_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-05-04_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..8698128c4de
--- /dev/null
+++ b/.hark/changes/2023-05-04_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1555
+is_stripe_api_change: true
+released_in_version: 22.18.0
+---
+
+* Add support for `link` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `brand`, `country`, `description`, `exp_month`, `exp_year`, `fingerprint`, `funding`, `iin`, `issuer`, `last4`, `network`, and `wallet` on `SetupAttempt.payment_method_details.card`
diff --git a/.hark/changes/2023-05-11_anniel_update-generated-code.change.md b/.hark/changes/2023-05-11_anniel_update-generated-code.change.md
new file mode 100644
index 00000000000..f0020ccf378
--- /dev/null
+++ b/.hark/changes/2023-05-11_anniel_update-generated-code.change.md
@@ -0,0 +1,20 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1559
+is_stripe_api_change: true
+released_in_version: 22.19.0
+---
+
+* Add support for `paypal` on `Charge.payment_method_details`, `checkout.SessionCreateParams.payment_method_options`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for `network_token` on `Charge.payment_method_details.card`
+* Add support for new value `paypal` on enums `checkout.SessionCreateParams.payment_method_types[]` and `PaymentMethodCreateParams.type`
+* Add support for `taxability_reason` and `taxable_amount` on `Checkout.Session.shipping_cost.taxes[]`, `Checkout.Session.total_details.breakdown.taxes[]`, `CreditNote.shipping_cost.taxes[]`, `CreditNote.tax_amounts[]`, `Invoice.shipping_cost.taxes[]`, `Invoice.total_tax_amounts[]`, `LineItem.taxes[]`, `Quote.computed.recurring.total_details.breakdown.taxes[]`, `Quote.computed.upfront.total_details.breakdown.taxes[]`, and `Quote.total_details.breakdown.taxes[]`
+* Add support for new value `paypal` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for new value `paypal` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for new value `paypal` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `eftpos_au` on enums `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
+* Add support for new value `paypal` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `brand`, `cardholder_name`, `country`, `exp_month`, `exp_year`, `fingerprint`, `funding`, `last4`, `networks`, and `read_method` on `PaymentMethod.card_present` and `PaymentMethod.interac_present`
+* Add support for `preferred_locales` on `PaymentMethod.interac_present`
+* Add support for `effective_percentage` on `TaxRate`
+* Add support for `gb_bank_transfer` and `jp_bank_transfer` on `CustomerCashBalanceTransactions.funded.bank_transfer`
diff --git a/.hark/changes/2023-05-19_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-05-19_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..f828ba24144
--- /dev/null
+++ b/.hark/changes/2023-05-19_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1563
+is_stripe_api_change: true
+released_in_version: 22.20.0
+---
+
+* Add support for `subscription_update_confirm` and `subscription_update` on `BillingPortal.Session.flow` and `billingportal.SessionCreateParams.flow_data`
+* Add support for new values `subscription_update_confirm` and `subscription_update` on enum `billingportal.SessionCreateParams.flow_data.type`
+* Add support for `link` on `Charge.payment_method_details.card.wallet` and `PaymentMethod.card.wallet`
+* Add support for `buyer_id` and `cashtag` on `Charge.payment_method_details.cashapp` and `PaymentMethod.cashapp`
+* Add support for new values `amusement_tax` and `communications_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2023-05-25_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-05-25_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..3f9fd98045b
--- /dev/null
+++ b/.hark/changes/2023-05-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1566
+is_stripe_api_change: true
+released_in_version: 22.21.0
+---
+
+* Add support for `zip_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `zip` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for new value `zip` on enums `checkout.SessionCreateParams.payment_method_types[]` and `PaymentMethodCreateParams.type`
+* Add support for new value `zip` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+* Add support for new value `zip` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
diff --git a/.hark/changes/2023-06-01_anniel_move-deserializes-stripeobject.change.md b/.hark/changes/2023-06-01_anniel_move-deserializes-stripeobject.change.md
new file mode 100644
index 00000000000..ce7939e10d2
--- /dev/null
+++ b/.hark/changes/2023-06-01_anniel_move-deserializes-stripeobject.change.md
@@ -0,0 +1,5 @@
+---
+title: Move deserializeStripeObject to StripeObject
+pr_url: https://github.com/stripe/stripe-java/pull/1572
+released_in_version: 22.22.0
+---
diff --git a/.hark/changes/2023-06-01_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-01_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..72f06caf038
--- /dev/null
+++ b/.hark/changes/2023-06-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1569
+is_stripe_api_change: true
+released_in_version: 22.22.0
+---
+
+* Add support for `numeric` and `text` on `checkout.SessionCreateParams.custom_fields[]`, `PaymentLinkCreateParams.custom_fields[]`, and `PaymentLinkUpdateParams.custom_fields[]`
+* Add support for new values `aba` and `swift` on enums `checkout.SessionCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`
+* Add support for new value `us_bank_transfer` on enums `checkout.SessionCreateParams.payment_method_options.customer_balance.bank_transfer.type`, `CustomerCreateFundingInstructionsParams.bank_transfer.type`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.type`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.type`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.type`
+* Add support for `maximum_length` and `minimum_length` on `Checkout.Session.custom_fields[].numeric` and `Checkout.Session.custom_fields[].text`
+* Add support for `preferred_locales` on `Issuing.Cardholder`, `issuing.CardholderCreateParams`, and `issuing.CardholderUpdateParams`
+* Add support for `description`, `iin`, and `issuer` on `PaymentMethod.card_present` and `PaymentMethod.interac_present`
+* Add support for `payer_email` on `PaymentMethod.paypal`
diff --git a/.hark/changes/2023-06-08_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-08_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..c229358afe4
--- /dev/null
+++ b/.hark/changes/2023-06-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1577
+is_stripe_api_change: true
+released_in_version: 22.23.0
+---
+
+* Add support for `taxability_reason` on `Tax.Calculation.tax_breakdown[]`
diff --git a/.hark/changes/2023-06-09_richardm_bugfix-fix-customer.change.md b/.hark/changes/2023-06-09_richardm_bugfix-fix-customer.change.md
new file mode 100644
index 00000000000..69e1fce9342
--- /dev/null
+++ b/.hark/changes/2023-06-09_richardm_bugfix-fix-customer.change.md
@@ -0,0 +1,5 @@
+---
+title: "Bugfix: fix `Customer.retrievePaymentMethod` URL interpolation"
+pr_url: https://github.com/stripe/stripe-java/pull/1582
+released_in_version: 22.23.1
+---
diff --git a/.hark/changes/2023-06-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..8d234a745ed
--- /dev/null
+++ b/.hark/changes/2023-06-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1591
+is_stripe_api_change: true
+released_in_version: 22.24.0
+---
+
+* Add support for `on_behalf_of` on `Mandate`
diff --git a/.hark/changes/2023-06-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..8ff942b90eb
--- /dev/null
+++ b/.hark/changes/2023-06-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1597
+is_stripe_api_change: true
+released_in_version: 22.25.0
+---
+
+* Add support for `effective_at` on `CreditNoteCreateParams`, `CreditNotePreviewLinesParams`, `CreditNotePreviewParams`, `CreditNote`, `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
+* Add support for new values `ad_nrt`, `ar_cuit`, `bo_tin`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `pe_ruc`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, and `vn_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxCalculationCreateParams.customer_details.tax_ids[].type`
diff --git a/.hark/changes/2023-07-06_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-07-06_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..0896b69537b
--- /dev/null
+++ b/.hark/changes/2023-07-06_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1601
+is_stripe_api_change: true
+released_in_version: 22.26.0
+---
+
+* Add support for `numeric` and `text` on `PaymentLink.custom_fields[]`
+* Add support for `automatic_tax` on `SubscriptionListParams`
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 00000000000..3970beca943
--- /dev/null
+++ b/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1606
+is_stripe_api_change: true
+released_in_version: 22.27.0
+---
+
+* Add support for new resource `Tax.Settings`
+* Add support for `retrieve` and `update` methods on resource `Settings`
+* Add support for `order_id` on `Charge.payment_method_details.afterpay_clearpay`
+* Add support for `allow_redirects` on `PaymentIntent.automatic_payment_methods`, `PaymentIntentCreateParams.automatic_payment_methods`, `SetupIntent.automatic_payment_methods`, and `SetupIntentCreateParams.automatic_payment_methods`
+* Add support for `product` on `Tax.TransactionLineItem`
+* Add support for new value `tax.settings.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2023-07-18_richardm_changelog-fix-namespaced.change.md b/.hark/changes/2023-07-18_richardm_changelog-fix-namespaced.change.md
new file mode 100644
index 00000000000..f3f5747e879
--- /dev/null
+++ b/.hark/changes/2023-07-18_richardm_changelog-fix-namespaced.change.md
@@ -0,0 +1,5 @@
+---
+title: "Changelog: fix namespaced param names"
+pr_url: https://github.com/stripe/stripe-java/pull/1610
+released_in_version: 22.28.0
+---
diff --git a/.hark/changes/2023-07-20_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-07-20_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..637ff2f0657
--- /dev/null
+++ b/.hark/changes/2023-07-20_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1611
+is_stripe_api_change: true
+released_in_version: 22.28.0
+---
+
+* Add support for new value `ro_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `use_stripe_sdk` on `SetupIntentConfirmParams` and `SetupIntentCreateParams`
+* Add support for new value `service_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2023-07-20_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2023-07-20_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..1ab62a73c09
--- /dev/null
+++ b/.hark/changes/2023-07-20_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1609
+is_stripe_api_change: true
+released_in_version: 22.28.0
+---
+
+* Add support for new value `ro_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `use_stripe_sdk` on `SetupIntentConfirmParams` and `SetupIntentCreateParams`
+* Add support for new value `service_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
diff --git a/.hark/changes/2023-07-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-07-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..1cd056c02b3
--- /dev/null
+++ b/.hark/changes/2023-07-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1614
+is_stripe_api_change: true
+released_in_version: 22.29.0
+---
+
+* Add support for `monthly_estimated_revenue` on `Account.business_profile`, `AccountCreateParams.business_profile`, and `AccountUpdateParams.business_profile`
diff --git a/.hark/changes/2023-08-03_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-03_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..06b2e2671e4
--- /dev/null
+++ b/.hark/changes/2023-08-03_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1620
+is_stripe_api_change: true
+released_in_version: 22.30.0
+---
+
+* Change many types from `string` to `emptyStringable(string)`
+* Add support for `subscription_details` on `Invoice`
+* Add support for `preferred_settlement_speed` on `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, and `PaymentIntentUpdateParams.payment_method_options.us_bank_account`
+* Add support for new values `sepa_debit_fingerprint` and `us_bank_account_fingerprint` on enum `radar.ValueListCreateParams.item_type`
diff --git a/.hark/changes/2023-08-16_pakrym_stripeclient.change.md b/.hark/changes/2023-08-16_pakrym_stripeclient.change.md
new file mode 100644
index 00000000000..1655481f614
--- /dev/null
+++ b/.hark/changes/2023-08-16_pakrym_stripeclient.change.md
@@ -0,0 +1,28 @@
+---
+title: StripeClient
+pr_url: https://github.com/stripe/stripe-java/pull/1622
+semver_level: major
+released_in_version: 23.0.0
+---
+
+* Introduces `StripeClient` and the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm.
+  * No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
+  * No extra API calls. All API endpoints can be accessed with a single method call. You don't have to call `retrieve` before doing an `update`.
+  * No static methods. Much easier mocking.
+  * Visit the [migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23) to learn more.
+* **Removals**
+  * ⚠️ `ApiResource.request()`, `requestStream()`, `requestCollection()`, `requestSearchResult()` methods removed.
+  * ⚠️ `StripeResponseGetter.oauthRequest(...)` was removed. OAuth requests are now performed via `StripeResponseGetter.request` with `ApiMode.OAuth`.
+  * ⚠️ Deprecated `ApiResource.className()`  `singleClassUrl()`, `classUrl()`, `instanceUrl()`, `subresourceUrl()` methods removed.
+* **Type changes**
+  * ⚠️ `StripeResponseGetter.request(...)`, `streamRequest(...)` signatures changed.
+    * `BaseAddress` parameter added.
+    * `url` renamed to `path` and is a relative to the base address
+    * `apiMode` parameter added to control how request is sent and response is handled, `V1` and `OAuth` are supported values.
+    * ⚠️ `RequestOptions.getReadTimeout()`, `getConnectTimeout()`, `getMaxNetworkRetries()` now return `Integer` instead of `int`.
+* **Renames**
+  * ⚠️ `addFullNameAliase` renamed to `addFullNameAlias` in `AccountCreateParams`, `AccountUpdateParams`, `PersonCollectionCreateParams`, `TokenCreateParams`, `PersonCollectionCreateParams`, `PersonUpdateParams`.
+  * ⚠️ `addLookupKeys` renamed to `addLookupKey` in `PriceListParams`
+* **Behavior Changes**
+  * ⚠️ `RequestOptions.getDefault()` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
+  * ⚠️ `RequestOptionsBuilder` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
diff --git a/.hark/changes/2023-08-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..159ba12e941
--- /dev/null
+++ b/.hark/changes/2023-08-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1632
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 23.0.0
+---
+
+* ⚠️Remove support for values `custom_account_update` and `custom_account_verification` from enum `AccountLinkCreateParams.type`
+  * These values are not fully operational. Please use `account_update` and `account_onboarding` instead (see [API reference](https://stripe.com/docs/api/account_links/create#create_account_link-type)).
+* ⚠️Remove support for `available_on` on `BalanceTransactionListParams`
+  * Use of this parameter is discouraged. You may use [`.putExtraParam`](https://github.com/stripe/stripe-java/#parameters) if sending the parameter is still required.
+* ⚠️Remove support for `alternate_statement_descriptors`, `destination`, and `dispute` on `Charge`
+  * Use of these fields is discouraged.
+* ⚠️Remove support for `shipping_rates` on `checkout.SessionCreateParams`
+  * Please use `shipping_options` instead.
+* ⚠️Remove support for `coupon` and `trial_from_plan` on `checkout.SessionCreateParams.subscription_data`
+  * Please [migrate to the Prices API](https://stripe.com/docs/billing/migration/migrating-prices), or use [`.putExtraParam`](https://github.com/stripe/stripe-java/#parameters) if sending the parameter is still required.
+* ⚠️Remove support for value `card_present` from enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
+  * This value was not fully operational.
+* ⚠️Remove support for `blik` on `Mandate.payment_method_details`, `PaymentMethodUpdateParams`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
+  * These fields were mistakenly released.
+* ⚠️Remove support for `acss_debit`, `affirm`, `au_becs_debit`, `bacs_debit`, `cashapp`, `sepa_debit`, and `zip` on `PaymentMethodUpdateParams`
+  * These fields are empty.
+* ⚠️Remove support for `country` on `PaymentMethod.link`
+  * This field was not fully operational.
+* ⚠️Remove support for `recurring` on `PriceUpdateParams`
+  * This property should be set on create only.
+* ⚠️Remove support for `attributes`, `caption`, and `deactivate_on` on `ProductCreateParams`, `ProductUpdateParams`, and `Product`
+  * These fields are not fully operational.
+* Add support for new value `2023-08-16` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2023-08-16_unknown_more-information-available.change.md b/.hark/changes/2023-08-16_unknown_more-information-available.change.md
new file mode 100644
index 00000000000..28752075bb4
--- /dev/null
+++ b/.hark/changes/2023-08-16_unknown_more-information-available.change.md
@@ -0,0 +1,4 @@
+---
+title: More information is available in the [stripe-java v23 migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23)
+released_in_version: 23.0.0
+---
diff --git a/.hark/changes/2023-08-16_unknown_please-read-api.change.md b/.hark/changes/2023-08-16_unknown_please-read-api.change.md
new file mode 100644
index 00000000000..ff1964a62fa
--- /dev/null
+++ b/.hark/changes/2023-08-16_unknown_please-read-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Please read the [API Changelog](https://docs.stripe.com/changelog/2023-08-16) and carefully review the API changes before upgrading `stripe-java`.
+released_in_version: 23.0.0
+---
diff --git a/.hark/changes/2023-08-17_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-17_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..3395d617cfa
--- /dev/null
+++ b/.hark/changes/2023-08-17_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1634
+is_stripe_api_change: true
+released_in_version: 23.1.0
+---
+
+* Add support for `flat_amount` on `tax.TransactionCreateReversalParams`
diff --git a/.hark/changes/2023-08-21_anniel_update-v23-0.change.md b/.hark/changes/2023-08-21_anniel_update-v23-0.change.md
new file mode 100644
index 00000000000..ab5a7266669
--- /dev/null
+++ b/.hark/changes/2023-08-21_anniel_update-v23-0.change.md
@@ -0,0 +1,5 @@
+---
+title: Update v23.0.0 Changelog
+pr_url: https://github.com/stripe/stripe-java/pull/1636
+released_in_version: 23.1.1
+---
diff --git a/.hark/changes/2023-08-21_pakrym_set-default-api.change.md b/.hark/changes/2023-08-21_pakrym_set-default-api.change.md
new file mode 100644
index 00000000000..6fff7482baf
--- /dev/null
+++ b/.hark/changes/2023-08-21_pakrym_set-default-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Set default API endpoints in StripeClient builder
+pr_url: https://github.com/stripe/stripe-java/pull/1638
+released_in_version: 23.1.1
+---
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 00000000000..a39d081910f
--- /dev/null
+++ b/.hark/changes/2023-08-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1635
+is_stripe_api_change: true
+released_in_version: 23.2.0
+---
+
+* Add support for `retention` on `BillingPortal.Session.flow.subscription_cancel` and `billingportal.SessionCreateParams.flow_data.subscription_cancel`
+* Add support for `prefetch` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections`, `FinancialConnections.Session`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntent.payment_method_options.us_bank_account.financial_connections`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections`, and `financialconnections.SessionCreateParams`
+* Add support for `payment_method_details` on `Dispute`
+* Change type of `PaymentIntentCreateParams.mandate_data` and `SetupIntentCreateParams.mandate_data` from `secret_key_param` to `emptyStringable(secret_key_param)`
+* Change type of `PaymentIntentConfirmParams.mandate_data` and `SetupIntentConfirmParams.mandate_data` from `secret_key_param | client_key_param` to `emptyStringable(secret_key_param | client_key_param)`
+* Add support for `balance_transaction` on `CustomerCashBalanceTransaction.adjusted_for_overdraft`
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 00000000000..859540f26f8
--- /dev/null
+++ b/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1640
+is_stripe_api_change: true
+released_in_version: 23.3.0
+---
+
+* Add support for new resource `AccountSession`
+* Add support for `create` method on resource `AccountSession`
+* Add support for `application` on `PaymentLink`
+* Add support for new value `obligation` on enum `reporting.ReportRunCreateParams.parameters.reporting_category`
diff --git a/.hark/changes/2023-09-07_pakrym_fix-ephemeralkey-create.change.md b/.hark/changes/2023-09-07_pakrym_fix-ephemeralkey-create.change.md
new file mode 100644
index 00000000000..0ed82dc4514
--- /dev/null
+++ b/.hark/changes/2023-09-07_pakrym_fix-ephemeralkey-create.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix EphemeralKeyService.create
+pr_url: https://github.com/stripe/stripe-java/pull/1646
+released_in_version: 23.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 00000000000..8da39d48863
--- /dev/null
+++ b/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1643
+is_stripe_api_change: true
+released_in_version: 23.4.0
+---
+
+* Add support for new resource `PaymentMethodDomain`
+* Add support for `create`, `list`, `retrieve`, `update`, and `validate` methods on resource `PaymentMethodDomain`
+* Add support for new value `n26` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for `features` on `ProductCreateParams`, `ProductUpdateParams`, and `Product`
+* Remove support for value `invoiceitem.updated` from enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2023-09-13_pakrym_flow-response-getters.change.md b/.hark/changes/2023-09-13_pakrym_flow-response-getters.change.md
new file mode 100644
index 00000000000..746a679fc9c
--- /dev/null
+++ b/.hark/changes/2023-09-13_pakrym_flow-response-getters.change.md
@@ -0,0 +1,5 @@
+---
+title: Flow response getters into Event.data.object and models deserialized via ApiResource.GSON
+pr_url: https://github.com/stripe/stripe-java/pull/1650
+released_in_version: 23.5.0
+---
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 00000000000..05887ec0769
--- /dev/null
+++ b/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1647
+is_stripe_api_change: true
+released_in_version: 23.5.0
+---
+
+* Add support for new resource `PaymentMethodConfiguration`
+* Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
+* 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`
+* Add support for `payment_method_configuration` on `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `checkout.SessionCreateParams`
+* Add support for `payment_method_configuration_details` on `Checkout.Session`, `PaymentIntent`, and `SetupIntent`
+* Add support for `nonce` on `EphemeralKeyCreateParams`
+* Add support for `cashback_amount` on `Issuing.Authorization.amount_details`, `Issuing.Authorization.pending_request.amount_details`, `Issuing.Authorization.request_history[].amount_details`, and `Issuing.Transaction.amount_details`
+* Add support for `serial_number` on `terminal.ReaderListParams`
diff --git a/.hark/changes/2023-09-18_pakrym_ci-drop-testing.change.md b/.hark/changes/2023-09-18_pakrym_ci-drop-testing.change.md
new file mode 100644
index 00000000000..71ec7122b5b
--- /dev/null
+++ b/.hark/changes/2023-09-18_pakrym_ci-drop-testing.change.md
@@ -0,0 +1,5 @@
+---
+title: "CI: Drop testing for 9, 10, 12-16"
+pr_url: https://github.com/stripe/stripe-java/pull/1655
+released_in_version: 23.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 00000000000..66b6a6761bc
--- /dev/null
+++ b/.hark/changes/2023-09-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1654
+is_stripe_api_change: true
+released_in_version: 23.6.0
+---
+
+* Add support for `terms_of_service_acceptance` on `Checkout.Session.custom_text`, `PaymentLink.custom_text`, `PaymentLinkCreateParams.custom_text`, `PaymentLinkUpdateParams.custom_text`, and `checkout.SessionCreateParams.custom_text`
diff --git a/.hark/changes/2023-09-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..07dbae78807
--- /dev/null
+++ b/.hark/changes/2023-09-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1657
+is_stripe_api_change: true
+released_in_version: 23.7.0
+---
+
+* Add support for `rendering` on `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
diff --git a/.hark/changes/2023-10-05_richardm_flow-type-information.change.md b/.hark/changes/2023-10-05_richardm_flow-type-information.change.md
new file mode 100644
index 00000000000..d3e635af307
--- /dev/null
+++ b/.hark/changes/2023-10-05_richardm_flow-type-information.change.md
@@ -0,0 +1,5 @@
+---
+title: Flow type information further into autopagination requests
+pr_url: https://github.com/stripe/stripe-java/pull/1663
+released_in_version: 23.8.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 00000000000..868b2857929
--- /dev/null
+++ b/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1662
+is_stripe_api_change: true
+released_in_version: 23.8.0
+---
+
+* Add support for new resource `Issuing.Token`
+* Add support for `list`, `retrieve`, and `update` methods on resource `Token`
+* Add support for `amount_authorized`, `extended_authorization`, `incremental_authorization`, `multicapture`, and `overcapture` on `Charge.payment_method_details.card`
+* Add support for `token` on `Issuing.Authorization` and `Issuing.Transaction`
+* Add support for `authorization_code` on `Issuing.Authorization.request_history[]`
+* Add support for `request_extended_authorization`, `request_multicapture`, and `request_overcapture` on `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, and `PaymentIntentUpdateParams.payment_method_options.card`
+* Add support for `request_incremental_authorization` on `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card`
+* Add support for `final_capture` on `PaymentIntentCaptureParams`
+* Add support for `metadata` on `PaymentLink.payment_intent_data`, `PaymentLink.subscription_data`, `PaymentLinkCreateParams.payment_intent_data`, and `PaymentLinkCreateParams.subscription_data`
+* Add support for `statement_descriptor_suffix` and `statement_descriptor` on `PaymentLink.payment_intent_data` and `PaymentLinkCreateParams.payment_intent_data`
+* Add support for `payment_intent_data` and `subscription_data` on `PaymentLinkUpdateParams`
diff --git a/.hark/changes/2023-10-11_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-11_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..25591b0f772
--- /dev/null
+++ b/.hark/changes/2023-10-11_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1668
+is_stripe_api_change: true
+released_in_version: 23.9.0
+---
+
+* Add support for `redirect_on_completion`, `return_url`, and `ui_mode` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Change `checkout.SessionCreateParams.success_url` to be optional
+* Add support for `client_secret` on `Checkout.Session`
+* Add support for `postal_code` on `Issuing.Authorization.verification_data`
+* Add support for `offline` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
diff --git a/.hark/changes/2023-10-13_pakrym_disallow-falback-global.change.md b/.hark/changes/2023-10-13_pakrym_disallow-falback-global.change.md
new file mode 100644
index 00000000000..b90ea1840c6
--- /dev/null
+++ b/.hark/changes/2023-10-13_pakrym_disallow-falback-global.change.md
@@ -0,0 +1,5 @@
+---
+title: Disallow falback to global response getter only in tests
+pr_url: https://github.com/stripe/stripe-java/pull/1671
+released_in_version: 23.10.0
+---
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 00000000000..64deb66d222
--- /dev/null
+++ b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1672
+is_stripe_api_change: true
+released_in_version: 24.0.0
+---
+
+* Add support for `legal_guardian` on `AccountPersonsParams.relationship` and `TokenCreateParams.person.relationship`
+* Add support for `additional_tos_acceptances` on `TokenCreateParams.person`
+* Add support for new value `2023-10-16` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2023-10-16_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..071ef5ddb80
--- /dev/null
+++ b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1670
+is_stripe_api_change: true
+released_in_version: 23.10.0
+---
+
+* Add support for new values `issuing_token.created` and `issuing_token.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..0fa9f8b758d
--- /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-java`.
+released_in_version: 24.0.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 00000000000..63cc000a4e0
--- /dev/null
+++ b/.hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1677
+is_stripe_api_change: true
+released_in_version: 24.1.0
+---
+
+* Add support for new resource `Tax.Registration`
+* Add support for `revolut_pay` throughout the API.
+* Add support for `aba` and `swift` on `FundingInstructions.bank_transfer.financial_addresses[]` and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[]`
+* Add support for `url` on `Issuing.Authorization.merchant_data`, `Issuing.Transaction.merchant_data`, `issuing.AuthorizationCreateParams.merchant_data`, `issuing.TransactionCreateForceCaptureParams.merchant_data`, and `issuing.TransactionCreateUnlinkedRefundParams.merchant_data`
+* Add support for `authentication_exemption` and `three_d_secure` on `Issuing.Authorization.verification_data` and `issuing.AuthorizationCreateParams.verification_data`
+* Add support for `description` on `PaymentLink.payment_intent_data`, `PaymentLinkCreateParams.payment_intent_data`, and `PaymentLinkUpdateParams.payment_intent_data`
+* Add support for new value `unreconciled_customer_funds` on enum `reporting.ReportRunCreateParams.parameters.reporting_category`
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 00000000000..8663b52606c
--- /dev/null
+++ b/.hark/changes/2023-11-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1679
+is_stripe_api_change: true
+released_in_version: 24.2.0
+---
+
+* Add support for `metadata` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, and `QuoteUpdateParams.subscription_data`
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 00000000000..fa64502b857
--- /dev/null
+++ b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1685
+is_stripe_api_change: true
+released_in_version: 24.3.0
+---
+
+* Add support for `status` on `checkout.SessionListParams`
diff --git a/.hark/changes/2023-11-16_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..173b8a3c83b
--- /dev/null
+++ b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1683
+is_stripe_api_change: true
+released_in_version: 24.3.0
+---
+
+* Add support for `bacs_debit_payments` on `AccountCreateParams.settings` and `AccountUpdateParams.settings`
+* Add support for `service_user_number` on `Account.settings.bacs_debit_payments`
+* Add support for `capture_before` on `Charge.payment_method_details.card`
+* Add support for `paypal` on `Checkout.Session.payment_method_options`
+* Add support for `tax_amounts` on `CreditNoteCreateParams.lines[]`, `CreditNotePreviewLinesParams.lines[]`, and `CreditNotePreviewParams.lines[]`
+* Add support for `network_data` on `Issuing.Transaction`
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 00000000000..edbfe6ef07d
--- /dev/null
+++ b/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1690
+is_stripe_api_change: true
+released_in_version: 24.4.0
+---
+
+* Add support for `offline` on `Charge.payment_method_details.card_present`
+* Add support for `system_trace_audit_number` on `Issuing.Authorization.network_data`
+* Add support for `transaction_id` on `Issuing.Authorization.network_data` and `Issuing.Transaction.network_data`
+* Add support for `network_risk_score` on `Issuing.Authorization.pending_request` and `Issuing.Authorization.request_history[]`
+* Add support for `requested_at` on `Issuing.Authorization.request_history[]`
+* Add support for `authorization_code` on `Issuing.Transaction.network_data`
diff --git a/.hark/changes/2023-11-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..ef284e3e4a0
--- /dev/null
+++ b/.hark/changes/2023-11-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1693
+is_stripe_api_change: true
+released_in_version: 24.5.0
+---
+
+* Add support for `electronic_commerce_indicator` and `transaction_id` on `Charge.payment_method_details.card.three_d_secure` and `SetupAttempt.payment_method_details.card.three_d_secure`
+* Add support for `exemption_indicator_applied` and `exemption_indicator` on `Charge.payment_method_details.card.three_d_secure`
+* Add support for `three_d_secure` on `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `SetupIntentConfirmParams.payment_method_options.card`, `SetupIntentCreateParams.payment_method_options.card`, and `SetupIntentUpdateParams.payment_method_options.card`
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 00000000000..943a1dd19f1
--- /dev/null
+++ b/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1694
+is_stripe_api_change: true
+released_in_version: 24.6.0
+---
+
+* Add support for new resources `Climate.Order`, `Climate.Product`, and `Climate.Supplier`
+* Add support for `cancel`, `create`, `list`, `retrieve`, and `update` methods on resource `Order`
+* Add support for `list` and `retrieve` methods on resources `Product` and `Supplier`
+* Add support for `created` on `checkout.SessionListParams`
+* Add support for `validate_location` on `CustomerCreateParams.tax` and `CustomerUpdateParams.tax`
+* Add support for new values `climate_order_purchase` and `climate_order_refund` on enum `reporting.ReportRunCreateParams.parameters.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 `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..5f8285b3620
--- /dev/null
+++ b/.hark/changes/2023-12-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1700
+is_stripe_api_change: true
+released_in_version: 24.7.0
+---
+
+* Add support for `payment_details`, `payments`, and `payouts` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `features` on `AccountSession.components.account_onboarding` and `AccountSessionCreateParams.components.account_onboarding`
+* Add support for `inactive_message` and `restrictions` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `transfer_group` on `PaymentLink.payment_intent_data`, `PaymentLinkCreateParams.payment_intent_data`, and `PaymentLinkUpdateParams.payment_intent_data`
+* Add support for `trial_settings` on `PaymentLink.subscription_data`, `PaymentLinkCreateParams.subscription_data`, and `PaymentLinkUpdateParams.subscription_data`
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 00000000000..f59e7c977d3
--- /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-java/pull/1704
+is_stripe_api_change: true
+released_in_version: 24.8.0
+---
+
+* Add support for `payment_method_reuse_agreement` on `Checkout.Session.consent_collection`, `PaymentLink.consent_collection`, `PaymentLinkCreateParams.consent_collection`, and `checkout.SessionCreateParams.consent_collection`
+* Add support for `after_submit` on `Checkout.Session.custom_text`, `PaymentLink.custom_text`, `PaymentLinkCreateParams.custom_text`, `PaymentLinkUpdateParams.custom_text`, and
+* Add support for `created` on `radar.EarlyFraudWarningListParams`
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 00000000000..ba72d3f6a47
--- /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-java/pull/1709
+is_stripe_api_change: true
+released_in_version: 24.9.0
+---
diff --git a/.hark/changes/2023-12-22_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2023-12-22_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..bb40bb43124
--- /dev/null
+++ b/.hark/changes/2023-12-22_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,24 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1707
+is_stripe_api_change: true
+released_in_version: 24.9.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[]`, `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[]`, `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, and `checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]` from `literal('balances')` to `enum('balances'|'transactions')`
+* 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 enum `financialconnections.SessionCreateParams.prefetch[]`
+* Add support for new value `unknown` on enum `issuing.AuthorizationCreateParams.verification_data.authentication_exemption.type`
+* Add support for `collection_method` on `Mandate.payment_method_details.us_bank_account`
+* Add support for new value `challenge` on enums `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`, `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 `mandate_options` on `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `SetupIntent.payment_method_options.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, and `SetupIntentUpdateParams.payment_method_options.us_bank_account`
+* Add support for `revolut_pay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* 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/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 00000000000..b250bde0bbe
--- /dev/null
+++ b/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1712
+is_stripe_api_change: true
+released_in_version: 24.10.0
+---
+
+* Add support for `retrieve` method on resource `Tax.Registration`
diff --git a/.hark/changes/2024-01-09_richardm_add-missing-method.change.md b/.hark/changes/2024-01-09_richardm_add-missing-method.change.md
new file mode 100644
index 00000000000..027804f5197
--- /dev/null
+++ b/.hark/changes/2024-01-09_richardm_add-missing-method.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing method overloads
+pr_url: https://github.com/stripe/stripe-java/pull/1716
+released_in_version: 24.11.0
+---
diff --git a/.hark/changes/2024-01-10_richardm_change-striperespon-take.change.md b/.hark/changes/2024-01-10_richardm_change-striperespon-take.change.md
new file mode 100644
index 00000000000..ff87a4ecb09
--- /dev/null
+++ b/.hark/changes/2024-01-10_richardm_change-striperespon-take.change.md
@@ -0,0 +1,5 @@
+---
+title: Change StripeResponseGetter to take a single APIRequest object
+pr_url: https://github.com/stripe/stripe-java/pull/1702
+released_in_version: 24.11.0
+---
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 00000000000..de732d8cc11
--- /dev/null
+++ b/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1715
+is_stripe_api_change: true
+released_in_version: 24.11.0
+---
+
+* Add support for new resource `CustomerSession`
+* Add support for `create` method on resource `CustomerSession`
+* Remove support for `expand` on `BankAccountDeleteParams` and `CardDeleteParams`
+* Add support for `account_type`, `default_for_currency`, and `documents` on `BankAccountUpdateParams` and `CardUpdateParams`
+* Remove support for `owner` on `BankAccountUpdateParams` and `CardUpdateParams`
+* Change type of `BankAccountUpdateParams.account_holder_type` and `CardUpdateParams.account_holder_type` from `enum('company'|'individual')` to `emptyStringable(enum('company'|'individual'))`
+* Add support for new values `eps` and `p24` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.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-16_richardm_refactor-livestripere.change.md b/.hark/changes/2024-01-16_richardm_refactor-livestripere.change.md
new file mode 100644
index 00000000000..de6324653fb
--- /dev/null
+++ b/.hark/changes/2024-01-16_richardm_refactor-livestripere.change.md
@@ -0,0 +1,5 @@
+---
+title: Refactor LiveStripeResponseGetter
+pr_url: https://github.com/stripe/stripe-java/pull/1722
+released_in_version: 24.12.0
+---
diff --git a/.hark/changes/2024-01-17_richardm_move-request-telemetry.change.md b/.hark/changes/2024-01-17_richardm_move-request-telemetry.change.md
new file mode 100644
index 00000000000..6ca975f0664
--- /dev/null
+++ b/.hark/changes/2024-01-17_richardm_move-request-telemetry.change.md
@@ -0,0 +1,5 @@
+---
+title: Move request telemetry to LiveStripeResponseGetter
+pr_url: https://github.com/stripe/stripe-java/pull/1725
+released_in_version: 24.12.0
+---
diff --git a/.hark/changes/2024-01-17_richardm_report-usage-stripeclient.change.md b/.hark/changes/2024-01-17_richardm_report-usage-stripeclient.change.md
new file mode 100644
index 00000000000..16badb61458
--- /dev/null
+++ b/.hark/changes/2024-01-17_richardm_report-usage-stripeclient.change.md
@@ -0,0 +1,11 @@
+---
+title: Report usage of `stripe_client`
+pr_url: https://github.com/stripe/stripe-java/pull/1721
+released_in_version: 24.12.0
+---
+
+* Reports use of the new `StripeClient` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `Stripe.enableTelemetry = false;`, see the [README](https://github.com/stripe/stripe-java/blob/master/README.md#telemetry).)
+
+## Details
+* A different approach to #1698. This one sets `usage` on each callsite to `StripeResponseGetter.request` from `StripeClient`, rather than attempting to wrap `LiveStripeResponseGetter`.
+* Modifies `RequestTelemetry` to accept usage and set it appropriately on `X-Stripe-Client-Telemetry`. Had to add a parameter to a public method, so I made a new overload and deprecated the old one. Had to disable a linter rule to do this.
diff --git a/.hark/changes/2024-01-18_pakrym_add-webhook-parsing.change.md b/.hark/changes/2024-01-18_pakrym_add-webhook-parsing.change.md
new file mode 100644
index 00000000000..9aed91497c2
--- /dev/null
+++ b/.hark/changes/2024-01-18_pakrym_add-webhook-parsing.change.md
@@ -0,0 +1,7 @@
+---
+title: Add webhook parsing method on StripeClient
+pr_url: https://github.com/stripe/stripe-java/pull/1724
+released_in_version: 24.12.0
+---
+
+* Add support for `constructEvent()` instance method on `StripeClient` that parses Webhook events and uses the settings inherited from the StripeClient instance to make further requests.
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 00000000000..ca7b3f71ee6
--- /dev/null
+++ b/.hark/changes/2024-01-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1732
+is_stripe_api_change: true
+released_in_version: 24.12.0
+---
diff --git a/.hark/changes/2024-01-18_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2024-01-18_stripe-openapi_update-generated-code_2.change.md
new file mode 100644
index 00000000000..ef97ae6ce8f
--- /dev/null
+++ b/.hark/changes/2024-01-18_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1723
+is_stripe_api_change: true
+released_in_version: 24.12.0
+---
+
+* Add support for `issuer` on `InvoiceCreateParams`, `InvoiceUpcomingLinesParams`, `InvoiceUpcomingParams`, `InvoiceUpdateParams`, and `Invoice`
+* Add support for `liability` on `Invoice.automatic_tax`, `InvoiceCreateParams.automatic_tax`, `InvoiceUpcomingLinesParams.automatic_tax`, `InvoiceUpcomingParams.automatic_tax`, `InvoiceUpdateParams.automatic_tax`, `Subscription.automatic_tax`, `SubscriptionCreateParams.automatic_tax`, and `SubscriptionUpdateParams.automatic_tax`
+* Add support for `on_behalf_of` on `InvoiceUpcomingLinesParams` and `InvoiceUpcomingParams`
+* Add support for `pin` on `issuing.CardCreateParams`
+* Add support for `revocation_reason` on `Mandate.payment_method_details.bacs_debit`
+* Add support for new value `nn` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for `customer_balance` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `invoice_settings` on `SubscriptionCreateParams` and `SubscriptionUpdateParams`
diff --git a/.hark/changes/2024-01-25_pakrym_add-clock-instance.change.md b/.hark/changes/2024-01-25_pakrym_add-clock-instance.change.md
new file mode 100644
index 00000000000..afb9aad3ccc
--- /dev/null
+++ b/.hark/changes/2024-01-25_pakrym_add-clock-instance.change.md
@@ -0,0 +1,5 @@
+---
+title: Add clock instance on webhook
+pr_url: https://github.com/stripe/stripe-java/pull/1739
+released_in_version: 24.14.0
+---
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 00000000000..ae4d10020b1
--- /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-java/pull/1736
+is_stripe_api_change: true
+released_in_version: 24.13.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_helenye_update-generated-code.change.md b/.hark/changes/2024-02-01_helenye_update-generated-code.change.md
new file mode 100644
index 00000000000..d1971ba89f1
--- /dev/null
+++ b/.hark/changes/2024-02-01_helenye_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1740
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 24.14.0
+---
+
+* Add support for `swish` payment method throughout the API
+* Add support for `relationship` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, and `TokenCreateParams.account.individual`
+* Add support for `jurisdiction_level` on `TaxRate`
+* ⚠️  Fix broken reference to `com.stripe.model.Discount` from `checkout.Session.TotalDetails.Breakdown.Discount` (this represents a bugfix as this class would never have worked, but might be a breaking type change)
diff --git a/.hark/changes/2024-02-05_richardm_define-stripeclient-usage.change.md b/.hark/changes/2024-02-05_richardm_define-stripeclient-usage.change.md
new file mode 100644
index 00000000000..bc810b46794
--- /dev/null
+++ b/.hark/changes/2024-02-05_richardm_define-stripeclient-usage.change.md
@@ -0,0 +1,5 @@
+---
+title: Define StripeClient "usage" in a single place
+pr_url: https://github.com/stripe/stripe-java/pull/1744
+released_in_version: 24.15.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 00000000000..5e5e6d82ee5
--- /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-java/pull/1742
+is_stripe_api_change: true
+released_in_version: 24.15.0
+---
+
+* Add support for `invoices` on `Account.settings` and `AccountUpdateParams.settings`
+* Add support for new value `velobank` on enums `PaymentIntentConfirmParams.payment_method_data.p24.bank`, `PaymentIntentCreateParams.payment_method_data.p24.bank`, `PaymentIntentUpdateParams.payment_method_data.p24.bank`, `PaymentMethodCreateParams.p24.bank`, `SetupIntentConfirmParams.payment_method_data.p24.bank`, `SetupIntentCreateParams.payment_method_data.p24.bank`, and `SetupIntentUpdateParams.payment_method_data.p24.bank`
+* Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.blik`, `PaymentIntentConfirmParams.payment_method_options.blik`, `PaymentIntentCreateParams.payment_method_options.blik`, and `PaymentIntentUpdateParams.payment_method_options.blik`
+* Add support for `require_cvc_recollection` on `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, and `PaymentIntentUpdateParams.payment_method_options.card`
+* Add support for `account_tax_ids` on `SubscriptionCreateParams.invoice_settings`, `SubscriptionSchedule.default_settings.invoice_settings`, `SubscriptionSchedule.phases[].invoice_settings`, `SubscriptionScheduleCreateParams.default_settings.invoice_settings`, `SubscriptionScheduleCreateParams.phases[].invoice_settings`, `SubscriptionScheduleUpdateParams.default_settings.invoice_settings`, `SubscriptionScheduleUpdateParams.phases[].invoice_settings`, and `SubscriptionUpdateParams.invoice_settings`
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 00000000000..86ba382373a
--- /dev/null
+++ b/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1745
+is_stripe_api_change: true
+released_in_version: 24.16.0
+---
+
+* Add support for `networks` on `Card`, `PaymentMethodCreateParams.CardDetails`, `PaymentMethodUpdateParams.Card`, and `TokenCreateParams.Card`
+* Add support for new value `no_voec` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `display_brand` on `PaymentMethod.card`
+* Add support for new value `financial_connections.account.refreshed_ownership` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..7e2581af360
--- /dev/null
+++ b/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1748
+is_stripe_api_change: true
+released_in_version: 24.17.0
+---
+
+* Add support for `client_reference_id` on `Identity.VerificationReport`, `Identity.VerificationSession`, `identity.VerificationReportListParams`, `identity.VerificationSessionCreateParams`, and `identity.VerificationSessionListParams`
+* Remove support for value `include_and_require` from enum `InvoiceCreateParams.pending_invoice_items_behavior`
+* Remove support for value `service_tax` from enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
+* Add support for `created` on `treasury.OutboundPaymentListParams`
+* Add `InvoiceLineItem.update` method.
diff --git a/.hark/changes/2024-02-23_helenye_update-readme-reference.change.md b/.hark/changes/2024-02-23_helenye_update-readme-reference.change.md
new file mode 100644
index 00000000000..67f230a3d23
--- /dev/null
+++ b/.hark/changes/2024-02-23_helenye_update-readme-reference.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README to reference addBetaVersion helper
+pr_url: https://github.com/stripe/stripe-java/pull/1753
+released_in_version: 24.18.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 00000000000..30f99c45013
--- /dev/null
+++ b/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1750
+is_stripe_api_change: true
+released_in_version: 24.18.0
+---
+
+* Add support for `number` on `InvoiceCreateParams` and `InvoiceUpdateParams`
+* Add support for `enable_customer_cancellation` on `Terminal.Reader.action.process_payment_intent.process_config`, `Terminal.Reader.action.process_setup_intent.process_config`, `terminal.ReaderProcessPaymentIntentParams.process_config`, and `terminal.ReaderProcessSetupIntentParams.process_config`
+* Add support for `refund_payment_config` on `Terminal.Reader.action.refund_payment` and `terminal.ReaderRefundPaymentParams`
+* Add support for `payment_method` on `TokenCreateParams.bank_account`
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 00000000000..db662be530c
--- /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-java/pull/1758
+is_stripe_api_change: true
+released_in_version: 24.19.0
+---
+
+* Add support for `documents` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `request_three_d_secure` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
+* Add support for `created` on `CreditNoteListParams`
+* Add support for `sepa_debit` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, and `InvoiceUpdateParams.payment_settings.payment_method_options`
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 00000000000..c2ecbaa0b82
--- /dev/null
+++ b/.hark/changes/2024-03-14_ramya_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1763
+is_stripe_api_change: true
+released_in_version: 24.20.0
+---
+
+* Add support for new resources `Issuing.PersonalizationDesign` and `Issuing.PhysicalBundle`
+* Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PersonalizationDesign`
+* Add support for `list` and `retrieve` methods on resource `PhysicalBundle`
+* Add support for `personalization_design` on `Issuing.Card`, `issuing.CardCreateParams`, `issuing.CardListParams`, and `issuing.CardUpdateParams`
+* Change type of `SubscriptionCreateParams.application_fee_percent` and `SubscriptionUpdateParams.application_fee_percent` from `number` to `emptyStringable(number)`
+* Add support for `sepa_debit` on `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
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 00000000000..991d0ba4eb6
--- /dev/null
+++ b/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1768
+is_stripe_api_change: true
+released_in_version: 24.21.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`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `mobilepay` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `payment_reference` on `Charge.payment_method_details.us_bank_account`
+* Add support for new value `mobilepay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `confirmation_token` on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `SetupIntentConfirmParams`, and `SetupIntentCreateParams`
+* Add support for new value `mobilepay` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for `name` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
+* Add support for `payout` on `Treasury.ReceivedDebit.linked_flows`
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 00000000000..056d2dc8801
--- /dev/null
+++ b/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1770
+is_stripe_api_change: true
+released_in_version: 24.22.0
+---
+
+* Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`
+* Add support for `create`, `deactivate`, `list`, `reactivate`, `retrieve`, and `update` methods on resource `Meter`
+* Add support for `create` method on resources `MeterEventAdjustment` and `MeterEvent`
+* Add support for `amazon_pay_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `destination_on_behalf_of_charge_management` on `AccountSession.components.payment_details.features`, `AccountSession.components.payments.features`, `AccountSessionCreateParams.components.payment_details.features`, and `AccountSessionCreateParams.components.payments.features`
+* Add support for `mandate` on `Charge.payment_method_details.us_bank_account`, `Treasury.InboundTransfer.origin_payment_method_details.us_bank_account`, `Treasury.OutboundPayment.destination_payment_method_details.us_bank_account`, and `Treasury.OutboundTransfer.destination_payment_method_details.us_bank_account`
+* Add support for `second_line` on `issuing.CardCreateParams`
+* Add support for `meter` on `PlanCreateParams`, `Plan`, `Price.recurring`, `PriceCreateParams.recurring`, and `PriceListParams.recurring`
diff --git a/.hark/changes/2024-04-04_ramya_update-generated-code.change.md b/.hark/changes/2024-04-04_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..28abb674b4d
--- /dev/null
+++ b/.hark/changes/2024-04-04_ramya_update-generated-code.change.md
@@ -0,0 +1,20 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1774
+is_stripe_api_change: true
+released_in_version: 24.23.0
+---
+
+* Change type of `checkout.SessionCreateParams.payment_method_options.swish.reference` from `emptyable(string)` to `string`
+* Add support for `subscription_item` on `Discount`
+* Add support for `email` and `phone` on `Identity.VerificationReport`, `Identity.VerificationSession.options`, `Identity.VerificationSession.verified_outputs`, `identity.VerificationSessionCreateParams.options`, and `identity.VerificationSessionUpdateParams.options`
+* Add support for `verification_flow` on `Identity.VerificationReport`, `Identity.VerificationSession`, and `identity.VerificationSessionCreateParams`
+* Add support for `provided_details` on `Identity.VerificationSession`, `identity.VerificationSessionCreateParams`, and `identity.VerificationSessionUpdateParams`
+* Change `identity.VerificationSessionCreateParams.type` to be optional
+* Add support for `promotion_code` on `InvoiceCreateParams.discounts[]`, `InvoiceItemCreateParams.discounts[]`, `InvoiceItemUpdateParams.discounts[]`, `InvoiceUpdateParams.discounts[]`, `QuoteCreateParams.discounts[]`, and `QuoteUpdateParams.discounts[]`
+* Add support for `discounts` on `InvoiceUpcomingLinesParams.subscription_items[]`, `InvoiceUpcomingParams.subscription_items[]`, `QuoteCreateParams.line_items[]`, `QuoteUpdateParams.line_items[]`, `SubscriptionCreateParams.add_invoice_items[]`, `SubscriptionCreateParams.items[]`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionItem`, `SubscriptionSchedule.phases[].add_invoice_items[]`, `SubscriptionSchedule.phases[].items[]`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[].add_invoice_items[]`, `SubscriptionScheduleCreateParams.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[].add_invoice_items[]`, `SubscriptionScheduleUpdateParams.phases[].items[]`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams.add_invoice_items[]`, `SubscriptionUpdateParams.items[]`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `allowed_merchant_countries` and `blocked_merchant_countries` on `Issuing.Card.spending_controls`, `Issuing.Cardholder.spending_controls`, `issuing.CardCreateParams.spending_controls`, `issuing.CardUpdateParams.spending_controls`, `issuing.CardholderCreateParams.spending_controls`, and `issuing.CardholderUpdateParams.spending_controls`
+* Add support for `zip` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `offline` on `SetupAttempt.payment_method_details.card_present`
+* Add support for `card_present` on `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for new value `mobile_phone_reader` on enum `terminal.ReaderListParams.device_type`
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 00000000000..f19ace647fa
--- /dev/null
+++ b/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1778
+is_stripe_api_change: true
+released_in_version: 24.24.0
+---
+
+* Add support for new resources `Entitlements.ActiveEntitlement` and `Entitlements.Feature`
+* Add support for `list` and `retrieve` methods on resource `ActiveEntitlement`
+* Add support for `create`, `list`, `retrieve`, and `update` methods on resource `Feature`
+* Add support for `controller` on `AccountCreateParams`
+* Add support for `fees`, `losses`, `requirement_collection`, and `stripe_dashboard` on `Account.controller`
+* Add support for `event_name` on `Billing.MeterEventAdjustment` and `billing.MeterEventAdjustmentCreateParams`
+* Add support for `cancel` and `type` on `Billing.MeterEventAdjustment`
diff --git a/.hark/changes/2024-04-10_ramya_update-generated-code.change.md b/.hark/changes/2024-04-10_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..914cc55d059
--- /dev/null
+++ b/.hark/changes/2024-04-10_ramya_update-generated-code.change.md
@@ -0,0 +1,70 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1776
+released_in_version: 25.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.
+
+* Add a new `TaxIdService` for operations on `/v1/tax_ids` endpoints.
+
+### ⚠️ Breaking changes
+
+* Rename `features` to `marketing_features` on `ProductCreateParams`, `ProductUpdateParams`, and `Product`
+* Rename "child" services to be prefixed with the associated parent service to allow for the same resource to be exposed at top level (e.g., `/v1/tax_ids` via `client.taxIds()`) and as a child (e.g., `/v1/customers/{}/tax_ids` via `client.customers().taxIds()`).
+  * Rename `CapabilityService` -> `AccountCapabilityService`
+  * Rename `ExternalAccountService` -> `AccountExternalAccountService`
+  * Rename `LoginLinkService` -> `AccountLoginLinkService`
+  * Rename `PersonService` -> `AccountPersonService`
+  * Rename `FeeRefundService` -> `ApplicationFeeRefundService`
+  * Rename `CashBalanceService` -> `CustomerCashBalanceService`
+  * Rename `PaymentSourceService` -> `CustomerPaymentSourceService`
+  * Rename `UsageRecordService` -> `SubscriptionItemUsageRecordService`
+  * Rename `UsageRecordSummaryService` -> `SubscriptionItemUsageRecordSummaryService`
+  * Rename `TaxIdService` -> `CustomerTaxIdService`.
+* Remove support for `verify` method on `BankAccountService`.
+  *  Please use the `verify` method on `CustomerPaymentSourceService` instead
+  ```java
+  // BEFORE
+  client.bankAccounts().verify("cus_...", "ba_...");
+
+  // AFTER
+  client.customers().paymentSources().verify("cus_...", "ba_...");
+  ```
+* Remove support for `list` and `create` methods on `treasury.FinancialAccountFeaturesService`. These methods were incorrectly named.
+  * Please migrate `list` -> `retrieve` and `create` -> `update`.
+* Update `setPageTypeToken` method on `StripeCollectionInterface` to be required and remove default implementation.
+* Remove deprecated `setUsage` method on `BaseApiRequest`.
+* Update `usage` on `BaseApiRequest` class to be `final`.
+* Remove deprecated `maybeEnqueueMetrics` method on `RequestTelemetry`.
+
+#### ⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API
+
+* Remove `Configuration.SubscriptionPause` for Billing Portal as the feature to pause subscription on the portal has been deprecated.
+* Remove the support for the below deprecated values in `BalanceTransaction.Type`
+    * `obligation_inbound`
+    * `obligation_payout`
+    * `obligation_payout_failure`
+    * `obligation_reversal_outbound`
+* Remove the below deprecated events from `Event.Type`, `WebhookEndpointCreateOptions.EnabledEvent`, `WebhookEndpointUpdateOptions.EnabledEvent`
+   * `invoiceitem.updated`
+   * `order.created`
+   * `recipient.created`
+   * `recipient.deleted`
+   * `recipient.updated`
+   * `sku.created`
+   * `sku.deleted`
+   * `sku.updated`
+* Remove support for `id_bank_transfer`, `multibanco`, `netbanking`, `pay_by_bank`, and `upi` on `PaymentMethodConfiguration` by removing the below classes
+   * `PaymentMethodConfiguration.IdBankTransfer`
+   * `PaymentMethodConfiguration.Multibanco`
+   * `PaymentMethodConfiguration.Netbanking`
+   * `PaymentMethodConfiguration.PayByBank`
+   * `PaymentMethodConfiguration.Upi`
+* Remove the support for `challenge_only` in `SetupIntent.PaymentMethodOptions.Card.RequestThreeDSecure`
+* Remove the support for deprecated value `service_tax` in `TaxRate.TaxType`, `InvoiceLinetItemUpdateParams.TaxAmount.TaxRateData.TaxType`,pweb`TaxRateCreateParams.TaxType`, `TaxRateUpdateParams.TaxType`
+* Remove the support for `various` in `Climate.Supplier.removalPathway`
+* Remove the deprecated value `INCLUDE_AND_REQUIRE` on the enum `InvoiceCreateParams.PendingInvoiceItemsBehavior`
+* Remove the property `RequestIncrementalAuthorization` on `PaymentIntentConfirmParams.PaymentMethodOptions.CardPresent`, `PaymentIntentCreateParams.PaymentMethodOptions.CardPresent` and `PaymentIntentUpdateParams.PaymentMethodOptions.CardPresent`. This was shipped by mistake.
+* Remove the support for deprecated value `obligation` on `ReportRunCreateParams.ReportingCategory`
+* Remove the legacy field `rendering_options` on `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`. Use `rendering` instead.
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 00000000000..35692265d6f
--- /dev/null
+++ b/.hark/changes/2024-04-11_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,19 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1779
+is_stripe_api_change: true
+released_in_version: 25.1.0
+---
+
+* Add support for `account_management` and `notification_banner` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `external_account_collection` on `AccountSession.components.account_onboarding.features` and `AccountSessionCreateParams.components.account_onboarding.features`
+* Change `billing.MeterEventAdjustmentCreateParams.cancel.identifier` and `billing.MeterEventAdjustmentCreateParams.cancel` to be optional
+* Change `billing.MeterEventAdjustmentCreateParams.type` to be required
+* Change type of `Billing.MeterEventAdjustment.cancel` from `BillingMeterResourceBillingMeterEventAdjustmentCancel` to `nullable(BillingMeterResourceBillingMeterEventAdjustmentCancel)`
+* Add support for `amazon_pay` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `Refund.destination_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `ownership` on enums `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `InvoiceUpdateParams.payment_settings.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[]`, `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[]`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]`, and `checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]`
+* Add support for new value `amazon_pay` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new value `amazon_pay` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new values `bh_vat`, `kz_bin`, `ng_tin`, and `om_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for new value `amazon_pay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `next_refresh_available_at` on `FinancialConnections.Account.ownership_refresh`
diff --git a/.hark/changes/2024-04-16_ramya_update-generated-code.change.md b/.hark/changes/2024-04-16_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..9837be85514
--- /dev/null
+++ b/.hark/changes/2024-04-16_ramya_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1780
+is_stripe_api_change: true
+released_in_version: 25.2.0
+---
+
+* Add support for new resource `Entitlements.ActiveEntitlementSummary`
+* Add support for `balances` and `payouts_list` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Change `billing.MeterEventCreateParams.timestamp` to be optional
+* Remove support for `config` on `Forwarding.Request` and `forwarding.RequestCreateParams`. This field is no longer used by the Forwarding Request API.
+* Add support for `capture_method` on `PaymentIntent.payment_method_options.revolut_pay`, `PaymentIntentConfirmParams.payment_method_options.revolut_pay`, `PaymentIntentCreateParams.payment_method_options.revolut_pay`, and `PaymentIntentUpdateParams.payment_method_options.revolut_pay`
+* Add support for `swish` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for new value `entitlements.active_entitlement_summary.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..3e010d0bf7b
--- /dev/null
+++ b/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1782
+is_stripe_api_change: true
+released_in_version: 25.3.0
+---
+
+* Add support for `create_preview` method on resource `Invoice`
+* Add support for `payment_method_data` on `checkout.SessionCreateParams`
+* Add support for `saved_payment_method_options` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Add support for `mobilepay` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `mobilepay` on enum `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for `allow_redisplay` on `ConfirmationTokenCreateParams.payment_method_data`, `CustomerListPaymentMethodsParams`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `schedule_details` and `subscription_details` on `InvoiceUpcomingLinesParams` and `InvoiceUpcomingParams`
+* Add support for new value `other` on enums `issuing.AuthorizationCaptureParams.purchase_details.fuel.unit`, `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel.unit`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel.unit`
diff --git a/.hark/changes/2024-04-25_anniel_update-generated-code.change.md b/.hark/changes/2024-04-25_anniel_update-generated-code.change.md
new file mode 100644
index 00000000000..eae205260ea
--- /dev/null
+++ b/.hark/changes/2024-04-25_anniel_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1784
+is_stripe_api_change: true
+released_in_version: 25.4.0
+---
+
+* Add support for `setup_future_usage` on `Checkout.Session.payment_method_options.amazon_pay`, `Checkout.Session.payment_method_options.revolut_pay`, `PaymentIntent.payment_method_options.amazon_pay`, and `PaymentIntent.payment_method_options.revolut_pay`
+* Change type of `Entitlements.ActiveEntitlement.feature` from `string` to `expandable($Entitlements.Feature)`
+* Remove support for inadvertently released identity verification features `email` and `phone` on `identity.VerificationSessionCreateParams.options` and `identity.VerificationSessionUpdateParams.options`
+* Add support for new values `amazon_pay` and `revolut_pay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for `amazon_pay` and `revolut_pay` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
+* Add support for `ending_before`, `limit`, and `starting_after` on `PaymentMethodConfigurationListParams`
+* Add support for `mobilepay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
diff --git a/.hark/changes/2024-04-25_unknown_deprecate-java-methods.change.md b/.hark/changes/2024-04-25_unknown_deprecate-java-methods.change.md
new file mode 100644
index 00000000000..5f42931588a
--- /dev/null
+++ b/.hark/changes/2024-04-25_unknown_deprecate-java-methods.change.md
@@ -0,0 +1,6 @@
+---
+title: Deprecate Java methods based on OpenAPI spec
+released_in_version: 25.4.0
+---
+
+* Mark as deprecated the `approve` and `decline` methods on Authorization. Instead, [respond directly to the webhook request to approve an authorization](https://docs.stripe.com/issuing/controls/real-time-authorizations#authorization-handling).
diff --git a/.hark/changes/2024-05-02_helenye_update-generated-code.change.md b/.hark/changes/2024-05-02_helenye_update-generated-code.change.md
new file mode 100644
index 00000000000..467e6ef11be
--- /dev/null
+++ b/.hark/changes/2024-05-02_helenye_update-generated-code.change.md
@@ -0,0 +1,13 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1785
+is_stripe_api_change: true
+released_in_version: 25.5.0
+---
+
+* Add support for `paypal` on `Dispute.payment_method_details`
+* Change type of `Dispute.payment_method_details.type` from `literal('card')` to `enum('card'|'paypal')`
+* Change type of `entitlements.FeatureUpdateParams.metadata` from `map(string: string)` to `emptyable(map(string: string))`
+* Add support for `payment_method_types` on `PaymentIntentConfirmParams`
+* Add support for `ship_from_details` on `Tax.Calculation`, `Tax.Transaction`, and `tax.CalculationCreateParams`
+* Add support for `bh`, `eg`, `ge`, `ke`, `kz`, `ng`, and `om` on `Tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
diff --git a/.hark/changes/2024-05-02_prathmesh_deprecate-java-params.change.md b/.hark/changes/2024-05-02_prathmesh_deprecate-java-params.change.md
new file mode 100644
index 00000000000..33a66facc64
--- /dev/null
+++ b/.hark/changes/2024-05-02_prathmesh_deprecate-java-params.change.md
@@ -0,0 +1,7 @@
+---
+title: Deprecate Java params based on OpenAPI spec
+pr_url: https://github.com/stripe/stripe-java/pull/1787
+released_in_version: 25.5.0
+---
+
+- Mark as deprecated the `persistent_token` property on `ConfirmationToken.Link.persistentToken`, `PaymentIntent.Link.persistentToken`, `PaymentMethod.Link.persistentToken`, `SetupIntent.Link.persistentToken`, `PaymentIntentConfirmParams.Link.persistentToken`, `PaymentIntentCreateParams.Link.persistentToken`, `PaymentIntentUpdateParams.Link.persistentToken`, `SetupIntentConfirmParams.Link.persistentToken`, `SetupIntentCreateParams.Link.persistentToken`, `SetupIntentUpdateParams.Link.persistentToken`. This is a legacy parameter that no longer has any function.
diff --git a/.hark/changes/2024-05-09_ramya_update-generated-code.change.md b/.hark/changes/2024-05-09_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..43f2a973234
--- /dev/null
+++ b/.hark/changes/2024-05-09_ramya_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1801
+is_stripe_api_change: true
+released_in_version: 25.7.0
+---
+
+* Remove support for `pending_invoice_items_behavior` on `SubscriptionCreateParams` that was prematurely added in the previous release on the same day
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 00000000000..c69eeb070fc
--- /dev/null
+++ b/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1797
+is_stripe_api_change: true
+released_in_version: 25.6.0
+---
+
+* Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+* Add support for `allow_redisplay` on `ConfirmationToken.payment_method_preview` and `PaymentMethod`
+* Add support for `preview_mode` on `InvoiceCreatePreviewParams`, `InvoiceUpcomingLinesParams`, and `InvoiceUpcomingParams`
+* Add support for `tracking_details` on `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+* Add support for new values `treasury.outbound_payment.tracking_details_updated` and `treasury.outbound_transfer.tracking_details_updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2024-05-13_prathmesh_added-deprecated-annotation.change.md b/.hark/changes/2024-05-13_prathmesh_added-deprecated-annotation.change.md
new file mode 100644
index 00000000000..7a3642fec04
--- /dev/null
+++ b/.hark/changes/2024-05-13_prathmesh_added-deprecated-annotation.change.md
@@ -0,0 +1,8 @@
+---
+title: Added deprecated annotation to builder methods
+pr_url: https://github.com/stripe/stripe-java/pull/1804
+released_in_version: 25.8.0
+---
+
+* Deprecate Java builder params based on OpenAPI spec
+  * Mark as deprecated the setters for persistent_token property on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`. This is a legacy parameter that no longer has any function.
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 00000000000..b8a32f6f938
--- /dev/null
+++ b/.hark/changes/2024-05-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,19 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1803
+is_stripe_api_change: true
+released_in_version: 25.8.0
+---
+
+* Add support for `fee_source` on `ApplicationFee`
+* Add support for `net_available` on `Balance.instant_available[]`
+* Add support for `preferred_locales` on `Charge.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card_present`, and `PaymentMethod.card_present`
+* Add support for `klarna` on `Dispute.payment_method_details`
+* Add support for `archived` and `lookup_key` on `entitlements.FeatureListParams`
+* Change `financialconnections.SessionCreateParams.filters.countries` to be optional
+* Add support for `no_valid_authorization` on `Issuing.Dispute.evidence`, `issuing.DisputeCreateParams.evidence`, and `issuing.DisputeUpdateParams.evidence`
+* Add support for new value `no_valid_authorization` on enums `issuing.DisputeCreateParams.evidence.reason` and `issuing.DisputeUpdateParams.evidence.reason`
+* Add support for `loss_reason` on `Issuing.Dispute`
+* Add support for `routing` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
+* Add support for `application_fee_amount` and `application_fee` on `Payout`
+* Add support for `stripe_s700` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
diff --git a/.hark/changes/2024-05-20_anniel_track-usage-unsafesetstr.change.md b/.hark/changes/2024-05-20_anniel_track-usage-unsafesetstr.change.md
new file mode 100644
index 00000000000..b1dbdce946e
--- /dev/null
+++ b/.hark/changes/2024-05-20_anniel_track-usage-unsafesetstr.change.md
@@ -0,0 +1,5 @@
+---
+title: Track usage for unsafeSetStripeVersionOverride
+pr_url: https://github.com/stripe/stripe-java/pull/1808
+released_in_version: 25.9.0
+---
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 00000000000..f37cf778263
--- /dev/null
+++ b/.hark/changes/2024-05-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1806
+is_stripe_api_change: true
+released_in_version: 25.9.0
+---
+
+* Add support for `external_account_collection` on `AccountSession.components.balances.features`, `AccountSession.components.payouts.features`, `AccountSessionCreateParams.components.balances.features`, and `AccountSessionCreateParams.components.payouts.features`
+* Add support for `payment_method_remove` on `Checkout.Session.saved_payment_method_options`
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 00000000000..240d1f76b7a
--- /dev/null
+++ b/.hark/changes/2024-05-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1815
+is_stripe_api_change: true
+released_in_version: 25.10.0
+---
+
+* Add support for `default_value` on `Checkout.Session.custom_fields[].dropdown`, `Checkout.Session.custom_fields[].numeric`, `Checkout.Session.custom_fields[].text`, `checkout.SessionCreateParams.custom_fields[].dropdown`, `checkout.SessionCreateParams.custom_fields[].numeric`, and `checkout.SessionCreateParams.custom_fields[].text`
+* Add support for `generated_from` on `ConfirmationToken.payment_method_preview.card` and `PaymentMethod.card`
+* Add support for new values `en-RO` and `ro-RO` on enums `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
+* Add support for new values `issuing_personalization_design.activated`, `issuing_personalization_design.deactivated`, `issuing_personalization_design.rejected`, and `issuing_personalization_design.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..39dec10aebe
--- /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-java/pull/1817
+is_stripe_api_change: true
+released_in_version: 25.11.0
+---
+
+* Add support for `gb_bank_transfer_payments`, `jp_bank_transfer_payments`, `mx_bank_transfer_payments`, `sepa_bank_transfer_payments`, and `us_bank_transfer_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for new value `swish` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.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 00000000000..291541fd8a7
--- /dev/null
+++ b/.hark/changes/2024-06-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,15 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1818
+is_stripe_api_change: true
+released_in_version: 25.12.0
+---
+
+* Add support for `multibanco_payments` and `twint_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `twint` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `multibanco` on `Checkout.Session.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `Refund.destination_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new values `multibanco` and `twint` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, `PaymentMethodListParams.type`, and `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new values `multibanco` and `twint` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `de_stn` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `multibanco_display_details` on `PaymentIntent.next_action`
+* Add support for `invoice_settings` on `Subscription`
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 00000000000..2ee8a0312f9
--- /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-java/pull/1823
+is_stripe_api_change: true
+released_in_version: 25.13.0
+---
+
+* Add support for new value `mobilepay` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `tax_id_collection` on `PaymentLinkUpdateParams`
diff --git a/.hark/changes/2024-06-24_ramya_please-read-api.change.md b/.hark/changes/2024-06-24_ramya_please-read-api.change.md
new file mode 100644
index 00000000000..1c6dca5a8da
--- /dev/null
+++ b/.hark/changes/2024-06-24_ramya_please-read-api.change.md
@@ -0,0 +1,25 @@
+---
+title: Please read the [API Changelog](https://docs.stripe.com/changelog/2024-06-20) and carefully review the API changes before upgrading.
+pr_url: https://github.com/stripe/stripe-java/pull/1825
+released_in_version: 26.0.0
+---
+
+### ⚠️ Breaking changes
+
+  * Remove the unused resource `PlatformTaxFee`
+  * Rename `volume_decimal` to `quantity_decimal` on
+     * `Issuing.Transaction.purchase_details.fuel`,
+     * `issuing.AuthorizationCaptureParams.purchase_details.fuel`,
+     *  `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel`, and
+     *  `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel`
+
+### Additions
+
+* Add support for `finalize_amount` test helper method on resource `Issuing.Authorization`
+* Add support for new values `platform_disabled`, `paused.inactivity` and `other` on enums `Capability.Requirements.disabledReason` and `Capability.FutureRequirements.disabledReason`
+* Add support for new value `ch_uid` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `fleet` on `Issuing.Authorization`, `Issuing.Transaction.purchase_details`, `issuing.AuthorizationCaptureParams.purchase_details`, `issuing.AuthorizationCreateParams`, `issuing.TransactionCreateForceCaptureParams.purchase_details`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details`
+* Add support for `fuel` on `Issuing.Authorization` and `issuing.AuthorizationCreateParams`
+* Add support for `industry_product_code` and `quantity_decimal` on `Issuing.Transaction.purchase_details.fuel`, `issuing.AuthorizationCaptureParams.purchase_details.fuel`, `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel`
+* Add support for new values `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, and `pound` on enums `issuing.AuthorizationCaptureParams.purchase_details.fuel.unit`, `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel.unit`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel.unit`
+* Add support for new value `2024-06-20` on enum `WebhookEndpointCreateParams.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 00000000000..9b163a5259e
--- /dev/null
+++ b/.hark/changes/2024-06-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1829
+is_stripe_api_change: true
+released_in_version: 26.1.0
+---
+
+* Add support for `filters` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntent.payment_method_options.us_bank_account.financial_connections`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`
+* Add support for `email_type` on `CreditNoteCreateParams`, `CreditNotePreviewLinesParams`, and `CreditNotePreviewParams`
+* Add support for `account_subcategories` on `FinancialConnections.Session.filters` and `financialconnections.SessionCreateParams.filters`
+* Add support for new values `multibanco`, `twint`, and `zip` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `reboot_window` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
diff --git a/.hark/changes/2024-07-03_xavdid_update-formatting-settings.change.md b/.hark/changes/2024-07-03_xavdid_update-formatting-settings.change.md
new file mode 100644
index 00000000000..f1fb85c323a
--- /dev/null
+++ b/.hark/changes/2024-07-03_xavdid_update-formatting-settings.change.md
@@ -0,0 +1,5 @@
+---
+title: Update formatting settings for VSCode
+pr_url: https://github.com/stripe/stripe-java/pull/1833
+released_in_version: 26.2.0
+---
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 00000000000..2c7ac882c6d
--- /dev/null
+++ b/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1831
+is_stripe_api_change: true
+released_in_version: 26.2.0
+---
+
+* Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
+* Add support for `posted_at` on `Tax.Transaction` and `tax.TransactionCreateFromCalculationParams`
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 00000000000..889248047b1
--- /dev/null
+++ b/.hark/changes/2024-07-11_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1835
+is_stripe_api_change: true
+released_in_version: 26.3.0
+---
+
+* Add support for `payment_method_options` on `ConfirmationToken`
+* Add support for `payment_element` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
+* Add support for `address_validation` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
+* Add support for `shipping` on `issuing.CardUpdateParams`
diff --git a/.hark/changes/2024-07-18_prathmesh_added-missing-log.change.md b/.hark/changes/2024-07-18_prathmesh_added-missing-log.change.md
new file mode 100644
index 00000000000..f5925f6e236
--- /dev/null
+++ b/.hark/changes/2024-07-18_prathmesh_added-missing-log.change.md
@@ -0,0 +1,5 @@
+---
+title: Added missing log to changelog
+pr_url: https://github.com/stripe/stripe-java/pull/1805
+released_in_version: 26.4.0
+---
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 00000000000..ddfd41e72e4
--- /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-java/pull/1836
+is_stripe_api_change: true
+released_in_version: 26.4.0
+---
+
+* Add support for `customer` on `ConfirmationToken.payment_method_preview`
+* Add support for new value `multibanco` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for new value `stripe_s700` on enum `terminal.ReaderListParams.device_type`
+* Add support for new value `issuing_dispute.funds_rescinded` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..d149b7e2efe
--- /dev/null
+++ b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1840
+is_stripe_api_change: true
+released_in_version: 26.5.1
+---
+
+* Add support for `tax_registrations` and `tax_settings` on `AccountSession.components` and `AccountSessionCreateParams.components`
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 00000000000..1fc91b6ac3c
--- /dev/null
+++ b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,16 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1837
+is_stripe_api_change: true
+released_in_version: 26.5.0
+---
+
+* Add support for `update` method on resource `Checkout.Session`
+* Add support for `transaction_id` on `Charge.payment_method_details.affirm`
+* Add support for `buyer_id` on `Charge.payment_method_details.blik`
+* Add support for `authorization_code` on `Charge.payment_method_details.card`
+* Add support for `brand_product` on `Charge.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card_present`, `PaymentMethod.card.generated_from.payment_method_details.card_present`, and `PaymentMethod.card_present`
+* Add support for `network_transaction_id` on `Charge.payment_method_details.card_present`, `Charge.payment_method_details.interac_present`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present`, and `PaymentMethod.card.generated_from.payment_method_details.card_present`
+* Add support for `case_type` on `Dispute.payment_method_details.card`
+* Add support for `twint` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for new values `invoice.overdue` and `invoice.will_be_due` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
diff --git a/.hark/changes/2024-08-01_prathmesh_update-generated-code.change.md b/.hark/changes/2024-08-01_prathmesh_update-generated-code.change.md
new file mode 100644
index 00000000000..6ec91b61af3
--- /dev/null
+++ b/.hark/changes/2024-08-01_prathmesh_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1841
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 26.6.0
+---
+
+* Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`
+* ⚠️ Remove support for `authorization_code` on `Charge.payment_method_details.card`. This was accidentally released last week.
+* Add support for new value `billing.alert.triggered` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
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 00000000000..70fe35f3213
--- /dev/null
+++ b/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,14 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1843
+is_stripe_api_change: true
+released_in_version: 26.7.0
+---
+
+* Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Billing.Alert`
+* Add support for `retrieve` method on resource `Tax.Calculation`
+* Add support for `type` on `Charge.payment_method_details.card_present.offline`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present.offline`, `PaymentMethod.card.generated_from.payment_method_details.card_present.offline`, and `SetupAttempt.payment_method_details.card_present.offline`
+* Add support for `offline` on `ConfirmationToken.payment_method_preview.card_present` and `PaymentMethod.card_present`
+* Add support for `related_customer` on `Identity.VerificationSession`, `identity.VerificationSessionCreateParams`, and `identity.VerificationSessionListParams`
+* Change `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.count`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.count`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.count`, and `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.interval` to be optional
+* Add support for new value `girocard` on enums `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
diff --git a/.hark/changes/2024-08-13_xavdid_update-recommended-vscode.change.md b/.hark/changes/2024-08-13_xavdid_update-recommended-vscode.change.md
new file mode 100644
index 00000000000..5eb49b6f8a3
--- /dev/null
+++ b/.hark/changes/2024-08-13_xavdid_update-recommended-vscode.change.md
@@ -0,0 +1,5 @@
+---
+title: Update recommended VSCode extensions
+pr_url: https://github.com/stripe/stripe-java/pull/1849
+released_in_version: 26.8.0
+---
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 00000000000..0a00dc1fbd7
--- /dev/null
+++ b/.hark/changes/2024-08-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1847
+is_stripe_api_change: true
+released_in_version: 26.8.0
+---
+
+* Add support for `authorization_code` on `Charge.payment_method_details.card`
+* Add support for `wallet` on `Charge.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card_present`, `PaymentMethod.card.generated_from.payment_method_details.card_present`, and `PaymentMethod.card_present`
+* Add support for `mandate_options` on `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, and `PaymentIntentUpdateParams.payment_method_options.bacs_debit`
+* Add support for `bacs_debit` on `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for `chips` on `Treasury.OutboundPayment.tracking_details.us_domestic_wire`, `Treasury.OutboundTransfer.tracking_details.us_domestic_wire`, `treasury.OutboundPaymentUpdateParams.tracking_details.us_domestic_wire`, and `treasury.OutboundTransferUpdateParams.tracking_details.us_domestic_wire`
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 00000000000..90cc039bc4b
--- /dev/null
+++ b/.hark/changes/2024-08-29_ramya_generate-sdk-openapi.change.md
@@ -0,0 +1,12 @@
+---
+title: Generate SDK for OpenAPI spec version 1230
+pr_url: https://github.com/stripe/stripe-java/pull/1856
+is_stripe_api_change: true
+released_in_version: 26.9.0
+---
+
+* Change `AccountLinkCreateParams.collection_options.fields` to be optional
+* Add support for new value `hr_oib` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for new value `issuing_regulatory_reporting` on enum `FileListParams.purpose`
+* Add support for new value `issuing_regulatory_reporting` on enum `FileCreateParams.purpose`
+* Add support for `status_details` on `TestHelpers.TestClock`
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 00000000000..a37a5768b5b
--- /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-java/pull/1850
+is_stripe_api_change: true
+released_in_version: 26.10.0
+---
+
+* Add support for `subscription_item` and `subscription` on `billing.AlertCreateParams.filter`
+* Change `terminal.ReaderProcessSetupIntentParams.customer_consent_collected` to be optional
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 00000000000..13e8b760060
--- /dev/null
+++ b/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,12 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1864
+is_stripe_api_change: true
+released_in_version: 26.11.0
+---
+
+* Add support for new resource `InvoiceRenderingTemplate`
+* Add support for `archive`, `list`, `retrieve`, and `unarchive` methods on resource `InvoiceRenderingTemplate`
+* Add support for `required` on `Checkout.Session.tax_id_collection`, `PaymentLink.tax_id_collection`, `PaymentLinkCreateParams.tax_id_collection`, `PaymentLinkUpdateParams.tax_id_collection`, and `checkout.SessionCreateParams.tax_id_collection`
+* Add support for `template` on `Customer.invoice_settings.rendering_options`, `CustomerCreateParams.invoice_settings.rendering_options`, `CustomerUpdateParams.invoice_settings.rendering_options`, `Invoice.rendering`, `InvoiceCreateParams.rendering`, and `InvoiceUpdateParams.rendering`
+* Add support for `template_version` on `Invoice.rendering`, `InvoiceCreateParams.rendering`, and `InvoiceUpdateParams.rendering`
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 00000000000..a09026c7388
--- /dev/null
+++ b/.hark/changes/2024-09-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,11 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1866
+is_stripe_api_change: true
+released_in_version: 26.12.0
+---
+
+* Add support for `payer_details` on `Charge.payment_method_details.klarna`
+* Add support for `amazon_pay` on `Dispute.payment_method_details`
+* Add support for `automatically_finalizes_at` on `Invoice`
+* Add support for `state_sales_tax` on `Tax.Registration.country_options.us` and `tax.RegistrationCreateParams.country_options.us`
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 00000000000..aa063dca461
--- /dev/null
+++ b/.hark/changes/2024-10-01_ramya_support-apis-new.change.md
@@ -0,0 +1,40 @@
+---
+title: Support for APIs in the new API version 2024-09-30.acacia
+pr_url: https://github.com/stripe/stripe-java/pull/1880
+is_stripe_api_change: true
+released_in_version: 27.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 `usage_threshold_config` to `usage_threshold` on `Billing.Alert` and `billing.AlertCreateParams`
+* Remove support for `filter` on `Billing.Alert` and `billing.AlertCreateParams`. Use the filters on the `usage_threshold` instead
+* Remove support for `customer_consent_collected` on `terminal.ReaderProcessSetupIntentParams`
+
+### ⚠️ 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`
+* Add method `parseThinEvent()` on the `StripeClient` class to parse [thin events](https://docs.corp.stripe.com/event-destinations#events-overview).  Rename `constructEvent()` method on the same class to `parseSnapshotEvent()` to clearly distinguish between the two kinds of events.
+* Breaking changes to public classes that are meant for internal use only and should not affect you
+    * Renamed `setStripeResponseGetter` on `ApiResource` to `setGlobalResponseGetter
+    * Added another parameter to FormEncoder.flattenParams()
+    * Removed the deprecated constructor overload on `APIRequest`
+    * Removed `GlobalStripeResponseGetterOptions.getAPiKey`  & `StripeResponseGetterOptions.getApiKey`. We now use a higher abstraction called `Authenticator` instead of passing around api keys
+    * Changed return type of `RequestOptions.RequestOptionsBuilder.getConnectTimeout` from int to java.lang.Integer.
+    * Removed the public constructor on `StripeRequest` in favor of a static `StripeRequest.create()`
+    * The unused field `partnerId` on class `Stripe` is removed
+
+### Additions
+
+* Add support for `usage_threshold` on `Billing.Alert` and `billing.AlertCreateParams`
+* Add support for `custom_unit_amount` on `ProductCreateParams.default_price_data`
+* Add support for `allow_redisplay` on `terminal.ReaderProcessPaymentIntentParams.process_config` and `terminal.ReaderProcessSetupIntentParams`
+* Add support for new value `2024-09-30.acacia` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for new Usage Billing APIs `Billing.MeterEvent`, `Billing.MeterEventAdjustments`, `Billing.MeterEventSession`, `Billing.MeterEventStream` and the new Events API `Core.Events` under the [v2 namespace ](https://docs.corp.stripe.com/api-v2-overview)
+* Add methods [rawRequest()](https://github.com/stripe/stripe-java/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.
+
+### Changes
+* Change `billingportal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates` and `billingportal.ConfigurationCreateParams.features.subscription_update.products` to be optional
diff --git a/.hark/changes/2024-10-03_ramya_removed-class-requestsigni.change.md b/.hark/changes/2024-10-03_ramya_removed-class-requestsigni.change.md
new file mode 100644
index 00000000000..445fb7fa3bb
--- /dev/null
+++ b/.hark/changes/2024-10-03_ramya_removed-class-requestsigni.change.md
@@ -0,0 +1,5 @@
+---
+title: Removed the class `RequestSigningAuthenticator` that was added in the previous release. Request Signing is not supported yet.
+pr_url: https://github.com/stripe/stripe-java/pull/1891
+released_in_version: 27.1.0
+---
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 00000000000..a8b6fec8554
--- /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` and `reason`
+pr_url: https://github.com/stripe/stripe-java/pull/1890
+released_in_version: 27.1.0
+---
diff --git a/.hark/changes/2024-10-03_ramya_update-generated-code.change.md b/.hark/changes/2024-10-03_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..613efe4b214
--- /dev/null
+++ b/.hark/changes/2024-10-03_ramya_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1889
+is_stripe_api_change: true
+released_in_version: 27.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_ramya_fixed-example-raw.change.md b/.hark/changes/2024-10-09_ramya_fixed-example-raw.change.md
new file mode 100644
index 00000000000..6cd4c8eb416
--- /dev/null
+++ b/.hark/changes/2024-10-09_ramya_fixed-example-raw.change.md
@@ -0,0 +1,5 @@
+---
+title: Fixed example for raw request in readme file
+pr_url: https://github.com/stripe/stripe-java/pull/1894
+released_in_version: 27.1.1
+---
diff --git a/.hark/changes/2024-10-11_jar_clean-up-examples.change.md b/.hark/changes/2024-10-11_jar_clean-up-examples.change.md
new file mode 100644
index 00000000000..f2439b68039
--- /dev/null
+++ b/.hark/changes/2024-10-11_jar_clean-up-examples.change.md
@@ -0,0 +1,5 @@
+---
+title: Clean up examples
+pr_url: https://github.com/stripe/stripe-java/pull/1898
+released_in_version: 27.1.1
+---
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 00000000000..02bcb7cd2e0
--- /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-java/pull/1901
+released_in_version: 27.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-23_jar_update-webhook-api.change.md b/.hark/changes/2024-10-23_jar_update-webhook-api.change.md
new file mode 100644
index 00000000000..a4e3f95668d
--- /dev/null
+++ b/.hark/changes/2024-10-23_jar_update-webhook-api.change.md
@@ -0,0 +1,7 @@
+---
+title: Update webhook API version validation
+pr_url: https://github.com/stripe/stripe-java/pull/1906
+released_in_version: 27.1.2
+---
+
+- Update webhook event processing to accept events from any API version within the supported major release
diff --git a/.hark/changes/2024-10-25_jar_fixes-bug-1899.change.md b/.hark/changes/2024-10-25_jar_fixes-bug-1899.change.md
new file mode 100644
index 00000000000..1dcd566ad9f
--- /dev/null
+++ b/.hark/changes/2024-10-25_jar_fixes-bug-1899.change.md
@@ -0,0 +1,7 @@
+---
+title: "Fixes bug [#1899](https://github.com/stripe/stripe-java/issues/1899)"
+pr_url: https://github.com/stripe/stripe-java/pull/1911
+released_in_version: 27.1.2
+---
+
+- Fixes the bug introduced in v27 where StripeException#getUserMessage on v1 API errors would return null instead of the error message.
diff --git a/.hark/changes/2024-10-28_xavdid_add-tolerance-argument.change.md b/.hark/changes/2024-10-28_xavdid_add-tolerance-argument.change.md
new file mode 100644
index 00000000000..3b443757bd4
--- /dev/null
+++ b/.hark/changes/2024-10-28_xavdid_add-tolerance-argument.change.md
@@ -0,0 +1,7 @@
+---
+title: add `tolerance` argument to `parseThinEvent`
+pr_url: https://github.com/stripe/stripe-java/pull/1912
+released_in_version: 27.1.2
+---
+
+- The default `tolerance` value is still what most users will want, but this fixes an oversight where it wasn't possible to set `tolerance` at all when parsing thin events
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 00000000000..39453494b21
--- /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-java/pull/1896
+is_stripe_api_change: true
+released_in_version: 28.0.0
+---
+
+* Add support for new resource `V2.EventDestinations`
+* Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
+* Add support for `submit_card` test helper method on resource `Issuing.Card`
+* Add support for `groups` on `AccountCreateParams`, `AccountUpdateParams`, and `Account`
+* Add support for `alma_payments`, `kakao_pay_payments`, `kr_card_payments`, `naver_pay_payments`, `payco_payments`, and `samsung_pay_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `disable_stripe_user_authentication` on `AccountSession.components.account_management.features`, `AccountSession.components.account_onboarding.features`, `AccountSession.components.balances.features`, `AccountSession.components.notification_banner.features`, `AccountSession.components.payouts.features`, `AccountSessionCreateParams.components.account_management.features`, `AccountSessionCreateParams.components.account_onboarding.features`, `AccountSessionCreateParams.components.balances.features`, `AccountSessionCreateParams.components.notification_banner.features`, and `AccountSessionCreateParams.components.payouts.features`
+* Add support for `schedule_at_period_end` on `BillingPortal.Configuration.features.subscription_update`, `billingportal.ConfigurationCreateParams.features.subscription_update`, and `billingportal.ConfigurationUpdateParams.features.subscription_update`
+* Change `billingportal.ConfigurationCreateParams.business_profile` to be optional
+* Add support for `alma` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `Refund.destination_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `kakao_pay` and `kr_card` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `naver_pay` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `payco` and `samsung_pay` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new values `alma`, `kakao_pay`, `kr_card`, `naver_pay`, `payco`, and `samsung_pay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, `PaymentMethodListParams.type`, and `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new values `alma`, `kakao_pay`, `kr_card`, `naver_pay`, `payco`, and `samsung_pay` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `auto` on enum `CustomerUpdateParams.tax.validate_location`
+* Add support for new values `by_tin`, `ma_vat`, `md_vat`, `tz_vat`, `uz_tin`, and `uz_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `enhanced_evidence` on `Dispute.evidence` and `DisputeUpdateParams.evidence`
+* Add support for `enhanced_eligibility_types` on `Dispute`
+* Add support for `enhanced_eligibility` on `Dispute.evidence_details`
+* Add support for `metadata` on `Forwarding.Request` and `forwarding.RequestCreateParams`
+* Add support for `automatically_finalizes_at` on `InvoiceCreateParams` and `InvoiceUpdateParams`
+* Add support for new values `jp_credit_transfer`, `kakao_pay`, `kr_card`, `naver_pay`, and `payco` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
+* Add support for new value `retail_delivery_fee` on enums `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `TaxRateCreateParams.tax_type`, and `TaxRateUpdateParams.tax_type`
+* Add support for new value `alma` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `amazon_pay` on `PaymentMethodDomain`
+* Add support for `flat_amount` and `rate_type` on `Tax.Calculation.tax_breakdown[].tax_rate_details` and `TaxRate`
+* Add support for `by`, `cr`, `ec`, `ma`, `md`, `rs`, `ru`, `tz`, and `uz` on `Tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Add support for new value `state_retail_delivery_fee` on enum `tax.RegistrationCreateParams.country_options.us.type`
+* Add support for `pln` on `Terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for new values `issuing_transaction.purchase_details_receipt_updated` and `refund.failed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+* Add support for new value `2024-10-28.acacia` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2024-11-06_helenye_catch-jsonsyntaxex-processing.change.md b/.hark/changes/2024-11-06_helenye_catch-jsonsyntaxex-processing.change.md
new file mode 100644
index 00000000000..b24093b3b1d
--- /dev/null
+++ b/.hark/changes/2024-11-06_helenye_catch-jsonsyntaxex-processing.change.md
@@ -0,0 +1,5 @@
+---
+title: Catch `JsonSyntaxException` when processing all errors
+pr_url: https://github.com/stripe/stripe-java/pull/1919
+released_in_version: 28.0.1
+---
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 00000000000..c24be2dc46a
--- /dev/null
+++ b/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1923
+is_stripe_api_change: true
+released_in_version: 28.1.0
+---
+
+* Add support for `respond` test helper method on resource `Issuing.Authorization`
+* Add support for `authorizer` on `AccountPersonsParams.relationship` and `TokenCreateParams.person.relationship`
+* Add support for `adaptive_pricing` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Add support for `mandate_options` on `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.sepa_debit`, `checkout.SessionCreateParams.payment_method_options.bacs_debit`, and `checkout.SessionCreateParams.payment_method_options.sepa_debit`
+* Add support for `request_extended_authorization`, `request_incremental_authorization`, `request_multicapture`, and `request_overcapture` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
+* Add support for `capture_method` on `checkout.SessionCreateParams.payment_method_options.kakao_pay`, `checkout.SessionCreateParams.payment_method_options.kr_card`, `checkout.SessionCreateParams.payment_method_options.naver_pay`, `checkout.SessionCreateParams.payment_method_options.payco`, and `checkout.SessionCreateParams.payment_method_options.samsung_pay`
+* Add support for new value `subscribe` on enums `PaymentLinkCreateParams.submit_type` and `checkout.SessionCreateParams.submit_type`
+* Add support for new value `li_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for new value `financial_account_statement` on enum `FileListParams.purpose`
+* Add support for `account_holder_address`, `account_holder_name`, `account_type`, and `bank_address` on `FundingInstructions.bank_transfer.financial_addresses[].aba`, `FundingInstructions.bank_transfer.financial_addresses[].swift`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba`, and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swift`
+* Add support for new value `service_tax` on enums `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type`, `TaxRateCreateParams.tax_type`, and `TaxRateUpdateParams.tax_type`
+* Add support for `merchant_amount` and `merchant_currency` on `issuing.AuthorizationCreateParams`
+* Change `issuing.AuthorizationCreateParams.amount` to be optional
+* Add support for `fraud_challenges` and `verified_by_fraud_challenge` on `Issuing.Authorization`
+* Add support for new value `link` on enums `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
+* Add support for `submit_type` on `PaymentLinkUpdateParams`
+* Add support for `trace_id` on `Payout`
+* Add support for `network_decline_code` on `Refund.destination_details.blik` and `Refund.destination_details.swish`
+* Add support for new value `2024-11-20.acacia` on enum `WebhookEndpointCreateParams.api_version`
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 00000000000..c9db4b7493b
--- /dev/null
+++ b/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,25 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1931
+is_stripe_api_change: true
+released_in_version: 28.2.0
+---
+
+* Add support for `network_advice_code` and `network_decline_code` on `Charge.outcome`, `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+* Add support for `credits_application_invoice_voided` on `Billing.CreditBalanceTransaction.credit`
+* Change type of `Billing.CreditBalanceTransaction.credit.type` from `literal('credits_granted')` to `enum('credits_application_invoice_voided'|'credits_granted')`
+* Add support for `allow_redisplay` on `Card` and `Source`
+* Add support for `regulated_status` on `Card`, `Charge.payment_method_details.card`, `ConfirmationToken.payment_method_preview.card`, and `PaymentMethod.card`
+* Add support for `funding` on `Charge.payment_method_details.amazon_pay` and `Charge.payment_method_details.revolut_pay`
+* Add support for `network_transaction_id` on `Charge.payment_method_details.card`
+* Add support for `reference_prefix` on `Checkout.Session.payment_method_options.bacs_debit.mandate_options`, `Checkout.Session.payment_method_options.sepa_debit.mandate_options`, `PaymentIntent.payment_method_options.bacs_debit.mandate_options`, `PaymentIntent.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntent.payment_method_options.bacs_debit.mandate_options`, `SetupIntent.payment_method_options.sepa_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options`, `SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options`, `SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options`, `SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_options`, `checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options`, and `checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options`
+* Add support for new values `al_tin`, `am_tin`, `ao_tin`, `ba_tin`, `bb_tin`, `bs_tin`, `cd_nif`, `gn_nif`, `kh_tin`, `me_pib`, `mk_vat`, `mr_nif`, `np_pan`, `sn_ninea`, `sr_fin`, `tj_tin`, `ug_tin`, `zm_tin`, and `zw_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `visa_compliance` on `Dispute.evidence.enhanced_evidence`, `Dispute.evidence_details.enhanced_eligibility`, and `DisputeUpdateParams.evidence.enhanced_evidence`
+* Add support for new value `request_signature` on enum `forwarding.RequestCreateParams.replacements[]`
+* Add support for `account_holder_address` and `bank_address` on `FundingInstructions.bank_transfer.financial_addresses[].iban`, `FundingInstructions.bank_transfer.financial_addresses[].sort_code`, `FundingInstructions.bank_transfer.financial_addresses[].spei`, `FundingInstructions.bank_transfer.financial_addresses[].zengin`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code`, `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei`, and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin`
+* Add support for `account_holder_name` on `FundingInstructions.bank_transfer.financial_addresses[].spei` and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei`
+* Add support for `disabled_reason` on `Invoice.automatic_tax`, `Subscription.automatic_tax`, `SubscriptionSchedule.default_settings.automatic_tax`, and `SubscriptionSchedule.phases[].automatic_tax`
+* Add support for `tax_id` on `Issuing.Authorization.merchant_data` and `Issuing.Transaction.merchant_data`
+* Add support for `trial_period_days` on `PaymentLinkUpdateParams.subscription_data`
+* Add support for `al`, `am`, `ao`, `ba`, `bb`, `bs`, `cd`, `gn`, `kh`, `me`, `mk`, `mr`, `np`, `pe`, `sn`, `sr`, `tj`, `ug`, `uy`, `zm`, and `zw` on `Tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Add support for new value `2024-12-18.acacia` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2024-12-19_jar_added-pull-request.change.md b/.hark/changes/2024-12-19_jar_added-pull-request.change.md
new file mode 100644
index 00000000000..6a4f7290e15
--- /dev/null
+++ b/.hark/changes/2024-12-19_jar_added-pull-request.change.md
@@ -0,0 +1,5 @@
+---
+title: Added pull request template
+pr_url: https://github.com/stripe/stripe-java/pull/1933
+released_in_version: 28.3.0
+---
diff --git a/.hark/changes/2025-01-13_xavdid_add-justfile-tweak.change.md b/.hark/changes/2025-01-13_xavdid_add-justfile-tweak.change.md
new file mode 100644
index 00000000000..438c935ca2a
--- /dev/null
+++ b/.hark/changes/2025-01-13_xavdid_add-justfile-tweak.change.md
@@ -0,0 +1,5 @@
+---
+title: add justfile tweak readme, remove coveralls
+pr_url: https://github.com/stripe/stripe-java/pull/1934
+released_in_version: 28.3.0
+---
diff --git a/.hark/changes/2025-01-16_jar_added-contributing-md.change.md b/.hark/changes/2025-01-16_jar_added-contributing-md.change.md
new file mode 100644
index 00000000000..e2f8ac1a340
--- /dev/null
+++ b/.hark/changes/2025-01-16_jar_added-contributing-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Added CONTRIBUTING.md file
+pr_url: https://github.com/stripe/stripe-java/pull/1937
+released_in_version: 28.3.0
+---
diff --git a/.hark/changes/2025-01-16_xavdid_update-justfile-import.change.md b/.hark/changes/2025-01-16_xavdid_update-justfile-import.change.md
new file mode 100644
index 00000000000..1f7d8e7b03e
--- /dev/null
+++ b/.hark/changes/2025-01-16_xavdid_update-justfile-import.change.md
@@ -0,0 +1,5 @@
+---
+title: update justfile import & pin CI ubuntu
+pr_url: https://github.com/stripe/stripe-java/pull/1938
+released_in_version: 28.3.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 00000000000..4f55204b522
--- /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-java/pull/1941
+released_in_version: 28.3.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 00000000000..2c268f4a138
--- /dev/null
+++ b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1936
+is_stripe_api_change: true
+released_in_version: 28.3.0
+---
+
+* Add support for `close` method on resource `Treasury.FinancialAccount`
+* Add support for `pay_by_bank_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `directorship_declaration` and `ownership_exemption_reason` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+* Add support for `proof_of_ultimate_beneficial_ownership` on `AccountCreateParams.documents` and `AccountUpdateParams.documents`
+* Add support for `financial_account` on `AccountSession.components`, `AccountSessionCreateParams.components`, and `Treasury.OutboundTransfer.destination_payment_method_details`
+* Add support for `financial_account_transactions`, `issuing_card`, and `issuing_cards_list` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `advice_code` on `Charge.outcome`, `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
+* Add support for `pay_by_bank` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `country` on `Charge.payment_method_details.paypal`, `ConfirmationToken.payment_method_preview.paypal`, and `PaymentMethod.paypal`
+* Add support for new value `pay_by_bank` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, `PaymentMethodListParams.type`, and `checkout.SessionCreateParams.payment_method_types[]`
+* Add support for new value `SD` on enums `PaymentLinkCreateParams.shipping_address_collection.allowed_countries[]`, `PaymentLinkUpdateParams.shipping_address_collection.allowed_countries[]`, and `checkout.SessionCreateParams.shipping_address_collection.allowed_countries[]`
+* Add support for `discounts` on `Checkout.Session`
+* Add support for new value `pay_by_bank` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `pay_by_bank` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
+* Add support for `phone_number_collection` on `PaymentLinkUpdateParams`
+* Add support for `jpy` on `Terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for `nickname` on `Treasury.FinancialAccount`, `treasury.FinancialAccountCreateParams`, and `treasury.FinancialAccountUpdateParams`
+* Add support for `forwarding_settings` on `treasury.FinancialAccountUpdateParams`
+* Add support for `is_default` on `Treasury.FinancialAccount`
+* Add support for `destination_payment_method_data` on `treasury.OutboundTransferCreateParams`
+* Change type of `Treasury.OutboundTransfer.destination_payment_method_details.type` from `literal('us_bank_account')` to `enum('financial_account'|'us_bank_account')`
+* Add support for new value `outbound_transfer` on enum `treasury.ReceivedCreditListParams.linked_flows.source_flow_type`
+* Add support for `outbound_transfer` on `Treasury.ReceivedCredit.linked_flows.source_flow_details`
+* Add support for new value `2025-01-27.acacia` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2025-02-05_xavdid_ensure-getrawjsonob-returns.change.md b/.hark/changes/2025-02-05_xavdid_ensure-getrawjsonob-returns.change.md
new file mode 100644
index 00000000000..ad25cf04628
--- /dev/null
+++ b/.hark/changes/2025-02-05_xavdid_ensure-getrawjsonob-returns.change.md
@@ -0,0 +1,5 @@
+---
+title: Ensure `getRawJsonObject` returns data for constructed webhooks
+pr_url: https://github.com/stripe/stripe-java/pull/1946
+released_in_version: 28.3.1
+---
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 00000000000..44a6ef3b819
--- /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-java/pull/1948
+released_in_version: 28.4.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 00000000000..67a45608445
--- /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-java/pull/1943
+is_stripe_api_change: true
+released_in_version: 28.4.0
+---
+
+* Add support for `prices` on `Billing.CreditGrant.applicability_config.scope`, `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, and `billing.CreditGrantCreateParams.applicability_config.scope`
+* Change `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type` and `billing.CreditGrantCreateParams.applicability_config.scope.price_type` to be optional
+* Add support for `priority` on `Billing.CreditGrant` and `billing.CreditGrantCreateParams`
+* Add support for `target_date` on `Checkout.Session.payment_method_options.acss_debit`, `Checkout.Session.payment_method_options.au_becs_debit`, `Checkout.Session.payment_method_options.bacs_debit`, `Checkout.Session.payment_method_options.sepa_debit`, `Checkout.Session.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.acss_debit`, `PaymentIntent.payment_method_options.au_becs_debit`, `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntent.payment_method_options.sepa_debit`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.acss_debit`, `PaymentIntentConfirmParams.payment_method_options.au_becs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.acss_debit`, `PaymentIntentCreateParams.payment_method_options.au_becs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.sepa_debit`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.acss_debit`, `PaymentIntentUpdateParams.payment_method_options.au_becs_debit`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `checkout.SessionCreateParams.payment_method_options.acss_debit`, `checkout.SessionCreateParams.payment_method_options.au_becs_debit`, `checkout.SessionCreateParams.payment_method_options.bacs_debit`, `checkout.SessionCreateParams.payment_method_options.sepa_debit`, and `checkout.SessionCreateParams.payment_method_options.us_bank_account`
+* Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
+* Add support for `collected_information` on `Checkout.Session` and `checkout.SessionUpdateParams`
+* Add support for `metadata` on `ProductCreateParams.default_price_data`
+* Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
+* Add support for new value `2025-02-24.acacia` on enum `WebhookEndpointCreateParams.api_version`
diff --git a/.hark/changes/2025-03-17_mbroshi_add-equalsandhas-annotations.change.md b/.hark/changes/2025-03-17_mbroshi_add-equalsandhas-annotations.change.md
new file mode 100644
index 00000000000..ca66ebbc0bc
--- /dev/null
+++ b/.hark/changes/2025-03-17_mbroshi_add-equalsandhas-annotations.change.md
@@ -0,0 +1,7 @@
+---
+title: Add @EqualsAndHashCode annotations
+pr_url: https://github.com/stripe/stripe-java/pull/1955
+released_in_version: 29.0.0
+---
+
+- Adds `@EqualsAndHashCode(callSuper = false)` to all Params objects which is useful for unit test assertions and caching scenarios.
diff --git a/.hark/changes/2025-03-19_ramya_support-stripeaccoun-stripeclient.change.md b/.hark/changes/2025-03-19_ramya_support-stripeaccoun-stripeclient.change.md
new file mode 100644
index 00000000000..3e5ed385dd2
--- /dev/null
+++ b/.hark/changes/2025-03-19_ramya_support-stripeaccoun-stripeclient.change.md
@@ -0,0 +1,9 @@
+---
+title: Support for StripeAccount in StripeClient, and StripeContext on V1
+pr_url: https://github.com/stripe/stripe-java/pull/1958
+semver_level: major
+released_in_version: 29.0.0
+---
+
+* ⚠️ Adds `getStripeAccount` to `StripeResponseGetterOptions`.  If you have a class that extends `StripeResponseGetterOptions` you will need to implement this method.
+* Adds `setStripeAccount` to StripeClientBuilder, so you can specify the Stripe-Account header at the client (instead of the individual request) level.
diff --git a/.hark/changes/2025-03-31_ramya_support-apis-new.change.md b/.hark/changes/2025-03-31_ramya_support-apis-new.change.md
new file mode 100644
index 00000000000..164bd780d55
--- /dev/null
+++ b/.hark/changes/2025-03-31_ramya_support-apis-new.change.md
@@ -0,0 +1,78 @@
+---
+title: Support for APIs in the new API version 2025-03-31.basil
+pr_url: https://github.com/stripe/stripe-java/pull/1950
+is_stripe_api_change: true
+released_in_version: 29.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 `shippingDetails` on `Checkout.Session`
+* Remove support for `carrier`, `phone`, and `trackingNumber` on `Checkout.Session.collected_information.shipping_details`
+* Remove support for `refund` on `CreditNoteCreateParams`, `CreditNotePreviewLinesListParams`, `CreditNotePreviewParams`, and `CreditNote`
+* Remove support for `taxAmounts` on `CreditNoteLineItem`, `CreditNote`, and `InvoiceLineItem`
+* Remove support for `amountExcludingTax` and `unitAmountExcludingTax` on `CreditNoteLineItem` and `InvoiceLineItem`
+* Remove support for `coupon` on `CustomerCreateParams`, `CustomerUpdateParams`, `InvoiceCreatePreviewParams.schedule_details.phases[]`, `InvoiceCreatePreviewParams`, `SubscriptionCreateParams`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[]`, and `SubscriptionUpdateParams`
+* Remove support for `promotionCode` on `CustomerCreateParams`, `CustomerUpdateParams`, `SubscriptionCreateParams`, and `SubscriptionUpdateParams`
+* Remove support for `price` on `InvoiceAddLinesParams.lines[]`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams.lines[]`
+* Remove support for `billingThresholds` on `InvoiceCreatePreviewParams.schedule_details.phases[].items[]`, `InvoiceCreatePreviewParams.schedule_details.phases[]`, `InvoiceCreatePreviewParams.subscription_details.items[]`, `SubscriptionCreateParams.items[]`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionItem`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[].items[]`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, `SubscriptionScheduleUpdateParams.phases[].items[]`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams.items[]`, `SubscriptionUpdateParams`, and `Subscription`
+* Remove support for `applicationFeeAmount`, `charge`, `paidOutOfBand`, `paid`, `paymentIntent`, `quote`, `subscription`, `subscriptionDetails`, `subscriptionProrationDate`, `tax`, `totalTaxAmounts`, and `transferData` on `Invoice`
+* Remove support for `discount` on `Invoice` and `Subscription`
+* Remove support for `invoiceItem`, `prorationDetails`, `proration`, `taxRates`, and `type` on `InvoiceLineItem`
+* Remove support for `plan` and `subscriptionItem` on `InvoiceItem` and `InvoiceLineItem`
+* Remove support for `unitAmount` on `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, and `InvoiceItem`
+* Remove support for `subscription` and `unitAmountDecimal` on `InvoiceItem`
+* Remove support for `naverPay` on `PaymentMethodUpdateParams`
+* Remove support for `aggregateUsage` on `PlanCreateParams`, `Plan`, `Price.recurring`, and `PriceCreateParams.recurring`
+* Remove support for `currentPeriodEnd` and `currentPeriodStart` on `Subscription`
+* Remove support for page on `V2.EventDestinationListParams` and `V2.EventListParams`
+
+### Changes to the Stripe API
+
+* Change `PaymentIntentConfirmParams.payment_method_options.wechat_pay.client`, `PaymentIntentCreateParams.payment_method_options.wechat_pay.client`, and `PaymentIntentUpdateParams.payment_method_options.wechat_pay.client` to be optional
+* Change `politicalExposure` on `AccountPersonUpdateParams`, `AccountPersonCreateParams` from `string` to `PoliticalExposure` enum.
+
+### Additions to the Stripe API
+
+* Add support for new resource `InvoicePayment`
+* Add support for `list` and `retrieve` methods on resource `InvoicePayment`
+* Add support for `billiePayments`, `nzBankAccountBecsDebitPayments`, and `satispayPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `hostedPaymentMethodSave` on `Account.settings.invoices` and `AccountUpdateParams.settings.invoices`
+* Add support for `invoices` on `AccountCreateParams.settings`
+* Add support for new value `last` on enum `billing.MeterCreateParams.default_aggregation.formula`
+* Add support for `presentmentDetails` on `Charge`, `Checkout.Session`, `PaymentIntent`, and `Refund`
+* Add support for `billie` and `satispay` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `CustomerPaymentMethod`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `nzBankAccount` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `CustomerPaymentMethod`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `optionalItems` on `Checkout.Session`, `PaymentLinkCreateParams`, `PaymentLink`, and `checkout.SessionCreateParams`
+* Add support for `permissions` on `Checkout.Session` and `checkout.SessionCreateParams`
+* Add support for new values `billie` and `satispay` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for new value `custom` on enum `checkout.SessionCreateParams.uiMode`
+* Add support for `shippingOptions` on `checkout.SessionUpdateParams`
+* Add support for new values `billie`, `nz_bank_account`, and `satispay` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for `buyerId` on `ConfirmationToken.payment_method_preview.naver_pay`, `CustomerPaymentMethod.naver_pay`, and `PaymentMethod.naver_pay`
+* Add support for `refunds` on `CreditNoteCreateParams`, `CreditNotePreviewLinesListParams`, `CreditNotePreviewParams`, and `CreditNote`
+* Add support for `totalTaxes` on `CreditNote` and `Invoice`
+* Add support for `taxes` on `CreditNoteLineItem` and `InvoiceLineItem`
+* Add support for `taxabilityReason` on `InvoiceAddLinesParams.lines[].tax_amounts[]`, `InvoiceLineItemUpdateParams.tax_amounts[]`, and `InvoiceUpdateLinesParams.lines[].tax_amounts[]`
+* Add support for `jurisdictionLevel` on `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data`, `InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data`, and `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data`
+* Add support for `amountOverpaid`, `confirmationSecret`, and `payments` on `Invoice`
+* Add support for `parent` on `InvoiceItem`, `InvoiceLineItem`, and `Invoice`
+* Add support for new values `klarna` and `nz_bank_account` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `pricing` on `InvoiceAddLinesParams.lines[]`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams.lines[]`
+* Add support for `taxabilityReason` on `InvoiceAddLinesParams.lines[].tax_amounts[]`, `InvoiceLineItemUpdateParams.tax_amounts[]`, and `InvoiceUpdateLinesParams.lines[].tax_amounts[]`
+* Add support for `defaultValue` on `PaymentLink.custom_fields[].dropdown`, `PaymentLink.custom_fields[].numeric`, `PaymentLink.custom_fields[].text`, `PaymentLinkCreateParams.custom_fields[].dropdown`, `PaymentLinkCreateParams.custom_fields[].numeric`, `PaymentLinkCreateParams.custom_fields[].text`, `PaymentLinkUpdateParams.custom_fields[].dropdown`, `PaymentLinkUpdateParams.custom_fields[].numeric`, and `PaymentLinkUpdateParams.custom_fields[].text`
+* Add support for new values `billie` and `satispay` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for `nzBankTransfer` on `Refund.destination_details`
+* Add support for `currentPeriodEnd` and `currentPeriodStart` on `SubscriptionItem`
+* Add support for `wifi` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
+* Add support for new value `invoice.overpaid` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new values `2025-03-01.dashboard` and `2025-03-31.basil` on enum `WebhookEndpointCreateParams.apiVersion`
diff --git a/.hark/changes/2025-04-02_xavdid_require-beta-sdks.change.md b/.hark/changes/2025-04-02_xavdid_require-beta-sdks.change.md
new file mode 100644
index 00000000000..12c67613fc2
--- /dev/null
+++ b/.hark/changes/2025-04-02_xavdid_require-beta-sdks.change.md
@@ -0,0 +1,9 @@
+---
+title: require beta SDKs match event versions exactly when deserializing
+pr_url: https://github.com/stripe/stripe-java/pull/1971
+semver_level: major
+released_in_version: 29.1.0
+---
+
+- ⚠️ Public Preview SDKs now require an exact API version match when deserializing webhooks
+    - To deserialize events from another API version, use `EventDataObjectDeserializer .deserializeUnsafe()` instead of `.deserialize()`.
diff --git a/.hark/changes/2025-04-08_ramya_update-readme-clarificatio.change.md b/.hark/changes/2025-04-08_ramya_update-readme-clarificatio.change.md
new file mode 100644
index 00000000000..309e275df9f
--- /dev/null
+++ b/.hark/changes/2025-04-08_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-java/pull/1982
+released_in_version: 29.1.0
+---
diff --git a/.hark/changes/2025-04-08_xavdid_backport-beta-fixes.change.md b/.hark/changes/2025-04-08_xavdid_backport-beta-fixes.change.md
new file mode 100644
index 00000000000..1c2d8d1a31b
--- /dev/null
+++ b/.hark/changes/2025-04-08_xavdid_backport-beta-fixes.change.md
@@ -0,0 +1,5 @@
+---
+title: backport beta fixes
+pr_url: https://github.com/stripe/stripe-java/pull/1976
+released_in_version: 29.1.0
+---
diff --git a/.hark/changes/2025-04-21_mbroshi_update-manual-installation.change.md b/.hark/changes/2025-04-21_mbroshi_update-manual-installation.change.md
new file mode 100644
index 00000000000..cbaf8d215eb
--- /dev/null
+++ b/.hark/changes/2025-04-21_mbroshi_update-manual-installation.change.md
@@ -0,0 +1,5 @@
+---
+title: Update manual installation instructions in README.md
+pr_url: https://github.com/stripe/stripe-java/pull/1989
+released_in_version: 29.1.0
+---
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 00000000000..9afb1890400
--- /dev/null
+++ b/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/1986
+is_stripe_api_change: true
+released_in_version: 29.1.0
+---
+
+This release changes the pinned API version to `2025-04-30.basil`.
+
+* Add support for `minorityOwnedBusinessDesignation` on `Account.business_profile`, `AccountCreateParams.business_profile`, and `AccountUpdateParams.business_profile`
+* Add support for `registrationDate` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+* Add support for `usCfpbData` on `AccountCreateParams`, `AccountPersonCreateParams`, `AccountPersonUpdateParams`, `AccountUpdateParams`, `Person`, and `TokenCreateParams.person`
+* Add support for `taxId` on `Charge.billing_details`, `ConfirmationToken.payment_method_preview.billing_details`, `ConfirmationTokenCreateParams.payment_method_data.billing_details`, `PaymentIntentConfirmParams.payment_method_data.billing_details`, `PaymentIntentCreateParams.payment_method_data.billing_details`, `PaymentIntentUpdateParams.payment_method_data.billing_details`, `PaymentMethod.billing_details`, `PaymentMethodCreateParams.billing_details`, `PaymentMethodUpdateParams.billing_details`, `SetupIntentConfirmParams.payment_method_data.billing_details`, `SetupIntentCreateParams.payment_method_data.billing_details`, `SetupIntentUpdateParams.payment_method_data.billing_details`, `testhelpers.ConfirmationTokenCreateParams.payment_method_data.billing_details`, and `treasury.OutboundPaymentCreateParams.destination_payment_method_data.billing_details`
+* Add support for `walletOptions` on `checkout.SessionCreateParams` and `checkout.Session`
+* Add support for `provider` on `Invoice.automatic_tax`, `Quote.automatic_tax`, and `checkout.Session.automatic_tax`
+* Add support for `paymentMethodOptions` on `ConfirmationTokenCreateParams` and `testhelpers.ConfirmationTokenCreateParams`
+* Add support for `installments` on `ConfirmationToken.payment_method_options.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 `CustomerCreateParams.tax_id_data[].type`, `CustomerCreateParams.type`, `CustomerTaxIdCreateParams.type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `context` on `Event`
+* Add support for new value `affirm` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `billie` on `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_options`, and `PaymentIntentUpdateParams.payment_method_options`
+* Add support for `pix` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `klarna` on `PaymentMethodDomain`
+* Add support for `pendingReason` on `Refund`
+* Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Add support for new value `2025-04-30.basil` on enums `WebhookEndpointCreateParams.apiVersion`
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 00000000000..ce001a40f5b
--- /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-java/pull/1997
+released_in_version: 29.2.0
+---
diff --git a/.hark/changes/2025-05-27_jar_adds-generated-customer.change.md b/.hark/changes/2025-05-27_jar_adds-generated-customer.change.md
new file mode 100644
index 00000000000..4e859038248
--- /dev/null
+++ b/.hark/changes/2025-05-27_jar_adds-generated-customer.change.md
@@ -0,0 +1,7 @@
+---
+title: Adds generated Customer retrievePaymentMethod overload
+pr_url: https://github.com/stripe/stripe-java/pull/2002
+released_in_version: 29.2.0
+---
+
+* Adds `retrievePaymentMethod` overload to `Customer` that accepts a payment method id and `RequestOptions` object
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 00000000000..a8abff796cb
--- /dev/null
+++ b/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,32 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-java/pull/2000
+is_stripe_api_change: true
+released_in_version: 29.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 `pixPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `disputesList` and `paymentDisputes` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `refundAndDisputePrefunding` on `Balance`
+* Add support for `balanceType` on `BalanceTransaction`
+* Change `billing.AlertCreateParams.usage_threshold.meter` to be required
+* Add support for `location` and `reader` on `Charge.payment_method_details.affirm` and `Charge.payment_method_details.wechat_pay`
+* Add support for `paymentMethodRemove` on `checkout.SessionCreateParams.saved_payment_method_options`
+* Add support for `setupFutureUsage` on `checkout.Session.payment_method_options.naver_pay`
+* Add support for `postPaymentAmount` and `prePaymentAmount` on `CreditNote`
+* Add support for `sex`, `unparsedPlaceOfBirth`, and `unparsedSex` on `identity.VerificationReport.document` and `identity.VerificationSession.verified_outputs`
+* Add support for `billingThresholds` on `InvoiceCreatePreviewParams.schedule_details.phases[].items[]`, `InvoiceCreatePreviewParams.schedule_details.phases[]`, `InvoiceCreatePreviewParams.subscription_details.items[]`, `SubscriptionCreateParams.items[]`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionItem`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[].items[]`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, `SubscriptionScheduleUpdateParams.phases[].items[]`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams.items[]`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `satispay` on `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_options`, and `PaymentIntentUpdateParams.payment_method_options`
+* Add support for `captureMethod` on `PaymentIntent.payment_method_options.billie`
+* Add support for `kakaoPay`, `krCard`, `naverPay`, `payco`, and `samsungPay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `networkDeclineCode` on `Refund.destination_details.paypal`
+* Add support for `metadata` on `tax.CalculationCreateParams.line_items[]` and `tax.CalculationLineItem`
+* Add support for new value `simulated_stripe_s700` on enum `terminal.ReaderListParams.deviceType`
+* Add support for `returnUrl` on `terminal.Reader.action.process_payment_intent.process_config` and `terminal.ReaderProcessPaymentIntentParams.process_config`
+* Add support for `collectInputs` on `terminal.Reader.action`
+* Add support for new value `invoice_payment.paid` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new value `2025-05-28.basil` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for snapshot event `invoice_payment.paid` with resource `InvoicePayment`
diff --git a/.hark/changes/2025-06-03_prathmesh_include-java-versions.change.md b/.hark/changes/2025-06-03_prathmesh_include-java-versions.change.md
new file mode 100644
index 00000000000..bd844820cf7
--- /dev/null
+++ b/.hark/changes/2025-06-03_prathmesh_include-java-versions.change.md
@@ -0,0 +1,5 @@
+---
+title: Include Java versions 21, 22, 23, 24 in CI
+pr_url: https://github.com/stripe/stripe-java/pull/1987
+released_in_version: 29.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 00000000000..5ae0930ec80
--- /dev/null
+++ b/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,34 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-java/pull/2013
+is_stripe_api_change: true
+released_in_version: 29.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 `cryptoPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `proofOfAddress` on `AccountCreateParams.documents` and `AccountUpdateParams.documents`
+* Add support for `monthlyPayoutDays` and `weeklyPayoutDays` on `Account.settings.payouts.schedule`, `AccountCreateParams.settings.payouts.schedule`, and `AccountUpdateParams.settings.payouts.schedule`
+* Add support for `crypto` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Change type of `Charge.payment_method_details.card.installments.plan.type`, `ConfirmationToken.payment_method_options.card.installments.plan.type`, `ConfirmationTokenCreateParams.payment_method_options.card.installments.plan.type`, `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.type`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.type`, `PaymentIntent.payment_method_options.card.installments.available_plans[].type`, `PaymentIntent.payment_method_options.card.installments.plan.type`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.type`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.type`, and `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.type` from `literal('fixed_count')` to `enum('bonus'|'fixed_count'|'revolving')`
+* Add support for `subscriptions` on `PaymentIntentConfirmParams.payment_method_options.klarna`, `PaymentIntentCreateParams.payment_method_options.klarna`, `PaymentIntentUpdateParams.payment_method_options.klarna`, and `checkout.SessionCreateParams.payment_method_options.klarna`
+* Add support for new value `crypto` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for `billingMode` on `InvoiceCreatePreviewParams.schedule_details`, `InvoiceCreatePreviewParams.subscription_details`, `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionScheduleCreateParams`, `SubscriptionSchedule`, `Subscription`, and `checkout.SessionCreateParams.subscription_data`
+* Add support for new value `buut` on enums `ConfirmationTokenCreateParams.payment_method_data.ideal.bank`, `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for new value `crypto` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `crypto` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Change type of `Dispute.enhancedEligibilityTypes` from `literal('visa_compelling_evidence_3')` to `enum('visa_compelling_evidence_3'|'visa_compliance')`
+* Add support for `relatedPerson` on `identity.VerificationSessionCreateParams` and `identity.VerificationSession`
+* Add support for `matching` on `identity.VerificationSession.options`
+* Add support for new value `crypto` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `klarna` on `Mandate.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for `onDemand` on `PaymentIntentConfirmParams.payment_method_options.klarna`, `PaymentIntentCreateParams.payment_method_options.klarna`, and `PaymentIntentUpdateParams.payment_method_options.klarna`
+* Change type of `PaymentIntent.payment_method_options.klarna.setupFutureUsage`, `PaymentIntentConfirmParams.payment_method_options.klarna.setupFutureUsage`, `PaymentIntentCreateParams.payment_method_options.klarna.setupFutureUsage`, and `PaymentIntentUpdateParams.payment_method_options.klarna.setupFutureUsage` from `literal('none')` to `enum('none'|'off_session'|'on_session')`
+* Add support for `ua` on `tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Change type of `terminal.LocationUpdateParams.displayName` from `string` to `emptyable(string)`
+* Add support for `collectPaymentMethod` and `confirmPaymentIntent` on `terminal.Reader.action`
+* Add support for `status` on `treasury.FinancialAccountListParams`
+* Add support for new value `terminal.reader.action_updated` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new value `2025-06-30.basil` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for snapshot event `terminal.reader.action_updated` with resource `terminal.Reader`
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 00000000000..c6c789265e7
--- /dev/null
+++ b/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,22 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-java/pull/2027
+is_stripe_api_change: true
+released_in_version: 29.4.0
+---
+
+* Add support for `instantPayoutsPromotion` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `adjustableQuantity` on `billingportal.Configuration.features.subscription_update.products[]`, `billingportal.ConfigurationCreateParams.features.subscription_update.products[]`, and `billingportal.ConfigurationUpdateParams.features.subscription_update.products[]`
+* Add support for `transactionId` on `Charge.payment_method_details.cashapp`
+* Add support for `originContext` on `checkout.SessionCreateParams` and `checkout.Session`
+* Add support for `template` on `PaymentLink.invoice_creation.invoice_data.rendering_options`, `PaymentLinkCreateParams.invoice_creation.invoice_data.rendering_options`, `PaymentLinkUpdateParams.invoice_creation.invoice_data.rendering_options`, `checkout.Session.invoice_creation.invoice_data.rendering_options`, and `checkout.SessionCreateParams.invoice_creation.invoice_data.rendering_options`
+* Add support for `setupFutureUsage` on `checkout.Session.payment_method_options.pix` and `checkout.SessionCreateParams.payment_method_options.pix`
+* Add support for new value `nz_bank_account` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for `duration` on `InvoiceCreatePreviewParams.schedule_details.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, and `SubscriptionScheduleUpdateParams.phases[]`
+* Add support for `priceData` on `PaymentLinkCreateParams.line_items[]`
+* Change `PaymentLinkCreateParams.line_items[].price` to be optional
+* Add support for new value `America/Coyhaique` on enum `reporting.ReportRunCreateParams.parameters.timezone`
+* Add support for `standard` on `tax.Registration.country_options.ae`, `tax.Registration.country_options.au`, `tax.Registration.country_options.ch`, `tax.Registration.country_options.gb`, `tax.Registration.country_options.jp`, `tax.Registration.country_options.no`, `tax.Registration.country_options.nz`, `tax.Registration.country_options.sg`, `tax.RegistrationCreateParams.country_options.ae`, `tax.RegistrationCreateParams.country_options.al`, `tax.RegistrationCreateParams.country_options.ao`, `tax.RegistrationCreateParams.country_options.au`, `tax.RegistrationCreateParams.country_options.aw`, `tax.RegistrationCreateParams.country_options.ba`, `tax.RegistrationCreateParams.country_options.bb`, `tax.RegistrationCreateParams.country_options.bd`, `tax.RegistrationCreateParams.country_options.bf`, `tax.RegistrationCreateParams.country_options.bh`, `tax.RegistrationCreateParams.country_options.bs`, `tax.RegistrationCreateParams.country_options.cd`, `tax.RegistrationCreateParams.country_options.ch`, `tax.RegistrationCreateParams.country_options.et`, `tax.RegistrationCreateParams.country_options.gb`, `tax.RegistrationCreateParams.country_options.gn`, `tax.RegistrationCreateParams.country_options.is`, `tax.RegistrationCreateParams.country_options.jp`, `tax.RegistrationCreateParams.country_options.me`, `tax.RegistrationCreateParams.country_options.mk`, `tax.RegistrationCreateParams.country_options.mr`, `tax.RegistrationCreateParams.country_options.no`, `tax.RegistrationCreateParams.country_options.nz`, `tax.RegistrationCreateParams.country_options.om`, `tax.RegistrationCreateParams.country_options.rs`, `tax.RegistrationCreateParams.country_options.sg`, `tax.RegistrationCreateParams.country_options.sr`, `tax.RegistrationCreateParams.country_options.uy`, `tax.RegistrationCreateParams.country_options.za`, and `tax.RegistrationCreateParams.country_options.zw`
+* Add support for new value `inbound_goods` on enums `tax.RegistrationCreateParams.country_options.at.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.be.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.bg.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.cy.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.cz.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.de.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.dk.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.ee.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.es.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.fi.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.fr.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.gr.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.hr.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.hu.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.ie.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.it.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.lt.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.lu.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.lv.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.mt.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.nl.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.pl.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.pt.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.ro.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.se.standard.placeOfSupplyScheme`, `tax.RegistrationCreateParams.country_options.si.standard.placeOfSupplyScheme`, and `tax.RegistrationCreateParams.country_options.sk.standard.placeOfSupplyScheme`
+* Add support for `aed`, `bgn`, `huf`, and `ron` on `terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for new value `2025-07-30.basil` on enum `WebhookEndpointCreateParams.apiVersion`
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 00000000000..df99864c764
--- /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-java/pull/2032
+released_in_version: 29.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
+StripeClient client = new 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-java/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 00000000000..d075e184438
--- /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-java/pull/2034
+released_in_version: 29.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 00000000000..2237a8f98ef
--- /dev/null
+++ b/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,23 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-java/pull/2030
+is_stripe_api_change: true
+released_in_version: 29.5.0
+---
+
+* Add support for `balanceReport`, `payoutDetails`, and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `name` on `billingportal.ConfigurationCreateParams`, `billingportal.ConfigurationUpdateParams`, and `billingportal.Configuration`
+* Add support for `installments` on `Charge.payment_method_details.alma`
+* Add support for `transactionId` on `Charge.payment_method_details.alma`, `Charge.payment_method_details.amazon_pay`, `Charge.payment_method_details.billie`, `Charge.payment_method_details.kakao_pay`, `Charge.payment_method_details.kr_card`, `Charge.payment_method_details.naver_pay`, `Charge.payment_method_details.payco`, `Charge.payment_method_details.revolut_pay`, `Charge.payment_method_details.samsung_pay`, and `Charge.payment_method_details.satispay`
+* Add support for `location` and `reader` on `Charge.payment_method_details.paynow`
+* Add support for `amountIncludesIof` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, `PaymentIntentUpdateParams.payment_method_options.pix`, `checkout.Session.payment_method_options.pix`, and `checkout.SessionCreateParams.payment_method_options.pix`
+* Add support for new value `terminal_android_apk` on enum `FileListParams.purpose`
+* Add support for new value `terminal_android_apk` on enum `FileCreateParams.purpose`
+* Add support for `metadata` and `period` on `InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[]`, `SubscriptionCreateParams.add_invoice_items[]`, `SubscriptionSchedule.phases[].add_invoice_items[]`, `SubscriptionScheduleCreateParams.phases[].add_invoice_items[]`, `SubscriptionScheduleUpdateParams.phases[].add_invoice_items[]`, and `SubscriptionUpdateParams.add_invoice_items[]`
+* Add support for `expMonth` and `expYear` on `issuing.CardCreateParams`
+* Add support for `excludedPaymentMethodTypes` on `PaymentIntentCreateParams` and `PaymentIntent`
+* Add support for `payoutMethod` on `PayoutCreateParams` and `Payout`
+* Add support for `mxn` on `terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for `card` on `terminal.ReaderPresentPaymentMethodParams`
+* Add support for new value `card` on enum `terminal.ReaderPresentPaymentMethodParams.type`
+* Add support for new value `2025-08-27.basil` on enum `WebhookEndpointCreateParams.apiVersion`
diff --git a/.hark/changes/2025-09-04_mbroshi_fix-type-bounds.change.md b/.hark/changes/2025-09-04_mbroshi_fix-type-bounds.change.md
new file mode 100644
index 00000000000..41f708c54f0
--- /dev/null
+++ b/.hark/changes/2025-09-04_mbroshi_fix-type-bounds.change.md
@@ -0,0 +1,8 @@
+---
+title: Fix type bounds on request
+pr_url: https://github.com/stripe/stripe-java/pull/2037
+semver_level: major
+released_in_version: 30.0.0
+---
+
+* ⚠️ Changes the signature of `LiveResponseGetter#request`, `ApiService#request`, and `StripeResponseGetter#request` to return `<T extends StripeObject>` instead of `<T extends StripeObjectInterface>`. This only affects advanced use cases where users are extending `StripeObjectInterface` with their own objects to deserialize Stripe responses. Those objects will now need to extend `StripeObject`.
diff --git a/.hark/changes/2025-09-08_xavdid_build-sdk-w.change.md b/.hark/changes/2025-09-08_xavdid_build-sdk-w.change.md
new file mode 100644
index 00000000000..1331223d82b
--- /dev/null
+++ b/.hark/changes/2025-09-08_xavdid_build-sdk-w.change.md
@@ -0,0 +1,10 @@
+---
+title: Build SDK w/ V2 OpenAPI spec
+pr_url: https://github.com/stripe/stripe-java/pull/2039
+semver_level: major
+released_in_version: 30.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.
+- ⚠️ Query params on v2 APIs (like `limit`) are now `Long` instead of `Integer` (to match v1 APIs)
+- ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Map<String, Object>`. Because there were no params, it's unlikely you were using these classes.
diff --git a/.hark/changes/2025-09-18_xavdid_throw-apikeymissin-instead.change.md b/.hark/changes/2025-09-18_xavdid_throw-apikeymissin-instead.change.md
new file mode 100644
index 00000000000..2c07b098308
--- /dev/null
+++ b/.hark/changes/2025-09-18_xavdid_throw-apikeymissin-instead.change.md
@@ -0,0 +1,8 @@
+---
+title: Throw `ApiKeyMissingException` instead of `IllegalArgumentException` for unset API keys
+pr_url: https://github.com/stripe/stripe-java/pull/2041
+semver_level: major
+released_in_version: 30.0.0
+---
+
+- ⚠️ throw `ApiKeyMissingException` instead of `IllegalArgumentException` when making a request before setting an API key initializing a client without an API key. Tweak the wording of that message to better indicate how to fix.
diff --git a/.hark/changes/2025-09-23_helenye_adds-v2-support.change.md b/.hark/changes/2025-09-23_helenye_adds-v2-support.change.md
new file mode 100644
index 00000000000..fb47757c078
--- /dev/null
+++ b/.hark/changes/2025-09-23_helenye_adds-v2-support.change.md
@@ -0,0 +1,8 @@
+---
+title: Adds v2 support to RateLimitException
+pr_url: https://github.com/stripe/stripe-java/pull/2046
+semver_level: major
+released_in_version: 30.0.0
+---
+
+* ⚠️ The base class of `RateLimitException` has been changed from `InvalidRequestException` to `ApiException`.  There is no change to the public interface for the `RateLimitException` class.
diff --git a/.hark/changes/2025-09-23_ramya_2058-2059-2073.change.md b/.hark/changes/2025-09-23_ramya_2058-2059-2073.change.md
new file mode 100644
index 00000000000..19887cfdbd8
--- /dev/null
+++ b/.hark/changes/2025-09-23_ramya_2058-2059-2073.change.md
@@ -0,0 +1,43 @@
+---
+title: ", [#2058](https://github.com/stripe/stripe-java/pull/2058), [#2059](https://github.com/stripe/stripe-java/pull/2059), [#2073](https://github.com/stripe/stripe-java/pull/2073) Update generated code based on incoming API changes in the `2025-09-30.clover` API version."
+pr_url: https://github.com/stripe/stripe-java/pull/2040
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 30.0.0
+---
+
+* ⚠️ Remove support for `balanceReport` and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* ⚠️ Change type of `InvoiceCreatePreviewParams.subscription_details.cancelAt`, `SubscriptionCreateParams.cancelAt` and `SubscriptionUpdateParams.cancelAt` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+* ⚠️ Remove support for values `saturday` and `sunday` from enums `AccountCreateParams.settings.payouts.schedule.weeklyPayoutDays` and `AccountUpdateParams.settings.payouts.schedule.weeklyPayoutDays`
+* ⚠️ Remove support for `iterations` on `InvoiceCreatePreviewParams.schedule_details.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, and `SubscriptionScheduleUpdateParams.phases[]`
+* ⚠️ Remove support for `link` and `payByBank` on `PaymentMethodUpdateParams`
+* ⚠️ Remove support for `coupon` on `Discount`, `PromotionCodeCreateParams`, and `PromotionCode`. Use `Discount.source.coupon`, `PromotionCodeCreateParams.promotion.coupon`, and `PromotionCode.promotion.coupon` instead
+* Add support for new resource `BalanceSettings`
+* Add support for `retrieve` and `update` methods on resource `BalanceSettings`
+* Add support for `source` on `Discount`
+* Add support for `mbWayPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `trialUpdateBehavior` on `billingportal.Configuration.features.subscription_update`, `billingportal.ConfigurationCreateParams.features.subscription_update`, and `billingportal.ConfigurationUpdateParams.features.subscription_update`
+* Add support for `mbWay` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `brandingSettings` and `nameCollection` on `checkout.SessionCreateParams` and `checkout.Session`
+* Add support for `excludedPaymentMethodTypes` on `PaymentIntentConfirmParams`, `PaymentIntentUpdateParams`, `checkout.SessionCreateParams`, and `checkout.Session`
+* Add support for `unitLabel` on `InvoiceAddLinesParams.lines[].price_data.product_data`, `InvoiceLineItemUpdateParams.price_data.product_data`, `InvoiceUpdateLinesParams.lines[].price_data.product_data`, `PaymentLinkCreateParams.line_items[].price_data.product_data`, and `checkout.SessionCreateParams.line_items[].price_data.product_data`
+* Add support for `alma`, `billie`, and `satispay` on `checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `demoPay` on `checkout.SessionCreateParams.payment_method_options`
+* Add support for `captureMethod` on `checkout.Session.payment_method_options.affirm`, `checkout.Session.payment_method_options.afterpay_clearpay`, `checkout.Session.payment_method_options.amazon_pay`, `checkout.Session.payment_method_options.card`, `checkout.Session.payment_method_options.cashapp`, `checkout.Session.payment_method_options.klarna`, `checkout.Session.payment_method_options.link`, `checkout.Session.payment_method_options.mobilepay`, `checkout.Session.payment_method_options.revolut_pay`, `checkout.SessionCreateParams.payment_method_options.affirm`, `checkout.SessionCreateParams.payment_method_options.afterpay_clearpay`, `checkout.SessionCreateParams.payment_method_options.amazon_pay`, `checkout.SessionCreateParams.payment_method_options.card`, `checkout.SessionCreateParams.payment_method_options.cashapp`, `checkout.SessionCreateParams.payment_method_options.klarna`, `checkout.SessionCreateParams.payment_method_options.link`, `checkout.SessionCreateParams.payment_method_options.mobilepay`, and `checkout.SessionCreateParams.payment_method_options.revolut_pay`
+* Add support for `flexible` on `InvoiceCreatePreviewParams.schedule_details.billing_mode`, `InvoiceCreatePreviewParams.subscription_details.billing_mode`, `Quote.subscription_data.billing_mode`, `QuoteCreateParams.subscription_data.billing_mode`, `Subscription.billing_mode`, `SubscriptionCreateParams.billing_mode`, `SubscriptionMigrateParams.billing_mode`, `SubscriptionSchedule.billing_mode`, `SubscriptionScheduleCreateParams.billing_mode`, and `checkout.SessionCreateParams.subscription_data.billing_mode`
+* Add support for `businessName` and `individualName` on `CustomerCreateParams`, `CustomerUpdateParams`, `Customer`, `checkout.Session.collected_information`, and `checkout.Session.customer_details`
+* Add support for new values `mb_way`on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new values `mb_way`on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `chargebackLossReasonCode` on `Dispute.payment_method_details.klarna`
+* Add support for `netAmount` and `prorationDetails` on `InvoiceItem`
+* Add support for `fraudDisputabilityLikelihood` and `riskAssessment` on `issuing.AuthorizationCreateParams`
+* Add support for `secondLine` on `issuing.Card`
+* Add support for new values `mb_way`on enum `PaymentIntentCreateParams.excludedPaymentMethodTypes`
+* Add support for `frMealVoucherConecs` on `PaymentMethodConfigurationCreateParams` and `PaymentMethodConfigurationUpdateParams`
+* Add support for `promotion` on `PromotionCodeCreateParams` and `PromotionCode`
+* Add support for `provider` on `tax.Settings.defaults`
+* Add support for `bbposWisepad3` on `terminal.ConfigurationCreateParams`, `terminal.ConfigurationUpdateParams`, and `terminal.Configuration`
+* Add support for `addressKana`, `addressKanji`, `displayNameKana`, `displayNameKanji`, and `phone` on `terminal.LocationCreateParams`, `terminal.LocationUpdateParams`, and `terminal.Location`
+* Change `terminal.LocationCreateParams.address` to be optional
+* Change `terminal.LocationCreateParams.displayName` to be optional
+* Add support for new value `2025-09-30.clover` on enum `WebhookEndpointCreateParams.apiVersion`
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 00000000000..2291915d24e
--- /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-java/pull/2036
+semver_level: major
+released_in_version: 30.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 `fetchEvent()` method to retrieve its corresponding event. For events with related objects, there's a `fetchRelatedObject()` method that performs the API call and casts the response to the correct type.
+- ⚠️ Rename function `StripeClient.parseThinEvent` to `StripeClient.parseEventNotification` 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 `relatedObject` property and a `fetchRelatedObject()` function. They also have a `fetchEvent()` method to retrieve their corresponding `Stripe.Event.*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-26_xavdid_add-stripecontex-object.change.md b/.hark/changes/2025-09-26_xavdid_add-stripecontex-object.change.md
new file mode 100644
index 00000000000..edc83a6fdf7
--- /dev/null
+++ b/.hark/changes/2025-09-26_xavdid_add-stripecontex-object.change.md
@@ -0,0 +1,9 @@
+---
+title: Add `StripeContext` object
+pr_url: https://github.com/stripe/stripe-java/pull/2057
+semver_level: major
+released_in_version: 30.0.0
+---
+
+- Add the `StripeContext` class. Previously, you could set the stripe context only as a string via `StripeClientBuilder .setStripeContext()`. The same method can now take an instance of the `StripeContext` class as well
+- ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
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 00000000000..ec56a85f181
--- /dev/null
+++ b/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md
@@ -0,0 +1,10 @@
+---
+title: Move `V2.Event` API resources to `V2.Core.Events`
+pr_url: https://github.com/stripe/stripe-java/pull/2069
+semver_level: major
+released_in_version: 30.0.0
+---
+
+- ⚠️ Move the below event related classes from `com.stripe.model.v2` to `com.stripe.model.v2.core`. This enables us to correctly match the API path to the namespace
+     - `com.stripe.model.v2.Event` -> `com.stripe.model.v2.core.Event`
+     - `com.stripe.model.v2.EventDestination` -> `com.stripe.model.v2.core.EventDestination`
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 00000000000..5a548aa37fa
--- /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-java/releases/tag/v29.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: 30.0.0
+---
+
+```diff
+StripeClient client = new 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-java/wiki/v1-namespace-in-StripeClient) for help upgrading.
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 00000000000..5f957ef419c
--- /dev/null
+++ b/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,44 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2086
+is_stripe_api_change: true
+released_in_version: 30.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 `representativeDeclaration` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+* Change `billing.CreditGrantCreateParams.category` to be optional
+* Add support for `paymentMethodConfiguration` on `billingportal.ConfigurationCreateParams.features.payment_method_update` and `billingportal.ConfigurationUpdateParams.features.payment_method_update`
+* Add support for new value `mb_way` on enum `checkout.SessionCreateParams.excludedPaymentMethodTypes`
+* Add support for `twint` on `checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `mb_way` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for `paymentRecordRefund` and `type` on `CreditNote.refunds[]`, `CreditNoteCreateParams.refunds[]`, `CreditNotePreviewLinesParams.refunds[]`, and `CreditNotePreviewParams.refunds[]`
+* Add support for `customerSheet` and `mobilePaymentElement` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
+* 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 value `platform_terms_of_service` on enum `FileListParams.purpose`
+* Add support for new value `platform_terms_of_service` on enum `FileCreateParams.purpose`
+* Add support for `paymentRecord` on `InvoiceAttachPaymentParams`, `InvoicePayment.payment`, and `InvoicePaymentListParams.payment`
+* Change type of `InvoicePaymentListParams.payment.type` from `literal('payment_intent')` to `enum('payment_intent'|'payment_record')`
+* Add support for new value `custom` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `amountDetails` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, and `PaymentIntentUpdateParams`
+* Add support for `paymentDetails` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
+* Add support for `discountAmount`, `lineItems`, `shipping`, and `tax` on `PaymentIntent.amount_details`
+* Add support for `nameCollection` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for new value `mb_way` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for `crypto` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, and `Refund.destination_details`
+* Add support for `mbWay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `custom` on `PaymentMethodCreateParams` and `PaymentMethod`
+* Add support for `excludedPaymentMethodTypes` on `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntent`
+* Add support for `tw` on `tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Add support for `gip` on `terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for `lastSeenAt` on `terminal.Reader`
+* Add support for new values `balance_settings.updated` and `invoice.payment_attempt_required` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new value `2025-10-29.clover` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for `gt`, `gte`, `lt`, `lte`, and `types` on `v2.core.EventListParams`
+* Change `v2.core.EventListParams.objectId` 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`
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 00000000000..0f14b94305c
--- /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-java/pull/2093
+is_stripe_api_change: true
+released_in_version: 30.1.0
+---
+
+* Improve docs for PaymentIntent related endpoints
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 00000000000..6dbc5e39c00
--- /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-java/pull/2102
+is_stripe_api_change: true
+released_in_version: 30.2.0
+---
+
+* Add support for `captureMethod` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
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 00000000000..2cadc4508e6
--- /dev/null
+++ b/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,21 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2108
+is_stripe_api_change: true
+released_in_version: 31.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 `paymentMethodConfiguration` on `billingportal.Configuration.features.payment_method_update`
+* Add support for `transactionId` on `Charge.payment_method_details.ideal`, `PaymentAttemptRecord.payment_method_details.ideal`, and `PaymentRecord.payment_method_details.ideal`
+* Add support for new value `finom` on enums `ConfirmationTokenCreateParams.payment_method_data.ideal.bank`, `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for `created` on `CustomerBalanceTransactionListParams` and `InvoicePaymentListParams`
+* Add support for `accountNumbers` on `financialconnections.Account`
+* Add support for `fraudRisk` on `issuing.AuthorizationCreateParams.risk_assessment`
+* Add support for `latestFraudWarning` on `issuing.Card`
+* Add support for `hooks` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
+* Add support for `mbWay` and `twint` on `Refund.destination_details`
+* Add support for new values `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for snapshot events `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` with resource `financialconnections.Account`
diff --git a/.hark/changes/2025-11-17_ramya_update-generated-code.change.md b/.hark/changes/2025-11-17_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..79b157375b2
--- /dev/null
+++ b/.hark/changes/2025-11-17_ramya_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2113
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 31.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-17_ramya_update-v2-array.change.md b/.hark/changes/2025-11-17_ramya_update-v2-array.change.md
new file mode 100644
index 00000000000..2fb90ef9869
--- /dev/null
+++ b/.hark/changes/2025-11-17_ramya_update-v2-array.change.md
@@ -0,0 +1,8 @@
+---
+title: Update v2 array parameter serialization to use indexed format
+pr_url: https://github.com/stripe/stripe-java/pull/2110
+released_in_version: 31.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.
+- The `arraysAsRepeated` parameter was removed from the internal-use-only method `FormEncoder#createQueryString`
diff --git a/.hark/changes/2025-12-02_mbroshi_adds-automatic-module.change.md b/.hark/changes/2025-12-02_mbroshi_adds-automatic-module.change.md
new file mode 100644
index 00000000000..c558cdcaabb
--- /dev/null
+++ b/.hark/changes/2025-12-02_mbroshi_adds-automatic-module.change.md
@@ -0,0 +1,5 @@
+---
+title: "Adds `Automatic-Module-Name: stripe.java` to the jar's manifest entry"
+pr_url: https://github.com/stripe/stripe-java/pull/2121
+released_in_version: 31.1.0
+---
diff --git a/.hark/changes/2025-12-06_mbroshi_adds-gson-version.change.md b/.hark/changes/2025-12-06_mbroshi_adds-gson-version.change.md
new file mode 100644
index 00000000000..5847c5e4511
--- /dev/null
+++ b/.hark/changes/2025-12-06_mbroshi_adds-gson-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Adds the Gson version included at runtime to the X-STRIPE-CLIENT-USER-AGENT header hash
+pr_url: https://github.com/stripe/stripe-java/pull/2124
+released_in_version: 31.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 00000000000..6513e200044
--- /dev/null
+++ b/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,37 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2126
+is_stripe_api_change: true
+released_in_version: 31.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`, `retrieve`, and `update` methods on resource `v2.core.Account`
+* Add support for `create`, `delete`, `list`, `retrieve`, and `update` methods on resource `v2.core.AccountPerson`
+* Add support for `customerAccount` on `CashBalance`, `ConfirmationToken.payment_method_preview`, `CreditNoteListParams`, `CreditNote`, `CustomerBalanceTransaction`, `CustomerCashBalanceTransaction`, `CustomerSessionCreateParams`, `CustomerSession`, `Customer`, `Discount`, `InvoiceCreateParams`, `InvoiceCreatePreviewParams`, `InvoiceItemCreateParams`, `InvoiceItemListParams`, `InvoiceItem`, `InvoiceListParams`, `Invoice`, `PaymentIntentCreateParams`, `PaymentIntentListParams`, `PaymentIntentUpdateParams`, `PaymentIntent`, `PaymentMethodAttachParams`, `PaymentMethodListParams`, `PaymentMethod`, `PromotionCodeCreateParams`, `PromotionCodeListParams`, `PromotionCode`, `QuoteCreateParams`, `QuoteListParams`, `QuoteUpdateParams`, `Quote`, `SetupAttempt`, `SetupIntentCreateParams`, `SetupIntentListParams`, `SetupIntentUpdateParams`, `SetupIntent`, `SubscriptionCreateParams`, `SubscriptionListParams`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleListParams`, `SubscriptionSchedule`, `Subscription`, `TaxId.owner`, `TaxIdCreateParams.owner`, `TaxIdListParams.owner`, `TaxId`, `billing.CreditBalanceSummaryRetrieveParams`, `billing.CreditBalanceSummary`, `billing.CreditBalanceTransactionListParams`, `billing.CreditGrantCreateParams`, `billing.CreditGrantListParams`, `billing.CreditGrant`, `billingportal.SessionCreateParams`, `billingportal.Session`, `checkout.SessionCreateParams`, `checkout.SessionListParams`, `checkout.Session`, `financialconnections.Account.account_holder`, `financialconnections.AccountListParams.account_holder`, `financialconnections.Session.account_holder`, and `financialconnections.SessionCreateParams.account_holder`
+* Add support for `metadata` on `LineItem` and `checkout.SessionCreateParams.line_items[]`
+* Add support for `paytoPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `signer` on `AccountCreateParams.documents.proof_of_registration`, `AccountCreateParams.documents.proof_of_ultimate_beneficial_ownership`, `AccountUpdateParams.documents.proof_of_registration`, and `AccountUpdateParams.documents.proof_of_ultimate_beneficial_ownership`
+* Change `CustomerSessionCreateParams.customer`, `InvoiceItemCreateParams.customer`, `PaymentMethodAttachParams.customer`, `SubscriptionCreateParams.customer`, `billing.CreditBalanceSummaryRetrieveParams.customer`, `billing.CreditBalanceTransactionListParams.customer`, `billing.CreditGrantCreateParams.customer`, and `billingportal.SessionCreateParams.customer` to be optional
+* Add support for `billingCycleAnchor` on `billingportal.Configuration.features.subscription_update`, `billingportal.ConfigurationCreateParams.features.subscription_update`, and `billingportal.ConfigurationUpdateParams.features.subscription_update`
+* Add support for `payto` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Mandate.payment_method_details`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_options`, `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, `SubscriptionUpdateParams.payment_settings.payment_method_options`, `checkout.Session.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `expectedDebitDate` on `Charge.payment_method_details.acss_debit`, `Charge.payment_method_details.au_becs_debit`, `Charge.payment_method_details.bacs_debit`, `Charge.payment_method_details.nz_bank_account`, `Charge.payment_method_details.sepa_debit`, `Charge.payment_method_details.us_bank_account`, `PaymentAttemptRecord.payment_method_details.acss_debit`, `PaymentAttemptRecord.payment_method_details.au_becs_debit`, `PaymentAttemptRecord.payment_method_details.bacs_debit`, `PaymentAttemptRecord.payment_method_details.nz_bank_account`, `PaymentAttemptRecord.payment_method_details.sepa_debit`, `PaymentAttemptRecord.payment_method_details.us_bank_account`, `PaymentRecord.payment_method_details.acss_debit`, `PaymentRecord.payment_method_details.au_becs_debit`, `PaymentRecord.payment_method_details.bacs_debit`, `PaymentRecord.payment_method_details.nz_bank_account`, `PaymentRecord.payment_method_details.sepa_debit`, and `PaymentRecord.payment_method_details.us_bank_account`
+* Add support for new value `payto` on enums `PaymentIntentConfirmParams.excludedPaymentMethodTypes`, `PaymentIntentCreateParams.excludedPaymentMethodTypes`, `PaymentIntentUpdateParams.excludedPaymentMethodTypes`, `SetupIntentCreateParams.excludedPaymentMethodTypes`, `SetupIntentUpdateParams.excludedPaymentMethodTypes`, and `checkout.SessionCreateParams.excludedPaymentMethodTypes`
+* Add support for new value `payto` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for `lineItems` on `checkout.SessionUpdateParams`
+* Add support for new value `mollie` on enums `ConfirmationTokenCreateParams.payment_method_data.ideal.bank`, `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for new value `payto` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new value `payto` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `invoice` on `CustomerBalanceTransactionListParams`
+* Add support for `relatedCustomerAccount` on `identity.VerificationSessionCreateParams`, `identity.VerificationSessionListParams`, and `identity.VerificationSession`
+* Change type of `InvoiceItem.pricing.price_details.price` and `InvoiceLineItem.pricing.price_details.price` from `string` to `expandable($Price)`
+* Add support for new value `payto` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `subtotal` on `InvoiceLineItem`
+* Add support for `authorizationCode`, `description`, `iin`, `installments`, `issuer`, `networkAdviceCode`, `networkDeclineCode`, and `storedCredentialUsage` on `PaymentAttemptRecord.payment_method_details.card` and `PaymentRecord.payment_method_details.card`
+* Add support for new value `payto` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for `allowRedisplay` on `PaymentMethodListParams`
+* Add support for `reportedBy` on `PaymentRecord`
+* Add support for new values `2025-12-15.clover` and `2026-01-28.clover` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for `changes` on `v2.core.Event`
diff --git a/.hark/changes/2026-01-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-01-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 00000000000..da0af06fe6d
--- /dev/null
+++ b/.hark/changes/2026-01-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2144
+is_stripe_api_change: true
+released_in_version: 31.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-28_ramya_update-generated-code.change.md b/.hark/changes/2026-01-28_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..78814f8442a
--- /dev/null
+++ b/.hark/changes/2026-01-28_ramya_update-generated-code.change.md
@@ -0,0 +1,20 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2147
+is_stripe_api_change: true
+released_in_version: 31.3.0
+---
+
+* Add support for new resource `radar.PaymentEvaluation`
+* Add support for `create` method on resource `radar.PaymentEvaluation`
+* Add support for `adjustableQuantity` on `LineItem`
+* Add support for new value `adyen` on enums `ConfirmationTokenCreateParams.payment_method_data.ideal.bank`, `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
+* Add support for new value `pl_nip` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `enforceArithmeticValidation` on `PaymentIntentCaptureParams.amount_details`, `PaymentIntentConfirmParams.amount_details`, `PaymentIntentCreateParams.amount_details`, `PaymentIntentIncrementAuthorizationParams.amount_details`, and `PaymentIntentUpdateParams.amount_details`
+* Add support for new values `2.3.0` and `2.3.1` on enums `PaymentIntentConfirmParams.payment_method_options.card.three_d_secure.version`, `PaymentIntentCreateParams.payment_method_options.card.three_d_secure.version`, `PaymentIntentUpdateParams.payment_method_options.card.three_d_secure.version`, `SetupIntentConfirmParams.payment_method_options.card.three_d_secure.version`, `SetupIntentCreateParams.payment_method_options.card.three_d_secure.version`, and `SetupIntentUpdateParams.payment_method_options.card.three_d_secure.version`
+* Add support for `error` on `PaymentIntent.amount_details`
+* Remove support for `bgn` on `terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
+* Add support for `topup` on `treasury.ReceivedDebit.linked_flows`
+* Add support for `contactPhone` on `v2.core.AccountCreateParams`, `v2.core.AccountTokenCreateParams`, `v2.core.AccountUpdateParams`, and `v2.core.Account`
+* Add support for `registrationDate` on `v2.core.Account.identity.business_details`, `v2.core.AccountCreateParams.identity.business_details`, `v2.core.AccountTokenCreateParams.identity.business_details`, and `v2.core.AccountUpdateParams.identity.business_details`
+* Add support for new value `gb_vat` on enums `v2.core.AccountCreateParams.identity.business_details.id_numbers[].type`, `v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type`, and `v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type`
diff --git a/.hark/changes/2026-02-23_ramya_update-generated-code.change.md b/.hark/changes/2026-02-23_ramya_update-generated-code.change.md
new file mode 100644
index 00000000000..38e3b5c128c
--- /dev/null
+++ b/.hark/changes/2026-02-23_ramya_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2158
+is_stripe_api_change: true
+released_in_version: 31.4.0
+---
+
+* Add support for new resources `reserve.Hold`, `reserve.Plan`, and `reserve.Release`
+* Add support for `location` and `reader` on `Charge.payment_method_details.card_present`, `Charge.payment_method_details.interac_present`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present`, `PaymentAttemptRecord.payment_method_details.card_present`, `PaymentAttemptRecord.payment_method_details.interac_present`, `PaymentMethod.card.generated_from.payment_method_details.card_present`, `PaymentRecord.payment_method_details.card_present`, and `PaymentRecord.payment_method_details.interac_present`
+* Add support for new value `lk_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for new values `terminal_wifi_certificate` and `terminal_wifi_private_key` on enum `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 `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `displayName` and `serviceUserNumber` on `Mandate.payment_method_details.bacs_debit`
+* Add support for `transactionPurpose` on `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, and `PaymentIntentUpdateParams.payment_method_options.us_bank_account`
+* Add support for `optionalItems` on `PaymentLinkUpdateParams`
+* Remove support for unused `cardIssuerDecline` on `radar.PaymentEvaluation.insights`
+* Add support for `paymentBehavior` on `SubscriptionItemDeleteParams`
+* Add support for `lk` on `tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
+* Add support for `cellular` and `stripeS710` on `terminal.ConfigurationCreateParams`, `terminal.ConfigurationUpdateParams`, and `terminal.Configuration`
+* Add support for new values `simulated_stripe_s710` and `stripe_s710` on enum `terminal.ReaderListParams.deviceType`
+* 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.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new value `2026-02-25.clover` on enum `WebhookEndpointCreateParams.apiVersion`
+* 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`
diff --git a/.hark/changes/2026-03-03_xavdid_add-ai-agent.change.md b/.hark/changes/2026-03-03_xavdid_add-ai-agent.change.md
new file mode 100644
index 00000000000..44ac8bd9739
--- /dev/null
+++ b/.hark/changes/2026-03-03_xavdid_add-ai-agent.change.md
@@ -0,0 +1,5 @@
+---
+title: Add AI Agent information to UserAgent
+pr_url: https://github.com/stripe/stripe-java/pull/2165
+released_in_version: 31.4.1
+---
diff --git a/.hark/changes/2026-03-04_jar_support-serializing-stripe.change.md b/.hark/changes/2026-03-04_jar_support-serializing-stripe.change.md
new file mode 100644
index 00000000000..69505135dda
--- /dev/null
+++ b/.hark/changes/2026-03-04_jar_support-serializing-stripe.change.md
@@ -0,0 +1,7 @@
+---
+title: Support serializing Stripe objects with ApiResource.GSON
+pr_url: https://github.com/stripe/stripe-java/pull/2168
+released_in_version: 31.4.1
+---
+
+* `ApiResource.GSON` now supports serializing Stripe objects back into compatible JSON
diff --git a/.hark/changes/2026-03-17_mbroshi_add-runtime-support.change.md b/.hark/changes/2026-03-17_mbroshi_add-runtime-support.change.md
new file mode 100644
index 00000000000..727a78ae6f5
--- /dev/null
+++ b/.hark/changes/2026-03-17_mbroshi_add-runtime-support.change.md
@@ -0,0 +1,5 @@
+---
+title: Add runtime support for V2 int64 string-encoded fields
+pr_url: https://github.com/stripe/stripe-java/pull/2179
+released_in_version: 32.0.0
+---
diff --git a/.hark/changes/2026-03-17_mbroshi_change-automatic-module.change.md b/.hark/changes/2026-03-17_mbroshi_change-automatic-module.change.md
new file mode 100644
index 00000000000..c2cf08d7b4c
--- /dev/null
+++ b/.hark/changes/2026-03-17_mbroshi_change-automatic-module.change.md
@@ -0,0 +1,8 @@
+---
+title: Change Automatic-Module-Name to com.stripe
+pr_url: https://github.com/stripe/stripe-java/pull/2181
+semver_level: major
+released_in_version: 32.0.0
+---
+
+- Changes `Automatic-Module-Name` from `stripe.java` to `com.stripe`. Users with `requires stripe.java;` in their `module-info.java` will need to update to `requires com.stripe;`.
diff --git a/.hark/changes/2026-03-18_mbroshi_add-sethttpclien-stripeclient.change.md b/.hark/changes/2026-03-18_mbroshi_add-sethttpclien-stripeclient.change.md
new file mode 100644
index 00000000000..3a6d77dc29d
--- /dev/null
+++ b/.hark/changes/2026-03-18_mbroshi_add-sethttpclien-stripeclient.change.md
@@ -0,0 +1,9 @@
+---
+title: Add setHttpClient to StripeClientBuilder; clean up apiKey/authenticator coupling
+pr_url: https://github.com/stripe/stripe-java/pull/2182
+semver_level: major
+released_in_version: 32.0.0
+---
+
+- ⚠️ Removed `RequestOptions.getApiKey()`, `RequestOptions.RequestOptionsBuilder.getApiKey()`, and `StripeClient.StripeClientBuilder.getApiKey()`. Use `getAuthenticator()` instead.
+- Added `StripeClient.StripeClientBuilder.setHttpClient(HttpClient)` to allow injecting a custom HTTP client.
diff --git a/.hark/changes/2026-03-18_mbroshi_make-requestoptio-rawrequestop.change.md b/.hark/changes/2026-03-18_mbroshi_make-requestoptio-rawrequestop.change.md
new file mode 100644
index 00000000000..2b309f1bd8f
--- /dev/null
+++ b/.hark/changes/2026-03-18_mbroshi_make-requestoptio-rawrequestop.change.md
@@ -0,0 +1,6 @@
+---
+title: Make `RequestOptions` & `RawRequestOptions` constructors private and add Stripe-Request-Trigger header
+pr_url: https://github.com/stripe/stripe-java/pull/2172
+semver_level: major
+released_in_version: 32.0.0
+---
diff --git a/.hark/changes/2026-03-20_jar_regenerate-decimalstrin-enabled.change.md b/.hark/changes/2026-03-20_jar_regenerate-decimalstrin-enabled.change.md
new file mode 100644
index 00000000000..fd291c03b77
--- /dev/null
+++ b/.hark/changes/2026-03-20_jar_regenerate-decimalstrin-enabled.change.md
@@ -0,0 +1,12 @@
+---
+title: Regenerate with decimal_string enabled for v2 APIs
+pr_url: https://github.com/stripe/stripe-java/pull/2187
+semver_level: major
+released_in_version: 32.0.0
+---
+
+- V2 API decimal fields changed type from `String` to `BigDecimal`. Code that reads or writes these fields as `String` will need to use `BigDecimal` instead. Affected fields:
+  - **V2.Core.Account** / **V2.Core.AccountPerson**: `percentOwnership`
+  - **PaymentEvaluation.Signals.FraudulentPayment**: `score`
+  - Params: `AccountCreateParams`, `PersonCreateParams`, `AccountTokenCreateParams`, `PersonTokenCreateParams` (all: `percentOwnership`)
+  - Params: `InvoiceItemCreateParams`, `InvoiceAddLinesParams`, `InvoiceUpdateLinesParams`, `InvoiceCreatePreviewParams` (all: `quantityDecimal`)
diff --git a/.hark/changes/2026-03-20_xavdid_throw-error-using.change.md b/.hark/changes/2026-03-20_xavdid_throw-error-using.change.md
new file mode 100644
index 00000000000..9fb0fa4fa1c
--- /dev/null
+++ b/.hark/changes/2026-03-20_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-java/pull/2190
+semver_level: major
+released_in_version: 32.0.0
+---
diff --git a/.hark/changes/2026-03-24_mbroshi_use-http-status.change.md b/.hark/changes/2026-03-24_mbroshi_use-http-status.change.md
new file mode 100644
index 00000000000..15cbea93aa7
--- /dev/null
+++ b/.hark/changes/2026-03-24_mbroshi_use-http-status.change.md
@@ -0,0 +1,9 @@
+---
+title: Use HTTP status code in V2 errors
+pr_url: https://github.com/stripe/stripe-java/pull/2131
+semver_level: major
+released_in_version: 32.0.0
+---
+
+- `RateLimitException` now extends `StripeException` rather than `ApiException`
+- Non-200 status codes from V2 endpoints will throw a `StripeException` (e.g. `RateLimitException`, `InvalidRequestException`, etc.) like in V1 instead of a generic `ApiException`
diff --git a/.hark/changes/2026-03-25_unknown_generated-changes-2170.change.md b/.hark/changes/2026-03-25_unknown_generated-changes-2170.change.md
new file mode 100644
index 00000000000..79f89027a7a
--- /dev/null
+++ b/.hark/changes/2026-03-25_unknown_generated-changes-2170.change.md
@@ -0,0 +1,31 @@
+---
+title: "Generated changes from [#2170](https://github.com/stripe/stripe-java/pull/2170), [#2193](https://github.com/stripe/stripe-java/pull/2193), [#2191](https://github.com/stripe/stripe-java/pull/2191)"
+semver_level: major
+is_stripe_api_change: true
+section: ⚠️ Breaking changes due to changes in the Stripe API
+released_in_version: 32.0.0
+---
+
+* Add support for `upiPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `upi` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `Mandate.payment_method_details`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_options`, `checkout.Session.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `integrationIdentifier` on `checkout.SessionCreateParams` and `checkout.Session`
+* Add support for new value `upi` on enums `PaymentIntentConfirmParams.excludedPaymentMethodTypes`, `PaymentIntentCreateParams.excludedPaymentMethodTypes`, `PaymentIntentUpdateParams.excludedPaymentMethodTypes`, `SetupIntentCreateParams.excludedPaymentMethodTypes`, `SetupIntentUpdateParams.excludedPaymentMethodTypes`, and `checkout.SessionCreateParams.excludedPaymentMethodTypes`
+* Add support for `crypto` on `checkout.SessionCreateParams.payment_method_options`
+* Add support for new value `upi` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* Add support for `pendingInvoiceItemInterval` on `checkout.SessionCreateParams.subscription_data`
+* Add support for new values `elements`, `embedded_page`, `form`, and `hosted_page` on enum `checkout.SessionCreateParams.uiMode`
+* Add support for new value `upi` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for `metadata` on `CreditNoteCreateParams.lines[]`, `CreditNoteLineItem`, `CreditNotePreviewLinesParams.lines[]`, and `CreditNotePreviewParams.lines[]`
+* Add support for new value `upi` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `quantityDecimal` on `InvoiceAddLinesParams.lines[]`, `InvoiceCreatePreviewParams.invoice_items[]`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams.lines[]`
+* ⚠️ Add support for `level` on `issuing.AuthorizationCreateParams.risk_assessment.card_testing_risk` and `issuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk`
+* ⚠️ Remove support for `riskLevel` on `issuing.AuthorizationCreateParams.risk_assessment.card_testing_risk` and `issuing.AuthorizationCreateParams.risk_assessment.merchant_dispute_risk`
+* Add support for `lifecycleControls` on `issuing.CardCreateParams` and `issuing.Card`
+* Add support for `cryptogram`, `electronicCommerceIndicator`, `exemptionIndicatorApplied`, and `exemptionIndicator` on `PaymentAttemptRecord.payment_method_details.card.three_d_secure` and `PaymentRecord.payment_method_details.card.three_d_secure`
+* Add support for `upiHandleRedirectOrDisplayQrCode` on `PaymentIntent.next_action` and `SetupIntent.next_action`
+* Add support for new value `upi` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for `recommendedAction` and `signals` on `radar.PaymentEvaluation`
+* ⚠️ Remove support for `insights` on `radar.PaymentEvaluation`
+* Add support for new value `crypto_fingerprint` on enum `radar.ValueListCreateParams.itemType`
+* Add support for new value `2026-03-25.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
+* ⚠️ Change type of `v2.core.EventDestinationCreateParams.eventsFrom` from `enum('other_accounts'|'self')` to `string`
diff --git a/.hark/changes/2026-04-20_mbroshi_fix-missing-stripecontex.change.md b/.hark/changes/2026-04-20_mbroshi_fix-missing-stripecontex.change.md
new file mode 100644
index 00000000000..1dc583b93e0
--- /dev/null
+++ b/.hark/changes/2026-04-20_mbroshi_fix-missing-stripecontex.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix missing stripeContext in RequestOptions.toBuilderFullCopy()
+pr_url: https://github.com/stripe/stripe-java/pull/2208
+released_in_version: 32.1.0
+---
+
+- Fixes a bug where an existing `stripeContext` was being reset to `null` when calling `RequestOptions#toBuilderFullCopy()`
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 00000000000..48520a4b88a
--- /dev/null
+++ b/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,35 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2203
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 32.1.0
+---
+
+* Add support for `balanceReport` and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `appDistribution` and `sunbitPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `sunbit` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
+* Add support for `location` and `reader` on `Charge.payment_method_details.klarna`, `PaymentAttemptRecord.payment_method_details.klarna`, and `PaymentRecord.payment_method_details.klarna`
+* Add support for `mandate` on `Charge.payment_method_details.pix`, `PaymentAttemptRecord.payment_method_details.pix`, and `PaymentRecord.payment_method_details.pix`
+* Add support for `managedPayments` on `PaymentIntent`, `PaymentLinkCreateParams`, `PaymentLink`, `SetupIntent`, `Subscription`, `checkout.SessionCreateParams`, and `checkout.Session`
+* Add support for new value `sunbit` on enums `PaymentIntentConfirmParams.excludedPaymentMethodTypes`, `PaymentIntentCreateParams.excludedPaymentMethodTypes`, `PaymentIntentUpdateParams.excludedPaymentMethodTypes`, `SetupIntentCreateParams.excludedPaymentMethodTypes`, `SetupIntentUpdateParams.excludedPaymentMethodTypes`, and `checkout.SessionCreateParams.excludedPaymentMethodTypes`
+* Add support for `mandateOptions` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, `PaymentIntentUpdateParams.payment_method_options.pix`, `checkout.Session.payment_method_options.pix`, and `checkout.SessionCreateParams.payment_method_options.pix`
+* Change type of `PaymentIntentConfirmParams.payment_method_options.pix.setupFutureUsage`, `PaymentIntentCreateParams.payment_method_options.pix.setupFutureUsage`, `PaymentIntentUpdateParams.payment_method_options.pix.setupFutureUsage`, and `checkout.SessionCreateParams.payment_method_options.pix.setupFutureUsage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new value `sunbit` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* ⚠️ Change type of `PaymentIntent.payment_method_options.pix.setupFutureUsage` and `checkout.Session.payment_method_options.pix.setupFutureUsage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new value `sunbit` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new values `fo_vat`, `gi_tin`, `it_cf`, and `py_ruc` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for new value `sunbit` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `pix` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Mandate.payment_method_details`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_options`, `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
+* Add support for `upi` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
+* Add support for new values `pix` and `upi` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `cardPresence` on `issuing.Authorization`
+* Add support for `allowedCardPresences` and `blockedCardPresences` on `issuing.Card.spending_controls`, `issuing.CardCreateParams.spending_controls`, `issuing.CardUpdateParams.spending_controls`, `issuing.Cardholder.spending_controls`, `issuing.CardholderCreateParams.spending_controls`, and `issuing.CardholderUpdateParams.spending_controls`
+* Add support for `amount` and `currency` on `Mandate.multi_use`
+* Add support for `amountToConfirm` on `PaymentIntentConfirmParams`
+* Add support for `klarnaDisplayQrCode` on `PaymentIntent.next_action`
+* Add support for new value `sunbit` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for new value `account` on enum `radar.ValueListCreateParams.itemType`
+* Add support for `moto` on `SetupAttempt.payment_method_details.card`
+* Add support for `pixDisplayQrCode` on `SetupIntent.next_action`
+* Add support for new value `2026-04-22.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
diff --git a/.hark/changes/2026-05-20_xavdid_add-better-example.change.md b/.hark/changes/2026-05-20_xavdid_add-better-example.change.md
new file mode 100644
index 00000000000..9dbde9d9cc2
--- /dev/null
+++ b/.hark/changes/2026-05-20_xavdid_add-better-example.change.md
@@ -0,0 +1,5 @@
+---
+title: Add better example for accessing non-documented properties in a list response
+pr_url: https://github.com/stripe/stripe-java/pull/2218
+released_in_version: 32.2.0
+---
diff --git a/.hark/changes/2026-05-26_xavdid_emit-warning-stripe.change.md b/.hark/changes/2026-05-26_xavdid_emit-warning-stripe.change.md
new file mode 100644
index 00000000000..62618a3bc2b
--- /dev/null
+++ b/.hark/changes/2026-05-26_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-java/pull/2219
+released_in_version: 32.2.0
+---
diff --git a/.hark/changes/2026-05-27_mbroshi_update-generated-code.change.md b/.hark/changes/2026-05-27_mbroshi_update-generated-code.change.md
new file mode 100644
index 00000000000..37197537fee
--- /dev/null
+++ b/.hark/changes/2026-05-27_mbroshi_update-generated-code.change.md
@@ -0,0 +1,48 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2220
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 32.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 `bizumPayments` and `scalapayPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+* Add support for `automaticTransferRulesByCurrency` on `BalanceSettings.payments.payouts` and `BalanceSettingsUpdateParams.payments.payouts`
+* Add support for `startOfDay` on `BalanceSettings.payments.settlement_timing` and `BalanceSettingsUpdateParams.payments.settlement_timing`
+* Add support for `description` on `ChargeCreateParams.transfer_data`, `PaymentIntent.transfer_data`, `PaymentIntentCreateParams.transfer_data`, and `PaymentIntentUpdateParams.transfer_data`
+* Add support for `bizum` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
+* Add support for `scalapay` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `Refund.destination_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_data`, `checkout.Session.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `mandate` on `Charge.payment_method_details.twint`, `PaymentAttemptRecord.payment_method_details.twint`, and `PaymentRecord.payment_method_details.twint`
+* Add support for new values `bizum` and `scalapay` on enums `PaymentIntentConfirmParams.excludedPaymentMethodTypes`, `PaymentIntentCreateParams.excludedPaymentMethodTypes`, `PaymentIntentUpdateParams.excludedPaymentMethodTypes`, `SetupIntentCreateParams.excludedPaymentMethodTypes`, `SetupIntentUpdateParams.excludedPaymentMethodTypes`, and `checkout.SessionCreateParams.excludedPaymentMethodTypes`
+* Change type of `PaymentIntentConfirmParams.payment_method_options.twint.setupFutureUsage`, `PaymentIntentCreateParams.payment_method_options.twint.setupFutureUsage`, `PaymentIntentUpdateParams.payment_method_options.twint.setupFutureUsage`, and `checkout.SessionCreateParams.payment_method_options.twint.setupFutureUsage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new values `bizum` and `scalapay` on enum `checkout.SessionCreateParams.paymentMethodTypes`
+* ⚠️ Change type of `PaymentIntent.payment_method_options.twint.setupFutureUsage` and `checkout.Session.payment_method_options.twint.setupFutureUsage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for new values `bizum` and `scalapay` on enums `ConfirmationTokenCreateParams.payment_method_data.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
+* Add support for new values `bizum` and `scalapay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
+* Add support for `creditedItems` on `InvoiceItem.proration_details`
+* Add support for new value `twint` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for `discountable` on `InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[]`, `SubscriptionCreateParams.add_invoice_items[]`, `SubscriptionSchedule.phases[].add_invoice_items[]`, `SubscriptionScheduleCreateParams.phases[].add_invoice_items[]`, `SubscriptionScheduleUpdateParams.phases[].add_invoice_items[]`, and `SubscriptionUpdateParams.add_invoice_items[]`
+* Add support for `billingSchedules` on `InvoiceCreatePreviewParams.subscription_details`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for new value `max_billed_until` on enums `InvoiceCreatePreviewParams.subscription_details.cancelAt`, `SubscriptionCreateParams.cancelAt`, and `SubscriptionUpdateParams.cancelAt`
+* Add support for `amountPaidOffStripe` on `Invoice`
+* Add support for `twint` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
+* Add support for `metadata` on `PaymentIntent.transfer_data`, `PaymentIntentCreateParams.transfer_data`, `PaymentIntentUpdateParams.transfer_data`, and `Subscription.pending_update`
+* Add support for `paymentData` on `PaymentIntent.transfer_data`, `PaymentIntentCreateParams.transfer_data`, and `PaymentIntentUpdateParams.transfer_data`
+* Add support for `blikAuthorize` on `PaymentIntent.next_action` and `SetupIntent.next_action`
+* Add support for `paymentMethodOptions` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for new value `bizum` on enums `PaymentLinkCreateParams.paymentMethodTypes` and `PaymentLinkUpdateParams.paymentMethodTypes`
+* Add support for `active` on `PaymentMethodConfigurationListParams`
+* Add support for `billedUntil` on `SubscriptionItem`
+* Add support for `discount` and `discounts` on `Subscription.pending_update`
+* Add support for `verifoneM425`, `verifoneP630`, `verifoneUx700`, and `verifoneV660p` on `terminal.ConfigurationCreateParams`, `terminal.ConfigurationUpdateParams`, and `terminal.Configuration`
+* 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.deviceType`
+* Add support for `apiError` and `printContent` on `terminal.Reader.action`
+* Add support for `customer` on `testhelpers.TestClockCreateParams`
+* Add support for new value `2026-05-27.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for `signer` on `v2.core.Account.identity.business_details.documents.proof_of_registration`, `v2.core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership`, `v2.core.AccountCreateParams.identity.business_details.documents.proof_of_registration`, `v2.core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership`, `v2.core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration`, `v2.core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership`, `v2.core.AccountUpdateParams.identity.business_details.documents.proof_of_registration`, and `v2.core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership`
+* Add support for `azureEventGrid` on `v2.core.EventDestinationCreateParams` and `v2.core.EventDestination`
+* 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.error_types[].code` and `EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code`
+* Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `v2.commerce.ProductCatalogImport`
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 00000000000..cacb079915e
--- /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-java/pull/2230
+released_in_version: 33.0.0
+---
diff --git a/.hark/changes/2026-06-05_xavdid_make-taxrate-taxdetails.change.md b/.hark/changes/2026-06-05_xavdid_make-taxrate-taxdetails.change.md
new file mode 100644
index 00000000000..b3a0b038c05
--- /dev/null
+++ b/.hark/changes/2026-06-05_xavdid_make-taxrate-taxdetails.change.md
@@ -0,0 +1,6 @@
+---
+title: Make `tax_rate.tax_details` expandable
+pr_url: https://github.com/stripe/stripe-java/pull/2234
+semver_level: major
+released_in_version: 33.0.0
+---
diff --git a/.hark/changes/2026-06-24_xavdid_update-generated-code.change.md b/.hark/changes/2026-06-24_xavdid_update-generated-code.change.md
new file mode 100644
index 00000000000..d917def5a2c
--- /dev/null
+++ b/.hark/changes/2026-06-24_xavdid_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2240
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 33.1.0
+---
+
+* Add support for `releaseDetails` on `reserve.Hold`
+* Add support for `buyerId` on `Charge.payment_method_details.bizum`, `ConfirmationToken.payment_method_preview.bizum`, `ConfirmationToken.payment_method_preview.blik`, `PaymentAttemptRecord.payment_method_details.bizum`, `PaymentMethod.bizum`, `PaymentMethod.blik`, and `PaymentRecord.payment_method_details.bizum`
+* Add support for `transactionLinkId` on `Charge.payment_method_details.card`
+* Add support for `fingerprint` on `Charge.payment_method_details.pix`, `ConfirmationToken.payment_method_preview.pix`, `PaymentMethod.pix`, and `SetupAttempt.payment_method_details.pix`
+* Add support for `sunbit` on `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `checkout.Session.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
+* Add support for `billingCycleAnchorConfig` on `checkout.SessionCreateParams.subscription_data`
+* Add support for `wechatPay` on `checkout.Session.payment_method_options`
+* Add support for `mastercardCompliance` on `Dispute.evidence.enhanced_evidence`, `Dispute.evidence_details.enhanced_eligibility`, and `DisputeUpdateParams.evidence.enhanced_evidence`
+* Add support for `statusDetails` on `financialconnections.Account`
+* Add support for new value `satispay` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* ⚠️ Remove support for `storedCredentialUsage` on `PaymentAttemptRecord.payment_method_details.card` and `PaymentRecord.payment_method_details.card`
+* Add support for `setupFutureUsage` on `PaymentIntent.payment_method_options.satispay`, `PaymentIntentConfirmParams.payment_method_options.satispay`, `PaymentIntentCreateParams.payment_method_options.satispay`, and `PaymentIntentUpdateParams.payment_method_options.satispay`
+* Change `PaymentRecordReportRefundParams.refunded` to be optional
+* Add support for `satispay` on `SetupAttempt.payment_method_details`
+* Add support for `customFields`, `description`, and `footer` on `Subscription.invoice_settings`, `SubscriptionCreateParams.invoice_settings`, and `SubscriptionUpdateParams.invoice_settings`
+* Add support for `paymentMethodOptions` and `paymentMethod` on `TopupCreateParams`
+* Add support for new value `2026-06-24.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for `mode` on `v2.commerce.ProductCatalogImport`
+* Add support for `sunbitPayments` on `v2.core.Account.configuration.merchant.capabilities`, `v2.core.AccountCreateParams.configuration.merchant.capabilities`, and `v2.core.AccountUpdateParams.configuration.merchant.capabilities`
+* Add support for `cryptoMoneyManager` and `moneyManager` on `v2.core.AccountUpdateParams.identity.attestations.terms_of_service`
+* ⚠️ Remove support for `cryptoStorer` and `storer` on `v2.core.AccountUpdateParams.identity.attestations.terms_of_service`
+* Add support for new value `promotion` on enum `v2.commerce.ProductCatalogImportCreateParams.feedType`
+* Add support for new value `sunbit_payments` on enum `EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updatedCapability`
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 00000000000..0d4ab167e78
--- /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-java/pull/2244
+released_in_version: 33.1.1
+---
diff --git a/.hark/changes/2026-07-29_jar_update-generated-code.change.md b/.hark/changes/2026-07-29_jar_update-generated-code.change.md
new file mode 100644
index 00000000000..d564fe21fd8
--- /dev/null
+++ b/.hark/changes/2026-07-29_jar_update-generated-code.change.md
@@ -0,0 +1,42 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2257
+is_stripe_api_change: true
+released_in_version: 33.2.0
+---
+
+* Add support for new resource `financialconnections.Authorization`
+* Add support for `unreject` method on resource `Account`
+* Add support for `list` method on resource `PaymentRecord`
+* Add support for `smartDisputesManagement` on `AccountSession.components.disputes_list.features`, `AccountSession.components.payment_details.features`, `AccountSession.components.payment_disputes.features`, `AccountSession.components.payments.features`, `AccountSessionCreateParams.components.disputes_list.features`, `AccountSessionCreateParams.components.payment_details.features`, `AccountSessionCreateParams.components.payment_disputes.features`, and `AccountSessionCreateParams.components.payments.features`
+* Add support for `administrativeAddress` and `principalPlaceOfBusiness` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
+* Add support for `sepaDebitPayments` on `AccountUpdateParams.settings`
+* Remove support for `proofOfRegistration` on `AccountCreateParams.documents`.  This field was limited-use and is being deprecated.
+* Add support for `payoutsAction` on `AccountRejectParams`
+* Remove support for `dynamicTaxRates` on `checkout.SessionCreateParams.line_items[]`.  This field was limited-use and is being deprecated.
+* Add support for `setupFutureUsage` on `PaymentIntent.payment_method_options.payco`, `PaymentIntent.payment_method_options.samsung_pay`, `PaymentIntentConfirmParams.payment_method_options.payco`, `PaymentIntentConfirmParams.payment_method_options.samsung_pay`, `PaymentIntentCreateParams.payment_method_options.payco`, `PaymentIntentCreateParams.payment_method_options.samsung_pay`, `PaymentIntentUpdateParams.payment_method_options.payco`, `PaymentIntentUpdateParams.payment_method_options.samsung_pay`, `PaymentLinkUpdateParams.payment_intent_data`, `checkout.Session.payment_method_options.payco`, `checkout.Session.payment_method_options.samsung_pay`, `checkout.SessionCreateParams.payment_method_options.payco`, and `checkout.SessionCreateParams.payment_method_options.samsung_pay`
+* Add support for new values `bnp_paribas`, `citibank`, and `mbsb_bank` on enums `ConfirmationTokenCreateParams.payment_method_data.fpx.bank`, `PaymentIntentConfirmParams.payment_method_data.fpx.bank`, `PaymentIntentCreateParams.payment_method_data.fpx.bank`, `PaymentIntentUpdateParams.payment_method_data.fpx.bank`, `PaymentMethodCreateParams.fpx.bank`, `SetupIntentConfirmParams.payment_method_data.fpx.bank`, `SetupIntentCreateParams.payment_method_data.fpx.bank`, and `SetupIntentUpdateParams.payment_method_data.fpx.bank`
+* Add support for new value `ic_nif` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
+* Add support for `network` on `Dispute.payment_method_details.card`
+* Add support for `limits` and `manualEntry` on `financialconnections.SessionCreateParams` and `financialconnections.Session`
+* Add support for `requirePaymentMethodSupport` on `financialconnections.Session.filters` and `financialconnections.SessionCreateParams.filters`
+* Add support for `bankAccountToken` on `financialconnections.Session`
+* Add support for new values `alipay` and `mb_way` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enums `InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.taxType`, `InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data.taxType`, `InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.taxType`, `TaxRateCreateParams.taxType`, and `TaxRateUpdateParams.taxType`
+* Add support for `metadata` on `InvoiceCreatePreviewParams.subscription_details`
+* Add support for `businessName` on `issuing.Card.shipping`, `issuing.CardCreateParams.shipping`, and `issuing.CardUpdateParams.shipping`
+* Add support for `allowedPaymentMethodTypes` on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `PaymentIntent`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntent`
+* Add support for `referrer` on `PaymentIntentConfirmParams.radar_options` and `PaymentIntentCreateParams.radar_options`
+* Add support for `consentCollection` and `shippingOptions` on `PaymentLinkUpdateParams`
+* Add support for `customFields`, `description`, and `footer` on `Quote.invoice_settings`, `QuoteCreateParams.invoice_settings`, `QuoteUpdateParams.invoice_settings`, `SubscriptionSchedule.default_settings.invoice_settings`, `SubscriptionSchedule.phases[].invoice_settings`, `SubscriptionScheduleCreateParams.default_settings.invoice_settings`, `SubscriptionScheduleCreateParams.phases[].invoice_settings`, `SubscriptionScheduleUpdateParams.default_settings.invoice_settings`, and `SubscriptionScheduleUpdateParams.phases[].invoice_settings`
+* Add support for `customerAccount` and `customer` on `Refund`
+* Add support for `paymentMethod` on `Refund` and `Topup`
+* Add support for `trial` on `SubscriptionSchedule.phases[]`
+* Add support for `massTransitParkingTax` and `parkingTax` on `tax.Registration.country_options.us` and `tax.RegistrationCreateParams.country_options.us`
+* Add support for new values `mass_transit_parking_tax` and `parking_tax` on enum `tax.RegistrationCreateParams.country_options.us.type`
+* Add support for `initiatedBy` and `paymentMethodOptions` 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.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
+* Add support for new value `2026-07-29.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
+* Add support for `additionalAddresses` on `v2.core.Account.identity.business_details`, `v2.core.AccountCreateParams.identity.business_details`, `v2.core.AccountTokenCreateParams.identity.business_details`, and `v2.core.AccountUpdateParams.identity.business_details`
+* 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 `financialconnections.Account`
+* Add support for snapshot events `financial_connections.authorization.expected_deactivation_date_updated` and `financial_connections.authorization.upcoming_deactivation` with resource `financialconnections.Authorization`
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 00000000000..4e0b50cd07d
--- /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-java/pull/2261
+released_in_version: 33.3.0
+---
diff --git a/.hark/changes/2026-08-05_xavdid_add-stripeobject-deserializat.change.md b/.hark/changes/2026-08-05_xavdid_add-stripeobject-deserializat.change.md
new file mode 100644
index 00000000000..6f017201ac9
--- /dev/null
+++ b/.hark/changes/2026-08-05_xavdid_add-stripeobject-deserializat.change.md
@@ -0,0 +1,5 @@
+---
+title: add stripeobject deserialization helper for JsonObject
+pr_url: https://github.com/stripe/stripe-java/pull/2263
+released_in_version: 33.3.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 00000000000..352364b2458
--- /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-java/pull/2256
+released_in_version: 33.3.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.constructEventWithoutVerification(payload)`
+  - `StripeClient.constructEventWithoutVerification(payload)`
+  - `StripeClient.parseEventNotificationWithoutVerification(payload)`
+- Added `Webhook.Signature.generateSignatureHeader(payload, secret)`, which computes a full `Stripe-Signature` header for the given payload. Useful for unit tests!
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 00000000000..a5bcdd24a70
--- /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-java/pull/2265
+released_in_version: 33.3.0
+---
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 00000000000..420434d8878
--- /dev/null
+++ b/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md
@@ -0,0 +1,10 @@
+---
+title: Add new `EventNotificationHandler` class for better thin event management
+pr_url: https://github.com/stripe/stripe-java/pull/2269
+released_in_version: 33.4.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
diff --git a/.hark/changes/2026-08-26_xavdid_update-generated-code.change.md b/.hark/changes/2026-08-26_xavdid_update-generated-code.change.md
new file mode 100644
index 00000000000..947e88f8023
--- /dev/null
+++ b/.hark/changes/2026-08-26_xavdid_update-generated-code.change.md
@@ -0,0 +1,28 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-java/pull/2262
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 33.4.0
+---
+
+* Add support for new resource `billing.FeedbackOption`
+* Add support for `create`, `deactivate`, `list`, `retrieve`, and `update` methods on resource `billing.FeedbackOption`
+* Add support for `paymentMethodSettings` on `AccountSession.components` and `AccountSessionCreateParams.components`
+* Add support for `feedbackOptions` on `billingportal.Configuration.features.subscription_cancel.cancellation_reason`, `billingportal.ConfigurationCreateParams.features.subscription_cancel.cancellation_reason`, and `billingportal.ConfigurationUpdateParams.features.subscription_cancel.cancellation_reason`
+* Add support for new value `customer_update` on enum `billingportal.SessionCreateParams.flow_data.type`
+* Add support for `customerUpdate` on `billingportal.Session.flow`
+* Add support for `fundingSourceGroup` on `Charge.payment_method_details.card.wallet.link` and `Charge.payment_method_details.link`
+* Add support for `fundingTypesBlocked` on `checkout.Session.payment_method_options.card.restrictions` and `checkout.SessionCreateParams.payment_method_options.card.restrictions`
+* Add support for `metadata` on `ConfirmationToken`
+* Add support for `activeEntitlements` and `customerPortal` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
+* Add support for `country` on `financialconnections.Session.filters`
+* Add support for `frozenFields` on `InvoiceItem`
+* Add support for `billie` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
+* Add support for new value `billie` on enums `InvoiceCreateParams.payment_settings.paymentMethodTypes`, `InvoiceUpdateParams.payment_settings.paymentMethodTypes`, `SubscriptionCreateParams.payment_settings.paymentMethodTypes`, and `SubscriptionUpdateParams.payment_settings.paymentMethodTypes`
+* ⚠️ Remove support for `cryptogram` on `PaymentAttemptRecord.payment_method_details.card.three_d_secure` and `PaymentRecord.payment_method_details.card.three_d_secure`
+* Add support for new value `touch_n_go` on enums `PaymentIntentConfirmParams.allowedPaymentMethodTypes`, `PaymentIntentCreateParams.allowedPaymentMethodTypes`, `PaymentIntentUpdateParams.allowedPaymentMethodTypes`, `SetupIntentConfirmParams.allowedPaymentMethodTypes`, `SetupIntentCreateParams.allowedPaymentMethodTypes`, and `SetupIntentUpdateParams.allowedPaymentMethodTypes`
+* Add support for `applicationFeeAmount`, `applicationFeePercent`, `onBehalfOf`, and `transferData` on `PaymentLinkUpdateParams`
+* Add support for `feedbackOption` on `Subscription.cancellation_details`, `SubscriptionCancelParams.cancellation_details`, and `SubscriptionUpdateParams.cancellation_details`
+* Add support for `igic` on `tax.Registration.country_options.at`, `tax.Registration.country_options.be`, `tax.Registration.country_options.bg`, `tax.Registration.country_options.cy`, `tax.Registration.country_options.cz`, `tax.Registration.country_options.de`, `tax.Registration.country_options.dk`, `tax.Registration.country_options.ee`, `tax.Registration.country_options.es`, `tax.Registration.country_options.fi`, `tax.Registration.country_options.fr`, `tax.Registration.country_options.gr`, `tax.Registration.country_options.hr`, `tax.Registration.country_options.hu`, `tax.Registration.country_options.ie`, `tax.Registration.country_options.it`, `tax.Registration.country_options.lt`, `tax.Registration.country_options.lu`, `tax.Registration.country_options.lv`, `tax.Registration.country_options.mt`, `tax.Registration.country_options.nl`, `tax.Registration.country_options.pl`, `tax.Registration.country_options.pt`, `tax.Registration.country_options.ro`, `tax.Registration.country_options.se`, `tax.Registration.country_options.si`, `tax.Registration.country_options.sk`, `tax.RegistrationCreateParams.country_options.at`, `tax.RegistrationCreateParams.country_options.be`, `tax.RegistrationCreateParams.country_options.bg`, `tax.RegistrationCreateParams.country_options.cy`, `tax.RegistrationCreateParams.country_options.cz`, `tax.RegistrationCreateParams.country_options.de`, `tax.RegistrationCreateParams.country_options.dk`, `tax.RegistrationCreateParams.country_options.ee`, `tax.RegistrationCreateParams.country_options.es`, `tax.RegistrationCreateParams.country_options.fi`, `tax.RegistrationCreateParams.country_options.fr`, `tax.RegistrationCreateParams.country_options.gr`, `tax.RegistrationCreateParams.country_options.hr`, `tax.RegistrationCreateParams.country_options.hu`, `tax.RegistrationCreateParams.country_options.ie`, `tax.RegistrationCreateParams.country_options.it`, `tax.RegistrationCreateParams.country_options.lt`, `tax.RegistrationCreateParams.country_options.lu`, `tax.RegistrationCreateParams.country_options.lv`, `tax.RegistrationCreateParams.country_options.mt`, `tax.RegistrationCreateParams.country_options.nl`, `tax.RegistrationCreateParams.country_options.pl`, `tax.RegistrationCreateParams.country_options.pt`, `tax.RegistrationCreateParams.country_options.ro`, `tax.RegistrationCreateParams.country_options.se`, `tax.RegistrationCreateParams.country_options.si`, and `tax.RegistrationCreateParams.country_options.sk`
+* Add support for new value `2026-08-26.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
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 00000000000..83d7947114a
--- /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-java/pull/2284
+released_in_version: 33.4.1
+---
diff --git a/.hark/changes/2026-09-09_xavdid_validate-webhook-secrets.change.md b/.hark/changes/2026-09-09_xavdid_validate-webhook-secrets.change.md
new file mode 100644
index 00000000000..833635d73b6
--- /dev/null
+++ b/.hark/changes/2026-09-09_xavdid_validate-webhook-secrets.change.md
@@ -0,0 +1,5 @@
+---
+title: Validate that webhook secrets are non-empty
+pr_url: https://github.com/stripe/stripe-java/pull/2286
+released_in_version: 33.4.2
+---
diff --git a/.hark/intros/intro-17.0.0.md b/.hark/intros/intro-17.0.0.md
new file mode 100644
index 00000000000..4cad2013954
--- /dev/null
+++ b/.hark/intros/intro-17.0.0.md
@@ -0,0 +1 @@
+Pull requests included in this release (cf. [#869](https://github.com/stripe/stripe-java/pull/869)) (⚠️ = breaking changes):
diff --git a/.hark/intros/intro-21.0.0.md b/.hark/intros/intro-21.0.0.md
new file mode 100644
index 00000000000..8bd7d7a205f
--- /dev/null
+++ b/.hark/intros/intro-21.0.0.md
@@ -0,0 +1,3 @@
+This release includes breaking changes resulting from:
+
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-22.0.0.md b/.hark/intros/intro-22.0.0.md
new file mode 100644
index 00000000000..d6e416bd766
--- /dev/null
+++ b/.hark/intros/intro-22.0.0.md
@@ -0,0 +1,21 @@
+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.
+
+Use of `setStripeVersionOverride` is discouraged and can lead to unexpected errors during service calls because Java SDK class shapes are not guaranteed to match API responses on arbitrary versions.
+
+If you were using these methods in conjunction with `EphemeralKey` resource prefer the `EphemeralKeyCreateParamsBuilder.setStripeVersion`.
+```java
+EphemeralKeyCreateParams params = EphemeralKeyCreateParams.builder()
+  .setStripeVersion("XXXX-YY-ZZ")
+  .build();
+```
+
+If you have a use case that requires per-request version overrides, please file an issue on [stripe-java](https://github.com/stripe/stripe-java/issues) repository to ensure we are aware and can add first-class support for it. In the meantime you can use `unsafeSetStripeVersionOverride` method as a workaround.
+```java
+RequestOptions.RequestOptionsBuilder builder = RequestOptions.builder();
+builder.setApiKey(...)
+            .setClientId(...);
+
+RequestOptionsBuilder.unsafeSetStripeVersionOverride(builder, "2022-11-15");
+```
diff --git a/.hark/intros/intro-23.0.0.md b/.hark/intros/intro-23.0.0.md
new file mode 100644
index 00000000000..9063146eaf4
--- /dev/null
+++ b/.hark/intros/intro-23.0.0.md
@@ -0,0 +1 @@
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-28.0.0.md b/.hark/intros/intro-28.0.0.md
new file mode 100644
index 00000000000..6ed3563b2ba
--- /dev/null
+++ b/.hark/intros/intro-28.0.0.md
@@ -0,0 +1,3 @@
+Historically, when upgrading webhooks to a new API version, you also had to upgrade your SDK version. Your webhook's API version needed to match the API version pinned by the SDK you were using to ensure successful deserialization of events. With the `2024-09-30.acacia` release, Stripe follows a [new API release process](https://stripe.com/blog/introducing-stripes-new-api-release-process). As a result, you can safely upgrade your webhook endpoints to any API version within a biannual release (like `acacia`) without upgrading the SDK.
+
+However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y` SDK releases meant that webhook version upgrades from the SDK's pinned `2024-09-30.acacia` version to the new `2024-10-28.acacia` version would fail. Therefore, we are shipping SDK support for `2024-10-28.acacia` as a major version to enforce the idea that an SDK upgrade is also required. Future API versions in the `acacia` line will be released as minor versions.
diff --git a/.hark/intros/intro-30.0.0.md b/.hark/intros/intro-30.0.0.md
new file mode 100644
index 00000000000..caec7ed1d3f
--- /dev/null
+++ b/.hark/intros/intro-30.0.0.md
@@ -0,0 +1 @@
+This release contains breaking changes (prefixed with ⚠️ below)
diff --git a/.hark/intros/intro-32.0.0.md b/.hark/intros/intro-32.0.0.md
new file mode 100644
index 00000000000..e98f6f33cec
--- /dev/null
+++ b/.hark/intros/intro-32.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-java/wiki/Migration-guide-for-v32) 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-33.0.0.md b/.hark/intros/intro-33.0.0.md
new file mode 100644
index 00000000000..8f91e7c5d28
--- /dev/null
+++ b/.hark/intros/intro-33.0.0.md
@@ -0,0 +1,3 @@
+This release **doesn't** change the pinned API version; it still uses `2026-05-27.dahlia`.
+
+We're doing an out-of-band-major to update a field type that changed. If you're not using `tax_details`, this is a no-op release when compared with the last one. If you _are_ using `tax_details` its type has changed slightly and you'll have to update your code when upgrading.
diff --git a/.hark/intros/intro-6.0.0.md b/.hark/intros/intro-6.0.0.md
new file mode 100644
index 00000000000..eec96564f26
--- /dev/null
+++ b/.hark/intros/intro-6.0.0.md
@@ -0,0 +1,3 @@
+Major version release. Refer to our [migration guide for v6](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v6) for a list of backwards incompatible changes to watch out for.
+
+Pull requests included in this release:
diff --git a/.hark/intros/intro-7.0.0.md b/.hark/intros/intro-7.0.0.md
new file mode 100644
index 00000000000..443f9533aa7
--- /dev/null
+++ b/.hark/intros/intro-7.0.0.md
@@ -0,0 +1,3 @@
+Major version release. Refer to our [migration guide for v7](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v7) for a list of backwards incompatible changes to watch out for.
+
+Pull requests included in this release:
diff --git a/.hark/releases.json b/.hark/releases.json
new file mode 100644
index 00000000000..0cbb52de406
--- /dev/null
+++ b/.hark/releases.json
@@ -0,0 +1,3880 @@
+{
+  "metadata": {
+    "language": "java",
+    "channel": "ga"
+  },
+  "releases": [
+    {
+      "version": "33.4.2",
+      "released_on": "2026-09-09",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.4.1",
+      "released_on": "2026-09-01",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.4.0",
+      "released_on": "2026-08-26",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.3.0",
+      "released_on": "2026-08-10",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.2.0",
+      "released_on": "2026-07-29",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.1.1",
+      "released_on": "2026-07-15",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.1.0",
+      "released_on": "2026-06-24",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "33.0.0",
+      "released_on": "2026-06-05",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "32.2.0",
+      "released_on": "2026-05-27",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "32.1.0",
+      "released_on": "2026-04-23",
+      "pinned_api_version": "2026-04-22.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "32.0.0",
+      "released_on": "2026-03-25",
+      "pinned_api_version": "2026-03-25.dahlia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.4.1",
+      "released_on": "2026-03-06",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.4.0",
+      "released_on": "2026-02-25",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.3.0",
+      "released_on": "2026-01-28",
+      "pinned_api_version": "2026-01-28.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.2.0",
+      "released_on": "2026-01-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.1.0",
+      "released_on": "2025-12-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "31.0.0",
+      "released_on": "2025-11-18",
+      "pinned_api_version": "2025-11-17.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "30.2.0",
+      "released_on": "2025-11-05",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "30.1.0",
+      "released_on": "2025-10-29",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "30.0.0",
+      "released_on": "2025-09-30",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.5.0",
+      "released_on": "2025-08-27",
+      "pinned_api_version": "2025-08-27.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.4.0",
+      "released_on": "2025-07-30",
+      "pinned_api_version": "2025-07-30.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.3.0",
+      "released_on": "2025-07-01",
+      "pinned_api_version": "2025-06-30.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.2.0",
+      "released_on": "2025-05-29",
+      "pinned_api_version": "2025-05-28.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.1.0",
+      "released_on": "2025-04-30",
+      "pinned_api_version": "2025-04-30.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "29.0.0",
+      "released_on": "2025-04-01",
+      "pinned_api_version": "2025-03-31.basil",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.4.0",
+      "released_on": "2025-02-24",
+      "pinned_api_version": "2025-02-24.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.3.1",
+      "released_on": "2025-02-07",
+      "pinned_api_version": "2025-01-27.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.3.0",
+      "released_on": "2025-01-27",
+      "pinned_api_version": "2025-01-27.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.2.0",
+      "released_on": "2024-12-18",
+      "pinned_api_version": "2024-12-18.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.1.0",
+      "released_on": "2024-11-20",
+      "pinned_api_version": "2024-11-20.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.0.1",
+      "released_on": "2024-11-06",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "28.0.0",
+      "released_on": "2024-10-29",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "27.1.2",
+      "released_on": "2024-10-29",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "27.1.1",
+      "released_on": "2024-10-18",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "27.1.0",
+      "released_on": "2024-10-03",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "27.0.0",
+      "released_on": "2024-10-01",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.13.0",
+      "released_on": "2024-10-01",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.12.0",
+      "released_on": "2024-09-18",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.11.0",
+      "released_on": "2024-09-12",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.10.0",
+      "released_on": "2024-09-05",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.9.0",
+      "released_on": "2024-08-29",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.8.0",
+      "released_on": "2024-08-15",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.7.0",
+      "released_on": "2024-08-08",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.6.0",
+      "released_on": "2024-08-01",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.5.1",
+      "released_on": "2024-07-25",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.5.0",
+      "released_on": "2024-07-25",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.4.0",
+      "released_on": "2024-07-18",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.3.0",
+      "released_on": "2024-07-11",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.2.0",
+      "released_on": "2024-07-05",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.1.0",
+      "released_on": "2024-06-27",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "26.0.0",
+      "released_on": "2024-06-24",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.13.0",
+      "released_on": "2024-06-17",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.12.0",
+      "released_on": "2024-06-13",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.11.0",
+      "released_on": "2024-06-06",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.10.0",
+      "released_on": "2024-05-30",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.9.0",
+      "released_on": "2024-05-23",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.8.0",
+      "released_on": "2024-05-16",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.7.0",
+      "released_on": "2024-05-09",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.6.0",
+      "released_on": "2024-05-09",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.5.0",
+      "released_on": "2024-05-02",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.4.0",
+      "released_on": "2024-04-25",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.3.0",
+      "released_on": "2024-04-18",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.2.0",
+      "released_on": "2024-04-16",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.1.0",
+      "released_on": "2024-04-11",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "25.0.0",
+      "released_on": "2024-04-10",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.24.0",
+      "released_on": "2024-04-09",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.23.0",
+      "released_on": "2024-04-04",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.22.0",
+      "released_on": "2024-03-28",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.21.0",
+      "released_on": "2024-03-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.20.0",
+      "released_on": "2024-03-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.19.0",
+      "released_on": "2024-03-07",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.18.0",
+      "released_on": "2024-02-29",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.17.0",
+      "released_on": "2024-02-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.16.0",
+      "released_on": "2024-02-15",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.15.0",
+      "released_on": "2024-02-08",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.14.0",
+      "released_on": "2024-02-01",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.13.0",
+      "released_on": "2024-01-25",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.12.0",
+      "released_on": "2024-01-18",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.11.0",
+      "released_on": "2024-01-12",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.10.0",
+      "released_on": "2024-01-04",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.9.0",
+      "released_on": "2023-12-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.8.0",
+      "released_on": "2023-12-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.7.0",
+      "released_on": "2023-12-07",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.6.0",
+      "released_on": "2023-11-30",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.5.0",
+      "released_on": "2023-11-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.4.0",
+      "released_on": "2023-11-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.3.0",
+      "released_on": "2023-11-16",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.2.0",
+      "released_on": "2023-11-09",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.1.0",
+      "released_on": "2023-11-02",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "24.0.0",
+      "released_on": "2023-10-16",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.10.0",
+      "released_on": "2023-10-16",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.9.0",
+      "released_on": "2023-10-11",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.8.0",
+      "released_on": "2023-10-05",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.7.0",
+      "released_on": "2023-09-28",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.6.0",
+      "released_on": "2023-09-21",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.5.0",
+      "released_on": "2023-09-14",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.4.0",
+      "released_on": "2023-09-07",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.3.0",
+      "released_on": "2023-08-31",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.2.0",
+      "released_on": "2023-08-24",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.1.1",
+      "released_on": "2023-08-21",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.1.0",
+      "released_on": "2023-08-17",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "23.0.0",
+      "released_on": "2023-08-16",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.31.0",
+      "released_on": "2023-08-10",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.30.0",
+      "released_on": "2023-08-03",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.29.0",
+      "released_on": "2023-07-27",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.28.0",
+      "released_on": "2023-07-20",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.27.0",
+      "released_on": "2023-07-13",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.26.0",
+      "released_on": "2023-07-06",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.25.0",
+      "released_on": "2023-06-29",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.24.0",
+      "released_on": "2023-06-22",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.23.1",
+      "released_on": "2023-06-09",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.23.0",
+      "released_on": "2023-06-08",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.22.0",
+      "released_on": "2023-06-01",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.21.0",
+      "released_on": "2023-05-25",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.20.0",
+      "released_on": "2023-05-19",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.19.0",
+      "released_on": "2023-05-11",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.18.0",
+      "released_on": "2023-05-04",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.17.0",
+      "released_on": "2023-04-27",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.16.0",
+      "released_on": "2023-04-06",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.15.0",
+      "released_on": "2023-03-30",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.14.0",
+      "released_on": "2023-03-23",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.13.0",
+      "released_on": "2023-03-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.12.0",
+      "released_on": "2023-03-09",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.11.0",
+      "released_on": "2023-03-02",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.10.0",
+      "released_on": "2023-02-23",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.9.0",
+      "released_on": "2023-02-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.8.0",
+      "released_on": "2023-02-02",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.7.0",
+      "released_on": "2023-01-26",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.6.0",
+      "released_on": "2023-01-19",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.5.1",
+      "released_on": "2023-01-12",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.5.0",
+      "released_on": "2023-01-05",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.4.0",
+      "released_on": "2022-12-22",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.3.0",
+      "released_on": "2022-12-08",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.2.0",
+      "released_on": "2022-12-06",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.1.0",
+      "released_on": "2022-11-17",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "22.0.0",
+      "released_on": "2022-11-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.15.0",
+      "released_on": "2022-11-08",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.14.0",
+      "released_on": "2022-11-03",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.13.0",
+      "released_on": "2022-10-20",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.12.0",
+      "released_on": "2022-10-14",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.11.0",
+      "released_on": "2022-10-06",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.10.0",
+      "released_on": "2022-09-29",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.9.0",
+      "released_on": "2022-09-22",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.8.0",
+      "released_on": "2022-09-15",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.7.0",
+      "released_on": "2022-09-09",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.6.0",
+      "released_on": "2022-09-06",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.5.0",
+      "released_on": "2022-08-31",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.4.0",
+      "released_on": "2022-08-26",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.3.0",
+      "released_on": "2022-08-23",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.2.0",
+      "released_on": "2022-08-11",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.1.0",
+      "released_on": "2022-08-09",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "21.0.0",
+      "released_on": "2022-08-02",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.136.0",
+      "released_on": "2022-07-26",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.135.0",
+      "released_on": "2022-07-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.134.0",
+      "released_on": "2022-07-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.133.0",
+      "released_on": "2022-07-12",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.132.0",
+      "released_on": "2022-07-07",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.131.0",
+      "released_on": "2022-06-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.130.0",
+      "released_on": "2022-06-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.129.0",
+      "released_on": "2022-06-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.128.0",
+      "released_on": "2022-06-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.127.0",
+      "released_on": "2022-06-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.126.0",
+      "released_on": "2022-06-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.125.0",
+      "released_on": "2022-06-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.124.0",
+      "released_on": "2022-05-26",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.123.0",
+      "released_on": "2022-05-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.122.0",
+      "released_on": "2022-05-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.121.0",
+      "released_on": "2022-05-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.120.0",
+      "released_on": "2022-05-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.119.0",
+      "released_on": "2022-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.118.0",
+      "released_on": "2022-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.117.0",
+      "released_on": "2022-05-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.116.0",
+      "released_on": "2022-04-21",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.115.0",
+      "released_on": "2022-04-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.114.0",
+      "released_on": "2022-04-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.113.0",
+      "released_on": "2022-04-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.112.0",
+      "released_on": "2022-04-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.111.0",
+      "released_on": "2022-03-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.110.0",
+      "released_on": "2022-03-28",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.109.0",
+      "released_on": "2022-03-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.108.0",
+      "released_on": "2022-03-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.107.0",
+      "released_on": "2022-03-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.106.0",
+      "released_on": "2022-03-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.105.0",
+      "released_on": "2022-03-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.104.0",
+      "released_on": "2022-03-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.103.0",
+      "released_on": "2022-03-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.102.0",
+      "released_on": "2022-02-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.101.0",
+      "released_on": "2022-02-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.100.0",
+      "released_on": "2022-02-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.99.0",
+      "released_on": "2022-02-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.98.0",
+      "released_on": "2022-01-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.97.0",
+      "released_on": "2022-01-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.96.0",
+      "released_on": "2022-01-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.95.0",
+      "released_on": "2022-01-12",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.94.0",
+      "released_on": "2021-12-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.93.0",
+      "released_on": "2021-12-15",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.92.0",
+      "released_on": "2021-12-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.91.0",
+      "released_on": "2021-12-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.90.0",
+      "released_on": "2021-11-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.89.0",
+      "released_on": "2021-11-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.88.0",
+      "released_on": "2021-11-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.87.0",
+      "released_on": "2021-11-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.86.1",
+      "released_on": "2021-11-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.86.0",
+      "released_on": "2021-11-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.85.0",
+      "released_on": "2021-10-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.84.0",
+      "released_on": "2021-10-15",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.83.0",
+      "released_on": "2021-10-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.82.0",
+      "released_on": "2021-10-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.81.0",
+      "released_on": "2021-10-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.80.0",
+      "released_on": "2021-10-07",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.79.0",
+      "released_on": "2021-09-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.78.0",
+      "released_on": "2021-09-24",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.77.0",
+      "released_on": "2021-09-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.76.0",
+      "released_on": "2021-09-15",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.75.0",
+      "released_on": "2021-09-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.74.0",
+      "released_on": "2021-09-07",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.73.0",
+      "released_on": "2021-09-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.72.0",
+      "released_on": "2021-09-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.71.0",
+      "released_on": "2021-08-27",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.70.0",
+      "released_on": "2021-08-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.69.0",
+      "released_on": "2021-08-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.68.0",
+      "released_on": "2021-08-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.67.0",
+      "released_on": "2021-07-28",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.66.0",
+      "released_on": "2021-07-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.65.0",
+      "released_on": "2021-07-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.64.0",
+      "released_on": "2021-07-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.63.1",
+      "released_on": "2021-07-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.63.0",
+      "released_on": "2021-07-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.62.0",
+      "released_on": "2021-06-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.61.0",
+      "released_on": "2021-06-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.60.0",
+      "released_on": "2021-06-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.59.0",
+      "released_on": "2021-06-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.58.0",
+      "released_on": "2021-06-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.57.0",
+      "released_on": "2021-06-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.56.0",
+      "released_on": "2021-06-07",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.55.0",
+      "released_on": "2021-06-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.54.0",
+      "released_on": "2021-06-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.53.0",
+      "released_on": "2021-06-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.52.0",
+      "released_on": "2021-05-26",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.51.0",
+      "released_on": "2021-05-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.50.0",
+      "released_on": "2021-05-06",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.49.0",
+      "released_on": "2021-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.48.0",
+      "released_on": "2021-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.47.1",
+      "released_on": "2021-04-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.47.0",
+      "released_on": "2021-04-12",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.46.0",
+      "released_on": "2021-04-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.45.0",
+      "released_on": "2021-03-31",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.44.0",
+      "released_on": "2021-03-26",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.43.0",
+      "released_on": "2021-03-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.42.0",
+      "released_on": "2021-03-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.41.0",
+      "released_on": "2021-02-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.40.0",
+      "released_on": "2021-02-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.39.0",
+      "released_on": "2021-02-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.38.0",
+      "released_on": "2021-02-10",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.37.0",
+      "released_on": "2021-02-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.36.0",
+      "released_on": "2021-02-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.35.0",
+      "released_on": "2021-01-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.34.0",
+      "released_on": "2021-01-07",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.33.0",
+      "released_on": "2020-12-15",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.32.0",
+      "released_on": "2020-12-10",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.31.0",
+      "released_on": "2020-12-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.30.0",
+      "released_on": "2020-11-24",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.29.0",
+      "released_on": "2020-11-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.28.0",
+      "released_on": "2020-11-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.27.0",
+      "released_on": "2020-11-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "7.63.1",
+      "released_on": "2020-11-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.63.0",
+      "released_on": "2020-11-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.26.0",
+      "released_on": "2020-11-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.25.0",
+      "released_on": "2020-11-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.24.0",
+      "released_on": "2020-10-27",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.23.0",
+      "released_on": "2020-10-26",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.22.0",
+      "released_on": "2020-10-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.21.0",
+      "released_on": "2020-10-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.20.0",
+      "released_on": "2020-10-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.19.0",
+      "released_on": "2020-10-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.18.0",
+      "released_on": "2020-10-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.17.0",
+      "released_on": "2020-10-12",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.16.0",
+      "released_on": "2020-10-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.15.0",
+      "released_on": "2020-10-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.14.0",
+      "released_on": "2020-10-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.13.0",
+      "released_on": "2020-09-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.12.0",
+      "released_on": "2020-09-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.11.0",
+      "released_on": "2020-09-28",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.10.0",
+      "released_on": "2020-09-25",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.9.0",
+      "released_on": "2020-09-24",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.8.0",
+      "released_on": "2020-09-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.7.0",
+      "released_on": "2020-09-21",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.6.0",
+      "released_on": "2020-09-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.5.0",
+      "released_on": "2020-09-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.4.0",
+      "released_on": "2020-09-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.3.2",
+      "released_on": "2020-09-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.3.1",
+      "released_on": "2020-09-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.3.0",
+      "released_on": "2020-09-08",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.2.0",
+      "released_on": "2020-09-02",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.1.0",
+      "released_on": "2020-08-31",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "20.0.0",
+      "released_on": "2020-08-31",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.45.0",
+      "released_on": "2020-08-19",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.44.0",
+      "released_on": "2020-08-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.43.0",
+      "released_on": "2020-08-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.42.0",
+      "released_on": "2020-08-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.41.0",
+      "released_on": "2020-08-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.40.0",
+      "released_on": "2020-08-07",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.39.0",
+      "released_on": "2020-08-05",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.38.0",
+      "released_on": "2020-08-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.37.0",
+      "released_on": "2020-07-31",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.36.0",
+      "released_on": "2020-07-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.35.0",
+      "released_on": "2020-07-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.34.0",
+      "released_on": "2020-07-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.33.0",
+      "released_on": "2020-07-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.32.0",
+      "released_on": "2020-07-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.31.0",
+      "released_on": "2020-07-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.30.0",
+      "released_on": "2020-07-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.29.0",
+      "released_on": "2020-07-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.28.0",
+      "released_on": "2020-07-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.27.0",
+      "released_on": "2020-06-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.26.0",
+      "released_on": "2020-06-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.25.0",
+      "released_on": "2020-06-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.24.0",
+      "released_on": "2020-06-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.23.0",
+      "released_on": "2020-06-11",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.22.0",
+      "released_on": "2020-06-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.21.0",
+      "released_on": "2020-06-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.20.0",
+      "released_on": "2020-06-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.19.0",
+      "released_on": "2020-06-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.18.0",
+      "released_on": "2020-06-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.17.0",
+      "released_on": "2020-06-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.16.0",
+      "released_on": "2020-05-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.15.0",
+      "released_on": "2020-05-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.14.0",
+      "released_on": "2020-05-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.13.0",
+      "released_on": "2020-05-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.12.0",
+      "released_on": "2020-05-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.11.0",
+      "released_on": "2020-05-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.10.0",
+      "released_on": "2020-05-11",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.9.0",
+      "released_on": "2020-05-07",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.8.0",
+      "released_on": "2020-05-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.7.0",
+      "released_on": "2020-04-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.6.0",
+      "released_on": "2020-04-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.5.0",
+      "released_on": "2020-04-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.4.0",
+      "released_on": "2020-04-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.3.0",
+      "released_on": "2020-04-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.2.0",
+      "released_on": "2020-04-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.1.0",
+      "released_on": "2020-04-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "19.0.0",
+      "released_on": "2020-04-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.16.0",
+      "released_on": "2020-04-14",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.15.0",
+      "released_on": "2020-04-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.14.0",
+      "released_on": "2020-04-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.13.1",
+      "released_on": "2020-04-06",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.13.0",
+      "released_on": "2020-04-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.12.0",
+      "released_on": "2020-03-26",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.11.0",
+      "released_on": "2020-03-25",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.10.0",
+      "released_on": "2020-03-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.9.0",
+      "released_on": "2020-03-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.8.0",
+      "released_on": "2020-03-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.7.0",
+      "released_on": "2020-03-13",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.6.0",
+      "released_on": "2020-03-12",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.5.0",
+      "released_on": "2020-03-12",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.4.0",
+      "released_on": "2020-03-05",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.3.0",
+      "released_on": "2020-03-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.2.0",
+      "released_on": "2020-03-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.1.0",
+      "released_on": "2020-03-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "18.0.0",
+      "released_on": "2020-03-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.16.0",
+      "released_on": "2020-02-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.15.0",
+      "released_on": "2020-02-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.14.0",
+      "released_on": "2020-02-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.13.0",
+      "released_on": "2020-02-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.12.0",
+      "released_on": "2020-02-21",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.11.0",
+      "released_on": "2020-02-12",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.10.0",
+      "released_on": "2020-02-12",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.9.1",
+      "released_on": "2020-02-11",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.9.0",
+      "released_on": "2020-02-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.8.0",
+      "released_on": "2020-02-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.7.0",
+      "released_on": "2020-02-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.6.0",
+      "released_on": "2020-01-31",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.5.0",
+      "released_on": "2020-01-30",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.4.0",
+      "released_on": "2020-01-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.3.0",
+      "released_on": "2020-01-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.2.0",
+      "released_on": "2020-01-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.1.1",
+      "released_on": "2020-01-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.1.0",
+      "released_on": "2020-01-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "17.0.0",
+      "released_on": "2020-01-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.8.0",
+      "released_on": "2020-01-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.7.0",
+      "released_on": "2020-01-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.6.0",
+      "released_on": "2020-01-14",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.5.1",
+      "released_on": "2020-01-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.5.0",
+      "released_on": "2020-01-07",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.4.0",
+      "released_on": "2019-12-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.3.0",
+      "released_on": "2019-12-20",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.2.0",
+      "released_on": "2019-12-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.1.0",
+      "released_on": "2019-12-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "16.0.0",
+      "released_on": "2019-12-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.7.0",
+      "released_on": "2019-11-26",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.6.0",
+      "released_on": "2019-11-25",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.5.0",
+      "released_on": "2019-11-21",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.4.0",
+      "released_on": "2019-11-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.3.1",
+      "released_on": "2019-11-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.3.0",
+      "released_on": "2019-11-07",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.2.0",
+      "released_on": "2019-11-06",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.1.0",
+      "released_on": "2019-11-06",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "15.0.0",
+      "released_on": "2019-11-05",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.5.0",
+      "released_on": "2019-11-04",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.4.1",
+      "released_on": "2019-10-30",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.4.0",
+      "released_on": "2019-10-30",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.3.0",
+      "released_on": "2019-10-25",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.2.0",
+      "released_on": "2019-10-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.1.0",
+      "released_on": "2019-10-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.0.1",
+      "released_on": "2019-10-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "14.0.0",
+      "released_on": "2019-10-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "13.3.0",
+      "released_on": "2019-10-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "13.2.0",
+      "released_on": "2019-10-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "13.1.0",
+      "released_on": "2019-10-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "13.0.0",
+      "released_on": "2019-10-08",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "12.2.0",
+      "released_on": "2019-10-08",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "12.1.0",
+      "released_on": "2019-09-27",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "12.0.0",
+      "released_on": "2019-09-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.8.0",
+      "released_on": "2019-09-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.7.0",
+      "released_on": "2019-09-05",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.6.1",
+      "released_on": "2019-09-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.6.0",
+      "released_on": "2019-09-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.5.1",
+      "released_on": "2019-08-30",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.5.0",
+      "released_on": "2019-08-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.4.0",
+      "released_on": "2019-08-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.3.0",
+      "released_on": "2019-08-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.2.0",
+      "released_on": "2019-08-21",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.1.0",
+      "released_on": "2019-08-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "11.0.0",
+      "released_on": "2019-08-14",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.15.0",
+      "released_on": "2019-08-14",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.14.0",
+      "released_on": "2019-08-08",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.13.0",
+      "released_on": "2019-08-08",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.12.2",
+      "released_on": "2019-08-07",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.12.1",
+      "released_on": "2019-07-30",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.12.0",
+      "released_on": "2019-07-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.11.0",
+      "released_on": "2019-07-19",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.10.0",
+      "released_on": "2019-07-17",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.9.1",
+      "released_on": "2019-07-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.9.0",
+      "released_on": "2019-07-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.8.0",
+      "released_on": "2019-07-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.7.0",
+      "released_on": "2019-07-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.6.0",
+      "released_on": "2019-07-12",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.5.0",
+      "released_on": "2019-07-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.4.0",
+      "released_on": "2019-07-01",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.3.0",
+      "released_on": "2019-06-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.2.0",
+      "released_on": "2019-06-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.1.0",
+      "released_on": "2019-06-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.0.2",
+      "released_on": "2019-05-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.0.1",
+      "released_on": "2019-05-28",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "10.0.0",
+      "released_on": "2019-05-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.13.0",
+      "released_on": "2019-05-23",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.12.0",
+      "released_on": "2019-05-14",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.11.0",
+      "released_on": "2019-05-10",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.10.0",
+      "released_on": "2019-05-06",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.9.0",
+      "released_on": "2019-05-03",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.8.0",
+      "released_on": "2019-04-29",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.7.0",
+      "released_on": "2019-04-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.6.0",
+      "released_on": "2019-04-24",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.5.0",
+      "released_on": "2019-04-22",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.4.0",
+      "released_on": "2019-04-18",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.3.0",
+      "released_on": "2019-04-16",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.2.0",
+      "released_on": "2019-04-15",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.1.0",
+      "released_on": "2019-04-11",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "9.0.0",
+      "released_on": "2019-04-09",
+      "minimum_runtime_version": "1.8"
+    },
+    {
+      "version": "8.1.0",
+      "released_on": "2019-03-25",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "8.0.2",
+      "released_on": "2019-03-20",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "8.0.1",
+      "released_on": "2019-03-20",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "8.0.0",
+      "released_on": "2019-03-19",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.29.0",
+      "released_on": "2019-03-18",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.28.0",
+      "released_on": "2019-03-18",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.27.0",
+      "released_on": "2019-03-13",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.26.0",
+      "released_on": "2019-03-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.25.0",
+      "released_on": "2019-02-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.24.0",
+      "released_on": "2019-02-22",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.23.0",
+      "released_on": "2019-02-19",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.22.0",
+      "released_on": "2019-02-16",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.21.0",
+      "released_on": "2019-02-12",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.20.0",
+      "released_on": "2019-02-12",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.19.0",
+      "released_on": "2019-02-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.18.1",
+      "released_on": "2019-02-04",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.18.0",
+      "released_on": "2019-01-25",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.17.0",
+      "released_on": "2019-01-17",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.16.0",
+      "released_on": "2019-01-17",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.15.0",
+      "released_on": "2019-01-14",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.14.0",
+      "released_on": "2019-01-11",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.13.0",
+      "released_on": "2019-01-09",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.12.0",
+      "released_on": "2019-01-08",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.11.0",
+      "released_on": "2018-12-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.10.0",
+      "released_on": "2018-11-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.9.0",
+      "released_on": "2018-11-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.8.0",
+      "released_on": "2018-11-19",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.7.0",
+      "released_on": "2018-11-14",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.6.0",
+      "released_on": "2018-11-09",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.5.0",
+      "released_on": "2018-11-08",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.4.0",
+      "released_on": "2018-11-08",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.3.0",
+      "released_on": "2018-11-07",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "4.11.0",
+      "released_on": "2018-11-07",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.2.0",
+      "released_on": "2018-10-31",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.1.0",
+      "released_on": "2018-10-10",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "7.0.0",
+      "released_on": "2018-09-24",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.12.0",
+      "released_on": "2018-09-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.11.0",
+      "released_on": "2018-09-05",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.10.0",
+      "released_on": "2018-09-05",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.9.0",
+      "released_on": "2018-08-29",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.8.0",
+      "released_on": "2018-08-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.7.0",
+      "released_on": "2018-08-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.6.0",
+      "released_on": "2018-08-23",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.5.0",
+      "released_on": "2018-08-16",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.4.0",
+      "released_on": "2018-08-14",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.3.0",
+      "released_on": "2018-08-03",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.2.1",
+      "released_on": "2018-08-02",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.2.0",
+      "released_on": "2018-08-01",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.1.0",
+      "released_on": "2018-07-30",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "6.0.0",
+      "released_on": "2018-07-30",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.53.0",
+      "released_on": "2018-07-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.52.0",
+      "released_on": "2018-07-26",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.51.0",
+      "released_on": "2018-07-12",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.50.0",
+      "released_on": "2018-07-11",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.49.0",
+      "released_on": "2018-07-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.48.0",
+      "released_on": "2018-07-03",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.47.0",
+      "released_on": "2018-07-02",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.46.0",
+      "released_on": "2018-06-29",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.45.0",
+      "released_on": "2018-06-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.44.0",
+      "released_on": "2018-06-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.43.0",
+      "released_on": "2018-06-25",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.42.0",
+      "released_on": "2018-06-19",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.41.1",
+      "released_on": "2018-06-17",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.41.0",
+      "released_on": "2018-06-14",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.40.0",
+      "released_on": "2018-06-13",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.39.0",
+      "released_on": "2018-06-07",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.38.0",
+      "released_on": "2018-06-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.37.0",
+      "released_on": "2018-06-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.36.0",
+      "released_on": "2018-05-09",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.35.1",
+      "released_on": "2018-04-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.35.0",
+      "released_on": "2018-04-05",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.34.1",
+      "released_on": "2018-03-23",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.34.0",
+      "released_on": "2018-03-22",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.33.3",
+      "released_on": "2018-03-21",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.33.2",
+      "released_on": "2018-02-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.33.1",
+      "released_on": "2018-02-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.33.0",
+      "released_on": "2018-02-23",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.32.0",
+      "released_on": "2018-02-21",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.31.0",
+      "released_on": "2018-02-13",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.30.0",
+      "released_on": "2018-02-13",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.29.0",
+      "released_on": "2018-02-08",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.28.0",
+      "released_on": "2018-01-02",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.27.0",
+      "released_on": "2017-12-22",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.26.0",
+      "released_on": "2017-12-18",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.25.0",
+      "released_on": "2017-12-06",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.24.0",
+      "released_on": "2017-11-28",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.23.1",
+      "released_on": "2017-11-09",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.23.0",
+      "released_on": "2017-10-31",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.22.1",
+      "released_on": "2017-10-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.22.0",
+      "released_on": "2017-10-27",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.21.0",
+      "released_on": "2017-10-09",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.10.0",
+      "released_on": "2017-10-04",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.9.1",
+      "released_on": "2017-10-03",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.9.0",
+      "released_on": "2017-09-25",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.8.0",
+      "released_on": "2017-08-31",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.7.1",
+      "released_on": "2017-07-11",
+      "minimum_runtime_version": "1.7"
+    },
+    {
+      "version": "5.7.0",
+      "released_on": "2017-07-11",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.6.0",
+      "released_on": "2017-06-27",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.5.0",
+      "released_on": "2017-06-23",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.4.0",
+      "released_on": "2017-06-19",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.3.0",
+      "released_on": "2017-06-14",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.2.0",
+      "released_on": "2017-06-09",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.1.0",
+      "released_on": "2017-06-07",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "5.0.0",
+      "released_on": "2017-05-31",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.9.1",
+      "released_on": "2017-05-30",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.9.0",
+      "released_on": "2017-05-25",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.8.0",
+      "released_on": "2017-05-25",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.7.0",
+      "released_on": "2017-05-02",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.6.0",
+      "released_on": "2017-04-28",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.5.0",
+      "released_on": "2017-04-28",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.4.0",
+      "released_on": "2017-04-24",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.3.0",
+      "released_on": "2017-04-12",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.2.0",
+      "released_on": "2017-04-06",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.1.0",
+      "released_on": "2017-04-04",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "4.0.0",
+      "released_on": "2017-03-13",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.11.0",
+      "released_on": "2017-02-22",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.10.2",
+      "released_on": "2017-02-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.10.1",
+      "released_on": "2017-02-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.10.0",
+      "released_on": "2017-02-13",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.9.0",
+      "released_on": "2017-02-02",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.8.0",
+      "released_on": "2017-01-23",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.7.0",
+      "released_on": "2017-01-06",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.6.0",
+      "released_on": "2017-01-03",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.5.0",
+      "released_on": "2016-12-08",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.4.0",
+      "released_on": "2016-12-08",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.3.0",
+      "released_on": "2016-11-22",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.2.0",
+      "released_on": "2016-10-18",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.1.0",
+      "released_on": "2016-10-18",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "3.0.0",
+      "released_on": "2016-10-17",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.10.2",
+      "released_on": "2016-10-13",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.10.1",
+      "released_on": "2016-10-06",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.10.0",
+      "released_on": "2016-09-16",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.9.0",
+      "released_on": "2016-09-07",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.8.0",
+      "released_on": "2016-08-05",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.7.0",
+      "released_on": "2016-07-12",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.6.1",
+      "released_on": "2016-06-13",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.6.0",
+      "released_on": "2016-05-25",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.5.1",
+      "released_on": "2016-05-23",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.5.0",
+      "released_on": "2016-05-04",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.4.0",
+      "released_on": "2016-04-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.3.0",
+      "released_on": "2016-04-18",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.2.0",
+      "released_on": "2016-04-12",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.1.0",
+      "released_on": "2016-04-12",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "2.0.0",
+      "released_on": "2016-04-08",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.48.0",
+      "released_on": "2016-03-29",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.47.0",
+      "released_on": "2016-03-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.46.0",
+      "released_on": "2016-03-15",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.45.0",
+      "released_on": "2016-02-18",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.44.0",
+      "released_on": "2016-02-11",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.43.0",
+      "released_on": "2016-01-26",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.42.0",
+      "released_on": "2016-01-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.41.1",
+      "released_on": "2016-01-15",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.41.0",
+      "released_on": "2016-01-13",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.40.1",
+      "released_on": "2016-01-07",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.40.0",
+      "released_on": "2015-12-03",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.39.0",
+      "released_on": "2015-12-01",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.38.1",
+      "released_on": "2015-11-30",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.38.0",
+      "released_on": "2015-10-27",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.37.1",
+      "released_on": "2015-10-07",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.37.0",
+      "released_on": "2015-09-14",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.36.0",
+      "released_on": "2015-09-11",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.35.0",
+      "released_on": "2015-08-31",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.34.0",
+      "released_on": "2015-08-17",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.33.0",
+      "released_on": "2015-08-03",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.32.1",
+      "released_on": "2015-07-24",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.32.0",
+      "released_on": "2015-07-06",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.31.0",
+      "released_on": "2015-06-01",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.30.0",
+      "released_on": "2015-05-28",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.29.0",
+      "released_on": "2015-05-21",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.28.0",
+      "released_on": "2015-05-08",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.27.1",
+      "released_on": "2015-03-30",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.27.0",
+      "released_on": "2015-03-19",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.26.0",
+      "released_on": "2015-02-19",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.25.1",
+      "released_on": "2015-01-23",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.25.0",
+      "released_on": "2015-01-22",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.24.1",
+      "released_on": "2015-01-05",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.24.0",
+      "released_on": "2014-12-23",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.23.0",
+      "released_on": "2014-12-08",
+      "minimum_runtime_version": "1.6"
+    },
+    {
+      "version": "1.22.0",
+      "released_on": "2014-12-03",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.21.0",
+      "released_on": "2014-11-14",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.20.0",
+      "released_on": "2014-11-06",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.19.1",
+      "released_on": "2014-10-02",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.19.0",
+      "released_on": "2014-09-29",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.18.0",
+      "released_on": "2014-08-25",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.17.0",
+      "released_on": "2014-08-19",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.16.0",
+      "released_on": "2014-07-29",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.15.1",
+      "released_on": "2014-06-25",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.15.0",
+      "released_on": "2014-06-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.14.1",
+      "released_on": "2014-06-04",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.14.0",
+      "released_on": "2014-05-28",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.13.1",
+      "released_on": "2014-05-23",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.13.0",
+      "released_on": "2014-05-21",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.12.0",
+      "released_on": "2014-04-09",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.11.0",
+      "released_on": "2014-04-07",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.10.0",
+      "released_on": "2014-03-28",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.9.0",
+      "released_on": "2014-03-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.8.0",
+      "released_on": "2014-03-12",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.7.2",
+      "released_on": "2014-02-27",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.7.1",
+      "released_on": "2014-01-31",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.7.0",
+      "released_on": "2014-01-29",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.6.5",
+      "released_on": "2014-01-22",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.6.4",
+      "released_on": "2014-01-16",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.6.3",
+      "released_on": "2014-01-13",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.6.2",
+      "released_on": "2014-01-08",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.6.1",
+      "released_on": "2013-12-04",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.5.1",
+      "released_on": "2013-10-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.5.0",
+      "released_on": "2013-10-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.4.3",
+      "released_on": "2013-09-18",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.4.2",
+      "released_on": "2013-09-18",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.4.1",
+      "released_on": "2013-09-04",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.4.0",
+      "released_on": "2013-09-03",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.3.2",
+      "released_on": "2013-08-30",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.3.1",
+      "released_on": "2013-08-21",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.3.0",
+      "released_on": "2013-08-19",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.8",
+      "released_on": "2013-08-12",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.7",
+      "released_on": "2013-07-31",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.6",
+      "released_on": "2013-07-30",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.5",
+      "released_on": "2013-07-15",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.4",
+      "released_on": "2013-06-22",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.3",
+      "released_on": "2013-05-07"
+    },
+    {
+      "version": "1.2.2",
+      "released_on": "2013-04-25",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.1",
+      "released_on": "2013-04-20",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.2.0",
+      "released_on": "2013-04-20",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.18",
+      "released_on": "2013-03-18",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.17",
+      "released_on": "2013-02-18",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.16",
+      "released_on": "2013-02-15",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.15",
+      "released_on": "2013-02-01",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.14",
+      "released_on": "2013-01-15",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.13",
+      "released_on": "2012-12-29",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.12",
+      "released_on": "2012-12-24",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.11",
+      "released_on": "2012-11-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.10",
+      "released_on": "2012-11-15",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.9",
+      "released_on": "2012-11-08",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.8",
+      "released_on": "2012-10-30",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.7",
+      "released_on": "2012-10-24",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.6",
+      "released_on": "2012-10-15",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.5",
+      "released_on": "2012-09-26",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.4",
+      "released_on": "2012-08-31",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.3",
+      "released_on": "2012-08-17",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.2",
+      "released_on": "2012-08-06",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.1",
+      "released_on": "2012-05-24",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.1.0",
+      "released_on": "2012-05-16",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.16",
+      "released_on": "2012-05-09",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.15",
+      "released_on": "2012-04-11",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.14",
+      "released_on": "2012-03-16",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.13",
+      "released_on": "2012-03-02",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.12",
+      "released_on": "2012-01-30",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.11",
+      "released_on": "2012-01-20",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.9",
+      "released_on": "2011-12-13",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.8",
+      "released_on": "2011-12-11",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.7",
+      "released_on": "2011-11-29",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.6",
+      "released_on": "2011-11-23",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.5",
+      "released_on": "2011-11-20",
+      "minimum_runtime_version": "1.5"
+    },
+    {
+      "version": "1.0.4",
+      "released_on": "2011-11-11"
+    },
+    {
+      "version": "1.0.3",
+      "released_on": "2011-11-03"
+    },
+    {
+      "version": "1.0.2",
+      "released_on": "2011-10-27"
+    },
+    {
+      "version": "1.0.1",
+      "released_on": "2011-10-14"
+    },
+    {
+      "version": "1.0.0",
+      "released_on": "2011-10-09"
+    }
+  ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 73998caa708..5ef8dc85ad8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,21 +1,25 @@
+<!--
+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
 
-## 33.4.2 - 2026-09-09
+## <a id="33-4-2"></a>33.4.2 - 2026-09-09
 * [#2286](https://github.com/stripe/stripe-java/pull/2286) Validate that webhook secrets are non-empty
 
-## 33.4.1 - 2026-09-01
+## <a id="33-4-1"></a>33.4.1 - 2026-09-01
 * [#2284](https://github.com/stripe/stripe-java/pull/2284) Harden API requestor code against malicious URLs
 
-## 33.4.0 - 2026-08-26
-This release changes the pinned API version to 2026-08-26.dahlia.
+## <a id="33-4-0"></a>33.4.0 - 2026-08-26
+This release changes the pinned API version to `2026-08-26.dahlia`.
 
 * [#2269](https://github.com/stripe/stripe-java/pull/2269) 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
-* [#2262](https://github.com/stripe/stripe-java/pull/2262) Update generated code
+* ⚠️ [#2262](https://github.com/stripe/stripe-java/pull/2262) Update generated code
   * Add support for new resource `billing.FeedbackOption`
   * Add support for `create`, `deactivate`, `list`, `retrieve`, and `update` methods on resource `billing.FeedbackOption`
   * Add support for `paymentMethodSettings` on `AccountSession.components` and `AccountSessionCreateParams.components`
@@ -37,20 +41,19 @@ This release changes the pinned API version to 2026-08-26.dahlia.
   * Add support for `igic` on `tax.Registration.country_options.at`, `tax.Registration.country_options.be`, `tax.Registration.country_options.bg`, `tax.Registration.country_options.cy`, `tax.Registration.country_options.cz`, `tax.Registration.country_options.de`, `tax.Registration.country_options.dk`, `tax.Registration.country_options.ee`, `tax.Registration.country_options.es`, `tax.Registration.country_options.fi`, `tax.Registration.country_options.fr`, `tax.Registration.country_options.gr`, `tax.Registration.country_options.hr`, `tax.Registration.country_options.hu`, `tax.Registration.country_options.ie`, `tax.Registration.country_options.it`, `tax.Registration.country_options.lt`, `tax.Registration.country_options.lu`, `tax.Registration.country_options.lv`, `tax.Registration.country_options.mt`, `tax.Registration.country_options.nl`, `tax.Registration.country_options.pl`, `tax.Registration.country_options.pt`, `tax.Registration.country_options.ro`, `tax.Registration.country_options.se`, `tax.Registration.country_options.si`, `tax.Registration.country_options.sk`, `tax.RegistrationCreateParams.country_options.at`, `tax.RegistrationCreateParams.country_options.be`, `tax.RegistrationCreateParams.country_options.bg`, `tax.RegistrationCreateParams.country_options.cy`, `tax.RegistrationCreateParams.country_options.cz`, `tax.RegistrationCreateParams.country_options.de`, `tax.RegistrationCreateParams.country_options.dk`, `tax.RegistrationCreateParams.country_options.ee`, `tax.RegistrationCreateParams.country_options.es`, `tax.RegistrationCreateParams.country_options.fi`, `tax.RegistrationCreateParams.country_options.fr`, `tax.RegistrationCreateParams.country_options.gr`, `tax.RegistrationCreateParams.country_options.hr`, `tax.RegistrationCreateParams.country_options.hu`, `tax.RegistrationCreateParams.country_options.ie`, `tax.RegistrationCreateParams.country_options.it`, `tax.RegistrationCreateParams.country_options.lt`, `tax.RegistrationCreateParams.country_options.lu`, `tax.RegistrationCreateParams.country_options.lv`, `tax.RegistrationCreateParams.country_options.mt`, `tax.RegistrationCreateParams.country_options.nl`, `tax.RegistrationCreateParams.country_options.pl`, `tax.RegistrationCreateParams.country_options.pt`, `tax.RegistrationCreateParams.country_options.ro`, `tax.RegistrationCreateParams.country_options.se`, `tax.RegistrationCreateParams.country_options.si`, and `tax.RegistrationCreateParams.country_options.sk`
   * Add support for new value `2026-08-26.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
 
-## 33.3.0 - 2026-08-10
-* [#2265](https://github.com/stripe/stripe-java/pull/2265) Surface `object` property on `EventNotification`
+## <a id="33-3-0"></a>33.3.0 - 2026-08-10
+* [#2261](https://github.com/stripe/stripe-java/pull/2261) Add `stripe.major_api_version` constant
+* [#2263](https://github.com/stripe/stripe-java/pull/2263) add stripeobject deserialization helper for JsonObject
 * [#2256](https://github.com/stripe/stripe-java/pull/2256) 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.constructEventWithoutVerification(payload)`
     - `StripeClient.constructEventWithoutVerification(payload)`
     - `StripeClient.parseEventNotificationWithoutVerification(payload)`
   - Added `Webhook.Signature.generateSignatureHeader(payload, secret)`, which computes a full `Stripe-Signature` header for the given payload. Useful for unit tests!
-* [#2263](https://github.com/stripe/stripe-java/pull/2263) add stripeobject deserialization helper for JsonObject
-* [#2261](https://github.com/stripe/stripe-java/pull/2261) Add `stripe.major_api_version` constant
+* [#2265](https://github.com/stripe/stripe-java/pull/2265) Surface `object` property on `EventNotification`
 
-## 33.2.0 - 2026-07-29
-This release changes the pinned API version to 2026-07-29.dahlia.
+## <a id="33-2-0"></a>33.2.0 - 2026-07-29
+This release changes the pinned API version to `2026-07-29.dahlia`.
 
 * [#2257](https://github.com/stripe/stripe-java/pull/2257) Update generated code
   * Add support for new resource `financialconnections.Authorization`
@@ -89,13 +92,13 @@ 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 `financialconnections.Account`
   * Add support for snapshot events `financial_connections.authorization.expected_deactivation_date_updated` and `financial_connections.authorization.upcoming_deactivation` with resource `financialconnections.Authorization`
 
-## 33.1.1 - 2026-07-15
+## <a id="33-1-1"></a>33.1.1 - 2026-07-15
 * [#2244](https://github.com/stripe/stripe-java/pull/2244) Replace source hash with Telemetry UUID
 
-## 33.1.0 - 2026-06-24
-This release changes the pinned API version to 2026-06-24.dahlia.
+## <a id="33-1-0"></a>33.1.0 - 2026-06-24
+This release changes the pinned API version to `2026-06-24.dahlia`.
 
-* [#2240](https://github.com/stripe/stripe-java/pull/2240) Update generated code
+* ⚠️ [#2240](https://github.com/stripe/stripe-java/pull/2240) Update generated code
   * Add support for `releaseDetails` on `reserve.Hold`
   * Add support for `buyerId` on `Charge.payment_method_details.bizum`, `ConfirmationToken.payment_method_preview.bizum`, `ConfirmationToken.payment_method_preview.blik`, `PaymentAttemptRecord.payment_method_details.bizum`, `PaymentMethod.bizum`, `PaymentMethod.blik`, and `PaymentRecord.payment_method_details.bizum`
   * Add support for `transactionLinkId` on `Charge.payment_method_details.card`
@@ -120,19 +123,20 @@ This release changes the pinned API version to 2026-06-24.dahlia.
   * Add support for new value `promotion` on enum `v2.commerce.ProductCatalogImportCreateParams.feedType`
   * Add support for new value `sunbit_payments` on enum `EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updatedCapability`
 
-## 33.0.0 - 2026-06-05
-
+## <a id="33-0-0"></a>33.0.0 - 2026-06-05
 This release **doesn't** change the pinned API version; it still uses `2026-05-27.dahlia`.
 
 We're doing an out-of-band-major to update a field type that changed. If you're not using `tax_details`, this is a no-op release when compared with the last one. If you _are_ using `tax_details` its type has changed slightly and you'll have to update your code when upgrading.
 
-* [#2234](https://github.com/stripe/stripe-java/pull/2234) ⚠️ Make `tax_rate.tax_details` expandable
 * [#2230](https://github.com/stripe/stripe-java/pull/2230) Add "source" field to user-agent header
+* ⚠️ [#2234](https://github.com/stripe/stripe-java/pull/2234) Make `tax_rate.tax_details` expandable
 
-## 32.2.0 - 2026-05-27
-This release changes the pinned API version to 2026-05-27.dahlia.
+## <a id="32-2-0"></a>32.2.0 - 2026-05-27
+This release changes the pinned API version to `2026-05-27.dahlia`.
 
-* [#2220](https://github.com/stripe/stripe-java/pull/2220) Update generated code
+* [#2218](https://github.com/stripe/stripe-java/pull/2218) Add better example for accessing non-documented properties in a list response
+* [#2219](https://github.com/stripe/stripe-java/pull/2219) Emit warning when `stripe-notify` header is present in response
+* ⚠️ [#2220](https://github.com/stripe/stripe-java/pull/2220) 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 `bizumPayments` and `scalapayPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
@@ -173,13 +177,13 @@ This release changes the pinned API version to 2026-05-27.dahlia.
   * 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.error_types[].code` and `EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code`
   * Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `v2.commerce.ProductCatalogImport`
-* [#2219](https://github.com/stripe/stripe-java/pull/2219) Emit warning when `stripe-notify` header is present in response
-* [#2218](https://github.com/stripe/stripe-java/pull/2218) Add better example for accessing non-documented properties in a list response
 
-## 32.1.0 - 2026-04-23
-This release changes the pinned API version to 2026-04-22.dahlia.
+## <a id="32-1-0"></a>32.1.0 - 2026-04-23
+This release changes the pinned API version to `2026-04-22.dahlia`.
 
-* [#2203](https://github.com/stripe/stripe-java/pull/2203) Update generated code
+* [#2208](https://github.com/stripe/stripe-java/pull/2208) Fix missing stripeContext in RequestOptions.toBuilderFullCopy()
+  - Fixes a bug where an existing `stripeContext` was being reset to `null` when calling `RequestOptions#toBuilderFullCopy()`
+* ⚠️ [#2203](https://github.com/stripe/stripe-java/pull/2203) Update generated code
   * Add support for `balanceReport` and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `appDistribution` and `sunbitPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `sunbit` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
@@ -207,37 +211,34 @@ This release changes the pinned API version to 2026-04-22.dahlia.
   * Add support for `moto` on `SetupAttempt.payment_method_details.card`
   * Add support for `pixDisplayQrCode` on `SetupIntent.next_action`
   * Add support for new value `2026-04-22.dahlia` on enum `WebhookEndpointCreateParams.apiVersion`
-* [#2208](https://github.com/stripe/stripe-java/pull/2208) Fix missing stripeContext in RequestOptions.toBuilderFullCopy()
-  - Fixes a bug where an existing `stripeContext` was being reset to `null` when calling `RequestOptions#toBuilderFullCopy()`
 
-## 32.0.0 - 2026-03-25
+## <a id="32-0-0"></a>32.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-java/wiki/Migration-guide-for-v32) 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-java/wiki/Migration-guide-for-v32) 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:** [#2182](https://github.com/stripe/stripe-java/pull/2182) Add setHttpClient to StripeClientBuilder; clean up apiKey/authenticator coupling
+* [#2179](https://github.com/stripe/stripe-java/pull/2179) Add runtime support for V2 int64 string-encoded fields
+* ⚠️ [#2181](https://github.com/stripe/stripe-java/pull/2181) Change Automatic-Module-Name to com.stripe
+  - Changes `Automatic-Module-Name` from `stripe.java` to `com.stripe`. Users with `requires stripe.java;` in their `module-info.java` will need to update to `requires com.stripe;`.
+* ⚠️ [#2182](https://github.com/stripe/stripe-java/pull/2182) Add setHttpClient to StripeClientBuilder; clean up apiKey/authenticator coupling
   - ⚠️ Removed `RequestOptions.getApiKey()`, `RequestOptions.RequestOptionsBuilder.getApiKey()`, and `StripeClient.StripeClientBuilder.getApiKey()`. Use `getAuthenticator()` instead.
   - Added `StripeClient.StripeClientBuilder.setHttpClient(HttpClient)` to allow injecting a custom HTTP client.
-* ⚠️ **Breaking change:** [#2187](https://github.com/stripe/stripe-java/pull/2187) Regenerate with decimal_string enabled for v2 APIs
+* ⚠️ [#2172](https://github.com/stripe/stripe-java/pull/2172) Make `RequestOptions` & `RawRequestOptions` constructors private and add Stripe-Request-Trigger header
+* ⚠️ [#2187](https://github.com/stripe/stripe-java/pull/2187) Regenerate with decimal_string enabled for v2 APIs
   - V2 API decimal fields changed type from `String` to `BigDecimal`. Code that reads or writes these fields as `String` will need to use `BigDecimal` instead. Affected fields:
     - **V2.Core.Account** / **V2.Core.AccountPerson**: `percentOwnership`
     - **PaymentEvaluation.Signals.FraudulentPayment**: `score`
     - Params: `AccountCreateParams`, `PersonCreateParams`, `AccountTokenCreateParams`, `PersonTokenCreateParams` (all: `percentOwnership`)
     - Params: `InvoiceItemCreateParams`, `InvoiceAddLinesParams`, `InvoiceUpdateLinesParams`, `InvoiceCreatePreviewParams` (all: `quantityDecimal`)
-* ⚠️ **Breaking change:** [#2131](https://github.com/stripe/stripe-java/pull/2131) Use HTTP status code in V2 errors
+* ⚠️ [#2190](https://github.com/stripe/stripe-java/pull/2190) Throw an error when using the wrong webhook parsing method
+* ⚠️ [#2131](https://github.com/stripe/stripe-java/pull/2131) Use HTTP status code in V2 errors
   - `RateLimitException` now extends `StripeException` rather than `ApiException`
   - Non-200 status codes from V2 endpoints will throw a `StripeException` (e.g. `RateLimitException`, `InvalidRequestException`, etc.) like in V1 instead of a generic `ApiException`
-* ⚠️ **Breaking change:** [#2190](https://github.com/stripe/stripe-java/pull/2190) Throw an error when using the wrong webhook parsing method
-* ⚠️ **Breaking change:** [#2172](https://github.com/stripe/stripe-java/pull/2172) Make `RequestOptions` & `RawRequestOptions` constructors private and add Stripe-Request-Trigger header
-* ⚠️ **Breaking change:** [#2181](https://github.com/stripe/stripe-java/pull/2181) Change Automatic-Module-Name to com.stripe
-  - Changes `Automatic-Module-Name` from `stripe.java` to `com.stripe`. Users with `requires stripe.java;` in their `module-info.java` will need to update to `requires com.stripe;`.
-* [#2179](https://github.com/stripe/stripe-java/pull/2179) Add runtime support for V2 int64 string-encoded fields
-
 
 ### ⚠️ Breaking changes due to changes in the Stripe API
-
-* Generated changes from [#2170](https://github.com/stripe/stripe-java/pull/2170), [#2193](https://github.com/stripe/stripe-java/pull/2193), [#2191](https://github.com/stripe/stripe-java/pull/2191)
+* ⚠️ Generated changes from [#2170](https://github.com/stripe/stripe-java/pull/2170), [#2193](https://github.com/stripe/stripe-java/pull/2193), [#2191](https://github.com/stripe/stripe-java/pull/2191)
   * Add support for `upiPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `upi` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `Mandate.payment_method_details`, `PaymentAttemptRecord.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord.payment_method_details`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, `SetupIntentUpdateParams.payment_method_options`, `checkout.Session.payment_method_options`, and `checkout.SessionCreateParams.payment_method_options`
   * Add support for `integrationIdentifier` on `checkout.SessionCreateParams` and `checkout.Session`
@@ -262,12 +263,12 @@ 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.apiVersion`
   * ⚠️ Change type of `v2.core.EventDestinationCreateParams.eventsFrom` from `enum('other_accounts'|'self')` to `string`
 
-## 31.4.1 - 2026-03-06
+## <a id="31-4-1"></a>31.4.1 - 2026-03-06
+* [#2165](https://github.com/stripe/stripe-java/pull/2165) Add AI Agent information to UserAgent
 * [#2168](https://github.com/stripe/stripe-java/pull/2168) Support serializing Stripe objects with ApiResource.GSON
   * `ApiResource.GSON` now supports serializing Stripe objects back into compatible JSON
-* [#2165](https://github.com/stripe/stripe-java/pull/2165) Add AI Agent information to UserAgent
 
-## 31.4.0 - 2026-02-25
+## <a id="31-4-0"></a>31.4.0 - 2026-02-25
 This release changes the pinned API version to `2026-02-25.clover`.
 
 * [#2158](https://github.com/stripe/stripe-java/pull/2158) Update generated code
@@ -291,7 +292,7 @@ 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`
 
-## 31.3.0 - 2026-01-28
+## <a id="31-3-0"></a>31.3.0 - 2026-01-28
 This release changes the pinned API version to `2026-01-28.clover`.
 
 * [#2147](https://github.com/stripe/stripe-java/pull/2147) Update generated code
@@ -309,15 +310,17 @@ This release changes the pinned API version to `2026-01-28.clover`.
   * Add support for `registrationDate` on `v2.core.Account.identity.business_details`, `v2.core.AccountCreateParams.identity.business_details`, `v2.core.AccountTokenCreateParams.identity.business_details`, and `v2.core.AccountUpdateParams.identity.business_details`
   * Add support for new value `gb_vat` on enums `v2.core.AccountCreateParams.identity.business_details.id_numbers[].type`, `v2.core.AccountTokenCreateParams.identity.business_details.id_numbers[].type`, and `v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type`
 
-## 31.2.0 - 2026-01-16
+## <a id="31-2-0"></a>31.2.0 - 2026-01-16
 * [#2144](https://github.com/stripe/stripe-java/pull/2144) 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`
 
-## 31.1.0 - 2025-12-16
+## <a id="31-1-0"></a>31.1.0 - 2025-12-16
 This release changes the pinned API version to `2025-12-15.clover`.
 
+* [#2121](https://github.com/stripe/stripe-java/pull/2121) Adds `Automatic-Module-Name: stripe.java` to the jar's manifest entry
+* [#2124](https://github.com/stripe/stripe-java/pull/2124) Adds the Gson version included at runtime to the X-STRIPE-CLIENT-USER-AGENT header hash
 * [#2126](https://github.com/stripe/stripe-java/pull/2126) 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`
@@ -349,14 +352,10 @@ This release changes the pinned API version to `2025-12-15.clover`.
   * Add support for `reportedBy` on `PaymentRecord`
   * Add support for new values `2025-12-15.clover` and `2026-01-28.clover` on enum `WebhookEndpointCreateParams.apiVersion`
   * Add support for `changes` on `v2.core.Event`
-* [#2124](https://github.com/stripe/stripe-java/pull/2124) Adds the Gson version included at runtime to the X-STRIPE-CLIENT-USER-AGENT header hash
-* [#2121](https://github.com/stripe/stripe-java/pull/2121) Adds `Automatic-Module-Name: stripe.java` to the jar's manifest entry
 
-## 31.0.0 - 2025-11-18
+## <a id="31-0-0"></a>31.0.0 - 2025-11-18
 This release changes the pinned API version to `2025-11-17.clover`.
 
-* [#2113](https://github.com/stripe/stripe-java/pull/2113) Update generated code
-  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `v2.core.EventListParams` in favor of `created`.
 * [#2110](https://github.com/stripe/stripe-java/pull/2110) 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.
   - The `arraysAsRepeated` parameter was removed from the internal-use-only method `FormEncoder#createQueryString`
@@ -375,17 +374,16 @@ This release changes the pinned API version to `2025-11-17.clover`.
   * Add support for `mbWay` and `twint` on `Refund.destination_details`
   * Add support for new values `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
   * Add support for snapshot events `financial_connections.account.account_numbers_updated` and `financial_connections.account.upcoming_account_number_expiry` with resource `financialconnections.Account`
+* ⚠️ [#2113](https://github.com/stripe/stripe-java/pull/2113) Update generated code
+  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `v2.core.EventListParams` in favor of `created`.
 
-## 30.2.0 - 2025-11-05
+## <a id="30-2-0"></a>30.2.0 - 2025-11-05
 * [#2102](https://github.com/stripe/stripe-java/pull/2102) Update generated code
   * Add support for `captureMethod` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
 
-## 30.1.0 - 2025-10-29
-
+## <a id="30-1-0"></a>30.1.0 - 2025-10-29
 This release changes the pinned API version to `2025-10-29.clover`.
 
-* [#2093](https://github.com/stripe/stripe-java/pull/2093) Update generated code
-  * Improve docs for PaymentIntent related endpoints
 * [#2086](https://github.com/stripe/stripe-java/pull/2086) Update generated code
   * Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
   * Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
@@ -424,29 +422,37 @@ This release changes the pinned API version to `2025-10-29.clover`.
   * Change `v2.core.EventListParams.objectId` 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`
+* [#2093](https://github.com/stripe/stripe-java/pull/2093) Update generated code
+  * Improve docs for PaymentIntent related endpoints
+
+## <a id="30-0-0"></a>30.0.0 - 2025-09-30
+This release changes the pinned API version to `2025-09-30.clover`.
 
-## 30.0.0 - 2025-09-30
-This release changes the pinned API version to `2025-09-30.clover` and contains breaking changes (prefixed with ⚠️ below)
+This release contains breaking changes (prefixed with ⚠️ below)
 
-* [#2036](https://github.com/stripe/stripe-java/pull/2036) ⚠️ Add strongly typed EventNotifications
+* ⚠️ [#2037](https://github.com/stripe/stripe-java/pull/2037) Fix type bounds on request
+  * ⚠️ Changes the signature of `LiveResponseGetter#request`, `ApiService#request`, and `StripeResponseGetter#request` to return `<T extends StripeObject>` instead of `<T extends StripeObjectInterface>`. This only affects advanced use cases where users are extending `StripeObjectInterface` with their own objects to deserialize Stripe responses. Those objects will now need to extend `StripeObject`.
+* ⚠️ [#2039](https://github.com/stripe/stripe-java/pull/2039) 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.
+  - ⚠️ Query params on v2 APIs (like `limit`) are now `Long` instead of `Integer` (to match v1 APIs)
+  - ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Map<String, Object>`. Because there were no params, it's unlikely you were using these classes.
+* ⚠️ [#2041](https://github.com/stripe/stripe-java/pull/2041) Throw `ApiKeyMissingException` instead of `IllegalArgumentException` for unset API keys
+  - ⚠️ throw `ApiKeyMissingException` instead of `IllegalArgumentException` when making a request before setting an API key initializing a client without an API key. Tweak the wording of that message to better indicate how to fix.
+* ⚠️ [#2046](https://github.com/stripe/stripe-java/pull/2046) Adds v2 support to RateLimitException
+  * ⚠️ The base class of `RateLimitException` has been changed from `InvalidRequestException` to `ApiException`.  There is no change to the public interface for the `RateLimitException` class.
+* ⚠️ [#2036](https://github.com/stripe/stripe-java/pull/2036) 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 `fetchEvent()` method to retrieve its corresponding event. For events with related objects, there's a `fetchRelatedObject()` method that performs the API call and casts the response to the correct type.
   - ⚠️ Rename function `StripeClient.parseThinEvent` to `StripeClient.parseEventNotification` 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 `relatedObject` property and a `fetchRelatedObject()` function. They also have a `fetchEvent()` method to retrieve their corresponding `Stripe.Event.*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`)
-* [#2069](https://github.com/stripe/stripe-java/pull/2069) Move `V2.Event` API resources to `V2.Core.Events`
+* ⚠️ [#2057](https://github.com/stripe/stripe-java/pull/2057) Add `StripeContext` object
+  - Add the `StripeContext` class. Previously, you could set the stripe context only as a string via `StripeClientBuilder .setStripeContext()`. The same method can now take an instance of the `StripeContext` class as well
+  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
+* ⚠️ [#2069](https://github.com/stripe/stripe-java/pull/2069) Move `V2.Event` API resources to `V2.Core.Events`
   - ⚠️ Move the below event related classes from `com.stripe.model.v2` to `com.stripe.model.v2.core`. This enables us to correctly match the API path to the namespace
        - `com.stripe.model.v2.Event` -> `com.stripe.model.v2.core.Event`
        - `com.stripe.model.v2.EventDestination` -> `com.stripe.model.v2.core.EventDestination`
-* [#2057](https://github.com/stripe/stripe-java/pull/2057) Add `StripeContext` object
-  - Add the `StripeContext` class. Previously, you could set the stripe context only as a string via `StripeClientBuilder .setStripeContext()`. The same method can now take an instance of the `StripeContext` class as well
-  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
-* [#2041](https://github.com/stripe/stripe-java/pull/2041) Throw `ApiKeyMissingException` instead of `IllegalArgumentException` for unset API keys
-  - ⚠️ throw `ApiKeyMissingException` instead of `IllegalArgumentException` when making a request before setting an API key initializing a client without an API key. Tweak the wording of that message to better indicate how to fix.
-* [#2039](https://github.com/stripe/stripe-java/pull/2039) ⚠️ 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.
-  - ⚠️ Query params on v2 APIs (like `limit`) are now `Long` instead of `Integer` (to match v1 APIs)
-  - ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `Map<String, Object>`. Because there were no params, it's unlikely you were using these classes.
 * ⚠️ 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-java/releases/tag/v29.5.0). Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.
   ```diff
   StripeClient client = new StripeClient("sk_test...")
@@ -456,12 +462,7 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   + client.v1().customers().list()
   ```
   Refer to the [migration guide](https://github.com/stripe/stripe-java/wiki/v1-namespace-in-StripeClient) for help upgrading.
-* [#2046](https://github.com/stripe/stripe-java/pull/2046) Adds v2 support to RateLimitException
-  * ⚠️ The base class of `RateLimitException` has been changed from `InvalidRequestException` to `ApiException`.  There is no change to the public interface for the `RateLimitException` class.
-* [#2037](https://github.com/stripe/stripe-java/pull/2037) Fix type bounds on request
-  * ⚠️ Changes the signature of `LiveResponseGetter#request`, `ApiService#request`, and `StripeResponseGetter#request` to return `<T extends StripeObject>` instead of `<T extends StripeObjectInterface>`. This only affects advanced use cases where users are extending `StripeObjectInterface` with their own objects to deserialize Stripe responses. Those objects will now need to extend `StripeObject`.
-
-* [#2040](https://github.com/stripe/stripe-java/pull/2040), [#2058](https://github.com/stripe/stripe-java/pull/2058), [#2059](https://github.com/stripe/stripe-java/pull/2059), [#2073](https://github.com/stripe/stripe-java/pull/2073) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
+* ⚠️ [#2040](https://github.com/stripe/stripe-java/pull/2040) , [#2058](https://github.com/stripe/stripe-java/pull/2058), [#2059](https://github.com/stripe/stripe-java/pull/2059), [#2073](https://github.com/stripe/stripe-java/pull/2073) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
   * ⚠️ Remove support for `balanceReport` and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * ⚠️ Change type of `InvoiceCreatePreviewParams.subscription_details.cancelAt`, `SubscriptionCreateParams.cancelAt` and `SubscriptionUpdateParams.cancelAt` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
   * ⚠️ Remove support for values `saturday` and `sunday` from enums `AccountCreateParams.settings.payouts.schedule.weeklyPayoutDays` and `AccountUpdateParams.settings.payouts.schedule.weeklyPayoutDays`
@@ -498,9 +499,21 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Change `terminal.LocationCreateParams.displayName` to be optional
   * Add support for new value `2025-09-30.clover` on enum `WebhookEndpointCreateParams.apiVersion`
 
-## 29.5.0 - 2025-08-27
+## <a id="29-5-0"></a>29.5.0 - 2025-08-27
+This release changes the pinned API version to `2025-08-27.basil`.
+
+* [#2032](https://github.com/stripe/stripe-java/pull/2032) 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
+  StripeClient client = new 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-java/wiki/v1-namespace-in-StripeClient) for help upgrading.
 * [#2034](https://github.com/stripe/stripe-java/pull/2034) Add section on private preview SDKs in readme
-* [#2030](https://github.com/stripe/stripe-java/pull/2030) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+* [#2030](https://github.com/stripe/stripe-java/pull/2030) Update generated code.
   * Add support for `balanceReport`, `payoutDetails`, and `payoutReconciliationReport` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `name` on `billingportal.ConfigurationCreateParams`, `billingportal.ConfigurationUpdateParams`, and `billingportal.Configuration`
   * Add support for `installments` on `Charge.payment_method_details.alma`
@@ -517,19 +530,11 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `card` on `terminal.ReaderPresentPaymentMethodParams`
   * Add support for new value `card` on enum `terminal.ReaderPresentPaymentMethodParams.type`
   * Add support for new value `2025-08-27.basil` on enum `WebhookEndpointCreateParams.apiVersion`
-* [#2032](https://github.com/stripe/stripe-java/pull/2032) 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
-  StripeClient client = new 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-java/wiki/v1-namespace-in-StripeClient) for help upgrading.
+## <a id="29-4-0"></a>29.4.0 - 2025-07-30
+This release changes the pinned API version to `2025-07-30.basil`.
 
-## 29.4.0 - 2025-07-30
-* [#2027](https://github.com/stripe/stripe-java/pull/2027) Update generated code. This release changes the pinned API version to `2025-07-30.basil`.
+* [#2027](https://github.com/stripe/stripe-java/pull/2027) Update generated code.
   * Add support for `instantPayoutsPromotion` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `adjustableQuantity` on `billingportal.Configuration.features.subscription_update.products[]`, `billingportal.ConfigurationCreateParams.features.subscription_update.products[]`, and `billingportal.ConfigurationUpdateParams.features.subscription_update.products[]`
   * Add support for `transactionId` on `Charge.payment_method_details.cashapp`
@@ -546,8 +551,11 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `aed`, `bgn`, `huf`, and `ron` on `terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
   * Add support for new value `2025-07-30.basil` on enum `WebhookEndpointCreateParams.apiVersion`
 
-## 29.3.0 - 2025-07-01
-* [#2013](https://github.com/stripe/stripe-java/pull/2013) Update generated code. This release changes the pinned API version to `2025-06-30.basil`.
+## <a id="29-3-0"></a>29.3.0 - 2025-07-01
+This release changes the pinned API version to `2025-06-30.basil`.
+
+* [#1987](https://github.com/stripe/stripe-java/pull/1987) Include Java versions 21, 22, 23, 24 in CI
+* [#2013](https://github.com/stripe/stripe-java/pull/2013) 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`
   * Add support for `cryptoPayments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
@@ -575,11 +583,14 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `terminal.reader.action_updated` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
   * Add support for new value `2025-06-30.basil` on enum `WebhookEndpointCreateParams.apiVersion`
   * Add support for snapshot event `terminal.reader.action_updated` with resource `terminal.Reader`
-* [#1987](https://github.com/stripe/stripe-java/pull/1987) Include Java versions 21, 22, 23, 24 in CI
 
-## 29.2.0 - 2025-05-29
+## <a id="29-2-0"></a>29.2.0 - 2025-05-29
+This release changes the pinned API version to `2025-05-28.basil`.
 
-* [#2000](https://github.com/stripe/stripe-java/pull/2000) Update generated code. This release changes the pinned API version to `2025-05-28.basil`.
+* [#1997](https://github.com/stripe/stripe-java/pull/1997) Adds CONTRIBUTING.md
+* [#2002](https://github.com/stripe/stripe-java/pull/2002) Adds generated Customer retrievePaymentMethod overload
+  * Adds `retrievePaymentMethod` overload to `Customer` that accepts a payment method id and `RequestOptions` object
+* [#2000](https://github.com/stripe/stripe-java/pull/2000) Update generated code.
   * 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`
@@ -605,13 +616,17 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `invoice_payment.paid` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
   * Add support for new value `2025-05-28.basil` on enum `WebhookEndpointCreateParams.apiVersion`
   * Add support for snapshot event `invoice_payment.paid` with resource `InvoicePayment`
-* [#2002](https://github.com/stripe/stripe-java/pull/2002) Adds generated Customer retrievePaymentMethod overload
-  * Adds `retrievePaymentMethod` overload to `Customer` that accepts a payment method id and `RequestOptions` object
-* [#1997](https://github.com/stripe/stripe-java/pull/1997) Adds CONTRIBUTING.md
 
-## 29.1.0 - 2025-04-30
-* [#1986](https://github.com/stripe/stripe-java/pull/1986) Update generated code
+## <a id="29-1-0"></a>29.1.0 - 2025-04-30
+This release changes the pinned API version to `2025-04-30.basil`.
 
+* ⚠️ [#1971](https://github.com/stripe/stripe-java/pull/1971) require beta SDKs match event versions exactly when deserializing
+  - ⚠️ Public Preview SDKs now require an exact API version match when deserializing webhooks
+      - To deserialize events from another API version, use `EventDataObjectDeserializer .deserializeUnsafe()` instead of `.deserialize()`.
+* [#1982](https://github.com/stripe/stripe-java/pull/1982) Update readme with clarification on resource based call patterns
+* [#1976](https://github.com/stripe/stripe-java/pull/1976) backport beta fixes
+* [#1989](https://github.com/stripe/stripe-java/pull/1989) Update manual installation instructions in README.md
+* [#1986](https://github.com/stripe/stripe-java/pull/1986) Update generated code
   This release changes the pinned API version to `2025-04-30.basil`.
 
   * Add support for `minorityOwnedBusinessDesignation` on `Account.business_profile`, `AccountCreateParams.business_profile`, and `AccountUpdateParams.business_profile`
@@ -631,17 +646,16 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `pendingReason` on `Refund`
   * Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
   * Add support for new value `2025-04-30.basil` on enums `WebhookEndpointCreateParams.apiVersion`
-* [#1989](https://github.com/stripe/stripe-java/pull/1989) Update manual installation instructions in README.md
-* [#1982](https://github.com/stripe/stripe-java/pull/1982) Update readme with clarification on resource based call patterns
-* [#1976](https://github.com/stripe/stripe-java/pull/1976) backport beta fixes
-* [#1971](https://github.com/stripe/stripe-java/pull/1971) require beta SDKs match event versions exactly when deserializing
 
-  - ⚠️ Public Preview SDKs now require an exact API version match when deserializing webhooks
-      - To deserialize events from another API version, use `EventDataObjectDeserializer .deserializeUnsafe()` instead of `.deserialize()`.
+## <a id="29-0-0"></a>29.0.0 - 2025-04-01
+This release changes the pinned API version to `2025-03-31.basil`.
 
-## 29.0.0 - 2025-04-01
+* [#1955](https://github.com/stripe/stripe-java/pull/1955) Add @EqualsAndHashCode annotations
+  - Adds `@EqualsAndHashCode(callSuper = false)` to all Params objects which is useful for unit test assertions and caching scenarios.
+* ⚠️ [#1958](https://github.com/stripe/stripe-java/pull/1958) Support for StripeAccount in StripeClient, and StripeContext on V1
+  * ⚠️ Adds `getStripeAccount` to `StripeResponseGetterOptions`.  If you have a class that extends `StripeResponseGetterOptions` you will need to implement this method.
+  * Adds `setStripeAccount` to StripeClientBuilder, so you can specify the Stripe-Account header at the client (instead of the individual request) level.
 * [#1950](https://github.com/stripe/stripe-java/pull/1950) 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
@@ -714,14 +728,10 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `invoice.overpaid` on enums `WebhookEndpointCreateParams.enabledEvents` and `WebhookEndpointUpdateParams.enabledEvents`
   * Add support for new values `2025-03-01.dashboard` and `2025-03-31.basil` on enum `WebhookEndpointCreateParams.apiVersion`
 
-* [#1958](https://github.com/stripe/stripe-java/pull/1958) Support for StripeAccount in StripeClient, and StripeContext on V1
-  * ⚠️ Adds `getStripeAccount` to `StripeResponseGetterOptions`.  If you have a class that extends `StripeResponseGetterOptions` you will need to implement this method.
-  * Adds `setStripeAccount` to StripeClientBuilder, so you can specify the Stripe-Account header at the client (instead of the individual request) level.
-* [#1955](https://github.com/stripe/stripe-java/pull/1955) Add @EqualsAndHashCode annotations
-  - Adds `@EqualsAndHashCode(callSuper = false)` to all Params objects which is useful for unit test assertions and caching scenarios.
+## <a id="28-4-0"></a>28.4.0 - 2025-02-24
+This release changes the pinned API version to `2025-02-24.acacia`.
 
-
-## 28.4.0 - 2025-02-24
+* [#1948](https://github.com/stripe/stripe-java/pull/1948) add codeowners file
 * [#1943](https://github.com/stripe/stripe-java/pull/1943) Update generated code
   * Add support for `prices` on `Billing.CreditGrant.applicability_config.scope`, `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, and `billing.CreditGrantCreateParams.applicability_config.scope`
   * Change `billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type` and `billing.CreditGrantCreateParams.applicability_config.scope.price_type` to be optional
@@ -732,12 +742,18 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `metadata` on `ProductCreateParams.default_price_data`
   * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
   * Add support for new value `2025-02-24.acacia` on enum `WebhookEndpointCreateParams.api_version`
-* [#1948](https://github.com/stripe/stripe-java/pull/1948) add codeowners file
 
-## 28.3.1 - 2025-02-07
+## <a id="28-3-1"></a>28.3.1 - 2025-02-07
 * [#1946](https://github.com/stripe/stripe-java/pull/1946) Ensure `getRawJsonObject` returns data for constructed webhooks
 
-## 28.3.0 - 2025-01-27
+## <a id="28-3-0"></a>28.3.0 - 2025-01-27
+This release changes the pinned API version to `2025-01-27.acacia`.
+
+* [#1933](https://github.com/stripe/stripe-java/pull/1933) Added pull request template
+* [#1934](https://github.com/stripe/stripe-java/pull/1934) add justfile tweak readme, remove coveralls
+* [#1937](https://github.com/stripe/stripe-java/pull/1937) Added CONTRIBUTING.md file
+* [#1938](https://github.com/stripe/stripe-java/pull/1938) update justfile import & pin CI ubuntu
+* [#1941](https://github.com/stripe/stripe-java/pull/1941) Updated upload artifact ci action
 * [#1936](https://github.com/stripe/stripe-java/pull/1936) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`
   * Add support for `pay_by_bank_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
@@ -763,14 +779,11 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for new value `outbound_transfer` on enum `treasury.ReceivedCreditListParams.linked_flows.source_flow_type`
   * Add support for `outbound_transfer` on `Treasury.ReceivedCredit.linked_flows.source_flow_details`
   * Add support for new value `2025-01-27.acacia` on enum `WebhookEndpointCreateParams.api_version`
-* [#1941](https://github.com/stripe/stripe-java/pull/1941) Updated upload artifact ci action
-* [#1938](https://github.com/stripe/stripe-java/pull/1938) update justfile import & pin CI ubuntu
-* [#1937](https://github.com/stripe/stripe-java/pull/1937) Added CONTRIBUTING.md file
-* [#1934](https://github.com/stripe/stripe-java/pull/1934) add justfile tweak readme, remove coveralls
-* [#1933](https://github.com/stripe/stripe-java/pull/1933) Added pull request template
 
-## 28.2.0 - 2024-12-18
-* [#1931](https://github.com/stripe/stripe-java/pull/1931) This release changes the pinned API version to `2024-12-18.acacia`.
+## <a id="28-2-0"></a>28.2.0 - 2024-12-18
+This release changes the pinned API version to `2024-12-18.acacia`.
+
+* [#1931](https://github.com/stripe/stripe-java/pull/1931) Update generated code
   * Add support for `network_advice_code` and `network_decline_code` on `Charge.outcome`, `Invoice.last_finalization_error`, `PaymentIntent.last_payment_error`, `SetupAttempt.setup_error`, `SetupIntent.last_setup_error`, and `StripeError`
   * Add support for `credits_application_invoice_voided` on `Billing.CreditBalanceTransaction.credit`
   * Change type of `Billing.CreditBalanceTransaction.credit.type` from `literal('credits_granted')` to `enum('credits_application_invoice_voided'|'credits_granted')`
@@ -790,8 +803,10 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `al`, `am`, `ao`, `ba`, `bb`, `bs`, `cd`, `gn`, `kh`, `me`, `mk`, `mr`, `np`, `pe`, `sn`, `sr`, `tj`, `ug`, `uy`, `zm`, and `zw` on `Tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
   * Add support for new value `2024-12-18.acacia` on enum `WebhookEndpointCreateParams.api_version`
 
-## 28.1.0 - 2024-11-20
-* [#1923](https://github.com/stripe/stripe-java/pull/1923) This release changes the pinned API version to `2024-11-20.acacia`.
+## <a id="28-1-0"></a>28.1.0 - 2024-11-20
+This release changes the pinned API version to `2024-11-20.acacia`.
+
+* [#1923](https://github.com/stripe/stripe-java/pull/1923) Update generated code
   * Add support for `respond` test helper method on resource `Issuing.Authorization`
   * Add support for `authorizer` on `AccountPersonsParams.relationship` and `TokenCreateParams.person.relationship`
   * Add support for `adaptive_pricing` on `Checkout.Session` and `checkout.SessionCreateParams`
@@ -812,16 +827,17 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `network_decline_code` on `Refund.destination_details.blik` and `Refund.destination_details.swish`
   * Add support for new value `2024-11-20.acacia` on enum `WebhookEndpointCreateParams.api_version`
 
-## 28.0.1 - 2024-11-06
+## <a id="28-0-1"></a>28.0.1 - 2024-11-06
 * [#1919](https://github.com/stripe/stripe-java/pull/1919) Catch `JsonSyntaxException` when processing all errors
 
-## 28.0.0 - 2024-10-29
+## <a id="28-0-0"></a>28.0.0 - 2024-10-29
+This release changes the pinned API version to `2024-10-28.acacia`.
 
 Historically, when upgrading webhooks to a new API version, you also had to upgrade your SDK version. Your webhook's API version needed to match the API version pinned by the SDK you were using to ensure successful deserialization of events. With the `2024-09-30.acacia` release, Stripe follows a [new API release process](https://stripe.com/blog/introducing-stripes-new-api-release-process). As a result, you can safely upgrade your webhook endpoints to any API version within a biannual release (like `acacia`) without upgrading the SDK.
 
 However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y` SDK releases meant that webhook version upgrades from the SDK's pinned `2024-09-30.acacia` version to the new `2024-10-28.acacia` version would fail. Therefore, we are shipping SDK support for `2024-10-28.acacia` as a major version to enforce the idea that an SDK upgrade is also required. Future API versions in the `acacia` line will be released as minor versions.
 
-* [#1896](https://github.com/stripe/stripe-java/pull/1896) This release changes the pinned API version to `2024-10-28.acacia`.
+* [#1896](https://github.com/stripe/stripe-java/pull/1896) Update generated code
   * Add support for new resource `V2.EventDestinations`
   * Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
   * Add support for `submit_card` test helper method on resource `Issuing.Card`
@@ -854,30 +870,28 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new values `issuing_transaction.purchase_details_receipt_updated` and `refund.failed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
   * Add support for new value `2024-10-28.acacia` on enum `WebhookEndpointCreateParams.api_version`
 
-## 27.1.2 - 2024-10-29
-* [#1912](https://github.com/stripe/stripe-java/pull/1912) add `tolerance` argument to `parseThinEvent`
-  - The default `tolerance` value is still what most users will want, but this fixes an oversight where it wasn't possible to set `tolerance` at all when parsing thin events
-* [#1911](https://github.com/stripe/stripe-java/pull/1911) Fixes bug [#1899](https://github.com/stripe/stripe-java/issues/1899)
-  - Fixes the bug introduced in v27 where StripeException#getUserMessage on v1 API errors would return null instead of the error message.
+## <a id="27-1-2"></a>27.1.2 - 2024-10-29
 * [#1906](https://github.com/stripe/stripe-java/pull/1906) Update webhook API version validation
   - Update webhook event processing to accept events from any API version within the supported major release
+* [#1911](https://github.com/stripe/stripe-java/pull/1911) Fixes bug [#1899](https://github.com/stripe/stripe-java/issues/1899)
+  - Fixes the bug introduced in v27 where StripeException#getUserMessage on v1 API errors would return null instead of the error message.
+* [#1912](https://github.com/stripe/stripe-java/pull/1912) add `tolerance` argument to `parseThinEvent`
+  - The default `tolerance` value is still what most users will want, but this fixes an oversight where it wasn't possible to set `tolerance` at all when parsing thin events
 
-## 27.1.1 - 2024-10-18
+## <a id="27-1-1"></a>27.1.1 - 2024-10-18
+* [#1894](https://github.com/stripe/stripe-java/pull/1894) Fixed example for raw request in readme file
+* [#1898](https://github.com/stripe/stripe-java/pull/1898) Clean up examples
 * [#1901](https://github.com/stripe/stripe-java/pull/1901) 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.
-* [#1898](https://github.com/stripe/stripe-java/pull/1898) Clean up examples
-* [#1894](https://github.com/stripe/stripe-java/pull/1894) Fixed example for raw request in readme file
 
-## 27.1.0 - 2024-10-03
-* [#1890](https://github.com/stripe/stripe-java/pull/1890) Update the class for `ThinEvent` to include `livemode` and `reason`
+## <a id="27-1-0"></a>27.1.0 - 2024-10-03
 * [#1891](https://github.com/stripe/stripe-java/pull/1891) Removed the class `RequestSigningAuthenticator` that was added in the previous release. Request Signing is not supported yet.
+* [#1890](https://github.com/stripe/stripe-java/pull/1890) Update the class for `ThinEvent` to include `livemode` and `reason`
 * [#1889](https://github.com/stripe/stripe-java/pull/1889) Update generated code
   * Remove the support for resource `Margin` that was accidentally made public in the last release
 
-## 27.0.0 - 2024-10-01
+## <a id="27-0-0"></a>27.0.0 - 2024-10-01
 * [#1880](https://github.com/stripe/stripe-java/pull/1880) 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
@@ -912,15 +926,17 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   ### Changes
   * Change `billingportal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates` and `billingportal.ConfigurationCreateParams.features.subscription_update.products` to be optional
 
+## <a id="26-13-0"></a>26.13.0 - 2024-10-01
+This release changes the pinned API version to `2024-09-30.acacia`.
 
-## 26.12.0 - 2024-09-18
+## <a id="26-12-0"></a>26.12.0 - 2024-09-18
 * [#1866](https://github.com/stripe/stripe-java/pull/1866) Update generated code
   * Add support for `payer_details` on `Charge.payment_method_details.klarna`
   * Add support for `amazon_pay` on `Dispute.payment_method_details`
   * Add support for `automatically_finalizes_at` on `Invoice`
   * Add support for `state_sales_tax` on `Tax.Registration.country_options.us` and `tax.RegistrationCreateParams.country_options.us`
 
-## 26.11.0 - 2024-09-12
+## <a id="26-11-0"></a>26.11.0 - 2024-09-12
 * [#1864](https://github.com/stripe/stripe-java/pull/1864) Update generated code
   * Add support for new resource `InvoiceRenderingTemplate`
   * Add support for `archive`, `list`, `retrieve`, and `unarchive` methods on resource `InvoiceRenderingTemplate`
@@ -928,12 +944,12 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `template` on `Customer.invoice_settings.rendering_options`, `CustomerCreateParams.invoice_settings.rendering_options`, `CustomerUpdateParams.invoice_settings.rendering_options`, `Invoice.rendering`, `InvoiceCreateParams.rendering`, and `InvoiceUpdateParams.rendering`
   * Add support for `template_version` on `Invoice.rendering`, `InvoiceCreateParams.rendering`, and `InvoiceUpdateParams.rendering`
 
-## 26.10.0 - 2024-09-05
+## <a id="26-10-0"></a>26.10.0 - 2024-09-05
 * [#1850](https://github.com/stripe/stripe-java/pull/1850) Update generated code
   * Add support for `subscription_item` and `subscription` on `billing.AlertCreateParams.filter`
   * Change `terminal.ReaderProcessSetupIntentParams.customer_consent_collected` to be optional
 
-## 26.9.0 - 2024-08-29
+## <a id="26-9-0"></a>26.9.0 - 2024-08-29
 * [#1856](https://github.com/stripe/stripe-java/pull/1856) Generate SDK for OpenAPI spec version 1230
   * Change `AccountLinkCreateParams.collection_options.fields` to be optional
   * Add support for new value `hr_oib` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceCreatePreviewParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
@@ -941,16 +957,16 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `issuing_regulatory_reporting` on enum `FileCreateParams.purpose`
   * Add support for `status_details` on `TestHelpers.TestClock`
 
-## 26.8.0 - 2024-08-15
+## <a id="26-8-0"></a>26.8.0 - 2024-08-15
+* [#1849](https://github.com/stripe/stripe-java/pull/1849) Update recommended VSCode extensions
 * [#1847](https://github.com/stripe/stripe-java/pull/1847) Update generated code
   * Add support for `authorization_code` on `Charge.payment_method_details.card`
   * Add support for `wallet` on `Charge.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present`, `ConfirmationToken.payment_method_preview.card_present`, `PaymentMethod.card.generated_from.payment_method_details.card_present`, and `PaymentMethod.card_present`
   * Add support for `mandate_options` on `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, and `PaymentIntentUpdateParams.payment_method_options.bacs_debit`
   * Add support for `bacs_debit` on `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
   * Add support for `chips` on `Treasury.OutboundPayment.tracking_details.us_domestic_wire`, `Treasury.OutboundTransfer.tracking_details.us_domestic_wire`, `treasury.OutboundPaymentUpdateParams.tracking_details.us_domestic_wire`, and `treasury.OutboundTransferUpdateParams.tracking_details.us_domestic_wire`
-* [#1849](https://github.com/stripe/stripe-java/pull/1849) Update recommended VSCode extensions
 
-## 26.7.0 - 2024-08-08
+## <a id="26-7-0"></a>26.7.0 - 2024-08-08
 * [#1843](https://github.com/stripe/stripe-java/pull/1843) Update generated code
   * Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Billing.Alert`
   * Add support for `retrieve` method on resource `Tax.Calculation`
@@ -960,17 +976,17 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Change `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.count`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.count`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.count`, and `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.interval` to be optional
   * Add support for new value `girocard` on enums `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
 
-## 26.6.0 - 2024-08-01
-* [#1841](https://github.com/stripe/stripe-java/pull/1841) Update generated code
+## <a id="26-6-0"></a>26.6.0 - 2024-08-01
+* ⚠️ [#1841](https://github.com/stripe/stripe-java/pull/1841) Update generated code
   * Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`
   * ⚠️ Remove support for `authorization_code` on `Charge.payment_method_details.card`. This was accidentally released last week.
   * Add support for new value `billing.alert.triggered` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 26.5.1 - 2024-07-25
+## <a id="26-5-1"></a>26.5.1 - 2024-07-25
 * [#1840](https://github.com/stripe/stripe-java/pull/1840) Update generated code
   * Add support for `tax_registrations` and `tax_settings` on `AccountSession.components` and `AccountSessionCreateParams.components`
 
-## 26.5.0 - 2024-07-25
+## <a id="26-5-0"></a>26.5.0 - 2024-07-25
 * [#1837](https://github.com/stripe/stripe-java/pull/1837) Update generated code
   * Add support for `update` method on resource `Checkout.Session`
   * Add support for `transaction_id` on `Charge.payment_method_details.affirm`
@@ -982,28 +998,28 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `twint` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
   * Add support for new values `invoice.overdue` and `invoice.will_be_due` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 26.4.0 - 2024-07-18
+## <a id="26-4-0"></a>26.4.0 - 2024-07-18
+* [#1805](https://github.com/stripe/stripe-java/pull/1805) Added missing log to changelog
 * [#1836](https://github.com/stripe/stripe-java/pull/1836) Update generated code
   * Add support for `customer` on `ConfirmationToken.payment_method_preview`
   * Add support for new value `multibanco` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
   * Add support for new value `stripe_s700` on enum `terminal.ReaderListParams.device_type`
   * Add support for new value `issuing_dispute.funds_rescinded` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-* [#1805](https://github.com/stripe/stripe-java/pull/1805) Added missing log to changelog
 
-## 26.3.0 - 2024-07-11
+## <a id="26-3-0"></a>26.3.0 - 2024-07-11
 * [#1835](https://github.com/stripe/stripe-java/pull/1835) Update generated code
   * Add support for `payment_method_options` on `ConfirmationToken`
   * Add support for `payment_element` on `CustomerSession.components` and `CustomerSessionCreateParams.components`
   * Add support for `address_validation` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
   * Add support for `shipping` on `issuing.CardUpdateParams`
 
-## 26.2.0 - 2024-07-05
+## <a id="26-2-0"></a>26.2.0 - 2024-07-05
+* [#1833](https://github.com/stripe/stripe-java/pull/1833) Update formatting settings for VSCode
 * [#1831](https://github.com/stripe/stripe-java/pull/1831) Update generated code
   * Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
   * Add support for `posted_at` on `Tax.Transaction` and `tax.TransactionCreateFromCalculationParams`
-* [#1833](https://github.com/stripe/stripe-java/pull/1833) Update formatting settings for VSCode
 
-## 26.1.0 - 2024-06-27
+## <a id="26-1-0"></a>26.1.0 - 2024-06-27
 * [#1829](https://github.com/stripe/stripe-java/pull/1829) Update generated code
   * Add support for `filters` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntent.payment_method_options.us_bank_account.financial_connections`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`
   * Add support for `email_type` on `CreditNoteCreateParams`, `CreditNotePreviewLinesParams`, and `CreditNotePreviewParams`
@@ -1011,11 +1027,10 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new values `multibanco`, `twint`, and `zip` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
   * Add support for `reboot_window` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
 
-## 26.0.0 - 2024-06-24
-* [#1825](https://github.com/stripe/stripe-java/pull/1825)
-
-  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.
+## <a id="26-0-0"></a>26.0.0 - 2024-06-24
+This release changes the pinned API version to `2024-06-20`.
 
+* [#1825](https://github.com/stripe/stripe-java/pull/1825) 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`
@@ -1036,12 +1051,12 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new values `charging_minute`, `imperial_gallon`, `kilogram`, `kilowatt_hour`, and `pound` on enums `issuing.AuthorizationCaptureParams.purchase_details.fuel.unit`, `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel.unit`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel.unit`
   * Add support for new value `2024-06-20` on enum `WebhookEndpointCreateParams.api_version`
 
-## 25.13.0 - 2024-06-17
+## <a id="25-13-0"></a>25.13.0 - 2024-06-17
 * [#1823](https://github.com/stripe/stripe-java/pull/1823) Update generated code
   * Add support for new value `mobilepay` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
   * Add support for `tax_id_collection` on `PaymentLinkUpdateParams`
 
-## 25.12.0 - 2024-06-13
+## <a id="25-12-0"></a>25.12.0 - 2024-06-13
 * [#1818](https://github.com/stripe/stripe-java/pull/1818) Update generated code
   * Add support for `multibanco_payments` and `twint_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `twint` on `Charge.payment_method_details`, `ConfirmationToken.payment_method_preview`, `ConfirmationTokenCreateParams.payment_method_data`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
@@ -1052,25 +1067,28 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `multibanco_display_details` on `PaymentIntent.next_action`
   * Add support for `invoice_settings` on `Subscription`
 
-## 25.11.0 - 2024-06-06
+## <a id="25-11-0"></a>25.11.0 - 2024-06-06
 * [#1817](https://github.com/stripe/stripe-java/pull/1817) Update generated code
   * Add support for `gb_bank_transfer_payments`, `jp_bank_transfer_payments`, `mx_bank_transfer_payments`, `sepa_bank_transfer_payments`, and `us_bank_transfer_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for new value `swish` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
 
-## 25.10.0 - 2024-05-30
+## <a id="25-10-0"></a>25.10.0 - 2024-05-30
 * [#1815](https://github.com/stripe/stripe-java/pull/1815) Update generated code
   * Add support for `default_value` on `Checkout.Session.custom_fields[].dropdown`, `Checkout.Session.custom_fields[].numeric`, `Checkout.Session.custom_fields[].text`, `checkout.SessionCreateParams.custom_fields[].dropdown`, `checkout.SessionCreateParams.custom_fields[].numeric`, and `checkout.SessionCreateParams.custom_fields[].text`
   * Add support for `generated_from` on `ConfirmationToken.payment_method_preview.card` and `PaymentMethod.card`
   * Add support for new values `en-RO` and `ro-RO` on enums `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
   * Add support for new values `issuing_personalization_design.activated`, `issuing_personalization_design.deactivated`, `issuing_personalization_design.rejected`, and `issuing_personalization_design.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 25.9.0 - 2024-05-23
+## <a id="25-9-0"></a>25.9.0 - 2024-05-23
+* [#1808](https://github.com/stripe/stripe-java/pull/1808) Track usage for unsafeSetStripeVersionOverride
 * [#1806](https://github.com/stripe/stripe-java/pull/1806) Update generated code
   * Add support for `external_account_collection` on `AccountSession.components.balances.features`, `AccountSession.components.payouts.features`, `AccountSessionCreateParams.components.balances.features`, and `AccountSessionCreateParams.components.payouts.features`
   * Add support for `payment_method_remove` on `Checkout.Session.saved_payment_method_options`
-* [#1808](https://github.com/stripe/stripe-java/pull/1808) Track usage for unsafeSetStripeVersionOverride
 
-## 25.8.0 - 2024-05-16
+## <a id="25-8-0"></a>25.8.0 - 2024-05-16
+* [#1804](https://github.com/stripe/stripe-java/pull/1804) Added deprecated annotation to builder methods
+  * Deprecate Java builder params based on OpenAPI spec
+    * Mark as deprecated the setters for persistent_token property on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`. This is a legacy parameter that no longer has any function.
 * [#1803](https://github.com/stripe/stripe-java/pull/1803) Update generated code
   * Add support for `fee_source` on `ApplicationFee`
   * Add support for `net_available` on `Balance.instant_available[]`
@@ -1084,15 +1102,12 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `routing` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
   * Add support for `application_fee_amount` and `application_fee` on `Payout`
   * Add support for `stripe_s700` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
-* [#1804](https://github.com/stripe/stripe-java/pull/1804) Added deprecated annotation to builder methods
-  * Deprecate Java builder params based on OpenAPI spec
-    * Mark as deprecated the setters for persistent_token property on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`. This is a legacy parameter that no longer has any function.
 
-## 25.7.0 - 2024-05-09
+## <a id="25-7-0"></a>25.7.0 - 2024-05-09
 * [#1801](https://github.com/stripe/stripe-java/pull/1801) Update generated code
   * Remove support for `pending_invoice_items_behavior` on `SubscriptionCreateParams` that was prematurely added in the previous release on the same day
 
-## 25.6.0 - 2024-05-09
+## <a id="25-6-0"></a>25.6.0 - 2024-05-09
 * [#1797](https://github.com/stripe/stripe-java/pull/1797) Update generated code
   * Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
   * Add support for `allow_redisplay` on `ConfirmationToken.payment_method_preview` and `PaymentMethod`
@@ -1100,7 +1115,9 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `tracking_details` on `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
   * Add support for new values `treasury.outbound_payment.tracking_details_updated` and `treasury.outbound_transfer.tracking_details_updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 25.5.0 - 2024-05-02
+## <a id="25-5-0"></a>25.5.0 - 2024-05-02
+* [#1787](https://github.com/stripe/stripe-java/pull/1787) Deprecate Java params based on OpenAPI spec
+  - Mark as deprecated the `persistent_token` property on `ConfirmationToken.Link.persistentToken`, `PaymentIntent.Link.persistentToken`, `PaymentMethod.Link.persistentToken`, `SetupIntent.Link.persistentToken`, `PaymentIntentConfirmParams.Link.persistentToken`, `PaymentIntentCreateParams.Link.persistentToken`, `PaymentIntentUpdateParams.Link.persistentToken`, `SetupIntentConfirmParams.Link.persistentToken`, `SetupIntentCreateParams.Link.persistentToken`, `SetupIntentUpdateParams.Link.persistentToken`. This is a legacy parameter that no longer has any function.
 * [#1785](https://github.com/stripe/stripe-java/pull/1785) Update generated code
   * Add support for `paypal` on `Dispute.payment_method_details`
   * Change type of `Dispute.payment_method_details.type` from `literal('card')` to `enum('card'|'paypal')`
@@ -1108,10 +1125,10 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `payment_method_types` on `PaymentIntentConfirmParams`
   * Add support for `ship_from_details` on `Tax.Calculation`, `Tax.Transaction`, and `tax.CalculationCreateParams`
   * Add support for `bh`, `eg`, `ge`, `ke`, `kz`, `ng`, and `om` on `Tax.Registration.country_options` and `tax.RegistrationCreateParams.country_options`
-* [#1787](https://github.com/stripe/stripe-java/pull/1787) Deprecate Java params based on OpenAPI spec
-  - Mark as deprecated the `persistent_token` property on `ConfirmationToken.Link.persistentToken`, `PaymentIntent.Link.persistentToken`, `PaymentMethod.Link.persistentToken`, `SetupIntent.Link.persistentToken`, `PaymentIntentConfirmParams.Link.persistentToken`, `PaymentIntentCreateParams.Link.persistentToken`, `PaymentIntentUpdateParams.Link.persistentToken`, `SetupIntentConfirmParams.Link.persistentToken`, `SetupIntentCreateParams.Link.persistentToken`, `SetupIntentUpdateParams.Link.persistentToken`. This is a legacy parameter that no longer has any function.
 
-## 25.4.0 - 2024-04-25
+## <a id="25-4-0"></a>25.4.0 - 2024-04-25
+* Deprecate Java methods based on OpenAPI spec
+  * Mark as deprecated the `approve` and `decline` methods on Authorization. Instead, [respond directly to the webhook request to approve an authorization](https://docs.stripe.com/issuing/controls/real-time-authorizations#authorization-handling).
 * [#1784](https://github.com/stripe/stripe-java/pull/1784) Update generated code
   * Add support for `setup_future_usage` on `Checkout.Session.payment_method_options.amazon_pay`, `Checkout.Session.payment_method_options.revolut_pay`, `PaymentIntent.payment_method_options.amazon_pay`, and `PaymentIntent.payment_method_options.revolut_pay`
   * Change type of `Entitlements.ActiveEntitlement.feature` from `string` to `expandable($Entitlements.Feature)`
@@ -1120,10 +1137,8 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `amazon_pay` and `revolut_pay` on `Mandate.payment_method_details` and `SetupAttempt.payment_method_details`
   * Add support for `ending_before`, `limit`, and `starting_after` on `PaymentMethodConfigurationListParams`
   * Add support for `mobilepay` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
-* Deprecate Java methods based on OpenAPI spec
-  * Mark as deprecated the `approve` and `decline` methods on Authorization. Instead, [respond directly to the webhook request to approve an authorization](https://docs.stripe.com/issuing/controls/real-time-authorizations#authorization-handling).
 
-## 25.3.0 - 2024-04-18
+## <a id="25-3-0"></a>25.3.0 - 2024-04-18
 * [#1782](https://github.com/stripe/stripe-java/pull/1782) Update generated code
   * Add support for `create_preview` method on resource `Invoice`
   * Add support for `payment_method_data` on `checkout.SessionCreateParams`
@@ -1134,7 +1149,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `schedule_details` and `subscription_details` on `InvoiceUpcomingLinesParams` and `InvoiceUpcomingParams`
   * Add support for new value `other` on enums `issuing.AuthorizationCaptureParams.purchase_details.fuel.unit`, `issuing.TransactionCreateForceCaptureParams.purchase_details.fuel.unit`, and `issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel.unit`
 
-## 25.2.0 - 2024-04-16
+## <a id="25-2-0"></a>25.2.0 - 2024-04-16
 * [#1780](https://github.com/stripe/stripe-java/pull/1780) Update generated code
   * Add support for new resource `Entitlements.ActiveEntitlementSummary`
   * Add support for `balances` and `payouts_list` on `AccountSession.components` and `AccountSessionCreateParams.components`
@@ -1144,7 +1159,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `swish` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
   * Add support for new value `entitlements.active_entitlement_summary.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 25.1.0 - 2024-04-11
+## <a id="25-1-0"></a>25.1.0 - 2024-04-11
 * [#1779](https://github.com/stripe/stripe-java/pull/1779) Update generated code
   * Add support for `account_management` and `notification_banner` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `external_account_collection` on `AccountSession.components.account_onboarding.features` and `AccountSessionCreateParams.components.account_onboarding.features`
@@ -1159,9 +1174,10 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `amazon_pay` on enums `CustomerListPaymentMethodsParams.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
   * Add support for `next_refresh_available_at` on `FinancialConnections.Account.ownership_refresh`
 
-## 25.0.0 - 2024-04-10
-* [#1776](https://github.com/stripe/stripe-java/pull/1776)
+## <a id="25-0-0"></a>25.0.0 - 2024-04-10
+This release changes the pinned API version to `2024-04-10`.
 
+* [#1776](https://github.com/stripe/stripe-java/pull/1776) Update generated code
   * 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.
 
   * Add a new `TaxIdService` for operations on `/v1/tax_ids` endpoints.
@@ -1227,14 +1243,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Remove the support for deprecated value `obligation` on `ReportRunCreateParams.ReportingCategory`
   * Remove the legacy field `rendering_options` on `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`. Use `rendering` instead.
 
-
-
-
-
-
-
-
-## 24.24.0 - 2024-04-09
+## <a id="24-24-0"></a>24.24.0 - 2024-04-09
 * [#1778](https://github.com/stripe/stripe-java/pull/1778) Update generated code
   * Add support for new resources `Entitlements.ActiveEntitlement` and `Entitlements.Feature`
   * Add support for `list` and `retrieve` methods on resource `ActiveEntitlement`
@@ -1244,7 +1253,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `event_name` on `Billing.MeterEventAdjustment` and `billing.MeterEventAdjustmentCreateParams`
   * Add support for `cancel` and `type` on `Billing.MeterEventAdjustment`
 
-## 24.23.0 - 2024-04-04
+## <a id="24-23-0"></a>24.23.0 - 2024-04-04
 * [#1774](https://github.com/stripe/stripe-java/pull/1774) Update generated code
   * Change type of `checkout.SessionCreateParams.payment_method_options.swish.reference` from `emptyable(string)` to `string`
   * Add support for `subscription_item` on `Discount`
@@ -1260,7 +1269,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `card_present` on `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_options`, and `SetupIntentUpdateParams.payment_method_options`
   * Add support for new value `mobile_phone_reader` on enum `terminal.ReaderListParams.device_type`
 
-## 24.22.0 - 2024-03-28
+## <a id="24-22-0"></a>24.22.0 - 2024-03-28
 * [#1770](https://github.com/stripe/stripe-java/pull/1770) Update generated code
   * Add support for new resources `Billing.MeterEventAdjustment`, `Billing.MeterEvent`, and `Billing.Meter`
   * Add support for `create`, `deactivate`, `list`, `reactivate`, `retrieve`, and `update` methods on resource `Meter`
@@ -1271,7 +1280,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `second_line` on `issuing.CardCreateParams`
   * Add support for `meter` on `PlanCreateParams`, `Plan`, `Price.recurring`, `PriceCreateParams.recurring`, and `PriceListParams.recurring`
 
-## 24.21.0 - 2024-03-21
+## <a id="24-21-0"></a>24.21.0 - 2024-03-21
 * [#1768](https://github.com/stripe/stripe-java/pull/1768) Update generated code
   * Add support for new resources `ConfirmationToken` and `Forwarding.Request`
   * Add support for `retrieve` method on resource `ConfirmationToken`
@@ -1285,7 +1294,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `name` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
   * Add support for `payout` on `Treasury.ReceivedDebit.linked_flows`
 
-## 24.20.0 - 2024-03-14
+## <a id="24-20-0"></a>24.20.0 - 2024-03-14
 * [#1763](https://github.com/stripe/stripe-java/pull/1763) Update generated code
   * Add support for new resources `Issuing.PersonalizationDesign` and `Issuing.PhysicalBundle`
   * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PersonalizationDesign`
@@ -1294,22 +1303,22 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Change type of `SubscriptionCreateParams.application_fee_percent` and `SubscriptionUpdateParams.application_fee_percent` from `number` to `emptyStringable(number)`
   * Add support for `sepa_debit` on `Subscription.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, and `SubscriptionUpdateParams.payment_settings.payment_method_options`
 
-## 24.19.0 - 2024-03-07
+## <a id="24-19-0"></a>24.19.0 - 2024-03-07
 * [#1758](https://github.com/stripe/stripe-java/pull/1758) Update generated code
   * Add support for `documents` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `request_three_d_secure` on `Checkout.Session.payment_method_options.card` and `checkout.SessionCreateParams.payment_method_options.card`
   * Add support for `created` on `CreditNoteListParams`
   * Add support for `sepa_debit` on `Invoice.payment_settings.payment_method_options`, `InvoiceCreateParams.payment_settings.payment_method_options`, and `InvoiceUpdateParams.payment_settings.payment_method_options`
 
-## 24.18.0 - 2024-02-29
+## <a id="24-18-0"></a>24.18.0 - 2024-02-29
+* [#1753](https://github.com/stripe/stripe-java/pull/1753) Update README to reference addBetaVersion helper
 * [#1750](https://github.com/stripe/stripe-java/pull/1750) Update generated code
   * Add support for `number` on `InvoiceCreateParams` and `InvoiceUpdateParams`
   * Add support for `enable_customer_cancellation` on `Terminal.Reader.action.process_payment_intent.process_config`, `Terminal.Reader.action.process_setup_intent.process_config`, `terminal.ReaderProcessPaymentIntentParams.process_config`, and `terminal.ReaderProcessSetupIntentParams.process_config`
   * Add support for `refund_payment_config` on `Terminal.Reader.action.refund_payment` and `terminal.ReaderRefundPaymentParams`
   * Add support for `payment_method` on `TokenCreateParams.bank_account`
-* [#1753](https://github.com/stripe/stripe-java/pull/1753) Update README to reference addBetaVersion helper
 
-## 24.17.0 - 2024-02-22
+## <a id="24-17-0"></a>24.17.0 - 2024-02-22
 * [#1748](https://github.com/stripe/stripe-java/pull/1748) Update generated code
   * Add support for `client_reference_id` on `Identity.VerificationReport`, `Identity.VerificationSession`, `identity.VerificationReportListParams`, `identity.VerificationSessionCreateParams`, and `identity.VerificationSessionListParams`
   * Remove support for value `include_and_require` from enum `InvoiceCreateParams.pending_invoice_items_behavior`
@@ -1317,31 +1326,31 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `created` on `treasury.OutboundPaymentListParams`
   * Add `InvoiceLineItem.update` method.
 
-## 24.16.0 - 2024-02-15
+## <a id="24-16-0"></a>24.16.0 - 2024-02-15
 * [#1745](https://github.com/stripe/stripe-java/pull/1745) Update generated code
   * Add support for `networks` on `Card`, `PaymentMethodCreateParams.CardDetails`, `PaymentMethodUpdateParams.Card`, and `TokenCreateParams.Card`
   * Add support for new value `no_voec` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `TaxIdCreateParams.type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
   * Add support for `display_brand` on `PaymentMethod.card`
   * Add support for new value `financial_connections.account.refreshed_ownership` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 24.15.0 - 2024-02-08
+## <a id="24-15-0"></a>24.15.0 - 2024-02-08
+* [#1744](https://github.com/stripe/stripe-java/pull/1744) Define StripeClient "usage" in a single place
 * [#1742](https://github.com/stripe/stripe-java/pull/1742) Update generated code
   * Add support for `invoices` on `Account.settings` and `AccountUpdateParams.settings`
   * Add support for new value `velobank` on enums `PaymentIntentConfirmParams.payment_method_data.p24.bank`, `PaymentIntentCreateParams.payment_method_data.p24.bank`, `PaymentIntentUpdateParams.payment_method_data.p24.bank`, `PaymentMethodCreateParams.p24.bank`, `SetupIntentConfirmParams.payment_method_data.p24.bank`, `SetupIntentCreateParams.payment_method_data.p24.bank`, and `SetupIntentUpdateParams.payment_method_data.p24.bank`
   * Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.blik`, `PaymentIntentConfirmParams.payment_method_options.blik`, `PaymentIntentCreateParams.payment_method_options.blik`, and `PaymentIntentUpdateParams.payment_method_options.blik`
   * Add support for `require_cvc_recollection` on `PaymentIntent.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, and `PaymentIntentUpdateParams.payment_method_options.card`
   * Add support for `account_tax_ids` on `SubscriptionCreateParams.invoice_settings`, `SubscriptionSchedule.default_settings.invoice_settings`, `SubscriptionSchedule.phases[].invoice_settings`, `SubscriptionScheduleCreateParams.default_settings.invoice_settings`, `SubscriptionScheduleCreateParams.phases[].invoice_settings`, `SubscriptionScheduleUpdateParams.default_settings.invoice_settings`, `SubscriptionScheduleUpdateParams.phases[].invoice_settings`, and `SubscriptionUpdateParams.invoice_settings`
-* [#1744](https://github.com/stripe/stripe-java/pull/1744) Define StripeClient "usage" in a single place
 
-## 24.14.0 - 2024-02-01
-* [#1740](https://github.com/stripe/stripe-java/pull/1740) Update generated code
+## <a id="24-14-0"></a>24.14.0 - 2024-02-01
+* [#1739](https://github.com/stripe/stripe-java/pull/1739) Add clock instance on webhook
+* ⚠️ [#1740](https://github.com/stripe/stripe-java/pull/1740) Update generated code
   * Add support for `swish` payment method throughout the API
   * Add support for `relationship` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, and `TokenCreateParams.account.individual`
   * Add support for `jurisdiction_level` on `TaxRate`
   * ⚠️  Fix broken reference to `com.stripe.model.Discount` from `checkout.Session.TotalDetails.Breakdown.Discount` (this represents a bugfix as this class would never have worked, but might be a breaking type change)
-* [#1739](https://github.com/stripe/stripe-java/pull/1739) Add clock instance on webhook
 
-## 24.13.0 - 2024-01-25
+## <a id="24-13-0"></a>24.13.0 - 2024-01-25
 * [#1736](https://github.com/stripe/stripe-java/pull/1736) 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`
@@ -1353,7 +1362,17 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * 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`
 
-## 24.12.0 - 2024-01-18
+## <a id="24-12-0"></a>24.12.0 - 2024-01-18
+* [#1722](https://github.com/stripe/stripe-java/pull/1722) Refactor LiveStripeResponseGetter
+* [#1725](https://github.com/stripe/stripe-java/pull/1725) Move request telemetry to LiveStripeResponseGetter
+* [#1721](https://github.com/stripe/stripe-java/pull/1721) Report usage of `stripe_client`
+  * Reports use of the new `StripeClient` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `Stripe.enableTelemetry = false;`, see the [README](https://github.com/stripe/stripe-java/blob/master/README.md#telemetry).)
+
+  ## Details
+  * A different approach to #1698. This one sets `usage` on each callsite to `StripeResponseGetter.request` from `StripeClient`, rather than attempting to wrap `LiveStripeResponseGetter`.
+  * Modifies `RequestTelemetry` to accept usage and set it appropriately on `X-Stripe-Client-Telemetry`. Had to add a parameter to a public method, so I made a new overload and deprecated the old one. Had to disable a linter rule to do this.
+* [#1724](https://github.com/stripe/stripe-java/pull/1724) Add webhook parsing method on StripeClient
+  * Add support for `constructEvent()` instance method on `StripeClient` that parses Webhook events and uses the settings inherited from the StripeClient instance to make further requests.
 * [#1732](https://github.com/stripe/stripe-java/pull/1732) Update generated code
 * [#1723](https://github.com/stripe/stripe-java/pull/1723) Update generated code
   * Add support for `issuer` on `InvoiceCreateParams`, `InvoiceUpcomingLinesParams`, `InvoiceUpcomingParams`, `InvoiceUpdateParams`, and `Invoice`
@@ -1364,18 +1383,10 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `nn` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
   * Add support for `customer_balance` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
   * Add support for `invoice_settings` on `SubscriptionCreateParams` and `SubscriptionUpdateParams`
-* [#1724](https://github.com/stripe/stripe-java/pull/1724) Add webhook parsing method on StripeClient
-  * Add support for `constructEvent()` instance method on `StripeClient` that parses Webhook events and uses the settings inherited from the StripeClient instance to make further requests.
-* [#1721](https://github.com/stripe/stripe-java/pull/1721) Report usage of `stripe_client`
-  * Reports use of the new `StripeClient` in `X-Stripe-Client-Telemetry`. (You can disable telemetry via `Stripe.enableTelemetry = false;`, see the [README](https://github.com/stripe/stripe-java/blob/master/README.md#telemetry).)
 
-  ## Details
-  * A different approach to #1698. This one sets `usage` on each callsite to `StripeResponseGetter.request` from `StripeClient`, rather than attempting to wrap `LiveStripeResponseGetter`.
-  * Modifies `RequestTelemetry` to accept usage and set it appropriately on `X-Stripe-Client-Telemetry`. Had to add a parameter to a public method, so I made a new overload and deprecated the old one. Had to disable a linter rule to do this.
-* [#1725](https://github.com/stripe/stripe-java/pull/1725) Move request telemetry to LiveStripeResponseGetter
-* [#1722](https://github.com/stripe/stripe-java/pull/1722) Refactor LiveStripeResponseGetter
-
-## 24.11.0 - 2024-01-12
+## <a id="24-11-0"></a>24.11.0 - 2024-01-12
+* [#1716](https://github.com/stripe/stripe-java/pull/1716) Add missing method overloads
+* [#1702](https://github.com/stripe/stripe-java/pull/1702) Change StripeResponseGetter to take a single APIRequest object
 * [#1715](https://github.com/stripe/stripe-java/pull/1715) Update generated code
   * Add support for new resource `CustomerSession`
   * Add support for `create` method on resource `CustomerSession`
@@ -1386,14 +1397,12 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new values `eps` and `p24` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.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`
-* [#1702](https://github.com/stripe/stripe-java/pull/1702) Change StripeResponseGetter to take a single APIRequest object
-* [#1716](https://github.com/stripe/stripe-java/pull/1716) Add missing method overloads
 
-## 24.10.0 - 2024-01-04
+## <a id="24-10-0"></a>24.10.0 - 2024-01-04
 * [#1712](https://github.com/stripe/stripe-java/pull/1712) Update generated code
   * Add support for `retrieve` method on resource `Tax.Registration`
 
-## 24.9.0 - 2023-12-22
+## <a id="24-9-0"></a>24.9.0 - 2023-12-22
 * [#1709](https://github.com/stripe/stripe-java/pull/1709) Update generated code
 * [#1707](https://github.com/stripe/stripe-java/pull/1707) Update generated code
   * Add support for new resource `FinancialConnections.Transaction`
@@ -1414,13 +1423,13 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * 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[]`
 
-## 24.8.0 - 2023-12-14
+## <a id="24-8-0"></a>24.8.0 - 2023-12-14
 * [#1704](https://github.com/stripe/stripe-java/pull/1704) Update generated code
   * Add support for `payment_method_reuse_agreement` on `Checkout.Session.consent_collection`, `PaymentLink.consent_collection`, `PaymentLinkCreateParams.consent_collection`, and `checkout.SessionCreateParams.consent_collection`
   * Add support for `after_submit` on `Checkout.Session.custom_text`, `PaymentLink.custom_text`, `PaymentLinkCreateParams.custom_text`, `PaymentLinkUpdateParams.custom_text`, and
   * Add support for `created` on `radar.EarlyFraudWarningListParams`
 
-## 24.7.0 - 2023-12-07
+## <a id="24-7-0"></a>24.7.0 - 2023-12-07
 * [#1700](https://github.com/stripe/stripe-java/pull/1700) Update generated code
   * Add support for `payment_details`, `payments`, and `payouts` on `AccountSession.components` and `AccountSessionCreateParams.components`
   * Add support for `features` on `AccountSession.components.account_onboarding` and `AccountSessionCreateParams.components.account_onboarding`
@@ -1428,7 +1437,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `transfer_group` on `PaymentLink.payment_intent_data`, `PaymentLinkCreateParams.payment_intent_data`, and `PaymentLinkUpdateParams.payment_intent_data`
   * Add support for `trial_settings` on `PaymentLink.subscription_data`, `PaymentLinkCreateParams.subscription_data`, and `PaymentLinkUpdateParams.subscription_data`
 
-## 24.6.0 - 2023-11-30
+## <a id="24-6-0"></a>24.6.0 - 2023-11-30
 * [#1694](https://github.com/stripe/stripe-java/pull/1694) Update generated code
   * Add support for new resources `Climate.Order`, `Climate.Product`, and `Climate.Supplier`
   * Add support for `cancel`, `create`, `list`, `retrieve`, and `update` methods on resource `Order`
@@ -1438,13 +1447,13 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new values `climate_order_purchase` and `climate_order_refund` on enum `reporting.ReportRunCreateParams.parameters.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 `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 24.5.0 - 2023-11-21
+## <a id="24-5-0"></a>24.5.0 - 2023-11-21
 * [#1693](https://github.com/stripe/stripe-java/pull/1693) Update generated code
   * Add support for `electronic_commerce_indicator` and `transaction_id` on `Charge.payment_method_details.card.three_d_secure` and `SetupAttempt.payment_method_details.card.three_d_secure`
   * Add support for `exemption_indicator_applied` and `exemption_indicator` on `Charge.payment_method_details.card.three_d_secure`
   * Add support for `three_d_secure` on `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `SetupIntentConfirmParams.payment_method_options.card`, `SetupIntentCreateParams.payment_method_options.card`, and `SetupIntentUpdateParams.payment_method_options.card`
 
-## 24.4.0 - 2023-11-21
+## <a id="24-4-0"></a>24.4.0 - 2023-11-21
 * [#1690](https://github.com/stripe/stripe-java/pull/1690) Update generated code
   * Add support for `offline` on `Charge.payment_method_details.card_present`
   * Add support for `system_trace_audit_number` on `Issuing.Authorization.network_data`
@@ -1453,7 +1462,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `requested_at` on `Issuing.Authorization.request_history[]`
   * Add support for `authorization_code` on `Issuing.Transaction.network_data`
 
-## 24.3.0 - 2023-11-16
+## <a id="24-3-0"></a>24.3.0 - 2023-11-16
 * [#1685](https://github.com/stripe/stripe-java/pull/1685) Update generated code
   * Add support for `status` on `checkout.SessionListParams`
 * [#1683](https://github.com/stripe/stripe-java/pull/1683) Update generated code
@@ -1464,11 +1473,11 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `tax_amounts` on `CreditNoteCreateParams.lines[]`, `CreditNotePreviewLinesParams.lines[]`, and `CreditNotePreviewParams.lines[]`
   * Add support for `network_data` on `Issuing.Transaction`
 
-## 24.2.0 - 2023-11-09
+## <a id="24-2-0"></a>24.2.0 - 2023-11-09
 * [#1679](https://github.com/stripe/stripe-java/pull/1679) Update generated code
   * Add support for `metadata` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, and `QuoteUpdateParams.subscription_data`
 
-## 24.1.0 - 2023-11-02
+## <a id="24-1-0"></a>24.1.0 - 2023-11-02
 * [#1677](https://github.com/stripe/stripe-java/pull/1677) Update generated code
   * Add support for new resource `Tax.Registration`
   * Add support for `revolut_pay` throughout the API.
@@ -1478,19 +1487,21 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `description` on `PaymentLink.payment_intent_data`, `PaymentLinkCreateParams.payment_intent_data`, and `PaymentLinkUpdateParams.payment_intent_data`
   * Add support for new value `unreconciled_customer_funds` on enum `reporting.ReportRunCreateParams.parameters.reporting_category`
 
-## 24.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-java`.
+## <a id="24-0-0"></a>24.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-java`.
 * [#1672](https://github.com/stripe/stripe-java/pull/1672) Update generated code
   * Add support for `legal_guardian` on `AccountPersonsParams.relationship` and `TokenCreateParams.person.relationship`
   * Add support for `additional_tos_acceptances` on `TokenCreateParams.person`
   * Add support for new value `2023-10-16` on enum `WebhookEndpointCreateParams.api_version`
 
-## 23.10.0 - 2023-10-16
+## <a id="23-10-0"></a>23.10.0 - 2023-10-16
+* [#1671](https://github.com/stripe/stripe-java/pull/1671) Disallow falback to global response getter only in tests
 * [#1670](https://github.com/stripe/stripe-java/pull/1670) Update generated code
   * Add support for new values `issuing_token.created` and `issuing_token.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-* [#1671](https://github.com/stripe/stripe-java/pull/1671) Disallow falback to global response getter only in tests
 
-## 23.9.0 - 2023-10-11
+## <a id="23-9-0"></a>23.9.0 - 2023-10-11
 * [#1668](https://github.com/stripe/stripe-java/pull/1668) Update generated code
   * Add support for `redirect_on_completion`, `return_url`, and `ui_mode` on `Checkout.Session` and `checkout.SessionCreateParams`
   * Change `checkout.SessionCreateParams.success_url` to be optional
@@ -1498,7 +1509,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `postal_code` on `Issuing.Authorization.verification_data`
   * Add support for `offline` on `Terminal.Configuration`, `terminal.ConfigurationCreateParams`, and `terminal.ConfigurationUpdateParams`
 
-## 23.8.0 - 2023-10-05
+## <a id="23-8-0"></a>23.8.0 - 2023-10-05
 * [#1663](https://github.com/stripe/stripe-java/pull/1663) Flow type information further into autopagination requests
 * [#1662](https://github.com/stripe/stripe-java/pull/1662) Update generated code
   * Add support for new resource `Issuing.Token`
@@ -1513,16 +1524,17 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `statement_descriptor_suffix` and `statement_descriptor` on `PaymentLink.payment_intent_data` and `PaymentLinkCreateParams.payment_intent_data`
   * Add support for `payment_intent_data` and `subscription_data` on `PaymentLinkUpdateParams`
 
-## 23.7.0 - 2023-09-28
+## <a id="23-7-0"></a>23.7.0 - 2023-09-28
 * [#1657](https://github.com/stripe/stripe-java/pull/1657) Update generated code
   * Add support for `rendering` on `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
 
-## 23.6.0 - 2023-09-21
+## <a id="23-6-0"></a>23.6.0 - 2023-09-21
+* [#1655](https://github.com/stripe/stripe-java/pull/1655) CI: Drop testing for 9, 10, 12-16
 * [#1654](https://github.com/stripe/stripe-java/pull/1654) Update generated code
   * Add support for `terms_of_service_acceptance` on `Checkout.Session.custom_text`, `PaymentLink.custom_text`, `PaymentLinkCreateParams.custom_text`, `PaymentLinkUpdateParams.custom_text`, and `checkout.SessionCreateParams.custom_text`
-* [#1655](https://github.com/stripe/stripe-java/pull/1655) CI: Drop testing for 9, 10, 12-16
 
-## 23.5.0 - 2023-09-14
+## <a id="23-5-0"></a>23.5.0 - 2023-09-14
+* [#1650](https://github.com/stripe/stripe-java/pull/1650) Flow response getters into Event.data.object and models deserialized via ApiResource.GSON
 * [#1647](https://github.com/stripe/stripe-java/pull/1647) Update generated code
   * Add support for new resource `PaymentMethodConfiguration`
   * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
@@ -1533,25 +1545,24 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `nonce` on `EphemeralKeyCreateParams`
   * Add support for `cashback_amount` on `Issuing.Authorization.amount_details`, `Issuing.Authorization.pending_request.amount_details`, `Issuing.Authorization.request_history[].amount_details`, and `Issuing.Transaction.amount_details`
   * Add support for `serial_number` on `terminal.ReaderListParams`
-* [#1650](https://github.com/stripe/stripe-java/pull/1650) Flow response getters into Event.data.object and models deserialized via ApiResource.GSON
 
-## 23.4.0 - 2023-09-07
+## <a id="23-4-0"></a>23.4.0 - 2023-09-07
+* [#1646](https://github.com/stripe/stripe-java/pull/1646) Fix EphemeralKeyService.create
 * [#1643](https://github.com/stripe/stripe-java/pull/1643) Update generated code
   * Add support for new resource `PaymentMethodDomain`
   * Add support for `create`, `list`, `retrieve`, `update`, and `validate` methods on resource `PaymentMethodDomain`
   * Add support for new value `n26` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
   * Add support for `features` on `ProductCreateParams`, `ProductUpdateParams`, and `Product`
   * Remove support for value `invoiceitem.updated` from enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-* [#1646](https://github.com/stripe/stripe-java/pull/1646) Fix EphemeralKeyService.create
 
-## 23.3.0 - 2023-08-31
+## <a id="23-3-0"></a>23.3.0 - 2023-08-31
 * [#1640](https://github.com/stripe/stripe-java/pull/1640) Update generated code
   * Add support for new resource `AccountSession`
   * Add support for `create` method on resource `AccountSession`
   * Add support for `application` on `PaymentLink`
   * Add support for new value `obligation` on enum `reporting.ReportRunCreateParams.parameters.reporting_category`
 
-## 23.2.0 - 2023-08-24
+## <a id="23-2-0"></a>23.2.0 - 2023-08-24
 * [#1635](https://github.com/stripe/stripe-java/pull/1635) Update generated code
   * Add support for `retention` on `BillingPortal.Session.flow.subscription_cancel` and `billingportal.SessionCreateParams.flow_data.subscription_cancel`
   * Add support for `prefetch` on `Checkout.Session.payment_method_options.us_bank_account.financial_connections`, `FinancialConnections.Session`, `Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `PaymentIntent.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntent.payment_method_options.us_bank_account.financial_connections`, `SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections`, `SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections`, `Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections`, `checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections`, and `financialconnections.SessionCreateParams`
@@ -1560,21 +1571,44 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Change type of `PaymentIntentConfirmParams.mandate_data` and `SetupIntentConfirmParams.mandate_data` from `secret_key_param | client_key_param` to `emptyStringable(secret_key_param | client_key_param)`
   * Add support for `balance_transaction` on `CustomerCashBalanceTransaction.adjusted_for_overdraft`
 
-## 23.1.1 - 2023-08-21
-* [#1638](https://github.com/stripe/stripe-java/pull/1638) Set default API endpoints in StripeClient builder
+## <a id="23-1-1"></a>23.1.1 - 2023-08-21
 * [#1636](https://github.com/stripe/stripe-java/pull/1636) Update v23.0.0 Changelog
+* [#1638](https://github.com/stripe/stripe-java/pull/1638) Set default API endpoints in StripeClient builder
 
-## 23.1.0 - 2023-08-17
+## <a id="23-1-0"></a>23.1.0 - 2023-08-17
 * [#1634](https://github.com/stripe/stripe-java/pull/1634) Update generated code
   * Add support for `flat_amount` on `tax.TransactionCreateReversalParams`
 
-## 23.0.0 - 2023-08-16
-* This release changes the pinned API version to `2023-08-16`. Please read the [API Changelog](https://docs.stripe.com/changelog/2023-08-16) and carefully review the API changes before upgrading `stripe-java`.
-* More information is available in the [stripe-java v23 migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23)
+## <a id="23-0-0"></a>23.0.0 - 2023-08-16
+This release changes the pinned API version to `2023-08-16`.
 
 "⚠️" symbol highlights breaking changes.
 
-* [#1632](https://github.com/stripe/stripe-java/pull/1632) Update generated code
+* ⚠️ [#1622](https://github.com/stripe/stripe-java/pull/1622) StripeClient
+  * Introduces `StripeClient` and the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm.
+    * No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
+    * No extra API calls. All API endpoints can be accessed with a single method call. You don't have to call `retrieve` before doing an `update`.
+    * No static methods. Much easier mocking.
+    * Visit the [migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23) to learn more.
+  * **Removals**
+    * ⚠️ `ApiResource.request()`, `requestStream()`, `requestCollection()`, `requestSearchResult()` methods removed.
+    * ⚠️ `StripeResponseGetter.oauthRequest(...)` was removed. OAuth requests are now performed via `StripeResponseGetter.request` with `ApiMode.OAuth`.
+    * ⚠️ Deprecated `ApiResource.className()`  `singleClassUrl()`, `classUrl()`, `instanceUrl()`, `subresourceUrl()` methods removed.
+  * **Type changes**
+    * ⚠️ `StripeResponseGetter.request(...)`, `streamRequest(...)` signatures changed.
+      * `BaseAddress` parameter added.
+      * `url` renamed to `path` and is a relative to the base address
+      * `apiMode` parameter added to control how request is sent and response is handled, `V1` and `OAuth` are supported values.
+      * ⚠️ `RequestOptions.getReadTimeout()`, `getConnectTimeout()`, `getMaxNetworkRetries()` now return `Integer` instead of `int`.
+  * **Renames**
+    * ⚠️ `addFullNameAliase` renamed to `addFullNameAlias` in `AccountCreateParams`, `AccountUpdateParams`, `PersonCollectionCreateParams`, `TokenCreateParams`, `PersonCollectionCreateParams`, `PersonUpdateParams`.
+    * ⚠️ `addLookupKeys` renamed to `addLookupKey` in `PriceListParams`
+  * **Behavior Changes**
+    * ⚠️ `RequestOptions.getDefault()` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
+    * ⚠️ `RequestOptionsBuilder` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
+* More information is available in the [stripe-java v23 migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23)
+* Please read the [API Changelog](https://docs.stripe.com/changelog/2023-08-16) and carefully review the API changes before upgrading `stripe-java`.
+* ⚠️ [#1632](https://github.com/stripe/stripe-java/pull/1632) Update generated code
   * ⚠️Remove support for values `custom_account_update` and `custom_account_verification` from enum `AccountLinkCreateParams.type`
     * These values are not fully operational. Please use `account_update` and `account_onboarding` instead (see [API reference](https://stripe.com/docs/api/account_links/create#create_account_link-type)).
   * ⚠️Remove support for `available_on` on `BalanceTransactionListParams`
@@ -1598,41 +1632,22 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * ⚠️Remove support for `attributes`, `caption`, and `deactivate_on` on `ProductCreateParams`, `ProductUpdateParams`, and `Product`
     * These fields are not fully operational.
   * Add support for new value `2023-08-16` on enum `WebhookEndpointCreateParams.api_version`
-* [#1622](https://github.com/stripe/stripe-java/pull/1622) - StripeClient
-  * Introduces `StripeClient` and the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm.
-    * No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
-    * No extra API calls. All API endpoints can be accessed with a single method call. You don't have to call `retrieve` before doing an `update`.
-    * No static methods. Much easier mocking.
-    * Visit the [migration guide](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v23) to learn more.
-  * **Removals**
-    * ⚠️ `ApiResource.request()`, `requestStream()`, `requestCollection()`, `requestSearchResult()` methods removed.
-    * ⚠️ `StripeResponseGetter.oauthRequest(...)` was removed. OAuth requests are now performed via `StripeResponseGetter.request` with `ApiMode.OAuth`.
-    * ⚠️ Deprecated `ApiResource.className()`  `singleClassUrl()`, `classUrl()`, `instanceUrl()`, `subresourceUrl()` methods removed.
-  * **Type changes**
-    * ⚠️ `StripeResponseGetter.request(...)`, `streamRequest(...)` signatures changed.
-      * `BaseAddress` parameter added.
-      * `url` renamed to `path` and is a relative to the base address
-      * `apiMode` parameter added to control how request is sent and response is handled, `V1` and `OAuth` are supported values.
-      * ⚠️ `RequestOptions.getReadTimeout()`, `getConnectTimeout()`, `getMaxNetworkRetries()` now return `Integer` instead of `int`.
-  * **Renames**
-    * ⚠️ `addFullNameAliase` renamed to `addFullNameAlias` in `AccountCreateParams`, `AccountUpdateParams`, `PersonCollectionCreateParams`, `TokenCreateParams`, `PersonCollectionCreateParams`, `PersonUpdateParams`.
-    * ⚠️ `addLookupKeys` renamed to `addLookupKey` in `PriceListParams`
-  * **Behavior Changes**
-    * ⚠️ `RequestOptions.getDefault()` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
-    * ⚠️ `RequestOptionsBuilder` does not apply global configuration options from `Stripe` class, all fields are initialized to `null`.
 
-## 22.30.0 - 2023-08-03
+## <a id="22-31-0"></a>22.31.0 - 2023-08-10
+
+## <a id="22-30-0"></a>22.30.0 - 2023-08-03
 * [#1620](https://github.com/stripe/stripe-java/pull/1620) Update generated code
   * Change many types from `string` to `emptyStringable(string)`
   * Add support for `subscription_details` on `Invoice`
   * Add support for `preferred_settlement_speed` on `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, and `PaymentIntentUpdateParams.payment_method_options.us_bank_account`
   * Add support for new values `sepa_debit_fingerprint` and `us_bank_account_fingerprint` on enum `radar.ValueListCreateParams.item_type`
 
-## 22.29.0 - 2023-07-27
+## <a id="22-29-0"></a>22.29.0 - 2023-07-27
 * [#1614](https://github.com/stripe/stripe-java/pull/1614) Update generated code
   * Add support for `monthly_estimated_revenue` on `Account.business_profile`, `AccountCreateParams.business_profile`, and `AccountUpdateParams.business_profile`
 
-## 22.28.0 - 2023-07-20
+## <a id="22-28-0"></a>22.28.0 - 2023-07-20
+* [#1610](https://github.com/stripe/stripe-java/pull/1610) Changelog: fix namespaced param names
 * [#1611](https://github.com/stripe/stripe-java/pull/1611) Update generated code
   * Add support for new value `ro_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
   * Add support for `use_stripe_sdk` on `SetupIntentConfirmParams` and `SetupIntentCreateParams`
@@ -1641,9 +1656,8 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `ro_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `tax.CalculationCreateParams.customer_details.tax_ids[].type`
   * Add support for `use_stripe_sdk` on `SetupIntentConfirmParams` and `SetupIntentCreateParams`
   * Add support for new value `service_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
-* [#1610](https://github.com/stripe/stripe-java/pull/1610) Changelog: fix namespaced param names
 
-## 22.27.0 - 2023-07-13
+## <a id="22-27-0"></a>22.27.0 - 2023-07-13
 * [#1606](https://github.com/stripe/stripe-java/pull/1606) Update generated code
   * Add support for new resource `Tax.Settings`
   * Add support for `retrieve` and `update` methods on resource `Settings`
@@ -1652,28 +1666,29 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `product` on `Tax.TransactionLineItem`
   * Add support for new value `tax.settings.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 22.26.0 - 2023-07-06
+## <a id="22-26-0"></a>22.26.0 - 2023-07-06
 * [#1601](https://github.com/stripe/stripe-java/pull/1601) Update generated code
   * Add support for `numeric` and `text` on `PaymentLink.custom_fields[]`
   * Add support for `automatic_tax` on `SubscriptionListParams`
 
-## 22.25.0 - 2023-06-29
+## <a id="22-25-0"></a>22.25.0 - 2023-06-29
 * [#1597](https://github.com/stripe/stripe-java/pull/1597) Update generated code
   * Add support for `effective_at` on `CreditNoteCreateParams`, `CreditNotePreviewLinesParams`, `CreditNotePreviewParams`, `CreditNote`, `InvoiceCreateParams`, `InvoiceUpdateParams`, and `Invoice`
   * Add support for new values `ad_nrt`, `ar_cuit`, `bo_tin`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `pe_ruc`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, and `vn_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxCalculationCreateParams.customer_details.tax_ids[].type`
 
-## 22.24.0 - 2023-06-22
+## <a id="22-24-0"></a>22.24.0 - 2023-06-22
 * [#1591](https://github.com/stripe/stripe-java/pull/1591) Update generated code
   * Add support for `on_behalf_of` on `Mandate`
 
-## 22.23.1 - 2023-06-09
+## <a id="22-23-1"></a>22.23.1 - 2023-06-09
 * [#1582](https://github.com/stripe/stripe-java/pull/1582) Bugfix: fix `Customer.retrievePaymentMethod` URL interpolation
 
-## 22.23.0 - 2023-06-08
+## <a id="22-23-0"></a>22.23.0 - 2023-06-08
 * [#1577](https://github.com/stripe/stripe-java/pull/1577) Update generated code
   * Add support for `taxability_reason` on `Tax.Calculation.tax_breakdown[]`
 
-## 22.22.0 - 2023-06-01
+## <a id="22-22-0"></a>22.22.0 - 2023-06-01
+* [#1572](https://github.com/stripe/stripe-java/pull/1572) Move deserializeStripeObject to StripeObject
 * [#1569](https://github.com/stripe/stripe-java/pull/1569) Update generated code
   * Add support for `numeric` and `text` on `checkout.SessionCreateParams.custom_fields[]`, `PaymentLinkCreateParams.custom_fields[]`, and `PaymentLinkUpdateParams.custom_fields[]`
   * Add support for new values `aba` and `swift` on enums `checkout.SessionCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`
@@ -1682,9 +1697,8 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `preferred_locales` on `Issuing.Cardholder`, `issuing.CardholderCreateParams`, and `issuing.CardholderUpdateParams`
   * Add support for `description`, `iin`, and `issuer` on `PaymentMethod.card_present` and `PaymentMethod.interac_present`
   * Add support for `payer_email` on `PaymentMethod.paypal`
-* [#1572](https://github.com/stripe/stripe-java/pull/1572) Move deserializeStripeObject to StripeObject
 
-## 22.21.0 - 2023-05-25
+## <a id="22-21-0"></a>22.21.0 - 2023-05-25
 * [#1566](https://github.com/stripe/stripe-java/pull/1566) Update generated code
   * Add support for `zip_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `zip` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
@@ -1692,7 +1706,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `zip` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
   * Add support for new value `zip` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
 
-## 22.20.0 - 2023-05-19
+## <a id="22-20-0"></a>22.20.0 - 2023-05-19
 * [#1563](https://github.com/stripe/stripe-java/pull/1563) Update generated code
   * Add support for `subscription_update_confirm` and `subscription_update` on `BillingPortal.Session.flow` and `billingportal.SessionCreateParams.flow_data`
   * Add support for new values `subscription_update_confirm` and `subscription_update` on enum `billingportal.SessionCreateParams.flow_data.type`
@@ -1700,7 +1714,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `buyer_id` and `cashtag` on `Charge.payment_method_details.cashapp` and `PaymentMethod.cashapp`
   * Add support for new values `amusement_tax` and `communications_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
 
-## 22.19.0 - 2023-05-11
+## <a id="22-19-0"></a>22.19.0 - 2023-05-11
 * [#1559](https://github.com/stripe/stripe-java/pull/1559) Update generated code
   * Add support for `paypal` on `Charge.payment_method_details`, `checkout.SessionCreateParams.payment_method_options`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
   * Add support for `network_token` on `Charge.payment_method_details.card`
@@ -1716,36 +1730,35 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `effective_percentage` on `TaxRate`
   * Add support for `gb_bank_transfer` and `jp_bank_transfer` on `CustomerCashBalanceTransactions.funded.bank_transfer`
 
-## 22.18.0 - 2023-05-04
+## <a id="22-18-0"></a>22.18.0 - 2023-05-04
 * [#1555](https://github.com/stripe/stripe-java/pull/1555) Update generated code
   * Add support for `link` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
   * Add support for `brand`, `country`, `description`, `exp_month`, `exp_year`, `fingerprint`, `funding`, `iin`, `issuer`, `last4`, `network`, and `wallet` on `SetupAttempt.payment_method_details.card`
 
-## 22.17.0 - 2023-04-27
+## <a id="22-17-0"></a>22.17.0 - 2023-04-27
+* [#1544](https://github.com/stripe/stripe-java/pull/1544) Update generated code
+* [#1547](https://github.com/stripe/stripe-java/pull/1547) Update generated code
 * [#1551](https://github.com/stripe/stripe-java/pull/1551) Update generated code
   * Add support for `billing_cycle_anchor` and `proration_behavior` on `checkout.SessionCreateParams.subscription_data`
   * Add support for `terminal_id` on `Issuing.Authorization.merchant_data` and `Issuing.Transaction.merchant_data`
   * Add support for `metadata` on `PaymentIntentCaptureParams`
   * Add support for `checks` on `SetupAttempt.payment_method_details.card`
   * Add support for `tax_breakdown` on `Tax.Calculation.shipping_cost` and `Tax.Transaction.shipping_cost`
-* [#1547](https://github.com/stripe/stripe-java/pull/1547) Update generated code
-* [#1544](https://github.com/stripe/stripe-java/pull/1544) Update generated code
-
 
-## 22.16.0 - 2023-04-06
+## <a id="22-16-0"></a>22.16.0 - 2023-04-06
 * [#1540](https://github.com/stripe/stripe-java/pull/1540) Update generated code
   * Add support for `country` on `PaymentMethod.link`
   * Add support for `status_details` on `PaymentMethod.us_bank_account`
 
-## 22.15.0 - 2023-03-30
+## <a id="22-15-0"></a>22.15.0 - 2023-03-30
+* [#1538](https://github.com/stripe/stripe-java/pull/1538) Add missing file purpose terminal_reader_splashscreen
 * [#1536](https://github.com/stripe/stripe-java/pull/1536) 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 `createFromCalculation` method.
   * Add support for `export_license_id` and `export_purpose_code` on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company`, and `TokenCreateParams.account.company`
   * Add support for `amount_tip` on `terminal.ReaderPresentPaymentMethodParams`
-* [#1538](https://github.com/stripe/stripe-java/pull/1538) Add missing file purpose terminal_reader_splashscreen
 
-## 22.14.0 - 2023-03-23
+## <a id="22-14-0"></a>22.14.0 - 2023-03-23
 * [#1531](https://github.com/stripe/stripe-java/pull/1531) 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`
@@ -1755,7 +1768,9 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `link` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
   * Add support for `automatic_payment_methods` on `SetupIntentCreateParams` and `SetupIntent`
 
-## 22.13.0 - 2023-03-16
+## <a id="22-13-0"></a>22.13.0 - 2023-03-16
+* [#1526](https://github.com/stripe/stripe-java/pull/1526) Update generated code (new)
+  Release specs are identical.
 * [#1529](https://github.com/stripe/stripe-java/pull/1529) API Updates
   * Add support for `cashapp_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `future_requirements` and `requirements` on `BankAccount`
@@ -1766,27 +1781,23 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `cashapp_handle_redirect_or_display_qr_code` on `PaymentIntent.next_action` and `SetupIntent.next_action`
   * Add support for new value `payout.reconciliation_completed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-
-* [#1526](https://github.com/stripe/stripe-java/pull/1526) Update generated code (new)
-  Release specs are identical.
-
-## 22.12.0 - 2023-03-09
+## <a id="22-12-0"></a>22.12.0 - 2023-03-09
 * [#1523](https://github.com/stripe/stripe-java/pull/1523) API Updates
   * Add support for `card_issuing` on `issuing.CardholderCreateParams.individual` and `issuing.CardholderUpdateParams.individual`
   * Add support for `cancellation_details` on `SubscriptionCancelParams`, `SubscriptionUpdateParams`, and `Subscription`
 
-## 22.11.0 - 2023-03-02
+## <a id="22-11-0"></a>22.11.0 - 2023-03-02
 * [#1520](https://github.com/stripe/stripe-java/pull/1520) API Updates
   * Add support for new values `electric_vehicle_charging`, `emergency_services_gcas_visa_use_only`, `government_licensed_horse_dog_racing_us_region_only`, `government_licensed_online_casions_online_gambling_us_region_only`, `government_owned_lotteries_non_us_region`, `government_owned_lotteries_us_region_only`, and `marketplaces` on enums `issuing.CardCreateParams.spending_controls.allowed_categories[]`, `issuing.CardCreateParams.spending_controls.blocked_categories[]`, `issuing.CardCreateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardUpdateParams.spending_controls.allowed_categories[]`, `issuing.CardUpdateParams.spending_controls.blocked_categories[]`, `issuing.CardUpdateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardholderCreateParams.spending_controls.allowed_categories[]`, `issuing.CardholderCreateParams.spending_controls.blocked_categories[]`, `issuing.CardholderCreateParams.spending_controls.spending_limits[].categories[]`, `issuing.CardholderUpdateParams.spending_controls.allowed_categories[]`, `issuing.CardholderUpdateParams.spending_controls.blocked_categories[]`, and `issuing.CardholderUpdateParams.spending_controls.spending_limits[].categories[]`
   * Add support for `reconciliation_status` on `Payout`
   * Add support for new value `lease_tax` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
 
-## 22.10.0 - 2023-02-23
+## <a id="22-10-0"></a>22.10.0 - 2023-02-23
 * [#1517](https://github.com/stripe/stripe-java/pull/1517) API Updates
   * Add support for new value `yoursafe` on enums `PaymentIntentConfirmParams.payment_method_data.ideal.bank`, `PaymentIntentCreateParams.payment_method_data.ideal.bank`, `PaymentIntentUpdateParams.payment_method_data.ideal.bank`, `PaymentMethodCreateParams.ideal.bank`, `SetupIntentConfirmParams.payment_method_data.ideal.bank`, `SetupIntentCreateParams.payment_method_data.ideal.bank`, and `SetupIntentUpdateParams.payment_method_data.ideal.bank`
   * Add support for new value `igst` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
 
-## 22.9.0 - 2023-02-16
+## <a id="22-9-0"></a>22.9.0 - 2023-02-16
 * [#1514](https://github.com/stripe/stripe-java/pull/1514) API Updates
   * Add support for `refund_payment` method on resource `Terminal.Reader`
   * Add support for new value `name` on enums `billingportal.ConfigurationCreateParams.features.customer_update.allowed_updates[]` and `billingportal.ConfigurationUpdateParams.features.customer_update.allowed_updates[]`
@@ -1795,7 +1806,7 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Change type of `terminal.ReaderPresentPaymentMethodParams.type` from `literal('card_present')` to `enum('card_present'|'interac_present')`
   * Add support for `refund_payment` on `Terminal.Reader.action`
 
-## 22.8.0 - 2023-02-02
+## <a id="22-8-0"></a>22.8.0 - 2023-02-02
 * [#1512](https://github.com/stripe/stripe-java/pull/1512) API Updates
   * Add support for `resume` method on resource `Subscription`
   * Add support for `payment_link` on `checkout.SessionListParams`
@@ -1810,40 +1821,40 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for new value `paused` on enum `SubscriptionListParams.status`
   * Add support for new values `customer.subscription.paused` and `customer.subscription.resumed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 22.7.0 - 2023-01-26
+## <a id="22-7-0"></a>22.7.0 - 2023-01-26
 * [#1510](https://github.com/stripe/stripe-java/pull/1510) API Updates
   * Add support for new values `cs-CZ`, `el-GR`, `en-CZ`, and `en-GR` on enums `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
 
-## 22.6.0 - 2023-01-19
+## <a id="22-6-0"></a>22.6.0 - 2023-01-19
 * [#1507](https://github.com/stripe/stripe-java/pull/1507) API Updates
   * Add support for `verification_session` on `EphemeralKeyCreateParams`
   * Add support for new values `refund.created` and `refund.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 22.5.1 - 2023-01-12
+## <a id="22-5-1"></a>22.5.1 - 2023-01-12
 * [#1505](https://github.com/stripe/stripe-java/pull/1505) Bump Gson to 2.10.1
 
-## 22.5.0 - 2023-01-05
-* [#1502](https://github.com/stripe/stripe-java/pull/1502) API Updates
-  * Add support for `card_issuing` on `Issuing.Cardholder.individual`
-* [#1501](https://github.com/stripe/stripe-java/pull/1501) Add fix for per-request ApiBase
-* [#1476](https://github.com/stripe/stripe-java/pull/1476) Solution For "Regarding ability to override stripe api url per API re…
+## <a id="22-5-0"></a>22.5.0 - 2023-01-05
+* [#1499](https://github.com/stripe/stripe-java/pull/1499) Fix publish command
 * [#1500](https://github.com/stripe/stripe-java/pull/1500) Deprecate ApiResource.classUrl, etc.
   * Mark `ApiResource.className`, `ApiResource.singleClassUrl`, `ApiResource.classUrl`, `ApiResource.instanceUrl`, and `ApiResource.subresourceUrl` as deprecated
-* [#1499](https://github.com/stripe/stripe-java/pull/1499) Fix publish command
+* [#1476](https://github.com/stripe/stripe-java/pull/1476) Solution For "Regarding ability to override stripe api url per API re…
+* [#1501](https://github.com/stripe/stripe-java/pull/1501) Add fix for per-request ApiBase
+* [#1502](https://github.com/stripe/stripe-java/pull/1502) API Updates
+  * Add support for `card_issuing` on `Issuing.Cardholder.individual`
 
-## 22.4.0 - 2022-12-22
+## <a id="22-4-0"></a>22.4.0 - 2022-12-22
+* [#1491](https://github.com/stripe/stripe-java/pull/1491) Don't delombok sources
+* [#1496](https://github.com/stripe/stripe-java/pull/1496) Replace ReflectionCheckingTypeAdapterFactory with a ReflectionAccessFilter
 * [#1497](https://github.com/stripe/stripe-java/pull/1497) API Updates
   * Add support for new value `merchant_default` on enums `CashBalanceUpdateParams.settings.reconciliation_mode`, `CustomerCreateParams.cash_balance.settings.reconciliation_mode`, and `CustomerUpdateParams.cash_balance.settings.reconciliation_mode`
   * Add support for `using_merchant_default` on `CashBalance.settings`
-* [#1496](https://github.com/stripe/stripe-java/pull/1496) Replace ReflectionCheckingTypeAdapterFactory with a ReflectionAccessFilter
-* [#1491](https://github.com/stripe/stripe-java/pull/1491) Don't delombok sources
 
-## 22.3.0 - 2022-12-08
+## <a id="22-3-0"></a>22.3.0 - 2022-12-08
 * [#1487](https://github.com/stripe/stripe-java/pull/1487) API Updates
   * Change `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`.
   * Added parameterless overload of `Customer.listPaymentMethods`.
 
-## 22.2.0 - 2022-12-06
+## <a id="22-2-0"></a>22.2.0 - 2022-12-06
 * [#1484](https://github.com/stripe/stripe-java/pull/1484) API Updates
   * Add support for `flow_data` on `billingportal.SessionCreateParams`
   * Add support for `flow` on `BillingPortal.Session`
@@ -1853,29 +1864,20 @@ However, [a bug](https://github.com/stripe/stripe-java/pull/1906) in the `27.x.y
   * Add support for `invoice` on `Checkout.Session`
   * Add support for `metadata` on `SubscriptionSchedule.phases[].items[]`, `SubscriptionScheduleCreateParams.phases[].items[]`, and `SubscriptionScheduleUpdateParams.phases[].items[]`
 
-## 22.1.0 - 2022-11-17
+## <a id="22-1-0"></a>22.1.0 - 2022-11-17
 * [#1480](https://github.com/stripe/stripe-java/pull/1480) API Updates
   * Add support for `hosted_instructions_url` on `PaymentIntent.next_action.wechat_pay_display_qr_code`
 * [#1479](https://github.com/stripe/stripe-java/pull/1479) API Updates
   * Add support for `custom_text` on `Checkout.Session`, `checkout.SessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
   * Add support for `hosted_instructions_url` on `PaymentIntent.next_action.paynow_display_qr_code`
 
-## 22.0.0 - 2022-11-16
-* [#1471](https://github.com/stripe/stripe-java/pull/1471) Next major release changes
+## <a id="22-0-0"></a>22.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.
 
-- ⚠️ Inline several "shared" classes for consistency (#1455)
-- ⚠️ Removed `LineItem.Product` property that was released by mistake. (#1456)
-- ⚠️ Removed `Charges` property on `PaymentIntent` and replace it with `LatestCharge` (#1473)
-- ⚠️ Removed deprecated `Amount`, `Currency`, `Description`, `Images`, `Name` properties from `SessionCreateParams.LineItem` (#1473)
-- ⚠️ Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow` (#1473)
-- ⚠️ Removed deprecated `Sku` resource (#1459)
-- ⚠️ Removed deprecated `EphemeralKey.associatedObjects` field. ([#1470](https://github.com/stripe/stripe-java/pull/1470))
-- ⚠️ Removed `RequestOptions.getStripeVersionOverride`, `RequestOptions.setStripeVersionOverride`,  and `RequestOptions.clearStripeVersionOverride` (#1464)
-
 Use of `setStripeVersionOverride` is discouraged and can lead to unexpected errors during service calls because Java SDK class shapes are not guaranteed to match API responses on arbitrary versions.
 
 If you were using these methods in conjunction with `EphemeralKey` resource prefer the `EphemeralKeyCreateParamsBuilder.setStripeVersion`.
@@ -1893,54 +1895,62 @@ builder.setApiKey(...)
 
 RequestOptionsBuilder.unsafeSetStripeVersionOverride(builder, "2022-11-15");
 ```
-* [#1474](https://github.com/stripe/stripe-java/pull/1474) API Updates
-  * ⚠️ Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow`. The property was mistakenly released and never worked.
 
+* ⚠️ [#1456](https://github.com/stripe/stripe-java/pull/1456) Removed `LineItem.Product` property that was released by mistake.
+* ⚠️ [#1455](https://github.com/stripe/stripe-java/pull/1455) Inline several "shared" classes for consistency
+* ⚠️ [#1459](https://github.com/stripe/stripe-java/pull/1459) Removed deprecated `Sku` resource
+* ⚠️ [#1464](https://github.com/stripe/stripe-java/pull/1464) Removed `RequestOptions.getStripeVersionOverride`, `RequestOptions.setStripeVersionOverride`,  and `RequestOptions.clearStripeVersionOverride`
+* ⚠️ [#1470](https://github.com/stripe/stripe-java/pull/1470) Removed deprecated `EphemeralKey.associatedObjects` field.
+* ⚠️ [#1473](https://github.com/stripe/stripe-java/pull/1473) Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow`
+* ⚠️ [#1473](https://github.com/stripe/stripe-java/pull/1473) Removed `Charges` property on `PaymentIntent` and replace it with `LatestCharge`
+* ⚠️ [#1473](https://github.com/stripe/stripe-java/pull/1473) Removed deprecated `Amount`, `Currency`, `Description`, `Images`, `Name` properties from `SessionCreateParams.LineItem`
+* ⚠️ [#1474](https://github.com/stripe/stripe-java/pull/1474) API Updates
+  * ⚠️ Remove support for `tos_shown_and_accepted` on `checkout.SessionCreateParams.payment_method_options.paynow`. The property was mistakenly released and never worked.
+* [#1471](https://github.com/stripe/stripe-java/pull/1471) Next major release changes
 
-## 21.15.0 - 2022-11-08
+## <a id="21-15-0"></a>21.15.0 - 2022-11-08
 * [#1472](https://github.com/stripe/stripe-java/pull/1472) API Updates
   * Add support for new values `eg_tin`, `ph_tin`, and `tr_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `OrderCreateParams.tax_details.tax_ids[].type`, `OrderUpdateParams.tax_details.tax_ids[].type`, and `TaxIdCreateParams.type`
   * Add support for `reason_message` on `Issuing.Authorization.request_history[]`
 
-## 21.14.0 - 2022-11-03
+## <a id="21-14-0"></a>21.14.0 - 2022-11-03
 * [#1466](https://github.com/stripe/stripe-java/pull/1466) API Updates
   * Add support for `on_behalf_of` on `checkout.SessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, `SubscriptionScheduleUpdateParams.phases[]`, `SubscriptionUpdateParams`, and `Subscription`
   * Add support for `tax_behavior` and `tax_code` on `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceUpcomingLinesParams.invoice_items[]`, and `InvoiceUpcomingParams.invoice_items[]`
 
-## 21.13.0 - 2022-10-20
+## <a id="21-13-0"></a>21.13.0 - 2022-10-20
 * [#1461](https://github.com/stripe/stripe-java/pull/1461) API Updates
   * Add support for new values `jp_trn` and `ke_pin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `OrderCreateParams.tax_details.tax_ids[].type`, `OrderUpdateParams.tax_details.tax_ids[].type`, and `TaxIdCreateParams.type`
   * Add support for `tipping` on `Terminal.Reader.action.process_payment_intent.process_config` and `terminal.ReaderProcessPaymentIntentParams.process_config`
 
-## 21.12.0 - 2022-10-14
+## <a id="21-12-0"></a>21.12.0 - 2022-10-14
 * [#1457](https://github.com/stripe/stripe-java/pull/1457) Bugfix: Don't require global API Key when API Key is propagated from list request
 * [#1458](https://github.com/stripe/stripe-java/pull/1458) API Updates
   * Add support for `request_log_url` on `StripeError`
   * Add support for `network_data` on `Issuing.Authorization`
 
-## 21.11.0 - 2022-10-06
+## <a id="21-11-0"></a>21.11.0 - 2022-10-06
+* [#1450](https://github.com/stripe/stripe-java/pull/1450) Set JDK to 17 LTS
 * [#1451](https://github.com/stripe/stripe-java/pull/1451) API Updates
   * Add support for new value `bank_of_china` on enums `PaymentIntentConfirmParams.payment_method_data.fpx.bank`, `PaymentIntentCreateParams.payment_method_data.fpx.bank`, `PaymentIntentUpdateParams.payment_method_data.fpx.bank`, `PaymentMethodCreateParams.fpx.bank`, `SetupIntentConfirmParams.payment_method_data.fpx.bank`, `SetupIntentCreateParams.payment_method_data.fpx.bank`, and `SetupIntentUpdateParams.payment_method_data.fpx.bank`
   * Add support for new values `America/Nuuk`, `Europe/Kyiv`, and `Pacific/Kanton` on enum `reporting.ReportRunCreateParams.parameters.timezone`
   * Add support for `klarna` on `SetupAttempt.payment_method_details`
-* [#1450](https://github.com/stripe/stripe-java/pull/1450) Set JDK to 17 LTS
 
-## 21.10.0 - 2022-09-29
+## <a id="21-10-0"></a>21.10.0 - 2022-09-29
 * [#1448](https://github.com/stripe/stripe-java/pull/1448) API Updates
   * Add support for `created` on `Checkout.Session`
   * Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
   * Deprecate `SessionCreateParams.subscription_data.items` (use the `line_items` param instead). This will be removed in the next major version.
 
-
-## 21.9.0 - 2022-09-22
-* [#1445](https://github.com/stripe/stripe-java/pull/1445) API Updates
+## <a id="21-9-0"></a>21.9.0 - 2022-09-22
+* ⚠️ [#1445](https://github.com/stripe/stripe-java/pull/1445) API Updates
   * Add support for `terms_of_service` on `Checkout.Session.consent_collection`, `Checkout.Session.consent`, `checkout.SessionCreateParams.consent_collection`, `PaymentLink.consent_collection`, and `PaymentLinkCreateParams.consent_collection`
   * ⚠️ Remove support for `plan` on `checkout.SessionCreateParams.payment_method_options.card.installments`. The property was mistakenly released and never worked.
   * Add support for `amount` on `issuing.DisputeCreateParams` and `issuing.DisputeUpdateParams`
   * Add support for `statement_descriptor` on `PaymentIntentIncrementAuthorizationParams`
   * Add `upcomingLines` method to `Invoice` resource.
 
-## 21.8.0 - 2022-09-15
+## <a id="21-8-0"></a>21.8.0 - 2022-09-15
 * [#1444](https://github.com/stripe/stripe-java/pull/1444) API Updates
   * Add support for `pix` on `Charge.payment_method_details`, `Checkout.Session.payment_method_options`, `checkout.SessionCreateParams.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
   * Add support for new value `pix` on enum `checkout.SessionCreateParams.payment_method_types[]`
@@ -1953,33 +1963,38 @@ RequestOptionsBuilder.unsafeSetStripeVersionOverride(builder, "2022-11-15");
   * Add support for new value `pix` on enum `PaymentMethodCreateParams.type`
   * Add support for `created` on `Treasury.CreditReversal` and `Treasury.DebitReversal`
 
-## 21.7.0 - 2022-09-09
+## <a id="21-7-0"></a>21.7.0 - 2022-09-09
 * [#1435](https://github.com/stripe/stripe-java/pull/1435) API Updates
   * Add support for `require_signature` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
 
-## 21.6.0 - 2022-09-06
+## <a id="21-6-0"></a>21.6.0 - 2022-09-06
 * [#1434](https://github.com/stripe/stripe-java/pull/1434) API Updates
   * Add support for new value `terminal_reader_splashscreen` on enum `FileListParams.purpose`
   * Fix `LineItem.Discount.discount` to reference the correct `Discount` class (`com.stripe.model.Discount`)
 
-
-## 21.5.0 - 2022-08-31
+## <a id="21-5-0"></a>21.5.0 - 2022-08-31
+* [#1431](https://github.com/stripe/stripe-java/pull/1431) Update coveralls to only run for one java version
+* [#1432](https://github.com/stripe/stripe-java/pull/1432) Update README badge
 * [#1433](https://github.com/stripe/stripe-java/pull/1433) API Updates
   * Add support for new values `de-CH`, `en-CH`, `en-PL`, `en-PT`, `fr-CH`, `it-CH`, `pl-PL`, and `pt-PT` on enums `OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
   * Add support for `description` on `PaymentLink.subscription_data` and `PaymentLinkCreateParams.subscription_data`
-* [#1432](https://github.com/stripe/stripe-java/pull/1432) Update README badge
-* [#1431](https://github.com/stripe/stripe-java/pull/1431) Update coveralls to only run for one java version
 
-## 21.4.0 - 2022-08-26
+## <a id="21-4-0"></a>21.4.0 - 2022-08-26
+* [#1428](https://github.com/stripe/stripe-java/pull/1428) Show test coverage in README
+* [#1427](https://github.com/stripe/stripe-java/pull/1427) Update README.md to clarify that API version can only be change in beta
 * [#1430](https://github.com/stripe/stripe-java/pull/1430) API Updates
   * Add support for `login_page` on `BillingPortal.Configuration`, `billingportal.ConfigurationCreateParams`, and `billingportal.ConfigurationUpdateParams`
   * Add support for `customs` and `phone_number` on `Issuing.Card.shipping` and `issuing.CardCreateParams.shipping`
   * Add support for new value `deutsche_bank_ag` on enums `PaymentIntentConfirmParams.payment_method_data.eps.bank`, `PaymentIntentCreateParams.payment_method_data.eps.bank`, `PaymentIntentUpdateParams.payment_method_data.eps.bank`, `PaymentMethodCreateParams.eps.bank`, `SetupIntentConfirmParams.payment_method_data.eps.bank`, `SetupIntentCreateParams.payment_method_data.eps.bank`, and `SetupIntentUpdateParams.payment_method_data.eps.bank`
   * Add support for `description` on `Quote.subscription_data`, `QuoteCreateParams.subscription_data`, `QuoteUpdateParams.subscription_data`, `SubscriptionSchedule.default_settings`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.default_settings`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.default_settings`, and `SubscriptionScheduleUpdateParams.phases[]`
-* [#1428](https://github.com/stripe/stripe-java/pull/1428) Show test coverage in README
-* [#1427](https://github.com/stripe/stripe-java/pull/1427) Update README.md to clarify that API version can only be change in beta
 
-## 21.3.0 - 2022-08-23
+## <a id="21-3-0"></a>21.3.0 - 2022-08-23
+* [#1418](https://github.com/stripe/stripe-java/pull/1418) Fix latest JAR hyperlink and related tests
+* [#1419](https://github.com/stripe/stripe-java/pull/1419) Fix makefile indentation and improve regex
+* [#1420](https://github.com/stripe/stripe-java/pull/1420) Fix outdated test comment
+* [#1421](https://github.com/stripe/stripe-java/pull/1421) Add a support section to the readme
+* [#1423](https://github.com/stripe/stripe-java/pull/1423) chore: Remove unused variable from SearchPagingIteratorTest.
+* [#1425](https://github.com/stripe/stripe-java/pull/1425) Add beta readme.md section
 * [#1422](https://github.com/stripe/stripe-java/pull/1422) API Updates
   * Add support for new resource `CustomerCashBalanceTransaction`
   * Remove support for value `paypal` from enums `OrderCreateParams.payment.settings.payment_method_types[]` and `OrderUpdateParams.payment.settings.payment_method_types[]`
@@ -1989,87 +2004,77 @@ RequestOptionsBuilder.unsafeSetStripeVersionOverride(builder, "2022-11-15");
   * Add support for new value `customer_cash_balance_transaction.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
   * Change the return type of `Customer.fundCashBalance` test helper from `CustomerBalanceTransaction` to `CustomerCashBalanceTransaction`.
     * This would generally be considered a breaking change, but we've worked with all existing users to migrate and are comfortable releasing this as a minor as it is solely a test helper method. This was essentially broken prior to this change.
-* [#1425](https://github.com/stripe/stripe-java/pull/1425) Add beta readme.md section
-* [#1423](https://github.com/stripe/stripe-java/pull/1423) chore: Remove unused variable from SearchPagingIteratorTest.
-* [#1421](https://github.com/stripe/stripe-java/pull/1421) Add a support section to the readme
-* [#1420](https://github.com/stripe/stripe-java/pull/1420) Fix outdated test comment
-* [#1418](https://github.com/stripe/stripe-java/pull/1418) Fix latest JAR hyperlink and related tests
-* [#1419](https://github.com/stripe/stripe-java/pull/1419) Fix makefile indentation and improve regex
 
-## 21.2.0 - 2022-08-11
+## <a id="21-2-0"></a>21.2.0 - 2022-08-11
+* [#1414](https://github.com/stripe/stripe-java/pull/1414) Stop publishing javadoc for beta Java SDKs
 * [#1416](https://github.com/stripe/stripe-java/pull/1416) API Updates
   * Add support for `payment_method_collection` on `Checkout.Session`, `checkout.SessionCreateParams`, `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
 
-* [#1414](https://github.com/stripe/stripe-java/pull/1414) Stop publishing javadoc for beta Java SDKs
-
-## 21.1.0 - 2022-08-09
-* [#1413](https://github.com/stripe/stripe-java/pull/1413) API Updates
-  * Add support for `process_config` on `Terminal.Reader.action.process_payment_intent`
+## <a id="21-1-0"></a>21.1.0 - 2022-08-09
 * [#1412](https://github.com/stripe/stripe-java/pull/1412) API Updates
   * Add support for `expires_at` on `Apps.Secret` and `apps.SecretCreateParams`
+* [#1413](https://github.com/stripe/stripe-java/pull/1413) API Updates
+  * Add support for `process_config` on `Terminal.Reader.action.process_payment_intent`
 
-## 21.0.0 - 2022-08-02
+## <a id="21-0-0"></a>21.0.0 - 2022-08-02
+This release changes the pinned API version to `2022-08-01`.
 
 This release includes breaking changes resulting from:
 
-* Moving to use the new API version "2022-08-01". To learn more about these changes to Stripe products, see https://docs.stripe.com/changelog/2022-08-01
-* Cleaning up the SDK to remove deprecated/unused APIs and rename classes/methods/properties to sync with product APIs. Read more detailed description at https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v21.
-
 "⚠️" symbol highlights breaking changes.
 
-* [#1409](https://github.com/stripe/stripe-java/pull/1409) API Updates
+* Cleaning up the SDK to remove deprecated/unused APIs and rename classes/methods/properties to sync with product APIs. Read more detailed description at https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v21.
+* Moving to use the new API version "2022-08-01". To learn more about these changes to Stripe products, see https://docs.stripe.com/changelog/2022-08-01
 * [#1407](https://github.com/stripe/stripe-java/pull/1407) Next major release changes
+* [#1409](https://github.com/stripe/stripe-java/pull/1409) API Updates
 
 ### Added
 * Add `ApiKeyMissingException`.
+* Add `shippingCost`, `shippingDetails`, and `shippingOptions` properties to `checkout.Session` resource.
+* Add support for new value `2022-08-01` on enum `WebhookEndpointCreateParams.api_version`
+* Add support for `shipping_cost` and `shipping_details` on `Checkout.Session`
 * Add `validate` field to `CustomerCreateParams`.
 * Add `validate` field to `CustomerUpdateParams`.
 * Add `validate` field to `PaymentSourceCollectionCreateParams`.
-* Add `shippingCost`, `shippingDetails`, and `shippingOptions` properties to `checkout.Session` resource.
-* Add support for `shipping_cost` and `shipping_details` on `Checkout.Session`
-* Add support for new value `2022-08-01` on enum `WebhookEndpointCreateParams.api_version`
-
-### ⚠️ Removed
-
-- Removed deprecated `AlipayAccount` and related classes.
-- Removed deprecated `BitcoinReceiver` and related classes.
-- Removed deprecated `BitcoinTransaction` and related classes.
-- Removed deprecated `Recipient` and related classes.
-- Removed deprecated `IssuerFraudRecord` and related classes.
-- Removed deprecated `Order` and related classes.
-- Removed deprecated `ThreeDSecure` and related classes.
-- Removed unused `QuoteFinalizeParams`, `QuoteCollectionListParams` classes.
-- Removed unused `BillingDetails` class.
-- Removed `CashBalance.retrieveCashBalance` method. Prefer `CashBalance.retrieve`.
-- Removed `Rule.getDeleted` method. The property was never populated and always had the default value of `false`.
-- Removed `LineItem.getDeleted` method. The property was never populated and always had the default value of `false`.
-- Removed public constructors from `TestHelper` inner classes and made them static.
-- Removed instance `Account.refresh`, `Account.disconnect` methods.
-- Removed deprecated `TREASURY__RECEIVED_CREDIT__REVERSED`, `TREASURY__RECEIVED_DEBIT__CREATED`, `ORDER__UPDATED`, `ORDER_RETURN__CREATED`, `ORDER__PAYMENT_SUCCEEDED`, `TRANSFER__FAILED`, `TRANSFER__PAID` webhook events.
-- Removed deprecated `LoginLink.redirectUrl` property.
-- Removed deprecated `Charge.order` property.
-- Removed deprecated `Card.recipient` property.
-- Removed `defaultCurrency` property from `Customer` resource. Please use `Currency` property instead.
-- Removed `shipping` and `shippingOptions` properties from `checkout.Session` resource. Please use `shippingCost`, `shippingDetails`, and `shippingOptions` properties instead.
-- Removed `InitiatingPaymentMethodDetails` class
 
 ### ⚠️ Changed
+* ⚠️ Changed `CashBalance.retrieve` method from an instance to a static.
+* ⚠️ Changed type of `businessType` field in `AccountCreateParams` from `Object` to `BusinessType`
+* ⚠️ Check that apiKey is set (either globally or via request options) in `StripeCollection.autoPagingIterable` and `StripeSearchResult.autoPagingIterable`, and throw an exception if it is not.
+* ⚠️ Default API version changed to "2022-07-28".
+* ⚠️ Renamed `PaymentIntent.FinancialAddresses` class to `FinancialAddress`.
 
-- Default API version changed to "2022-07-28".
-- Changed `CashBalance.retrieve` method from an instance to a static.
-- Renamed `PaymentIntent.FinancialAddresses` class to `FinancialAddress`.
-- Check that apiKey is set (either globally or via request options) in `StripeCollection.autoPagingIterable` and `StripeSearchResult.autoPagingIterable`, and throw an exception if it is not.
-- Changed type of `businessType` field in `AccountCreateParams` from `Object` to `BusinessType`
-
-
-## 20.136.0 - 2022-07-26
+### ⚠️ Removed
+* ⚠️ Removed `CashBalance.retrieveCashBalance` method. Prefer `CashBalance.retrieve`.
+* ⚠️ Removed `defaultCurrency` property from `Customer` resource. Please use `Currency` property instead.
+* ⚠️ Removed deprecated `AlipayAccount` and related classes.
+* ⚠️ Removed deprecated `BitcoinReceiver` and related classes.
+* ⚠️ Removed deprecated `BitcoinTransaction` and related classes.
+* ⚠️ Removed deprecated `Card.recipient` property.
+* ⚠️ Removed deprecated `Charge.order` property.
+* ⚠️ Removed deprecated `IssuerFraudRecord` and related classes.
+* ⚠️ Removed deprecated `LoginLink.redirectUrl` property.
+* ⚠️ Removed deprecated `Order` and related classes.
+* ⚠️ Removed deprecated `Recipient` and related classes.
+* ⚠️ Removed deprecated `ThreeDSecure` and related classes.
+* ⚠️ Removed deprecated `TREASURY__RECEIVED_CREDIT__REVERSED`, `TREASURY__RECEIVED_DEBIT__CREATED`, `ORDER__UPDATED`, `ORDER_RETURN__CREATED`, `ORDER__PAYMENT_SUCCEEDED`, `TRANSFER__FAILED`, `TRANSFER__PAID` webhook events.
+* ⚠️ Removed `InitiatingPaymentMethodDetails` class
+* ⚠️ Removed instance `Account.refresh`, `Account.disconnect` methods.
+* ⚠️ Removed `LineItem.getDeleted` method. The property was never populated and always had the default value of `false`.
+* ⚠️ Removed public constructors from `TestHelper` inner classes and made them static.
+* ⚠️ Removed `Rule.getDeleted` method. The property was never populated and always had the default value of `false`.
+* ⚠️ Removed `shipping` and `shippingOptions` properties from `checkout.Session` resource. Please use `shippingCost`, `shippingDetails`, and `shippingOptions` properties instead.
+* ⚠️ Removed unused `BillingDetails` class.
+* ⚠️ Removed unused `QuoteFinalizeParams`, `QuoteCollectionListParams` classes.
+
+## <a id="20-136-0"></a>20.136.0 - 2022-07-26
+* [#1405](https://github.com/stripe/stripe-java/pull/1405) chore: Update gson version in README.
 * [#1406](https://github.com/stripe/stripe-java/pull/1406) API Updates
   * Add support for `customer_balance` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
   * Add support for new value `customer_balance` on enum `checkout.SessionCreateParams.payment_method_types[]`
   * Add support for new values `en-CA` and `fr-CA` on enums `OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_locale`, `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`
-* [#1405](https://github.com/stripe/stripe-java/pull/1405) chore: Update gson version in README.
 
-## 20.135.0 - 2022-07-25
+## <a id="20-135-0"></a>20.135.0 - 2022-07-25
 * [#1402](https://github.com/stripe/stripe-java/pull/1402) API Updates
   * Add support for `installments` on `Checkout.Session.payment_method_options.card`, `checkout.SessionCreateParams.payment_method_options.card`, `Invoice.payment_settings.payment_method_options.card`, `InvoiceCreateParams.payment_settings.payment_method_options.card`, and `InvoiceUpdateParams.payment_settings.payment_method_options.card`
   * Add support for `default_currency` and `invoice_credit_balance` on `Customer`
@@ -2077,8 +2082,7 @@ This release includes breaking changes resulting from:
   * Add support for `default_mandate` on `Invoice.payment_settings`, `InvoiceCreateParams.payment_settings`, and `InvoiceUpdateParams.payment_settings`
   * Add support for `mandate` on `InvoicePayParams`
 
-
-## 20.134.0 - 2022-07-18
+## <a id="20-134-0"></a>20.134.0 - 2022-07-18
 * [#1391](https://github.com/stripe/stripe-java/pull/1391) API Updates
   * Add support for `blik_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `blik` on `Charge.payment_method_details`, `Mandate.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupAttempt.payment_method_details`, `SetupIntent.payment_method_options`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentConfirmParams.payment_method_options`, `SetupIntentCreateParams.payment_method_data`, `SetupIntentCreateParams.payment_method_options`, `SetupIntentUpdateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_options`
@@ -2089,29 +2093,31 @@ This release includes breaking changes resulting from:
   * Add support for new value `blik` on enums `PaymentLinkCreateParams.payment_method_types[]` and `PaymentLinkUpdateParams.payment_method_types[]`
   * Add support for new value `blik` on enum `PaymentMethodCreateParams.type`
 
-## 20.133.0 - 2022-07-12
+## <a id="20-133-0"></a>20.133.0 - 2022-07-12
 * [#1390](https://github.com/stripe/stripe-java/pull/1390) API Updates
   * Add support for `customer_details` on `checkout.SessionListParams`
 
-## 20.132.0 - 2022-07-07
+## <a id="20-132-0"></a>20.132.0 - 2022-07-07
+* [#1386](https://github.com/stripe/stripe-java/pull/1386) Support serializing nested objects in map
+* [#1387](https://github.com/stripe/stripe-java/pull/1387) API Updates
+  * Add support for `customer` on `checkout.SessionListParams` and `RefundCreateParams`
+  * Add support for `currency` and `origin` on `RefundCreateParams`
+  * Add support for new values `financial_connections.account.created`, `financial_connections.account.deactivated`, `financial_connections.account.disconnected`, `financial_connections.account.reactivated`, and `financial_connections.account.refreshed_balance` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 * [#1388](https://github.com/stripe/stripe-java/pull/1388) API Updates
   * Add support for `currency` on `checkout.SessionCreateParams`, `InvoiceUpcomingLinesParams`, `InvoiceUpcomingParams`, `PaymentLinkCreateParams`, `SubscriptionCreateParams`, `SubscriptionSchedule.phases[]`, `SubscriptionScheduleCreateParams.phases[]`, `SubscriptionScheduleUpdateParams.phases[]`, and `Subscription`
   * Add support for `currency_options` on `checkout.SessionCreateParams.shipping_options[].shipping_rate_data.fixed_amount`, `CouponCreateParams`, `CouponUpdateParams`, `Coupon`, `OrderCreateParams.shipping_cost.shipping_rate_data.fixed_amount`, `OrderUpdateParams.shipping_cost.shipping_rate_data.fixed_amount`, `PriceCreateParams`, `PriceUpdateParams`, `Price`, `ProductCreateParams.default_price_data`, `PromotionCode.restrictions`, `PromotionCodeCreateParams.restrictions`, `ShippingRate.fixed_amount`, and `ShippingRateCreateParams.fixed_amount`
   * Add support for `restrictions` on `PromotionCodeUpdateParams`
   * Add support for `fixed_amount` and `tax_behavior` on `ShippingRateUpdateParams`
-* [#1387](https://github.com/stripe/stripe-java/pull/1387) API Updates
-  * Add support for `customer` on `checkout.SessionListParams` and `RefundCreateParams`
-  * Add support for `currency` and `origin` on `RefundCreateParams`
-  * Add support for new values `financial_connections.account.created`, `financial_connections.account.deactivated`, `financial_connections.account.disconnected`, `financial_connections.account.reactivated`, and `financial_connections.account.refreshed_balance` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-* [#1386](https://github.com/stripe/stripe-java/pull/1386) Support serializing nested objects in map
 
-## 20.131.0 - 2022-06-29
+## <a id="20-131-0"></a>20.131.0 - 2022-06-29
 * [#1384](https://github.com/stripe/stripe-java/pull/1384) API Updates
   * Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
   * Change type of `PaymentLink.payment_method_types[]`, `PaymentLinkCreateParams.payment_method_types[]`, and `PaymentLinkUpdateParams.payment_method_types[]` from `literal('card')` to `enum`
   * Add support for `hosted_regulatory_receipt_url` on `Treasury.ReceivedCredit` and `Treasury.ReceivedDebit`
 
-## 20.130.0 - 2022-06-23
+## <a id="20-130-0"></a>20.130.0 - 2022-06-23
+* [#1376](https://github.com/stripe/stripe-java/pull/1376) Document how to access unsupported parameters and properties
+* [#1379](https://github.com/stripe/stripe-java/pull/1379) Use the generated API version
 * [#1380](https://github.com/stripe/stripe-java/pull/1380) API Updates
   * Add support for `capture_method` on `PaymentIntentConfirmParams` and `PaymentIntentUpdateParams`
 * [#1378](https://github.com/stripe/stripe-java/pull/1378) API Updates
@@ -2128,10 +2134,10 @@ This release includes breaking changes resulting from:
   * Add support for new value `promptpay` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
   * Add support for `promptpay_display_qr_code` on `PaymentIntent.next_action`
   * Add support for new value `promptpay` on enum `PaymentMethodCreateParams.type`
-* [#1379](https://github.com/stripe/stripe-java/pull/1379) Use the generated API version
-* [#1376](https://github.com/stripe/stripe-java/pull/1376) Document how to access unsupported parameters and properties
 
-## 20.129.0 - 2022-06-17
+## <a id="20-129-0"></a>20.129.0 - 2022-06-17
+* [#1372](https://github.com/stripe/stripe-java/pull/1372) Update readme example to use typed params.
+* [#1373](https://github.com/stripe/stripe-java/pull/1373) Trigger workflows on beta branches
 * [#1375](https://github.com/stripe/stripe-java/pull/1375) API Updates
   * Add support for `fund_cash_balance` test helper method on resource `Customer`
   * Add support for `statement_descriptor_prefix_kana` and `statement_descriptor_prefix_kanji` on `Account.settings.card_payments`, `Account.settings.payments`, `AccountCreateParams.settings.card_payments`, and `AccountUpdateParams.settings.card_payments`
@@ -2139,10 +2145,8 @@ This release includes breaking changes resulting from:
   * Add support for `total_excluding_tax` on `CreditNote`
   * Change type of `CustomerCreateParams.invoice_settings.rendering_options` and `CustomerUpdateParams.invoice_settings.rendering_options` from `rendering_options_param` to `emptyStringable(rendering_options_param)`
   * Add support for `rendering_options` on `Customer.invoice_settings` and `Invoice`
-* [#1373](https://github.com/stripe/stripe-java/pull/1373) Trigger workflows on beta branches
-* [#1372](https://github.com/stripe/stripe-java/pull/1372) Update readme example to use typed params.
 
-## 20.128.0 - 2022-06-09
+## <a id="20-128-0"></a>20.128.0 - 2022-06-09
 * [#1370](https://github.com/stripe/stripe-java/pull/1370) API Updates
   * Add support for `treasury` on `Account.settings`, `AccountCreateParams.settings`, and `AccountUpdateParams.settings`
   * Add support for `rendering_options` on `CustomerCreateParams.invoice_settings` and `CustomerUpdateParams.invoice_settings`
@@ -2153,7 +2157,7 @@ This release includes breaking changes resulting from:
   * Change type of `Order.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderCreateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `OrderUpdateParams.payment.settings.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntent.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentConfirmParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, `PaymentIntentCreateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]`, and `PaymentIntentUpdateParams.payment_method_options.customer_balance.bank_transfer.requested_address_types[]` from `literal('zengin')` to `enum`
   * Add support for `custom_unit_amount` on `PriceCreateParams` and `Price`
 
-## 20.127.0 - 2022-06-08
+## <a id="20-127-0"></a>20.127.0 - 2022-06-08
 * [#1369](https://github.com/stripe/stripe-java/pull/1369) API Updates
   * Add support for `affirm`, `bancontact`, `card`, `ideal`, `p24`, and `sofort` on `Checkout.Session.payment_method_options` and `checkout.SessionCreateParams.payment_method_options`
   * Add support for `afterpay_clearpay`, `au_becs_debit`, `bacs_debit`, `eps`, `fpx`, `giropay`, `grabpay`, `klarna`, `paynow`, and `sepa_debit` on `checkout.SessionCreateParams.payment_method_options`
@@ -2161,13 +2165,13 @@ This release includes breaking changes resulting from:
   * Add support for `attach_to_self` on `SetupAttempt`, `SetupIntentCreateParams`, `SetupIntentListParams`, and `SetupIntentUpdateParams`
   * Add support for `flow_directions` on `SetupAttempt`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
 
-## 20.126.0 - 2022-06-02
+## <a id="20-126-0"></a>20.126.0 - 2022-06-02
 * [#1367](https://github.com/stripe/stripe-java/pull/1367) API Updates
   * Add support for `create` test helper on `ReceivedCredit`.
   * Add support for `create` test helper on `ReceivedDebit`.
   * Deprecates the ability to directly create instances of inner `TestHelper` classes.
 
-## 20.125.0 - 2022-06-01
+## <a id="20-125-0"></a>20.125.0 - 2022-06-01
 * [#1366](https://github.com/stripe/stripe-java/pull/1366) API Updates
   * Add support for `radar_options` on `ChargeCreateParams`, `Charge`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentMethodCreateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
   * Add support for `account_holder_name`, `account_number`, `account_type`, `bank_code`, `bank_name`, `branch_code`, and `branch_name` on `FundingInstructions.bank_transfer.financial_addresses[].zengin` and `PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin`
@@ -2176,7 +2180,10 @@ This release includes breaking changes resulting from:
   * Add support for `network` on `SetupIntent.payment_method_options.card`
   * Add support for new value `simulated_wisepos_e` on enum `terminal.ReaderListParams.device_type`
 
-## 20.124.0 - 2022-05-26
+## <a id="20-124-0"></a>20.124.0 - 2022-05-26
+* [#1361](https://github.com/stripe/stripe-java/pull/1361) Fix version update script and the version in README.md
+* [#1360](https://github.com/stripe/stripe-java/pull/1360) API Updates
+  * Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
 * [#1363](https://github.com/stripe/stripe-java/pull/1363) API Updates
   * Add support for `affirm_payments` and `link_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `id_number_secondary` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
@@ -2185,15 +2192,14 @@ This release includes breaking changes resulting from:
   * Add support for `id_number_secondary_provided` on `Person`
   * Add support for `card_issuing` on `treasury.FinancialAccountCreateParams.features`, `treasury.FinancialAccountUpdateFeaturesParams`, and `treasury.FinancialAccountUpdateParams.features`
 
-* [#1361](https://github.com/stripe/stripe-java/pull/1361) Fix version update script and the version in README.md
-* [#1360](https://github.com/stripe/stripe-java/pull/1360) API Updates
-  * Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
-
-## 20.123.0 - 2022-05-23
+## <a id="20-123-0"></a>20.123.0 - 2022-05-23
 * [#1360](https://github.com/stripe/stripe-java/pull/1360) API Updates
   * Add support for `treasury` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
 
-## 20.122.0 - 2022-05-23
+## <a id="20-122-0"></a>20.122.0 - 2022-05-23
+* [#1357](https://github.com/stripe/stripe-java/pull/1357) Revert master trigger
+* [#1356](https://github.com/stripe/stripe-java/pull/1356) Temporary allow triggering docs push from master
+* [#1355](https://github.com/stripe/stripe-java/pull/1355) Use github.actor as GRGIT_USER
 * [#1359](https://github.com/stripe/stripe-java/pull/1359) API Updates
   * Add support for new resource `Apps.Secret`
   * Add support for `affirm` on `Charge.payment_method_details`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `SetupIntentConfirmParams.payment_method_data`, `SetupIntentCreateParams.payment_method_data`, and `SetupIntentUpdateParams.payment_method_data`
@@ -2202,13 +2208,12 @@ This release includes breaking changes resulting from:
   * Add support for new value `link` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
   * Add support for new values `affirm` and `link` on enums `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `SetupIntentConfirmParams.payment_method_data.type`, `SetupIntentCreateParams.payment_method_data.type`, and `SetupIntentUpdateParams.payment_method_data.type`
   * Add support for new values `affirm` and `link` on enum `PaymentMethodCreateParams.type`
-* [#1357](https://github.com/stripe/stripe-java/pull/1357) Revert master trigger
-* [#1356](https://github.com/stripe/stripe-java/pull/1356) Temporary allow triggering docs push from master
-* [#1355](https://github.com/stripe/stripe-java/pull/1355) Use github.actor as GRGIT_USER
 
-## 20.121.0 - 2022-05-19
+## <a id="20-121-0"></a>20.121.0 - 2022-05-19
+* [#1340](https://github.com/stripe/stripe-java/pull/1340) Publish Java package from Github actions
+* [#1352](https://github.com/stripe/stripe-java/pull/1352) Finish automated Java releases
+* [#1353](https://github.com/stripe/stripe-java/pull/1353) Update readme with new jar download URL
 * [#1354](https://github.com/stripe/stripe-java/pull/1354) 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`
@@ -2222,11 +2227,8 @@ This release includes breaking changes resulting from:
   * Add support for `save_default_payment_method` on `Subscription.payment_settings`, `SubscriptionCreateParams.payment_settings`, and `SubscriptionUpdateParams.payment_settings`
   * Add support for `czk` on `Terminal.Configuration.tipping`, `terminal.ConfigurationCreateParams.tipping`, and `terminal.ConfigurationUpdateParams.tipping`
   * Add support for new values `treasury.credit_reversal.created`, `treasury.credit_reversal.posted`, `treasury.debit_reversal.completed`, `treasury.debit_reversal.created`, `treasury.debit_reversal.initial_credit_granted`, `treasury.financial_account.closed`, `treasury.financial_account.created`, `treasury.financial_account.features_status_updated`, `treasury.inbound_transfer.canceled`, `treasury.inbound_transfer.created`, `treasury.inbound_transfer.failed`, `treasury.inbound_transfer.succeeded`, `treasury.outbound_payment.canceled`, `treasury.outbound_payment.created`, `treasury.outbound_payment.expected_arrival_date_updated`, `treasury.outbound_payment.failed`, `treasury.outbound_payment.posted`, `treasury.outbound_payment.returned`, `treasury.outbound_transfer.canceled`, `treasury.outbound_transfer.created`, `treasury.outbound_transfer.expected_arrival_date_updated`, `treasury.outbound_transfer.failed`, `treasury.outbound_transfer.posted`, `treasury.outbound_transfer.returned`, `treasury.received_credit.created`, `treasury.received_credit.failed`, `treasury.received_credit.reversed`, `treasury.received_credit.succeeded`, and `treasury.received_debit.created` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
-* [#1353](https://github.com/stripe/stripe-java/pull/1353) Update readme with new jar download URL
-* [#1352](https://github.com/stripe/stripe-java/pull/1352) Finish automated Java releases
-* [#1340](https://github.com/stripe/stripe-java/pull/1340) Publish Java package from Github actions
 
-## 20.120.0 - 2022-05-11
+## <a id="20-120-0"></a>20.120.0 - 2022-05-11
 * [#1351](https://github.com/stripe/stripe-java/pull/1351) API Updates
   * Add support for `description` on `checkout.SessionCreateParams.subscription_data`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
   * Add support for `consent_collection`, `payment_intent_data`, `shipping_options`, `submit_type`, and `tax_id_collection` on `PaymentLinkCreateParams` and `PaymentLink`
@@ -2236,25 +2238,22 @@ This release includes breaking changes resulting from:
 * [#1350](https://github.com/stripe/stripe-java/pull/1350) API Updates
   * Add support for `amount_discount`, `amount_tax`, and `product` on `LineItem`
 
-
-## 20.119.0 - 2022-05-05
+## <a id="20-119-0"></a>20.119.0 - 2022-05-05
 * [#1349](https://github.com/stripe/stripe-java/pull/1349) API Updates
   * Add support for `default_price_data` on `ProductCreateParams`
   * Add support for `default_price` on `ProductUpdateParams` and `Product`
   * Add support for `instructions_email` on `RefundCreateParams` and `Refund`
 
-
-## 20.118.0 - 2022-05-05
+## <a id="20-118-0"></a>20.118.0 - 2022-05-05
+* [#1347](https://github.com/stripe/stripe-java/pull/1347) API Updates
+  * Add support for `registered_address` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
+  * Add support for `payment_method_data` on `SetupIntentConfirmParams`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
 * [#1348](https://github.com/stripe/stripe-java/pull/1348) API Updates
   * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
   * Add support for `financial_connections` on `Checkout.Session.payment_method_options.us_bank_account`, `checkout.SessionCreateParams.payment_method_options.us_bank_account`, `Invoice.payment_settings.payment_method_options.us_bank_account`, `InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account`, `InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account`, `PaymentIntent.payment_method_options.us_bank_account`, `PaymentIntentConfirmParams.payment_method_options.us_bank_account`, `PaymentIntentCreateParams.payment_method_options.us_bank_account`, `PaymentIntentUpdateParams.payment_method_options.us_bank_account`, `SetupIntent.payment_method_options.us_bank_account`, `SetupIntentConfirmParams.payment_method_options.us_bank_account`, `SetupIntentCreateParams.payment_method_options.us_bank_account`, `SetupIntentUpdateParams.payment_method_options.us_bank_account`, `Subscription.payment_settings.payment_method_options.us_bank_account`, `SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account`
   * Add support for `financial_connections_account` on `PaymentIntentConfirmParams.payment_method_data.us_bank_account`, `PaymentIntentCreateParams.payment_method_data.us_bank_account`, `PaymentIntentUpdateParams.payment_method_data.us_bank_account`, `PaymentMethod.us_bank_account`, `PaymentMethodCreateParams.us_bank_account`, `SetupIntentConfirmParams.payment_method_data.us_bank_account`, `SetupIntentCreateParams.payment_method_data.us_bank_account`, and `SetupIntentUpdateParams.payment_method_data.us_bank_account`
 
-* [#1347](https://github.com/stripe/stripe-java/pull/1347) API Updates
-  * Add support for `registered_address` on `AccountCreateParams.individual`, `AccountUpdateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
-  * Add support for `payment_method_data` on `SetupIntentConfirmParams`, `SetupIntentCreateParams`, and `SetupIntentUpdateParams`
-
-## 20.117.0 - 2022-05-03
+## <a id="20-117-0"></a>20.117.0 - 2022-05-03
 * [#1346](https://github.com/stripe/stripe-java/pull/1346) API Updates
   * Add support for new resource `CashBalance`
   * Change type of `BillingPortal.Configuration.application` from `$Application` to `deletable($Application)`
@@ -2263,15 +2262,14 @@ This release includes breaking changes resulting from:
   * Add support for `cash_balance` on `Customer`
   * Add support for `application` on `Invoice`, `Quote`, `SubscriptionSchedule`, and `Subscription`
 
-
-## 20.116.0 - 2022-04-21
+## <a id="20-116-0"></a>20.116.0 - 2022-04-21
+* [#1342](https://github.com/stripe/stripe-java/pull/1342) Add null checks before streaming expandable IDs in setters.
 * [#1345](https://github.com/stripe/stripe-java/pull/1345) API Updates
   * Add support for `expire` test helper method on resource `Refund`
   * Change type of `BillingPortal.Configuration.application` from `string` to `expandable($Application)`
   * Change `issuing.DisputeCreateParams.transaction` to be optional
-* [#1342](https://github.com/stripe/stripe-java/pull/1342) Add null checks before streaming expandable IDs in setters.
 
-## 20.115.0 - 2022-04-20
+## <a id="20-115-0"></a>20.115.0 - 2022-04-20
 * [#1339](https://github.com/stripe/stripe-java/pull/1339) API Updates
   * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
   * Add support for `create_funding_instructions` method on resource `Customer`
@@ -2283,19 +2281,21 @@ This release includes breaking changes resulting from:
   * Add support for new value `customer_balance` on enum `PaymentMethodCreateParams.type`
   * Add support for `configuration_overrides` on `Terminal.Location`, `terminal.LocationCreateParams`, and `terminal.LocationUpdateParams`
 
-## 20.114.0 - 2022-04-14
+## <a id="20-114-0"></a>20.114.0 - 2022-04-14
 * [#1338](https://github.com/stripe/stripe-java/pull/1338) Add support for putExtraParam on EphemeralKeyCreateParams
 * [#1336](https://github.com/stripe/stripe-java/pull/1336) API Updates
   * Add support for `increment_authorization` method on resource `PaymentIntent`
   * Add support for `incremental_authorization_supported` on `Charge.payment_method_details.card_present`
   * Add support for `request_incremental_authorization_support` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
 
-## 20.113.0 - 2022-04-08
+## <a id="20-113-0"></a>20.113.0 - 2022-04-08
 * [#1335](https://github.com/stripe/stripe-java/pull/1335) API Updates
   * Add support for `apply_customer_balance` method on resource `PaymentIntent`
   * Add support for new value `cash_balance.funds_available` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 20.112.0 - 2022-04-01
+## <a id="20-112-0"></a>20.112.0 - 2022-04-01
+* [#1331](https://github.com/stripe/stripe-java/pull/1331) Pin JDK version and always build using Java 18
+  * This only impacts development and it's not a breaking change for users. We still support Java 1.8 and later.
 * [#1333](https://github.com/stripe/stripe-java/pull/1333) API Updates
   * Add support for `bank_transfer_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
   * Add support for `capture_before` on `Charge.payment_method_details.card_present`
@@ -2305,20 +2305,17 @@ This release includes breaking changes resulting from:
   * Add support for `request_extended_authorization` on `PaymentIntent.payment_method_options.card_present`, `PaymentIntentConfirmParams.payment_method_options.card_present`, `PaymentIntentCreateParams.payment_method_options.card_present`, and `PaymentIntentUpdateParams.payment_method_options.card_present`
   * Add support for new values `payment_intent.partially_funded`, `terminal.reader.action_failed`, and `terminal.reader.action_succeeded` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-* [#1331](https://github.com/stripe/stripe-java/pull/1331) Pin JDK version and always build using Java 18
-  * This only impacts development and it's not a breaking change for users. We still support Java 1.8 and later.
-
-## 20.111.0 - 2022-03-30
+## <a id="20-111-0"></a>20.111.0 - 2022-03-30
 * [#1332](https://github.com/stripe/stripe-java/pull/1332) API Updates
   * Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
   * Add support for `action` on `Terminal.Reader`
 
-## 20.110.0 - 2022-03-28
+## <a id="20-110-0"></a>20.110.0 - 2022-03-28
 * [#1330](https://github.com/stripe/stripe-java/pull/1330) API Updates
   * Add support for Search API
     * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
 
-## 20.109.0 - 2022-03-25
+## <a id="20-109-0"></a>20.109.0 - 2022-03-25
 * [#1329](https://github.com/stripe/stripe-java/pull/1329) API Updates
   * Add support for PayNow and US Bank Accounts Debits payments
       * **Charge** ([API ref](https://stripe.com/docs/api/charges/object#charge_object-payment_method_details))
@@ -2359,39 +2356,38 @@ This release includes breaking changes resulting from:
       * Add support for `descriptor_code` on `PaymentIntentVerifyMicrodepositsParams` and `SetupIntentVerifyMicrodepositsParams`
   * Add support for `test_clock` on `SubscriptionListParams` ([API ref](https://stripe.com/docs/api/subscriptions/list#list_subscriptions-test_clock))
 
-## 20.108.0 - 2022-03-23
+## <a id="20-108-0"></a>20.108.0 - 2022-03-23
 * [#1328](https://github.com/stripe/stripe-java/pull/1328) API Updates
   * Add support for `cancel` method on resource `Refund`
   * Add support for new values `bg_uic`, `hu_tin`, and `si_tin` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
   * Add support for `test_clock` on `QuoteListParams`
   * Add support for new values `test_helpers.test_clock.advancing`, `test_helpers.test_clock.created`, `test_helpers.test_clock.deleted`, `test_helpers.test_clock.internal_failure`, and `test_helpers.test_clock.ready` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-
-## 20.107.0 - 2022-03-18
+## <a id="20-107-0"></a>20.107.0 - 2022-03-18
+* [#1326](https://github.com/stripe/stripe-java/pull/1326) Update SearchResult pagination to match new API shape. This is a breaking change but the object shape is not exposed in the API currently and is therefore not being used.
+* [#1322](https://github.com/stripe/stripe-java/pull/1322) Upgrade GSON dependency to 2.9.0
 * [#1327](https://github.com/stripe/stripe-java/pull/1327) API Updates
   * Add support for `status` on `Card`
-* [#1322](https://github.com/stripe/stripe-java/pull/1322) Upgrade GSON dependency to 2.9.0
-* [#1326](https://github.com/stripe/stripe-java/pull/1326) Update SearchResult pagination to match new API shape. This is a breaking change but the object shape is not exposed in the API currently and is therefore not being used.
 
-## 20.106.0 - 2022-03-11
+## <a id="20-106-0"></a>20.106.0 - 2022-03-11
+* [#1321](https://github.com/stripe/stripe-java/pull/1321) Delete PaymentIntentTypeSpecificPaymentMethodOptionsClient.java
 * [#1324](https://github.com/stripe/stripe-java/pull/1324) API Updates
   * Add support for `mandate` on `Charge.payment_method_details.card`
   * Add support for `mandate_options` on `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, `PaymentIntent.payment_method_options.card`, `SetupIntentCreateParams.payment_method_options.card`, `SetupIntentUpdateParams.payment_method_options.card`, `SetupIntentConfirmParams.payment_method_options.card`, and `SetupIntent.payment_method_options.card`
   * Add support for `card_await_notification` on `PaymentIntent.next_action`
   * Add support for `customer_notification` on `PaymentIntent.processing.card`
   * Change `PaymentLinkCreateParams.line_items` to be required
-* [#1321](https://github.com/stripe/stripe-java/pull/1321) Delete PaymentIntentTypeSpecificPaymentMethodOptionsClient.java
 
-## 20.105.0 - 2022-03-09
+## <a id="20-105-0"></a>20.105.0 - 2022-03-09
 * [#1323](https://github.com/stripe/stripe-java/pull/1323) API Updates
   * Add support for `test_clock` on `CustomerListParams`
 
-## 20.104.0 - 2022-03-02
+## <a id="20-104-0"></a>20.104.0 - 2022-03-02
 * [#1320](https://github.com/stripe/stripe-java/pull/1320) API Updates
   * Add support for new resources `CreditedItems` and `ProrationDetails`
   * Add support for `proration_details` on `InvoiceLineItem`
 
-## 20.103.0 - 2022-03-01
+## <a id="20-103-0"></a>20.103.0 - 2022-03-01
 * [#1319](https://github.com/stripe/stripe-java/pull/1319) API Updates
   * Add support for `deletes_after` on `TestHelpers.TestClock`
 * [#1318](https://github.com/stripe/stripe-java/pull/1318) API Updates
@@ -2401,7 +2397,7 @@ This release includes breaking changes resulting from:
   * Change type of `ProductUpdateParams.url` from `string` to `emptyStringable(string)`
   * Add support for `next_action` on `Refund`
 
-## 20.102.0 - 2022-02-25
+## <a id="20-102-0"></a>20.102.0 - 2022-02-25
 * [#1315](https://github.com/stripe/stripe-java/pull/1315) API Updates
   * Add support for `konbini_payments` on `AccountUpdateParams.capabilities`, `AccountCreateParams.capabilities`, and `Account.capabilities`
   * Add support for .payment_method_options.konbini and .payment_method_data.konbini on the PaymentIntent API.
@@ -2410,44 +2406,42 @@ This release includes breaking changes resulting from:
   * Add support for .payment_method_options.konbini on the checkout.Session API
   * Add support for `konbini_display_details` on `PaymentIntent.next_action`
 
-
-## 20.101.0 - 2022-02-23
+## <a id="20-101-0"></a>20.101.0 - 2022-02-23
 * [#1313](https://github.com/stripe/stripe-java/pull/1313) API Updates
   * Add support for `setup_future_usage` on `PaymentIntentCreateParams.payment_method_options.acss_debit`, `PaymentIntentCreateParams.payment_method_options.afterpay_clearpay`, `PaymentIntentCreateParams.payment_method_options.alipay`, `PaymentIntentCreateParams.payment_method_options.au_becs_debit`, `PaymentIntentCreateParams.payment_method_options.bacs_debit`, `PaymentIntentCreateParams.payment_method_options.bancontact`, `PaymentIntentCreateParams.payment_method_options.boleto`, `PaymentIntentCreateParams.payment_method_options.eps`, `PaymentIntentCreateParams.payment_method_options.fpx`, `PaymentIntentCreateParams.payment_method_options.giropay`, `PaymentIntentCreateParams.payment_method_options.grabpay`, `PaymentIntentCreateParams.payment_method_options.ideal`, `PaymentIntentCreateParams.payment_method_options.klarna`, `PaymentIntentCreateParams.payment_method_options.oxxo`, `PaymentIntentCreateParams.payment_method_options.p24`, `PaymentIntentCreateParams.payment_method_options.sepa_debit`, `PaymentIntentCreateParams.payment_method_options.sofort`, `PaymentIntentCreateParams.payment_method_options.wechat_pay`, `PaymentIntentUpdateParams.payment_method_options.acss_debit`, `PaymentIntentUpdateParams.payment_method_options.afterpay_clearpay`, `PaymentIntentUpdateParams.payment_method_options.alipay`, `PaymentIntentUpdateParams.payment_method_options.au_becs_debit`, `PaymentIntentUpdateParams.payment_method_options.bacs_debit`, `PaymentIntentUpdateParams.payment_method_options.bancontact`, `PaymentIntentUpdateParams.payment_method_options.boleto`, `PaymentIntentUpdateParams.payment_method_options.eps`, `PaymentIntentUpdateParams.payment_method_options.fpx`, `PaymentIntentUpdateParams.payment_method_options.giropay`, `PaymentIntentUpdateParams.payment_method_options.grabpay`, `PaymentIntentUpdateParams.payment_method_options.ideal`, `PaymentIntentUpdateParams.payment_method_options.klarna`, `PaymentIntentUpdateParams.payment_method_options.oxxo`, `PaymentIntentUpdateParams.payment_method_options.p24`, `PaymentIntentUpdateParams.payment_method_options.sepa_debit`, `PaymentIntentUpdateParams.payment_method_options.sofort`, `PaymentIntentUpdateParams.payment_method_options.wechat_pay`, `PaymentIntentConfirmParams.payment_method_options.acss_debit`, `PaymentIntentConfirmParams.payment_method_options.afterpay_clearpay`, `PaymentIntentConfirmParams.payment_method_options.alipay`, `PaymentIntentConfirmParams.payment_method_options.au_becs_debit`, `PaymentIntentConfirmParams.payment_method_options.bacs_debit`, `PaymentIntentConfirmParams.payment_method_options.bancontact`, `PaymentIntentConfirmParams.payment_method_options.boleto`, `PaymentIntentConfirmParams.payment_method_options.eps`, `PaymentIntentConfirmParams.payment_method_options.fpx`, `PaymentIntentConfirmParams.payment_method_options.giropay`, `PaymentIntentConfirmParams.payment_method_options.grabpay`, `PaymentIntentConfirmParams.payment_method_options.ideal`, `PaymentIntentConfirmParams.payment_method_options.klarna`, `PaymentIntentConfirmParams.payment_method_options.oxxo`, `PaymentIntentConfirmParams.payment_method_options.p24`, `PaymentIntentConfirmParams.payment_method_options.sepa_debit`, `PaymentIntentConfirmParams.payment_method_options.sofort`, `PaymentIntentConfirmParams.payment_method_options.wechat_pay`, `PaymentIntent.payment_method_options.acss_debit`, `PaymentIntent.payment_method_options.afterpay_clearpay`, `PaymentIntent.payment_method_options.alipay`, `PaymentIntent.payment_method_options.au_becs_debit`, `PaymentIntent.payment_method_options.bacs_debit`, `PaymentIntent.payment_method_options.bancontact`, `PaymentIntent.payment_method_options.boleto`, `PaymentIntent.payment_method_options.eps`, `PaymentIntent.payment_method_options.fpx`, `PaymentIntent.payment_method_options.giropay`, `PaymentIntent.payment_method_options.grabpay`, `PaymentIntent.payment_method_options.ideal`, `PaymentIntent.payment_method_options.klarna`, `PaymentIntent.payment_method_options.oxxo`, `PaymentIntent.payment_method_options.p24`, `PaymentIntent.payment_method_options.sepa_debit`, `PaymentIntent.payment_method_options.sofort`, and `PaymentIntent.payment_method_options.wechat_pay`
   * Add support for new values `bbpos_wisepad3` and `stripe_m2` on enum `terminal.ReaderListParams.device_type`
   * Add generated test for the endpoints introduced in #1312
 
-## 20.100.0 - 2022-02-16
-* [#1312](https://github.com/stripe/stripe-java/pull/1312) API Updates
-  * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
-  * Add support for new value `grabpay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]
-  `
+## <a id="20-100-0"></a>20.100.0 - 2022-02-16
 * [#1311](https://github.com/stripe/stripe-java/pull/1311) Pin grgit version to 4.1.1.
 * [#1310](https://github.com/stripe/stripe-java/pull/1310) API Updates
   * Add support for `pin` on `issuing.CardUpdateParams`
+* [#1312](https://github.com/stripe/stripe-java/pull/1312) API Updates
+  * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
+  * Add support for new value `grabpay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]
+  `
 
-## 20.99.0 - 2022-02-03
+## <a id="20-99-0"></a>20.99.0 - 2022-02-03
 * [#1307](https://github.com/stripe/stripe-java/pull/1307) API Updates
   * Add support for new value `au_becs_debit` on enum `checkout.SessionCreateParams.payment_method_types[]`
 
-## 20.98.0 - 2022-01-25
+## <a id="20-98-0"></a>20.98.0 - 2022-01-25
 * [#1306](https://github.com/stripe/stripe-java/pull/1306) API Updates
   * Add support for `phone_number_collection` on `PaymentLinkCreateParams` and `PaymentLink`
   * Add support for new values `payment_link.created` and `payment_link.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
   * Add support for new value `is_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
 
-
-## 20.97.0 - 2022-01-20
+## <a id="20-97-0"></a>20.97.0 - 2022-01-20
 * [#1304](https://github.com/stripe/stripe-java/pull/1304) API Updates
   * Add support for new resource `PaymentLink`
   * Add support for `payment_link` on `Checkout.Session`
 
-## 20.96.0 - 2022-01-19
+## <a id="20-96-0"></a>20.96.0 - 2022-01-19
 * [#1302](https://github.com/stripe/stripe-java/pull/1302) API Updates
   * Add support for `bacs_debit` and `eps` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
   * Add support for `image_url_png` and `image_url_svg` on `PaymentIntent.next_action.wechat_pay_display_qr_code`
 
-## 20.95.0 - 2022-01-12
+## <a id="20-95-0"></a>20.95.0 - 2022-01-12
 * [#1301](https://github.com/stripe/stripe-java/pull/1301) API Updates
   * Add support for `customer_creation` on `checkout.SessionCreateParams` and `Checkout.Session`
   * Add support for `fpx` and `grabpay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
@@ -2455,84 +2449,82 @@ This release includes breaking changes resulting from:
 * [#1300](https://github.com/stripe/stripe-java/pull/1300) API Updates
   * Add support for `mandate_options` on `SubscriptionCreateParams.payment_settings.payment_method_options.card`, `SubscriptionUpdateParams.payment_settings.payment_method_options.card`, and `Subscription.payment_settings.payment_method_options.card`
 
-## 20.94.0 - 2021-12-22
+## <a id="20-94-0"></a>20.94.0 - 2021-12-22
+* [#1297](https://github.com/stripe/stripe-java/pull/1297) API Updates
+  * Add support for `processing` on `PaymentIntent`
 * [#1299](https://github.com/stripe/stripe-java/pull/1299) API Updates
   * Add support for `au_becs_debit` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
-
 * [#1298](https://github.com/stripe/stripe-java/pull/1298) API Updates
   * Add support for new values `en-FR`, `es-US`, and `fr-FR` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
   * Add support for `boleto` on `SetupAttempt.payment_method_details`
 
-* [#1297](https://github.com/stripe/stripe-java/pull/1297) API Updates
-  * Add support for `processing` on `PaymentIntent`
-
-## 20.93.0 - 2021-12-15
+## <a id="20-93-0"></a>20.93.0 - 2021-12-15
 * [#1296](https://github.com/stripe/stripe-java/pull/1296) API Updates
   * Add support for new resource `PaymentIntentTypeSpecificPaymentMethodOptionsClient`
   * Add support for `setup_future_usage` on `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, and `PaymentIntent.payment_method_options.card`
 
-## 20.92.0 - 2021-12-09
+## <a id="20-92-0"></a>20.92.0 - 2021-12-09
 * [#1295](https://github.com/stripe/stripe-java/pull/1295) API Updates
   * Add support for `metadata` on `billingportal.ConfigurationCreateParams`, `billingportal.ConfigurationUpdateParams`, and `BillingPortal.Configuration`
 
-## 20.91.0 - 2021-12-09
+## <a id="20-91-0"></a>20.91.0 - 2021-12-09
+* [#1290](https://github.com/stripe/stripe-java/pull/1290) Update Javadoc task to not use module directories.
+* [#1292](https://github.com/stripe/stripe-java/pull/1292) Pass credentials to nexusStaging rule.
+* [#1291](https://github.com/stripe/stripe-java/pull/1291) Test Java 16 and 17
 * [#1294](https://github.com/stripe/stripe-java/pull/1294) API Updates
   * Add support for new values `ge_vat` and `ua_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
   * Change type of `PaymentIntentCreateParams.payment_method_data.billing_details.email`, `PaymentIntentUpdateParams.payment_method_data.billing_details.email`, `PaymentIntentConfirmParams.payment_method_data.billing_details.email`, `PaymentMethodCreateParams.billing_details.email`, and `PaymentMethodUpdateParams.billing_details.email` from `string` to `emptyStringable(string)`
   * Add support for `giropay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
   * Add support for new value `en-IE` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
-* [#1291](https://github.com/stripe/stripe-java/pull/1291) Test Java 16 and 17
-* [#1292](https://github.com/stripe/stripe-java/pull/1292) Pass credentials to nexusStaging rule.
-* [#1290](https://github.com/stripe/stripe-java/pull/1290) Update Javadoc task to not use module directories.
 
-## 20.90.0 - 2021-11-19
+## <a id="20-90-0"></a>20.90.0 - 2021-11-19
 * [#1289](https://github.com/stripe/stripe-java/pull/1289) API Updates
   * Add support for `wallets` on `Issuing.Card`
 * [#1288](https://github.com/stripe/stripe-java/pull/1288) API Updates
   * Add support for `interac_present` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
   * Add support for new value `jct` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
 
-## 20.89.0 - 2021-11-17
+## <a id="20-89-0"></a>20.89.0 - 2021-11-17
 * [#1286](https://github.com/stripe/stripe-java/pull/1286) API Updates
   * Add support for `automatic_payment_methods` on `PaymentIntentCreateParams` and `PaymentIntent`
 
-## 20.88.0 - 2021-11-16
+## <a id="20-88-0"></a>20.88.0 - 2021-11-16
 * [#1284](https://github.com/stripe/stripe-java/pull/1284) API Updates
   * Add support for new resource `ShippingRate`
   * Add support for `shipping_options` on `checkout.SessionCreateParams` and `Checkout.Session`
   * Add support for `shipping_rate` on `Checkout.Session`
 
-## 20.87.0 - 2021-11-11
+## <a id="20-87-0"></a>20.87.0 - 2021-11-11
 * [#1281](https://github.com/stripe/stripe-java/pull/1281) API Updates
   * Add support for `expire` method on resource `Checkout.Session`
   * Add support for `status` on `Checkout.Session`
 
-## 20.86.1 - 2021-11-04
+## <a id="20-86-1"></a>20.86.1 - 2021-11-04
 * [#1279](https://github.com/stripe/stripe-java/pull/1279) API Updates
   * Remove support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account`. This API was unused.
   * Add support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account.company`
 
-## 20.86.0 - 2021-11-01
+## <a id="20-86-0"></a>20.86.0 - 2021-11-01
 * [#1278](https://github.com/stripe/stripe-java/pull/1278) API Updates
   * Add support for `ownership_declaration` on `AccountUpdateParams.company`, `AccountCreateParams.company`, `Account.company`, and `TokenCreateParams.account.company`
   * Add support for `proof_of_registration` on `AccountUpdateParams.documents` and `AccountCreateParams.documents`
   * Add support for `ownership_declaration_shown_and_signed` on `TokenCreateParams.account`
 
-## 20.85.0 - 2021-10-20
+## <a id="20-85-0"></a>20.85.0 - 2021-10-20
 * [#1275](https://github.com/stripe/stripe-java/pull/1275) Reorder fields
 * [#1274](https://github.com/stripe/stripe-java/pull/1274) API Updates
   * Add support for `buyer_id` on `Charge.payment_method_details.alipay`
 
-## 20.84.0 - 2021-10-15
+## <a id="20-84-0"></a>20.84.0 - 2021-10-15
 * [#1273](https://github.com/stripe/stripe-java/pull/1273) API Updates
   * Change type of `UsageRecordCreateParams.timestamp` from `integer` to `literal('now') | integer`
   * Change `UsageRecordCreateParams.timestamp` to be optional
 
-## 20.83.0 - 2021-10-14
+## <a id="20-83-0"></a>20.83.0 - 2021-10-14
 * [#1272](https://github.com/stripe/stripe-java/pull/1272) API Updates
   * Add support for new value `klarna` on enum `checkout.SessionCreateParams.payment_method_types[]`
 
-## 20.82.0 - 2021-10-11
+## <a id="20-82-0"></a>20.82.0 - 2021-10-11
 * [#1271](https://github.com/stripe/stripe-java/pull/1271) API Updates
   * Add support for `payment_method_category` and `preferred_locale` on `Charge.payment_method_details.klarna`
   * Add support for new value `klarna` on enums `CustomerListPaymentMethodsParams.type` and `PaymentMethodListParams.type`
@@ -2540,11 +2532,11 @@ This release includes breaking changes resulting from:
   * Add support for new value `klarna` on enums `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, and `PaymentIntentConfirmParams.payment_method_data.type`
   * Add support for new value `klarna` on enum `PaymentMethodCreateParams.type`
 
-## 20.81.0 - 2021-10-11
+## <a id="20-81-0"></a>20.81.0 - 2021-10-11
 * [#1269](https://github.com/stripe/stripe-java/pull/1269) API Updates
   * Add support for `list_payment_methods` method on resource `Customer`
 
-## 20.80.0 - 2021-10-07
+## <a id="20-80-0"></a>20.80.0 - 2021-10-07
 * [#1268](https://github.com/stripe/stripe-java/pull/1268) API Updates
   * Add support for `phone_number_collection` on `checkout.SessionCreateParams` and `Checkout.Session`
   * Add support for `phone` on `Checkout.Session.customer_details`
@@ -2552,137 +2544,135 @@ This release includes breaking changes resulting from:
   * Add support for new value `customer_id` on enum `radar.ValueListCreateParams.item_type`
   * Add support for new value `bbpos_wisepos_e` on enum `terminal.ReaderListParams.device_type`
 
-## 20.79.0 - 2021-09-29
+## <a id="20-79-0"></a>20.79.0 - 2021-09-29
 * [#1266](https://github.com/stripe/stripe-java/pull/1266) API Updates
   * Add support for `klarna_payments` on `AccountUpdateParams.capabilities`, `AccountCreateParams.capabilities`, and `Account.capabilities`
 
-## 20.78.0 - 2021-09-24
+## <a id="20-78-0"></a>20.78.0 - 2021-09-24
+* [#1209](https://github.com/stripe/stripe-java/pull/1209) Fix typo in README.md
+* [#1261](https://github.com/stripe/stripe-java/pull/1261) Upgrade Gradle
 * [#1265](https://github.com/stripe/stripe-java/pull/1265) API Updates
   * Add support for `amount_authorized` and `overcapture_supported` on `Charge.payment_method_details.card_present`
 
-* [#1261](https://github.com/stripe/stripe-java/pull/1261) Upgrade Gradle
-* [#1209](https://github.com/stripe/stripe-java/pull/1209) Fix typo in README.md
-
-## 20.77.0 - 2021-09-16
+## <a id="20-77-0"></a>20.77.0 - 2021-09-16
 * [#1264](https://github.com/stripe/stripe-java/pull/1264) API Updates
   * Add support for `full_name_aliases` on `AccountUpdateParams.individual`, `AccountCreateParams.individual`, `PersonCreateParams`, `PersonUpdateParams`, `Person`, `TokenCreateParams.account.individual`, and `TokenCreateParams.person`
 
-## 20.76.0 - 2021-09-15
+## <a id="20-76-0"></a>20.76.0 - 2021-09-15
 * [#1263](https://github.com/stripe/stripe-java/pull/1263) API Updates
   * Add support for `default_for` on `checkout.SessionCreateParams.payment_method_options.acss_debit.mandate_options`, `Checkout.Session.payment_method_options.acss_debit.mandate_options`, `Mandate.payment_method_details.acss_debit`, `SetupIntentCreateParams.payment_method_options.acss_debit.mandate_options`, `SetupIntentUpdateParams.payment_method_options.acss_debit.mandate_options`, `SetupIntentConfirmParams.payment_method_options.acss_debit.mandate_options`, and `SetupIntent.payment_method_options.acss_debit.mandate_options`
   * Add support for `acss_debit` on `InvoiceCreateParams.payment_settings.payment_method_options`, `InvoiceUpdateParams.payment_settings.payment_method_options`, `Invoice.payment_settings.payment_method_options`, `SubscriptionCreateParams.payment_settings.payment_method_options`, `SubscriptionUpdateParams.payment_settings.payment_method_options`, and `Subscription.payment_settings.payment_method_options`
   * Add support for new value `acss_debit` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, and `SubscriptionUpdateParams.payment_settings.payment_method_types[]`
   * Add support for `livemode` on `Reporting.ReportType`
 
-
-## 20.75.0 - 2021-09-09
+## <a id="20-75-0"></a>20.75.0 - 2021-09-09
 * [#1259](https://github.com/stripe/stripe-java/pull/1259) Add missing constant for `account_requirement` as a `purpose` on File create and List APIs
 
-## 20.74.0 - 2021-09-07
+## <a id="20-74-0"></a>20.74.0 - 2021-09-07
 * [#1257](https://github.com/stripe/stripe-java/pull/1257) API Updates
   * Add support for new value `rst` on enums `TaxRateCreateParams.tax_type` and `TaxRateUpdateParams.tax_type`
   * Add support for new value `checkout.session.expired` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 
-## 20.73.0 - 2021-09-03
+## <a id="20-73-0"></a>20.73.0 - 2021-09-03
 * [#1255](https://github.com/stripe/stripe-java/pull/1255) API Updates
   * Add support for `future_requirements` on `Account`, `Capability`, and `Person`
   * Add support for `alternatives` on `Account.requirements`, `Capability.requirements`, and `Person.requirements`
 
-## 20.72.0 - 2021-09-01
+## <a id="20-72-0"></a>20.72.0 - 2021-09-01
+* [#1252](https://github.com/stripe/stripe-java/pull/1252) Add support for auto-paginatable `SearchResult` type
 * [#1254](https://github.com/stripe/stripe-java/pull/1254) API Updates
   * Add support for `after_expiration`, `consent_collection`, and `expires_at` on `checkout.SessionCreateParams` and `Checkout.Session`
   * Add support for `consent` and `recovered_from` on `Checkout.Session`
-* [#1252](https://github.com/stripe/stripe-java/pull/1252) Add support for auto-paginatable `SearchResult` type
 
-## 20.71.0 - 2021-08-27
+## <a id="20-71-0"></a>20.71.0 - 2021-08-27
 * [#1250](https://github.com/stripe/stripe-java/pull/1250) API Updates
   * Add support for `cancellation_reason` on `billingportal.ConfigurationCreateParams.features.subscription_cancel`, `billingportal.ConfigurationUpdateParams.features.subscription_cancel`, and `BillingPortal.Configuration.features.subscription_cancel`
 
-## 20.70.0 - 2021-08-19
+## <a id="20-70-0"></a>20.70.0 - 2021-08-19
 * [#1249](https://github.com/stripe/stripe-java/pull/1249) API Updates
   * Add support for new value `fil` on enum `checkout.SessionCreateParams.locale`
   * Add support for new value `au_arn` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
 
-## 20.69.0 - 2021-08-11
+## <a id="20-69-0"></a>20.69.0 - 2021-08-11
 * [#1248](https://github.com/stripe/stripe-java/pull/1248) API Updates
   * Add support for `locale` on `billingportal.SessionCreateParams` and `BillingPortal.Session`
 
-## 20.68.0 - 2021-08-04
+## <a id="20-68-0"></a>20.68.0 - 2021-08-04
 * [#1246](https://github.com/stripe/stripe-java/pull/1246) API Updates
   * Change type of `PaymentIntentCreateParams.payment_method_options.sofort.preferred_language`, `PaymentIntentUpdateParams.payment_method_options.sofort.preferred_language`, and `PaymentIntentConfirmParams.payment_method_options.sofort.preferred_language` from `enum` to `emptyStringable(enum)`
 
-## 20.67.0 - 2021-07-28
-* [#1242](https://github.com/stripe/stripe-java/pull/1242) API Updates
-  * Add support for `account_type` on `BankAccount`, `ExternalAccountUpdateParams`, and `TokenCreateParams.bank_account`
+## <a id="20-67-0"></a>20.67.0 - 2021-07-28
 * [#1241](https://github.com/stripe/stripe-java/pull/1241) API Updates
   * Add support for `category_code` on `Issuing.Authorization.merchant_data` and `Issuing.Transaction.merchant_data`
+* [#1242](https://github.com/stripe/stripe-java/pull/1242) API Updates
+  * Add support for `account_type` on `BankAccount`, `ExternalAccountUpdateParams`, and `TokenCreateParams.bank_account`
 
-## 20.66.0 - 2021-07-22
+## <a id="20-66-0"></a>20.66.0 - 2021-07-22
 * [#1239](https://github.com/stripe/stripe-java/pull/1239) API Updates
   * Add support for new values `hr`, `ko`, and `vi` on enum `checkout.SessionCreateParams.locale`
   * Add support for `payment_settings` on `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
 
-## 20.65.0 - 2021-07-20
+## <a id="20-65-0"></a>20.65.0 - 2021-07-20
 * [#1238](https://github.com/stripe/stripe-java/pull/1238) API Updates
   * Add support for `wallet` on `Issuing.Transaction`
   * Add support for `ideal` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
 
-## 20.64.0 - 2021-07-14
+## <a id="20-64-0"></a>20.64.0 - 2021-07-14
 * [#1237](https://github.com/stripe/stripe-java/pull/1237) API Updates
   * Add support for `quote.accepted`, `quote.canceled`, `quote.created`, and `quote.finalized` events.
 * [#1236](https://github.com/stripe/stripe-java/pull/1236) API Updates
   * Add support for `list_computed_upfront_line_items` method on resource `Quote`
 
-## 20.63.1 - 2021-07-09
+## <a id="20-63-1"></a>20.63.1 - 2021-07-09
 * [#1233](https://github.com/stripe/stripe-java/pull/1233) Remove inappropriate list method from QuoteCollection
 
-## 20.63.0 - 2021-07-09
+## <a id="20-63-0"></a>20.63.0 - 2021-07-09
 * [#1231](https://github.com/stripe/stripe-java/pull/1231) API Updates
   * Add support for new resource `Quote`
   * Add support for `quote` on `Invoice`
 
-## 20.62.0 - 2021-06-30
+## <a id="20-62-0"></a>20.62.0 - 2021-06-30
 * [#1229](https://github.com/stripe/stripe-java/pull/1229) API Updates
   * Add support for new value `boleto` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, and `InvoiceUpdateParams.payment_settings.payment_method_types[]`.
 
-## 20.61.0 - 2021-06-30
+## <a id="20-61-0"></a>20.61.0 - 2021-06-30
 * [#1228](https://github.com/stripe/stripe-java/pull/1228) API Updates
   * Add support for `wechat_pay` on `Charge.payment_method_details`, `checkout.SessionCreateParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntent.payment_method_options`, `PaymentMethodCreateParams`, and `PaymentMethod`
   * Add support for new value `wechat_pay` on enums `checkout.SessionCreateParams.payment_method_types[]` `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `PaymentIntentCreateParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`,`PaymentIntentConfirmParams.payment_method_data.type`, `PaymentMethodCreateParams.type`, and `PaymentMethodListParams.type`
   * Add support for `wechat_pay_display_qr_code`, `wechat_pay_redirect_to_android_app`, and `wechat_pay_redirect_to_ios_app` on `PaymentIntent.next_action`
 
-## 20.60.0 - 2021-06-29
+## <a id="20-60-0"></a>20.60.0 - 2021-06-29
+* [#1207](https://github.com/stripe/stripe-java/pull/1207) Streaming requests
 * [#1227](https://github.com/stripe/stripe-java/pull/1227) API Updates
   * Added support for `boleto_payments` on `Account.capabilities`
   * Added support for `boleto` and `oxxo` on `SessionCreateParams` and `Session`
-* [#1207](https://github.com/stripe/stripe-java/pull/1207) Streaming requests
 
-## 20.59.0 - 2021-06-25
+## <a id="20-59-0"></a>20.59.0 - 2021-06-25
+* [#1218](https://github.com/stripe/stripe-java/pull/1218) Remove Travis CI
 * [#1225](https://github.com/stripe/stripe-java/pull/1225) API Updates
   * Added support for `boleto` on `PaymentMethodCreateParams`, `PaymentIntent.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_data`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_data`, `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentCreateParams.payment_method_data`, `Charge.payment_method_details` and `PaymentMethod`
   * `PaymentMethodListParams.type`, `PaymentMethodCreateParams.type`, `PaymentIntentConfirmParams.payment_method_data.type`, `PaymentIntentUpdateParams.payment_method_data.type`, `PaymentIntentCreateParams.payment_method_data.type`  added new enum members: `boleto`
   * Added support for `boleto_display_details` on `PaymentIntent.next_action`
   * `TaxIdCreateParams.type`, `InvoiceLineItemListUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, and `CustomerCreateParams.tax_id_data[].type`, added new enum members: `il_vat`.
-* [#1218](https://github.com/stripe/stripe-java/pull/1218) Remove Travis CI
 
-## 20.58.0 - 2021-06-18
+## <a id="20-58-0"></a>20.58.0 - 2021-06-18
 * [#1222](https://github.com/stripe/stripe-java/pull/1222) API Updates
   * Add support for new TaxId types: `ca_pst_mb`, `ca_pst_bc`, `ca_gst_hst`, and `ca_pst_sk`.
 
-## 20.57.0 - 2021-06-16
+## <a id="20-57-0"></a>20.57.0 - 2021-06-16
 * [#1221](https://github.com/stripe/stripe-java/pull/1221) API Updates
   * Add support for `url` on Checkout `Session`
 
-## 20.56.0 - 2021-06-07
+## <a id="20-56-0"></a>20.56.0 - 2021-06-07
 * [#1219](https://github.com/stripe/stripe-java/pull/1219) API Updates
   * Added support for `TaxIdCollection` on `SessionCreateParams` and `Session.taxIdCollection`
   * Update `Location` to be expandable on `Reader`
 
-## 20.55.0 - 2021-06-04
+## <a id="20-55-0"></a>20.55.0 - 2021-06-04
 * [#1217](https://github.com/stripe/stripe-java/pull/1217) API Updates
   * Added support for `controller` on `Account`
 
-## 20.54.0 - 2021-06-04
+## <a id="20-54-0"></a>20.54.0 - 2021-06-04
 * [#1215](https://github.com/stripe/stripe-java/pull/1215) API Updates
   * Add support for new `TaxCode` API.
   * Add support for `tax_code` on `Product`, `ProductCreateParams`, `ProductUpdateParams`, `PriceCreateParams.product_data`, `PlanCreateParams.product`, and Checkout `SessionCreateParams.line_items[].price_data.product_data`.
@@ -2700,40 +2690,40 @@ This release includes breaking changes resulting from:
   * Add support for `customer_details` to `InvoiceUpcomingParams`.
   * Add support for `tax_type` to `TaxRate`, `TaxRateCreateParams`, and `TaxRateUpdateParams`.
 
-## 20.53.0 - 2021-06-02
+## <a id="20-53-0"></a>20.53.0 - 2021-06-02
 * [#1214](https://github.com/stripe/stripe-java/pull/1214) API Updates
   * Added support for `llc`, `free_zone_llc`, `free_zone_establishment` and `sole_establishment` to the `structure` enum on `Account.company`, `AccountCreateParams.company`, `AccountUpdateParams.company` and `TokenCreateParams.account.company`.
 
-## 20.52.0 - 2021-05-26
+## <a id="20-52-0"></a>20.52.0 - 2021-05-26
 * [#1212](https://github.com/stripe/stripe-java/pull/1212) API Updates
   * Added support for `documents` on `PersonUpdateParams`, `PersonCollectionCreateParams` and `TokenCreateParams.person`
 
-## 20.51.0 - 2021-05-19
-* [#1211](https://github.com/stripe/stripe-java/pull/1211), [#1205](https://github.com/stripe/stripe-java/pull/1205) API Updates
+## <a id="20-51-0"></a>20.51.0 - 2021-05-19
+* [#1211](https://github.com/stripe/stripe-java/pull/1211) , [#1205](https://github.com/stripe/stripe-java/pull/1205) API Updates
   * Add support for the `Identity.VerificationSession` and `Identity.VerificationReport` APIs.
 * [#1206](https://github.com/stripe/stripe-java/pull/1206) API Updates
   * Add support for setting `AccountUpdateParams.business_profile.support_url` and `AccountCreateParams.support_url` to `EmptyParam`.
 
-## 20.50.0 - 2021-05-06
+## <a id="20-50-0"></a>20.50.0 - 2021-05-06
+* [#1203](https://github.com/stripe/stripe-java/pull/1203) Fix flaky test: no telemetry by default in test suite
 * [#1204](https://github.com/stripe/stripe-java/pull/1204) API Updates
   * Add support for `reference` on `Charge.payment_method_details.afterpay_clearpay`
   * Add support for `afterpay_clearpay` on `PaymentIntent.payment_method_options`
-* [#1203](https://github.com/stripe/stripe-java/pull/1203) Fix flaky test: no telemetry by default in test suite
 
-## 20.49.0 - 2021-05-05
+## <a id="20-49-0"></a>20.49.0 - 2021-05-05
 * [#1202](https://github.com/stripe/stripe-java/pull/1202) API Updates
   * Add support for `payment_intent` on `EarlyFraudWarning`
 
-## 20.48.0 - 2021-05-05
+## <a id="20-48-0"></a>20.48.0 - 2021-05-05
 * [#1201](https://github.com/stripe/stripe-java/pull/1201) API Updates
   * Add support for `card_present` on `PaymentIntent.payment_method_options`
   * Add support for `default_incomplete` as a `payment_behavior` on `SubscriptionItemCreateParams`, `SubscriptionUpdateParams`, and `SubscriptionCreateParams`.
   * Add support for `single_member_llc` as a `structure` on `AccountCreateParams.company` and `AccountUpdateParams.company`.
 
-## 20.47.1 - 2021-04-22
+## <a id="20-47-1"></a>20.47.1 - 2021-04-22
 * [#1197](https://github.com/stripe/stripe-java/pull/1197) Fix GSON error in JDK16 (#1190) by marking RequestOptions transient
 
-## 20.47.0 - 2021-04-12
+## <a id="20-47-0"></a>20.47.0 - 2021-04-12
 * [#1195](https://github.com/stripe/stripe-java/pull/1195) Add support for ACSS Debit
   * Add support for `acss_debit_payments` on `Account.capabilities`
   * Add support for `payment_method_options` on `Checkout.Session`
@@ -2741,208 +2731,214 @@ This release includes breaking changes resulting from:
   * Add support for `verify_with_microdeposits` on `PaymentIntent.next_action` and `SetupIntent.next_action`
   * Add support for `acss_debit` as member of the `type` enum on `PaymentMethod` and `PaymentIntent`, and inside `Checkout.SessionCreateParams.payment_method_types[]`.
 
-## 20.46.0 - 2021-04-02
+## <a id="20-46-0"></a>20.46.0 - 2021-04-02
 * [#1194](https://github.com/stripe/stripe-java/pull/1194) API Updates
   * Add support for `subscription_pause` on `BillingPortal.ConfigurationUpdateParams.features`, `BillingPortalCreateParams.features` and `BillingPortal.Configuration.features`
 
-## 20.45.0 - 2021-03-31
+## <a id="20-45-0"></a>20.45.0 - 2021-03-31
 * [#1193](https://github.com/stripe/stripe-java/pull/1193) API Updates
   * Add support for `transfer_data` on `Checkout.SessionCreateParams.subscription_data`
 
-## 20.44.0 - 2021-03-26
+## <a id="20-44-0"></a>20.44.0 - 2021-03-26
 * [#1192](https://github.com/stripe/stripe-java/pull/1192) API Updates
   * Add support for `card_issuing` on `AccountCreateParams.settings`, `AccountUpdateParams.settings` and `Account.settings`
 
-## 20.43.0 - 2021-03-25
+## <a id="20-43-0"></a>20.43.0 - 2021-03-25
 * [#1191](https://github.com/stripe/stripe-java/pull/1191) API Updates
   * Add support for new locale `th` on `SessionCreateParams`.
 
-
-## 20.42.0 - 2021-03-22
+## <a id="20-42-0"></a>20.42.0 - 2021-03-22
 * [#1189](https://github.com/stripe/stripe-java/pull/1189) API Updates
   * Add support for `shipping_rates` on `Checkout.SessionCreateParams`
   * Add support for `amount_shipping` on `Checkout.Session.total_details`
 
-## 20.41.0 - 2021-02-22
+## <a id="20-41-0"></a>20.41.0 - 2021-02-22
 * [#1187](https://github.com/stripe/stripe-java/pull/1187) API Updates
   * Add support for Billing Portal Configuration API
 
-## 20.40.0 - 2021-02-17
+## <a id="20-40-0"></a>20.40.0 - 2021-02-17
 * [#1186](https://github.com/stripe/stripe-java/pull/1186) API Updates
   * Add support for `on_behalf_of` to `Invoice`
   * Add support `revolut` as an enum member on `PaymentMethodCreateParams.Ideal.Bank`, `PaymentIntentConfirmParams.Ideal.Bank`, `PaymentIntentUpdateParams.Ideal.Bank`, and `PaymentIntentCreateParams.Ideal.Bank`
 
-
-## 20.39.0 - 2021-02-16
+## <a id="20-39-0"></a>20.39.0 - 2021-02-16
 * [#1185](https://github.com/stripe/stripe-java/pull/1185) API Updates
   * Add support for `afterpay_clearpay` on `PaymentMethod`, `PaymentIntent.payment_method_data`, and `Charge.payment_method_details`.
   * Add support for `afterpay_clearpay` as a payment method type on `PaymentMethod.type`, `PaymentIntent.PaymentMethodData.type`, and `Checkout.SessionCreateParams.payment_method_types`.
   * Add support for `adjustable_quantity` on `SessionCreateParams.LineItem`
   * Add support for `bacs_debit`, `au_becs_debit` and `sepa_debit` on `SetupAttempt.payment_method_details`
 
-## 20.38.0 - 2021-02-10
+## <a id="20-38-0"></a>20.38.0 - 2021-02-10
 * [#1180](https://github.com/stripe/stripe-java/pull/1180) Accept all InputStreams for FileCreateParams.setFile
 
-## 20.37.0 - 2021-02-08
+## <a id="20-37-0"></a>20.37.0 - 2021-02-08
 * [#1182](https://github.com/stripe/stripe-java/pull/1182) API Updates
   * Add support for `afterpay_clearpay_payments` on `Account.capabilities`
   * Add support for `payment_settings` on `Invoice`
 
-## 20.36.0 - 2021-02-03
-* [#1179](https://github.com/stripe/stripe-java/pull/1179)
+## <a id="20-36-0"></a>20.36.0 - 2021-02-03
+* [#1173](https://github.com/stripe/stripe-java/pull/1173) Add link to YouTube from readme
+* [#1179](https://github.com/stripe/stripe-java/pull/1179) Update generated code
   * Add support for `nationality` on `Person`, `PersonUpdateParams`, `PersonCreateParams` and `TokenCreateParams.person`
   * Add `gb_vat` to `TaxId.type` enum
-* [#1173](https://github.com/stripe/stripe-java/pull/1173) Add link to YouTube from readme
 
-## 20.35.0 - 2021-01-14
+## <a id="20-35-0"></a>20.35.0 - 2021-01-14
 * [#1171](https://github.com/stripe/stripe-java/pull/1171) API Updates
   * Add support for `dynamic_tax_rates` on `SessionCreateParams.line_items[]`
   * Add support for `customer_details` on `Checkout.Session`
   * Add support for `type` on `TransactionListParams`
   * Add support for `country` and `state` on `TaxRateUpdateParams`, `TaxRateCreateParams` and `TaxRate`
 
-## 20.34.0 - 2021-01-07
+## <a id="20-34-0"></a>20.34.0 - 2021-01-07
+* [#1167](https://github.com/stripe/stripe-java/pull/1167) Adding getUserMessage() to exceptions
 * [#1169](https://github.com/stripe/stripe-java/pull/1169) API Updates
   * Add support for `company_registration_verification`, `company_ministerial_decree`, `company_memorandum_of_association`, `company_license` and `company_tax_id_verification` on `AccountUpdateParams.documents` and `AccountCreateParams.documents`
-* [#1167](https://github.com/stripe/stripe-java/pull/1167) Adding getUserMessage() to exceptions
 
-## 20.33.0 - 2020-12-15
+## <a id="20-33-0"></a>20.33.0 - 2020-12-15
+* [#1162](https://github.com/stripe/stripe-java/pull/1162) Pass mutated copy of params into oauth request
 * [#1165](https://github.com/stripe/stripe-java/pull/1165) API Updates
   * Add support for card_present on SetupAttempt.payment_method_details
-* [#1162](https://github.com/stripe/stripe-java/pull/1162) Pass mutated copy of params into oauth request
 
-## 20.32.0 - 2020-12-10
+## <a id="20-32-0"></a>20.32.0 - 2020-12-10
 * [#1163](https://github.com/stripe/stripe-java/pull/1163) [codegen] Multiple API changes
   * Add support for `bank` on `PaymentMethod`
   * Add support for `tos_shown_and_accepted` to `payment_method_options[p24]` on `PaymentMethod`.
 
-
-## 20.31.0 - 2020-12-03
+## <a id="20-31-0"></a>20.31.0 - 2020-12-03
 * [#1161](https://github.com/stripe/stripe-java/pull/1161) Add support for `documents` on `Account` create and update
 
-## 20.30.0 - 2020-11-24
+## <a id="20-30-0"></a>20.30.0 - 2020-11-24
+* [#1158](https://github.com/stripe/stripe-java/pull/1158) Better log the error causing the JSON parsing to fail on deserialization
 * [#1159](https://github.com/stripe/stripe-java/pull/1159) Multiple API changes
   * Add support for `account_tax_ids` on `Invoice`
   * Add support for `payment_method_options[sepa_debit]` on `PaymentIntent`
-* [#1158](https://github.com/stripe/stripe-java/pull/1158) Better log the error causing the JSON parsing to fail on deserialization
 
-## 20.29.0 - 2020-11-20
-* [#1157](https://github.com/stripe/stripe-java/pull/1157) Add support for `capabilities[grabpay_payments]` on `Account`
+## <a id="20-29-0"></a>20.29.0 - 2020-11-20
 * [#1156](https://github.com/stripe/stripe-java/pull/1156) Add support for `mandate_options` on `SetupIntent.payment_method_options.sepa_debit`
+* [#1157](https://github.com/stripe/stripe-java/pull/1157) Add support for `capabilities[grabpay_payments]` on `Account`
 
-## 20.28.0 - 2020-11-18
+## <a id="20-28-0"></a>20.28.0 - 2020-11-18
 * [#1154](https://github.com/stripe/stripe-java/pull/1154) Add support for `grabpay` on `PaymentMethod`.
 
-## 20.27.0 - 2020-11-17
+## <a id="20-27-0"></a>20.27.0 - 2020-11-17
 * [#1152](https://github.com/stripe/stripe-java/pull/1152) Multiple API changes
   * Add support for sepa_debit on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntentConfirmParams.
 
-## 20.26.0 - 2020-11-09
+## <a id="7-63-1"></a>7.63.1 - 2020-11-17
+* Identical to 7.29.0
+
+## <a id="7-63-0"></a>7.63.0 - 2020-11-17
+* Published in error. Do not use. This is identical to 20.27.0.
+
+## <a id="20-26-0"></a>20.26.0 - 2020-11-09
 * [#1149](https://github.com/stripe/stripe-java/pull/1149) Add `invoice.finalization_error` as a `type` on `Event`
 * [#1148](https://github.com/stripe/stripe-java/pull/1148) Multiple API changes
   * Add support for `last_finalization_error` on `Invoice`
   * Add support for deserializing Issuing `Dispute` as a `source` on `BalanceTransaction`
   * Add support for `payment_method_type` on `StripeError` used by other API resources
 
-## 20.25.0 - 2020-11-04
+## <a id="20-25-0"></a>20.25.0 - 2020-11-04
 * [#1147](https://github.com/stripe/stripe-java/pull/1147) Add support for `company[registration_number]` on `Account`
 
-## 20.24.0 - 2020-10-27
+## <a id="20-24-0"></a>20.24.0 - 2020-10-27
 * [#1144](https://github.com/stripe/stripe-java/pull/1144) Add  `payment_method_details[interac_present][preferred_locales]` on `Charge`
 
-## 20.23.0 - 2020-10-26
+## <a id="20-23-0"></a>20.23.0 - 2020-10-26
 * [#1143](https://github.com/stripe/stripe-java/pull/1143) Multiple API changes
   * Add support for `payment_method_options[card][cvc_token]` on `PaymentIntent`
   * Add support for `cvc_update[cvc]` on `Token` creation
 
-## 20.22.0 - 2020-10-23
+## <a id="20-22-0"></a>20.22.0 - 2020-10-23
 * [#1142](https://github.com/stripe/stripe-java/pull/1142) Add support for passing `p24[bank]` for P24 on `PaymentIntent` or `PaymentMethod`
 
-## 20.21.0 - 2020-10-22
-* [#1141](https://github.com/stripe/stripe-java/pull/1141) Support passing `tax_rates` when creating invoice items through `Subscription` or `SubscriptionSchedule`
-* [#1134](https://github.com/stripe/stripe-java/pull/1134) Upgrade Gradle to 6.7
-* [#1138](https://github.com/stripe/stripe-java/pull/1138) Bump ErrorProne to latest version
-* [#1139](https://github.com/stripe/stripe-java/pull/1139) Upgrade Lombok plugin
+## <a id="20-21-0"></a>20.21.0 - 2020-10-22
 * [#1137](https://github.com/stripe/stripe-java/pull/1137) Bump Spotless plugin version
 * [#1135](https://github.com/stripe/stripe-java/pull/1135) Fix deprecation warning in test file
+* [#1138](https://github.com/stripe/stripe-java/pull/1138) Bump ErrorProne to latest version
+* [#1134](https://github.com/stripe/stripe-java/pull/1134) Upgrade Gradle to 6.7
+* [#1139](https://github.com/stripe/stripe-java/pull/1139) Upgrade Lombok plugin
+* [#1141](https://github.com/stripe/stripe-java/pull/1141) Support passing `tax_rates` when creating invoice items through `Subscription` or `SubscriptionSchedule`
 
-## 20.20.0 - 2020-10-20
+## <a id="20-20-0"></a>20.20.0 - 2020-10-20
 * [#1133](https://github.com/stripe/stripe-java/pull/1133) Add support for `jp_rn` and `ru_kpp` as a `type` on `TaxId`
 
-## 20.19.0 - 2020-10-14
+## <a id="20-19-0"></a>20.19.0 - 2020-10-14
 * [#1130](https://github.com/stripe/stripe-java/pull/1130) Add support for `discounts` to SessionCreateParams
 
-## 20.18.0 - 2020-10-14
+## <a id="20-18-0"></a>20.18.0 - 2020-10-14
 * [#1129](https://github.com/stripe/stripe-java/pull/1129) Add support for the Payout Reverse API
 
-## 20.16.0 - 2020-10-09
+## <a id="20-17-0"></a>20.17.0 - 2020-10-12
+
+## <a id="20-16-0"></a>20.16.0 - 2020-10-09
 * [#1126](https://github.com/stripe/stripe-java/pull/1126) Add support for internal-only `description`, `iin`, and `issuer` for `card_present` and `interac_present` on `Charge.payment_method_details`.
 
-## 20.15.0 - 2020-10-08
-* Add support for `generated_sepa_debit` and `generated_sepa_debit_mandate` on `Charge.payment_method_details.ideal`, `Charge.payment_method_details.bancontact` and `Charge.payment_method_details.sofort`
+## <a id="20-15-0"></a>20.15.0 - 2020-10-08
 * Add support for `generated_from` on `PaymentMethod.sepa_debit`
+* Add support for `generated_sepa_debit` and `generated_sepa_debit_mandate` on `Charge.payment_method_details.ideal`, `Charge.payment_method_details.bancontact` and `Charge.payment_method_details.sofort`
 * Add support for `ideal`, `bancontact` and `sofort` on `SetupAttempt.payment_method_details`
 
-## 20.14.0 - 2020-10-02
-* [#1120](https://github.com/stripe/stripe-java/pull/1120) Add support for `TosAcceptance.ServiceAgreement` on `Account`
+## <a id="20-14-0"></a>20.14.0 - 2020-10-02
 * [#1119](https://github.com/stripe/stripe-java/pull/1119) Add support for new payments capabilities on `Account`
+* [#1120](https://github.com/stripe/stripe-java/pull/1120) Add support for `TosAcceptance.ServiceAgreement` on `Account`
 
-## 20.13.0 - 2020-09-29
+## <a id="20-13-0"></a>20.13.0 - 2020-09-29
 * [#1118](https://github.com/stripe/stripe-java/pull/1118) Add support for the `SetupAttempt` resource and List API
 
-## 20.12.0 - 2020-09-29
+## <a id="20-12-0"></a>20.12.0 - 2020-09-29
 * [#1117](https://github.com/stripe/stripe-java/pull/1117) Add support for `contribution` in `reporting_category` on `ReportRun`
 
-## 20.11.0 - 2020-09-28
+## <a id="20-11-0"></a>20.11.0 - 2020-09-28
 * [#1116](https://github.com/stripe/stripe-java/pull/1116) Add support for `oxxo_payments` capability on `Account`
 
-## 20.10.0 - 2020-09-25
+## <a id="20-10-0"></a>20.10.0 - 2020-09-25
 * [#1113](https://github.com/stripe/stripe-java/pull/1113) Add support for `oxxo` as a valid `type` on the List PaymentMethod API
 
-## 20.9.0 - 2020-09-24
+## <a id="20-9-0"></a>20.9.0 - 2020-09-24
 * [#1112](https://github.com/stripe/stripe-java/pull/1112) Add support for OXXO on `PaymentMethod` and `PaymentIntent`
 
-## 20.8.0 - 2020-09-23
+## <a id="20-8-0"></a>20.8.0 - 2020-09-23
 * [#1109](https://github.com/stripe/stripe-java/pull/1109) Multiple API changes
   * Add support for `issuing_dispute.closed` and `issuing_dispute.submitted` events
   * Add support for `instant_available` on `Balance`
 
-## 20.7.0 - 2020-09-21
+## <a id="20-7-0"></a>20.7.0 - 2020-09-21
 * [#1106](https://github.com/stripe/stripe-java/pull/1106) Multiple API changes
   * Add support for `amount_captured` on `Charge`
   * Add `checkout_session` on `Discount`
 
-## 20.6.0 - 2020-09-13
+## <a id="20-6-0"></a>20.6.0 - 2020-09-13
 * [#1102](https://github.com/stripe/stripe-java/pull/1102) Add support for `promotion_code.created` and `promotion_code.updated` on `Event`
 
-## 20.5.0 - 2020-09-10
+## <a id="20-5-0"></a>20.5.0 - 2020-09-10
 * [#1099](https://github.com/stripe/stripe-java/pull/1099) Add support for SEPA debit on Checkout
 
-## 20.4.0 - 2020-09-09
+## <a id="20-4-0"></a>20.4.0 - 2020-09-09
 * [#1098](https://github.com/stripe/stripe-java/pull/1098) Multiple API changes
   * Add support for `sofort` as a `type` on the List PaymentMethods API
   * Add back support for `invoice.payment_succeeded`
 
-## 20.3.2 - 2020-09-09
+## <a id="20-3-2"></a>20.3.2 - 2020-09-09
 * Increase `delayBetweenRetriesInMillis` deploy property from default of 2000 to 4000 to help mitigate close timeouts
 
-## 20.3.1 - 2020-09-09
+## <a id="20-3-1"></a>20.3.1 - 2020-09-09
 * [#1095](https://github.com/stripe/stripe-java/pull/1095) OAuth.deauthorize no longer mutates params
 
-## 20.3.0 - 2020-09-08
+## <a id="20-3-0"></a>20.3.0 - 2020-09-08
 * [#1096](https://github.com/stripe/stripe-java/pull/1096) Add support for Sofort on `PaymentMethod` and `PaymentIntent`
 
-## 20.2.0 - 2020-09-02
+## <a id="20-2-0"></a>20.2.0 - 2020-09-02
 * [#1092](https://github.com/stripe/stripe-java/pull/1092) Multiple API changes
   * Improve support for the Issuing `Dispute` APIs. Added the Submit API, missing parameters on creation, update and list and returned evidence details
   * Add support for `dispute` on Issuing `Transaction`
   * Add `available_payout_methods` on `BankAccount`
   * Add `payment_status` on Checkout `Session`
 
-## 20.1.0 - 2020-08-31
+## <a id="20-1-0"></a>20.1.0 - 2020-08-31
 * [#1089](https://github.com/stripe/stripe-java/pull/1089) Add support for `payment_method.automatically_updated` on `WebhookEndpoint`
 
-## 20.0.0 - 2020-08-31
+## <a id="20-0-0"></a>20.0.0 - 2020-08-31
+* [#1087](https://github.com/stripe/stripe-java/pull/1087) Fix retrieval of upcoming Invoice line items
 * [#1088](https://github.com/stripe/stripe-java/pull/1088) Multiple API changes
   * Pin to API version `2020-08-27`
   * Removed `authenticated` and `succeeded` on `payment_method_details[card][three_d_secure]` on `Charge`
@@ -2957,29 +2953,28 @@ This release includes breaking changes resulting from:
   * Removed `failure_url` and `success_url` from `AccountLink`, use `refresh_url` and `return_url` instead
   * Removed `invoice.payment_succeeded` and `payment_method.card_automatically_updated` events
   * `sources` and `tax_ids` on `Customer` are now includable sub-lists and not returned by default when retrieving a customer. You need to explicitly expand those properties to call `getTaxIds()` or `getSources()` now to create those sub-resources. Our API Reference has been updated to reflect this.
-* [#1087](https://github.com/stripe/stripe-java/pull/1087) Fix retrieval of upcoming Invoice line items
 
-## 19.45.0 - 2020-08-19
+## <a id="19-45-0"></a>19.45.0 - 2020-08-19
 * [#1085](https://github.com/stripe/stripe-java/pull/1085) Add support for `expires_at` on `File`
 
-## 19.44.0 - 2020-08-17
+## <a id="19-44-0"></a>19.44.0 - 2020-08-17
 * [#1084](https://github.com/stripe/stripe-java/pull/1084) Add support for `amount_details` on Issuing `Authorization` and `Transaction`
 
-## 19.43.0 - 2020-08-17
+## <a id="19-43-0"></a>19.43.0 - 2020-08-17
 * [#1083](https://github.com/stripe/stripe-java/pull/1083) Multiple API changes
   * Add `alipay` on `type` for the List PaymentMethods API
   * Add `payment_intent.requires_action` as a new `type` on `Event`
 
-## 19.42.0 - 2020-08-13
+## <a id="19-42-0"></a>19.42.0 - 2020-08-13
 * [#1082](https://github.com/stripe/stripe-java/pull/1082) Add support for Alipay on Checkout `Session`
 
-## 19.41.0 - 2020-08-13
+## <a id="19-41-0"></a>19.41.0 - 2020-08-13
 * [#1081](https://github.com/stripe/stripe-java/pull/1081) Add `payment_method_details[acss_debit][bank_name]` on `Charge`
 
-## 19.40.0 - 2020-08-07
+## <a id="19-40-0"></a>19.40.0 - 2020-08-07
 * [#1078](https://github.com/stripe/stripe-java/pull/1078) Add support for Alipay on `PaymentMethod` and `PaymentIntent`
 
-## 19.39.0 - 2020-08-05
+## <a id="19-39-0"></a>19.39.0 - 2020-08-05
 * [#1077](https://github.com/stripe/stripe-java/pull/1077) Multiple API changes
   * Add support for the `PromotionCode` resource and APIs
   * Add support for `allow_promotion_codes` on Checkout `Session`
@@ -2987,119 +2982,119 @@ This release includes breaking changes resulting from:
   * Add support for `promotion_code` on `Customer` and `Subscription`
   * Add support for `promotion_code` on `Discount`
 
-## 19.38.0 - 2020-08-04
+## <a id="19-38-0"></a>19.38.0 - 2020-08-04
 * [#1076](https://github.com/stripe/stripe-java/pull/1076) Multiple API changes
   * Add `zh-HK` and `zh-TW` as `locale` on Checkout `Session`.
   * Add `payment_method_details[card_present][receipt][account_type]` on `Charge`
 
-## 19.37.0 - 2020-07-31
-* [#1065](https://github.com/stripe/stripe-java/pull/1065) Support setting "proxy" per-request
+## <a id="19-37-0"></a>19.37.0 - 2020-07-31
 * [#1072](https://github.com/stripe/stripe-java/pull/1072) Socket timeout exceptions are now also subject to retries
+* [#1065](https://github.com/stripe/stripe-java/pull/1065) Support setting "proxy" per-request
 
-## 19.36.0 - 2020-07-29
+## <a id="19-36-0"></a>19.36.0 - 2020-07-29
 * [#1070](https://github.com/stripe/stripe-java/pull/1070) Multiple API changes
   * Add support for `id`, `invoice` and `invoice_item` on `Discount`
   * Add support for `discount_amounts` on `CreditNote`, `CreditNoteLineItem`, `InvoiceLineItem`
   * Add support for `discounts` on `InvoiceItem`, `InvoiceLineItem` and `Invoice`
   * Add support for `total_discount_amounts` on `Invoice`
 
-## 19.35.0 - 2020-07-24
+## <a id="19-35-0"></a>19.35.0 - 2020-07-24
 * [#1068](https://github.com/stripe/stripe-java/pull/1068) Add `capabilities[fpx_payments]` on `Account` create and update
 
-## 19.34.0 - 2020-07-22
+## <a id="19-34-0"></a>19.34.0 - 2020-07-22
 * [#1067](https://github.com/stripe/stripe-java/pull/1067) Add support for `cartes_bancaires_payments` as a `Capability`
 
-## 19.33.0 - 2020-07-20
+## <a id="19-33-0"></a>19.33.0 - 2020-07-20
 * [#1066](https://github.com/stripe/stripe-java/pull/1066) Add support for `capabilities` as a parameter on `Account` create and update
 
-## 19.32.0 - 2020-07-17
+## <a id="19-32-0"></a>19.32.0 - 2020-07-17
 * [#1062](https://github.com/stripe/stripe-java/pull/1062) Add support for `political_exposure` on `Person`
 
-## 19.31.0 - 2020-07-16
+## <a id="19-31-0"></a>19.31.0 - 2020-07-16
 * [#1061](https://github.com/stripe/stripe-java/pull/1061) Multiple API changes
   * Add `deleted` on `LineItem`
   * Add support for `account_onboarding` and `account_update` as `type` on `AccountLink`
 
-## 19.30.0 - 2020-07-15
+## <a id="19-30-0"></a>19.30.0 - 2020-07-15
 * [#1058](https://github.com/stripe/stripe-java/pull/1058) Add support for `en-GB`, `fr-CA` and `id` as `locale` on Checkout `Session`
 
-## 19.29.0 - 2020-07-15
+## <a id="19-29-0"></a>19.29.0 - 2020-07-15
 * [#1057](https://github.com/stripe/stripe-java/pull/1057) Add support for `amount_total`, `amount_subtotal`, `currency` and `total_details` on Checkout `Session`
 
-## 19.28.0 - 2020-07-13
+## <a id="19-28-0"></a>19.28.0 - 2020-07-13
 * [#1055](https://github.com/stripe/stripe-java/pull/1055) Multiple API changes
   * Adds `es-419` as a `locale` to Checkout `Session`
   * Adds `billing_cycle_anchor` to `default_settings` and `phases` for `SubscriptionSchedule`
 
-## 19.27.0 - 2020-06-24
+## <a id="19-27-0"></a>19.27.0 - 2020-06-24
 * [#1052](https://github.com/stripe/stripe-java/pull/1052) Add support for `invoice.paid` event
 
-## 19.26.0 - 2020-06-23
+## <a id="19-26-0"></a>19.26.0 - 2020-06-23
 * [#1049](https://github.com/stripe/stripe-java/pull/1049) Add support for `payment_method_data` on `PaymentIntent`
 
-## 19.25.0 - 2020-06-23
+## <a id="19-25-0"></a>19.25.0 - 2020-06-23
 * [#1048](https://github.com/stripe/stripe-java/pull/1048) Multiple API changes
   * Add `discounts` on `LineItem`
   * Add `document_provider_identity_document` as a `purpose` on `File`
   * Support nullable `metadata` on Issuing `Dispute`
   * Add `klarna[shipping_delay]` on `Source`
 
-## 19.24.0 - 2020-06-18
+## <a id="19-24-0"></a>19.24.0 - 2020-06-18
 * [#1047](https://github.com/stripe/stripe-java/pull/1047) Multiple API changes
   * Add support for `refresh_url` and `return_url` on `AccountLink`
   * Add support for `issuing_dispute.*` events
 
-## 19.23.0 - 2020-06-11
+## <a id="19-23-0"></a>19.23.0 - 2020-06-11
 * [#1044](https://github.com/stripe/stripe-java/pull/1044) Multiple API changes
   * Add `transaction` on Issuing `Dispute`
   * Add `payment_method_details[acss_debit][mandate]` on `Charge`
 
-## 19.22.0 - 2020-06-10
+## <a id="19-22-0"></a>19.22.0 - 2020-06-10
 * [#1043](https://github.com/stripe/stripe-java/pull/1043) Add support for Cartes Bancaires payments on `PaymentIntent` and `Pay…
 
-## 19.21.0 - 2020-06-09
+## <a id="19-21-0"></a>19.21.0 - 2020-06-09
 * [#1042](https://github.com/stripe/stripe-java/pull/1042) Add support for `id_npwp` and `my_frp` as `type` on `TaxId`
 
-## 19.20.0 - 2020-06-03
+## <a id="19-20-0"></a>19.20.0 - 2020-06-03
 * [#1041](https://github.com/stripe/stripe-java/pull/1041) Add support for `payment_intent_data[transfer_group]` on Checkout `Session`
 
-## 19.19.0 - 2020-06-03
+## <a id="19-19-0"></a>19.19.0 - 2020-06-03
 * [#1040](https://github.com/stripe/stripe-java/pull/1040) Add support for Bancontact, EPS, Giropay and P24 on Checkout `Session`
 
-## 19.18.0 - 2020-06-03
+## <a id="19-18-0"></a>19.18.0 - 2020-06-03
 * [#1039](https://github.com/stripe/stripe-java/pull/1039) Multiple API changes
   * Add `bacs_debit_payments` as a `Capability`
   * Add support for BACS Debit on Checkout `Session`
   * Add support for `checkout.session.async_payment_failed` and `checkout.session.async_payment_succeeded` as `type` on `Event`
 
-## 19.17.0 - 2020-06-03
+## <a id="19-17-0"></a>19.17.0 - 2020-06-03
 * [#1038](https://github.com/stripe/stripe-java/pull/1038) Multiple API changes
   * Add support for bg, cs, el, et, hu, lt, lv, mt, ro, ru, sk, sl and tr as new locale on Checkout `Session`
   * Add `settings[sepa_debit_payments][creditor_id]` on `Account`
   * Add support for Bancontact, EPS, Giropay and P24 on `PaymentMethod`, `PaymentIntent` and `SetupIntent`
   * Add support for `order_item[parent]` on `Source` for Klarna
 
-## 19.16.0 - 2020-05-29
+## <a id="19-16-0"></a>19.16.0 - 2020-05-29
 * [#1036](https://github.com/stripe/stripe-java/pull/1036) Add support for BACS Debit as a `PaymentMethod`
 
-## 19.15.0 - 2020-05-28
+## <a id="19-15-0"></a>19.15.0 - 2020-05-28
 * [#1035](https://github.com/stripe/stripe-java/pull/1035) Multiple API changes
   * Add `payment_method_details[card][three_d_secure][authentication_flow]` on `Charge`
   * Add `line_items[][price_data][product_data]` on Checkout `Session` creation
 
-## 19.14.0 - 2020-05-22
+## <a id="19-14-0"></a>19.14.0 - 2020-05-22
 * [#1034](https://github.com/stripe/stripe-java/pull/1034) Multiple API changes
   * Add support for `ae_trn`, `cl_tin` and `sa_vat` as `type` on `TaxId`
   * Add `result` and `result_reason` inside `payment_method_details[card][three_d_secure]` on `Charge`
 
-## 19.13.0 - 2020-05-20
+## <a id="19-13-0"></a>19.13.0 - 2020-05-20
 * [#1033](https://github.com/stripe/stripe-java/pull/1033) Multiple API changes
   * Add `anticipation_repayment` as a `type` on `BalanceTransaction`
   * Add `interac_present` as a `type` on `PaymentMethod`
   * Add `payment_method_details[interac_present]` on `Charge`
   * Add `transfer_data` on `SubscriptionSchedule`
 
-## 19.12.0 - 2020-05-18
+## <a id="19-12-0"></a>19.12.0 - 2020-05-18
 * [#1032](https://github.com/stripe/stripe-java/pull/1032) Multiple API changes
   * Add support for `issuing_dispute` as a `type` on `BalanceTransaction`
   * Add `balance_transactions` as an array of `BalanceTransaction` on Issuing `Dispute`
@@ -3108,47 +3103,47 @@ This release includes breaking changes resulting from:
   * Add `transfer_data[amount_percent]` on `Subscription`
   * Add `price.created`, `price.deleted` and `price.updated` on `Event`.
 
-## 19.11.0 - 2020-05-13
+## <a id="19-11-0"></a>19.11.0 - 2020-05-13
 * [#1030](https://github.com/stripe/stripe-java/pull/1030) Add support for `purchase_details` on Issuing `Transaction`
 
-## 19.10.0 - 2020-05-11
+## <a id="19-10-0"></a>19.10.0 - 2020-05-11
 * [#1028](https://github.com/stripe/stripe-java/pull/1028) Add support for the `LineItem` resource and APIs
 
-## 19.9.0 - 2020-05-07
+## <a id="19-9-0"></a>19.9.0 - 2020-05-07
 * [#1025](https://github.com/stripe/stripe-java/pull/1025) Multiple API changes
   * Remove parameters in `price_data[recurring]` across APIs as they were never supported
   * Move `payment_method_details[card][three_d_secure]` to a list of enum values on `Charge`
   * Add support for for `business_profile[support_address]` on `Account` create and update
 
-## 19.8.0 - 2020-05-01
+## <a id="19-8-0"></a>19.8.0 - 2020-05-01
 * [#1022](https://github.com/stripe/stripe-java/pull/1022) Add support for `issuing` on `Balance`
 
-## 19.7.0 - 2020-04-29
+## <a id="19-7-0"></a>19.7.0 - 2020-04-29
 * [#1020](https://github.com/stripe/stripe-java/pull/1020) Add support for `br_cpf` and `br_cnpj` as `type` on `TaxId`
 
-## 19.6.0 - 2020-04-29
+## <a id="19-6-0"></a>19.6.0 - 2020-04-29
 * [#1019](https://github.com/stripe/stripe-java/pull/1019) Add support for the `Price` resource and APIs
 
-## 19.5.0 - 2020-04-24
+## <a id="19-5-0"></a>19.5.0 - 2020-04-24
 * [#1016](https://github.com/stripe/stripe-java/pull/1016) Add support for `jcb_payments` as a `Capability`
 
-## 19.4.0 - 2020-04-22
+## <a id="19-4-0"></a>19.4.0 - 2020-04-22
 * [#1015](https://github.com/stripe/stripe-java/pull/1015) Add support for `coupon` for subscriptions on Checkout
 
-## 19.3.0 - 2020-04-22
+## <a id="19-3-0"></a>19.3.0 - 2020-04-22
 * [#1014](https://github.com/stripe/stripe-java/pull/1014) Add support for `billingportal` namespace and `Session` resource and APIs
 
-## 19.2.0 - 2020-04-17
+## <a id="19-2-0"></a>19.2.0 - 2020-04-17
 * [#1013](https://github.com/stripe/stripe-java/pull/1013) Multiple API changes
   * Add support for `cardholder_name` in `payment_method_details[card_present]` on `Charge`
   * Add new enum values for `company[structure]` on `Account`
 
-## 19.1.0 - 2020-04-16
+## <a id="19-1-0"></a>19.1.0 - 2020-04-16
 * [#1010](https://github.com/stripe/stripe-java/pull/1010) Multiple API changes
   * Add `institution_number` and `transit_number` in `payment_method_details[acss]` on `Charge`
   * Add `cvc` and `number` as properties that can be included when retrieving an Issuing `Card`
 
-## 19.0.0 - 2020-04-15
+## <a id="19-0-0"></a>19.0.0 - 2020-04-15
 * [#1009](https://github.com/stripe/stripe-java/pull/1009) Multiple breaking API changes while removing deprecated Issuing features:
   * Moved `SettingsBranding` on `Account` is now `Branding` inside the `Settings` on `Account`
   * Removed `percentage` filter from the List `TaxRate` API
@@ -3183,40 +3178,40 @@ This release includes breaking changes resulting from:
       * Reference `merchant_data` from the inner class in `Authorization`
       * Removed enum values for `type` to only have `capture` and `refund`
 
-## 18.16.0 - 2020-04-14
+## <a id="18-16-0"></a>18.16.0 - 2020-04-14
 * [#1006](https://github.com/stripe/stripe-java/pull/1006) Add support for `settings[branding][secondary_color]` on `Account`
 
-## 18.15.0 - 2020-04-13
+## <a id="18-15-0"></a>18.15.0 - 2020-04-13
 * [#1003](https://github.com/stripe/stripe-java/pull/1003) Add support for `description` on `WebhookEndpoint`
 
-## 18.14.0 - 2020-04-10
+## <a id="18-14-0"></a>18.14.0 - 2020-04-10
 * [#1002](https://github.com/stripe/stripe-java/pull/1002) Multiple API changes
   * Make `payment_intent` expandable on `Charge`
   * Add support for `sg_gst` as a value for `type` on `TaxId` and related APIs
   * Add `cancellation_reason` and new enum values for `replacement_reason` on Issuing `Card`
 
-## 18.13.1 - 2020-04-06
-* [#971](https://github.com/stripe/stripe-java/pull/971) Improve connection reuse
+## <a id="18-13-1"></a>18.13.1 - 2020-04-06
 * [#999](https://github.com/stripe/stripe-java/pull/999) Bump Gradle and other dependencies
+* [#971](https://github.com/stripe/stripe-java/pull/971) Improve connection reuse
 
-## 18.13.0 - 2020-04-03
+## <a id="18-13-0"></a>18.13.0 - 2020-04-03
 * [#998](https://github.com/stripe/stripe-java/pull/998) Add support for `calculatedStatementDescriptor` on `Charge`
 
-## 18.12.0 - 2020-03-26
+## <a id="18-12-0"></a>18.12.0 - 2020-03-26
 * [#994](https://github.com/stripe/stripe-java/pull/994) Add support for `spending_controls` on Issuing `Card` and `Cardholder`
 
-## 18.11.0 - 2020-03-25
+## <a id="18-11-0"></a>18.11.0 - 2020-03-25
 * [#993](https://github.com/stripe/stripe-java/pull/993) Multiple API changes
   * Add support for `pt-BR` as a `locale` on Checkout `Session`
   * Add support for `company` as a `type` on Issuing `Cardholder`
 
-## 18.10.0 - 2020-03-24
+## <a id="18-10-0"></a>18.10.0 - 2020-03-24
 * [#992](https://github.com/stripe/stripe-java/pull/992) Add support for `pause_collection` on `Subscription`
 
-## 18.9.0 - 2020-03-23
+## <a id="18-9-0"></a>18.9.0 - 2020-03-23
 * [#991](https://github.com/stripe/stripe-java/pull/991) Add support for capabilities for AU Becs Debit and Tax reporting
 
-## 18.8.0 - 2020-03-20
+## <a id="18-8-0"></a>18.8.0 - 2020-03-20
 * [#989](https://github.com/stripe/stripe-java/pull/989) Multiple API changes for Issuing:
   * Add `amount`, `currency`, `merchant_amount` and `merchant_currency` on `Authorization`
   * Add `amount`, `currency`, `merchant_amount` and `merchant_currency` inside `request_history` on `Authorization`
@@ -3224,171 +3219,170 @@ This release includes breaking changes resulting from:
   * Add `amount` when approving an `Authorization`
   * Add `replaced_by` on `Card`.
 
-## 18.7.0 - 2020-03-13
+## <a id="18-7-0"></a>18.7.0 - 2020-03-13
 * [#986](https://github.com/stripe/stripe-java/pull/986) Multiple API changes for Issuing:
   * Rename `speed` to `service` on Issuing `Card`
   * Rename `wallet_provider` to `wallet` and `address_zip_check` to `address_postal_code_check` on Issuing `Authorization`
   * Mark `is_default` as deprecated on Issuing `Cardholder`
 
-## 18.6.0 - 2020-03-12
+## <a id="18-6-0"></a>18.6.0 - 2020-03-12
 * [#985](https://github.com/stripe/stripe-java/pull/985) Add support for `shipping` and `shipping_address_collection` on Checkout `Session`
 
-## 18.5.0 - 2020-03-12
+## <a id="18-5-0"></a>18.5.0 - 2020-03-12
 * [#984](https://github.com/stripe/stripe-java/pull/984) Add support for `ThreeDSecure` on Issuing `Authorization`
 
-## 18.4.0 - 2020-03-05
+## <a id="18-4-0"></a>18.4.0 - 2020-03-05
 * [#981](https://github.com/stripe/stripe-java/pull/981) Make metadata nullable in many methods
 
-## 18.3.0 - 2020-03-04
+## <a id="18-3-0"></a>18.3.0 - 2020-03-04
 * [#980](https://github.com/stripe/stripe-java/pull/980) Add support for `metadata` on `WebhookEndpoint`
 
-## 18.2.0 - 2020-03-04
+## <a id="18-2-0"></a>18.2.0 - 2020-03-04
 * [#979](https://github.com/stripe/stripe-java/pull/979) Multiple API changes
   * Add support for `account` as a parameter on `Token` to create Account tokens
   * Add support for `verification_data.expiry_check` on Issuing `Authorization`
   * Add support for `incorrect_cvc` and `incorrect_expiry` as a value for `request_history.reason` on Issuing `Authorization`
 
-## 18.1.0 - 2020-03-04
+## <a id="18-1-0"></a>18.1.0 - 2020-03-04
 * [#978](https://github.com/stripe/stripe-java/pull/978) Multiple API changes
   * Add support for `errors` in `requirements` on `Account`, `Capability` and `Person`
   * Add support for `payment_intent.processing` as a new `type` on `Event`.
 
-## 18.0.0 - 2020-03-03
+## <a id="18-0-0"></a>18.0.0 - 2020-03-03
 * [#977](https://github.com/stripe/stripe-java/pull/977) Multiple API changes:
   * Pin to API version `2020-03-02`
   * Remove `uob_regional` as a value on `bank` for FPX as this is deprecated and was never used
   * Add support for `next_invoice_sequence` on `Customer`
   * Add support for `proration_behavior` on `SubscriptionItem` delete
 
-## 17.16.0 - 2020-02-28
+## <a id="17-16-0"></a>17.16.0 - 2020-02-28
 * [#976](https://github.com/stripe/stripe-java/pull/976) Add `my_sst` as a valid value for `type` on `TaxId`
 
-## 17.15.0 - 2020-02-27
+## <a id="17-15-0"></a>17.15.0 - 2020-02-27
 * [#975](https://github.com/stripe/stripe-java/pull/975) Make `type` on `AccountLink` an enum
 
-## 17.14.0 - 2020-02-24
+## <a id="17-14-0"></a>17.14.0 - 2020-02-24
 * [#974](https://github.com/stripe/stripe-java/pull/974) Add new enum values in `reason` for Issuing `Dispute` creation
 
-## 17.13.0 - 2020-02-24
+## <a id="17-13-0"></a>17.13.0 - 2020-02-24
 * [#973](https://github.com/stripe/stripe-java/pull/973) Add support for listing Checkout `Session` and passing tax rate information
 
-## 17.12.0 - 2020-02-21
+## <a id="17-12-0"></a>17.12.0 - 2020-02-21
 * [#970](https://github.com/stripe/stripe-java/pull/970) Multiple API changes
   * Add support for `timezone` on `ReportRun`
   * Add support for `proration_behavior` on `SubscriptionSchedule`
 
-## 17.11.0 - 2020-02-12
+## <a id="17-11-0"></a>17.11.0 - 2020-02-12
 * [#968](https://github.com/stripe/stripe-java/pull/968) Add support for `payment_intent_data[transfer_data][amount]` on Checkout `Session`
 
-## 17.10.0 - 2020-02-12
+## <a id="17-10-0"></a>17.10.0 - 2020-02-12
 * [#967](https://github.com/stripe/stripe-java/pull/967) Multiple API changes
   * Add `fpx` as a valid `source_type` on `Balance`, `Payout` and `Transfer`
   * Add `fpx` support on Checkout `Session`
   * Fields inside `verification_data` on Issuing `Authorization` are now enums
   * Support updating `payment_method_options` on `PaymentIntent` and `SetupIntent`
 
-## 17.9.1 - 2020-02-11
-* [#964](https://github.com/stripe/stripe-java/pull/964) Convert Markdown to HTML in Javadoc
+## <a id="17-9-1"></a>17.9.1 - 2020-02-11
 * [#965](https://github.com/stripe/stripe-java/pull/965) Add Gradle plugin for publishing JavaDoc to GitHub Pages
+* [#964](https://github.com/stripe/stripe-java/pull/964) Convert Markdown to HTML in Javadoc
 
-## 17.9.0 - 2020-02-10
+## <a id="17-9-0"></a>17.9.0 - 2020-02-10
 * [#963](https://github.com/stripe/stripe-java/pull/963) Multiple API changes
   * Add support for new `type` values for `TaxId`.
   * Add support for `payment_intent_data[statement_descriptor_suffix]` on Checkout `Session`.
 
-## 17.8.0 - 2020-02-04
+## <a id="17-8-0"></a>17.8.0 - 2020-02-04
 * [#961](https://github.com/stripe/stripe-java/pull/961) Rename `sort_code` to `sender_sort_code` on `SourceTransaction` for BACS debit. (This is technically a breaking change.)
 
-## 17.7.0 - 2020-02-03
-* [#960](https://github.com/stripe/stripe-java/pull/960) Add support for `error_on_requires_action` on `PaymentIntent`
+## <a id="17-7-0"></a>17.7.0 - 2020-02-03
 * [#957](https://github.com/stripe/stripe-java/pull/957) Add additional verification file purpose
+* [#960](https://github.com/stripe/stripe-java/pull/960) Add support for `error_on_requires_action` on `PaymentIntent`
 
-## 17.6.0 - 2020-01-31
+## <a id="17-6-0"></a>17.6.0 - 2020-01-31
 * [#959](https://github.com/stripe/stripe-java/pull/959) Add support for `company.structure` on `Account` and new types of `TaxId`
 
-## 17.5.0 - 2020-01-30
+## <a id="17-5-0"></a>17.5.0 - 2020-01-30
 * [#955](https://github.com/stripe/stripe-java/pull/955) Add support for FPX as a `PaymentMethod`
 
-## 17.4.0 - 2020-01-28
-* [#953](https://github.com/stripe/stripe-java/pull/953) Add new type for `TaxId` and `sender_account_name` on `SourceTransaction`
+## <a id="17-4-0"></a>17.4.0 - 2020-01-28
 * [#949](https://github.com/stripe/stripe-java/pull/949) Move examples to Customer instead of Charge
+* [#953](https://github.com/stripe/stripe-java/pull/953) Add new type for `TaxId` and `sender_account_name` on `SourceTransaction`
 
-## 17.3.0 - 2020-01-24
+## <a id="17-3-0"></a>17.3.0 - 2020-01-24
 * [#948](https://github.com/stripe/stripe-java/pull/948) Add support for `shipping.speed` on Issuing `Card` and new `TaxID` types
 
-## 17.2.0 - 2020-01-24
+## <a id="17-2-0"></a>17.2.0 - 2020-01-24
 * [#947](https://github.com/stripe/stripe-java/pull/947) Changes for custom HTTP clients
 
-## 17.1.1 - 2020-01-22
+## <a id="17-1-1"></a>17.1.1 - 2020-01-22
 * [#944](https://github.com/stripe/stripe-java/pull/944) Improve docstrings for many properties and parameters
 
-## 17.1.0 - 2020-01-17
-* [#943](https://github.com/stripe/stripe-java/pull/943) Add support for `metadata` on Checkout `Session`
+## <a id="17-1-0"></a>17.1.0 - 2020-01-17
 * [#940](https://github.com/stripe/stripe-java/pull/940) Add `StripeObjectInterface` interface
+* [#943](https://github.com/stripe/stripe-java/pull/943) Add support for `metadata` on Checkout `Session`
 
-## 17.0.0 - 2020-01-15
-* [#869](https://github.com/stripe/stripe-java/pull/869)
-Major version release. Refer to our [migration guide for v17](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v17) for a list of new features and backwards incompatible changes to watch out for.
-
+## <a id="17-0-0"></a>17.0.0 - 2020-01-15
 Pull requests included in this release (cf. [#869](https://github.com/stripe/stripe-java/pull/869)) (⚠️ = breaking changes):
+
 * [#857](https://github.com/stripe/stripe-java/pull/857) Refactor form encoding
-* [#870](https://github.com/stripe/stripe-java/pull/870) ⚠️ Refactor request telemetry
+* ⚠️ [#870](https://github.com/stripe/stripe-java/pull/870) Refactor request telemetry
 * [#872](https://github.com/stripe/stripe-java/pull/872) Move HTTP request methods into new `HttpClient` class
-* [#878](https://github.com/stripe/stripe-java/pull/878) Add `StripeRequest` object
 * [#879](https://github.com/stripe/stripe-java/pull/879) Add `HttpClient` abstract class
-* [#880](https://github.com/stripe/stripe-java/pull/880) ⚠️ Stop disabling the DNS cache
+* [#878](https://github.com/stripe/stripe-java/pull/878) Add `StripeRequest` object
+* ⚠️ [#880](https://github.com/stripe/stripe-java/pull/880) Stop disabling the DNS cache
 * [#895](https://github.com/stripe/stripe-java/pull/895) Fix deprecation warnings
 * [#896](https://github.com/stripe/stripe-java/pull/896) Add `HttpContent` class
 * [#897](https://github.com/stripe/stripe-java/pull/897) Add `Stopwatch` class
 * [#898](https://github.com/stripe/stripe-java/pull/898) Move all request properties in `StripeRequest`
-* [#899](https://github.com/stripe/stripe-java/pull/899) ⚠️ Remove `ApiResource.RequestType`
+* ⚠️ [#899](https://github.com/stripe/stripe-java/pull/899) Remove `ApiResource.RequestType`
 * [#900](https://github.com/stripe/stripe-java/pull/900) Add support for automatic request retries
 * [#902](https://github.com/stripe/stripe-java/pull/902) Minor fixes
+* ⚠️ [#927](https://github.com/stripe/stripe-java/pull/927) Remove support for custom `URLStreamHandler`
 * [#928](https://github.com/stripe/stripe-java/pull/928) `StringUtils` class & better API key validation
-* [#927](https://github.com/stripe/stripe-java/pull/927) ⚠️ Remove support for custom `URLStreamHandler`
-* [#931](https://github.com/stripe/stripe-java/pull/931) ⚠️ Refactor HTTP headers handling
-* [#932](https://github.com/stripe/stripe-java/pull/932) ⚠️ Modernize `StripeResponse`
+* ⚠️ [#932](https://github.com/stripe/stripe-java/pull/932) Modernize `StripeResponse`
+* ⚠️ [#931](https://github.com/stripe/stripe-java/pull/931) Refactor HTTP headers handling
 * [#934](https://github.com/stripe/stripe-java/pull/934) Add `maxNetworkRetries` as a global and per-request setting
-* [#935](https://github.com/stripe/stripe-java/pull/935) ⚠️ Add `StreamUtils` class
-* [#936](https://github.com/stripe/stripe-java/pull/936) ⚠️ Remove support for `count` and `total_count` in list objects
-* [#938](https://github.com/stripe/stripe-java/pull/938) ⚠️ Remove deprecated properties and parameters
+* ⚠️ [#935](https://github.com/stripe/stripe-java/pull/935) Add `StreamUtils` class
+* [#869](https://github.com/stripe/stripe-java/pull/869) Major version release. Refer to our [migration guide for v17](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v17) for a list of new features and backwards incompatible changes to watch out for.
+* ⚠️ [#938](https://github.com/stripe/stripe-java/pull/938) Remove deprecated properties and parameters
+* ⚠️ [#936](https://github.com/stripe/stripe-java/pull/936) Remove support for `count` and `total_count` in list objects
 * [#939](https://github.com/stripe/stripe-java/pull/939) Update README
 
-## 16.8.0 - 2020-01-15
+## <a id="16-8-0"></a>16.8.0 - 2020-01-15
 * [#937](https://github.com/stripe/stripe-java/pull/937) Adding missing events for pending updates on `Subscription`
 
-## 16.7.0 - 2020-01-15
-* [#933](https://github.com/stripe/stripe-java/pull/933) Add support for `pending_update` on `Subscription`
+## <a id="16-7-0"></a>16.7.0 - 2020-01-15
 * [#930](https://github.com/stripe/stripe-java/pull/930) Bump stripe-mock to 0.79.0
+* [#933](https://github.com/stripe/stripe-java/pull/933) Add support for `pending_update` on `Subscription`
 
-## 16.6.0 - 2020-01-14
+## <a id="16-6-0"></a>16.6.0 - 2020-01-14
 * [#929](https://github.com/stripe/stripe-java/pull/929) Add support for `CreditNoteLineItem`
 
-## 16.5.1 - 2020-01-09
+## <a id="16-5-1"></a>16.5.1 - 2020-01-09
 * [#924](https://github.com/stripe/stripe-java/pull/924) Doc changes for core properties or parameters such as `metadata` or `livemode`
 
-## 16.5.0 - 2020-01-07
+## <a id="16-5-0"></a>16.5.0 - 2020-01-07
 * [#922](https://github.com/stripe/stripe-java/pull/922) Codegen for openapi c896d1f
   * Add support for custom properties on `Source.detach` method
   * Add support for property expansion in `Subscription.cancel` method.
   * Add support for `sg_uen` on `TaxId`
 
-## 16.4.0 - 2019-12-20
+## <a id="16-4-0"></a>16.4.0 - 2019-12-20
 * [#921](https://github.com/stripe/stripe-java/pull/921) Add `executives_provided` on `Account`
 
-## 16.3.0 - 2019-12-20
+## <a id="16-3-0"></a>16.3.0 - 2019-12-20
 * [#918](https://github.com/stripe/stripe-java/pull/918) Multiple API changes
   * Adds `livemode` and `metadata` to Terminal `Reader` and `Location`
   * Adds `ms` as a valid locale on Checkout `Session`
 
-## 16.2.0 - 2019-12-09
-* [#914](https://github.com/stripe/stripe-java/pull/914) Add support for AU BECS Debit on `PaymentMethod`
+## <a id="16-2-0"></a>16.2.0 - 2019-12-09
 * [#906](https://github.com/stripe/stripe-java/pull/906) Add documentation for enum values
+* [#914](https://github.com/stripe/stripe-java/pull/914) Add support for AU BECS Debit on `PaymentMethod`
 
-## 16.1.0 - 2019-12-04
+## <a id="16-1-0"></a>16.1.0 - 2019-12-04
 * [#912](https://github.com/stripe/stripe-java/pull/912) Add support for `network` on `Charge` and `funding_method` on `SourceTransaction`
 
-## 16.0.0 - 2019-12-03
+## <a id="16-0-0"></a>16.0.0 - 2019-12-03
 * [#910](https://github.com/stripe/stripe-java/pull/910) Use global timeouts in RequestOptions
 * [#911](https://github.com/stripe/stripe-java/pull/911) Multiple API changes
   * Pin to API version `2019-12-03`
@@ -3396,66 +3390,66 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * Remove `cardholder` on Issuing `Card` update
   * Remove `invoice_customer_balance_settings` from `Subscription`
 
-## 15.7.0 - 2019-11-26
+## <a id="15-7-0"></a>15.7.0 - 2019-11-26
 * [#908](https://github.com/stripe/stripe-java/pull/908) Add support for Preview endpoint on CreditNote
 
-## 15.6.0 - 2019-11-25
+## <a id="15-6-0"></a>15.6.0 - 2019-11-25
 * [#907](https://github.com/stripe/stripe-java/pull/907) Add support for `out_of_band_amount` on `CreditNote` creation
 
-## 15.5.0 - 2019-11-21
+## <a id="15-5-0"></a>15.5.0 - 2019-11-21
 * [#905](https://github.com/stripe/stripe-java/pull/905) Add support for `payment_intent` filter when listing `Dispute`s.
 
-## 15.4.0 - 2019-11-18
+## <a id="15-4-0"></a>15.4.0 - 2019-11-18
 * [#904](https://github.com/stripe/stripe-java/pull/904) Add support for `violated_authorization_controls` on Issuing `Authorization`
 
-## 15.3.1 - 2019-11-18
-* [#903](https://github.com/stripe/stripe-java/pull/903) Serialize null values in all maps
-* [#901](https://github.com/stripe/stripe-java/pull/901) Minor code quality fixes
+## <a id="15-3-1"></a>15.3.1 - 2019-11-18
 * [#894](https://github.com/stripe/stripe-java/pull/894) Upgrade Gradle and other dependencies
+* [#901](https://github.com/stripe/stripe-java/pull/901) Minor code quality fixes
+* [#903](https://github.com/stripe/stripe-java/pull/903) Serialize null values in all maps
 
-## 15.3.0 - 2019-11-07
+## <a id="15-3-0"></a>15.3.0 - 2019-11-07
+* [#891](https://github.com/stripe/stripe-java/pull/891) Replace Cobertura with JaCoCo
 * [#890](https://github.com/stripe/stripe-java/pull/890) Multiple API changes
   * Add `company` and `individual` to Issuing `Cardholder`
   * Add `sepa_debit` to `PaymentMethodUpdateParams`
-* [#891](https://github.com/stripe/stripe-java/pull/891) Replace Cobertura with JaCoCo
 
-## 15.2.0 - 2019-11-06
+## <a id="15-2-0"></a>15.2.0 - 2019-11-06
 * [#889](https://github.com/stripe/stripe-java/pull/889) Multiple API changes:
   * Add `disputed` on `Charge`.
   * Add `payment_intent` on ` Dispute` and `Refund`.
   * Add `payment_intent` when creating a `Refund`.
   * Add `payment_intent` filter when listing `Refund` and `Dispute`.
 
-## 15.1.0 - 2019-11-06
+## <a id="15-1-0"></a>15.1.0 - 2019-11-06
 * [#888](https://github.com/stripe/stripe-java/pull/888) Add support for SEPA and iDEAL on `PaymentMethod` and `Mandate`
 
-## 15.0.0 - 2019-11-05
+## <a id="15-0-0"></a>15.0.0 - 2019-11-05
 * [#886](https://github.com/stripe/stripe-java/pull/886) Move to the latest API version and add new changes
   * Move to API version `2019-11-05`
   * Add `default_settings` on `SubscritionSchedule`
   * Remove `billing_thresholds`, `collection_method`, `default_payment_method`, `default_source` and `invoice_settings` from `SubscriptionSchedule
   * Add `charge` filter when listing `Dispute`
 
-## 14.5.0 - 2019-11-04
+## <a id="14-5-0"></a>14.5.0 - 2019-11-04
 * [#881](https://github.com/stripe/stripe-java/pull/881) Add support for `use_stripe_sdk` on `PaymentIntent` creation and confirmation
 
-## 14.4.1 - 2019-10-30
+## <a id="14-4-1"></a>14.4.1 - 2019-10-30
 * [#877](https://github.com/stripe/stripe-java/pull/877) Fix docstring for a parameter to reflect the correct behaviour
 
-## 14.4.0 - 2019-10-30
-* [#876](https://github.com/stripe/stripe-java/pull/876) Add support for `invoice_customer_balance_settings` on `Invoice`
+## <a id="14-4-0"></a>14.4.0 - 2019-10-30
 * [#873](https://github.com/stripe/stripe-java/pull/873) Suppress unchecked cast warnings in test
+* [#876](https://github.com/stripe/stripe-java/pull/876) Add support for `invoice_customer_balance_settings` on `Invoice`
 
-## 14.3.0 - 2019-10-25
+## <a id="14-3-0"></a>14.3.0 - 2019-10-25
 * [#871](https://github.com/stripe/stripe-java/pull/871) Codegen for openapi d8f9ddf
   * Remove `max_amount` from Issuing `Card`. This is technically a breaking change but only one integration was using this feature which changed a while ago
 
-## 14.2.0 - 2019-10-24
-* [#868](https://github.com/stripe/stripe-java/pull/868)
-  * Add support for typed parameters in `Event.retrieve` method
+## <a id="14-2-0"></a>14.2.0 - 2019-10-24
 * [#867](https://github.com/stripe/stripe-java/pull/867) Contributor Convenant
+* [#868](https://github.com/stripe/stripe-java/pull/868) Update generated code
+  * Add support for typed parameters in `Event.retrieve` method
 
-## 14.1.0 - 2019-10-23
+## <a id="14-1-0"></a>14.1.0 - 2019-10-23
 * [#866](https://github.com/stripe/stripe-java/pull/866) Various API changes
   * Add support for `mx_rfc` on `TaxId`
   * Add support for `pending_invoice_item_interval` on  `Subscription` creation and update
@@ -3463,13 +3457,13 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * Add support for `installments` which is a feature on `PaymentIntent` and `PaymentMethod` available on MX Stripe accounts. It's also added inside `payment_method_details[card]` on `Charge`
   * Add support for `next_pending_invoice_item_invoice` as a new `Capability`
 
-## 14.0.1 - 2019-10-18
-* [#864](https://github.com/stripe/stripe-java/pull/864)
+## <a id="14-0-1"></a>14.0.1 - 2019-10-18
+* [#864](https://github.com/stripe/stripe-java/pull/864) Update generated code
   * Remove `renewal_behavior` on Subscription Schedule model class
   * Remove `renewal_interval` on Subscription Schedule parameter classes
   * The above are technically breaking changes and should have been released with 14.0.0.
 
-## 14.0.0 - 2019-10-18
+## <a id="14-0-0"></a>14.0.0 - 2019-10-18
 * [#863](https://github.com/stripe/stripe-java/pull/863) Upgrade to new API version [`2019-10-17`](https://docs.stripe.com/changelog/2019-10-17)
   * Pin to API version `2019-10-17`
   * Remove `account_balance` from Customer model and parameter classes
@@ -3478,7 +3472,8 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * Remove `renewal_behavior` from Subscription Schedule parameter classes
   * **Note:** This release was missing some breaking changes. Please use 14.0.1 instead.
 
-## 13.3.0 - 2019-10-17
+## <a id="13-3-0"></a>13.3.0 - 2019-10-17
+* [#858](https://github.com/stripe/stripe-java/pull/858) Stop propagating UnsupportedEncodingException
 * [#862](https://github.com/stripe/stripe-java/pull/862) [codegen] Update API Resources
   * `requirements` on Issuing `Cardholder`
   * `payment_method_details[au_becs_debit][mandate]` on `Charge`
@@ -3486,33 +3481,24 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * `payment_behavior` on `Subscription` creation can now take the value `pending_if_incomplete`.
   * `payment_behavior` on `SubscriptionItem` creation and update is now supported.
   * `subscription_data[trial_from_plan]` is now supported on Checkout `Session` creation.
-* [#858](https://github.com/stripe/stripe-java/pull/858) Stop propagating UnsupportedEncodingException
 
-## 13.2.0 - 2019-10-16
+## <a id="13-2-0"></a>13.2.0 - 2019-10-16
 * [#861](https://github.com/stripe/stripe-java/pull/861) Add getters to parameters classes
 
-## 13.1.0 - 2019-10-09
-* [#854](https://github.com/stripe/stripe-java/pull/854)
+## <a id="13-1-0"></a>13.1.0 - 2019-10-09
+* [#854](https://github.com/stripe/stripe-java/pull/854) Update generated code
   * Add support for `description`, `iin` and `issuer` on `Source.Card`, `Source.CardPresent` and `Source.ThreeDSecure`
   * Add support for `deviceType` on `ReaderListParams`
 
-## 13.0.0 - 2019-10-08
+## <a id="13-0-0"></a>13.0.0 - 2019-10-08
 * [#853](https://github.com/stripe/stripe-java/pull/853) Upgrade to new API version [`2019-10-08`](https://docs.stripe.com/changelog/2019-10-08)
 
-## 12.2.0 - 2019-10-08
-* [#852](https://github.com/stripe/stripe-java/pull/852) Setters for string properties in update params now all accept `EmptyParam`
-* [#835](https://github.com/stripe/stripe-java/pull/835) Bump dependencies
+## <a id="12-2-0"></a>12.2.0 - 2019-10-08
 * [#851](https://github.com/stripe/stripe-java/pull/851) Update `README.md`
+* [#835](https://github.com/stripe/stripe-java/pull/835) Bump dependencies
+* [#852](https://github.com/stripe/stripe-java/pull/852) Setters for string properties in update params now all accept `EmptyParam`
 
-## 12.1.0 - 2019-09-27
-* [#850](https://github.com/stripe/stripe-java/pull/850) Codegen for openapi 4d4a107
-  * Add support for `mandate` on `Charge`.
-  * Add support for `reference` on `SourceTransaction`.
-  * Add support for `person` on `TokenCreateParams`.
-  * Add support for new event types `payment_intent.canceled` and `setup_intent.canceled`
-  * Add support for `metadata` on `AuthorizationApproveParams` and `AuthorizationDeclineParams`
-  * Add `setMetadata` method on `AuthorizationUpdateParams`
-  * Rename `chidrens_and_infants_wear_stores` to `childrens_and_infants_wear_stores`. This is technically a breaking change, but we've chosen to release this as a minor version as the previous name was virtually unused.
+## <a id="12-1-0"></a>12.1.0 - 2019-09-27
 * [#849](https://github.com/stripe/stripe-java/pull/849) Add add/addAll support for "emptyable" params
   * Add `addAttribute` and `addAllAttribute` methods to `ProductUpdateParams`
   * Add `addCustomField` and `addAllCustomField` methods to `CustomerCreateParams`, `CustomerUpdateParams`, `InvoiceCreateParams` and `InvoiceUpdateParams`
@@ -3521,142 +3507,150 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * Add `addItem` and `addAllItem` methods to `OrderReturnOrderParams`
   * Add `addSubscriptionDefaultTaxRate` and `addAllSubscriptionDefaultTaxRate` methods to `InvoiceUpcomingParams`
   * Add `addTaxRate` and `addAllTaxRate` methods to `InvoiceItemUpdateParams`, `InvoiceUpcomingParams`, `SubscriptionCreateParams`, `SubscriptionItemCreateParams`, `SubscriptionItemUpdateParams`, `SubscriptionScheduleCreateParams`, `SubscriptionScheduleUpdateParams` and `SubscriptionUpdateParams`
+* [#850](https://github.com/stripe/stripe-java/pull/850) Codegen for openapi 4d4a107
+  * Add support for `mandate` on `Charge`.
+  * Add support for `reference` on `SourceTransaction`.
+  * Add support for `person` on `TokenCreateParams`.
+  * Add support for new event types `payment_intent.canceled` and `setup_intent.canceled`
+  * Add support for `metadata` on `AuthorizationApproveParams` and `AuthorizationDeclineParams`
+  * Add `setMetadata` method on `AuthorizationUpdateParams`
+  * Rename `chidrens_and_infants_wear_stores` to `childrens_and_infants_wear_stores`. This is technically a breaking change, but we've chosen to release this as a minor version as the previous name was virtually unused.
 
-## 12.0.0 - 2019-09-10
+## <a id="12-0-0"></a>12.0.0 - 2019-09-10
 * [#844](https://github.com/stripe/stripe-java/pull/844) Update to API version 2019-09-09
 
-## 11.8.0 - 2019-09-09
-* [#842](https://github.com/stripe/stripe-java/pull/842)
+## <a id="11-8-0"></a>11.8.0 - 2019-09-09
+* [#842](https://github.com/stripe/stripe-java/pull/842) Update generated code
   * Add support for `company[verification]` on `Account`
   * Add support for `verification[additional_document]` on `Person`
 
-## 11.7.0 - 2019-09-05
-* [#827](https://github.com/stripe/stripe-java/pull/827) Switch to new "prettier" codegen
-* [#841](https://github.com/stripe/stripe-java/pull/841)
+## <a id="11-7-0"></a>11.7.0 - 2019-09-05
+* [#841](https://github.com/stripe/stripe-java/pull/841) Update generated code
   * Just a trivial comment update
+* [#827](https://github.com/stripe/stripe-java/pull/827) Switch to new "prettier" codegen
 
-## 11.6.1 - 2019-09-03
+## <a id="11-6-1"></a>11.6.1 - 2019-09-03
 * [#839](https://github.com/stripe/stripe-java/pull/839) Deprecate `total_count`
 
-## 11.6.0 - 2019-09-03
+## <a id="11-6-0"></a>11.6.0 - 2019-09-03
 * [#838](https://github.com/stripe/stripe-java/pull/838) Support `authentication` on Issuing `Authorization` and `url` on `MerchantData`
 
-## 11.5.1 - 2019-08-30
+## <a id="11-5-1"></a>11.5.1 - 2019-08-30
 * [#834](https://github.com/stripe/stripe-java/pull/834) Make `stripeError` transient on `StripeException`
 
-## 11.5.0 - 2019-08-28
+## <a id="11-5-0"></a>11.5.0 - 2019-08-28
 * [#833](https://github.com/stripe/stripe-java/pull/833) Add support for `endBehavior` on `SubscriptionSchedule`
 
-## 11.4.0 - 2019-08-28
+## <a id="11-4-0"></a>11.4.0 - 2019-08-28
 * [#830](https://github.com/stripe/stripe-java/pull/830) Add support for `pendingVerification` on `Account`, `Person` and `Capability`
 
-## 11.3.0 - 2019-08-23
-* [#829](https://github.com/stripe/stripe-java/pull/829)
+## <a id="11-3-0"></a>11.3.0 - 2019-08-23
+* [#829](https://github.com/stripe/stripe-java/pull/829) Update generated code
   * Release support for decimal values on Billing resources such as `Plan` or `InvoiceItem`
 
-## 11.2.0 - 2019-08-21
-* [#828](https://github.com/stripe/stripe-java/pull/828)
+## <a id="11-2-0"></a>11.2.0 - 2019-08-21
+* [#828](https://github.com/stripe/stripe-java/pull/828) Update generated code
   * Add support for `schedule` on `Subscription`
   * Add support for `defaultPaymentMethod`, `invoiceSettings`, `collectionMethod` and `billingThresholds` to `SubscriptionSchedule` and its update and create APIs
   * Add support for `mode` and `setupIntent` on Checkout `Session` and its create API
   * Add support for `schedule` and `subscriptionCancelAt` to the `Invoice` Upcoming API
   * Add support for new event types `subscription_schedule.*`
 
-## 11.1.0 - 2019-08-15
+## <a id="11-1-0"></a>11.1.0 - 2019-08-15
 * [#826](https://github.com/stripe/stripe-java/pull/826) Add support for `executive` on `Person` create, update and list
 
-## 11.0.0 - 2019-08-14
+## <a id="11-0-0"></a>11.0.0 - 2019-08-14
 * [#825](https://github.com/stripe/stripe-java/pull/825) Move to API version [`2019-08-14`](https://docs.stripe.com/changelog/2019-08-14)
   * Rename `platform_payments` to `transfers` in `Account`
   * Introduce `executive` as a relationship on `Person`
 
-## 10.15.0 - 2019-08-14
-* [#824](https://github.com/stripe/stripe-java/pull/824)
+## <a id="10-15-0"></a>10.15.0 - 2019-08-14
+* [#824](https://github.com/stripe/stripe-java/pull/824) Update generated code
   * Add support for `au_becs_debit` sources
   * Add support for `mandate` parameter in source creation and update requests
   * Add support for `amount` in source update requests
   * Add support for `pin` attribute on `issuing.card` objects
   * Add support for `digital_goods_applications` category for Issuing
 
-## 10.14.0 - 2019-08-08
-* [#820](https://github.com/stripe/stripe-java/pull/820)
+## <a id="10-14-0"></a>10.14.0 - 2019-08-08
+* [#820](https://github.com/stripe/stripe-java/pull/820) Update generated code
   * Add support for unsetting `receipt_email` on `PaymentIntent`
   * Remove support for `SubscriptionScheduleRevision`. This is technicall a breaking change, but we've chosen to release this as a minor version as this resource and its APIs were virtually unused.
 
-## 10.13.0 - 2019-08-08
-* [#819](https://github.com/stripe/stripe-java/pull/819)
+## <a id="10-13-0"></a>10.13.0 - 2019-08-08
+* [#819](https://github.com/stripe/stripe-java/pull/819) Update generated code
   * Add support for `payment_method_details[card][moto]` on `Charge`
   * Add support for `statement_descriptor_suffix` on `Charge` and `PaymentIntent`
   * Add support `subscription_data[application_fee_percent]` on Checkout `Session`
   * Rename `uk_credit_transfer` to `gbp_credit_transfer` on Source. This is technically a breaking change, but we've chosen to release this as a minor version as the previous name was virtually unused.
 
-## 10.12.2 - 2019-08-07
+## <a id="10-12-2"></a>10.12.2 - 2019-08-07
 * [#818](https://github.com/stripe/stripe-java/pull/818) Set default timeouts in `RequestOptionsBuilder`
 
-## 10.12.1 - 2019-07-30
+## <a id="10-12-1"></a>10.12.1 - 2019-07-30
 * [#812](https://github.com/stripe/stripe-java/pull/812) Fix potential `NullPointerException` when calling `getRawJsonObject()`
 
-## 10.12.0 - 2019-07-22
-* [#809](https://github.com/stripe/stripe-java/pull/809)
+## <a id="10-12-0"></a>10.12.0 - 2019-07-22
+* [#809](https://github.com/stripe/stripe-java/pull/809) Update generated code
   * Add support for `statement_descriptor` on `PaymentIntent` capture
   * Add support for unsetting `setup_future_usage` on `PaymentIntent`
 
-## 10.11.0 - 2019-07-19
-* [#808](https://github.com/stripe/stripe-java/pull/999)
+## <a id="10-11-0"></a>10.11.0 - 2019-07-19
+* [#999](https://github.com/stripe/stripe-java/pull/999) Update generated code
   * Add `off_session` to `SubscriptionItem` update
   * Add `customer` when listing `CreditNote`
   * Remove `challenge_only` enum value. This is technically a breaking change, but we've chosen to release this as a minor version in light of the fact that this value was virtually unused.
 
-## 10.10.0 - 2019-07-17
+## <a id="10-10-0"></a>10.10.0 - 2019-07-17
 * [#806](https://github.com/stripe/stripe-java/pull/806) Add support for `voided_at` on `CreditNote`
 
-## 10.9.1 - 2019-07-16
+## <a id="10-9-1"></a>10.9.1 - 2019-07-16
 * [#804](https://github.com/stripe/stripe-java/pull/804) Add support for unsetting metadata keys
 * [#805](https://github.com/stripe/stripe-java/pull/805) Bump dependencies
 
-## 10.9.0 - 2019-07-15
+## <a id="10-9-0"></a>10.9.0 - 2019-07-15
 * [#802](https://github.com/stripe/stripe-java/pull/802) Add support for `payment_method_options` on `PaymentIntent` and `SetupIntent`
 
-## 10.8.0 - 2019-07-15
-* [#801](https://github.com/stripe/stripe-java/pull/801)
+## <a id="10-8-0"></a>10.8.0 - 2019-07-15
+* [#801](https://github.com/stripe/stripe-java/pull/801) Update generated code
   * Add support for `pending_setup_intent` on Subscription
   * Add support for `off_session` on Subscription creation and update and Invoice pay
 
-## 10.7.0 - 2019-07-15
-* [#800](https://github.com/stripe/stripe-java/pull/800)
+## <a id="10-7-0"></a>10.7.0 - 2019-07-15
+* [#800](https://github.com/stripe/stripe-java/pull/800) Update generated code
   * Add support for Sources of type `klarna`
   * Add support for `payment_behavior` on Subscription and SubscriptionItem to control their behaviour on creation or update.
 
-## 10.6.0 - 2019-07-12
+## <a id="10-6-0"></a>10.6.0 - 2019-07-12
 * [#799](https://github.com/stripe/stripe-java/pull/799) Add `getRawJsonObject()` accessor
 
-## 10.5.0 - 2019-07-09
-* [#798](https://github.com/stripe/stripe-java/pull/798)
+## <a id="10-5-0"></a>10.5.0 - 2019-07-09
+* [#798](https://github.com/stripe/stripe-java/pull/798) Update generated code
   * Add support for `transfer_data[amount]` on PaymentIntent
   * Add support for passing `setup_future_usage` on PaymentIntent Update and Confirm APIs
   * Add support for `confirm` and `return_url` on SetupIntent creation
   * Add support for `setup_future_usage` on Checkout Session creation
   * Add support for `subscription_start_date` on the Upcoming Invoice API
 
-## 10.4.0 - 2019-07-01
-* [#796](https://github.com/stripe/stripe-java/pull/796)
+## <a id="10-4-0"></a>10.4.0 - 2019-07-01
+* [#796](https://github.com/stripe/stripe-java/pull/796) Update generated code
   * Add support for the `SetupIntent` resource and APIs
   * Add support for `PlatformTaxFee` resource
   * Add `unified_proration` on `InvoiceItem` and `InvoiceLineItem`
   * Add `default_payment_method` and `default_source` to `SubscriptionSchedule`
 
-## 10.3.0 - 2019-06-24
+## <a id="10-3-0"></a>10.3.0 - 2019-06-24
 * [#792](https://github.com/stripe/stripe-java/pull/792) Enable request latency telemetry by default
 
-## 10.2.0 - 2019-06-24
-* [#794](https://github.com/stripe/stripe-java/pull/794)
+## <a id="10-2-0"></a>10.2.0 - 2019-06-24
+* [#794](https://github.com/stripe/stripe-java/pull/794) Update generated code
   * Add `collection_method` to `Invoice`, `Subscription` and `SubscriptionSchedule`
   * Add `unified_propration` to `InvoiceLineItem`
   * Support unsetting `dob` on an `Account`
   * Removed `native_url` from WeChat `Source`. While technically breaking, this field has never been used
 
-## 10.1.0 - 2019-06-18
-* [#789](https://github.com/stripe/stripe-java/pull/789)
+## <a id="10-1-0"></a>10.1.0 - 2019-06-18
+* [#789](https://github.com/stripe/stripe-java/pull/789) Update generated code
   * Add support for SEPA Credit Transfer sources
   * Add support for `CustomerBalanceTransaction` resource and APIs
   * Add `balance` property on `Customer`
@@ -3664,278 +3658,275 @@ Pull requests included in this release (cf. [#869](https://github.com/stripe/str
   * Add `merchantAmount` and `merchantCurrency` properties on `issuing.Transaction`
   * Add `location` property on `terminal.ConnectionToken`
 
-## 10.0.2 - 2019-05-29
+## <a id="10-0-2"></a>10.0.2 - 2019-05-29
 * [#784](https://github.com/stripe/stripe-java/pull/784) Make headers access case insensitive
 
-## 10.0.1 - 2019-05-28
+## <a id="10-0-1"></a>10.0.1 - 2019-05-28
 * [#783](https://github.com/stripe/stripe-java/pull/783) Fix url-encoding for string id to throw exception on passing null
 
-## 10.0.0 - 2019-05-24
+## <a id="10-0-0"></a>10.0.0 - 2019-05-24
 * [#781](https://github.com/stripe/stripe-java/pull/781) Pin library to API version `2019-05-16`
 
-## 9.13.0 - 2019-05-23
-* [#780](https://github.com/stripe/stripe-java/pull/780)
+## <a id="9-13-0"></a>9.13.0 - 2019-05-23
+* [#780](https://github.com/stripe/stripe-java/pull/780) Update generated code
   * Add support for new `radar.early_fraud_warning` resource and methods
   * Add new in_gst and no_vat tax ID types
   * Add `spending_limits_currency` attribute and parameter in Issuing resources
 
-## 9.12.0 - 2019-05-14
-* [#777](https://github.com/stripe/stripe-java/pull/777)
+## <a id="9-12-0"></a>9.12.0 - 2019-05-14
+* [#777](https://github.com/stripe/stripe-java/pull/777) Update generated code
   * Add support for `Capability`
   * Add enum `off_session` for `PaymentIntentConfirmParams` and `PaymentIntentCreateParams`
   * Add enum `abandoned` for `PaymentIntentCancellationParams`.
   * Add support for `statementDescriptorKana` and `statementDescriptorKanji` in `Account.SettingsPayments`
 
-## 9.11.0 - 2019-05-10
-* [#776](https://github.com/stripe/stripe-java/pull/776)
+## <a id="9-11-0"></a>9.11.0 - 2019-05-10
+* [#776](https://github.com/stripe/stripe-java/pull/776) Update generated code
   * Add support for `startDate` in `Subscription`
   * Removed one unsupported enum on `PaymentIntentCancelParams`
 
-
-## 9.10.0 - 2019-05-06
-* [#773](https://github.com/stripe/stripe-java/pull/773)
+## <a id="9-10-0"></a>9.10.0 - 2019-05-06
+* [#773](https://github.com/stripe/stripe-java/pull/773) Update generated code
   * Add support for `extraParams` in all sub-classes of ApiRequestParams their nested classes
   * Add support for webhook event `payment_method.updated`
   * Add support for `payment_intent` filter when listing `Charge`
   * Add support for `legacy_payments` enum `RequestedCapability` in `AccountCreateParams` and `AccountUpdateParams`
 
-## 9.9.0 - 2019-05-03
-* [#768](https://github.com/stripe/stripe-java/pull/768)
+## <a id="9-9-0"></a>9.9.0 - 2019-05-03
+* [#768](https://github.com/stripe/stripe-java/pull/768) Update generated code
   * Add support for `customer` filter when listing `PaymentIntent`
   * Add support for `replacement_for` and `replacement_reason` on Issuing `card` creation
 
-## 9.8.0 - 2019-04-29
+## <a id="9-8-0"></a>9.8.0 - 2019-04-29
 * [#766](https://github.com/stripe/stripe-java/pull/766) Add support for ACSS debit Sources
 
-## 9.7.0 - 2019-04-24
+## <a id="9-7-0"></a>9.7.0 - 2019-04-24
 * [#761](https://github.com/stripe/stripe-java/pull/761) Add support for `TaxRate` resource and APIs
 
-## 9.6.0 - 2019-04-24
-* [#756](https://github.com/stripe/stripe-java/pull/756) Fix form-encoding to support `Collection` in untyped params as array. Previously only `List` is form-encoded as array.
+## <a id="9-6-0"></a>9.6.0 - 2019-04-24
 * [#755](https://github.com/stripe/stripe-java/pull/755) Add support for `CARD_ISSUING` enum in `RequestedCapability` for Account create/update params.
+* [#756](https://github.com/stripe/stripe-java/pull/756) Fix form-encoding to support `Collection` in untyped params as array. Previously only `List` is form-encoded as array.
 
-## 9.5.0 - 2019-04-22
+## <a id="9-5-0"></a>9.5.0 - 2019-04-22
 * [#750](https://github.com/stripe/stripe-java/pull/750) Add support for the `TaxId` resource and APIs
 
-## 9.4.0 - 2019-04-18
-* [#748](https://github.com/stripe/stripe-java/pull/748)
+## <a id="9-4-0"></a>9.4.0 - 2019-04-18
+* [#748](https://github.com/stripe/stripe-java/pull/748) Update generated code
   * Add support for `address`, `name`, `phone` and `preferredLocales` on `Customer`
   * Add support for the `CreditNote` resource and APIs
   * Add support for account and customer related fields on the `Invoice` resource
 
-## 9.3.0 - 2019-04-16
+## <a id="9-3-0"></a>9.3.0 - 2019-04-16
 * [#745](https://github.com/stripe/stripe-java/pull/745) Add support for the Checkout `Session` resource and APIs
 
-## 9.2.0 - 2019-04-15
-* [#744](https://github.com/stripe/stripe-java/pull/744)
+## <a id="9-2-0"></a>9.2.0 - 2019-04-15
+* [#744](https://github.com/stripe/stripe-java/pull/744) Update generated code
   * Make `paymentIntent` on `Invoice` expandable instead of full-model
   * Add support for issuing `SpendingLimit` in `Card` and `CardHolder`
   * Add support for fields in `PaymentMethodDetails.Card.ThreeDSecure`
 
-## 9.1.0 - 2019-04-11
-* [#737](https://github.com/stripe/stripe-java/pull/737) Fix issue #736 on un-encoded ID in url path
-* [#739](https://github.com/stripe/stripe-java/pull/739) Add support for `ConfirmationMethod` in `PaymentIntentCreateParams`, `AuthorizationControls` in cardholders mode/params
+## <a id="9-1-0"></a>9.1.0 - 2019-04-11
 * [#735](https://github.com/stripe/stripe-java/pull/735) Fix encoding of nested parameters in multipart requests
 * [#734](https://github.com/stripe/stripe-java/pull/734) Upgrade Gradle to 5.3.1
+* [#739](https://github.com/stripe/stripe-java/pull/739) Add support for `ConfirmationMethod` in `PaymentIntentCreateParams`, `AuthorizationControls` in cardholders mode/params
+* [#737](https://github.com/stripe/stripe-java/pull/737) Fix issue #736 on un-encoded ID in url path
 
-## 9.0.0 - 2019-04-09
-* [#700](https://github.com/stripe/stripe-java/pull/700) Major version release. Refer to our [migration guide for v9](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v9) for a list of backward incompatible changes to watch out for.
-Pull requests included in this release:
+## <a id="9-0-0"></a>9.0.0 - 2019-04-09
+* [#702](https://github.com/stripe/stripe-java/pull/702) Dev dependency version upgrades
+* [#706](https://github.com/stripe/stripe-java/pull/706) Dev dependency version upgrades (Junit 5)
 * [#698](https://github.com/stripe/stripe-java/pull/698) Drop support for Java 1.7
-* [#723](https://github.com/stripe/stripe-java/pull/723) Use `Optional` for unsafe event data object deserialization
 * [#705](https://github.com/stripe/stripe-java/pull/705) Add support for typed parameters, change deserialization of array in `Event#previousAttributes` from `Object[]` to `List<Object>`
-* [#729](https://github.com/stripe/stripe-java/pull/729) Add missing Javadoc for non-autogenerated classes (`EphemeralKey`, `Event` and `File`)
+* [#723](https://github.com/stripe/stripe-java/pull/723) Use `Optional` for unsafe event data object deserialization
+* [#713](https://github.com/stripe/stripe-java/pull/713) Use ErrorProne in builds
 * [#730](https://github.com/stripe/stripe-java/pull/730) Add support for typed parameters for non-autogenerated classes (`EphemeralKey`, `Event` and `File`)
-* [#702](https://github.com/stripe/stripe-java/pull/702) Dev dependency version upgrades
-* [#706](https://github.com/stripe/stripe-java/pull/706) Dev dependency version upgrades (Junit 5)
+* [#700](https://github.com/stripe/stripe-java/pull/700) Major version release. Refer to our [migration guide for v9](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v9) for a list of backward incompatible changes to watch out for.
+  Pull requests included in this release:
+* [#729](https://github.com/stripe/stripe-java/pull/729) Add missing Javadoc for non-autogenerated classes (`EphemeralKey`, `Event` and `File`)
 * [#728](https://github.com/stripe/stripe-java/pull/728) Dev dependency version upgrades
-* [#713](https://github.com/stripe/stripe-java/pull/713) Use ErrorProne in builds
 
-## 8.1.0 - 2019-03-25
+## <a id="8-1-0"></a>8.1.0 - 2019-03-25
 * [#710](https://github.com/stripe/stripe-java/pull/710) Add support for `PaymentMethod.BillingDetails` on `Charge`.
 * [#708](https://github.com/stripe/stripe-java/pull/708) Fix issues reported by `ErrorProne` Nothing major or user visible.
 
-## 8.0.2 - 2019-03-20
+## <a id="8-0-2"></a>8.0.2 - 2019-03-20
 * [#704](https://github.com/stripe/stripe-java/pull/704) Fix test compiler error by removing an accidental line
 
-## 8.0.1 - 2019-03-20
+## <a id="8-0-1"></a>8.0.1 - 2019-03-20
 * [#701](https://github.com/stripe/stripe-java/pull/701) Fix java doc on deprecated `EventData#getObject` and `Event#getDataObjectDeserializer`
 
-## 8.0.0 - 2019-03-19
+## <a id="8-0-0"></a>8.0.0 - 2019-03-19
 * [#662](https://github.com/stripe/stripe-java/pull/662) Major version release. Supports a pinned API version [2019-03-14](https://docs.stripe.com/changelog/2019-03-14). Refer to our [migration guide for v8](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v8) for API upgrade guide and lists of backwards incompatible changes to watch out for.
 
-## 7.63.1 - 2020-17-11
-* Identical to 7.29.0
-
-## 7.63.0 - 2020-17-11
-* Published in error. Do not use. This is identical to 20.27.0.
-
-## 7.29.0 - 2019-03-18
+## <a id="7-29-0"></a>7.29.0 - 2019-03-18
 * [#695](https://github.com/stripe/stripe-java/pull/695) Add support for `payment_intent` on `Charge`.
 
-## 7.28.0 - 2019-03-18
-* [#688](https://github.com/stripe/stripe-python/pull/688) Add support for the `PaymentMethod` resource and APIs
-* [#691](https://github.com/stripe/stripe-python/pull/691) Add support for deleting a Terminal `Location` and `Reader`
+## <a id="7-28-0"></a>7.28.0 - 2019-03-18
+* [#691](https://github.com/stripe/stripe-java/pull/691) Add support for deleting a Terminal `Location` and `Reader`
+* [#688](https://github.com/stripe/stripe-java/pull/688) Add support for the `PaymentMethod` resource and APIs
 
-## 7.27.0 - 2019-03-13
+## <a id="7-27-0"></a>7.27.0 - 2019-03-13
 * [#689](https://github.com/stripe/stripe-java/pull/689) Add support for `columns` on `ReportRun` and `default_columns` on `ReportType`.
 
-## 7.26.0 - 2019-03-06
+## <a id="7-26-0"></a>7.26.0 - 2019-03-06
 * [#686](https://github.com/stripe/stripe-java/pull/686) Add support for `cancel_at` on `Subscription`.
 
-## 7.25.0 - 2019-02-28
-* [#684](https://github.com/stripe/stripe-java/pull/684) Add support for `latest_invoice` on `Subscription`.
+## <a id="7-25-0"></a>7.25.0 - 2019-02-28
 * [#685](https://github.com/stripe/stripe-java/pull/685) Add `api_version` to the `WebhookEndpoint` resource.
+* [#684](https://github.com/stripe/stripe-java/pull/684) Add support for `latest_invoice` on `Subscription`.
 
-## 7.24.0 - 2019-02-22
+## <a id="7-24-0"></a>7.24.0 - 2019-02-22
 * [#681](https://github.com/stripe/stripe-java/pull/681) Add support for `status_transitions` and marked `date` as deprecated on `Invoice`.
 
-## 7.23.0 - 2019-02-19
+## <a id="7-23-0"></a>7.23.0 - 2019-02-19
 * [#660](https://github.com/stripe/stripe-java/pull/660) Add support for API version `2019-02-19` and related changes to `Account` and `Person`.
 
-## 7.22.0 - 2019-02-16
+## <a id="7-22-0"></a>7.22.0 - 2019-02-16
 * [#678](https://github.com/stripe/stripe-java/pull/678) Add `StripeException.getStripeError()` and `OAuthException.getOauthError()` accessors
 
-## 7.21.0 - 2019-02-12
+## <a id="7-21-0"></a>7.21.0 - 2019-02-12
 * [#648](https://github.com/stripe/stripe-java/pull/648) Add support for `transfer_data[destination]` on `Invoice` and `Subscription`.
 
-## 7.20.0 - 2019-02-12
+## <a id="7-20-0"></a>7.20.0 - 2019-02-12
 * [#670](https://github.com/stripe/stripe-java/pull/670) Add support for API version `2019-02-11` with changes to Payment Intents
   * `PaymentIntentSourceAction`, `PaymentIntentSourceActionValueAuthorizeWithUrl` and `next_source_action` are now depreacated. Use `PaymentIntent.NextAction`, `PaymentIntent.NextActionRedirectToUrl` and `next_action` instead.
   * `allowed_source_types` is now depreacated. Use `payment_method_types` instead.
 * [#673](https://github.com/stripe/stripe-java/pull/673) Add support for `SubscriptionSchedule` and `SubscriptionScheduleRevision`. Also add support for `invoice_settings` on `Customer`.
-* [#675](https://github.com/stripe/stripe-java/pull/675) The `customer` property is now expandable on `Invoice`.
 * [#677](https://github.com/stripe/stripe-java/pull/677) Add support for `transfer_data[amount]` on `Charge`.
+* [#675](https://github.com/stripe/stripe-java/pull/675) The `customer` property is now expandable on `Invoice`.
 
-## 7.19.0 - 2019-02-06
+## <a id="7-19-0"></a>7.19.0 - 2019-02-06
 * [#661](https://github.com/stripe/stripe-java/pull/661) Add configurable telemetry to gather information on client-side request latency
 
-## 7.18.1 - 2019-02-04
+## <a id="7-18-1"></a>7.18.1 - 2019-02-04
 * [#657](https://github.com/stripe/stripe-java/pull/657) Better handling of namespaced resources
 * [#665](https://github.com/stripe/stripe-java/pull/665) Configure Gradle signing plugin to use gpg-agent
 
-## 7.18.0 - 2019-01-25
+## <a id="7-18-0"></a>7.18.0 - 2019-01-25
 * [#649](https://github.com/stripe/stripe-java/pull/649) Add support for `destination_payment_refund` and `source_refund` on the `Reversal` resource.
 
-## 7.17.0 - 2019-01-17
+## <a id="7-17-0"></a>7.17.0 - 2019-01-17
 * [#656](https://github.com/stripe/stripe-java/pull/656) Added `receipt_url` property to `Charge`.
 
-## 7.16.0 - 2019-01-17
-* [#653](https://github.com/stripe/stripe-java/pull/653) Add support for `custom_fields` and `footer` on `Invoice`.
+## <a id="7-16-0"></a>7.16.0 - 2019-01-17
 * [#655](https://github.com/stripe/stripe-java/pull/655) Add support for billing thresholds.
+* [#653](https://github.com/stripe/stripe-java/pull/653) Add support for `custom_fields` and `footer` on `Invoice`.
 
-## 7.15.0 - 2019-01-14
+## <a id="7-15-0"></a>7.15.0 - 2019-01-14
 * [#652](https://github.com/stripe/stripe-java/pull/652) Add support for expandable `transfer_data[destination]` on `Charge` and `PaymentIntent`.
 
-## 7.14.0 - 2019-01-11
-* [#632](https://github.com/stripe/stripe-java/pull/632) Add support for `transfer_data` and `application_fee_amount` on `Charge` and `transfer_data[destination] on `PaymentIntent`.
+## <a id="7-14-0"></a>7.14.0 - 2019-01-11
 * [#647](https://github.com/stripe/stripe-java/pull/647) Add support for deserializing `IssuerFraudRecord` in events.
+* [#632](https://github.com/stripe/stripe-java/pull/632) Add support for `transfer_data` and `application_fee_amount` on `Charge` and `transfer_data[destination] on `PaymentIntent`.
 
-## 7.13.0 - 2019-01-09
+## <a id="7-13-0"></a>7.13.0 - 2019-01-09
 * [#626](https://github.com/stripe/stripe-java/pull/626) Add support for the `AccountLink` APIs.
 
-## 7.12.0 - 2019-01-08
+## <a id="7-12-0"></a>7.12.0 - 2019-01-08
 * [#634](https://github.com/stripe/stripe-java/pull/634) Add support for `wallet_provider` on `Issuing.Authorization`.
 
-## 7.11.0 - 2018-12-27
+## <a id="7-11-0"></a>7.11.0 - 2018-12-27
 * [#629](https://github.com/stripe/stripe-java/pull/629) Add support for `actionable` and `has_liability_shift` on `IssuerFraudRecord`
 
-## 7.10.0 - 2018-11-28
+## <a id="7-10-0"></a>7.10.0 - 2018-11-28
 * [#621](https://github.com/stripe/stripe-java/pull/621) Add missing properties on the `Refund` resource.
 * [#623](https://github.com/stripe/stripe-java/pull/623) Add support for the `Review` APIs.
 
-## 7.9.0 - 2018-11-27
+## <a id="7-9-0"></a>7.9.0 - 2018-11-27
 * [#614](https://github.com/stripe/stripe-java/pull/614) Add support for `ValueList` and `ValueListItem` for Radar
 
-## 7.8.0 - 2018-11-19
+## <a id="7-8-0"></a>7.8.0 - 2018-11-19
 * [#616](https://github.com/stripe/stripe-java/pull/616) Add missing properties to a few resources:
   * Add `default_source` to `Invoice` and `Subscription`
   * Add `livemode` to Subscription
   * Add `metadata` and `subscription` to `SubscriptionItem`
 
-## 7.7.0 - 2018-11-14
+## <a id="7-7-0"></a>7.7.0 - 2018-11-14
 * [#615](https://github.com/stripe/stripe-java/pull/615) Add `last_payment_error` to `PaymentIntent`.
 
-## 7.6.0 - 2018-11-09
+## <a id="7-6-0"></a>7.6.0 - 2018-11-09
 * [#613](https://github.com/stripe/stripe-java/pull/613) Throw `ApiException` on malformed JSON responses
-    - Previously, the library would throw `com.google.gson.JsonSyntaxException` in this case. We've chosen to release this as a minor update because we assume that most users are already catching Stripe exceptions.
+  - Previously, the library would throw `com.google.gson.JsonSyntaxException` in this case. We've chosen to release this as a minor update because we assume that most users are already catching Stripe exceptions.
 
-## 7.5.0 - 2018-11-08
+## <a id="7-5-0"></a>7.5.0 - 2018-11-08
 * [#604](https://github.com/stripe/stripe-java/pull/604) Add new API endpoints for the `Invoice` resource.
 
-## 7.4.0 - 2018-11-08
+## <a id="7-4-0"></a>7.4.0 - 2018-11-08
 * [#609](https://github.com/stripe/stripe-java/pull/609) Support new shape of the `PaymentIntent` resource.
 
-## 7.3.0 - 2018-11-07
+## <a id="7-3-0"></a>7.3.0 - 2018-11-07
 * [#610](https://github.com/stripe/stripe-java/pull/610) Add `flatAmount` to `Plan.Tier`
-* [#611](https://github.com/stripe/stripe-java/pull/611) Add `supportedTransferCountries` to `CountrySpec`
 * [#611](https://github.com/stripe/stripe-java/pull/611) Add `supportAddress` to `Account`
+* [#611](https://github.com/stripe/stripe-java/pull/611) Add `supportedTransferCountries` to `CountrySpec`
+
+## <a id="4-11-0"></a>4.11.0 - 2018-11-07
 
-## 7.2.0 - 2018-10-31
+## <a id="7-2-0"></a>7.2.0 - 2018-10-31
 * [#603](https://github.com/stripe/stripe-java/pull/603) Add support for the `Person` resource
 * [#606](https://github.com/stripe/stripe-java/pull/606) Add support for the `WebhookEndpoint` resource
 
-## 7.1.0 - 2018-10-10
+## <a id="7-1-0"></a>7.1.0 - 2018-10-10
 * [#602](https://github.com/stripe/stripe-java/pull/602) Adds support for `partnerId` in `setAppInfo()`
 
-## 7.0.0 - 2018-09-24
+## <a id="7-0-0"></a>7.0.0 - 2018-09-24
 Major version release. Refer to our [migration guide for v7](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v7) for a list of backwards incompatible changes to watch out for.
 
 Pull requests included in this release:
+
 * [#598](https://github.com/stripe/stripe-java/pull/598) Compatibility with latest API version
 * [#593](https://github.com/stripe/stripe-java/pull/593) Replace `FileUpload` class with `File` class
 * [#592](https://github.com/stripe/stripe-java/pull/592) Support for terminal endpoints
 
-## 6.12.0 - 2018-09-06
+## <a id="6-12-0"></a>6.12.0 - 2018-09-06
 * [#586](https://github.com/stripe/stripe-java/pull/586) Add `invoicePrefix` to `Customer`
 
-## 6.11.0 - 2018-09-05
+## <a id="6-11-0"></a>6.11.0 - 2018-09-05
 * [#584](https://github.com/stripe/stripe-java/pull/584) Add support for reporting resources
 
-## 6.10.0 - 2018-09-05
+## <a id="6-10-0"></a>6.10.0 - 2018-09-05
 * [#583](https://github.com/stripe/stripe-java/pull/583) Add `exchangeRate` to `BalanceTransaction`
 
-## 6.9.0 - 2018-08-29
+## <a id="6-9-0"></a>6.9.0 - 2018-08-29
 * [#580](https://github.com/stripe/stripe-java/pull/580) Add missing attributes to `Account` and `LegalEntity`
 * [#581](https://github.com/stripe/stripe-java/pull/581) Add `Topup.cancel()` overload with no arguments
 
-## 6.8.0 - 2018-08-28
-* [#577](https://github.com/stripe/stripe-java/pull/577) Update `Customer` and `Plan` models for API version [2018-08-23](https://docs.stripe.com/changelog/2018-08-23)
+## <a id="6-8-0"></a>6.8.0 - 2018-08-28
 * [#579](https://github.com/stripe/stripe-java/pull/579) Add `authorizationCode` to `Charge`
+* [#577](https://github.com/stripe/stripe-java/pull/577) Update `Customer` and `Plan` models for API version [2018-08-23](https://docs.stripe.com/changelog/2018-08-23)
 
-## 6.7.0 - 2018-08-27
+## <a id="6-7-0"></a>6.7.0 - 2018-08-27
 * [#575](https://github.com/stripe/stripe-java/pull/575) Remove support for `BitcoinReceiver` write-actions
 
-## 6.6.0 - 2018-08-23
+## <a id="6-6-0"></a>6.6.0 - 2018-08-23
 * [#576](https://github.com/stripe/stripe-java/pull/576) Add support for usage record summaries
 
-## 6.5.0 - 2018-08-16
+## <a id="6-5-0"></a>6.5.0 - 2018-08-16
 * [#574](https://github.com/stripe/stripe-java/pull/574) Add `unitLabel` to `Product`
 
-## 6.4.0 - 2018-08-14
+## <a id="6-4-0"></a>6.4.0 - 2018-08-14
 * [#572](https://github.com/stripe/stripe-java/pull/572) Serialize all arrays/lists with integer-indexed encoding
 
-## 6.3.0 - 2018-08-03
+## <a id="6-3-0"></a>6.3.0 - 2018-08-03
 * [#568](https://github.com/stripe/stripe-java/pull/568) Add cancel support for topups
 * [#569](https://github.com/stripe/stripe-java/pull/569) Add support for file links
 
-## 6.2.1 - 2018-08-02
+## <a id="6-2-1"></a>6.2.1 - 2018-08-02
 * [#567](https://github.com/stripe/stripe-java/pull/567) Use delomboked sources when creating sources JAR
 
-## 6.2.0 - 2018-08-01
-* [#565](https://github.com/stripe/stripe-java/pull/565) Add a `retrieve()` method that accepts parameters (e.g. for expansion) to all resource classes
+## <a id="6-2-0"></a>6.2.0 - 2018-08-01
 * [#566](https://github.com/stripe/stripe-java/pull/566) Add `object` attribute and accessors to `StripeCollection`
+* [#565](https://github.com/stripe/stripe-java/pull/565) Add a `retrieve()` method that accepts parameters (e.g. for expansion) to all resource classes
 
-## 6.1.0 - 2018-07-30
+## <a id="6-1-0"></a>6.1.0 - 2018-07-30
 * [#561](https://github.com/stripe/stripe-java/pull/561) Add `created` to `Account`
 
-## 6.0.0 - 2018-07-30
+## <a id="6-0-0"></a>6.0.0 - 2018-07-30
 Major version release. Refer to our [migration guide for v6](https://github.com/stripe/stripe-java/wiki/Migration-guide-for-v6) for a list of backwards incompatible changes to watch out for.
 
 Pull requests included in this release:
+
 * [#532](https://github.com/stripe/stripe-java/pull/532) Remove deprecated methods
-* [#534](https://github.com/stripe/stripe-java/pull/534) Only capitalize the first letter of acronyms per Google's style rules
 * [#535](https://github.com/stripe/stripe-java/pull/535) Change signatures to throw StripeException
+* [#534](https://github.com/stripe/stripe-java/pull/534) Only capitalize the first letter of acronyms per Google's style rules
 * [#538](https://github.com/stripe/stripe-java/pull/538) Change all integer types to `Long` and all floating point types to `Double`
 * [#540](https://github.com/stripe/stripe-java/pull/540) Add support for idempotency errors
 * [#541](https://github.com/stripe/stripe-java/pull/541) Minor fixes
@@ -3943,672 +3934,706 @@ Pull requests included in this release:
 * [#553](https://github.com/stripe/stripe-java/pull/553) Remove `Deleted*` models and add `deleted` attribute instead
 * [#558](https://github.com/stripe/stripe-java/pull/558) Use `BigDecimal` for floating point values
 
-## 5.53.0 - 2018-07-28
+## <a id="5-53-0"></a>5.53.0 - 2018-07-28
 * [#560](https://github.com/stripe/stripe-java/pull/560) Add support for scheduled query runs (`com.stripe.model.sigma.ScheduledQueryRun`) for Sigma
 
-## 5.52.0 - 2018-07-26
+## <a id="5-52-0"></a>5.52.0 - 2018-07-26
 * [#556](https://github.com/stripe/stripe-java/pull/556) Add `riskScore` property to `ChargeOutcome`
 * [#557](https://github.com/stripe/stripe-java/pull/557) Add support for StripeIssuing
 
-## 5.51.0 - 2018-07-12
+## <a id="5-51-0"></a>5.51.0 - 2018-07-12
 * [#551](https://github.com/stripe/stripe-java/pull/551) Add `autoAdvance` property to `Invoice`
 
-## 5.50.0 - 2018-07-11
+## <a id="5-50-0"></a>5.50.0 - 2018-07-11
 * [#552](https://github.com/stripe/stripe-java/pull/552) Rename `ApplicationFee` to `ApplicationFeeAmount` on `PaymentIntent`
 
-## 5.49.0 - 2018-07-06
+## <a id="5-49-0"></a>5.49.0 - 2018-07-06
 * [#548](https://github.com/stripe/stripe-java/pull/548) Add `subscriptionItem` property to `InvoiceItem` and `InvoiceLineItem`
 
-## 5.48.0 - 2018-07-03
+## <a id="5-48-0"></a>5.48.0 - 2018-07-03
 * [#544](https://github.com/stripe/stripe-java/pull/544) Add support for streams when uploading files
 
-## 5.47.0 - 2018-07-02
+## <a id="5-47-0"></a>5.47.0 - 2018-07-02
 * [#546](https://github.com/stripe/stripe-java/pull/546) Add `setClientId()` to `RequestOptionsBuilder`
 
-## 5.46.0 - 2018-06-29
+## <a id="5-46-0"></a>5.46.0 - 2018-06-29
 * [#543](https://github.com/stripe/stripe-java/pull/543) Add support for payment intents
 
-## 5.45.0 - 2018-06-28
+## <a id="5-45-0"></a>5.45.0 - 2018-06-28
 * [#542](https://github.com/stripe/stripe-java/pull/542) Fix `account.application.*` event data deserialization issue
 
-## 5.44.0 - 2018-06-27
+## <a id="5-44-0"></a>5.44.0 - 2018-06-27
 * [#539](https://github.com/stripe/stripe-java/pull/539) Add `customerReference` and `shippingFromZip` properties on `ChargeLevel3` model
 
-## 5.43.0 - 2018-06-25
+## <a id="5-43-0"></a>5.43.0 - 2018-06-25
 * [#537](https://github.com/stripe/stripe-java/pull/537) Add `level3` property on `Charge` model
 
-## 5.42.0 - 2018-06-19
+## <a id="5-42-0"></a>5.42.0 - 2018-06-19
 * [#529](https://github.com/stripe/stripe-java/pull/529) Annotate a lot of methods as deprecated and flagged for removal in the next major release
 
-## 5.41.1 - 2018-06-17
+## <a id="5-41-1"></a>5.41.1 - 2018-06-17
 * [#528](https://github.com/stripe/stripe-java/pull/528) Add `name` to `Coupon` model
 
-## 5.41.0 - 2018-06-14
+## <a id="5-41-0"></a>5.41.0 - 2018-06-14
 * [#522](https://github.com/stripe/stripe-java/pull/522) Add `amountPaid`, `amountRemaining` and `billingReason` to `Invoice` model
 
-## 5.40.0 - 2018-06-13
+## <a id="5-40-0"></a>5.40.0 - 2018-06-13
 * [#521](https://github.com/stripe/stripe-java/pull/521) Add `documentBack` property to `LegalEntity` model
 
-## 5.39.0 - 2018-06-07
+## <a id="5-39-0"></a>5.39.0 - 2018-06-07
 * [#515](https://github.com/stripe/stripe-java/pull/515) Add `hosted_invoice_url` and `invoice_pdf` properties to `Invoice` model
 
-## 5.38.0 - 2018-06-06
+## <a id="5-38-0"></a>5.38.0 - 2018-06-06
 * [#516](https://github.com/stripe/stripe-java/pull/516) Add `active` property to `Plan` model
 
-## 5.37.0 - 2018-06-06
+## <a id="5-37-0"></a>5.37.0 - 2018-06-06
+* [#302](https://github.com/stripe/stripe-java/pull/302) The library now uses Project Lombok. All API resource classes now have `equals` and `hashCode` methods.
 * [#513](https://github.com/stripe/stripe-java/pull/513) Add `on_behalf_of` property on `Charge` model
 * [#512](https://github.com/stripe/stripe-java/pull/512) Fix `update()` methods for `FeeRefund` and `Reversal`
-* [#302](https://github.com/stripe/stripe-java/pull/302) The library now uses Project Lombok. All API resource classes now have `equals` and `hashCode` methods.
 
-## 5.36.0 - 2018-05-09
+## <a id="5-36-0"></a>5.36.0 - 2018-05-09
 * [#505](https://github.com/stripe/stripe-java/pull/505) Add support for issuer fraud records
 
-## 5.35.1 - 2018-04-06
+## <a id="5-35-1"></a>5.35.1 - 2018-04-06
 * [#498](https://github.com/stripe/stripe-java/pull/498) Fix two bugs found by Error Prone
 
-## 5.35.0 - 2018-04-05
+## <a id="5-35-0"></a>5.35.0 - 2018-04-05
 * [#462](https://github.com/stripe/stripe-java/pull/462) Add support for flexible billing primitives
 
-## 5.34.1 - 2018-03-23
+## <a id="5-34-1"></a>5.34.1 - 2018-03-23
 * [#469](https://github.com/stripe/stripe-java/pull/469) Add support for expanding `product` attribute on `Plan` model
 
-## 5.34.0 - 2018-03-22
+## <a id="5-34-0"></a>5.34.0 - 2018-03-22
 * [#459](https://github.com/stripe/stripe-java/pull/459) Add support for passing parameters to `autoPagingIterable()`
 * [#466](https://github.com/stripe/stripe-java/pull/466) Fix serialization of null expandable attributes
 
-## 5.33.3 - 2018-03-21
+## <a id="5-33-3"></a>5.33.3 - 2018-03-21
 * [#464](https://github.com/stripe/stripe-java/pull/464) Add OSGi headers to manifest file
 
-## 5.33.2 - 2018-02-28
+## <a id="5-33-2"></a>5.33.2 - 2018-02-28
 * [#458](https://github.com/stripe/stripe-java/pull/458) Remove deprecation markers from `sourceTransaction` accessors on `Transfer` model
 
-## 5.33.1 - 2018-02-27
+## <a id="5-33-1"></a>5.33.1 - 2018-02-27
 * [#457](https://github.com/stripe/stripe-java/pull/457) Add title, version and vendor in JAR manifest file
 
-## 5.33.0 - 2018-02-23
+## <a id="5-33-0"></a>5.33.0 - 2018-02-23
 * [#455](https://github.com/stripe/stripe-java/pull/455) Add support for `code` attribute on all Stripe exceptions
 
-## 5.32.0 - 2018-02-21
+## <a id="5-32-0"></a>5.32.0 - 2018-02-21
 * [#453](https://github.com/stripe/stripe-java/pull/453) Add support for topups
 
-## 5.31.0 - 2018-02-13
+## <a id="5-31-0"></a>5.31.0 - 2018-02-13
 * [#446](https://github.com/stripe/stripe-java/pull/446) Add support for deserializing `source_mandate_notification` objects
 
-## 5.30.0 - 2018-02-13
+## <a id="5-30-0"></a>5.30.0 - 2018-02-13
 * [#449](https://github.com/stripe/stripe-java/pull/449) Add `Stripe.setAppInfo()` for passing custom application information in headers
 
-## 5.29.0 - 2018-02-08
+## <a id="5-29-0"></a>5.29.0 - 2018-02-08
 * [#447](https://github.com/stripe/stripe-java/pull/447) Update `Plan`, `Product` and `Subscription` models for latest API version
 
-## 5.28.0 - 2018-01-02
+## <a id="5-28-0"></a>5.28.0 - 2018-01-02
 * [#439](https://github.com/stripe/stripe-java/pull/439) Upgrade GSON dependency to 2.8.2
 
-## 5.27.0 - 2017-12-22
+## <a id="5-27-0"></a>5.27.0 - 2017-12-22
 * [#438](https://github.com/stripe/stripe-java/pull/438) Add support for passing parameters to `SubscriptionItem.delete()`
 
-## 5.26.0 - 2017-12-18
-* [#436](https://github.com/stripe/stripe-java/pull/436) Fix bug where `options` were not being plumbed through in an account delete method
+## <a id="5-26-0"></a>5.26.0 - 2017-12-18
 * [#436](https://github.com/stripe/stripe-java/pull/436) Add the proper set of overloads for account reject method
+* [#436](https://github.com/stripe/stripe-java/pull/436) Fix bug where `options` were not being plumbed through in an account delete method
 
-## 5.25.0 - 2017-12-06
+## <a id="5-25-0"></a>5.25.0 - 2017-12-06
 * [#432](https://github.com/stripe/stripe-java/pull/432) Make charge on `Dispute` expandable
 
-## 5.24.0 - 2017-11-28
-* [#421](https://github.com/stripe/stripe-java/pull/421) Expose response objects
+## <a id="5-24-0"></a>5.24.0 - 2017-11-28
 * [#427](https://github.com/stripe/stripe-java/pull/427) Add `automatic` property on `Payout` model
+* [#421](https://github.com/stripe/stripe-java/pull/421) Expose response objects
 
-## 5.23.1 - 2017-11-09
+## <a id="5-23-1"></a>5.23.1 - 2017-11-09
 * [#423](https://github.com/stripe/stripe-java/pull/423) Fix JSON encoding for expandable fields by adding customer encoder
 
-## 5.23.0 - 2017-10-31
+## <a id="5-23-0"></a>5.23.0 - 2017-10-31
 * [#419](https://github.com/stripe/stripe-java/pull/419) Support for exchange rate APIs
 
-## 5.22.1 - 2017-10-27
+## <a id="5-22-1"></a>5.22.1 - 2017-10-27
 * [#418](https://github.com/stripe/stripe-java/pull/418) Move build and release system from Maven to Gradle
 
-## 5.22.0 - 2017-10-27
+## <a id="5-22-0"></a>5.22.0 - 2017-10-27
 * [#417](https://github.com/stripe/stripe-java/pull/417) Support for listing source transactions
 
-## 5.21.0 - 2017-10-09
-* [#410](https://github.com/stripe/stripe-java/pull/410) Rename "verification" to "code verification" for sources (should have been unused up to this point)
+## <a id="5-21-0"></a>5.21.0 - 2017-10-09
 * [#412](https://github.com/stripe/stripe-java/pull/412) Add support for detaching sources from customers
+* [#410](https://github.com/stripe/stripe-java/pull/410) Rename "verification" to "code verification" for sources (should have been unused up to this point)
 * Note that some minor versions (5.11 through 5.20) were accidentally skipped for this release. I'm leaving as is to minimize churn, but please don't be alarmed!
 
-## 5.10.0 - 2017-10-04
+## <a id="5-10-0"></a>5.10.0 - 2017-10-04
 * Add `failure_reason` field to the source redirect flow model
 
-## 5.9.1 - 2017-10-03
+## <a id="5-9-1"></a>5.9.1 - 2017-10-03
 * No longer clobber global value of DNS cache TTL if it has not been set
 
-## 5.9.0 - 2017-09-25
+## <a id="5-9-0"></a>5.9.0 - 2017-09-25
 * Support Java 9 (just involves upgrading a few Maven plugins)
 
-## 5.8.0 - 2017-08-31
+## <a id="5-8-0"></a>5.8.0 - 2017-08-31
 * Add support for all OAuth actions
 
-## 5.7.1 - 2017-07-11
+## <a id="5-7-1"></a>5.7.1 - 2017-07-11
 * Force UTF-8 encoding for webhook signature verification
 
-## 5.7.0 - 2017-07-11
+## <a id="5-7-0"></a>5.7.0 - 2017-07-11
 * Use standard library comparison for webhook signature verification
 
-## 5.6.0 - 2017-06-27
+## <a id="5-6-0"></a>5.6.0 - 2017-06-27
 * `pay` on invoice can now take parameters
 
-## 5.5.0 - 2017-06-23
+## <a id="5-5-0"></a>5.5.0 - 2017-06-23
 * Add support for alternate statement descriptors on charge
 
-## 5.4.0 - 2017-06-19
+## <a id="5-4-0"></a>5.4.0 - 2017-06-19
 * Add support for ephemeral keys
 
-## 5.3.0 - 2017-06-14
+## <a id="5-3-0"></a>5.3.0 - 2017-06-14
 * Add missing expandable fields on every model
 
-## 5.2.0 - 2017-06-09
+## <a id="5-2-0"></a>5.2.0 - 2017-06-09
 * Support for expandable sources in balance transactions
 
-## 5.1.0 - 2017-06-07
+## <a id="5-1-0"></a>5.1.0 - 2017-06-07
 * Add `account` field to the event model
 
-## 5.0.0 - 2017-05-31
+## <a id="5-0-0"></a>5.0.0 - 2017-05-31
 * Clarify tolerance parameter for webhook signatures is in seconds
 * Support expanded request in `Event` model (now with idempotency key)
 
-## 4.9.1 - 2017-05-30
+## <a id="4-9-1"></a>4.9.1 - 2017-05-30
 * This release should have been 5.0.0, see notes for that
 
-## 4.9.0 - 2017-05-25
+## <a id="4-9-0"></a>4.9.0 - 2017-05-25
 * This release should have been 5.0.0, see notes for that
 
-## 4.8.0 - 2017-05-25
+## <a id="4-8-0"></a>4.8.0 - 2017-05-25
 * Add support for account login links
 
-## 4.7.0 - 2017-05-02
+## <a id="4-7-0"></a>4.7.0 - 2017-05-02
 * Add `three_d_secure` accessors to `Card` model
 
-## 4.6.0 - 2017-04-28
+## <a id="4-6-0"></a>4.6.0 - 2017-04-28
 * Support for checking webhook signatures
 
-## 4.5.0 - 2017-04-28
+## <a id="4-5-0"></a>4.5.0 - 2017-04-28
 * Make connect and read timeouts configurable (see README for details)
 
-## 4.4.0 - 2017-04-24
+## <a id="4-4-0"></a>4.4.0 - 2017-04-24
 * Add payout properties to `Account` model
 
-## 4.3.0 - 2017-04-12
+## <a id="4-3-0"></a>4.3.0 - 2017-04-12
 * Add support for `available_payout_methods` to `Card` model
 
-## 4.2.0 - 2017-04-06
+## <a id="4-2-0"></a>4.2.0 - 2017-04-06
 * Add support for payouts; see: https://docs.stripe.com/changelog/2017-04-06
 
-## 4.1.0 - 2017-04-04
+## <a id="4-1-0"></a>4.1.0 - 2017-04-04
 * Make `rule` under `ChargeOutcome` expandable
 
-## 4.0.0 - 2017-03-13
-* Dispute on charge becomes expandable field (not expanded by default)
+## <a id="4-0-0"></a>4.0.0 - 2017-03-13
+* Add missing fields on order: `amountReturned`, `returns`, and `upstreamId`
 * Charge on order becomes expandable field (not expanded by default)
 * Customer on order becomes expandable field (not expanded by default)
-* Add missing fields on order: `amountReturned`, `returns`, and `upstreamId`
+* Dispute on charge becomes expandable field (not expanded by default)
 * Fix type of `OrderReturnCollection` (now actually an order return)
 
-## 3.11.0 - 2017-02-22
+## <a id="3-11-0"></a>3.11.0 - 2017-02-22
 * Add new parameters for invoices and subscriptions
 
-## 3.10.2 - 2017-02-21
+## <a id="3-10-2"></a>3.10.2 - 2017-02-21
 * Add missing API resources to object deserializer
 
-## 3.10.1 - 2017-02-21
+## <a id="3-10-1"></a>3.10.1 - 2017-02-21
 * This release was inadvertently empty. See 3.10.2 for changes.
 
-## 3.10.0 - 2017-02-13
+## <a id="3-10-0"></a>3.10.0 - 2017-02-13
 * Deprecated sourced transfers under balance transactions
 
-## 3.9.0 - 2017-02-02
+## <a id="3-9-0"></a>3.9.0 - 2017-02-02
 * Add variant of account `delete` that doesn't require parameters
 
-## 3.8.0 - 2017-01-23
+## <a id="3-8-0"></a>3.8.0 - 2017-01-23
 * Add `ChargeOutcomeRule` to `ChargeOutcome`
 
-## 3.7.0 - 2017-01-06
+## <a id="3-7-0"></a>3.7.0 - 2017-01-06
 * Add `getObject`/`setObject` to a number of models where it was missing
 * Add `toJson` method to `StripeObject`
 
-## 3.6.0 - 2017-01-03
+## <a id="3-6-0"></a>3.6.0 - 2017-01-03
 * Add non-public `network_reason_code` to `Dispute` model
 
-## 3.5.0 - 2016-12-08
+## <a id="3-5-0"></a>3.5.0 - 2016-12-08
 * Add expandable Charge to Invoice
 
-## 3.3.0 - 2016-11-22
+## <a id="3-4-0"></a>3.4.0 - 2016-12-08
+
+## <a id="3-3-0"></a>3.3.0 - 2016-11-22
 * Add retrieve method for 3-D Secure resources
 
-## 3.2.0 - 2016-10-18
+## <a id="3-2-0"></a>3.2.0 - 2016-10-18
 * Add `risk_level` attribute to `ChargeOutcome` model
 
-## 3.1.0 - 2016-10-18
+## <a id="3-1-0"></a>3.1.0 - 2016-10-18
 * Support for 403 status codes (permission denied)
 
-## 3.0.0 - 2016-10-17
+## <a id="3-0-0"></a>3.0.0 - 2016-10-17
 * Change representations of money (e.g. "amounts" or "balances") from `Integer` to `Long`
 
-## 2.10.2 - 2016-10-13
+## <a id="2-10-2"></a>2.10.2 - 2016-10-13
 * Fix NullPointerException in SourceDeserializer for bitcoin receivers, and refactor tests.
 
-## 2.10.1 - 2016-10-06
+## <a id="2-10-1"></a>2.10.1 - 2016-10-06
 * Fix bug where the Transfer transactions method wasn't using requestCollection
 
-## 2.10.0 - 2016-09-16
+## <a id="2-10-0"></a>2.10.0 - 2016-09-16
 * Add support for Apple Pay domains
 
-## 2.9.0 - 2016-09-07
+## <a id="2-9-0"></a>2.9.0 - 2016-09-07
 * Add `description`, `iin`, and `issuer` attributes to `Card` model
 
-## 2.8.0 - 2016-08-05
+## <a id="2-8-0"></a>2.8.0 - 2016-08-05
 * Add `Source` model (prototype)
 
-## 2.7.0 - 2016-07-12
+## <a id="2-7-0"></a>2.7.0 - 2016-07-12
 * Add `ThreeDSecure` model for 3-D secure payments
 
-## 2.6.1 - 2016-06-13
+## <a id="2-6-1"></a>2.6.1 - 2016-06-13
 * Fix serialization of `businessURL` and `supportURL` in `Account` model
 
-## 2.6.0 - 2016-05-25
+## <a id="2-6-0"></a>2.6.0 - 2016-05-25
 * Add support for returning Relay orders
 
-## 2.5.1 - 2016-05-23
+## <a id="2-5-1"></a>2.5.1 - 2016-05-23
 * Give all collection classes access to auto-paginating helpers that work beyond first page
 
-## 2.5.0 - 2016-05-04
+## <a id="2-5-0"></a>2.5.0 - 2016-05-04
 * Add `retrieve`, `update`, `create`, `all`, and `delete` methods to the Subscription class
 
-## 2.4.0 - 2016-04-21
+## <a id="2-4-0"></a>2.4.0 - 2016-04-21
 * Add many missing fields to many models (see #285 for details)
 
-## 2.3.0 - 2016-04-18
+## <a id="2-3-0"></a>2.3.0 - 2016-04-18
 * Add source types to `Money` model under the `Balance` model
 
-## 2.2.0 - 2016-04-12
+## <a id="2-2-0"></a>2.2.0 - 2016-04-12
 * Add `Outcome` to the `Charge` model
 
-## 2.1.0 - 2016-04-12
-* Deprecate `getUser` and `setUser` on `ApplicationFee`
-* Deprecate `getCard` and `setCard` on `Charge`
+## <a id="2-1-0"></a>2.1.0 - 2016-04-12
 * Deprecate `getAccount` and `setAccount` on `Transfer`
+* Deprecate `getCard` and `setCard` on `Charge`
 * Deprecate `getOtherTransfers` and `setOtherTransfers` on `Transfer`
 * Deprecate `getSummary` and `setSummary` on `Transfer`
+* Deprecate `getUser` and `setUser` on `ApplicationFee`
 
-## 2.0.0 - 2016-04-08
+## <a id="2-0-0"></a>2.0.0 - 2016-04-08
 * Change `getBusinessUrl` to `getBusinessURL` in `Account` model
 * Change `getSupportUrl` to `getSupportURL` in `Account` model
 * Change `getUrl` to `getURL` in `Product` model
-* Change `setUrl` to `setURL` in `Product` model
 * Change `getUrl` to `getURL` in `StripeCollection` model
+* Change `getUrl` to `getURL` in `StripeCollectionInterface`
+* Change `setUrl` to `setURL` in `Product` model
 * Change `setUrl` to `setURL` in `StripeCollection` model
 * Remove previously-deprecated `getUrl` in `StripeCollectionAPIResource` model
-* Change `getUrl` to `getURL` in `StripeCollectionInterface`
 
-## 1.48.0 - 2016-03-29
+## <a id="1-48-0"></a>1.48.0 - 2016-03-29
 * Add accessors for `default_currency` to `CountrySpec` model
 
-## 1.47.0 - 2016-03-21
+## <a id="1-47-0"></a>1.47.0 - 2016-03-21
 * Allow request params and options to be overridden for `autoPagingIterable`
 
-## 1.46.0 - 2016-03-15
-* Expose creating bank accounts on customer
+## <a id="1-46-0"></a>1.46.0 - 2016-03-15
 * Add `reject` action on account
+* Expose creating bank accounts on customer
 
-## 1.45.0 - 2016-02-18
+## <a id="1-45-0"></a>1.45.0 - 2016-02-18
 * Add `CountrySpec` model for looking up country payment information
 
-## 1.44.0 - 2016-02-11
+## <a id="1-44-0"></a>1.44.0 - 2016-02-11
 * Add `businessTaxIdProvided` to `LegalEntity`
 
-## 1.43.0 - 2016-01-26
+## <a id="1-43-0"></a>1.43.0 - 2016-01-26
 * Add support for deleting Relay SKUs and products
 
-## 1.42.0 - 2016-01-21
+## <a id="1-42-0"></a>1.42.0 - 2016-01-21
 * Add `details_code` to `LegalEntity`
 * Add `disabled_reason` to `Verification`
 
-## 1.41.1 - 2016-01-15
+## <a id="1-41-1"></a>1.41.1 - 2016-01-15
 * Fix serialization bug in `LegalEntity`'s `ssnLast4Provided`
 
-## 1.41.0 - 2016-01-13
+## <a id="1-41-0"></a>1.41.0 - 2016-01-13
 * Add lots of missing fields to Account, Event, and Refund
 
-## 1.40.1 - 2016-01-07
+## <a id="1-40-1"></a>1.40.1 - 2016-01-07
 * Fix casting of newer objects to *typed* models
 
-## 1.40.0 - 2015-12-03
+## <a id="1-40-0"></a>1.40.0 - 2015-12-03
 * Add missing `ShippingDetails` to `Customer` model
 
-## 1.39.0 - 2015-12-01
+## <a id="1-39-0"></a>1.39.0 - 2015-12-01
 * Add a verification routine for external accounts
 
-## 1.38.1 - 2015-11-30
+## <a id="1-38-1"></a>1.38.1 - 2015-11-30
 * Fix bug when using lazy-paging collection across multiple pages
 
-## 1.38.0 - 2015-10-27
+## <a id="1-38-0"></a>1.38.0 - 2015-10-27
 * Add pagination through the use of calling `AutoPagingIterable()` for a page
 * Fix bug where arrays were not being properly encoded when sent to the API
 * Fix bug where setting a `List` to `null` wasn't encoding to an empty string (which is required to unset an array)
 
-## 1.37.1 - 2015-10-07
+## <a id="1-37-1"></a>1.37.1 - 2015-10-07
 * Bugfix `setTransfer` on `Reversal`
 
-## 1.37.0 - 2015-09-14
+## <a id="1-37-0"></a>1.37.0 - 2015-09-14
 * Products, SKUs, and Orders -- https://stripe.com/relay
 
-## 1.36.0 - 2015-09-11
+## <a id="1-36-0"></a>1.36.0 - 2015-09-11
 * Add support for new rate limiting responses.
 
-## 1.35.0 - 2015-08-31
+## <a id="1-35-0"></a>1.35.0 - 2015-08-31
 * Add `bankAccount` to `Token`
 
-## 1.34.0 - 2015-08-17
+## <a id="1-34-0"></a>1.34.0 - 2015-08-17
 * Added `retrieve`, `all`, `update`, `create` methods to `Refund`
 
-## 1.33.0 - 2015-08-03
-* Added `retrieve`, `all`, `update` and `close` methods to `Dispute`
+## <a id="1-33-0"></a>1.33.0 - 2015-08-03
 * Added `delete` method to managed `Account`s
+* Added `retrieve`, `all`, `update` and `close` methods to `Dispute`
 
-## 1.32.1 - 2015-07-24
+## <a id="1-32-1"></a>1.32.1 - 2015-07-24
 * Added `account` to `ApplicationFee`.
 
-## 1.32.0 - 2015-07-06
+## <a id="1-32-0"></a>1.32.0 - 2015-07-06
 * Added `getRequestId` method to `StripeException`.
 
-## 1.31.0 - 2015-06-01
-* `ConcretePaymentSource` and the `PaymentSource` interface have been combined into one `ExternalAccount` class
-* `PaymentSourceCollection` was renamed `ExternalAccountCollection`
+## <a id="1-31-0"></a>1.31.0 - 2015-06-01
 * `Account` now supports `getExternalAccounts`, which allows both `BankAccount` and `Card` attachment.
 * `BankAccount`s can now be deleted from `Customer`s (private beta feature) and `Account`s
+* `ConcretePaymentSource` and the `PaymentSource` interface have been combined into one `ExternalAccount` class
+* `PaymentSourceCollection` was renamed `ExternalAccountCollection`
 
-## 1.30.0 - 2015-05-28
+## <a id="1-30-0"></a>1.30.0 - 2015-05-28
 * Add decline_code, charge to CardException
 
-## 1.29.0 - 2015-05-21
+## <a id="1-29-0"></a>1.29.0 - 2015-05-21
 * Added tax percent field to subscriptions
 * Added tax and tax percent fields to invoices
 
-## 1.28.0 - 2015-05-08
-* Added support for Alipay accounts
+## <a id="1-28-0"></a>1.28.0 - 2015-05-08
 * Added default source when type is unknown
+* Added support for Alipay accounts
 * Added support dynamicLast4 on Card for Apple Pay integrations
 
-## 1.27.1 - 2015-03-30
+## <a id="1-27-1"></a>1.27.1 - 2015-03-30
 * Charge objects now support status
 
-## 1.27.0 - 2015-02-19
-* Added support for transfer reversals
+## <a id="1-27-0"></a>1.27.0 - 2015-03-19
+* Added STRIPE-ACCOUNT header options in RequestOptions
 * Added support for account creation/updating/retrieval by ID
+* Added support for transfer reversals
 * Customer objects now support currency
-* Added STRIPE-ACCOUNT header options in RequestOptions
 
-## 1.26.0 - 2015-02-19
+## <a id="1-26-0"></a>1.26.0 - 2015-02-19
 * Added Update and Delete for Bitcoin Receivers
 * Support new API version (2015-02-18) by providing source type properties
   on Customer and Charge in addition to card type properties
 
-## 1.25.1 - 2015-01-23
+## <a id="1-25-1"></a>1.25.1 - 2015-01-23
 * Test of new stripe-java release process.
 
-## 1.25.0 - 2015-01-21
+## <a id="1-25-0"></a>1.25.0 - 2015-01-22
 * Support making bitcoin charges through BitcoinReceiver source object
 
-## 1.24.1 - 2015-01-05
+## <a id="1-24-1"></a>1.24.1 - 2015-01-05
 * Support for fraud reporting methods was added
 
-## 1.24.0 - 2014-12-18
+## <a id="1-24-0"></a>1.24.0 - 2014-12-23
 * The ability to post multipart/form-data was added
 * Requests can now hit different base endpoints, by passing in `apiBase` when creating URLs
 * Support for the file upload endpoints was added. Documentation is available at https://stripe.com/docs/api#file_uploads
 * Support for fraud reporting (marking charges as safe or fraudulent) was added
 
-## 1.23.0 - 2014-12-08
-* Java 1.5 support dropped. We strongly suggest using newer versions of Java due to runtime, VM, language, and syntax improvements
+## <a id="1-23-0"></a>1.23.0 - 2014-12-08
 * Dispute Evidence has been updated to reflect the new version of Dispute evidence format introduced as part of api version 2014-12-08. See https://docs.stripe.com/changelog/2014-12-08 for details
+* Java 1.5 support dropped. We strongly suggest using newer versions of Java due to runtime, VM, language, and syntax improvements
 
-## 1.22.0 - 2014-12-03
+## <a id="1-22-0"></a>1.22.0 - 2014-12-03
+* Add shipping and address to the charge object
 * Convention is to call methods with a RequestOptions object, instead of an API Key directly
 * Support setting the stripe version on a per-request level, via the RequestOptions object
-* Add shipping and address to the charge object
 
 ### Deprecation
-
 * All requests that involve passing the apiKey directly to the method are now deprecated in favor of using RequestOptions instead. Use RequestOptions as follows:
+  RequestOptions.builder().setApiKey(apiKey).build()
 
-    RequestOptions.builder().setApiKey(apiKey).build()
-
-## 1.21.0 - 2014-11-14
+## <a id="1-21-0"></a>1.21.0 - 2014-11-14
 * Created Charge.receiptEmail field
 * Created Charge.receiptNumber field
 
-## 1.20.0 - 2014-11-06
+## <a id="1-20-0"></a>1.20.0 - 2014-11-06
+* Add id, currency, status, fingerprint, and defaultForCurrency to BankAccount
 * Change chargeEnabled to chargesEnabled
 * Change transferEnabled to transfersEnabled
-* Add id, currency, status, fingerprint, and defaultForCurrency to BankAccount
 
-## 1.19.1 - 2014-10-02
+## <a id="1-19-1"></a>1.19.1 - 2014-10-02
 * Add back explict autoboxing for Google App Engine reflected HTTP method (fixes issue #106)
 
-## 1.19.0 - 2014-09-30
+## <a id="1-19-0"></a>1.19.0 - 2014-09-29
 * Add statementDescription field to transfer
 * A few non-breaking general cleanups
 
-## 1.18.0 - 2014-08-25
+## <a id="1-18-0"></a>1.18.0 - 2014-08-25
 * Added isChargeRefundable and balanceTransactions to Dispute https://docs.stripe.com/changelog/2014-08-20
 
-## 1.17.0 - 2014-08-19
+## <a id="1-17-0"></a>1.17.0 - 2014-08-19
 * Added metadata to Coupons
 
-## 1.16.0 - 2014-07-26
+## <a id="1-16-0"></a>1.16.0 - 2014-07-29
 * Application Fee refunds now a list instead of array
 
-## 1.15.1 - 2014-06-25
+## <a id="1-15-1"></a>1.15.1 - 2014-06-25
 * Added brand and funding to Card
 
-## 1.15.0 - 2014-06-17
-* Added metadata to Refund
+## <a id="1-15-0"></a>1.15.0 - 2014-06-17
 * Added metadata to Dispute
+* Added metadata to Refund
 * Fixed incorrect return types for certain collection resources
 
-## 1.14.1 - 2014-06-04
+## <a id="1-14-1"></a>1.14.1 - 2014-06-04
 * Added metadata to Subscription
 
-## 1.14.0 - 2014-05-28
+## <a id="1-14-0"></a>1.14.0 - 2014-05-28
 * Add support for canceling transfers
 
-## 1.13.1 - 2014-05-23
+## <a id="1-13-1"></a>1.13.1 - 2014-05-23
 * Fix bug with retrieving lines of upcoming invoice.
 
-## 1.13.0 - 2014-05-21
+## <a id="1-13-0"></a>1.13.0 - 2014-05-21
 * Support cards for recipients.
 
-## 1.12.0 - 2014-04-09
+## <a id="1-12-0"></a>1.12.0 - 2014-04-09
 * Test SSL certificate against blacklist
 
-## 1.11.0 - 2014-04-07
-* Upgrade customer, charge, and coupon collections to new pagination style
+## <a id="1-11-0"></a>1.11.0 - 2014-04-07
 * Add missing fields to Account object
+* Upgrade customer, charge, and coupon collections to new pagination style
 
-## 1.10.0 - 2014-03-28
+## <a id="1-10-0"></a>1.10.0 - 2014-03-28
 * Support for newstyle pagination API (https://groups.google.com/a/lists.stripe.com/forum/#!topic/api-announce/29sLxmICA9E)
 
-## 1.9.0 - 2014-03-17
-* Support for dynamic statement descriptions
+## <a id="1-9-0"></a>1.9.0 - 2014-03-17
 * Preserve original 'threaqd null ids through to requests' behavior
+* Support for dynamic statement descriptions
 
-## 1.8.0 - 2014-03-12
+## <a id="1-8-0"></a>1.8.0 - 2014-03-12
 * Upgrade Google GSON to 2.2.4
 * URL-encode object ids (fixes #62)
 
-## 1.7.2 - 2014-02-27
+## <a id="1-7-2"></a>1.7.2 - 2014-02-27
 * Add 'valid' field to coupon
 
-## 1.7.1 - 2014-01-31
+## <a id="1-7-1"></a>1.7.1 - 2014-01-31
 * Fix Subscription cancel method call
 * Miscellaneous field fixups
-    * Discount on Subscription is an expanded Discount, not string
-    * Add missing application_fee_percent field on Subscription
-    * Add missing application_fee field on Invoice
+  * Discount on Subscription is an expanded Discount, not string
+  * Add missing application_fee_percent field on Subscription
+  * Add missing application_fee field on Invoice
 
-## 1.7.0 - 2014-01-29
+## <a id="1-7-0"></a>1.7.0 - 2014-01-29
 * Add support for multiple subscriptions per customer
 
-## 1.6.5 - 2014-01-22
-* Fixed url to refund application fees (fixes #60)
+## <a id="1-6-5"></a>1.6.5 - 2014-01-22
 * DRY'd some of the application fee urls
+* Fixed url to refund application fees (fixes #60)
 
-## 1.6.4 - 2014-01-16
+## <a id="1-6-4"></a>1.6.4 - 2014-01-16
 * Added metadata to InvoiceItem and InvoiceLineItem (fixes #59)
 
-## 1.6.3 - 2014-01-13
-* Support overriding base url (for testing) (user request)
+## <a id="1-6-3"></a>1.6.3 - 2014-01-13
 * Add default currency to Account object (fixes #46)
 * Add metadata to plan object (thanks, desirable-objects)
 * Remove plan from Customer (fixes #42)
 * Style improvements (see #30) (thanks, steve-nester-uk)
+* Support overriding base url (for testing) (user request)
 
-## 1.6.2 - 2014-01-08
+## <a id="1-6-2"></a>1.6.2 - 2014-01-08
 * Fix return type of Coupon.getRedeemBy
 
-## 1.6.1 - 2013-12-02
+## <a id="1-6-1"></a>1.6.1 - 2013-12-04
 * Add ApplicationFee API resource
 
-## 1.5.1 - 2013-10-17
+## <a id="1-5-1"></a>1.5.1 - 2013-10-17
 * Added field transfer_enabled to Account API object (thanks, kurguzov)
 
-## 1.5.0 - 2013-10-01
+## <a id="1-5-0"></a>1.5.0 - 2013-10-17
 * Add support for metadata API
 
-## 1.4.2 - 2013-09-18
+## <a id="1-4-3"></a>1.4.3 - 2013-09-18
+
+## <a id="1-4-2"></a>1.4.2 - 2013-09-18
 * Add support for closing disputes
 
-## 1.4.1 - 2013-09-04
+## <a id="1-4-1"></a>1.4.1 - 2013-09-04
 * Fix return type of CustomerCardCollection.retrieve
 
-## 1.4.0 - 2013-09-03
+## <a id="1-4-0"></a>1.4.0 - 2013-09-03
 * Tweak card create to align it with docs
 
-## 1.3.2 - 2013-08-30
-* Add missing `retrieve` method to `BalanceTransaction`
-* Add missing fields to `BalanceTransaction`
-    * `id`
-    * `fee`
-    * `fee_details`
-    * `description`
+## <a id="1-3-2"></a>1.3.2 - 2013-08-30
 * Add `id` field to `Subscription`
+* Add missing fields to `BalanceTransaction`
+  * `id`
+  * `fee`
+  * `fee_details`
+  * `description`
+* Add missing `retrieve` method to `BalanceTransaction`
 
-## 1.3.1 - 2013-08-21
+## <a id="1-3-1"></a>1.3.1 - 2013-08-21
 * Patch release with missing field, added tests
 
-## 1.3.0 - 2013-08-19
+## <a id="1-3-0"></a>1.3.0 - 2013-08-19
 * Add BalanceTransaction API resource
 * Add Refund resource
 * Resource updates
-    * Remove `fee`, `feeDetails` from Transfer and Charge resources
-    * Add `balanceTransaction` to Transfer, Charge, and Dispute resources
-    * Add `refunds` to Charge resource
+  * Remove `fee`, `feeDetails` from Transfer and Charge resources
+  * Add `balanceTransaction` to Transfer, Charge, and Dispute resources
+  * Add `refunds` to Charge resource
 
-## 1.2.8 - 2013-08-12
+## <a id="1-2-8"></a>1.2.8 - 2013-08-12
 * Add support for unsetting attributes by updating with a null value. Setting properties to a blank string is now an error.
 
-## 1.2.7 - 2013-07-31
+## <a id="1-2-7"></a>1.2.7 - 2013-07-31
 * Enable createCard() to use a token
 
-## 1.2.6 - 2013-07-30
+## <a id="1-2-6"></a>1.2.6 - 2013-07-30
 * Add 'createCard' to Customer
-* Update card collections bindings
 * Parse card objects when receiving customer.card.created events
+* Update card collections bindings
 
-## 1.2.5 - 2013-07-15
-* Add support for new cards API.
-    * You will probably need to upgrade the Stripe API version on your account to 2013-07-05 or explicitly specify an API version with com.stripe.Stripe.apiVersion when you switch to this release of the bindings. More information about the relevant changes can be found at https://docs.stripe.com/changelog/2013-07-05 and http://bit.ly/13miHM8
-* Add a StripeRawJsonObject type for deserializing webhook events we don't recognize
+## <a id="1-2-5"></a>1.2.5 - 2013-07-15
 * Add a Money class for representing account balances in individual currencies
+* Add a StripeRawJsonObject type for deserializing webhook events we don't recognize
+* Add support for new cards API.
+  * You will probably need to upgrade the Stripe API version on your account to 2013-07-05 or explicitly specify an API version with com.stripe.Stripe.apiVersion when you switch to this release of the bindings. More information about the relevant changes can be found at https://docs.stripe.com/changelog/2013-07-05 and http://bit.ly/13miHM8
 
-## 1.2.4 - 2013-06-21
+## <a id="1-2-4"></a>1.2.4 - 2013-06-22
 * Add more Balance API resource, and add to deserializer.
 
-## 1.2.3 - 2013-05-7
+## <a id="1-2-3"></a>1.2.3 - 2013-05-07
 * Rename BankAccount property `valid` to `validated`
 
-## 1.2.2 - 2013-04-25
+## <a id="1-2-2"></a>1.2.2 - 2013-04-25
 * Add more objects to Deserializer
 
-## 1.2.1 - 2013-04-20
+## <a id="1-2-1"></a>1.2.1 - 2013-04-20
 * Fix TransferTransaction fee retrieval
 
-## 1.2.0 - 2013-04-11
-* Allow Transfers to be creatable
+## <a id="1-2-0"></a>1.2.0 - 2013-04-20
 * Add new Recipient resource
+* Allow Transfers to be creatable
 
-## 1.1.18 - 2013-03-19
+## <a id="1-1-18"></a>1.1.18 - 2013-03-18
 * Add support for charge capture.
 
-## 1.1.17 - 2013-02-18
+## <a id="1-1-17"></a>1.1.17 - 2013-02-18
 * Add ability to deserialize account-related events.
 * Add user ID to Event object.
 
-## 1.1.16 - 2013-02-15
+## <a id="1-1-16"></a>1.1.16 - 2013-02-15
 * Fix off-by-one error in deserializing events (github issue #27).
 
-## 1.1.15 - 2013-02-01
-* List all checked exceptions throws by methods.
+## <a id="1-1-15"></a>1.1.15 - 2013-02-01
 * Add support for plan interval count.
+* List all checked exceptions throws by methods.
 
-## 1.1.14 - 2013-01-15
+## <a id="1-1-14"></a>1.1.14 - 2013-01-15
 * Add support for setting Stripe API version override.
 
-## 1.1.13 - 2012-12-29
+## <a id="1-1-13"></a>1.1.13 - 2012-12-29
 * Add address_city to card
 * Upgrade Google GSON to 2.2.2
 
-## 1.1.12 - 2012-12-24
+## <a id="1-1-12"></a>1.1.12 - 2012-12-24
 * Add option to provide custom URL handler
 
-## 1.1.11 - 2012-11-17
+## <a id="1-1-11"></a>1.1.11 - 2012-11-17
 * Explict cast to javax.net.ssl.HttpsURLConnection to prevent issues with user imports
 
-## 1.1.10 - 2012-11-15
-* Add currency to Invoice resource
+## <a id="1-1-10"></a>1.1.10 - 2012-11-15
 * Add amountOff and currency to Coupon resource
+* Add currency to Invoice resource
 
-## 1.1.9 - 2012-11-08
+## <a id="1-1-9"></a>1.1.9 - 2012-11-08
 * Add new Dispute resource
 * Add support for updating charge disputes
 
-## 1.1.8 - 2012-10-30
+## <a id="1-1-8"></a>1.1.8 - 2012-10-30
 * Add support for creating invoices
 * Add support for new Invoice.lines return format
 
-## 1.1.7 - 2012-10-15
+## <a id="1-1-7"></a>1.1.7 - 2012-10-24
 * Add quantity to Subscription
 
-## 1.1.6 - 2012-10-15
+## <a id="1-1-6"></a>1.1.6 - 2012-10-15
 * Add Fee API resource, add feeDetails to Charge API resource.
 
-## 1.1.5 - 2012-09-26
+## <a id="1-1-5"></a>1.1.5 - 2012-09-26
 * Pass query parameters to DELETE-based methods when using Google App Engine (github issue #17)
 
-## 1.1.4 - 2012-08-31
+## <a id="1-1-4"></a>1.1.4 - 2012-08-31
 * Add update and pay methods for Invoice resource
 
-## 1.1.3 - 2012-08-15
+## <a id="1-1-3"></a>1.1.3 - 2012-08-17
 * Add the Account API resource
 
-## 1.1.2 - 2012-08-06
+## <a id="1-1-2"></a>1.1.2 - 2012-08-06
 * Allow specification of API key at the API call level
 
-## 1.1.1 - 2012-05-24
+## <a id="1-1-1"></a>1.1.1 - 2012-05-24
 * Use String.length() == 0 instead of String.isEmpty() for compatibility with JDK 1.5 (needed for Android 2.2)
 
-## 1.1.0 - 2012-05-16
-* Change type of cvcCheck, addressZipCheck, and addressLine1Check attributes on com.stripe.model.Card; values of those fields will be "pass", "fail", "unchecked", or null (github issue #11)
-* Remove code and percentOff attributes from com.stripe.model.Discount. Stripe never returned these values for Discount objects, so they would previously always be null
+## <a id="1-1-0"></a>1.1.0 - 2012-05-16
 * Add missing fields to Charge, Coupon, Discount, Event, and Invoice models (github issue #12)
-* Include parameters passed to any object's delete method in actual API requests (github issue #10)
 * Add new deleteDiscount method to com.stripe.model.Customer
-* 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)
+* Change type of cvcCheck, addressZipCheck, and addressLine1Check attributes on com.stripe.model.Card; values of those fields will be "pass", "fail", "unchecked", or null (github issue #11)
+* Include parameters passed to any object's delete method in actual API requests (github issue #10)
 * Numerous test suite improvements
+* Remove code and percentOff attributes from com.stripe.model.Discount. Stripe never returned these values for Discount objects, so they would previously always be null
+* 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)
+
+## <a id="1-0-16"></a>1.0.16 - 2012-05-09
+
+## <a id="1-0-15"></a>1.0.15 - 2012-04-11
+
+## <a id="1-0-14"></a>1.0.14 - 2012-03-16
+
+## <a id="1-0-13"></a>1.0.13 - 2012-03-02
+
+## <a id="1-0-12"></a>1.0.12 - 2012-01-30
+
+## <a id="1-0-11"></a>1.0.11 - 2012-01-20
+
+## <a id="1-0-9"></a>1.0.9 - 2011-12-13
+
+## <a id="1-0-8"></a>1.0.8 - 2011-12-11
+
+## <a id="1-0-7"></a>1.0.7 - 2011-11-29
+
+## <a id="1-0-6"></a>1.0.6 - 2011-11-23
+
+## <a id="1-0-5"></a>1.0.5 - 2011-11-20
+
+## <a id="1-0-4"></a>1.0.4 - 2011-11-11
+
+## <a id="1-0-3"></a>1.0.3 - 2011-11-03
+
+## <a id="1-0-2"></a>1.0.2 - 2011-10-27
+
+## <a id="1-0-1"></a>1.0.1 - 2011-10-14
+
+## <a id="1-0-0"></a>1.0.0 - 2011-10-09
diff --git a/justfile b/justfile
index 072f3a4600f..6452b67db70 100644
--- a/justfile
+++ b/justfile
@@ -38,3 +38,10 @@ update-version version:
     perl -pi -e 's|<version>[.\d\-\w]+<\/version>|<version>{{ version }}</version>|' README.md
     perl -pi -e 's|VERSION_NAME=[.\d\-\w]+|VERSION_NAME={{ version }}|' gradle.properties
     perl -pi -e 's|public static final String VERSION = "[.\d\-\w]+";|public static final String VERSION = "{{ version }}";|' src/main/java/com/stripe/Stripe.java
+
+# ⭐ 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-]*' src/main/java/com/stripe/ApiVersion.java)"
+    echo "minimum-runtime-version: $(rg -N --color never -o 'sourceCompatibility = JavaVersion.VERSION_(\S+)' --replace '$1' build.gradle | tr '_' '.')"