diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 97a923ff8..c7d166a31 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -10,14 +10,6 @@ List out the key changes made in this PR, e.g.
 ### See Also
 <!-- Include any links or additional information that help explain this change. -->
 
-## Changelog
-<!-- Heads up! This section should include entries for any user-facing changes.
-Either fill it out or remove it if there are no entries to report.
+## Configuration
 
-List changes that affect end users, e.g.
-- Fixes crash when calling `foo.bar()` with nil argument
-- Adds support for new `baz` parameter on `PaymentIntent` creation
-
-List breaking changes first with a ⚠️ prefix, e.g.
-- ⚠️ Removes deprecated `legacy_method` function
--->
+- [ ] `skip-changefile`: This PR is not a user-facing change, so there's no changefile.
diff --git a/.github/workflows/changelog.yml b/.github/workflows/changelog.yml
new file mode 100644
index 000000000..aed122580
--- /dev/null
+++ b/.github/workflows/changelog.yml
@@ -0,0 +1,21 @@
+name: Changelog
+
+on:
+  pull_request:
+    # opened, synchronize and reopened are the defaults; `edited` is what makes this
+    # re-run when someone toggles an opt-out box in the description
+    types: [opened, synchronize, reopened, edited]
+
+permissions: {}
+
+jobs:
+  changefile:
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read # check out the repo so `hark validate` can read .hark/
+      pull-requests: read # list the files this pull request adds
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: stripe/hark/actions/checks@master
diff --git a/.github/zizmor.yml b/.github/zizmor.yml
index 17c9154c4..e76b9b86e 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/2010-01-05_unknown_initial-release.change.md b/.hark/changes/2010-01-05_unknown_initial-release.change.md
new file mode 100644
index 000000000..77b20f101
--- /dev/null
+++ b/.hark/changes/2010-01-05_unknown_initial-release.change.md
@@ -0,0 +1,4 @@
+---
+title: Initial release
+released_in_version: "1.0.0"
+---
diff --git a/.hark/changes/2010-03-14_unknown_support-recurring-billing.change.md b/.hark/changes/2010-03-14_unknown_support-recurring-billing.change.md
new file mode 100644
index 000000000..44eb41fd8
--- /dev/null
+++ b/.hark/changes/2010-03-14_unknown_support-recurring-billing.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for recurring billing
+released_in_version: "1.1.0"
+---
diff --git a/.hark/changes/2010-06-06_unknown_support-setcustomers-deletecustom.change.md b/.hark/changes/2010-06-06_unknown_support-setcustomers-deletecustom.change.md
new file mode 100644
index 000000000..6182a29cc
--- /dev/null
+++ b/.hark/changes/2010-06-06_unknown_support-setcustomers-deletecustom.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for the set_customer_subscription and delete_customer API methods
+released_in_version: "1.2.0"
+---
diff --git a/.hark/changes/2011-01-07_unknown_rename-stripe.change.md b/.hark/changes/2011-01-07_unknown_rename-stripe.change.md
new file mode 100644
index 000000000..5cf42afeb
--- /dev/null
+++ b/.hark/changes/2011-01-07_unknown_rename-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Rename to Stripe
+released_in_version: 1.3.4
+---
diff --git a/.hark/changes/2011-05-26_unknown_update-new-restful.change.md b/.hark/changes/2011-05-26_unknown_update-new-restful.change.md
new file mode 100644
index 000000000..4b08f9361
--- /dev/null
+++ b/.hark/changes/2011-05-26_unknown_update-new-restful.change.md
@@ -0,0 +1,4 @@
+---
+title: Update for new RESTful API
+released_in_version: 1.5.0
+---
diff --git a/.hark/changes/2012-01-27_unknown_1-6-0.change.md b/.hark/changes/2012-01-27_unknown_1-6-0.change.md
new file mode 100644
index 000000000..da60a94b2
--- /dev/null
+++ b/.hark/changes/2012-01-27_unknown_1-6-0.change.md
@@ -0,0 +1,4 @@
+---
+title: 1.6.0 also contains a new inspect/to_string implementation
+released_in_version: 1.6.0
+---
diff --git a/.hark/changes/2012-01-27_unknown_whole-bunch-releases.change.md b/.hark/changes/2012-01-27_unknown_whole-bunch-releases.change.md
new file mode 100644
index 000000000..eb60499d8
--- /dev/null
+++ b/.hark/changes/2012-01-27_unknown_whole-bunch-releases.change.md
@@ -0,0 +1,4 @@
+---
+title: A whole bunch of releases between 1.5.0 and 1.6.0, but few changes, mainly the addition of plans, coupons, events, and tokens
+released_in_version: 1.6.0
+---
diff --git a/.hark/changes/2012-02-22_unknown_fix-stripeobject-inspect.change.md b/.hark/changes/2012-02-22_unknown_fix-stripeobject-inspect.change.md
new file mode 100644
index 000000000..3e7842830
--- /dev/null
+++ b/.hark/changes/2012-02-22_unknown_fix-stripeobject-inspect.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix StripeObject#inspect when ActiveSupport 3.0 is loaded"
+released_in_version: 1.6.1
+---
diff --git a/.hark/changes/2012-02-24_unknown_correct-argument-handling.change.md b/.hark/changes/2012-02-24_unknown_correct-argument-handling.change.md
new file mode 100644
index 000000000..6ac10217e
--- /dev/null
+++ b/.hark/changes/2012-02-24_unknown_correct-argument-handling.change.md
@@ -0,0 +1,4 @@
+---
+title: "Correct argument handling in StripeObject#as_json"
+released_in_version: 1.6.2
+---
diff --git a/.hark/changes/2012-03-22_unknown_encode-get-query.change.md b/.hark/changes/2012-03-22_unknown_encode-get-query.change.md
new file mode 100644
index 000000000..c9db5ce17
--- /dev/null
+++ b/.hark/changes/2012-03-22_unknown_encode-get-query.change.md
@@ -0,0 +1,4 @@
+---
+title: Encode GET query strings ourselves instead of using rest-client to work around a bug
+released_in_version: 1.6.3
+---
diff --git a/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md b/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md
new file mode 100644
index 000000000..abf6effae
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_add-new-deletediscou.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new delete_discount method to Customer objects
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_add-new-transfer.change.md b/.hark/changes/2012-05-17_unknown_add-new-transfer.change.md
new file mode 100644
index 000000000..47947db4d
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_add-new-transfer.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new Transfer API resource
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md b/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md
new file mode 100644
index 000000000..be381bb67
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_numerous-test-suite.change.md
@@ -0,0 +1,4 @@
+---
+title: Numerous test suite improvements
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_switch-http-basic.change.md b/.hark/changes/2012-05-17_unknown_switch-http-basic.change.md
new file mode 100644
index 000000000..a3e67928a
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_switch-http-basic.change.md
@@ -0,0 +1,4 @@
+---
+title: "Switch from HTTP Basic auth to Bearer auth (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)"
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-05-17_unknown_switch-vendored-stripe.change.md b/.hark/changes/2012-05-17_unknown_switch-vendored-stripe.change.md
new file mode 100644
index 000000000..a6183a21d
--- /dev/null
+++ b/.hark/changes/2012-05-17_unknown_switch-vendored-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: "Switch from vendored stripe-json to multi_json for all JSON parsing and rendering. This should not impact programmatic usage of the library, but may cause small rendering differences from, e.g., StripeObject#inspect (github issue #22)"
+released_in_version: 1.7.0
+---
diff --git a/.hark/changes/2012-08-17_unknown_add-new-account.change.md b/.hark/changes/2012-08-17_unknown_add-new-account.change.md
new file mode 100644
index 000000000..b4cbc2f5c
--- /dev/null
+++ b/.hark/changes/2012-08-17_unknown_add-new-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new Account API resource
+released_in_version: 1.7.1
+---
diff --git a/.hark/changes/2012-08-31_unknown_add-support-new.change.md b/.hark/changes/2012-08-31_unknown_add-support-new.change.md
new file mode 100644
index 000000000..327d93eb8
--- /dev/null
+++ b/.hark/changes/2012-08-31_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new pay and update methods for Invoice objects
+released_in_version: 1.7.2
+---
diff --git a/.hark/changes/2012-09-14_unknown_make-sure-both.change.md b/.hark/changes/2012-09-14_unknown_make-sure-both.change.md
new file mode 100644
index 000000000..278eba04e
--- /dev/null
+++ b/.hark/changes/2012-09-14_unknown_make-sure-both.change.md
@@ -0,0 +1,4 @@
+---
+title: "Make sure that both keys and values of GET params are URL-encoded. NOTE: If you were previously URL-encoding values yourself, you may need to adjust your code."
+released_in_version: 1.7.3
+---
diff --git a/.hark/changes/2012-09-14_unknown_url-encode-post.change.md b/.hark/changes/2012-09-14_unknown_url-encode-post.change.md
new file mode 100644
index 000000000..c2697c393
--- /dev/null
+++ b/.hark/changes/2012-09-14_unknown_url-encode-post.change.md
@@ -0,0 +1,4 @@
+---
+title: "URL-encode POST params directly, instead of allowing rest-client to do it to work around an unfortunate interaction with the hashery gem (github issue #38)"
+released_in_version: 1.7.3
+---
diff --git a/.hark/changes/2012-10-08_unknown_fix-bug-introduced.change.md b/.hark/changes/2012-10-08_unknown_fix-bug-introduced.change.md
new file mode 100644
index 000000000..b6391a2f3
--- /dev/null
+++ b/.hark/changes/2012-10-08_unknown_fix-bug-introduced.change.md
@@ -0,0 +1,6 @@
+---
+title: Fix bug introduced in 1.7.3 calling API methods that take no
+released_in_version: 1.7.4
+---
+
+arguments, like Stripe::Invoice#pay (github issue #42)
diff --git a/.hark/changes/2012-10-25_unknown_add-support-new.change.md b/.hark/changes/2012-10-25_unknown_add-support-new.change.md
new file mode 100644
index 000000000..fadb6850e
--- /dev/null
+++ b/.hark/changes/2012-10-25_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for new API lists
+released_in_version: 1.7.5
+---
diff --git a/.hark/changes/2012-10-30_unknown_add-support-creating.change.md b/.hark/changes/2012-10-30_unknown_add-support-creating.change.md
new file mode 100644
index 000000000..bacc67b6f
--- /dev/null
+++ b/.hark/changes/2012-10-30_unknown_add-support-creating.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for creating invoices
+released_in_version: 1.7.6
+---
diff --git a/.hark/changes/2012-11-08_unknown_add-support-updating.change.md b/.hark/changes/2012-11-08_unknown_add-support-updating.change.md
new file mode 100644
index 000000000..de90ea9b0
--- /dev/null
+++ b/.hark/changes/2012-11-08_unknown_add-support-updating.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for updating charge disputes
+released_in_version: 1.7.7
+---
diff --git a/.hark/changes/2012-11-08_unknown_fix-account-api.change.md b/.hark/changes/2012-11-08_unknown_fix-account-api.change.md
new file mode 100644
index 000000000..6fe517b1e
--- /dev/null
+++ b/.hark/changes/2012-11-08_unknown_fix-account-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix Account API resource bug
+released_in_version: 1.7.7
+---
diff --git a/.hark/changes/2012-11-21_unknown_relax-version-constraint.change.md b/.hark/changes/2012-11-21_unknown_relax-version-constraint.change.md
new file mode 100644
index 000000000..58537bdc1
--- /dev/null
+++ b/.hark/changes/2012-11-21_unknown_relax-version-constraint.change.md
@@ -0,0 +1,4 @@
+---
+title: "Relax the version constraint on multi_json (github issue #44)"
+released_in_version: 1.7.8
+---
diff --git a/.hark/changes/2013-01-15_unknown_add-support-setting.change.md b/.hark/changes/2013-01-15_unknown_add-support-setting.change.md
new file mode 100644
index 000000000..677e02d3e
--- /dev/null
+++ b/.hark/changes/2013-01-15_unknown_add-support-setting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for setting a Stripe API version override.
+released_in_version: 1.7.9
+---
diff --git a/.hark/changes/2013-02-04_unknown_add-support-passing.change.md b/.hark/changes/2013-02-04_unknown_add-support-passing.change.md
new file mode 100644
index 000000000..0d79ef0f9
--- /dev/null
+++ b/.hark/changes/2013-02-04_unknown_add-support-passing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for passing options when retrieving Stripe objects e.g., Stripe::Charge.retrieve({id:"foo", expand:["customer"]}) Stripe::Charge("foo") is still supported as well
+released_in_version: 1.7.10
+---
diff --git a/.hark/changes/2013-02-21_unknown_add-id-list.change.md b/.hark/changes/2013-02-21_unknown_add-id-list.change.md
new file mode 100644
index 000000000..4d7bfb0ec
--- /dev/null
+++ b/.hark/changes/2013-02-21_unknown_add-id-list.change.md
@@ -0,0 +1,4 @@
+---
+title: Add 'id' to the list of permanent attributes
+released_in_version: 1.7.11
+---
diff --git a/.hark/changes/2013-04-11_unknown_add-new-recipient.change.md b/.hark/changes/2013-04-11_unknown_add-new-recipient.change.md
new file mode 100644
index 000000000..14e1e908c
--- /dev/null
+++ b/.hark/changes/2013-04-11_unknown_add-new-recipient.change.md
@@ -0,0 +1,4 @@
+---
+title: Add new Recipient resource
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2013-04-11_unknown_allow-transfers-createable.change.md b/.hark/changes/2013-04-11_unknown_allow-transfers-createable.change.md
new file mode 100644
index 000000000..f994bb044
--- /dev/null
+++ b/.hark/changes/2013-04-11_unknown_allow-transfers-createable.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow Transfers to be createable
+released_in_version: 1.8.0
+---
diff --git a/.hark/changes/2013-04-19_unknown_add-support-specifying.change.md b/.hark/changes/2013-04-19_unknown_add-support-specifying.change.md
new file mode 100644
index 000000000..118d2dbd6
--- /dev/null
+++ b/.hark/changes/2013-04-19_unknown_add-support-specifying.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for specifying an API key when retrieving an upcoming invoice
+released_in_version: 1.8.1
+---
diff --git a/.hark/changes/2013-05-01_unknown_add-customer-upcominginvo.change.md b/.hark/changes/2013-05-01_unknown_add-customer-upcominginvo.change.md
new file mode 100644
index 000000000..2e55661c5
--- /dev/null
+++ b/.hark/changes/2013-05-01_unknown_add-customer-upcominginvo.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add an Customer#upcoming_invoice convenience method (github issue #65)"
+released_in_version: 1.8.2
+---
diff --git a/.hark/changes/2013-05-01_unknown_allow-updating-resources.change.md b/.hark/changes/2013-05-01_unknown_allow-updating-resources.change.md
new file mode 100644
index 000000000..a1ff777a8
--- /dev/null
+++ b/.hark/changes/2013-05-01_unknown_allow-updating-resources.change.md
@@ -0,0 +1,4 @@
+---
+title: "Allow updating resources without first retrieving them (github issue #60)"
+released_in_version: 1.8.2
+---
diff --git a/.hark/changes/2013-05-01_unknown_handle-low-memory.change.md b/.hark/changes/2013-05-01_unknown_handle-low-memory.change.md
new file mode 100644
index 000000000..9d5c2b828
--- /dev/null
+++ b/.hark/changes/2013-05-01_unknown_handle-low-memory.change.md
@@ -0,0 +1,4 @@
+---
+title: "Handle low-memory situations without throwing an exception (github issue #61)"
+released_in_version: 1.8.2
+---
diff --git a/.hark/changes/2013-05-01_unknown_use-tosym-instead.change.md b/.hark/changes/2013-05-01_unknown_use-tosym-instead.change.md
new file mode 100644
index 000000000..9890b3ce0
--- /dev/null
+++ b/.hark/changes/2013-05-01_unknown_use-tosym-instead.change.md
@@ -0,0 +1,4 @@
+---
+title: "Use to_sym instead of type checking for minor performance improvement (github issue #59)"
+released_in_version: 1.8.2
+---
diff --git a/.hark/changes/2013-05-06_unknown_fix-handling-per.change.md b/.hark/changes/2013-05-06_unknown_fix-handling-per.change.md
new file mode 100644
index 000000000..718f66e0f
--- /dev/null
+++ b/.hark/changes/2013-05-06_unknown_fix-handling-per.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix handling of per-call API keys (github issue #67)"
+released_in_version: 1.8.3
+---
diff --git a/.hark/changes/2013-07-11_unknown_add-support-new.change.md b/.hark/changes/2013-07-11_unknown_add-support-new.change.md
new file mode 100644
index 000000000..a49651020
--- /dev/null
+++ b/.hark/changes/2013-07-11_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add support for new cards API (Stripe API version - 2013-07-05)"
+released_in_version: 1.8.4
+---
diff --git a/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md b/.hark/changes/2013-08-12_unknown_add-support-unsetting.change.md
new file mode 100644
index 000000000..95c9c64d7
--- /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 setting to nil. This permits unsetting email and description on customers and description on charges. Setting properties to a blank string is now an error.
+released_in_version: 1.8.5
+---
diff --git a/.hark/changes/2013-08-12_unknown_attempting-set-object.change.md b/.hark/changes/2013-08-12_unknown_attempting-set-object.change.md
new file mode 100644
index 000000000..5596eca24
--- /dev/null
+++ b/.hark/changes/2013-08-12_unknown_attempting-set-object.change.md
@@ -0,0 +1,4 @@
+---
+title: Attempting to set an object's id is now an error
+released_in_version: 1.8.5
+---
diff --git a/.hark/changes/2013-08-20_unknown_add-balance-balancetrans.change.md b/.hark/changes/2013-08-20_unknown_add-balance-balancetrans.change.md
new file mode 100644
index 000000000..45e977a90
--- /dev/null
+++ b/.hark/changes/2013-08-20_unknown_add-balance-balancetrans.change.md
@@ -0,0 +1,4 @@
+---
+title: Add Balance and BalanceTransaction resources
+released_in_version: 1.8.6
+---
diff --git a/.hark/changes/2013-09-19_unknown_add-support-closing.change.md b/.hark/changes/2013-09-19_unknown_add-support-closing.change.md
new file mode 100644
index 000000000..0f9a43cd9
--- /dev/null
+++ b/.hark/changes/2013-09-19_unknown_add-support-closing.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for closing disputes.
+released_in_version: 1.8.7
+---
diff --git a/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md b/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md
new file mode 100644
index 000000000..2423d9b3d
--- /dev/null
+++ b/.hark/changes/2013-10-17_unknown_add-support-metadata.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for metadata on resources
+released_in_version: 1.8.8
+---
diff --git a/.hark/changes/2013-11-14_unknown_fix-apiresourcet-use.change.md b/.hark/changes/2013-11-14_unknown_fix-apiresourcet-use.change.md
new file mode 100644
index 000000000..5cac66d65
--- /dev/null
+++ b/.hark/changes/2013-11-14_unknown_fix-apiresourcet-use.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix api_resource_test to not use returns as a way of testing rescue behavior
+released_in_version: 1.8.9
+---
diff --git a/.hark/changes/2013-11-14_unknown_fix-gemspec-dependencies.change.md b/.hark/changes/2013-11-14_unknown_fix-gemspec-dependencies.change.md
new file mode 100644
index 000000000..badbb83fb
--- /dev/null
+++ b/.hark/changes/2013-11-14_unknown_fix-gemspec-dependencies.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix gemspec dependencies so the gem doesn't break for Ruby 1.8 users
+released_in_version: 1.8.9
+---
diff --git a/.hark/changes/2013-12-04_unknown_add-applicationf-resource.change.md b/.hark/changes/2013-12-04_unknown_add-applicationf-resource.change.md
new file mode 100644
index 000000000..4d54700a0
--- /dev/null
+++ b/.hark/changes/2013-12-04_unknown_add-applicationf-resource.change.md
@@ -0,0 +1,4 @@
+---
+title: Add ApplicationFee resource
+released_in_version: 1.9.9
+---
diff --git a/.hark/changes/2014-01-29_unknown_allow-save-take.change.md b/.hark/changes/2014-01-29_unknown_allow-save-take.change.md
new file mode 100644
index 000000000..08b1dcdd2
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_allow-save-take.change.md
@@ -0,0 +1,4 @@
+---
+title: "Allow #save to take opts (for :expand)"
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-01-29_unknown_fix-try-respondto.change.md b/.hark/changes/2014-01-29_unknown_fix-try-respondto.change.md
new file mode 100644
index 000000000..47056049c
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_fix-try-respondto.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix #try and #respond_to? on StripeObjects"
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-01-29_unknown_replace-multijson-json.change.md b/.hark/changes/2014-01-29_unknown_replace-multijson-json.change.md
new file mode 100644
index 000000000..f1ad0f67c
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_replace-multijson-json.change.md
@@ -0,0 +1,4 @@
+---
+title: Replace multi_json with json
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-01-29_unknown_support-multiple-subscription.change.md b/.hark/changes/2014-01-29_unknown_support-multiple-subscription.change.md
new file mode 100644
index 000000000..0ddfdfcab
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_support-multiple-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for multiple subscriptions per customer
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-01-29_unknown_testing-ruby-2.change.md b/.hark/changes/2014-01-29_unknown_testing-ruby-2.change.md
new file mode 100644
index 000000000..d2018fd0f
--- /dev/null
+++ b/.hark/changes/2014-01-29_unknown_testing-ruby-2.change.md
@@ -0,0 +1,4 @@
+---
+title: Testing ruby 2.1.0
+released_in_version: 1.10.0
+---
diff --git a/.hark/changes/2014-02-03_unknown_fix-marshaling-stripeobject.change.md b/.hark/changes/2014-02-03_unknown_fix-marshaling-stripeobject.change.md
new file mode 100644
index 000000000..1eabb88ad
--- /dev/null
+++ b/.hark/changes/2014-02-03_unknown_fix-marshaling-stripeobject.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix marshaling of StripeObjects
+released_in_version: 1.10.1
+---
diff --git a/.hark/changes/2014-02-18_unknown_add-createsubscr-customer.change.md b/.hark/changes/2014-02-18_unknown_add-createsubscr-customer.change.md
new file mode 100644
index 000000000..f993fe2ce
--- /dev/null
+++ b/.hark/changes/2014-02-18_unknown_add-createsubscr-customer.change.md
@@ -0,0 +1,7 @@
+---
+title: Add create_subscription on Customer resources, so you can create
+released_in_version: 1.10.2
+---
+
+subscriptions without needing to retrieve the customer first (github
+issue #120)
diff --git a/.hark/changes/2014-04-09_unknown_implement-certificate-blacklisting.change.md b/.hark/changes/2014-04-09_unknown_implement-certificate-blacklisting.change.md
new file mode 100644
index 000000000..059ed086f
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_implement-certificate-blacklisting.change.md
@@ -0,0 +1,4 @@
+---
+title: Implement certificate blacklisting
+released_in_version: 1.11.0
+---
diff --git a/.hark/changes/2014-04-09_unknown_update-included-ca.change.md b/.hark/changes/2014-04-09_unknown_update-included-ca.change.md
new file mode 100644
index 000000000..4317f6ad2
--- /dev/null
+++ b/.hark/changes/2014-04-09_unknown_update-included-ca.change.md
@@ -0,0 +1,4 @@
+---
+title: Update included ca bundles
+released_in_version: 1.11.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 000000000..5001dfe96
--- /dev/null
+++ b/.hark/changes/2014-05-21_unknown_support-cards-recipients.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for cards for recipients
+released_in_version: 1.12.0
+---
diff --git a/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md b/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md
new file mode 100644
index 000000000..2144f023c
--- /dev/null
+++ b/.hark/changes/2014-05-28_unknown_support-canceling-transfers.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for canceling transfers
+released_in_version: 1.13.0
+---
diff --git a/.hark/changes/2014-06-17_unknown_add-metadata-refunds.change.md b/.hark/changes/2014-06-17_unknown_add-metadata-refunds.change.md
new file mode 100644
index 000000000..601634831
--- /dev/null
+++ b/.hark/changes/2014-06-17_unknown_add-metadata-refunds.change.md
@@ -0,0 +1,4 @@
+---
+title: Add metadata for refunds and disputes
+released_in_version: 1.14.0
+---
diff --git a/.hark/changes/2014-07-29_unknown_application-fee-refunds.change.md b/.hark/changes/2014-07-29_unknown_application-fee-refunds.change.md
new file mode 100644
index 000000000..60128faad
--- /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.15.0
+---
diff --git a/.hark/changes/2014-10-08_unknown_coupons-now-support.change.md b/.hark/changes/2014-10-08_unknown_coupons-now-support.change.md
new file mode 100644
index 000000000..5c50afa70
--- /dev/null
+++ b/.hark/changes/2014-10-08_unknown_coupons-now-support.change.md
@@ -0,0 +1,4 @@
+---
+title: "Coupons now support update operations - useful for manipulating metadata"
+released_in_version: 1.16.0
+---
diff --git a/.hark/changes/2014-12-19_unknown_ability-send-idempotent.change.md b/.hark/changes/2014-12-19_unknown_ability-send-idempotent.change.md
new file mode 100644
index 000000000..f24e8781a
--- /dev/null
+++ b/.hark/changes/2014-12-19_unknown_ability-send-idempotent.change.md
@@ -0,0 +1,4 @@
+---
+title: Ability to send idempotent requests
+released_in_version: 1.16.1
+---
diff --git a/.hark/changes/2014-12-19_unknown_ability-specify-stripe.change.md b/.hark/changes/2014-12-19_unknown_ability-specify-stripe.change.md
new file mode 100644
index 000000000..bba57bd11
--- /dev/null
+++ b/.hark/changes/2014-12-19_unknown_ability-specify-stripe.change.md
@@ -0,0 +1,4 @@
+---
+title: Ability to specify stripe account as a header
+released_in_version: 1.16.1
+---
diff --git a/.hark/changes/2014-12-23_unknown_file-uploads-resource.change.md b/.hark/changes/2014-12-23_unknown_file-uploads-resource.change.md
new file mode 100644
index 000000000..426d4a1a8
--- /dev/null
+++ b/.hark/changes/2014-12-23_unknown_file-uploads-resource.change.md
@@ -0,0 +1,4 @@
+---
+title: File uploads resource was added (for uploading pdf or image documents for disputes)
+released_in_version: 1.17.0
+---
diff --git a/.hark/changes/2015-01-07_unknown_added-deauthorize-method.change.md b/.hark/changes/2015-01-07_unknown_added-deauthorize-method.change.md
new file mode 100644
index 000000000..4ded5068d
--- /dev/null
+++ b/.hark/changes/2015-01-07_unknown_added-deauthorize-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Added deauthorize method to Account object
+released_in_version: 1.17.1
+---
diff --git a/.hark/changes/2015-01-07_unknown_fixed-dependencies-ruby.change.md b/.hark/changes/2015-01-07_unknown_fixed-dependencies-ruby.change.md
new file mode 100644
index 000000000..4e9bd32a9
--- /dev/null
+++ b/.hark/changes/2015-01-07_unknown_fixed-dependencies-ruby.change.md
@@ -0,0 +1,4 @@
+---
+title: Fixed dependencies for Ruby versions less than 1.9.3
+released_in_version: 1.17.1
+---
diff --git a/.hark/changes/2015-01-08_unknown_fixed-api-key.change.md b/.hark/changes/2015-01-08_unknown_fixed-api-key.change.md
new file mode 100644
index 000000000..9495d1d77
--- /dev/null
+++ b/.hark/changes/2015-01-08_unknown_fixed-api-key.change.md
@@ -0,0 +1,4 @@
+---
+title: Fixed API key propagation for child resources
+released_in_version: 1.17.2
+---
diff --git a/.hark/changes/2015-01-12_unknown_fixed-api-key.change.md b/.hark/changes/2015-01-12_unknown_fixed-api-key.change.md
new file mode 100644
index 000000000..fccd22bf8
--- /dev/null
+++ b/.hark/changes/2015-01-12_unknown_fixed-api-key.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fixed API key propagation for ApplicationFee#refund"
+released_in_version: 1.17.3
+---
diff --git a/.hark/changes/2015-01-21_unknown_added-support-making.change.md b/.hark/changes/2015-01-21_unknown_added-support-making.change.md
new file mode 100644
index 000000000..99769df7e
--- /dev/null
+++ b/.hark/changes/2015-01-21_unknown_added-support-making.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for making bitcoin charges through BitcoinReceiver source object
+released_in_version: 1.18.0
+---
diff --git a/.hark/changes/2015-02-15_unknown_account-retrieval-now.change.md b/.hark/changes/2015-02-15_unknown_account-retrieval-now.change.md
new file mode 100644
index 000000000..24a074fad
--- /dev/null
+++ b/.hark/changes/2015-02-15_unknown_account-retrieval-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Account retrieval now optionally accepts an account ID
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2015-02-15_unknown_better-support-passing.change.md b/.hark/changes/2015-02-15_unknown_better-support-passing.change.md
new file mode 100644
index 000000000..bec97a058
--- /dev/null
+++ b/.hark/changes/2015-02-15_unknown_better-support-passing.change.md
@@ -0,0 +1,4 @@
+---
+title: Better support for passing custom headers, like Stripe-Account, through requests
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2015-02-15_unknown_support-new-transfers.change.md b/.hark/changes/2015-02-15_unknown_support-new-transfers.change.md
new file mode 100644
index 000000000..0fdd145a0
--- /dev/null
+++ b/.hark/changes/2015-02-15_unknown_support-new-transfers.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for new Transfers /reversals endpoint
+released_in_version: 1.19.0
+---
diff --git a/.hark/changes/2015-02-18_unknown_fixed-fetching-upcoming.change.md b/.hark/changes/2015-02-18_unknown_fixed-fetching-upcoming.change.md
new file mode 100644
index 000000000..f71b16c15
--- /dev/null
+++ b/.hark/changes/2015-02-18_unknown_fixed-fetching-upcoming.change.md
@@ -0,0 +1,4 @@
+---
+title: Fixed fetching upcoming invoice/paying invoice methods
+released_in_version: 1.19.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 000000000..fee8ab5c9
--- /dev/null
+++ b/.hark/changes/2015-02-19_unknown_added-update-delete.change.md
@@ -0,0 +1,4 @@
+---
+title: Added Update & Delete operations to Bitcoin Receivers
+released_in_version: 1.20.0
+---
diff --git a/.hark/changes/2015-02-26_unknown_updated-card-point.change.md b/.hark/changes/2015-02-26_unknown_updated-card-point.change.md
new file mode 100644
index 000000000..b987ef218
--- /dev/null
+++ b/.hark/changes/2015-02-26_unknown_updated-card-point.change.md
@@ -0,0 +1,4 @@
+---
+title: Updated Card to point to customer sources endpoint when customer property is set
+released_in_version: 1.20.1
+---
diff --git a/.hark/changes/2015-03-10_unknown_added-support-updating.change.md b/.hark/changes/2015-03-10_unknown_added-support-updating.change.md
new file mode 100644
index 000000000..f8e6a2bc2
--- /dev/null
+++ b/.hark/changes/2015-03-10_unknown_added-support-updating.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for updating nested hashes besides `metadata` (which was already supported)
+released_in_version: 1.20.2
+---
diff --git a/.hark/changes/2015-03-10_unknown_fixed-bug-balance.change.md b/.hark/changes/2015-03-10_unknown_fixed-bug-balance.change.md
new file mode 100644
index 000000000..860d6c40c
--- /dev/null
+++ b/.hark/changes/2015-03-10_unknown_fixed-bug-balance.change.md
@@ -0,0 +1,4 @@
+---
+title: Fixed bug in balance retrieval
+released_in_version: 1.20.2
+---
diff --git a/.hark/changes/2015-03-13_unknown_fixed-error-updating.change.md b/.hark/changes/2015-03-13_unknown_fixed-error-updating.change.md
new file mode 100644
index 000000000..a210abeb7
--- /dev/null
+++ b/.hark/changes/2015-03-13_unknown_fixed-error-updating.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fixed error when updating certain resources (github issue #224)"
+released_in_version: 1.20.3
+---
diff --git a/.hark/changes/2015-03-26_unknown_fix-error-passing.change.md b/.hark/changes/2015-03-26_unknown_fix-error-passing.change.md
new file mode 100644
index 000000000..33ee77e76
--- /dev/null
+++ b/.hark/changes/2015-03-26_unknown_fix-error-passing.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix error when passing an API key to Balance.retrieve (github issue #232)"
+released_in_version: 1.20.4
+---
diff --git a/.hark/changes/2015-03-26_unknown_raise-error-explicitly.change.md b/.hark/changes/2015-03-26_unknown_raise-error-explicitly.change.md
new file mode 100644
index 000000000..76612ff5c
--- /dev/null
+++ b/.hark/changes/2015-03-26_unknown_raise-error-explicitly.change.md
@@ -0,0 +1,4 @@
+---
+title: Raise an error when explicitly passing nil as the API key on resource methods
+released_in_version: 1.20.4
+---
diff --git a/.hark/changes/2015-04-14_unknown_bugfix-don-t.change.md b/.hark/changes/2015-04-14_unknown_bugfix-don-t.change.md
new file mode 100644
index 000000000..e04fdfccb
--- /dev/null
+++ b/.hark/changes/2015-04-14_unknown_bugfix-don-t.change.md
@@ -0,0 +1,4 @@
+---
+title: "Bugfix: don't unset keys when they don't exist on StripeObject"
+released_in_version: 1.21.0
+---
diff --git a/.hark/changes/2015-04-14_unknown_remove-tls-cert.change.md b/.hark/changes/2015-04-14_unknown_remove-tls-cert.change.md
new file mode 100644
index 000000000..48ac9b97c
--- /dev/null
+++ b/.hark/changes/2015-04-14_unknown_remove-tls-cert.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove TLS cert revocation check (all pre-heartbleed certs have expired)
+released_in_version: 1.21.0
+---
diff --git a/.hark/changes/2015-06-10_unknown_added-support-bank.change.md b/.hark/changes/2015-06-10_unknown_added-support-bank.change.md
new file mode 100644
index 000000000..167978d22
--- /dev/null
+++ b/.hark/changes/2015-06-10_unknown_added-support-bank.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for bank accounts and debit cards in managed accounts (via the `external_accounts` param)
+released_in_version: 1.22.0
+---
diff --git a/.hark/changes/2015-07-06_unknown_added-request-ids.change.md b/.hark/changes/2015-07-06_unknown_added-request-ids.change.md
new file mode 100644
index 000000000..691e8f3ce
--- /dev/null
+++ b/.hark/changes/2015-07-06_unknown_added-request-ids.change.md
@@ -0,0 +1,4 @@
+---
+title: Added request IDs and HTTP headers to errors
+released_in_version: 1.23.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_added-support-deleting.change.md b/.hark/changes/2015-08-03_unknown_added-support-deleting.change.md
new file mode 100644
index 000000000..b803845f3
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_added-support-deleting.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for deleting managed accounts
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_added-support-dispute.change.md b/.hark/changes/2015-08-03_unknown_added-support-dispute.change.md
new file mode 100644
index 000000000..815ea9487
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_added-support-dispute.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for dispute listing and retrieval
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-08-03_unknown_bugfix-token-objects.change.md b/.hark/changes/2015-08-03_unknown_bugfix-token-objects.change.md
new file mode 100644
index 000000000..b40a2df1d
--- /dev/null
+++ b/.hark/changes/2015-08-03_unknown_bugfix-token-objects.change.md
@@ -0,0 +1,4 @@
+---
+title: "Bugfix: token objects now are the correct class"
+released_in_version: 1.24.0
+---
diff --git a/.hark/changes/2015-08-17_unknown_added-support-refund.change.md b/.hark/changes/2015-08-17_unknown_added-support-refund.change.md
new file mode 100644
index 000000000..b854354bb
--- /dev/null
+++ b/.hark/changes/2015-08-17_unknown_added-support-refund.change.md
@@ -0,0 +1,4 @@
+---
+title: Added support for refund listing and retrieval without an associated charge
+released_in_version: 1.25.0
+---
diff --git a/.hark/changes/2015-09-11_unknown_add-support-429.change.md b/.hark/changes/2015-09-11_unknown_add-support-429.change.md
new file mode 100644
index 000000000..501a68df3
--- /dev/null
+++ b/.hark/changes/2015-09-11_unknown_add-support-429.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for 429 Rate Limited response
+released_in_version: 1.26.0
+---
diff --git a/.hark/changes/2015-09-14_unknown_add-orders-products.change.md b/.hark/changes/2015-09-14_unknown_add-orders-products.change.md
new file mode 100644
index 000000000..b3130b486
--- /dev/null
+++ b/.hark/changes/2015-09-14_unknown_add-orders-products.change.md
@@ -0,0 +1,4 @@
+---
+title: Add Orders, Products, and SKUs for Relay
+released_in_version: 1.27.0
+---
diff --git a/.hark/changes/2015-09-20_unknown_use-hash-rockets.change.md b/.hark/changes/2015-09-20_unknown_use-hash-rockets.change.md
new file mode 100644
index 000000000..475c8d959
--- /dev/null
+++ b/.hark/changes/2015-09-20_unknown_use-hash-rockets.change.md
@@ -0,0 +1,4 @@
+---
+title: Use hash rockets for backwards compatibility.
+released_in_version: 1.27.1
+---
diff --git a/.hark/changes/2015-09-25_unknown_correct-urls-used.change.md b/.hark/changes/2015-09-25_unknown_correct-urls-used.change.md
new file mode 100644
index 000000000..c3a76e990
--- /dev/null
+++ b/.hark/changes/2015-09-25_unknown_correct-urls-used.change.md
@@ -0,0 +1,4 @@
+---
+title: Correct the URLs used to fetch Bitcoin transactions.
+released_in_version: 1.27.2
+---
diff --git a/.hark/changes/2015-10-05_unknown_add-pagination-helpers.change.md b/.hark/changes/2015-10-05_unknown_add-pagination-helpers.change.md
new file mode 100644
index 000000000..59dbe7c86
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_add-pagination-helpers.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add pagination helpers `#auto_paging_each`, `#previous_page`, and `#next_page`"
+released_in_version: 1.29.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_add-question-mark.change.md b/.hark/changes/2015-10-05_unknown_add-question-mark.change.md
new file mode 100644
index 000000000..2a88a1a9d
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_add-question-mark.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add question mark helpers for boolean fields (e.g. #paid? as well as old #paid)"
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_add-updateattrib-stripeobject.change.md b/.hark/changes/2015-10-05_unknown_add-updateattrib-stripeobject.change.md
new file mode 100644
index 000000000..8818df646
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_add-updateattrib-stripeobject.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add #update_attributes to StripeObject for safe mass assignment"
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_fix-bug-broke.change.md b/.hark/changes/2015-10-05_unknown_fix-bug-broke.change.md
new file mode 100644
index 000000000..50735b990
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_fix-bug-broke.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix a bug that broke the API for StripeObject initialization
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_fix-uri-being.change.md b/.hark/changes/2015-10-05_unknown_fix-uri-being.change.md
new file mode 100644
index 000000000..96439efc3
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_fix-uri-being.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix URI being referenced by file upload resources
+released_in_version: 1.28.1
+---
diff --git a/.hark/changes/2015-10-05_unknown_make-stripeobject-s.change.md b/.hark/changes/2015-10-05_unknown_make-stripeobject-s.change.md
new file mode 100644
index 000000000..f1871f385
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_make-stripeobject-s.change.md
@@ -0,0 +1,4 @@
+---
+title: "Make StripeObject's #save \"upsert\"-like; creates an object if new"
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_properly-mass-assign.change.md b/.hark/changes/2015-10-05_unknown_properly-mass-assign.change.md
new file mode 100644
index 000000000..9d8622c90
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_properly-mass-assign.change.md
@@ -0,0 +1,4 @@
+---
+title: "Properly mass assign attributes on calls to #save"
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-05_unknown_remove-use-deprecated.change.md b/.hark/changes/2015-10-05_unknown_remove-use-deprecated.change.md
new file mode 100644
index 000000000..2817d12d0
--- /dev/null
+++ b/.hark/changes/2015-10-05_unknown_remove-use-deprecated.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove use of deprecated URI.escape
+released_in_version: 1.28.0
+---
diff --git a/.hark/changes/2015-10-06_unknown_fix-bug-where.change.md b/.hark/changes/2015-10-06_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..11a4981ab
--- /dev/null
+++ b/.hark/changes/2015-10-06_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where ampersands were not being properly encoded
+released_in_version: 1.29.1
+---
diff --git a/.hark/changes/2015-10-09_unknown_add-stripeobject-deleted.change.md b/.hark/changes/2015-10-09_unknown_add-stripeobject-deleted.change.md
new file mode 100644
index 000000000..d8aeda13f
--- /dev/null
+++ b/.hark/changes/2015-10-09_unknown_add-stripeobject-deleted.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add `StripeObject#deleted?` for a reliable way to check whether an object is alive"
+released_in_version: 1.30.0
+---
diff --git a/.hark/changes/2015-10-09_unknown_deprecate-stripeobject-refreshfrom.change.md b/.hark/changes/2015-10-09_unknown_deprecate-stripeobject-refreshfrom.change.md
new file mode 100644
index 000000000..a0e0bb89f
--- /dev/null
+++ b/.hark/changes/2015-10-09_unknown_deprecate-stripeobject-refreshfrom.change.md
@@ -0,0 +1,4 @@
+---
+title: "Deprecate `StripeObject#refresh_from`"
+released_in_version: 1.30.0
+---
diff --git a/.hark/changes/2015-10-09_unknown_new-parameter-encoding.change.md b/.hark/changes/2015-10-09_unknown_new-parameter-encoding.change.md
new file mode 100644
index 000000000..39946c0be
--- /dev/null
+++ b/.hark/changes/2015-10-09_unknown_new-parameter-encoding.change.md
@@ -0,0 +1,4 @@
+---
+title: New parameter encoding scheme that doesn't use `URI.escape`
+released_in_version: 1.30.0
+---
diff --git a/.hark/changes/2015-10-10_unknown_fix-bug-prevent.change.md b/.hark/changes/2015-10-10_unknown_fix-bug-prevent.change.md
new file mode 100644
index 000000000..d9d257d59
--- /dev/null
+++ b/.hark/changes/2015-10-10_unknown_fix-bug-prevent.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug that prevent lists of hashes from being URI-encoded properly
+released_in_version: 1.30.1
+---
diff --git a/.hark/changes/2015-10-10_unknown_fix-bug-where.change.md b/.hark/changes/2015-10-10_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..bf77d8236
--- /dev/null
+++ b/.hark/changes/2015-10-10_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where filter conditions were not making it past the first instantiated `ListObject`
+released_in_version: 1.30.1
+---
diff --git a/.hark/changes/2015-10-12_unknown_fix-bug-where.change.md b/.hark/changes/2015-10-12_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..7f0322e0f
--- /dev/null
+++ b/.hark/changes/2015-10-12_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where `opts` didn't properly propagate to descendant `StripeObjects`
+released_in_version: 1.30.2
+---
diff --git a/.hark/changes/2015-10-28_unknown_fix-bug-where.change.md b/.hark/changes/2015-10-28_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..6165650cd
--- /dev/null
+++ b/.hark/changes/2015-10-28_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where arrays that were not `additional_owners` were not properly encoded for requests
+released_in_version: 1.30.3
+---
diff --git a/.hark/changes/2015-10-29_unknown_add-bankaccount-verify.change.md b/.hark/changes/2015-10-29_unknown_add-bankaccount-verify.change.md
new file mode 100644
index 000000000..a64ec3d4b
--- /dev/null
+++ b/.hark/changes/2015-10-29_unknown_add-bankaccount-verify.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add BankAccount#verify convenience method"
+released_in_version: 1.31.0
+---
diff --git a/.hark/changes/2016-01-05_unknown_add-configuratio-optionally.change.md b/.hark/changes/2016-01-05_unknown_add-configuratio-optionally.change.md
new file mode 100644
index 000000000..af4b68d22
--- /dev/null
+++ b/.hark/changes/2016-01-05_unknown_add-configuratio-optionally.change.md
@@ -0,0 +1,4 @@
+---
+title: Add configuration to optionally retry network failures
+released_in_version: 1.32.0
+---
diff --git a/.hark/changes/2016-01-05_unknown_use-modern-api.change.md b/.hark/changes/2016-01-05_unknown_use-modern-api.change.md
new file mode 100644
index 000000000..345a2a4d7
--- /dev/null
+++ b/.hark/changes/2016-01-05_unknown_use-modern-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Use modern API endpoint for producing application fee refunds
+released_in_version: 1.32.0
+---
diff --git a/.hark/changes/2016-01-07_unknown_fix-bug-where.change.md b/.hark/changes/2016-01-07_unknown_fix-bug-where.change.md
new file mode 100644
index 000000000..2867fecb4
--- /dev/null
+++ b/.hark/changes/2016-01-07_unknown_fix-bug-where.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where ivar left uninitialized in StripeObject could error on serialization
+released_in_version: 1.32.1
+---
diff --git a/.hark/changes/2016-01-07_unknown_fix-bug-where_2.change.md b/.hark/changes/2016-01-07_unknown_fix-bug-where_2.change.md
new file mode 100644
index 000000000..69f675caa
--- /dev/null
+++ b/.hark/changes/2016-01-07_unknown_fix-bug-where_2.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug where a nil customer from API could error Bitcoin model on refresh
+released_in_version: 1.32.1
+---
diff --git a/.hark/changes/2016-01-19_unknown_re-implement-charge.change.md b/.hark/changes/2016-01-19_unknown_re-implement-charge.change.md
new file mode 100644
index 000000000..0828ff5bb
--- /dev/null
+++ b/.hark/changes/2016-01-19_unknown_re-implement-charge.change.md
@@ -0,0 +1,4 @@
+---
+title: "Re-implement `Charge#refund` helper to use the modern endpoint suggested by docs"
+released_in_version: 1.33.0
+---
diff --git a/.hark/changes/2016-01-21_unknown_pass-through-arguments.change.md b/.hark/changes/2016-01-21_unknown_pass-through-arguments.change.md
new file mode 100644
index 000000000..c515b8262
--- /dev/null
+++ b/.hark/changes/2016-01-21_unknown_pass-through-arguments.change.md
@@ -0,0 +1,4 @@
+---
+title: "Pass through arguments of `Charge#refund`"
+released_in_version: 1.33.1
+---
diff --git a/.hark/changes/2016-01-25_unknown_add-support-deleting.change.md b/.hark/changes/2016-01-25_unknown_add-support-deleting.change.md
new file mode 100644
index 000000000..a7235cce2
--- /dev/null
+++ b/.hark/changes/2016-01-25_unknown_add-support-deleting.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for deleting products and SKUs
+released_in_version: 1.34.0
+---
diff --git a/.hark/changes/2016-02-01_unknown_allow-ca-cert.change.md b/.hark/changes/2016-02-01_unknown_allow-ca-cert.change.md
new file mode 100644
index 000000000..3f1730e9d
--- /dev/null
+++ b/.hark/changes/2016-02-01_unknown_allow-ca-cert.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow CA cert bundle location to be configured
+released_in_version: 1.35.0
+---
diff --git a/.hark/changes/2016-02-01_unknown_updated-bundled-ca.change.md b/.hark/changes/2016-02-01_unknown_updated-bundled-ca.change.md
new file mode 100644
index 000000000..143304ef4
--- /dev/null
+++ b/.hark/changes/2016-02-01_unknown_updated-bundled-ca.change.md
@@ -0,0 +1,4 @@
+---
+title: Updated bundled CA certs
+released_in_version: 1.35.0
+---
diff --git a/.hark/changes/2016-02-03_unknown_add-compatibilit-layer.change.md b/.hark/changes/2016-02-03_unknown_add-compatibilit-layer.change.md
new file mode 100644
index 000000000..79698192e
--- /dev/null
+++ b/.hark/changes/2016-02-03_unknown_add-compatibilit-layer.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add compatibility layer for old API versions on `Charge#refund`"
+released_in_version: 1.35.1
+---
diff --git a/.hark/changes/2016-02-08_unknown_add-countryspec-model.change.md b/.hark/changes/2016-02-08_unknown_add-countryspec-model.change.md
new file mode 100644
index 000000000..98163a543
--- /dev/null
+++ b/.hark/changes/2016-02-08_unknown_add-countryspec-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `CountrySpec` model for looking up country payment information
+released_in_version: 1.36.0
+---
diff --git a/.hark/changes/2016-03-04_unknown_fix-serializatio-subhash.change.md b/.hark/changes/2016-03-04_unknown_fix-serializatio-subhash.change.md
new file mode 100644
index 000000000..3a7d34713
--- /dev/null
+++ b/.hark/changes/2016-03-04_unknown_fix-serializatio-subhash.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix serialization when subhash given to `#save` or `#update_attributes`"
+released_in_version: 1.36.1
+---
diff --git a/.hark/changes/2016-03-14_unknown_add-account-reject.change.md b/.hark/changes/2016-03-14_unknown_add-account-reject.change.md
new file mode 100644
index 000000000..09de4b126
--- /dev/null
+++ b/.hark/changes/2016-03-14_unknown_add-account-reject.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add `Account#reject` to support the new API feature"
+released_in_version: 1.37.0
+---
diff --git a/.hark/changes/2016-03-14_unknown_fix-reference-non.change.md b/.hark/changes/2016-03-14_unknown_fix-reference-non.change.md
new file mode 100644
index 000000000..7e9227085
--- /dev/null
+++ b/.hark/changes/2016-03-14_unknown_fix-reference-non.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix reference to non-existent `#url` in `ListObject`"
+released_in_version: 1.36.2
+---
diff --git a/.hark/changes/2016-03-18_unknown_allow-opts-passed.change.md b/.hark/changes/2016-03-18_unknown_allow-opts-passed.change.md
new file mode 100644
index 000000000..f49cb88bc
--- /dev/null
+++ b/.hark/changes/2016-03-18_unknown_allow-opts-passed.change.md
@@ -0,0 +1,4 @@
+---
+title: "Allow `opts` to be passed to an API resource's `#save` method"
+released_in_version: 1.38.0
+---
diff --git a/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md b/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md
new file mode 100644
index 000000000..4ca3c9989
--- /dev/null
+++ b/.hark/changes/2016-03-31_unknown_update-ca-cert.change.md
@@ -0,0 +1,4 @@
+---
+title: Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
+released_in_version: 1.39.0
+---
diff --git a/.hark/changes/2016-04-06_unknown_fix-bug-omitted.change.md b/.hark/changes/2016-04-06_unknown_fix-bug-omitted.change.md
new file mode 100644
index 000000000..970508a92
--- /dev/null
+++ b/.hark/changes/2016-04-06_unknown_fix-bug-omitted.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bug that omitted subresources from serialization
+released_in_version: 1.40.0
+---
diff --git a/.hark/changes/2016-04-13_unknown_add-global-stripeaccoun.change.md b/.hark/changes/2016-04-13_unknown_add-global-stripeaccoun.change.md
new file mode 100644
index 000000000..7c5140c7f
--- /dev/null
+++ b/.hark/changes/2016-04-13_unknown_add-global-stripeaccoun.change.md
@@ -0,0 +1,4 @@
+---
+title: Add global `stripe_account` option that adds a `Stripe-Account` header to all requests
+released_in_version: 1.41.0
+---
diff --git a/.hark/changes/2016-05-04_unknown_add-support-new.change.md b/.hark/changes/2016-05-04_unknown_add-support-new.change.md
new file mode 100644
index 000000000..4695f3731
--- /dev/null
+++ b/.hark/changes/2016-05-04_unknown_add-support-new.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for the new /v1/subscriptions endpoint (retrieve, list, create, update, and delete)
+released_in_version: 1.42.0
+---
diff --git a/.hark/changes/2016-05-20_unknown_allow-relay-orders.change.md b/.hark/changes/2016-05-20_unknown_allow-relay-orders.change.md
new file mode 100644
index 000000000..ee3226ec9
--- /dev/null
+++ b/.hark/changes/2016-05-20_unknown_allow-relay-orders.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow Relay orders to be returned and add associated types
+released_in_version: 1.43.0
+---
diff --git a/.hark/changes/2016-05-20_unknown_support-alipay-account.change.md b/.hark/changes/2016-05-20_unknown_support-alipay-account.change.md
new file mode 100644
index 000000000..37eb85de8
--- /dev/null
+++ b/.hark/changes/2016-05-20_unknown_support-alipay-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Support Alipay account retrieval and deletion
+released_in_version: 1.43.0
+---
diff --git a/.hark/changes/2016-06-17_unknown_fix-type-resource.change.md b/.hark/changes/2016-06-17_unknown_fix-type-resource.change.md
new file mode 100644
index 000000000..6f876f419
--- /dev/null
+++ b/.hark/changes/2016-06-17_unknown_fix-type-resource.change.md
@@ -0,0 +1,4 @@
+---
+title: "Fix type of resource returned from `Order#return_order`"
+released_in_version: 1.43.1
+---
diff --git a/.hark/changes/2016-06-29_unknown_add-update-class.change.md b/.hark/changes/2016-06-29_unknown_add-update-class.change.md
new file mode 100644
index 000000000..a1f62910a
--- /dev/null
+++ b/.hark/changes/2016-06-29_unknown_add-update-class.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `update` class method to all resources that can be updated
+released_in_version: 1.44.0
+---
diff --git a/.hark/changes/2016-07-07_unknown_allow-retry-409.change.md b/.hark/changes/2016-07-07_unknown_allow-retry-409.change.md
new file mode 100644
index 000000000..4936edd89
--- /dev/null
+++ b/.hark/changes/2016-07-07_unknown_allow-retry-409.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow retry when a 409 conflict is encountered
+released_in_version: 1.46.0
+---
diff --git a/.hark/changes/2016-07-07_unknown_do-send-subresources.change.md b/.hark/changes/2016-07-07_unknown_do-send-subresources.change.md
new file mode 100644
index 000000000..506cdf309
--- /dev/null
+++ b/.hark/changes/2016-07-07_unknown_do-send-subresources.change.md
@@ -0,0 +1,4 @@
+---
+title: "Do not send subresources when updating except when explicitly told to do so (see #433)"
+released_in_version: 1.45.0
+---
diff --git a/.hark/changes/2016-07-11_unknown_allow-rest-client.change.md b/.hark/changes/2016-07-11_unknown_allow-rest-client.change.md
new file mode 100644
index 000000000..6746f6766
--- /dev/null
+++ b/.hark/changes/2016-07-11_unknown_allow-rest-client.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow rest-client version 2.0+ to be used with the gem
+released_in_version: 1.47.0
+---
diff --git a/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md b/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md
new file mode 100644
index 000000000..ad093020c
--- /dev/null
+++ b/.hark/changes/2016-07-12_unknown_add-threedsecure-model.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `ThreeDSecure` model for 3-D secure payments
+released_in_version: 1.48.0
+---
diff --git a/.hark/changes/2016-07-28_unknown_add-top-level.change.md b/.hark/changes/2016-07-28_unknown_add-top-level.change.md
new file mode 100644
index 000000000..59e39caf2
--- /dev/null
+++ b/.hark/changes/2016-07-28_unknown_add-top-level.change.md
@@ -0,0 +1,4 @@
+---
+title: Add top-level `Source` model
+released_in_version: 1.49.0
+---
diff --git a/.hark/changes/2016-08-15_unknown_allow-sources-created.change.md b/.hark/changes/2016-08-15_unknown_allow-sources-created.change.md
new file mode 100644
index 000000000..baea34193
--- /dev/null
+++ b/.hark/changes/2016-08-15_unknown_allow-sources-created.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow sources to be created
+released_in_version: 1.50.0
+---
diff --git a/.hark/changes/2016-08-25_unknown_fix-encoding-arrays.change.md b/.hark/changes/2016-08-25_unknown_fix-encoding-arrays.change.md
new file mode 100644
index 000000000..b373c826c
--- /dev/null
+++ b/.hark/changes/2016-08-25_unknown_fix-encoding-arrays.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix encoding of arrays of maps where maps unequal sets of keys
+released_in_version: 1.50.1
+---
diff --git a/.hark/changes/2016-08-26_unknown_error-array-maps.change.md b/.hark/changes/2016-08-26_unknown_error-array-maps.change.md
new file mode 100644
index 000000000..84d4ce319
--- /dev/null
+++ b/.hark/changes/2016-08-26_unknown_error-array-maps.change.md
@@ -0,0 +1,4 @@
+---
+title: Error when an array of maps is detected that cannot be accurately encoded
+released_in_version: 1.51.0
+---
diff --git a/.hark/changes/2016-08-26_unknown_start-using-strings.change.md b/.hark/changes/2016-08-26_unknown_start-using-strings.change.md
new file mode 100644
index 000000000..c8e8a8a0d
--- /dev/null
+++ b/.hark/changes/2016-08-26_unknown_start-using-strings.change.md
@@ -0,0 +1,4 @@
+---
+title: Start using strings for header names instead of symbols for better clarity
+released_in_version: 1.51.0
+---
diff --git a/.hark/changes/2016-08-30_unknown_make-sure-account.change.md b/.hark/changes/2016-08-30_unknown_make-sure-account.change.md
new file mode 100644
index 000000000..1bfc1573a
--- /dev/null
+++ b/.hark/changes/2016-08-30_unknown_make-sure-account.change.md
@@ -0,0 +1,4 @@
+---
+title: Make sure `Account`'s `external_account` is saved with its parent
+released_in_version: 1.51.1
+---
diff --git a/.hark/changes/2016-08-30_unknown_make-sure-subscription.change.md b/.hark/changes/2016-08-30_unknown_make-sure-subscription.change.md
new file mode 100644
index 000000000..c36878b39
--- /dev/null
+++ b/.hark/changes/2016-08-30_unknown_make-sure-subscription.change.md
@@ -0,0 +1,4 @@
+---
+title: Make sure `Subscription`'s `source` is saved with its parent
+released_in_version: 1.52.0
+---
diff --git a/.hark/changes/2016-08-31_unknown_relax-version-constraint.change.md b/.hark/changes/2016-08-31_unknown_relax-version-constraint.change.md
new file mode 100644
index 000000000..2aca0a2ca
--- /dev/null
+++ b/.hark/changes/2016-08-31_unknown_relax-version-constraint.change.md
@@ -0,0 +1,4 @@
+---
+title: Relax version constraint on rest-client (and by extension mime-types) for users on Ruby 2+
+released_in_version: 1.53.0
+---
diff --git a/.hark/changes/2016-09-01_unknown_whitelist-errors-should.change.md b/.hark/changes/2016-09-01_unknown_whitelist-errors-should.change.md
new file mode 100644
index 000000000..20c949254
--- /dev/null
+++ b/.hark/changes/2016-09-01_unknown_whitelist-errors-should.change.md
@@ -0,0 +1,4 @@
+---
+title: Whitelist errors that should be retried; scope to known socket and HTTP errors
+released_in_version: 1.54.0
+---
diff --git a/.hark/changes/2016-09-15_unknown_add-support-apple.change.md b/.hark/changes/2016-09-15_unknown_add-support-apple.change.md
new file mode 100644
index 000000000..5c04e5070
--- /dev/null
+++ b/.hark/changes/2016-09-15_unknown_add-support-apple.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for Apple Pay domains
+released_in_version: 1.55.0
+---
diff --git a/.hark/changes/2016-10-24_unknown_add-accessors-new.change.md b/.hark/changes/2016-10-24_unknown_add-accessors-new.change.md
new file mode 100644
index 000000000..fe6bf07af
--- /dev/null
+++ b/.hark/changes/2016-10-24_unknown_add-accessors-new.change.md
@@ -0,0 +1,4 @@
+---
+title: "Add accessors for new fields added in `#update_attributes`"
+released_in_version: 1.56.0
+---
diff --git a/.hark/changes/2016-10-24_unknown_handle-403-status.change.md b/.hark/changes/2016-10-24_unknown_handle-403-status.change.md
new file mode 100644
index 000000000..78b4a9a88
--- /dev/null
+++ b/.hark/changes/2016-10-24_unknown_handle-403-status.change.md
@@ -0,0 +1,4 @@
+---
+title: Handle 403 status codes from the API
+released_in_version: 1.56.0
+---
diff --git a/.hark/changes/2016-10-24_unknown_handle-multi-plan.change.md b/.hark/changes/2016-10-24_unknown_handle-multi-plan.change.md
new file mode 100644
index 000000000..928f667c4
--- /dev/null
+++ b/.hark/changes/2016-10-24_unknown_handle-multi-plan.change.md
@@ -0,0 +1,4 @@
+---
+title: Handle multi-plan subscriptions through new subscription items
+released_in_version: 1.56.0
+---
diff --git a/.hark/changes/2016-11-09_unknown_fix-fairly-serious.change.md b/.hark/changes/2016-11-09_unknown_fix-fairly-serious.change.md
new file mode 100644
index 000000000..18c5aafb5
--- /dev/null
+++ b/.hark/changes/2016-11-09_unknown_fix-fairly-serious.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix (fairly serious) memory like in `StripeObject`
+released_in_version: 1.56.1
+---
diff --git a/.hark/changes/2016-11-17_unknown_improve-stripeobject-s.change.md b/.hark/changes/2016-11-17_unknown_improve-stripeobject-s.change.md
new file mode 100644
index 000000000..cf31b3558
--- /dev/null
+++ b/.hark/changes/2016-11-17_unknown_improve-stripeobject-s.change.md
@@ -0,0 +1,4 @@
+---
+title: "Improve `StripeObject`'s `#to_s` to better handle how embedded objects are displayed"
+released_in_version: 1.56.2
+---
diff --git a/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md b/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md
new file mode 100644
index 000000000..1d14098eb
--- /dev/null
+++ b/.hark/changes/2016-11-21_unknown_add-retrieve-method.change.md
@@ -0,0 +1,4 @@
+---
+title: Add retrieve method for 3-D Secure resources
+released_in_version: 1.57.0
+---
diff --git a/.hark/changes/2016-11-28_unknown_disallow-sending-protected.change.md b/.hark/changes/2016-11-28_unknown_disallow-sending-protected.change.md
new file mode 100644
index 000000000..9b80a3c89
--- /dev/null
+++ b/.hark/changes/2016-11-28_unknown_disallow-sending-protected.change.md
@@ -0,0 +1,4 @@
+---
+title: Disallow sending protected fields along with API resource `.update`
+released_in_version: 1.57.1
+---
diff --git a/.hark/changes/2017-01-19_unknown_remove-erroneously-added.change.md b/.hark/changes/2017-01-19_unknown_remove-erroneously-added.change.md
new file mode 100644
index 000000000..4327d2455
--- /dev/null
+++ b/.hark/changes/2017-01-19_unknown_remove-erroneously-added.change.md
@@ -0,0 +1,4 @@
+---
+title: Remove erroneously added list methods for `Source` model
+released_in_version: 1.58.0
+---
diff --git a/.hark/changes/2017-02-14_unknown_allow-http-client.change.md b/.hark/changes/2017-02-14_unknown_allow-http-client.change.md
new file mode 100644
index 000000000..3c7966836
--- /dev/null
+++ b/.hark/changes/2017-02-14_unknown_allow-http-client.change.md
@@ -0,0 +1,4 @@
+---
+title: Allow HTTP client that makes Stripe calls to be configured via Faraday
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2017-02-14_unknown_drop-restclient.change.md b/.hark/changes/2017-02-14_unknown_drop-restclient.change.md
new file mode 100644
index 000000000..9922390df
--- /dev/null
+++ b/.hark/changes/2017-02-14_unknown_drop-restclient.change.md
@@ -0,0 +1,4 @@
+---
+title: Drop RestClient
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2017-02-14_unknown_drop-support-ruby.change.md b/.hark/changes/2017-02-14_unknown_drop-support-ruby.change.md
new file mode 100644
index 000000000..473890ab8
--- /dev/null
+++ b/.hark/changes/2017-02-14_unknown_drop-support-ruby.change.md
@@ -0,0 +1,4 @@
+---
+title: Drop support for Ruby 1.9
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2017-02-14_unknown_switch-openapi-2.change.md b/.hark/changes/2017-02-14_unknown_switch-openapi-2.change.md
new file mode 100644
index 000000000..45afb50b2
--- /dev/null
+++ b/.hark/changes/2017-02-14_unknown_switch-openapi-2.change.md
@@ -0,0 +1,4 @@
+---
+title: Switch to OpenAPI 2.0 spec and generated fixtures in test suite
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2017-02-14_unknown_switch-webmock-test.change.md b/.hark/changes/2017-02-14_unknown_switch-webmock-test.change.md
new file mode 100644
index 000000000..950188323
--- /dev/null
+++ b/.hark/changes/2017-02-14_unknown_switch-webmock-test.change.md
@@ -0,0 +1,4 @@
+---
+title: Switch to Webmock in test suite
+released_in_version: 2.0.0
+---
diff --git a/.hark/changes/2017-02-22_unknown_fix-multipart-parameter.change.md b/.hark/changes/2017-02-22_unknown_fix-multipart-parameter.change.md
new file mode 100644
index 000000000..6a35adb13
--- /dev/null
+++ b/.hark/changes/2017-02-22_unknown_fix-multipart-parameter.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix multipart parameter encoding to repair broken file uploads
+released_in_version: 2.0.1
+---
diff --git a/.hark/changes/2017-03-16_unknown_fix-bad-field.change.md b/.hark/changes/2017-03-16_unknown_fix-bad-field.change.md
new file mode 100644
index 000000000..b7db93e66
--- /dev/null
+++ b/.hark/changes/2017-03-16_unknown_fix-bad-field.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix bad field reference when recovering from a JSON parsing problem
+released_in_version: 2.0.2
+---
diff --git a/.hark/changes/2017-03-16_unknown_fix-marshalling-stripeobject.change.md b/.hark/changes/2017-03-16_unknown_fix-marshalling-stripeobject.change.md
new file mode 100644
index 000000000..3db6266dd
--- /dev/null
+++ b/.hark/changes/2017-03-16_unknown_fix-marshalling-stripeobject.change.md
@@ -0,0 +1,4 @@
+---
+title: Fix marshalling of `StripeObjects` that have an embedded client
+released_in_version: 2.0.3
+---
diff --git a/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md b/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md
new file mode 100644
index 000000000..81b641793
--- /dev/null
+++ b/.hark/changes/2017-03-17_unknown_support-detaching-sources.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for detaching sources from customers
+released_in_version: 2.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 000000000..92b98c9f7
--- /dev/null
+++ b/.hark/changes/2017-04-06_unknown_add-support-payouts.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for payouts and recipient transfers
+released_in_version: 2.2.0
+---
diff --git a/.hark/changes/2017-04-07_unknown_declare-minimum-required.change.md b/.hark/changes/2017-04-07_unknown_declare-minimum-required.change.md
new file mode 100644
index 000000000..48cc1ddee
--- /dev/null
+++ b/.hark/changes/2017-04-07_unknown_declare-minimum-required.change.md
@@ -0,0 +1,4 @@
+---
+title: Declare minimum required Faraday as 0.9
+released_in_version: 2.2.1
+---
diff --git a/.hark/changes/2017-04-14_unknown_add-question-mark.change.md b/.hark/changes/2017-04-14_unknown_add-question-mark.change.md
new file mode 100644
index 000000000..dce5d0dc3
--- /dev/null
+++ b/.hark/changes/2017-04-14_unknown_add-question-mark.change.md
@@ -0,0 +1,4 @@
+---
+title: Add question mark accessor when assigning boolean value to undefined field
+released_in_version: 2.3.0
+---
diff --git a/.hark/changes/2017-04-18_unknown_add-stripe-setappinfo.change.md b/.hark/changes/2017-04-18_unknown_add-stripe-setappinfo.change.md
new file mode 100644
index 000000000..59c261d56
--- /dev/null
+++ b/.hark/changes/2017-04-18_unknown_add-stripe-setappinfo.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `Stripe.set_app_info` for use by plugin creators
+released_in_version: 2.4.0
+---
diff --git a/.hark/changes/2017-04-24_unknown_make-opts-argument.change.md b/.hark/changes/2017-04-24_unknown_make-opts-argument.change.md
new file mode 100644
index 000000000..5caaf2f81
--- /dev/null
+++ b/.hark/changes/2017-04-24_unknown_make-opts-argument.change.md
@@ -0,0 +1,4 @@
+---
+title: Make `opts` argument in `Util.convert_to_stripe_object` optional
+released_in_version: 2.5.0
+---
diff --git a/.hark/changes/2017-04-26_unknown_add-model-invoicelinei.change.md b/.hark/changes/2017-04-26_unknown_add-model-invoicelinei.change.md
new file mode 100644
index 000000000..ad4ad76fc
--- /dev/null
+++ b/.hark/changes/2017-04-26_unknown_add-model-invoicelinei.change.md
@@ -0,0 +1,4 @@
+---
+title: Add model `InvoiceLineItem`
+released_in_version: 2.7.0
+---
diff --git a/.hark/changes/2017-04-26_unknown_add-objectname-constants.change.md b/.hark/changes/2017-04-26_unknown_add-objectname-constants.change.md
new file mode 100644
index 000000000..987e3115b
--- /dev/null
+++ b/.hark/changes/2017-04-26_unknown_add-objectname-constants.change.md
@@ -0,0 +1,4 @@
+---
+title: Add `OBJECT_NAME` constants to all API resources
+released_in_version: 2.6.0
+---
diff --git a/.hark/changes/2017-04-28_unknown_support-checking-webhook.change.md b/.hark/changes/2017-04-28_unknown_support-checking-webhook.change.md
new file mode 100644
index 000000000..8370886aa
--- /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: 2.8.0
+---
diff --git a/.hark/changes/2017-05-18_unknown_support-oauth-operations.change.md b/.hark/changes/2017-05-18_unknown_support-oauth-operations.change.md
new file mode 100644
index 000000000..bf84ef346
--- /dev/null
+++ b/.hark/changes/2017-05-18_unknown_support-oauth-operations.change.md
@@ -0,0 +1,4 @@
+---
+title: Support for OAuth operations in `Stripe::OAuth`
+released_in_version: 2.9.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 000000000..5768d21ad
--- /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: 2.10.0
+---
diff --git a/.hark/changes/2017-05-26_unknown_warn-keys-look.change.md b/.hark/changes/2017-05-26_unknown_warn-keys-look.change.md
new file mode 100644
index 000000000..90a21dcbc
--- /dev/null
+++ b/.hark/changes/2017-05-26_unknown_warn-keys-look.change.md
@@ -0,0 +1,4 @@
+---
+title: Warn when keys that look like opts are included as parameters
+released_in_version: 2.11.0
+---
diff --git a/.hark/changes/2017-06-20_unknown_add-support-ephemeral.change.md b/.hark/changes/2017-06-20_unknown_add-support-ephemeral.change.md
new file mode 100644
index 000000000..ebc45dd9a
--- /dev/null
+++ b/.hark/changes/2017-06-20_unknown_add-support-ephemeral.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for ephemeral keys
+released_in_version: 2.12.0
+---
diff --git a/.hark/changes/2017-06-27_unknown_pay-invoice-now.change.md b/.hark/changes/2017-06-27_unknown_pay-invoice-now.change.md
new file mode 100644
index 000000000..4bcc9abb1
--- /dev/null
+++ b/.hark/changes/2017-06-27_unknown_pay-invoice-now.change.md
@@ -0,0 +1,4 @@
+---
+title: "`#pay` on invoice now takes params as well as opts"
+released_in_version: 3.0.0
+---
diff --git a/.hark/changes/2017-07-11_unknown_api-resources-will.change.md b/.hark/changes/2017-07-11_unknown_api-resources-will.change.md
new file mode 100644
index 000000000..b1ff9eea4
--- /dev/null
+++ b/.hark/changes/2017-07-11_unknown_api-resources-will.change.md
@@ -0,0 +1,4 @@
+---
+title: API resources will throw an ArgumentError on save if a property has been with an API resource that cannot be serialized
+released_in_version: 3.0.1
+---
diff --git a/.hark/changes/2017-07-11_unknown_properties-set-api.change.md b/.hark/changes/2017-07-11_unknown_properties-set-api.change.md
new file mode 100644
index 000000000..7ff75160f
--- /dev/null
+++ b/.hark/changes/2017-07-11_unknown_properties-set-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Properties set with an API resource will now serialize that resource's ID if possible
+released_in_version: 3.0.1
+---
diff --git a/.hark/changes/2017-07-12_unknown_convert-nil-empty.change.md b/.hark/changes/2017-07-12_unknown_convert-nil-empty.change.md
new file mode 100644
index 000000000..08d2f3ab4
--- /dev/null
+++ b/.hark/changes/2017-07-12_unknown_convert-nil-empty.change.md
@@ -0,0 +1,4 @@
+---
+title: "Convert `nil` to empty string when serializing parameters (instead of opaquely dropping it) -- NOTE: this change has since been reverted"
+released_in_version: 3.0.2
+---
diff --git a/.hark/changes/2017-07-28_unknown_handle-invalidclien-oauth.change.md b/.hark/changes/2017-07-28_unknown_handle-invalidclien-oauth.change.md
new file mode 100644
index 000000000..83be1eaaa
--- /dev/null
+++ b/.hark/changes/2017-07-28_unknown_handle-invalidclien-oauth.change.md
@@ -0,0 +1,4 @@
+---
+title: Handle `invalid_client` OAuth error code
+released_in_version: 3.0.3
+---
diff --git a/.hark/changes/2017-07-28_unknown_improve-safety-error.change.md b/.hark/changes/2017-07-28_unknown_improve-safety-error.change.md
new file mode 100644
index 000000000..dfd171e41
--- /dev/null
+++ b/.hark/changes/2017-07-28_unknown_improve-safety-error.change.md
@@ -0,0 +1,4 @@
+---
+title: Improve safety of error handling logic safer for unrecognized OAuth error codes
+released_in_version: 3.0.3
+---
diff --git a/.hark/changes/2017-07-28_unknown_revert-nil-empty.change.md b/.hark/changes/2017-07-28_unknown_revert-nil-empty.change.md
new file mode 100644
index 000000000..bb55c86d3
--- /dev/null
+++ b/.hark/changes/2017-07-28_unknown_revert-nil-empty.change.md
@@ -0,0 +1,4 @@
+---
+title: Revert `nil` to empty string coercion from 3.0.2
+released_in_version: 3.0.3
+---
diff --git a/.hark/changes/2017-08-03_unknown_add-logging-request.change.md b/.hark/changes/2017-08-03_unknown_add-logging-request.change.md
new file mode 100644
index 000000000..2dbb19b4a
--- /dev/null
+++ b/.hark/changes/2017-08-03_unknown_add-logging-request.change.md
@@ -0,0 +1,4 @@
+---
+title: Add logging for request retry account and `Stripe-Account` header
+released_in_version: 3.2.0
+---
diff --git a/.hark/changes/2017-08-03_unknown_implement-request-logging.change.md b/.hark/changes/2017-08-03_unknown_implement-request-logging.change.md
new file mode 100644
index 000000000..60d4a59cc
--- /dev/null
+++ b/.hark/changes/2017-08-03_unknown_implement-request-logging.change.md
@@ -0,0 +1,4 @@
+---
+title: Implement request logging with `Stripe.log_level` and `STRIPE_LOG`
+released_in_version: 3.1.0
+---
diff --git a/.hark/changes/2017-08-11_unknown_add-support-standard.change.md b/.hark/changes/2017-08-11_unknown_add-support-standard.change.md
new file mode 100644
index 000000000..96965cf3b
--- /dev/null
+++ b/.hark/changes/2017-08-11_unknown_add-support-standard.change.md
@@ -0,0 +1,4 @@
+---
+title: Add support for standard library logger interface with `Stripe.logger`
+released_in_version: 3.3.0
+---
diff --git a/.hark/changes/2017-08-11_unknown_error-logs-now.change.md b/.hark/changes/2017-08-11_unknown_error-logs-now.change.md
new file mode 100644
index 000000000..133b84987
--- /dev/null
+++ b/.hark/changes/2017-08-11_unknown_error-logs-now.change.md
@@ -0,0 +1,4 @@
+---
+title: Error logs now go to stderr if using `Stripe.log_level`/`STRIPE_LOG`
+released_in_version: 3.3.0
+---
diff --git a/.hark/changes/2017-08-11_unknown_stripe-loglevel-stripelog.change.md b/.hark/changes/2017-08-11_unknown_stripe-loglevel-stripelog.change.md
new file mode 100644
index 000000000..22a734e85
--- /dev/null
+++ b/.hark/changes/2017-08-11_unknown_stripe-loglevel-stripelog.change.md
@@ -0,0 +1,4 @@
+---
+title: "`Stripe.log_level`/`STRIPE_LOG` now support `Stipe::LEVEL_ERROR`"
+released_in_version: 3.3.0
+---
diff --git a/.hark/changes/2017-08-18_unknown_only-parse-webhook.change.md b/.hark/changes/2017-08-18_unknown_only-parse-webhook.change.md
new file mode 100644
index 000000000..43527ba31
--- /dev/null
+++ b/.hark/changes/2017-08-18_unknown_only-parse-webhook.change.md
@@ -0,0 +1,6 @@
+---
+title: Only parse webhook payload after verification to decrease likelihood of
+released_in_version: 3.3.1
+---
+
+attack
diff --git a/.hark/changes/2017-09-20_unknown_correct-minimum-required.change.md b/.hark/changes/2017-09-20_unknown_correct-minimum-required.change.md
new file mode 100644
index 000000000..bf533db23
--- /dev/null
+++ b/.hark/changes/2017-09-20_unknown_correct-minimum-required.change.md
@@ -0,0 +1,4 @@
+---
+title: Correct minimum required Ruby version in gemspec (it's 2.0.0)
+released_in_version: 3.3.2
+---
diff --git a/.hark/changes/2017-09-20_unknown_mark-legacy-bitcoin.change.md b/.hark/changes/2017-09-20_unknown_mark-legacy-bitcoin.change.md
new file mode 100644
index 000000000..d637d0208
--- /dev/null
+++ b/.hark/changes/2017-09-20_unknown_mark-legacy-bitcoin.change.md
@@ -0,0 +1,4 @@
+---
+title: Mark legacy Bitcoin API as deprecated, and remove corresponding tests
+released_in_version: 3.4.0
+---
diff --git a/.hark/changes/2017-09-20_unknown_mark-recipients-api.change.md b/.hark/changes/2017-09-20_unknown_mark-recipients-api.change.md
new file mode 100644
index 000000000..239deeb1e
--- /dev/null
+++ b/.hark/changes/2017-09-20_unknown_mark-recipients-api.change.md
@@ -0,0 +1,4 @@
+---
+title: Mark recipients API as deprecated, and remove recipient card tests
+released_in_version: 3.4.0
+---
diff --git a/.hark/changes/2017-09-29_brandur_log-query-strings.change.md b/.hark/changes/2017-09-29_brandur_log-query-strings.change.md
new file mode 100644
index 000000000..c77201758
--- /dev/null
+++ b/.hark/changes/2017-09-29_brandur_log-query-strings.change.md
@@ -0,0 +1,5 @@
+---
+title: Log query strings as well as form bodies with STRIPE_LOG
+pr_url: https://github.com/stripe/stripe-ruby/pull/586
+released_in_version: 3.4.1
+---
diff --git a/.hark/changes/2017-10-05_brandur_require-minimum-faraday.change.md b/.hark/changes/2017-10-05_brandur_require-minimum-faraday.change.md
new file mode 100644
index 000000000..af1f93ab3
--- /dev/null
+++ b/.hark/changes/2017-10-05_brandur_require-minimum-faraday.change.md
@@ -0,0 +1,5 @@
+---
+title: Require minimum Faraday 0.10 for bug fix in parameter encoding
+pr_url: https://github.com/stripe/stripe-ruby/pull/588
+released_in_version: 3.4.1
+---
diff --git a/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md b/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md
new file mode 100644
index 000000000..cc03052e1
--- /dev/null
+++ b/.hark/changes/2017-10-11_brandur_rename-source-delete.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename source `delete` to `detach` (and deprecate the former)
+pr_url: https://github.com/stripe/stripe-ruby/pull/589
+released_in_version: 3.5.0
+---
diff --git a/.hark/changes/2017-10-12_brandur_use-thread-local.change.md b/.hark/changes/2017-10-12_brandur_use-thread-local.change.md
new file mode 100644
index 000000000..c1e8ee950
--- /dev/null
+++ b/.hark/changes/2017-10-12_brandur_use-thread-local.change.md
@@ -0,0 +1,5 @@
+---
+title: Use thread-local `StripeClient` instances for thread safety
+pr_url: https://github.com/stripe/stripe-ruby/pull/591
+released_in_version: 3.5.1
+---
diff --git a/.hark/changes/2017-10-13_brandur_bring-back-marshal.change.md b/.hark/changes/2017-10-13_brandur_bring-back-marshal.change.md
new file mode 100644
index 000000000..6a0576767
--- /dev/null
+++ b/.hark/changes/2017-10-13_brandur_bring-back-marshal.change.md
@@ -0,0 +1,5 @@
+---
+title: Bring back `Marshal.dump/load` support with custom marshal encoder/decoder
+pr_url: https://github.com/stripe/stripe-ruby/pull/592
+released_in_version: 3.5.2
+---
diff --git a/.hark/changes/2017-10-16_brandur_allow-object-method.change.md b/.hark/changes/2017-10-16_brandur_allow-object-method.change.md
new file mode 100644
index 000000000..64ac76917
--- /dev/null
+++ b/.hark/changes/2017-10-16_brandur_allow-object-method.change.md
@@ -0,0 +1,5 @@
+---
+title: "Allow `Object#method` to be called on `StripeObject` even if it conflicts with an accessor"
+pr_url: https://github.com/stripe/stripe-ruby/pull/595
+released_in_version: 3.5.3
+---
diff --git a/.hark/changes/2017-10-16_brandur_encode-arrays-integer.change.md b/.hark/changes/2017-10-16_brandur_encode-arrays-integer.change.md
new file mode 100644
index 000000000..d43965690
--- /dev/null
+++ b/.hark/changes/2017-10-16_brandur_encode-arrays-integer.change.md
@@ -0,0 +1,5 @@
+---
+title: Encode arrays as integer-indexed hashes where appropriate
+pr_url: https://github.com/stripe/stripe-ruby/pull/596
+released_in_version: 3.5.3
+---
diff --git a/.hark/changes/2017-10-16_brandur_make-sure-stripeobject.change.md b/.hark/changes/2017-10-16_brandur_make-sure-stripeobject.change.md
new file mode 100644
index 000000000..c05dad043
--- /dev/null
+++ b/.hark/changes/2017-10-16_brandur_make-sure-stripeobject.change.md
@@ -0,0 +1,5 @@
+---
+title: "Make sure that `StripeObject`'s `#deep_copy` maintains original class"
+pr_url: https://github.com/stripe/stripe-ruby/pull/594
+released_in_version: 3.5.3
+---
diff --git a/.hark/changes/2017-10-16_unknown_don-t-persist.change.md b/.hark/changes/2017-10-16_unknown_don-t-persist.change.md
new file mode 100644
index 000000000..38032aaf6
--- /dev/null
+++ b/.hark/changes/2017-10-16_unknown_don-t-persist.change.md
@@ -0,0 +1,5 @@
+---
+title: Don't persist `idempotency_key` opt between requests
+pr_url: https://github.com/stripe/stripe-ruby/pull/598
+released_in_version: 3.5.3
+---
diff --git a/.hark/changes/2017-10-18_brandur_add-static-methods.change.md b/.hark/changes/2017-10-18_brandur_add-static-methods.change.md
new file mode 100644
index 000000000..ee58920c6
--- /dev/null
+++ b/.hark/changes/2017-10-18_brandur_add-static-methods.change.md
@@ -0,0 +1,10 @@
+---
+title: Add static methods to manipulate resources from parent
+pr_url: https://github.com/stripe/stripe-ruby/pull/597
+released_in_version: 3.6.0
+---
+
+* `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
+* `ApplicationFee` gains methods for refunds
+* `Customer` gains methods for sources
+* `Transfer` gains methods for reversals
diff --git a/.hark/changes/2017-10-26_brandur_support-listing-source.change.md b/.hark/changes/2017-10-26_brandur_support-listing-source.change.md
new file mode 100644
index 000000000..fbef65c74
--- /dev/null
+++ b/.hark/changes/2017-10-26_brandur_support-listing-source.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for listing source transactions
+pr_url: https://github.com/stripe/stripe-ruby/pull/603
+released_in_version: 3.7.0
+---
diff --git a/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md b/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md
new file mode 100644
index 000000000..288e9f28a
--- /dev/null
+++ b/.hark/changes/2017-10-31_brandur_support-exchange-rates.change.md
@@ -0,0 +1,5 @@
+---
+title: Support for exchange rates APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/606
+released_in_version: 3.8.0
+---
diff --git a/.hark/changes/2017-12-06_brandur_support-tempfile-well.change.md b/.hark/changes/2017-12-06_brandur_support-tempfile-well.change.md
new file mode 100644
index 000000000..19cfe8ca6
--- /dev/null
+++ b/.hark/changes/2017-12-06_brandur_support-tempfile-well.change.md
@@ -0,0 +1,5 @@
+---
+title: Support `Tempfile` (as well as `File`) in file uploads
+pr_url: https://github.com/stripe/stripe-ruby/pull/611
+released_in_version: 3.8.1
+---
diff --git a/.hark/changes/2017-12-07_brandur_fix-integer-indexed.change.md b/.hark/changes/2017-12-07_brandur_fix-integer-indexed.change.md
new file mode 100644
index 000000000..6da4c8fe0
--- /dev/null
+++ b/.hark/changes/2017-12-07_brandur_fix-integer-indexed.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix integer-indexed array encoding when sent as query parameter (subscription items can now be used when fetching an upcoming invoice)
+pr_url: https://github.com/stripe/stripe-ruby/pull/612
+released_in_version: 3.8.2
+---
diff --git a/.hark/changes/2017-12-08_brandur_introduce-new-idempotencye.change.md b/.hark/changes/2017-12-08_brandur_introduce-new-idempotencye.change.md
new file mode 100644
index 000000000..a1ab36e6a
--- /dev/null
+++ b/.hark/changes/2017-12-08_brandur_introduce-new-idempotencye.change.md
@@ -0,0 +1,5 @@
+---
+title: Introduce new `IdempotencyError` type for idempotency-specific failures
+pr_url: https://github.com/stripe/stripe-ruby/pull/613
+released_in_version: 3.9.0
+---
diff --git a/.hark/changes/2017-12-14_brandur_support-all-file.change.md b/.hark/changes/2017-12-14_brandur_support-all-file.change.md
new file mode 100644
index 000000000..44d153367
--- /dev/null
+++ b/.hark/changes/2017-12-14_brandur_support-all-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Support all file-like objects for uploads with duck typed checks on `path` and `read` (we previously whitelisted only certain classes)
+pr_url: https://github.com/stripe/stripe-ruby/pull/616
+released_in_version: 3.9.1
+---
diff --git a/.hark/changes/2018-02-12_ob_skip-calling-tohash.change.md b/.hark/changes/2018-02-12_ob_skip-calling-tohash.change.md
new file mode 100644
index 000000000..a8baa3082
--- /dev/null
+++ b/.hark/changes/2018-02-12_ob_skip-calling-tohash.change.md
@@ -0,0 +1,5 @@
+---
+title: Skip calling `to_hash` for `nil`
+pr_url: https://github.com/stripe/stripe-ruby/pull/625
+released_in_version: 3.9.2
+---
diff --git a/.hark/changes/2018-02-21_brandur_add-support-topups.change.md b/.hark/changes/2018-02-21_brandur_add-support-topups.change.md
new file mode 100644
index 000000000..65b24a15d
--- /dev/null
+++ b/.hark/changes/2018-02-21_brandur_add-support-topups.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for topups
+pr_url: https://github.com/stripe/stripe-ruby/pull/627
+released_in_version: 3.10.0
+---
diff --git a/.hark/changes/2018-02-26_ob_add-support-code.change.md b/.hark/changes/2018-02-26_ob_add-support-code.change.md
new file mode 100644
index 000000000..92348c4cb
--- /dev/null
+++ b/.hark/changes/2018-02-26_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-ruby/pull/628
+released_in_version: 3.11.0
+---
diff --git a/.hark/changes/2018-04-05_brandur_fix-warning-uninitialize.change.md b/.hark/changes/2018-04-05_brandur_fix-warning-uninitialize.change.md
new file mode 100644
index 000000000..ec9700942
--- /dev/null
+++ b/.hark/changes/2018-04-05_brandur_fix-warning-uninitialize.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix a warning for uninitialized instance variable `@additive_params`
+pr_url: https://github.com/stripe/stripe-ruby/pull/636
+released_in_version: 3.12.1
+---
diff --git a/.hark/changes/2018-04-05_brandur_introduce-additiveobje-non.change.md b/.hark/changes/2018-04-05_brandur_introduce-additiveobje-non.change.md
new file mode 100644
index 000000000..a9f85e72a
--- /dev/null
+++ b/.hark/changes/2018-04-05_brandur_introduce-additiveobje-non.change.md
@@ -0,0 +1,5 @@
+---
+title: Introduce `additive_object_param` so that non-`metadata` subobjects don't zero their keys as they're being replaced
+pr_url: https://github.com/stripe/stripe-ruby/pull/632
+released_in_version: 3.12.0
+---
diff --git a/.hark/changes/2018-04-11_unknown_add-support-flexible.change.md b/.hark/changes/2018-04-11_unknown_add-support-flexible.change.md
new file mode 100644
index 000000000..3382c1d55
--- /dev/null
+++ b/.hark/changes/2018-04-11_unknown_add-support-flexible.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for flexible billing primitives
+pr_url: https://github.com/stripe/stripe-ruby/pull/498
+released_in_version: 3.13.0
+---
diff --git a/.hark/changes/2018-05-07_brandur_merge-query-parameters.change.md b/.hark/changes/2018-05-07_brandur_merge-query-parameters.change.md
new file mode 100644
index 000000000..91d8da998
--- /dev/null
+++ b/.hark/changes/2018-05-07_brandur_merge-query-parameters.change.md
@@ -0,0 +1,5 @@
+---
+title: Merge query parameters coming from path with `params` argument
+pr_url: https://github.com/stripe/stripe-ruby/pull/647
+released_in_version: 3.13.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 000000000..fc3d542ff
--- /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-ruby/pull/645
+released_in_version: 3.14.0
+---
diff --git a/.hark/changes/2018-05-10_brandur_freeze-all-string.change.md b/.hark/changes/2018-05-10_brandur_freeze-all-string.change.md
new file mode 100644
index 000000000..3d81f1e5d
--- /dev/null
+++ b/.hark/changes/2018-05-10_brandur_freeze-all-string.change.md
@@ -0,0 +1,5 @@
+---
+title: Freeze all string literals
+pr_url: https://github.com/stripe/stripe-ruby/pull/649
+released_in_version: 3.15.0
+---
diff --git a/.hark/changes/2018-06-28_brandur_add-support-partnerid.change.md b/.hark/changes/2018-06-28_brandur_add-support-partnerid.change.md
new file mode 100644
index 000000000..8e354b73d
--- /dev/null
+++ b/.hark/changes/2018-06-28_brandur_add-support-partnerid.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `partner_id` from `Stripe.set_app_info`
+pr_url: https://github.com/stripe/stripe-ruby/pull/658
+released_in_version: 3.17.0
+---
diff --git a/.hark/changes/2018-06-28_ob_add-support-payment.change.md b/.hark/changes/2018-06-28_ob_add-support-payment.change.md
new file mode 100644
index 000000000..8df3f8815
--- /dev/null
+++ b/.hark/changes/2018-06-28_ob_add-support-payment.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for payment intents
+pr_url: https://github.com/stripe/stripe-ruby/pull/657
+released_in_version: 3.16.0
+---
diff --git a/.hark/changes/2018-07-19_brandur_don-t-colorize.change.md b/.hark/changes/2018-07-19_brandur_don-t-colorize.change.md
new file mode 100644
index 000000000..a63cd923c
--- /dev/null
+++ b/.hark/changes/2018-07-19_brandur_don-t-colorize.change.md
@@ -0,0 +1,5 @@
+---
+title: Don't colorize log output being sent to a configured logger
+pr_url: https://github.com/stripe/stripe-ruby/pull/664
+released_in_version: 3.17.2
+---
diff --git a/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md b/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md
new file mode 100644
index 000000000..a7b23f5dc
--- /dev/null
+++ b/.hark/changes/2018-07-19_ob_internal-improvements-apiresource.change.md
@@ -0,0 +1,5 @@
+---
+title: Internal improvements to `ApiResource.class_url`
+pr_url: https://github.com/stripe/stripe-ruby/pull/663
+released_in_version: 3.17.1
+---
diff --git a/.hark/changes/2018-07-26_brandur_add-support-stripe.change.md b/.hark/changes/2018-07-26_brandur_add-support-stripe.change.md
new file mode 100644
index 000000000..343720de9
--- /dev/null
+++ b/.hark/changes/2018-07-26_brandur_add-support-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Stripe Issuing
+pr_url: https://github.com/stripe/stripe-ruby/pull/665
+released_in_version: 3.18.0
+---
diff --git a/.hark/changes/2018-07-28_brandur_add-support-scheduled.change.md b/.hark/changes/2018-07-28_brandur_add-support-scheduled.change.md
new file mode 100644
index 000000000..13a31e704
--- /dev/null
+++ b/.hark/changes/2018-07-28_brandur_add-support-scheduled.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for scheduled query runs (`Stripe::Sigma::ScheduledQueryRun`) for Sigma
+pr_url: https://github.com/stripe/stripe-ruby/pull/666
+released_in_version: 3.19.0
+---
diff --git a/.hark/changes/2018-08-03_ob_add-cancel-support.change.md b/.hark/changes/2018-08-03_ob_add-cancel-support.change.md
new file mode 100644
index 000000000..b01da05e1
--- /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-ruby/pull/671
+released_in_version: 3.21.0
+---
diff --git a/.hark/changes/2018-08-03_ob_add-support-file.change.md b/.hark/changes/2018-08-03_ob_add-support-file.change.md
new file mode 100644
index 000000000..d67adbacc
--- /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-ruby/pull/669
+released_in_version: 3.20.0
+---
diff --git a/.hark/changes/2018-08-15_brandur_use-integer-indexed.change.md b/.hark/changes/2018-08-15_brandur_use-integer-indexed.change.md
new file mode 100644
index 000000000..a650c7ac7
--- /dev/null
+++ b/.hark/changes/2018-08-15_brandur_use-integer-indexed.change.md
@@ -0,0 +1,5 @@
+---
+title: Use integer-indexed encoding for all arrays
+pr_url: https://github.com/stripe/stripe-ruby/pull/674
+released_in_version: 3.22.0
+---
diff --git a/.hark/changes/2018-08-23_ob_add-support-usage.change.md b/.hark/changes/2018-08-23_ob_add-support-usage.change.md
new file mode 100644
index 000000000..c6789a85c
--- /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-ruby/pull/676
+released_in_version: 3.23.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 000000000..79411fedb
--- /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-ruby/pull/675
+released_in_version: 3.24.0
+---
diff --git a/.hark/changes/2018-08-28_brandur_allow-payment-intent.change.md b/.hark/changes/2018-08-28_brandur_allow-payment-intent.change.md
new file mode 100644
index 000000000..9550b44e5
--- /dev/null
+++ b/.hark/changes/2018-08-28_brandur_allow-payment-intent.change.md
@@ -0,0 +1,5 @@
+---
+title: "Allow payment intent `#cancel`, `#capture`, and `#confirm` to take their own parameters"
+pr_url: https://github.com/stripe/stripe-ruby/pull/678
+released_in_version: 3.25.0
+---
diff --git a/.hark/changes/2018-09-05_brandur_add-support-reporting.change.md b/.hark/changes/2018-09-05_brandur_add-support-reporting.change.md
new file mode 100644
index 000000000..e728caf7b
--- /dev/null
+++ b/.hark/changes/2018-09-05_brandur_add-support-reporting.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for reporting resources
+pr_url: https://github.com/stripe/stripe-ruby/pull/681
+released_in_version: 3.26.0
+---
diff --git a/.hark/changes/2018-09-14_ob_fix-hash-equality.change.md b/.hark/changes/2018-09-14_ob_fix-hash-equality.change.md
new file mode 100644
index 000000000..0b809bcd6
--- /dev/null
+++ b/.hark/changes/2018-09-14_ob_fix-hash-equality.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix hash equality on `StripeObject`
+pr_url: https://github.com/stripe/stripe-ruby/pull/688
+released_in_version: 3.26.1
+---
diff --git a/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md b/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md
new file mode 100644
index 000000000..2effb0828
--- /dev/null
+++ b/.hark/changes/2018-09-24_brandur_add-support-stripe.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Stripe Terminal
+pr_url: https://github.com/stripe/stripe-ruby/pull/690
+released_in_version: 3.28.0
+---
diff --git a/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md b/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md
new file mode 100644
index 000000000..2511d3285
--- /dev/null
+++ b/.hark/changes/2018-09-24_ob_rename-fileupload-file.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `FileUpload` to `File`
+pr_url: https://github.com/stripe/stripe-ruby/pull/689
+released_in_version: 3.27.0
+---
diff --git a/.hark/changes/2018-10-30_remi_add-support-person.change.md b/.hark/changes/2018-10-30_remi_add-support-person.change.md
new file mode 100644
index 000000000..4b5156407
--- /dev/null
+++ b/.hark/changes/2018-10-30_remi_add-support-person.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `Person` resource
+pr_url: https://github.com/stripe/stripe-ruby/pull/692
+released_in_version: 3.29.0
+---
diff --git a/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md b/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md
new file mode 100644
index 000000000..a9cc55c9c
--- /dev/null
+++ b/.hark/changes/2018-10-30_remi_add-support-webhookendpo.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `WebhookEndpoint` resource
+pr_url: https://github.com/stripe/stripe-ruby/pull/694
+released_in_version: 3.29.0
+---
diff --git a/.hark/changes/2018-11-09_remi_add-new-api.change.md b/.hark/changes/2018-11-09_remi_add-new-api.change.md
new file mode 100644
index 000000000..2a5f9259d
--- /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-ruby/pull/693
+released_in_version: 3.30.0
+---
diff --git a/.hark/changes/2018-11-12_brandur_add-configurable-telemetry.change.md b/.hark/changes/2018-11-12_brandur_add-configurable-telemetry.change.md
new file mode 100644
index 000000000..a96cbea17
--- /dev/null
+++ b/.hark/changes/2018-11-12_brandur_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-ruby/pull/696
+released_in_version: 3.31.0
+---
diff --git a/.hark/changes/2018-11-13_brandur_send-telemetry-milliseconds.change.md b/.hark/changes/2018-11-13_brandur_send-telemetry-milliseconds.change.md
new file mode 100644
index 000000000..0b50bdd3d
--- /dev/null
+++ b/.hark/changes/2018-11-13_brandur_send-telemetry-milliseconds.change.md
@@ -0,0 +1,5 @@
+---
+title: Send telemetry in milliseconds specifically
+pr_url: https://github.com/stripe/stripe-ruby/pull/697
+released_in_version: 3.31.1
+---
diff --git a/.hark/changes/2018-11-15_brandur_drop-support-ruby.change.md b/.hark/changes/2018-11-15_brandur_drop-support-ruby.change.md
new file mode 100644
index 000000000..5e430e161
--- /dev/null
+++ b/.hark/changes/2018-11-15_brandur_drop-support-ruby.change.md
@@ -0,0 +1,5 @@
+---
+title: Drop support for Ruby 2.0 (which we consider a breaking change here)
+pr_url: https://github.com/stripe/stripe-ruby/pull/698
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2018-11-15_brandur_only-send-telemetry.change.md b/.hark/changes/2018-11-15_brandur_only-send-telemetry.change.md
new file mode 100644
index 000000000..0d239151e
--- /dev/null
+++ b/.hark/changes/2018-11-15_brandur_only-send-telemetry.change.md
@@ -0,0 +1,5 @@
+---
+title: Only send telemetry if `Request-Id` was present in the response
+pr_url: https://github.com/stripe/stripe-ruby/pull/699
+released_in_version: 4.0.1
+---
diff --git a/.hark/changes/2018-11-15_brandur_use-persistent-connections.change.md b/.hark/changes/2018-11-15_brandur_use-persistent-connections.change.md
new file mode 100644
index 000000000..02727fa5b
--- /dev/null
+++ b/.hark/changes/2018-11-15_brandur_use-persistent-connections.change.md
@@ -0,0 +1,5 @@
+---
+title: Use persistent connections by default through `Net::HTTP::Persistent`
+pr_url: https://github.com/stripe/stripe-ruby/pull/698
+released_in_version: 4.0.0
+---
diff --git a/.hark/changes/2018-11-16_ob_require-minimum-faraday.change.md b/.hark/changes/2018-11-16_ob_require-minimum-faraday.change.md
new file mode 100644
index 000000000..b4acbb83e
--- /dev/null
+++ b/.hark/changes/2018-11-16_ob_require-minimum-faraday.change.md
@@ -0,0 +1,5 @@
+---
+title: Require minimum Faraday 0.13 for proper support of persistent connections
+pr_url: https://github.com/stripe/stripe-ruby/pull/701
+released_in_version: 4.0.2
+---
diff --git a/.hark/changes/2018-11-19_brandur_don-t-use.change.md b/.hark/changes/2018-11-19_brandur_don-t-use.change.md
new file mode 100644
index 000000000..a4d37ff64
--- /dev/null
+++ b/.hark/changes/2018-11-19_brandur_don-t-use.change.md
@@ -0,0 +1,5 @@
+---
+title: Don't use `Net::HTTP::Persistent` on Windows where it's not well supported
+pr_url: https://github.com/stripe/stripe-ruby/pull/703
+released_in_version: 4.0.3
+---
diff --git a/.hark/changes/2018-11-27_ob_add-support-valuelist.change.md b/.hark/changes/2018-11-27_ob_add-support-valuelist.change.md
new file mode 100644
index 000000000..9101ed85e
--- /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-ruby/pull/695
+released_in_version: 4.1.0
+---
diff --git a/.hark/changes/2018-11-28_remi_add-support-review.change.md b/.hark/changes/2018-11-28_remi_add-support-review.change.md
new file mode 100644
index 000000000..96e2ce6ad
--- /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-ruby/pull/705
+released_in_version: 4.2.0
+---
diff --git a/.hark/changes/2018-12-11_ob_add-support-account.change.md b/.hark/changes/2018-12-11_ob_add-support-account.change.md
new file mode 100644
index 000000000..7ec415745
--- /dev/null
+++ b/.hark/changes/2018-12-11_ob_add-support-account.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for account links
+pr_url: https://github.com/stripe/stripe-ruby/pull/711
+released_in_version: 4.3.0
+---
diff --git a/.hark/changes/2018-12-21_remi_add-support-checkoutsess.change.md b/.hark/changes/2018-12-21_remi_add-support-checkoutsess.change.md
new file mode 100644
index 000000000..c7cb349ca
--- /dev/null
+++ b/.hark/changes/2018-12-21_remi_add-support-checkoutsess.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `CheckoutSession` resource
+pr_url: https://github.com/stripe/stripe-ruby/pull/716
+released_in_version: 4.4.0
+---
diff --git a/.hark/changes/2018-12-31_brandur_fix-error-message.change.md b/.hark/changes/2018-12-31_brandur_fix-error-message.change.md
new file mode 100644
index 000000000..89a3c2d1c
--- /dev/null
+++ b/.hark/changes/2018-12-31_brandur_fix-error-message.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix an error message typo
+pr_url: https://github.com/stripe/stripe-ruby/pull/718
+released_in_version: 4.4.1
+---
diff --git a/.hark/changes/2019-01-02_brandur_generate-oauth-authorize.change.md b/.hark/changes/2019-01-02_brandur_generate-oauth-authorize.change.md
new file mode 100644
index 000000000..549b5cb25
--- /dev/null
+++ b/.hark/changes/2019-01-02_brandur_generate-oauth-authorize.change.md
@@ -0,0 +1,5 @@
+---
+title: Generate OAuth authorize URLs for Express accounts as well as standard
+pr_url: https://github.com/stripe/stripe-ruby/pull/719
+released_in_version: 4.5.0
+---
diff --git a/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md b/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md
new file mode 100644
index 000000000..22e259094
--- /dev/null
+++ b/.hark/changes/2019-01-21_ob_properly-serialize-individual.change.md
@@ -0,0 +1,5 @@
+---
+title: Properly serialize `individual` on `Account` objects
+pr_url: https://github.com/stripe/stripe-ruby/pull/736
+released_in_version: 4.6.0
+---
diff --git a/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md b/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md
new file mode 100644
index 000000000..7a8711b5e
--- /dev/null
+++ b/.hark/changes/2019-01-23_remi_rename-checkoutsess-session.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `CheckoutSession` to `Session` and move it under the `Checkout` namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.
+pr_url: https://github.com/stripe/stripe-ruby/pull/735
+released_in_version: 4.7.0
+---
diff --git a/.hark/changes/2019-02-01_brandur_fix-query-encoding.change.md b/.hark/changes/2019-02-01_brandur_fix-query-encoding.change.md
new file mode 100644
index 000000000..364985275
--- /dev/null
+++ b/.hark/changes/2019-02-01_brandur_fix-query-encoding.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix query encoding for integer-indexed maps
+pr_url: https://github.com/stripe/stripe-ruby/pull/740
+released_in_version: 4.7.1
+---
diff --git a/.hark/changes/2019-02-03_brandur_use-faradaystrip-encode.change.md b/.hark/changes/2019-02-03_brandur_use-faradaystrip-encode.change.md
new file mode 100644
index 000000000..3949212de
--- /dev/null
+++ b/.hark/changes/2019-02-03_brandur_use-faradaystrip-encode.change.md
@@ -0,0 +1,5 @@
+---
+title: Use `FaradayStripeEncoder` to encode all parameter styles
+pr_url: https://github.com/stripe/stripe-ruby/pull/741
+released_in_version: 4.8.0
+---
diff --git a/.hark/changes/2019-02-11_brandur_fix-bug-file.change.md b/.hark/changes/2019-02-11_brandur_fix-bug-file.change.md
new file mode 100644
index 000000000..c30476b4c
--- /dev/null
+++ b/.hark/changes/2019-02-11_brandur_fix-bug-file.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix bug in file uploading introduced in #741"
+pr_url: https://github.com/stripe/stripe-ruby/pull/743
+released_in_version: 4.8.1
+---
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 000000000..d7ea356c8
--- /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`
+pr_url: https://github.com/stripe/stripe-ruby/pull/739
+released_in_version: 4.9.0
+---
diff --git a/.hark/changes/2019-03-18_brandur_catch-error-warn.change.md b/.hark/changes/2019-03-18_brandur_catch-error-warn.change.md
new file mode 100644
index 000000000..7da141f66
--- /dev/null
+++ b/.hark/changes/2019-03-18_brandur_catch-error-warn.change.md
@@ -0,0 +1,5 @@
+---
+title: Catch error and warn if unable to remove a method
+pr_url: https://github.com/stripe/stripe-ruby/pull/750
+released_in_version: 4.9.1
+---
diff --git a/.hark/changes/2019-03-18_remi_add-support-deleting.change.md b/.hark/changes/2019-03-18_remi_add-support-deleting.change.md
new file mode 100644
index 000000000..3ebecf67d
--- /dev/null
+++ b/.hark/changes/2019-03-18_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-ruby/pull/748
+released_in_version: 4.10.0
+---
diff --git a/.hark/changes/2019-03-18_remi_add-support-paymentmetho.change.md b/.hark/changes/2019-03-18_remi_add-support-paymentmetho.change.md
new file mode 100644
index 000000000..3dbe9fe97
--- /dev/null
+++ b/.hark/changes/2019-03-18_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-ruby/pull/745
+released_in_version: 4.10.0
+---
diff --git a/.hark/changes/2019-03-18_remi_add-support-retrieving.change.md b/.hark/changes/2019-03-18_remi_add-support-retrieving.change.md
new file mode 100644
index 000000000..898a3bc37
--- /dev/null
+++ b/.hark/changes/2019-03-18_remi_add-support-retrieving.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for retrieving a Checkout `Session`
+pr_url: https://github.com/stripe/stripe-ruby/pull/747
+released_in_version: 4.10.0
+---
diff --git a/.hark/changes/2019-03-26_ob_add-global-proxy.change.md b/.hark/changes/2019-03-26_ob_add-global-proxy.change.md
new file mode 100644
index 000000000..a3accd9f0
--- /dev/null
+++ b/.hark/changes/2019-03-26_ob_add-global-proxy.change.md
@@ -0,0 +1,5 @@
+---
+title: Add a global proxy configuration parameter
+pr_url: https://github.com/stripe/stripe-ruby/pull/753
+released_in_version: 4.11.0
+---
diff --git a/.hark/changes/2019-04-02_ob_add-class-methods.change.md b/.hark/changes/2019-04-02_ob_add-class-methods.change.md
new file mode 100644
index 000000000..1b345b2d2
--- /dev/null
+++ b/.hark/changes/2019-04-02_ob_add-class-methods.change.md
@@ -0,0 +1,5 @@
+---
+title: Add class methods for all custom API requests (e.g. `Charge.capture`)
+pr_url: https://github.com/stripe/stripe-ruby/pull/754
+released_in_version: 4.12.0
+---
diff --git a/.hark/changes/2019-04-02_ob_add-delete-class.change.md b/.hark/changes/2019-04-02_ob_add-delete-class.change.md
new file mode 100644
index 000000000..3e4a04841
--- /dev/null
+++ b/.hark/changes/2019-04-02_ob_add-delete-class.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `.delete` class method on deletable API resources
+pr_url: https://github.com/stripe/stripe-ruby/pull/752
+released_in_version: 4.12.0
+---
diff --git a/.hark/changes/2019-04-16_brandur_relax-constraints-objects.change.md b/.hark/changes/2019-04-16_brandur_relax-constraints-objects.change.md
new file mode 100644
index 000000000..63069ba94
--- /dev/null
+++ b/.hark/changes/2019-04-16_brandur_relax-constraints-objects.change.md
@@ -0,0 +1,5 @@
+---
+title: "Relax constraints on objects that we'll accept as a file (now they just need to respond to `#read`)"
+pr_url: https://github.com/stripe/stripe-ruby/pull/766
+released_in_version: 4.13.0
+---
diff --git a/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md b/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md
new file mode 100644
index 000000000..f9750e7bb
--- /dev/null
+++ b/.hark/changes/2019-04-18_remi_add-support-creditnote.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `CreditNote` resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/758
+released_in_version: 4.14.0
+---
diff --git a/.hark/changes/2019-04-22_remi_add-support-taxid.change.md b/.hark/changes/2019-04-22_remi_add-support-taxid.change.md
new file mode 100644
index 000000000..c79bd1589
--- /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-ruby/pull/762
+released_in_version: 4.15.0
+---
diff --git a/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md b/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md
new file mode 100644
index 000000000..6ba2cb5d1
--- /dev/null
+++ b/.hark/changes/2019-04-24_remi_add-support-taxrate.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `TaxRate` resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/760
+released_in_version: 4.16.0
+---
diff --git a/.hark/changes/2019-05-14_ob_add-support-capability.change.md b/.hark/changes/2019-05-14_ob_add-support-capability.change.md
new file mode 100644
index 000000000..19c2dc233
--- /dev/null
+++ b/.hark/changes/2019-05-14_ob_add-support-capability.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Capability resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/779
+released_in_version: 4.17.0
+---
diff --git a/.hark/changes/2019-05-24_ob_add-support-radar.change.md b/.hark/changes/2019-05-24_ob_add-support-radar.change.md
new file mode 100644
index 000000000..33f397980
--- /dev/null
+++ b/.hark/changes/2019-05-24_ob_add-support-radar.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `radar.early_fraud_warning` resource
+pr_url: https://github.com/stripe/stripe-ruby/pull/783
+released_in_version: 4.18.0
+---
diff --git a/.hark/changes/2019-05-28_ob_allow-order-pay.change.md b/.hark/changes/2019-05-28_ob_allow-order-pay.change.md
new file mode 100644
index 000000000..ce86729ec
--- /dev/null
+++ b/.hark/changes/2019-05-28_ob_allow-order-pay.change.md
@@ -0,0 +1,5 @@
+---
+title: "Allow `Order#pay` to be called without arguments"
+pr_url: https://github.com/stripe/stripe-ruby/pull/789
+released_in_version: 4.18.1
+---
diff --git a/.hark/changes/2019-06-17_remi_add-support-customerbala.change.md b/.hark/changes/2019-06-17_remi_add-support-customerbala.change.md
new file mode 100644
index 000000000..a50a28d8d
--- /dev/null
+++ b/.hark/changes/2019-06-17_remi_add-support-customerbala.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CustomerBalanceTransaction` resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/770
+released_in_version: 4.19.0
+---
diff --git a/.hark/changes/2019-06-25_ob_enable-request-latency.change.md b/.hark/changes/2019-06-25_ob_enable-request-latency.change.md
new file mode 100644
index 000000000..9e3a07f48
--- /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-ruby/pull/800
+released_in_version: 4.20.0
+---
diff --git a/.hark/changes/2019-06-28_brandur_fix-formatting-connectionfa.change.md b/.hark/changes/2019-06-28_brandur_fix-formatting-connectionfa.change.md
new file mode 100644
index 000000000..210bc2199
--- /dev/null
+++ b/.hark/changes/2019-06-28_brandur_fix-formatting-connectionfa.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix formatting in `ConnectionFailed` error message
+pr_url: https://github.com/stripe/stripe-ruby/pull/805
+released_in_version: 4.20.1
+---
diff --git a/.hark/changes/2019-06-28_remi_add-support-setupintent.change.md b/.hark/changes/2019-06-28_remi_add-support-setupintent.change.md
new file mode 100644
index 000000000..6df7c0a99
--- /dev/null
+++ b/.hark/changes/2019-06-28_remi_add-support-setupintent.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `SetupIntent` resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/803
+released_in_version: 4.21.0
+---
diff --git a/.hark/changes/2019-07-04_ob_add-gem-metadata.change.md b/.hark/changes/2019-07-04_ob_add-gem-metadata.change.md
new file mode 100644
index 000000000..9770ad24b
--- /dev/null
+++ b/.hark/changes/2019-07-04_ob_add-gem-metadata.change.md
@@ -0,0 +1,5 @@
+---
+title: Add gem metadata
+pr_url: https://github.com/stripe/stripe-ruby/pull/807
+released_in_version: 4.21.1
+---
diff --git a/.hark/changes/2019-07-05_brandur_revert-back-initializefr.change.md b/.hark/changes/2019-07-05_brandur_revert-back-initializefr.change.md
new file mode 100644
index 000000000..39c175bf5
--- /dev/null
+++ b/.hark/changes/2019-07-05_brandur_revert-back-initializefr.change.md
@@ -0,0 +1,5 @@
+---
+title: Revert back to `initialize_from` from `Util.convert_to_stripe_object`
+pr_url: https://github.com/stripe/stripe-ruby/pull/806
+released_in_version: 4.21.2
+---
diff --git a/.hark/changes/2019-07-16_brandur_better-error-message.change.md b/.hark/changes/2019-07-16_brandur_better-error-message.change.md
new file mode 100644
index 000000000..bc87bce4c
--- /dev/null
+++ b/.hark/changes/2019-07-16_brandur_better-error-message.change.md
@@ -0,0 +1,5 @@
+---
+title: Better error message when passing non-string to custom method
+pr_url: https://github.com/stripe/stripe-ruby/pull/810
+released_in_version: 4.21.3
+---
diff --git a/.hark/changes/2019-07-29_brandur_convert-library-use.change.md b/.hark/changes/2019-07-29_brandur_convert-library-use.change.md
new file mode 100644
index 000000000..8c9562d21
--- /dev/null
+++ b/.hark/changes/2019-07-29_brandur_convert-library-use.change.md
@@ -0,0 +1,6 @@
+---
+title: Convert library to use built-in `Net::HTTP`
+pr_url: https://github.com/stripe/stripe-ruby/pull/813
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-07-29_brandur_drop-support-very.change.md b/.hark/changes/2019-07-29_brandur_drop-support-very.change.md
new file mode 100644
index 000000000..d9f49a2d3
--- /dev/null
+++ b/.hark/changes/2019-07-29_brandur_drop-support-very.change.md
@@ -0,0 +1,6 @@
+---
+title: Drop support for very old Ruby versions.
+pr_url: https://github.com/stripe/stripe-ruby/pull/817
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-07-30_ob_bump-rubocop-latest.change.md b/.hark/changes/2019-07-30_ob_bump-rubocop-latest.change.md
new file mode 100644
index 000000000..113974379
--- /dev/null
+++ b/.hark/changes/2019-07-30_ob_bump-rubocop-latest.change.md
@@ -0,0 +1,5 @@
+---
+title: Bump Rubocop to latest version
+pr_url: https://github.com/stripe/stripe-ruby/pull/818
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-07-30_ob_make-code-argument.change.md b/.hark/changes/2019-07-30_ob_make-code-argument.change.md
new file mode 100644
index 000000000..2bd9605bf
--- /dev/null
+++ b/.hark/changes/2019-07-30_ob_make-code-argument.change.md
@@ -0,0 +1,6 @@
+---
+title: Make `code` argument in `CardError` named instead of positional.
+pr_url: https://github.com/stripe/stripe-ruby/pull/816
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-07-30_ob_ruby-minimum-version.change.md b/.hark/changes/2019-07-30_ob_ruby-minimum-version.change.md
new file mode 100644
index 000000000..2e1d63320
--- /dev/null
+++ b/.hark/changes/2019-07-30_ob_ruby-minimum-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Ruby minimum version increase followup
+pr_url: https://github.com/stripe/stripe-ruby/pull/819
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md b/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md
new file mode 100644
index 000000000..0647ef30a
--- /dev/null
+++ b/.hark/changes/2019-07-30_remi_listing-balancetrans-objects.change.md
@@ -0,0 +1,5 @@
+---
+title: Listing `BalanceTransaction` objects now uses `/v1/balance_transactions` instead of `/v1/balance/history`
+pr_url: https://github.com/stripe/stripe-ruby/pull/821
+released_in_version: 4.22.0
+---
diff --git a/.hark/changes/2019-08-07_ob_remove-all-alias.change.md b/.hark/changes/2019-08-07_ob_remove-all-alias.change.md
new file mode 100644
index 000000000..3b78d09f5
--- /dev/null
+++ b/.hark/changes/2019-08-07_ob_remove-all-alias.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove all alias for list methods
+pr_url: https://github.com/stripe/stripe-ruby/pull/823
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-07_ob_remove-old-deprecated.change.md b/.hark/changes/2019-08-07_ob_remove-old-deprecated.change.md
new file mode 100644
index 000000000..69acdd8f8
--- /dev/null
+++ b/.hark/changes/2019-08-07_ob_remove-old-deprecated.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove old deprecated methods
+pr_url: https://github.com/stripe/stripe-ruby/pull/820
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-08_rattrayalex_unify-request-response.change.md b/.hark/changes/2019-08-08_rattrayalex_unify-request-response.change.md
new file mode 100644
index 000000000..249a11e14
--- /dev/null
+++ b/.hark/changes/2019-08-08_rattrayalex_unify-request-response.change.md
@@ -0,0 +1,5 @@
+---
+title: Unify request/response handling
+pr_url: https://github.com/stripe/stripe-ruby/pull/808
+released_in_version: 4.22.1
+---
diff --git a/.hark/changes/2019-08-09_rattrayalex_remove-subscription.change.md b/.hark/changes/2019-08-09_rattrayalex_remove-subscription.change.md
new file mode 100644
index 000000000..ac4060e6d
--- /dev/null
+++ b/.hark/changes/2019-08-09_rattrayalex_remove-subscription.change.md
@@ -0,0 +1,7 @@
+---
+title: Remove SubscriptionScheduleRevision
+pr_url: https://github.com/stripe/stripe-ruby/pull/824
+released_in_version: 4.23.0
+---
+
+- This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
diff --git a/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md b/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md
new file mode 100644
index 000000000..20f389ec2
--- /dev/null
+++ b/.hark/changes/2019-08-13_ob_add-subscription-createusager.change.md
@@ -0,0 +1,7 @@
+---
+title: Add `SubscriptionItem.create_usage_record` method
+pr_url: https://github.com/stripe/stripe-ruby/pull/825
+released_in_version: 4.24.0
+---
+
+- This release also removed the `SubscriptionSchedule.revisions` method. This should have been included in the previous release (4.23.0)
diff --git a/.hark/changes/2019-08-13_ob_remove-usagerecord-create.change.md b/.hark/changes/2019-08-13_ob_remove-usagerecord-create.change.md
new file mode 100644
index 000000000..8895b9a63
--- /dev/null
+++ b/.hark/changes/2019-08-13_ob_remove-usagerecord-create.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `UsageRecord.create` method
+pr_url: https://github.com/stripe/stripe-ruby/pull/826
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-15_ob_remove-issuerfraudr.change.md b/.hark/changes/2019-08-15_ob_remove-issuerfraudr.change.md
new file mode 100644
index 000000000..d653eee1b
--- /dev/null
+++ b/.hark/changes/2019-08-15_ob_remove-issuerfraudr.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `IssuerFraudRecord`
+pr_url: https://github.com/stripe/stripe-ruby/pull/827
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-16_brandur_tweak-retry-logic.change.md b/.hark/changes/2019-08-16_brandur_tweak-retry-logic.change.md
new file mode 100644
index 000000000..00e40da49
--- /dev/null
+++ b/.hark/changes/2019-08-16_brandur_tweak-retry-logic.change.md
@@ -0,0 +1,5 @@
+---
+title: Tweak retry logic to be a little more like stripe-node
+pr_url: https://github.com/stripe/stripe-ruby/pull/828
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-16_ob_add-errorobject-stripeerror.change.md b/.hark/changes/2019-08-16_ob_add-errorobject-stripeerror.change.md
new file mode 100644
index 000000000..01da5849a
--- /dev/null
+++ b/.hark/changes/2019-08-16_ob_add-errorobject-stripeerror.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `ErrorObject` to `StripeError` exceptions
+pr_url: https://github.com/stripe/stripe-ruby/pull/811
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-17_brandur_fix-inverted-sign.change.md b/.hark/changes/2019-08-17_brandur_fix-inverted-sign.change.md
new file mode 100644
index 000000000..a33546d35
--- /dev/null
+++ b/.hark/changes/2019-08-17_brandur_fix-inverted-sign.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix inverted sign for 500 retries
+pr_url: https://github.com/stripe/stripe-ruby/pull/830
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-17_brandur_remove-few-more.change.md b/.hark/changes/2019-08-17_brandur_remove-few-more.change.md
new file mode 100644
index 000000000..e54407ed4
--- /dev/null
+++ b/.hark/changes/2019-08-17_brandur_remove-few-more.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove a few more very old deprecated methods
+pr_url: https://github.com/stripe/stripe-ruby/pull/831
+semver_level: major
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-19_brandur_minor-cleanup-stripeclient.change.md b/.hark/changes/2019-08-19_brandur_minor-cleanup-stripeclient.change.md
new file mode 100644
index 000000000..627e483e1
--- /dev/null
+++ b/.hark/changes/2019-08-19_brandur_minor-cleanup-stripeclient.change.md
@@ -0,0 +1,5 @@
+---
+title: Minor cleanup in `StripeClient`
+pr_url: https://github.com/stripe/stripe-ruby/pull/832
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-19_brandur_reset-connections-connection.change.md b/.hark/changes/2019-08-19_brandur_reset-connections-connection.change.md
new file mode 100644
index 000000000..9d87f0107
--- /dev/null
+++ b/.hark/changes/2019-08-19_brandur_reset-connections-connection.change.md
@@ -0,0 +1,5 @@
+---
+title: Reset connections when connection-changing configuration changes (optional)
+pr_url: https://github.com/stripe/stripe-ruby/pull/829
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-20_brandur_do-better-bookkeeping.change.md b/.hark/changes/2019-08-20_brandur_do-better-bookkeeping.change.md
new file mode 100644
index 000000000..ff0fceb19
--- /dev/null
+++ b/.hark/changes/2019-08-20_brandur_do-better-bookkeeping.change.md
@@ -0,0 +1,5 @@
+---
+title: Do better bookkeeping when tracking state in `Thread.current`
+pr_url: https://github.com/stripe/stripe-ruby/pull/833
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-20_brandur_increase-connection-keep.change.md b/.hark/changes/2019-08-20_brandur_increase-connection-keep.change.md
new file mode 100644
index 000000000..b074dac48
--- /dev/null
+++ b/.hark/changes/2019-08-20_brandur_increase-connection-keep.change.md
@@ -0,0 +1,5 @@
+---
+title: Increase connection keep alive timeout to 30 seconds
+pr_url: https://github.com/stripe/stripe-ruby/pull/836
+released_in_version: 5.0.1
+---
diff --git a/.hark/changes/2019-08-20_ob_add-invoice-listupcoming.change.md b/.hark/changes/2019-08-20_ob_add-invoice-listupcoming.change.md
new file mode 100644
index 000000000..43a59666a
--- /dev/null
+++ b/.hark/changes/2019-08-20_ob_add-invoice-listupcoming.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `Invoice.list_upcoming_line_items` method
+pr_url: https://github.com/stripe/stripe-ruby/pull/834
+released_in_version: 5.0.0
+---
diff --git a/.hark/changes/2019-08-27_brandur_retry-requests-429.change.md b/.hark/changes/2019-08-27_brandur_retry-requests-429.change.md
new file mode 100644
index 000000000..0c944ae0c
--- /dev/null
+++ b/.hark/changes/2019-08-27_brandur_retry-requests-429.change.md
@@ -0,0 +1,5 @@
+---
+title: Retry requests on a 429 that's a lock timeout
+pr_url: https://github.com/stripe/stripe-ruby/pull/841
+released_in_version: 5.1.0
+---
diff --git a/.hark/changes/2019-09-04_brandur_transfer-requestid-httpheaders.change.md b/.hark/changes/2019-09-04_brandur_transfer-requestid-httpheaders.change.md
new file mode 100644
index 000000000..88403d683
--- /dev/null
+++ b/.hark/changes/2019-09-04_brandur_transfer-requestid-httpheaders.change.md
@@ -0,0 +1,5 @@
+---
+title: Transfer the request_id from the http_headers to error.
+pr_url: https://github.com/stripe/stripe-ruby/pull/845
+released_in_version: 5.1.1
+---
diff --git a/.hark/changes/2019-09-20_brandur_introduce-system-garbage.change.md b/.hark/changes/2019-09-20_brandur_introduce-system-garbage.change.md
new file mode 100644
index 000000000..164fc81e3
--- /dev/null
+++ b/.hark/changes/2019-09-20_brandur_introduce-system-garbage.change.md
@@ -0,0 +1,5 @@
+---
+title: Introduce system for garbage collecting connection managers
+pr_url: https://github.com/stripe/stripe-ruby/pull/851
+released_in_version: 5.2.0
+---
diff --git a/.hark/changes/2019-10-01_brandur_drop-timecop-dependency.change.md b/.hark/changes/2019-10-01_brandur_drop-timecop-dependency.change.md
new file mode 100644
index 000000000..126a9d95f
--- /dev/null
+++ b/.hark/changes/2019-10-01_brandur_drop-timecop-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Drop Timecop dependency
+pr_url: https://github.com/stripe/stripe-ruby/pull/858
+released_in_version: 5.4.1
+---
diff --git a/.hark/changes/2019-10-01_brandur_move-monotonic-time.change.md b/.hark/changes/2019-10-01_brandur_move-monotonic-time.change.md
new file mode 100644
index 000000000..056999f09
--- /dev/null
+++ b/.hark/changes/2019-10-01_brandur_move-monotonic-time.change.md
@@ -0,0 +1,5 @@
+---
+title: Move to monotonic time for duration calculations
+pr_url: https://github.com/stripe/stripe-ruby/pull/857
+released_in_version: 5.4.0
+---
diff --git a/.hark/changes/2019-10-01_brandur_support-stripe-should.change.md b/.hark/changes/2019-10-01_brandur_support-stripe-should.change.md
new file mode 100644
index 000000000..2a9951c39
--- /dev/null
+++ b/.hark/changes/2019-10-01_brandur_support-stripe-should.change.md
@@ -0,0 +1,5 @@
+---
+title: Support `Stripe-Should-Retry` header
+pr_url: https://github.com/stripe/stripe-ruby/pull/853
+released_in_version: 5.3.0
+---
diff --git a/.hark/changes/2019-10-03_brandur_user-friendly-messages.change.md b/.hark/changes/2019-10-03_brandur_user-friendly-messages.change.md
new file mode 100644
index 000000000..1bae595c9
--- /dev/null
+++ b/.hark/changes/2019-10-03_brandur_user-friendly-messages.change.md
@@ -0,0 +1,5 @@
+---
+title: User-friendly messages and retries for `EOFError`, `Errno::ECONNRESET`, `Errno::ETIMEDOUT`, and `Errno::EHOSTUNREACH` network errors
+pr_url: https://github.com/stripe/stripe-ruby/pull/859
+released_in_version: 5.5.0
+---
diff --git a/.hark/changes/2019-10-04_brandur_nicer-error-specifying.change.md b/.hark/changes/2019-10-04_brandur_nicer-error-specifying.change.md
new file mode 100644
index 000000000..a094df688
--- /dev/null
+++ b/.hark/changes/2019-10-04_brandur_nicer-error-specifying.change.md
@@ -0,0 +1,5 @@
+---
+title: Nicer error when specifying non-nil non-string opt value
+pr_url: https://github.com/stripe/stripe-ruby/pull/861
+released_in_version: 5.6.0
+---
diff --git a/.hark/changes/2019-10-10_brandur_support-backwards-pagination.change.md b/.hark/changes/2019-10-10_brandur_support-backwards-pagination.change.md
new file mode 100644
index 000000000..f4e8707ba
--- /dev/null
+++ b/.hark/changes/2019-10-10_brandur_support-backwards-pagination.change.md
@@ -0,0 +1,5 @@
+---
+title: "Support backwards pagination with list's `#auto_paging_each`"
+pr_url: https://github.com/stripe/stripe-ruby/pull/865
+released_in_version: 5.7.0
+---
diff --git a/.hark/changes/2019-10-16_ob_fixes-misnamed-connectionba.change.md b/.hark/changes/2019-10-16_ob_fixes-misnamed-connectionba.change.md
new file mode 100644
index 000000000..9e9aa1abd
--- /dev/null
+++ b/.hark/changes/2019-10-16_ob_fixes-misnamed-connectionba.change.md
@@ -0,0 +1,5 @@
+---
+title: Fixes the misnamed `connection_base=` setter to be named `connect_base=`
+pr_url: https://github.com/stripe/stripe-ruby/pull/869
+released_in_version: 5.7.1
+---
diff --git a/.hark/changes/2019-10-24_ob_contributor-covenant.change.md b/.hark/changes/2019-10-24_ob_contributor-covenant.change.md
new file mode 100644
index 000000000..fc9e0fc16
--- /dev/null
+++ b/.hark/changes/2019-10-24_ob_contributor-covenant.change.md
@@ -0,0 +1,5 @@
+---
+title: Contributor Covenant
+pr_url: https://github.com/stripe/stripe-ruby/pull/873
+released_in_version: 5.8.0
+---
diff --git a/.hark/changes/2019-10-31_ob_raise-error-requests.change.md b/.hark/changes/2019-10-31_ob_raise-error-requests.change.md
new file mode 100644
index 000000000..eb00b533d
--- /dev/null
+++ b/.hark/changes/2019-10-31_ob_raise-error-requests.change.md
@@ -0,0 +1,5 @@
+---
+title: Raise an error when requests params are invalid
+pr_url: https://github.com/stripe/stripe-ruby/pull/874
+released_in_version: 5.8.0
+---
diff --git a/.hark/changes/2019-11-01_ob_add-additional-per.change.md b/.hark/changes/2019-11-01_ob_add-additional-per.change.md
new file mode 100644
index 000000000..5fb7b21d0
--- /dev/null
+++ b/.hark/changes/2019-11-01_ob_add-additional-per.change.md
@@ -0,0 +1,5 @@
+---
+title: Add additional per-request configuration documentation
+pr_url: https://github.com/stripe/stripe-ruby/pull/876
+released_in_version: 5.8.0
+---
diff --git a/.hark/changes/2019-11-06_remi_add-support-mandate.change.md b/.hark/changes/2019-11-06_remi_add-support-mandate.change.md
new file mode 100644
index 000000000..8b04d88aa
--- /dev/null
+++ b/.hark/changes/2019-11-06_remi_add-support-mandate.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `Mandate`
+pr_url: https://github.com/stripe/stripe-ruby/pull/879
+released_in_version: 5.8.0
+---
diff --git a/.hark/changes/2019-11-07_brandur_add-request-instrumentat.change.md b/.hark/changes/2019-11-07_brandur_add-request-instrumentat.change.md
new file mode 100644
index 000000000..2c14c4cfc
--- /dev/null
+++ b/.hark/changes/2019-11-07_brandur_add-request-instrumentat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add request instrumentation callback (see `README.md` for usage example)
+pr_url: https://github.com/stripe/stripe-ruby/pull/870
+released_in_version: 5.9.0
+---
diff --git a/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md b/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md
new file mode 100644
index 000000000..7e512656b
--- /dev/null
+++ b/.hark/changes/2019-11-09_rattrayalex_add-listusagerec-listsourcetr.change.md
@@ -0,0 +1,5 @@
+---
+title: Add list_usage_record_summaries and list_source_transactions
+pr_url: https://github.com/stripe/stripe-ruby/pull/882
+released_in_version: 5.10.0
+---
diff --git a/.hark/changes/2019-11-26_ob_add-support-creditnote.change.md b/.hark/changes/2019-11-26_ob_add-support-creditnote.change.md
new file mode 100644
index 000000000..4c081aacf
--- /dev/null
+++ b/.hark/changes/2019-11-26_ob_add-support-creditnote.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `CreditNote` preview
+pr_url: https://github.com/stripe/stripe-ruby/pull/885
+released_in_version: 5.11.0
+---
diff --git a/.hark/changes/2020-01-02_ob_add-support-retrieve.change.md b/.hark/changes/2020-01-02_ob_add-support-retrieve.change.md
new file mode 100644
index 000000000..b4c571315
--- /dev/null
+++ b/.hark/changes/2020-01-02_ob_add-support-retrieve.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for retrieve source transaction API method
+pr_url: https://github.com/stripe/stripe-ruby/pull/889
+released_in_version: 5.12.0
+---
diff --git a/.hark/changes/2020-01-06_ob_override-api-key.change.md b/.hark/changes/2020-01-06_ob_override-api-key.change.md
new file mode 100644
index 000000000..3861a0975
--- /dev/null
+++ b/.hark/changes/2020-01-06_ob_override-api-key.change.md
@@ -0,0 +1,5 @@
+---
+title: Override API key with `client_secret` in `OAuth.token`
+pr_url: https://github.com/stripe/stripe-ruby/pull/890
+released_in_version: 5.12.1
+---
diff --git a/.hark/changes/2020-01-08_brandur_fix-most-ruby.change.md b/.hark/changes/2020-01-08_brandur_fix-most-ruby.change.md
new file mode 100644
index 000000000..a5a1779ef
--- /dev/null
+++ b/.hark/changes/2020-01-08_brandur_fix-most-ruby.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix most Ruby 2.7 warnings
+pr_url: https://github.com/stripe/stripe-ruby/pull/891
+released_in_version: 5.13.0
+---
diff --git a/.hark/changes/2020-01-09_brandur_upgrade-rubocop-0.change.md b/.hark/changes/2020-01-09_brandur_upgrade-rubocop-0.change.md
new file mode 100644
index 000000000..a2aa815a5
--- /dev/null
+++ b/.hark/changes/2020-01-09_brandur_upgrade-rubocop-0.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade Rubocop to 0.79
+pr_url: https://github.com/stripe/stripe-ruby/pull/893
+released_in_version: 5.14.0
+---
diff --git a/.hark/changes/2020-01-10_brandur_clean-up-test.change.md b/.hark/changes/2020-01-10_brandur_clean-up-test.change.md
new file mode 100644
index 000000000..e3ece8ac9
--- /dev/null
+++ b/.hark/changes/2020-01-10_brandur_clean-up-test.change.md
@@ -0,0 +1,5 @@
+---
+title: Clean up test output by capturing `$stderr` when we expect warnings
+pr_url: https://github.com/stripe/stripe-ruby/pull/894
+released_in_version: 5.14.0
+---
diff --git a/.hark/changes/2020-01-10_brandur_explicitly-pass-parameter.change.md b/.hark/changes/2020-01-10_brandur_explicitly-pass-parameter.change.md
new file mode 100644
index 000000000..7dcab1214
--- /dev/null
+++ b/.hark/changes/2020-01-10_brandur_explicitly-pass-parameter.change.md
@@ -0,0 +1,5 @@
+---
+title: Explicitly pass a parameter as hash to be more ruby 2.7 friendly
+pr_url: https://github.com/stripe/stripe-ruby/pull/892
+released_in_version: 5.14.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 000000000..15cb3d59c
--- /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-ruby/pull/896
+released_in_version: 5.14.0
+---
diff --git a/.hark/changes/2020-02-10_brandur_add-requestbegin-instrumentat.change.md b/.hark/changes/2020-02-10_brandur_add-requestbegin-instrumentat.change.md
new file mode 100644
index 000000000..224270e1a
--- /dev/null
+++ b/.hark/changes/2020-02-10_brandur_add-requestbegin-instrumentat.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `request_begin` instrumentation callback
+pr_url: https://github.com/stripe/stripe-ruby/pull/902
+released_in_version: 5.15.0
+---
diff --git a/.hark/changes/2020-02-18_brandur_upgrade-rubocop-0.change.md b/.hark/changes/2020-02-18_brandur_upgrade-rubocop-0.change.md
new file mode 100644
index 000000000..4fe91ed8b
--- /dev/null
+++ b/.hark/changes/2020-02-18_brandur_upgrade-rubocop-0.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade to Rubocop 0.80
+pr_url: https://github.com/stripe/stripe-ruby/pull/903
+released_in_version: 5.16.0
+---
diff --git a/.hark/changes/2020-02-26_ob_add-support-listing.change.md b/.hark/changes/2020-02-26_ob_add-support-listing.change.md
new file mode 100644
index 000000000..6d290b424
--- /dev/null
+++ b/.hark/changes/2020-02-26_ob_add-support-listing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for listing Checkout sessions
+pr_url: https://github.com/stripe/stripe-ruby/pull/906
+released_in_version: 5.16.0
+---
diff --git a/.hark/changes/2020-02-27_brandur_add-stripeerror-idempotentre.change.md b/.hark/changes/2020-02-27_brandur_add-stripeerror-idempotentre.change.md
new file mode 100644
index 000000000..8b387fb72
--- /dev/null
+++ b/.hark/changes/2020-02-27_brandur_add-stripeerror-idempotentre.change.md
@@ -0,0 +1,5 @@
+---
+title: "Add `StripeError#idempotent_replayed?`"
+pr_url: https://github.com/stripe/stripe-ruby/pull/907
+released_in_version: 5.17.0
+---
diff --git a/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md b/.hark/changes/2020-04-22_remi_add-support-billingporta.change.md
new file mode 100644
index 000000000..3bb82359d
--- /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-ruby/pull/911
+released_in_version: 5.18.0
+---
diff --git a/.hark/changes/2020-04-24_brandur_expose-stripe-webhook.change.md b/.hark/changes/2020-04-24_brandur_expose-stripe-webhook.change.md
new file mode 100644
index 000000000..3706ecd43
--- /dev/null
+++ b/.hark/changes/2020-04-24_brandur_expose-stripe-webhook.change.md
@@ -0,0 +1,5 @@
+---
+title: Expose `Stripe::Webhook.compute_signature` publicly
+pr_url: https://github.com/stripe/stripe-ruby/pull/915
+released_in_version: 5.19.0
+---
diff --git a/.hark/changes/2020-04-27_brandur_add-new-generatehead.change.md b/.hark/changes/2020-04-27_brandur_add-new-generatehead.change.md
new file mode 100644
index 000000000..007f16474
--- /dev/null
+++ b/.hark/changes/2020-04-27_brandur_add-new-generatehead.change.md
@@ -0,0 +1,5 @@
+---
+title: Add new `.generate_header` method for webhooks
+pr_url: https://github.com/stripe/stripe-ruby/pull/916
+released_in_version: 5.20.0
+---
diff --git a/.hark/changes/2020-04-29_remi_add-support-price.change.md b/.hark/changes/2020-04-29_remi_add-support-price.change.md
new file mode 100644
index 000000000..6c574846e
--- /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-ruby/pull/917
+released_in_version: 5.21.0
+---
diff --git a/.hark/changes/2020-05-12_remi_add-support-lineitem.change.md b/.hark/changes/2020-05-12_remi_add-support-lineitem.change.md
new file mode 100644
index 000000000..5b5a536f7
--- /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-ruby/pull/918
+released_in_version: 5.22.0
+---
diff --git a/.hark/changes/2020-08-05_brandur_rename-api-resource.change.md b/.hark/changes/2020-08-05_brandur_rename-api-resource.change.md
new file mode 100644
index 000000000..c1855ce7d
--- /dev/null
+++ b/.hark/changes/2020-08-05_brandur_rename-api-resource.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename API resource's `request` method
+pr_url: https://github.com/stripe/stripe-ruby/pull/936
+released_in_version: 5.23.1
+---
diff --git a/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md b/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md
new file mode 100644
index 000000000..5f177e8f9
--- /dev/null
+++ b/.hark/changes/2020-08-05_remi_add-support-promotioncod.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the `PromotionCode` resource and APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/937
+released_in_version: 5.23.0
+---
diff --git a/.hark/changes/2020-08-16_remi_fix-typo-documentatio.change.md b/.hark/changes/2020-08-16_remi_fix-typo-documentatio.change.md
new file mode 100644
index 000000000..0f13436bf
--- /dev/null
+++ b/.hark/changes/2020-08-16_remi_fix-typo-documentatio.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix typo in documentation of `stripe_object.rb`
+pr_url: https://github.com/stripe/stripe-ruby/pull/940
+released_in_version: 5.24.0
+---
diff --git a/.hark/changes/2020-08-26_brandur_extract-configuratio-separate.change.md b/.hark/changes/2020-08-26_brandur_extract-configuratio-separate.change.md
new file mode 100644
index 000000000..6c3690b59
--- /dev/null
+++ b/.hark/changes/2020-08-26_brandur_extract-configuratio-separate.change.md
@@ -0,0 +1,5 @@
+---
+title: Extract configurations into separate object
+pr_url: https://github.com/stripe/stripe-ruby/pull/939
+released_in_version: 5.24.0
+---
diff --git a/.hark/changes/2020-09-02_remi_add-support-issuing.change.md b/.hark/changes/2020-09-02_remi_add-support-issuing.change.md
new file mode 100644
index 000000000..677186d30
--- /dev/null
+++ b/.hark/changes/2020-09-02_remi_add-support-issuing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Issuing Dispute Submit API
+pr_url: https://github.com/stripe/stripe-ruby/pull/944
+released_in_version: 5.25.0
+---
diff --git a/.hark/changes/2020-09-30_remi_add-support-setupattempt.change.md b/.hark/changes/2020-09-30_remi_add-support-setupattempt.change.md
new file mode 100644
index 000000000..01ddcec99
--- /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-ruby/pull/949
+released_in_version: 5.26.0
+---
diff --git a/.hark/changes/2020-10-14_brandur_add-configuratio-option.change.md b/.hark/changes/2020-10-14_brandur_add-configuratio-option.change.md
new file mode 100644
index 000000000..0a688016b
--- /dev/null
+++ b/.hark/changes/2020-10-14_brandur_add-configuratio-option.change.md
@@ -0,0 +1,5 @@
+---
+title: Add configuration option for `write_timeout` for connections on Ruby 2.6+
+pr_url: https://github.com/stripe/stripe-ruby/pull/950
+released_in_version: 5.28.0
+---
diff --git a/.hark/changes/2020-10-14_remi_add-support-payout.change.md b/.hark/changes/2020-10-14_remi_add-support-payout.change.md
new file mode 100644
index 000000000..8d7dfbeed
--- /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-ruby/pull/951
+released_in_version: 5.27.0
+---
diff --git a/.hark/changes/2021-01-05_brandur_allow-clientid-configuratio.change.md b/.hark/changes/2021-01-05_brandur_allow-clientid-configuratio.change.md
new file mode 100644
index 000000000..b38b59be0
--- /dev/null
+++ b/.hark/changes/2021-01-05_brandur_allow-clientid-configuratio.change.md
@@ -0,0 +1,5 @@
+---
+title: Allow client_id configuration on instance config
+pr_url: https://github.com/stripe/stripe-ruby/pull/952
+released_in_version: 5.29.0
+---
diff --git a/.hark/changes/2021-02-09_brandur_fix-return-value.change.md b/.hark/changes/2021-02-09_brandur_fix-return-value.change.md
new file mode 100644
index 000000000..e62157f16
--- /dev/null
+++ b/.hark/changes/2021-02-09_brandur_fix-return-value.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix return value of `Customer#delete_discount`"
+pr_url: https://github.com/stripe/stripe-ruby/pull/964
+released_in_version: 5.29.1
+---
diff --git a/.hark/changes/2021-02-20_richardm_add-support-billing.change.md b/.hark/changes/2021-02-20_richardm_add-support-billing.change.md
new file mode 100644
index 000000000..04da38f18
--- /dev/null
+++ b/.hark/changes/2021-02-20_richardm_add-support-billing.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Billing Portal Configuration API
+pr_url: https://github.com/stripe/stripe-ruby/pull/965
+released_in_version: 5.30.0
+---
diff --git a/.hark/changes/2021-03-10_richardm_ci-github-actions.change.md b/.hark/changes/2021-03-10_richardm_ci-github-actions.change.md
new file mode 100644
index 000000000..35707b843
--- /dev/null
+++ b/.hark/changes/2021-03-10_richardm_ci-github-actions.change.md
@@ -0,0 +1,5 @@
+---
+title: "CI: github actions"
+pr_url: https://github.com/stripe/stripe-ruby/pull/967
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2021-04-01_brandur_allow-stripeclient-configured.change.md b/.hark/changes/2021-04-01_brandur_allow-stripeclient-configured.change.md
new file mode 100644
index 000000000..577c7cc13
--- /dev/null
+++ b/.hark/changes/2021-04-01_brandur_allow-stripeclient-configured.change.md
@@ -0,0 +1,5 @@
+---
+title: Allow StripeClient to be configured per instance
+pr_url: https://github.com/stripe/stripe-ruby/pull/968
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2021-04-02_brandur_config-change-only.change.md b/.hark/changes/2021-04-02_brandur_config-change-only.change.md
new file mode 100644
index 000000000..11fa12d86
--- /dev/null
+++ b/.hark/changes/2021-04-02_brandur_config-change-only.change.md
@@ -0,0 +1,5 @@
+---
+title: On config change, only clear connection managers for changed config
+pr_url: https://github.com/stripe/stripe-ruby/pull/971
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2021-04-02_brandur_rename-stripe-configuratio.change.md b/.hark/changes/2021-04-02_brandur_rename-stripe-configuratio.change.md
new file mode 100644
index 000000000..a71e01b8f
--- /dev/null
+++ b/.hark/changes/2021-04-02_brandur_rename-stripe-configuratio.change.md
@@ -0,0 +1,5 @@
+---
+title: Rename `Stripe.configuration` to `Stripe.config`
+pr_url: https://github.com/stripe/stripe-ruby/pull/972
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2021-04-02_brandur_reserve-some-critical.change.md b/.hark/changes/2021-04-02_brandur_reserve-some-critical.change.md
new file mode 100644
index 000000000..24af73c47
--- /dev/null
+++ b/.hark/changes/2021-04-02_brandur_reserve-some-critical.change.md
@@ -0,0 +1,5 @@
+---
+title: Reserve some critical field names when adding `StripeObject` accessors
+pr_url: https://github.com/stripe/stripe-ruby/pull/970
+released_in_version: 5.31.0
+---
diff --git a/.hark/changes/2021-04-05_brandur_reduce-packed-gem.change.md b/.hark/changes/2021-04-05_brandur_reduce-packed-gem.change.md
new file mode 100644
index 000000000..0e95417cf
--- /dev/null
+++ b/.hark/changes/2021-04-05_brandur_reduce-packed-gem.change.md
@@ -0,0 +1,5 @@
+---
+title: Reduce packed gem size
+pr_url: https://github.com/stripe/stripe-ruby/pull/973
+released_in_version: 5.32.0
+---
diff --git a/.hark/changes/2021-04-05_unknown_correct-use-regexp.change.md b/.hark/changes/2021-04-05_unknown_correct-use-regexp.change.md
new file mode 100644
index 000000000..3703c1dd4
--- /dev/null
+++ b/.hark/changes/2021-04-05_unknown_correct-use-regexp.change.md
@@ -0,0 +1,4 @@
+---
+title: Correct use of regexp `match` in gemspec for old versions of Ruby
+released_in_version: 5.32.1
+---
diff --git a/.hark/changes/2021-05-19_richardm_add-support-identify.change.md b/.hark/changes/2021-05-19_richardm_add-support-identify.change.md
new file mode 100644
index 000000000..2693e4a0c
--- /dev/null
+++ b/.hark/changes/2021-05-19_richardm_add-support-identify.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for the Identify VerificationSession and VerificationReport APIs
+pr_url: https://github.com/stripe/stripe-ruby/pull/979
+released_in_version: 5.33.0
+---
diff --git a/.hark/changes/2021-06-04_richardm_api-updates.change.md b/.hark/changes/2021-06-04_richardm_api-updates.change.md
new file mode 100644
index 000000000..666f6e8b0
--- /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-ruby/pull/981
+is_stripe_api_change: true
+released_in_version: 5.34.0
+---
+
+* Add support for `TaxCode` API.
diff --git a/.hark/changes/2021-06-24_dcr_add-support-making.change.md b/.hark/changes/2021-06-24_dcr_add-support-making.change.md
new file mode 100644
index 000000000..fcef8c99a
--- /dev/null
+++ b/.hark/changes/2021-06-24_dcr_add-support-making.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for making a request and receiving the response as a stream.
+pr_url: https://github.com/stripe/stripe-ruby/pull/983
+released_in_version: 5.35.0
+---
diff --git a/.hark/changes/2021-06-24_richardm_deprecate-travis.change.md b/.hark/changes/2021-06-24_richardm_deprecate-travis.change.md
new file mode 100644
index 000000000..2911816d6
--- /dev/null
+++ b/.hark/changes/2021-06-24_richardm_deprecate-travis.change.md
@@ -0,0 +1,5 @@
+---
+title: Deprecate travis
+pr_url: https://github.com/stripe/stripe-ruby/pull/982
+released_in_version: 5.35.0
+---
diff --git a/.hark/changes/2021-06-29_dcr_update-normalizeopt-use.change.md b/.hark/changes/2021-06-29_dcr_update-normalizeopt-use.change.md
new file mode 100644
index 000000000..1ea3619a0
--- /dev/null
+++ b/.hark/changes/2021-06-29_dcr_update-normalizeopt-use.change.md
@@ -0,0 +1,5 @@
+---
+title: Update normalize_opts to use dup instead of clone.
+pr_url: https://github.com/stripe/stripe-ruby/pull/985
+released_in_version: 5.35.0
+---
diff --git a/.hark/changes/2021-07-09_richardm_add-support-quote.change.md b/.hark/changes/2021-07-09_richardm_add-support-quote.change.md
new file mode 100644
index 000000000..8b6620d4d
--- /dev/null
+++ b/.hark/changes/2021-07-09_richardm_add-support-quote.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for `Quote` API
+pr_url: https://github.com/stripe/stripe-ruby/pull/987
+released_in_version: 5.36.0
+---
diff --git a/.hark/changes/2021-07-14_dcr_api-updates.change.md b/.hark/changes/2021-07-14_dcr_api-updates.change.md
new file mode 100644
index 000000000..6e6c50056
--- /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-ruby/pull/988
+is_stripe_api_change: true
+released_in_version: 5.37.0
+---
+
+* Add support for `list_computed_upfront_line_items` method on resource `Quote`
diff --git a/.hark/changes/2021-07-15_dcr_remove-unused-api.change.md b/.hark/changes/2021-07-15_dcr_remove-unused-api.change.md
new file mode 100644
index 000000000..76c82b3fc
--- /dev/null
+++ b/.hark/changes/2021-07-15_dcr_remove-unused-api.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove unused API error types from docs.
+pr_url: https://github.com/stripe/stripe-ruby/pull/989
+released_in_version: 5.38.0
+---
diff --git a/.hark/changes/2021-07-27_richardm_codegen-more-files.change.md b/.hark/changes/2021-07-27_richardm_codegen-more-files.change.md
new file mode 100644
index 000000000..f7c3e4944
--- /dev/null
+++ b/.hark/changes/2021-07-27_richardm_codegen-more-files.change.md
@@ -0,0 +1,5 @@
+---
+title: Codegen more files
+pr_url: https://github.com/stripe/stripe-ruby/pull/991
+released_in_version: 5.38.0
+---
diff --git a/.hark/changes/2021-08-09_richardm_add-requestid-requestendev.change.md b/.hark/changes/2021-08-09_richardm_add-requestid-requestendev.change.md
new file mode 100644
index 000000000..009e616b5
--- /dev/null
+++ b/.hark/changes/2021-08-09_richardm_add-requestid-requestendev.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `request_id` to RequestEndEvent
+pr_url: https://github.com/stripe/stripe-ruby/pull/993
+released_in_version: 5.38.0
+---
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 000000000..2b1e1478d
--- /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-ruby/pull/1010
+is_stripe_api_change: true
+released_in_version: 5.39.0
+---
+
+* Add support for `list_payment_methods` method on resource `Customer`
diff --git a/.hark/changes/2021-10-12_dcr_add-tests-namespaced.change.md b/.hark/changes/2021-10-12_dcr_add-tests-namespaced.change.md
new file mode 100644
index 000000000..9a7dd49b3
--- /dev/null
+++ b/.hark/changes/2021-10-12_dcr_add-tests-namespaced.change.md
@@ -0,0 +1,5 @@
+---
+title: Add tests for namespaced resources.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1012
+released_in_version: 5.40.0
+---
diff --git a/.hark/changes/2021-10-12_richardm_codegen-3-more.change.md b/.hark/changes/2021-10-12_richardm_codegen-3-more.change.md
new file mode 100644
index 000000000..cc8303f36
--- /dev/null
+++ b/.hark/changes/2021-10-12_richardm_codegen-3-more.change.md
@@ -0,0 +1,5 @@
+---
+title: "codegen: 3 more files"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1011
+released_in_version: 5.40.0
+---
diff --git a/.hark/changes/2021-10-13_dcr_add-tests-child.change.md b/.hark/changes/2021-10-13_dcr_add-tests-child.change.md
new file mode 100644
index 000000000..5a989f43b
--- /dev/null
+++ b/.hark/changes/2021-10-13_dcr_add-tests-child.change.md
@@ -0,0 +1,5 @@
+---
+title: Add tests for child resources.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1013
+released_in_version: 5.40.0
+---
diff --git a/.hark/changes/2021-11-11_richardm_api-updates.change.md b/.hark/changes/2021-11-11_richardm_api-updates.change.md
new file mode 100644
index 000000000..a10766beb
--- /dev/null
+++ b/.hark/changes/2021-11-11_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1015
+is_stripe_api_change: true
+released_in_version: 5.40.0
+---
+
+* Add support for `expire` method on resource `Checkout.Session`
diff --git a/.hark/changes/2021-11-16_dcr_api-updates.change.md b/.hark/changes/2021-11-16_dcr_api-updates.change.md
new file mode 100644
index 000000000..2849352f5
--- /dev/null
+++ b/.hark/changes/2021-11-16_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1017
+is_stripe_api_change: true
+released_in_version: 5.41.0
+---
+
+* Add support for new resource `ShippingRate`
diff --git a/.hark/changes/2021-12-13_dcr_add-connection-manager.change.md b/.hark/changes/2021-12-13_dcr_add-connection-manager.change.md
new file mode 100644
index 000000000..91eaa48db
--- /dev/null
+++ b/.hark/changes/2021-12-13_dcr_add-connection-manager.change.md
@@ -0,0 +1,5 @@
+---
+title: Add connection manager logging and include object IDs in logging.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1022
+released_in_version: 5.42.0
+---
diff --git a/.hark/changes/2022-01-20_richardm_api-updates.change.md b/.hark/changes/2022-01-20_richardm_api-updates.change.md
new file mode 100644
index 000000000..25e8148f5
--- /dev/null
+++ b/.hark/changes/2022-01-20_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1031
+is_stripe_api_change: true
+released_in_version: 5.43.0
+---
+
+* Add support for new resource `PaymentLink`
diff --git a/.hark/changes/2022-02-15_richardm_api-updates.change.md b/.hark/changes/2022-02-15_richardm_api-updates.change.md
new file mode 100644
index 000000000..0495f3c80
--- /dev/null
+++ b/.hark/changes/2022-02-15_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1032
+is_stripe_api_change: true
+released_in_version: 5.44.0
+---
+
+* Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
diff --git a/.hark/changes/2022-03-01_richardm_api-updates.change.md b/.hark/changes/2022-03-01_richardm_api-updates.change.md
new file mode 100644
index 000000000..1fdb80226
--- /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-ruby/pull/1035
+is_stripe_api_change: true
+released_in_version: 5.45.0
+---
+
+* Add support for new resource `TestHelpers.TestClock`
diff --git a/.hark/changes/2022-03-17_pakrym_add-support-search.change.md b/.hark/changes/2022-03-17_pakrym_add-support-search.change.md
new file mode 100644
index 000000000..8f73f1bec
--- /dev/null
+++ b/.hark/changes/2022-03-17_pakrym_add-support-search.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for Search API
+pr_url: https://github.com/stripe/stripe-ruby/pull/992
+released_in_version: 5.46.0
+---
diff --git a/.hark/changes/2022-03-23_dcr_api-updates.change.md b/.hark/changes/2022-03-23_dcr_api-updates.change.md
new file mode 100644
index 000000000..ab9fcc132
--- /dev/null
+++ b/.hark/changes/2022-03-23_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1039
+is_stripe_api_change: true
+released_in_version: 5.46.0
+---
+
+* Add support for `cancel` method on resource `Refund`
diff --git a/.hark/changes/2022-03-28_pakrym_add-supporting-classes.change.md b/.hark/changes/2022-03-28_pakrym_add-supporting-classes.change.md
new file mode 100644
index 000000000..1ee959b1d
--- /dev/null
+++ b/.hark/changes/2022-03-28_pakrym_add-supporting-classes.change.md
@@ -0,0 +1,5 @@
+---
+title: Add supporting classes for test helper generation
+pr_url: https://github.com/stripe/stripe-ruby/pull/1034
+released_in_version: 5.47.0
+---
diff --git a/.hark/changes/2022-03-28_pakrym_api-updates.change.md b/.hark/changes/2022-03-28_pakrym_api-updates.change.md
new file mode 100644
index 000000000..89d4299e2
--- /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-ruby/pull/1040
+is_stripe_api_change: true
+released_in_version: 5.47.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 000000000..ab91c4d44
--- /dev/null
+++ b/.hark/changes/2022-03-29_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1041
+is_stripe_api_change: true
+released_in_version: 5.48.0
+---
+
+* Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
diff --git a/.hark/changes/2022-04-08_kamil_api-updates.change.md b/.hark/changes/2022-04-08_kamil_api-updates.change.md
new file mode 100644
index 000000000..333825ee2
--- /dev/null
+++ b/.hark/changes/2022-04-08_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1043
+is_stripe_api_change: true
+released_in_version: 5.49.0
+---
+
+* Add support for `apply_customer_balance` method on resource `PaymentIntent`
diff --git a/.hark/changes/2022-04-13_richardm_api-updates.change.md b/.hark/changes/2022-04-13_richardm_api-updates.change.md
new file mode 100644
index 000000000..810fef484
--- /dev/null
+++ b/.hark/changes/2022-04-13_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1045
+is_stripe_api_change: true
+released_in_version: 5.50.0
+---
+
+* Add support for `increment_authorization` method on resource `PaymentIntent`
diff --git a/.hark/changes/2022-04-15_richardm_1047-api-updates.change.md b/.hark/changes/2022-04-15_richardm_1047-api-updates.change.md
new file mode 100644
index 000000000..02d2cfecf
--- /dev/null
+++ b/.hark/changes/2022-04-15_richardm_1047-api-updates.change.md
@@ -0,0 +1,7 @@
+---
+title: "[#1047](https://github.com/stripe/stripe-ruby/pull/1047) API Updates"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1046
+released_in_version: 5.52.0
+---
+
+* Add support for new resources `FundingInstructions` and `Terminal.Configuration`
diff --git a/.hark/changes/2022-04-15_richardm_release-incomplete-yanked.change.md b/.hark/changes/2022-04-15_richardm_release-incomplete-yanked.change.md
new file mode 100644
index 000000000..ab5a2d0cf
--- /dev/null
+++ b/.hark/changes/2022-04-15_richardm_release-incomplete-yanked.change.md
@@ -0,0 +1,5 @@
+---
+title: This release was incomplete and was yanked from RubyGems immediately after it was published.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1046
+released_in_version: 5.51.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 000000000..67e95a383
--- /dev/null
+++ b/.hark/changes/2022-04-21_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1050
+is_stripe_api_change: true
+released_in_version: 5.53.0
+---
+
+* Add support for `expire` test helper method on resource `Refund`
diff --git a/.hark/changes/2022-05-03_dcr_api-updates.change.md b/.hark/changes/2022-05-03_dcr_api-updates.change.md
new file mode 100644
index 000000000..d48e6c448
--- /dev/null
+++ b/.hark/changes/2022-05-03_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1053
+is_stripe_api_change: true
+released_in_version: 5.54.0
+---
+
+* Add support for new resource `CashBalance`
diff --git a/.hark/changes/2022-05-05_dcr_api-updates.change.md b/.hark/changes/2022-05-05_dcr_api-updates.change.md
new file mode 100644
index 000000000..4035c86be
--- /dev/null
+++ b/.hark/changes/2022-05-05_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1055
+is_stripe_api_change: true
+released_in_version: 5.55.0
+---
+
+* Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
diff --git a/.hark/changes/2022-05-09_richardm_api-updates.change.md b/.hark/changes/2022-05-09_richardm_api-updates.change.md
new file mode 100644
index 000000000..5f77cc083
--- /dev/null
+++ b/.hark/changes/2022-05-09_richardm_api-updates.change.md
@@ -0,0 +1,16 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1056
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 6.0.0
+---
+
+Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-Guide-for-v6) contains more information.
+
+(⚠️ = breaking changes):
+* ⚠️ Replace the legacy `Order` API with the new `Order` API.
+  * New methods: `cancel`, `list_line_items`, `reopen`, and `submit`
+  * Removed methods: `pay` and `return_order`
+  * Removed resources: `OrderItem` and `OrderReturn`
+* ⚠️ Rename `FinancialConnections::Account.refresh` to `FinancialConnections::Account.refresh_account
diff --git a/.hark/changes/2022-05-20_richardm_api-updates.change.md b/.hark/changes/2022-05-20_richardm_api-updates.change.md
new file mode 100644
index 000000000..56fa8ec91
--- /dev/null
+++ b/.hark/changes/2022-05-20_richardm_api-updates.change.md
@@ -0,0 +1,10 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1057
+is_stripe_api_change: true
+released_in_version: 6.1.0
+---
+
+* Add support for new resources `Treasury.CreditReversal`, `Treasury.DebitReversal`, `Treasury.FinancialAccountFeatures`, `Treasury.FinancialAccount`, `Treasury.FlowDetails`, `Treasury.InboundTransfer`, `Treasury.OutboundPayment`, `Treasury.OutboundTransfer`, `Treasury.ReceivedCredit`, `Treasury.ReceivedDebit`, `Treasury.TransactionEntry`, and `Treasury.Transaction`
+* Add support for `retrieve_payment_method` method on resource `Customer`
+* Add support for `list_owners` and `list` methods on resource `FinancialConnections.Account`
diff --git a/.hark/changes/2022-05-23_pakrym_api-updates.change.md b/.hark/changes/2022-05-23_pakrym_api-updates.change.md
new file mode 100644
index 000000000..2dad91e03
--- /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-ruby/pull/1060
+is_stripe_api_change: true
+released_in_version: 6.2.0
+---
+
+* Add support for new resource `Apps.Secret`
diff --git a/.hark/changes/2022-06-08_dcr_chore-stop-special.change.md b/.hark/changes/2022-06-08_dcr_chore-stop-special.change.md
new file mode 100644
index 000000000..e5ec222ac
--- /dev/null
+++ b/.hark/changes/2022-06-08_dcr_chore-stop-special.change.md
@@ -0,0 +1,5 @@
+---
+title: "chore: Stop special implementation of Account.persons method."
+pr_url: https://github.com/stripe/stripe-ruby/pull/1069
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md b/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md
new file mode 100644
index 000000000..3bb067caa
--- /dev/null
+++ b/.hark/changes/2022-06-08_dcr_fix-update-cash.change.md
@@ -0,0 +1,5 @@
+---
+title: "fix: Update cash balance methods to no longer require nested ID."
+pr_url: https://github.com/stripe/stripe-ruby/pull/1063
+released_in_version: 6.3.0
+---
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 000000000..5443fea46
--- /dev/null
+++ b/.hark/changes/2022-06-09_pakrym_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1070
+is_stripe_api_change: true
+released_in_version: 6.4.0
+---
+
+Switch from using meta-programing to generating explicit methods for custom methods.
diff --git a/.hark/changes/2022-06-13_pakrym_use-requeststrip-all.change.md b/.hark/changes/2022-06-13_pakrym_use-requeststrip-all.change.md
new file mode 100644
index 000000000..dd7e7539e
--- /dev/null
+++ b/.hark/changes/2022-06-13_pakrym_use-requeststrip-all.change.md
@@ -0,0 +1,5 @@
+---
+title: Use request_stripe_object for all requests
+pr_url: https://github.com/stripe/stripe-ruby/pull/1071
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2022-06-15_pakrym_support-updating-pre.change.md b/.hark/changes/2022-06-15_pakrym_support-updating-pre.change.md
new file mode 100644
index 000000000..ed353bcbf
--- /dev/null
+++ b/.hark/changes/2022-06-15_pakrym_support-updating-pre.change.md
@@ -0,0 +1,5 @@
+---
+title: Support updating pre-release versions
+pr_url: https://github.com/stripe/stripe-ruby/pull/1074
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md b/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md
new file mode 100644
index 000000000..9dcd2ce28
--- /dev/null
+++ b/.hark/changes/2022-06-15_pakrym_trigger-workflows-beta.change.md
@@ -0,0 +1,5 @@
+---
+title: Trigger workflows on beta branches
+pr_url: https://github.com/stripe/stripe-ruby/pull/1072
+released_in_version: 6.4.0
+---
diff --git a/.hark/changes/2022-06-17_kamil_api-updates.change.md b/.hark/changes/2022-06-17_kamil_api-updates.change.md
new file mode 100644
index 000000000..20ef1c0a7
--- /dev/null
+++ b/.hark/changes/2022-06-17_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1073
+is_stripe_api_change: true
+released_in_version: 6.4.0
+---
+
+* Add support for `fund_cash_balance` test helper method on resource `Customer`
diff --git a/.hark/changes/2022-06-21_dcr_fix-update-logging.change.md b/.hark/changes/2022-06-21_dcr_fix-update-logging.change.md
new file mode 100644
index 000000000..fde00c71f
--- /dev/null
+++ b/.hark/changes/2022-06-21_dcr_fix-update-logging.change.md
@@ -0,0 +1,5 @@
+---
+title: "fix: Update logging to coerce ASCII-8BIT into UTF-8."
+pr_url: https://github.com/stripe/stripe-ruby/pull/1076
+released_in_version: 6.5.0
+---
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 000000000..f95d151fe
--- /dev/null
+++ b/.hark/changes/2022-06-29_dcr_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1084
+is_stripe_api_change: true
+released_in_version: 6.5.0
+---
+
+* Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
diff --git a/.hark/changes/2022-07-06_pakrym_use-auto-generation.change.md b/.hark/changes/2022-07-06_pakrym_use-auto-generation.change.md
new file mode 100644
index 000000000..8bc9a4edd
--- /dev/null
+++ b/.hark/changes/2022-07-06_pakrym_use-auto-generation.change.md
@@ -0,0 +1,5 @@
+---
+title: Use auto-generation for `Invoice` methods
+pr_url: https://github.com/stripe/stripe-ruby/pull/1090
+released_in_version: 7.0.0
+---
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 000000000..65dc7b8e4
--- /dev/null
+++ b/.hark/changes/2022-07-07_pakrym_api-updates.change.md
@@ -0,0 +1,6 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1092
+is_stripe_api_change: true
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-01_kamil_next-major-release.change.md b/.hark/changes/2022-08-01_kamil_next-major-release.change.md
new file mode 100644
index 000000000..ba86c4187
--- /dev/null
+++ b/.hark/changes/2022-08-01_kamil_next-major-release.change.md
@@ -0,0 +1,6 @@
+---
+title: Next major release changes
+pr_url: https://github.com/stripe/stripe-ruby/pull/1103
+is_stripe_api_change: true
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_pakrym_api-updates.change.md b/.hark/changes/2022-08-02_pakrym_api-updates.change.md
new file mode 100644
index 000000000..a6b04f2d5
--- /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-ruby/pull/1106
+is_stripe_api_change: true
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_deprecate-delete-method.change.md b/.hark/changes/2022-08-02_unknown_deprecate-delete-method.change.md
new file mode 100644
index 000000000..536118f0c
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_deprecate-delete-method.change.md
@@ -0,0 +1,5 @@
+---
+title: Deprecate `delete` method on `Subscription` resource. Please use `cancel` method instead.
+section: Deprecated
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-ability-list.change.md b/.hark/changes/2022-08-02_unknown_remove-ability-list.change.md
new file mode 100644
index 000000000..02c29afdf
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-ability-list.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove ability to list `Card` resource for a `Recipient`.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-alipayaccoun-bitcoinrecei.change.md b/.hark/changes/2022-08-02_unknown_remove-alipayaccoun-bitcoinrecei.change.md
new file mode 100644
index 000000000..3cdc113e8
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-alipayaccoun-bitcoinrecei.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `Issuing::CardDetails`, `Recipient`, ` RecipientTransfer`, and `ThreeDSecure` resources. The resources were deprecated or no longer in use.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-cancel-method.change.md b/.hark/changes/2022-08-02_unknown_remove-cancel-method.change.md
new file mode 100644
index 000000000..afd96c545
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-cancel-method.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `cancel` method from `Transfer` resource. The method was deprecated.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-create-method.change.md b/.hark/changes/2022-08-02_unknown_remove-create-method.change.md
new file mode 100644
index 000000000..f063a77eb
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-create-method.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `create` method from `ReportType` resource. The method was not supported.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-details-method.change.md b/.hark/changes/2022-08-02_unknown_remove-details-method.change.md
new file mode 100644
index 000000000..6a79bdbb1
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-details-method.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `details` method from `Issuing.Card` resource. The method was not supported.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-issuing-carddetails.change.md b/.hark/changes/2022-08-02_unknown_remove-issuing-carddetails.change.md
new file mode 100644
index 000000000..ed84e7794
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-issuing-carddetails.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `Issuing.CardDetails` resource. Read more at https://stripe.com/docs/issuing/cards/virtual.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_remove-usagerecords-method.change.md b/.hark/changes/2022-08-02_unknown_remove-usagerecords-method.change.md
new file mode 100644
index 000000000..8600bebfe
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_remove-usagerecords-method.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove `usage_record_summaries` method from `SubscriptionItem` resource. Please use `list_usage_record_summaries` method instead.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_retrievecash-updatecashba-methods.change.md b/.hark/changes/2022-08-02_unknown_retrievecash-updatecashba-methods.change.md
new file mode 100644
index 000000000..5a777a752
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_retrievecash-updatecashba-methods.change.md
@@ -0,0 +1,6 @@
+---
+title: "`retrieve_cash_balance` and `update_cash_balance` methods on `Customer` resource no longer requires the second argument to always be `nil`. The methods now now take in `customer_id`, `params`, and `opts` parameters."
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-02_unknown_update-default-bundle.change.md b/.hark/changes/2022-08-02_unknown_update-default-bundle.change.md
new file mode 100644
index 000000000..a0a027338
--- /dev/null
+++ b/.hark/changes/2022-08-02_unknown_update-default-bundle.change.md
@@ -0,0 +1,6 @@
+---
+title: Update default bundle of CA certificates to April 26, 2022.
+semver_level: major
+section: ⚠️ Changed
+released_in_version: 7.0.0
+---
diff --git a/.hark/changes/2022-08-17_ramya_add-support-section.change.md b/.hark/changes/2022-08-17_ramya_add-support-section.change.md
new file mode 100644
index 000000000..4df7528ec
--- /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-ruby/pull/1115
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2022-08-18_dcr_refresh-rubocop-config.change.md b/.hark/changes/2022-08-18_dcr_refresh-rubocop-config.change.md
new file mode 100644
index 000000000..f6b4a10d4
--- /dev/null
+++ b/.hark/changes/2022-08-18_dcr_refresh-rubocop-config.change.md
@@ -0,0 +1,5 @@
+---
+title: Refresh rubocop config.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1117
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2022-08-19_anniel_update-allowedchars-rubocop.change.md b/.hark/changes/2022-08-19_anniel_update-allowedchars-rubocop.change.md
new file mode 100644
index 000000000..8c9b0c75a
--- /dev/null
+++ b/.hark/changes/2022-08-19_anniel_update-allowedchars-rubocop.change.md
@@ -0,0 +1,5 @@
+---
+title: Update AllowedChars in rubocop config
+pr_url: https://github.com/stripe/stripe-ruby/pull/1118
+released_in_version: 7.1.0
+---
diff --git a/.hark/changes/2022-08-19_kamil_api-updates.change.md b/.hark/changes/2022-08-19_kamil_api-updates.change.md
new file mode 100644
index 000000000..1f6e5e00a
--- /dev/null
+++ b/.hark/changes/2022-08-19_kamil_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1116
+is_stripe_api_change: true
+released_in_version: 7.1.0
+---
+
+* Add support for new resource `CustomerCashBalanceTransaction`
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 000000000..ba74d3149
--- /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-ruby/pull/1144
+is_stripe_api_change: true
+released_in_version: 8.0.0
+---
diff --git a/.hark/changes/2022-11-16_unknown_removed-deprecated-delete.change.md b/.hark/changes/2022-11-16_unknown_removed-deprecated-delete.change.md
new file mode 100644
index 000000000..f46fa89a2
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_removed-deprecated-delete.change.md
@@ -0,0 +1,14 @@
+---
+title: Removed deprecated `delete` method on `Subscription` resource. Please use `cancel` method instead.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 8.0.0
+---
+
+```ruby
+# before
+Stripe::Subscription::delete("sub_12345")
+
+# after
+Stripe::Subscription::cancel("sub_12345")
+```
diff --git a/.hark/changes/2022-11-16_unknown_removed-deprecated-orders.change.md b/.hark/changes/2022-11-16_unknown_removed-deprecated-orders.change.md
new file mode 100644
index 000000000..f78f50d66
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_removed-deprecated-orders.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Orders` resource.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 8.0.0
+---
diff --git a/.hark/changes/2022-11-16_unknown_removed-deprecated-sku.change.md b/.hark/changes/2022-11-16_unknown_removed-deprecated-sku.change.md
new file mode 100644
index 000000000..5481dd986
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_removed-deprecated-sku.change.md
@@ -0,0 +1,6 @@
+---
+title: Removed deprecated `Sku` resource.
+semver_level: major
+section: ⚠️ Removed
+released_in_version: 8.0.0
+---
diff --git a/.hark/changes/2022-11-16_unknown_save-method-deprecated.change.md b/.hark/changes/2022-11-16_unknown_save-method-deprecated.change.md
new file mode 100644
index 000000000..cdbe99d90
--- /dev/null
+++ b/.hark/changes/2022-11-16_unknown_save-method-deprecated.change.md
@@ -0,0 +1,15 @@
+---
+title: The `save` method is deprecated. Prefer the static `update` method that doesn't require retrieval of the resource to update it.
+section: Deprecated
+released_in_version: 8.0.0
+---
+
+``` ruby
+# before
+refund = Stripe::Refund.retrieve("re_123")
+refund.description = "Refund description"
+refund.save
+
+# after
+Stripe::Refund.update("re_123", description: "Refund description")
+```
diff --git a/.hark/changes/2023-01-11_anniel_improve-request-events.change.md b/.hark/changes/2023-01-11_anniel_improve-request-events.change.md
new file mode 100644
index 000000000..e0a21090b
--- /dev/null
+++ b/.hark/changes/2023-01-11_anniel_improve-request-events.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve request events instrumentation
+pr_url: https://github.com/stripe/stripe-ruby/pull/1162
+released_in_version: 8.1.0
+---
diff --git a/.hark/changes/2023-01-23_richardm_remove-unused-partial.change.md b/.hark/changes/2023-01-23_richardm_remove-unused-partial.change.md
new file mode 100644
index 000000000..f9b8afad0
--- /dev/null
+++ b/.hark/changes/2023-01-23_richardm_remove-unused-partial.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove unused `partial` param from `initialize_from`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1171
+released_in_version: 8.2.0
+---
diff --git a/.hark/changes/2023-02-02_richardm_api-updates.change.md b/.hark/changes/2023-02-02_richardm_api-updates.change.md
new file mode 100644
index 000000000..161fa1ad9
--- /dev/null
+++ b/.hark/changes/2023-02-02_richardm_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1173
+is_stripe_api_change: true
+released_in_version: 8.2.0
+---
+
+* Add support for `resume` method on resource `Subscription`
diff --git a/.hark/changes/2023-02-16_anniel_api-updates.change.md b/.hark/changes/2023-02-16_anniel_api-updates.change.md
new file mode 100644
index 000000000..d4b7613ec
--- /dev/null
+++ b/.hark/changes/2023-02-16_anniel_api-updates.change.md
@@ -0,0 +1,8 @@
+---
+title: API Updates
+pr_url: https://github.com/stripe/stripe-ruby/pull/1175
+is_stripe_api_change: true
+released_in_version: 8.3.0
+---
+
+* Add support for `refund_payment` method on resource `Terminal.Reader`
diff --git a/.hark/changes/2023-02-21_pakrym_symbolize-hash-keys.change.md b/.hark/changes/2023-02-21_pakrym_symbolize-hash-keys.change.md
new file mode 100644
index 000000000..a3cd622f2
--- /dev/null
+++ b/.hark/changes/2023-02-21_pakrym_symbolize-hash-keys.change.md
@@ -0,0 +1,5 @@
+---
+title: Symbolize hash keys inside `convert_to_stripe_object_with_params`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1152
+released_in_version: 8.4.0
+---
diff --git a/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md b/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md
new file mode 100644
index 000000000..1e6b87192
--- /dev/null
+++ b/.hark/changes/2023-03-23_pakrym_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code (new)
+pr_url: https://github.com/stripe/stripe-ruby/pull/1197
+is_stripe_api_change: true
+released_in_version: 8.4.0
+---
+
+* Add support for new resources `Tax.CalculationLineItem`, `Tax.Calculation`, `Tax.TransactionLineItem`, and `Tax.Transaction`
+* Add support for `create` and `list_line_items` methods on resource `Calculation`
+* Add support for `create_from_calculation`, `create_reversal`, `create`, `list_line_items`, and `retrieve` methods on resource `Transaction`
diff --git a/.hark/changes/2023-03-29_anniel_update-save-deprecation.change.md b/.hark/changes/2023-03-29_anniel_update-save-deprecation.change.md
new file mode 100644
index 000000000..912cceae8
--- /dev/null
+++ b/.hark/changes/2023-03-29_anniel_update-save-deprecation.change.md
@@ -0,0 +1,5 @@
+---
+title: Update save deprecation message
+pr_url: https://github.com/stripe/stripe-ruby/pull/1201
+released_in_version: 8.5.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 000000000..cfc54071e
--- /dev/null
+++ b/.hark/changes/2023-03-30_anniel_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1203
+is_stripe_api_change: true
+released_in_version: 8.5.0
+---
+
+* Remove support for `create` method on resource `Tax.Transaction`
+  * This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the `create_from_calculation` method.
diff --git a/.hark/changes/2023-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 000000000..0956d1d98
--- /dev/null
+++ b/.hark/changes/2023-04-06_richardm_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1204
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-04-13_pakrym_update-shoulda-context.change.md b/.hark/changes/2023-04-13_pakrym_update-shoulda-context.change.md
new file mode 100644
index 000000000..06acd1d69
--- /dev/null
+++ b/.hark/changes/2023-04-13_pakrym_update-shoulda-context.change.md
@@ -0,0 +1,5 @@
+---
+title: Update shoulda-context version
+pr_url: https://github.com/stripe/stripe-ruby/pull/1209
+released_in_version: 8.6.0
+---
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 000000000..e84f464a1
--- /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-ruby/pull/1208
+is_stripe_api_change: true
+released_in_version: 8.6.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 000000000..08eb2cf5d
--- /dev/null
+++ b/.hark/changes/2023-04-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1215
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
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 000000000..bcd7c395c
--- /dev/null
+++ b/.hark/changes/2023-05-19_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1219
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
+
+Documentation updates.
diff --git a/.hark/changes/2023-05-23_pakrym_downgrade-jarowinkler.change.md b/.hark/changes/2023-05-23_pakrym_downgrade-jarowinkler.change.md
new file mode 100644
index 000000000..b4ac19369
--- /dev/null
+++ b/.hark/changes/2023-05-23_pakrym_downgrade-jarowinkler.change.md
@@ -0,0 +1,5 @@
+---
+title: Downgrade jaro_winkler
+pr_url: https://github.com/stripe/stripe-ruby/pull/1225
+released_in_version: 8.6.0
+---
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 000000000..c90cf43f3
--- /dev/null
+++ b/.hark/changes/2023-05-25_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1223
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
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 000000000..abed588b0
--- /dev/null
+++ b/.hark/changes/2023-06-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1226
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-06-13_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-13_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a33f627f2
--- /dev/null
+++ b/.hark/changes/2023-06-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1230
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
+
+* Release specs are identical.
diff --git a/.hark/changes/2023-06-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-06-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9bfc51d3a
--- /dev/null
+++ b/.hark/changes/2023-06-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1234
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-06-20_anniel_fix-variable-typo.change.md b/.hark/changes/2023-06-20_anniel_fix-variable-typo.change.md
new file mode 100644
index 000000000..7360aada6
--- /dev/null
+++ b/.hark/changes/2023-06-20_anniel_fix-variable-typo.change.md
@@ -0,0 +1,5 @@
+---
+title: "fix: variable typo in README for instrumentation"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1231
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-06-23_anniel_allow-error-string.change.md b/.hark/changes/2023-06-23_anniel_allow-error-string.change.md
new file mode 100644
index 000000000..e21070b15
--- /dev/null
+++ b/.hark/changes/2023-06-23_anniel_allow-error-string.change.md
@@ -0,0 +1,5 @@
+---
+title: Allow "error" string as log level
+pr_url: https://github.com/stripe/stripe-ruby/pull/1235
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-06-23_anniel_update-log-level.change.md b/.hark/changes/2023-06-23_anniel_update-log-level.change.md
new file mode 100644
index 000000000..1f17a9ca2
--- /dev/null
+++ b/.hark/changes/2023-06-23_anniel_update-log-level.change.md
@@ -0,0 +1,5 @@
+---
+title: Update log level error message to include `error`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1238
+released_in_version: 8.6.0
+---
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 000000000..20ee0d18f
--- /dev/null
+++ b/.hark/changes/2023-07-06_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1241
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
diff --git a/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..2d0a6a180
--- /dev/null
+++ b/.hark/changes/2023-07-13_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1244
+is_stripe_api_change: true
+released_in_version: 8.6.0
+---
+
+* Add support for new resource `Tax.Settings`
+* Add support for `retrieve` and `update` methods on resource `Settings`
diff --git a/.hark/changes/2023-08-10_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-10_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9832c2cfe
--- /dev/null
+++ b/.hark/changes/2023-08-10_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1256
+is_stripe_api_change: true
+released_in_version: 8.7.0
+---
+
+Add resources `Tax::CalculationLineItem`, `Tax::TransactionLineItem`, and `Treasury::FinancialAccountFeatures`. These resources have no methods on them, but do represent the return type of methods elsewhere.
diff --git a/.hark/changes/2023-08-16_anniel_1260-pin-latest.change.md b/.hark/changes/2023-08-16_anniel_1260-pin-latest.change.md
new file mode 100644
index 000000000..7de044660
--- /dev/null
+++ b/.hark/changes/2023-08-16_anniel_1260-pin-latest.change.md
@@ -0,0 +1,32 @@
+---
+title: "[#1260](https://github.com/stripe/stripe-ruby/pull/1260) Pin latest API version as the default"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1253
+released_in_version: 9.0.0
+---
+
+In this release, Stripe API Version `2023-08-16` (the latest at time of release) will be sent by default on all requests. This is a significant change with wide ramifications. The API version affects the properties you see on responses, the parameters you are allowed to send on requests, and so on. The previous default was to use your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version).
+
+To successfully upgrade to stripe-ruby v9, you must either
+
+1. **(Recommended) Upgrade your integration to be compatible with API Version `2023-08-16`.**
+
+   Please read the API Changelog carefully for each API Version from `2023-08-16` back to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe [Test Mode](https://stripe.com/docs/keys#test-live-modes) before deploying them to production.
+
+   You can read the [v9 migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v9) for more detailed instructions.
+2. **(Alternative option) Specify a version other than `2023-08-16` when initializing `stripe-ruby`.**
+
+   If you were previously initializing stripe-ruby without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version). For example:
+
+   ```diff
+     require 'stripe'
+     Stripe.api_key = "sk_test_..."
+   + Stripe.api_version = '2020-08-27'
+   ```
+
+   If you were already initializing stripe-ruby with an explicit API Version, upgrading to v9 will not affect your integration.
+
+   Read the [v9 migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v9) for more details.
+
+Going forward, each major release of this library will be *pinned* by default to the latest Stripe API Version at the time of release.
+
+That is, instead of upgrading stripe-ruby and separately upgrading your Stripe API Version through the Stripe Dashboard. whenever you upgrade major versions of stripe-ruby, you should also upgrade your integration to be compatible with the latest Stripe API version.
diff --git a/.hark/changes/2023-08-22_anniel_explicitly-format-timestamp.change.md b/.hark/changes/2023-08-22_anniel_explicitly-format-timestamp.change.md
new file mode 100644
index 000000000..badcc6799
--- /dev/null
+++ b/.hark/changes/2023-08-22_anniel_explicitly-format-timestamp.change.md
@@ -0,0 +1,5 @@
+---
+title: Explicitly format timestamp in SignatureVerificationError message
+pr_url: https://github.com/stripe/stripe-ruby/pull/1262
+released_in_version: 9.1.0
+---
diff --git a/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c82695e0c
--- /dev/null
+++ b/.hark/changes/2023-08-31_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1266
+is_stripe_api_change: true
+released_in_version: 9.1.0
+---
+
+* Add support for new resource `AccountSession`
+* Add support for `create` method on resource `AccountSession`
diff --git a/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5252cd6b9
--- /dev/null
+++ b/.hark/changes/2023-09-07_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1267
+is_stripe_api_change: true
+released_in_version: 9.2.0
+---
+
+* Add support for new resource `PaymentMethodDomain`
+* Add support for `create`, `list`, `retrieve`, `update`, and `validate` methods on resource `PaymentMethodDomain`
diff --git a/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..1af01c85d
--- /dev/null
+++ b/.hark/changes/2023-09-14_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1271
+is_stripe_api_change: true
+released_in_version: 9.3.0
+---
+
+* Add support for `capture`, `create`, `expire`, `increment`, and `reverse` test helper methods on resource `Issuing.Authorization`
+* Add support for `create_force_capture`, `create_unlinked_refund`, and `refund` test helper methods on resource `Issuing.Transaction`
diff --git a/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..39c7faa94
--- /dev/null
+++ b/.hark/changes/2023-09-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1272
+is_stripe_api_change: true
+released_in_version: 9.3.0
+---
+
+* Add support for new resource `PaymentMethodConfiguration`
+* Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
diff --git a/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0e9ff32a8
--- /dev/null
+++ b/.hark/changes/2023-10-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1277
+is_stripe_api_change: true
+released_in_version: 9.4.0
+---
+
+* Add support for new resources `Issuing.Token`
+* Add support for `list`, `retrieve`, and `update` methods on resource `Token`
diff --git a/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..06d231be6
--- /dev/null
+++ b/.hark/changes/2023-10-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1283
+is_stripe_api_change: true
+released_in_version: 10.0.0
+---
+
+- Updated pinned 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 000000000..9aff8a1ef
--- /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-ruby/pull/1281
+is_stripe_api_change: true
+released_in_version: 10.0.0
+---
+
+* Documentation only changes
diff --git a/.hark/changes/2023-10-16_unknown_please-read-api.change.md b/.hark/changes/2023-10-16_unknown_please-read-api.change.md
new file mode 100644
index 000000000..4f1b7964e
--- /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-ruby`.
+released_in_version: 10.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 000000000..be3a143ae
--- /dev/null
+++ b/.hark/changes/2023-11-02_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1286
+is_stripe_api_change: true
+released_in_version: 10.1.0
+---
+
+* Add support for new resource `Tax.Registration`
+* Add support for `create`, `list`, and `update` methods on resource `Registration`
diff --git a/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..df99d19ba
--- /dev/null
+++ b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1290
+is_stripe_api_change: true
+released_in_version: 10.2.0
+---
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 000000000..1879aeb38
--- /dev/null
+++ b/.hark/changes/2023-11-16_stripe-openapi_update-generated-code_2.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1288
+is_stripe_api_change: true
+released_in_version: 10.2.0
+---
diff --git a/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..49e0898cf
--- /dev/null
+++ b/.hark/changes/2023-11-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1291
+is_stripe_api_change: true
+released_in_version: 10.2.0
+---
diff --git a/.hark/changes/2023-11-28_richardm_upgrade-rubocop.change.md b/.hark/changes/2023-11-28_richardm_upgrade-rubocop.change.md
new file mode 100644
index 000000000..5fbd4c284
--- /dev/null
+++ b/.hark/changes/2023-11-28_richardm_upgrade-rubocop.change.md
@@ -0,0 +1,5 @@
+---
+title: Upgrade rubocop
+pr_url: https://github.com/stripe/stripe-ruby/pull/1295
+released_in_version: 10.2.0
+---
diff --git a/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b94a1b44c
--- /dev/null
+++ b/.hark/changes/2023-11-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1292
+is_stripe_api_change: true
+released_in_version: 10.2.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`
diff --git a/.hark/changes/2023-12-11_richardm_support-sending-parameters.change.md b/.hark/changes/2023-12-11_richardm_support-sending-parameters.change.md
new file mode 100644
index 000000000..273cb628f
--- /dev/null
+++ b/.hark/changes/2023-12-11_richardm_support-sending-parameters.change.md
@@ -0,0 +1,5 @@
+---
+title: Support sending parameters inside singleton retrieve
+pr_url: https://github.com/stripe/stripe-ruby/pull/1294
+released_in_version: 10.3.0
+---
diff --git a/.hark/changes/2023-12-21_pakrym_add-support-updatable.change.md b/.hark/changes/2023-12-21_pakrym_add-support-updatable.change.md
new file mode 100644
index 000000000..e21f9628a
--- /dev/null
+++ b/.hark/changes/2023-12-21_pakrym_add-support-updatable.change.md
@@ -0,0 +1,5 @@
+---
+title: Add support for updatable singleton resources
+pr_url: https://github.com/stripe/stripe-ruby/pull/1304
+released_in_version: 10.4.0
+---
diff --git a/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e5507c32b
--- /dev/null
+++ b/.hark/changes/2023-12-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1303
+is_stripe_api_change: true
+released_in_version: 10.4.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`
diff --git a/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-04_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c3ebac80e
--- /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-ruby/pull/1306
+is_stripe_api_change: true
+released_in_version: 10.5.0
+---
+
+* Add support for `retrieve` method on resource `Tax.Registration`
diff --git a/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..15daf77a5
--- /dev/null
+++ b/.hark/changes/2024-01-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1310
+is_stripe_api_change: true
+released_in_version: 10.6.0
+---
+
+* Add support for new resource `CustomerSession`
+* Add support for `create` method on resource `CustomerSession`
diff --git a/.hark/changes/2024-01-19_helenye_use-deprecation-gem.change.md b/.hark/changes/2024-01-19_helenye_use-deprecation-gem.change.md
new file mode 100644
index 000000000..b0b3dca91
--- /dev/null
+++ b/.hark/changes/2024-01-19_helenye_use-deprecation-gem.change.md
@@ -0,0 +1,5 @@
+---
+title: Use the deprecation gem in search and clean up usage of the gem
+pr_url: https://github.com/stripe/stripe-ruby/pull/1311
+released_in_version: 10.7.0
+---
diff --git a/.hark/changes/2024-01-30_helenye_remove-list-method.change.md b/.hark/changes/2024-01-30_helenye_remove-list-method.change.md
new file mode 100644
index 000000000..a9d738515
--- /dev/null
+++ b/.hark/changes/2024-01-30_helenye_remove-list-method.change.md
@@ -0,0 +1,7 @@
+---
+title: Remove list method in child resources
+pr_url: https://github.com/stripe/stripe-ruby/pull/1317
+released_in_version: 10.7.0
+---
+
+* Removes list method mixin from child resources, as these methods always return `InvalidRequestError` and never succeed
diff --git a/.hark/changes/2024-02-05_anniel_remove-spurious-search.change.md b/.hark/changes/2024-02-05_anniel_remove-spurious-search.change.md
new file mode 100644
index 000000000..0b5883911
--- /dev/null
+++ b/.hark/changes/2024-02-05_anniel_remove-spurious-search.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove spurious _search deprecation messages (https://github.com/stripe/stripe-ruby/issues/1319)
+pr_url: https://github.com/stripe/stripe-ruby/pull/1320
+released_in_version: 10.7.1
+---
diff --git a/.hark/changes/2024-02-05_helenye_update-mocha-gem.change.md b/.hark/changes/2024-02-05_helenye_update-mocha-gem.change.md
new file mode 100644
index 000000000..2c2419498
--- /dev/null
+++ b/.hark/changes/2024-02-05_helenye_update-mocha-gem.change.md
@@ -0,0 +1,5 @@
+---
+title: Update mocha gem to 1.16
+pr_url: https://github.com/stripe/stripe-ruby/pull/1314
+released_in_version: 10.8.0
+---
diff --git a/.hark/changes/2024-02-06_helenye_extract-other-crudl.change.md b/.hark/changes/2024-02-06_helenye_extract-other-crudl.change.md
new file mode 100644
index 000000000..59fa49a17
--- /dev/null
+++ b/.hark/changes/2024-02-06_helenye_extract-other-crudl.change.md
@@ -0,0 +1,7 @@
+---
+title: Extract other CRUDL api operations from mixins
+pr_url: https://github.com/stripe/stripe-ruby/pull/1323
+released_in_version: 10.8.0
+---
+
+* Extract more CRUDL operations, namely `create`, `delete`, `update`, and `list` into the resources. These methods will no longer rely on the APIOperation mixins.
diff --git a/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..d2e202c1d
--- /dev/null
+++ b/.hark/changes/2024-02-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1322
+is_stripe_api_change: true
+released_in_version: 10.8.0
+---
diff --git a/.hark/changes/2024-02-10_helenye_add-methods-dynamically.change.md b/.hark/changes/2024-02-10_helenye_add-methods-dynamically.change.md
new file mode 100644
index 000000000..117b66d30
--- /dev/null
+++ b/.hark/changes/2024-02-10_helenye_add-methods-dynamically.change.md
@@ -0,0 +1,5 @@
+---
+title: Add methods for dynamically referenced constants
+pr_url: https://github.com/stripe/stripe-ruby/pull/1327
+released_in_version: 10.9.0
+---
diff --git a/.hark/changes/2024-02-12_helenye_start-running-sorbet.change.md b/.hark/changes/2024-02-12_helenye_start-running-sorbet.change.md
new file mode 100644
index 000000000..06b8ce1fa
--- /dev/null
+++ b/.hark/changes/2024-02-12_helenye_start-running-sorbet.change.md
@@ -0,0 +1,5 @@
+---
+title: Start running Sorbet in CI
+pr_url: https://github.com/stripe/stripe-ruby/pull/1324
+released_in_version: 10.9.0
+---
diff --git a/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b9fead613
--- /dev/null
+++ b/.hark/changes/2024-02-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1329
+is_stripe_api_change: true
+released_in_version: 10.9.0
+---
+
+* Fixed bug where `TaxId` resource `delete` method sent request to wrong URL (https://github.com/stripe/stripe-ruby/issues/1333)
diff --git a/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md b/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md
new file mode 100644
index 000000000..ecff249f2
--- /dev/null
+++ b/.hark/changes/2024-02-22_anniel_add-taxids-api.change.md
@@ -0,0 +1,9 @@
+---
+title: Add TaxIds API
+pr_url: https://github.com/stripe/stripe-ruby/pull/1334
+released_in_version: 10.10.0
+---
+
+* Add support for `all`, `create`, and `retrieve` methods on resource `TaxId`
+* The `delete` method now sends a DELETE request to `/v1/tax_ids/{id}` instead of `/v1/customers/{customer}/tax_ids/{id}`. The endpoints are functionally the same when operating on a Customer Tax ID.
+* The `resource_url` method on `TaxId` now returns the top-level `/v1/tax_ids/{id}` path instead of the `/v1/customers/{customer}/tax_ids/{id}` path.
diff --git a/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..8f84a4e19
--- /dev/null
+++ b/.hark/changes/2024-02-22_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1336
+is_stripe_api_change: true
+released_in_version: 10.10.0
+---
+
+- Add `InvoiceLineItem.update` method.
diff --git a/.hark/changes/2024-02-28_helenye_update-readme-use.change.md b/.hark/changes/2024-02-28_helenye_update-readme-use.change.md
new file mode 100644
index 000000000..1508165b2
--- /dev/null
+++ b/.hark/changes/2024-02-28_helenye_update-readme-use.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README to use add_beta_version
+pr_url: https://github.com/stripe/stripe-ruby/pull/1345
+released_in_version: 10.11.0
+---
diff --git a/.hark/changes/2024-02-29_anniel_update-changelog-md.change.md b/.hark/changes/2024-02-29_anniel_update-changelog-md.change.md
new file mode 100644
index 000000000..6c2411aa6
--- /dev/null
+++ b/.hark/changes/2024-02-29_anniel_update-changelog-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update CHANGELOG.md
+pr_url: https://github.com/stripe/stripe-ruby/pull/1351
+released_in_version: 10.12.0
+---
diff --git a/.hark/changes/2024-02-29_helenye_use-sorbet-gem.change.md b/.hark/changes/2024-02-29_helenye_use-sorbet-gem.change.md
new file mode 100644
index 000000000..4da2feeff
--- /dev/null
+++ b/.hark/changes/2024-02-29_helenye_use-sorbet-gem.change.md
@@ -0,0 +1,5 @@
+---
+title: Use sorbet gem instead of sorbet-static
+pr_url: https://github.com/stripe/stripe-ruby/pull/1348
+released_in_version: 10.11.0
+---
diff --git a/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4ca14136c
--- /dev/null
+++ b/.hark/changes/2024-02-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1342
+is_stripe_api_change: true
+released_in_version: 10.11.0
+---
+
+* Add `list_refunds` and `retrieve_refund` methods on resource `Charge`.
diff --git a/.hark/changes/2024-03-01_anniel_disable-metrics-classlength.change.md b/.hark/changes/2024-03-01_anniel_disable-metrics-classlength.change.md
new file mode 100644
index 000000000..d18028fea
--- /dev/null
+++ b/.hark/changes/2024-03-01_anniel_disable-metrics-classlength.change.md
@@ -0,0 +1,5 @@
+---
+title: Disable Metrics/ClassLength
+pr_url: https://github.com/stripe/stripe-ruby/pull/1355
+released_in_version: 10.12.0
+---
diff --git a/.hark/changes/2024-03-07_helenye_reorder-methods-lexographica.change.md b/.hark/changes/2024-03-07_helenye_reorder-methods-lexographica.change.md
new file mode 100644
index 000000000..e8561ae65
--- /dev/null
+++ b/.hark/changes/2024-03-07_helenye_reorder-methods-lexographica.change.md
@@ -0,0 +1,5 @@
+---
+title: Reorder methods with lexographical sort
+pr_url: https://github.com/stripe/stripe-ruby/pull/1347
+released_in_version: 10.12.0
+---
diff --git a/.hark/changes/2024-03-11_helenye_refactor-after-sdk.change.md b/.hark/changes/2024-03-11_helenye_refactor-after-sdk.change.md
new file mode 100644
index 000000000..3b71b8584
--- /dev/null
+++ b/.hark/changes/2024-03-11_helenye_refactor-after-sdk.change.md
@@ -0,0 +1,5 @@
+---
+title: Refactor after SDK based generation pattern
+pr_url: https://github.com/stripe/stripe-ruby/pull/1354
+released_in_version: 10.12.0
+---
diff --git a/.hark/changes/2024-03-14_ramya_update-generated-code.change.md b/.hark/changes/2024-03-14_ramya_update-generated-code.change.md
new file mode 100644
index 000000000..9620fbeb0
--- /dev/null
+++ b/.hark/changes/2024-03-14_ramya_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1359
+is_stripe_api_change: true
+released_in_version: 10.12.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`
diff --git a/.hark/changes/2024-03-15_helenye_exclude-sorbet-directory.change.md b/.hark/changes/2024-03-15_helenye_exclude-sorbet-directory.change.md
new file mode 100644
index 000000000..05eb4f3c9
--- /dev/null
+++ b/.hark/changes/2024-03-15_helenye_exclude-sorbet-directory.change.md
@@ -0,0 +1,5 @@
+---
+title: Exclude sorbet directory and tapioca script when packing gem
+pr_url: https://github.com/stripe/stripe-ruby/pull/1362
+released_in_version: 10.13.0
+---
diff --git a/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..488f603a9
--- /dev/null
+++ b/.hark/changes/2024-03-21_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1367
+is_stripe_api_change: true
+released_in_version: 10.13.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`
diff --git a/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5875444c5
--- /dev/null
+++ b/.hark/changes/2024-03-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1369
+is_stripe_api_change: true
+released_in_version: 10.14.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`
diff --git a/.hark/changes/2024-04-05_helenye_move-executables-exe.change.md b/.hark/changes/2024-04-05_helenye_move-executables-exe.change.md
new file mode 100644
index 000000000..91bc359d0
--- /dev/null
+++ b/.hark/changes/2024-04-05_helenye_move-executables-exe.change.md
@@ -0,0 +1,5 @@
+---
+title: Move executables to `exe` folder
+pr_url: https://github.com/stripe/stripe-ruby/pull/1366
+released_in_version: 10.15.0
+---
diff --git a/.hark/changes/2024-04-09_helenye_add-lastresponse-stripeobject.change.md b/.hark/changes/2024-04-09_helenye_add-lastresponse-stripeobject.change.md
new file mode 100644
index 000000000..c05ae6a41
--- /dev/null
+++ b/.hark/changes/2024-04-09_helenye_add-lastresponse-stripeobject.change.md
@@ -0,0 +1,7 @@
+---
+title: Add last_response to StripeObject
+pr_url: https://github.com/stripe/stripe-ruby/pull/1377
+released_in_version: 10.15.0
+---
+
+* Users can now retrieve raw response from the returned resource, using the `last_response` property. See [README](https://github.com/stripe/stripe-ruby/blob/master/README.md) for an example.
diff --git a/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..f4e9b1c3c
--- /dev/null
+++ b/.hark/changes/2024-04-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1372
+is_stripe_api_change: true
+released_in_version: 10.15.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`
diff --git a/.hark/changes/2024-04-10_ramya_change-retry-logic.change.md b/.hark/changes/2024-04-10_ramya_change-retry-logic.change.md
new file mode 100644
index 000000000..134380161
--- /dev/null
+++ b/.hark/changes/2024-04-10_ramya_change-retry-logic.change.md
@@ -0,0 +1,11 @@
+---
+title: Change retry logic
+pr_url: https://github.com/stripe/stripe-ruby/pull/1374
+released_in_version: 11.0.0
+---
+
+* This release changes the pinned API version to `2024-04-10`. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-04-10) and carefully review the API changes before upgrading.
+
+### ⚠️ Breaking changes
+
+* When no `x-stripe-should-retry` header is set in the response, the library now retries all requests with `status >= 500`, not just non-POST methods.
diff --git a/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5511049af
--- /dev/null
+++ b/.hark/changes/2024-04-16_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1379
+is_stripe_api_change: true
+released_in_version: 11.1.0
+---
+
+* Add support for new resource `Entitlements.ActiveEntitlementSummary`
diff --git a/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..cd0478646
--- /dev/null
+++ b/.hark/changes/2024-04-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1385
+is_stripe_api_change: true
+released_in_version: 11.2.0
+---
+
+* Add support for `create_preview` method on resource `Invoice`
diff --git a/.hark/changes/2024-05-01_helenye_add-ruby-3.change.md b/.hark/changes/2024-05-01_helenye_add-ruby-3.change.md
new file mode 100644
index 000000000..998efbb31
--- /dev/null
+++ b/.hark/changes/2024-05-01_helenye_add-ruby-3.change.md
@@ -0,0 +1,5 @@
+---
+title: Add Ruby 3.3 to CI test matrix
+pr_url: https://github.com/stripe/stripe-ruby/pull/1391
+released_in_version: 11.3.0
+---
diff --git a/.hark/changes/2024-05-02_prathmesh_deprecate-ruby-methods.change.md b/.hark/changes/2024-05-02_prathmesh_deprecate-ruby-methods.change.md
new file mode 100644
index 000000000..594f22761
--- /dev/null
+++ b/.hark/changes/2024-05-02_prathmesh_deprecate-ruby-methods.change.md
@@ -0,0 +1,7 @@
+---
+title: Deprecate Ruby methods based on OpenAPI spec
+pr_url: https://github.com/stripe/stripe-ruby/pull/1392
+released_in_version: 11.3.0
+---
+
+- Mark as deprecated the `approve` and `decline` methods in `lib/stripe/resources/issuing/authorization.rb`. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
diff --git a/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3a8783208
--- /dev/null
+++ b/.hark/changes/2024-05-02_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1387
+is_stripe_api_change: true
+released_in_version: 11.3.0
+---
diff --git a/.hark/changes/2024-05-03_anniel_start-tracking-stripeclient.change.md b/.hark/changes/2024-05-03_anniel_start-tracking-stripeclient.change.md
new file mode 100644
index 000000000..eb5d7c1d6
--- /dev/null
+++ b/.hark/changes/2024-05-03_anniel_start-tracking-stripeclient.change.md
@@ -0,0 +1,5 @@
+---
+title: "Start tracking `StripeClient#request` usage"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1396
+released_in_version: 11.4.0
+---
diff --git a/.hark/changes/2024-05-06_prathmesh_removed-jarowinkler-dependency.change.md b/.hark/changes/2024-05-06_prathmesh_removed-jarowinkler-dependency.change.md
new file mode 100644
index 000000000..806618d21
--- /dev/null
+++ b/.hark/changes/2024-05-06_prathmesh_removed-jarowinkler-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Removed jaro_winkler as a dependency
+pr_url: https://github.com/stripe/stripe-ruby/pull/1389
+released_in_version: 11.4.0
+---
diff --git a/.hark/changes/2024-05-08_prathmesh_pass-params-transfer.change.md b/.hark/changes/2024-05-08_prathmesh_pass-params-transfer.change.md
new file mode 100644
index 000000000..af98f9218
--- /dev/null
+++ b/.hark/changes/2024-05-08_prathmesh_pass-params-transfer.change.md
@@ -0,0 +1,7 @@
+---
+title: Pass params to transfer reversal
+pr_url: https://github.com/stripe/stripe-ruby/pull/1399
+released_in_version: 11.4.0
+---
+
+* Allow `Stripe::Transfer.retrieve_reversal()` to accept a params hash as the third argument, followed by opts. No changes to existing calls are necessary, but in a future major version this method will be updated to only accept params as the first argument. Fixes [#1393](https://github.com/stripe/stripe-ruby/issues/1393)
diff --git a/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..ed719f530
--- /dev/null
+++ b/.hark/changes/2024-05-09_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1397
+is_stripe_api_change: true
+released_in_version: 11.4.0
+---
+
+* Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
diff --git a/.hark/changes/2024-05-23_unknown_release-changes.change.md b/.hark/changes/2024-05-23_unknown_release-changes.change.md
new file mode 100644
index 000000000..d5cc92677
--- /dev/null
+++ b/.hark/changes/2024-05-23_unknown_release-changes.change.md
@@ -0,0 +1,4 @@
+---
+title: This release has no changes.
+released_in_version: 11.5.0
+---
diff --git a/.hark/changes/2024-05-24_ramya_add-method-list.change.md b/.hark/changes/2024-05-24_ramya_add-method-list.change.md
new file mode 100644
index 000000000..708a7a3bc
--- /dev/null
+++ b/.hark/changes/2024-05-24_ramya_add-method-list.change.md
@@ -0,0 +1,7 @@
+---
+title: Add method to list invoice line items
+pr_url: https://github.com/stripe/stripe-ruby/pull/1404
+released_in_version: 11.6.0
+---
+
+* Add methods `list_lines()` on the class `Invoice` to list the invoice line items
diff --git a/.hark/changes/2024-06-12_anniel_deprecate-stripeclient-request.change.md b/.hark/changes/2024-06-12_anniel_deprecate-stripeclient-request.change.md
new file mode 100644
index 000000000..ca1e6a488
--- /dev/null
+++ b/.hark/changes/2024-06-12_anniel_deprecate-stripeclient-request.change.md
@@ -0,0 +1,7 @@
+---
+title: "Deprecate StripeClient#request"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1415
+released_in_version: 11.7.0
+---
+
+* Add deprecation warning for `StripeClient#request`. This helper method will be removed in a future major version. To access response objects, use the `last_response` property on the returned resource instead. Refer to [Accessing a response object](https://github.com/stripe/stripe-ruby?tab=readme-ov-file#accessing-a-response-object) in the README for usage details.
diff --git a/.hark/changes/2024-06-18_ramya_add-missing-static.change.md b/.hark/changes/2024-06-18_ramya_add-missing-static.change.md
new file mode 100644
index 000000000..a23270765
--- /dev/null
+++ b/.hark/changes/2024-06-18_ramya_add-missing-static.change.md
@@ -0,0 +1,5 @@
+---
+title: Add missing static method for verify on BankAccount
+pr_url: https://github.com/stripe/stripe-ruby/pull/1418
+released_in_version: 12.0.0
+---
diff --git a/.hark/changes/2024-06-24_stripe-openapi_please-read-api.change.md b/.hark/changes/2024-06-24_stripe-openapi_please-read-api.change.md
new file mode 100644
index 000000000..a72d6b738
--- /dev/null
+++ b/.hark/changes/2024-06-24_stripe-openapi_please-read-api.change.md
@@ -0,0 +1,9 @@
+---
+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-ruby/pull/1419
+released_in_version: 12.0.0
+---
+
+### Additions
+
+* Add support for `finalize_amount` test helper method on resource `Issuing.Authorization`
diff --git a/.hark/changes/2024-06-26_helenye_regenerate-rbis.change.md b/.hark/changes/2024-06-26_helenye_regenerate-rbis.change.md
new file mode 100644
index 000000000..cb72c279c
--- /dev/null
+++ b/.hark/changes/2024-06-26_helenye_regenerate-rbis.change.md
@@ -0,0 +1,5 @@
+---
+title: Regenerate rbis
+pr_url: https://github.com/stripe/stripe-ruby/pull/1427
+released_in_version: 12.1.0
+---
diff --git a/.hark/changes/2024-06-26_prathmesh_remove-coveralls-re.change.md b/.hark/changes/2024-06-26_prathmesh_remove-coveralls-re.change.md
new file mode 100644
index 000000000..39ce7f3a3
--- /dev/null
+++ b/.hark/changes/2024-06-26_prathmesh_remove-coveralls-re.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove coveralls and re-added JRuby
+pr_url: https://github.com/stripe/stripe-ruby/pull/1426
+released_in_version: 12.1.0
+---
diff --git a/.hark/changes/2024-06-27_ramya_update-static-methods.change.md b/.hark/changes/2024-06-27_ramya_update-static-methods.change.md
new file mode 100644
index 000000000..58f01ace8
--- /dev/null
+++ b/.hark/changes/2024-06-27_ramya_update-static-methods.change.md
@@ -0,0 +1,14 @@
+---
+title: Update static methods for delete/list on BankAccount/Card to throw NotImplementedError
+pr_url: https://github.com/stripe/stripe-ruby/pull/1420
+released_in_version: 12.1.0
+---
+
+* The below methods have been throwing `InvalidRequestError` because the urls used to make the requests have been buggy. Updating them to throw `NotImplementedError` instead just like their counterparts for update & retrieve because they cannot be implemented without the parent id.
+
+Methods affected | Use these instead in the context of payment method | Use these in the context of external accounts
+------ | ------ | ----
+Stripe:: BankAccount.delete | Stripe::Customer.delete_source | Stripe::Account.delete_external_account
+Stripe:: BankAccount.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
+Stripe:: Card.delete | Stripe::Customer.delete_source | Stripe::Account.delete_external_account
+Stripe:: Card.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
diff --git a/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..143f451a6
--- /dev/null
+++ b/.hark/changes/2024-07-05_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1425
+is_stripe_api_change: true
+released_in_version: 12.1.0
+---
+
+* Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
diff --git a/.hark/changes/2024-07-10_helenye_add-rawrequest.change.md b/.hark/changes/2024-07-10_helenye_add-rawrequest.change.md
new file mode 100644
index 000000000..0407ce172
--- /dev/null
+++ b/.hark/changes/2024-07-10_helenye_add-rawrequest.change.md
@@ -0,0 +1,7 @@
+---
+title: Add `raw_request`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1431
+released_in_version: 12.2.0
+---
+
+- Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. This is an alternative to using `Stripe::APIResource.request(...)` to make custom requests, which is discouraged and will be broken in a future major version.
diff --git a/.hark/changes/2024-07-11_helenye_add-usage-rawrequest.change.md b/.hark/changes/2024-07-11_helenye_add-usage-rawrequest.change.md
new file mode 100644
index 000000000..b313d8d88
--- /dev/null
+++ b/.hark/changes/2024-07-11_helenye_add-usage-rawrequest.change.md
@@ -0,0 +1,5 @@
+---
+title: Add usage to raw_request call
+pr_url: https://github.com/stripe/stripe-ruby/pull/1433
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2024-07-12_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-12_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..6e7b5bf6c
--- /dev/null
+++ b/.hark/changes/2024-07-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,6 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1430
+is_stripe_api_change: true
+released_in_version: 12.2.0
+---
diff --git a/.hark/changes/2024-07-16_helenye_add-deprecation-warning.change.md b/.hark/changes/2024-07-16_helenye_add-deprecation-warning.change.md
new file mode 100644
index 000000000..99a881076
--- /dev/null
+++ b/.hark/changes/2024-07-16_helenye_add-deprecation-warning.change.md
@@ -0,0 +1,5 @@
+---
+title: Add deprecation warning for `APIResource.request`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1435
+released_in_version: 12.3.0
+---
diff --git a/.hark/changes/2024-07-17_prathmesh_fixed-changelog-major.change.md b/.hark/changes/2024-07-17_prathmesh_fixed-changelog-major.change.md
new file mode 100644
index 000000000..e3fbbb1d4
--- /dev/null
+++ b/.hark/changes/2024-07-17_prathmesh_fixed-changelog-major.change.md
@@ -0,0 +1,5 @@
+---
+title: Fixed changelog for major release 12.0.0
+pr_url: https://github.com/stripe/stripe-ruby/pull/1436
+released_in_version: 12.3.0
+---
diff --git a/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-07-25_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..a203fe1b9
--- /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-ruby/pull/1437
+is_stripe_api_change: true
+released_in_version: 12.4.0
+---
+
+* Add support for `update` method on resource `Checkout.Session`
diff --git a/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..4c79fe422
--- /dev/null
+++ b/.hark/changes/2024-08-08_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1440
+is_stripe_api_change: true
+released_in_version: 12.5.0
+---
+
+* Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`
+* Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Alert`
+* Add support for `retrieve` method on resource `Tax.Calculation`
diff --git a/.hark/changes/2024-08-29_prathmesh_removed-v1-files.change.md b/.hark/changes/2024-08-29_prathmesh_removed-v1-files.change.md
new file mode 100644
index 000000000..41666488d
--- /dev/null
+++ b/.hark/changes/2024-08-29_prathmesh_removed-v1-files.change.md
@@ -0,0 +1,5 @@
+---
+title: Removed v1/files override
+pr_url: https://github.com/stripe/stripe-ruby/pull/1443
+released_in_version: 12.6.0
+---
diff --git a/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..002e7b13c
--- /dev/null
+++ b/.hark/changes/2024-09-12_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1442
+is_stripe_api_change: true
+released_in_version: 12.6.0
+---
+
+* Add support for new resource `InvoiceRenderingTemplate`
+* Add support for `archive`, `list`, `retrieve`, and `unarchive` methods on resource `InvoiceRenderingTemplate`
diff --git a/.hark/changes/2024-10-01_ramya_support-apis-new.change.md b/.hark/changes/2024-10-01_ramya_support-apis-new.change.md
new file mode 100644
index 000000000..5c1906cba
--- /dev/null
+++ b/.hark/changes/2024-10-01_ramya_support-apis-new.change.md
@@ -0,0 +1,71 @@
+---
+title: Support for APIs in the new API version 2024-09-30.acacia
+pr_url: https://github.com/stripe/stripe-ruby/pull/1458
+is_stripe_api_change: true
+released_in_version: 13.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
+
+Please refer to our [migration guide for v13](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v13) for more information about the backwards incompatible changes.
+
+#### ❗ `StripeClient` and related changes
+* Move `StripeClient` and requestor logic to `APIRequestor`.
+  * `StripeClient#request` is still available, but is deprecated and will be removed. We encourage `StripeClient#raw_request` as a replacement (see other breaking changes for more detail).
+* Repurpose and introduce `StripeClient` as the the entry-point to the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm. Services are available under the `v1` and `v2` accessors.
+    * 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.
+
+#### Other breaking changes
+
+* Adjust default values around retries for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
+  - max retries: `0` -> `2`
+  - max retry delay (seconds) `2` -> `5`
+* Remove `StripeClient#connection_manager`. This was a legacy method from years ago.
+* Singleton `retrieve` method now requires `params` to be passed as the first argument. Existing calls to singleton `retrieve` method with only `opts` argument will have to be updated to account for the addition of `params` argument.
+    ```ruby
+    params = { expand: ["available"] }
+    opts = { stripe_account: "acct_123" }
+
+    # ❌ No longer works
+    Stripe::Balance.retrieve(opts)
+
+    # ✅ Correct way to call retrieve method
+    Stripe::Balance.retrieve(params, opts)
+    ```
+* Moved the `Stripe.raw_request()` method that was recently added to `StripeClient`. This will use the configuration set on the StripeClient instead of the global configuration used before.
+* Remove `APIResource.request`. Instead, use `StripeClient#raw_request` now.
+    ```ruby
+    # Instead of
+    Stripe::APIResource.request(:get, "/v1/endpoint", params, opts)
+
+    # do
+    client = Stripe::StripeClient.new(...)
+    resp = client.raw_request(:get, "/v1/endpoint", params: params, opts: opts)
+    ```
+* Add an additional parameter to `APIResource.execute_resource_request`. However, we discourage use of this in favor of `StripeClient#raw_request`.
+    ```ruby
+    APIResource.execute_resource_request(method, url, params = {}, opts = {}, usage = [])
+    # is now, with base_address being one of [:api, :files, :connect, :meter_events]
+    APIResource.execute_resource_request(method, url, base_address = :api, params = {}, opts = {}, usage = [])
+    ```
+* Change parameters to `APIRequestor.execute_request` (previously `StripeClient.execute_request`). It now returns all request options from our internal request framework as the second value in the returned tuple, instead of only the API key used:
+  ```ruby
+  # Before
+  obj, api_key = StripeClient.execute_request(method, path, api_base: nil,
+                                              api_key: nil, headers: {}, params: {}, usage: [])
+
+  # is now, with base_address being one of [:api, :files, :connect, :meter_events]
+
+  obj, opts = APIRequestor.execute_request(method, path, base_address,
+                                          params: {}, opts: {}, usage: [])
+  puts(opts) # will output {api_key: "sk_test_123", stripe_account: "acct_123"}
+  ```
+
+
+### Additions
+* Add support for new Usage Billing APIs `Billing.MeterEvent`, `Billing.MeterEventAdjustments`, `Billing.MeterEventSession`, `Billing.MeterEventStream` and the new Events API `Core.Events` in the [v2 namespace ](https://docs.corp.stripe.com/api-v2-overview)
+* Add method `parse_thin_event()` on the `StripeClient` class to parse [thin events](https://docs.corp.stripe.com/event-destinations#events-overview).
diff --git a/.hark/changes/2024-10-10_jar_cleaned-up-examples.change.md b/.hark/changes/2024-10-10_jar_cleaned-up-examples.change.md
new file mode 100644
index 000000000..e8d1f1d44
--- /dev/null
+++ b/.hark/changes/2024-10-10_jar_cleaned-up-examples.change.md
@@ -0,0 +1,5 @@
+---
+title: Cleaned up examples and added documentation
+pr_url: https://github.com/stripe/stripe-ruby/pull/1470
+released_in_version: 13.0.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 000000000..83a5c61cf
--- /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-ruby/pull/1471
+released_in_version: 13.0.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_helenye_always-return-result.change.md b/.hark/changes/2024-10-23_helenye_always-return-result.change.md
new file mode 100644
index 000000000..90973def6
--- /dev/null
+++ b/.hark/changes/2024-10-23_helenye_always-return-result.change.md
@@ -0,0 +1,7 @@
+---
+title: "Always return the result of APIResource#refresh in APIResource.retrieve"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1473
+released_in_version: 13.0.2
+---
+
+* Fix bug where we would not return the mutated `self` object when calling `APIResource.retrieve`
diff --git a/.hark/changes/2024-10-28_helenye_fix-apiresource-retrieve.change.md b/.hark/changes/2024-10-28_helenye_fix-apiresource-retrieve.change.md
new file mode 100644
index 000000000..b88729f8f
--- /dev/null
+++ b/.hark/changes/2024-10-28_helenye_fix-apiresource-retrieve.change.md
@@ -0,0 +1,7 @@
+---
+title: "Fix APIResource#retrieve bug not returning instance of custom resources"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1476
+released_in_version: 13.1.0
+---
+
+* Fix bug in APIResource#refresh and APIResource#retrieve where they returned an instance of `StripeObject` for custom resources. They should now return the instance of the custom resource.
diff --git a/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..bd677d9d9
--- /dev/null
+++ b/.hark/changes/2024-10-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1472
+is_stripe_api_change: true
+released_in_version: 13.1.0
+---
+
+* Add support for `submit_card` test helper method on resource `Issuing.Card`
+* Add support for new resource `V2.EventDestinations`
+* Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
diff --git a/.hark/changes/2024-11-06_helenye_fix-apiresource-retrieve.change.md b/.hark/changes/2024-11-06_helenye_fix-apiresource-retrieve.change.md
new file mode 100644
index 000000000..13db3c1eb
--- /dev/null
+++ b/.hark/changes/2024-11-06_helenye_fix-apiresource-retrieve.change.md
@@ -0,0 +1,5 @@
+---
+title: "Fix APIResource#retrieve not sending `stripe_version`"
+pr_url: https://github.com/stripe/stripe-ruby/pull/1483
+released_in_version: 13.1.1
+---
diff --git a/.hark/changes/2024-11-15_helenye_fix-incorrect-key.change.md b/.hark/changes/2024-11-15_helenye_fix-incorrect-key.change.md
new file mode 100644
index 000000000..71b014576
--- /dev/null
+++ b/.hark/changes/2024-11-15_helenye_fix-incorrect-key.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix incorrect key in param encoding
+pr_url: https://github.com/stripe/stripe-ruby/pull/1488
+released_in_version: 13.1.2
+---
diff --git a/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..b78899acb
--- /dev/null
+++ b/.hark/changes/2024-11-20_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1486
+released_in_version: 13.2.0
+---
+
+* Add support for `respond` test helper method on resource `Issuing.Authorization`
diff --git a/.hark/changes/2024-12-17_helenye_pass-requestor-all.change.md b/.hark/changes/2024-12-17_helenye_pass-requestor-all.change.md
new file mode 100644
index 000000000..f1bba298a
--- /dev/null
+++ b/.hark/changes/2024-12-17_helenye_pass-requestor-all.change.md
@@ -0,0 +1,7 @@
+---
+title: Pass requestor to all deserialized objects including lists
+pr_url: https://github.com/stripe/stripe-ruby/pull/1507
+released_in_version: 13.3.0
+---
+
+* Fixes bug where `StripeObject` retrieved from lists could not be used to make requests, such as `refresh`
diff --git a/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md b/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..2a9977189
--- /dev/null
+++ b/.hark/changes/2024-12-18_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,5 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1500
+released_in_version: 13.3.0
+---
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 000000000..f6af324e3
--- /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-ruby/pull/1508
+released_in_version: 13.3.1
+---
diff --git a/.hark/changes/2025-01-13_helenye_import-global-configuratio.change.md b/.hark/changes/2025-01-13_helenye_import-global-configuratio.change.md
new file mode 100644
index 000000000..e70124032
--- /dev/null
+++ b/.hark/changes/2025-01-13_helenye_import-global-configuratio.change.md
@@ -0,0 +1,7 @@
+---
+title: Import global configuration for options not available on StripeClient options
+pr_url: https://github.com/stripe/stripe-ruby/pull/1512
+released_in_version: 13.3.1
+---
+
+* Fixes bug where `StripeClient` was not falling back to global options for options that are not available to be set per-client
diff --git a/.hark/changes/2025-01-13_jar_pin-ubuntu-version.change.md b/.hark/changes/2025-01-13_jar_pin-ubuntu-version.change.md
new file mode 100644
index 000000000..8d3f71e50
--- /dev/null
+++ b/.hark/changes/2025-01-13_jar_pin-ubuntu-version.change.md
@@ -0,0 +1,5 @@
+---
+title: Pin ubuntu version in Test action
+pr_url: https://github.com/stripe/stripe-ruby/pull/1518
+released_in_version: 13.3.1
+---
diff --git a/.hark/changes/2025-01-13_jar_thinevent-reason-livemode.change.md b/.hark/changes/2025-01-13_jar_thinevent-reason-livemode.change.md
new file mode 100644
index 000000000..460d30263
--- /dev/null
+++ b/.hark/changes/2025-01-13_jar_thinevent-reason-livemode.change.md
@@ -0,0 +1,7 @@
+---
+title: ThinEvent reason and livemode
+pr_url: https://github.com/stripe/stripe-ruby/pull/1516
+released_in_version: 13.3.1
+---
+
+- Add `livemode` and optional `reason` fields to ThinEvent
diff --git a/.hark/changes/2025-01-15_jar_added-contributing-md.change.md b/.hark/changes/2025-01-15_jar_added-contributing-md.change.md
new file mode 100644
index 000000000..53d6dc844
--- /dev/null
+++ b/.hark/changes/2025-01-15_jar_added-contributing-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Added CONTRIBUTING.md file
+pr_url: https://github.com/stripe/stripe-ruby/pull/1515
+released_in_version: 13.4.0
+---
diff --git a/.hark/changes/2025-01-16_xavdid_add-justfile.change.md b/.hark/changes/2025-01-16_xavdid_add-justfile.change.md
new file mode 100644
index 000000000..bb0a8048b
--- /dev/null
+++ b/.hark/changes/2025-01-16_xavdid_add-justfile.change.md
@@ -0,0 +1,5 @@
+---
+title: add justfile
+pr_url: https://github.com/stripe/stripe-ruby/pull/1513
+released_in_version: 13.4.0
+---
diff --git a/.hark/changes/2025-01-17_jar_fixed-typos-contributing.change.md b/.hark/changes/2025-01-17_jar_fixed-typos-contributing.change.md
new file mode 100644
index 000000000..3da352fc3
--- /dev/null
+++ b/.hark/changes/2025-01-17_jar_fixed-typos-contributing.change.md
@@ -0,0 +1,5 @@
+---
+title: Fixed typos in CONTRIBUTING.MD
+pr_url: https://github.com/stripe/stripe-ruby/pull/1519
+released_in_version: 13.4.0
+---
diff --git a/.hark/changes/2025-01-17_xavdid_pipe-rubocop-output.change.md b/.hark/changes/2025-01-17_xavdid_pipe-rubocop-output.change.md
new file mode 100644
index 000000000..c681d79d2
--- /dev/null
+++ b/.hark/changes/2025-01-17_xavdid_pipe-rubocop-output.change.md
@@ -0,0 +1,5 @@
+---
+title: pipe rubocop output to devnull
+pr_url: https://github.com/stripe/stripe-ruby/pull/1521
+released_in_version: 13.4.0
+---
diff --git a/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..d8aae6bd2
--- /dev/null
+++ b/.hark/changes/2025-01-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1510
+is_stripe_api_change: true
+released_in_version: 13.4.0
+---
+
+* Add support for `close` method on resource `Treasury.FinancialAccount`
diff --git a/.hark/changes/2025-01-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-01-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..d2fb8c8d5
--- /dev/null
+++ b/.hark/changes/2025-01-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1528
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 13.4.1
+---
+
+* ⚠️ Bugfix: `invoice` and `line_item_id` can be passed to `update` method in `InvoiceLineItem`.
diff --git a/.hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md b/.hark/changes/2025-02-13_xavdid_add-codeowners-file.change.md
new file mode 100644
index 000000000..5017e5340
--- /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-ruby/pull/1533
+released_in_version: 13.5.0
+---
diff --git a/.hark/changes/2025-02-21_helenye_fix-invoicelinei-parent.change.md b/.hark/changes/2025-02-21_helenye_fix-invoicelinei-parent.change.md
new file mode 100644
index 000000000..61565c80b
--- /dev/null
+++ b/.hark/changes/2025-02-21_helenye_fix-invoicelinei-parent.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix InvoiceLineItem parent class
+pr_url: https://github.com/stripe/stripe-ruby/pull/1536
+released_in_version: 13.5.0
+---
+
+* Fix bug where `Stripe::InvoiceLineItem` had the incorrect parent class, making it error when `update` was called
diff --git a/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..1a2839cd9
--- /dev/null
+++ b/.hark/changes/2025-02-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,8 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1534
+is_stripe_api_change: true
+released_in_version: 13.5.0
+---
+
+* Fixed `Stripe::InvoiceLineItem.update` method.
diff --git a/.hark/changes/2025-03-31_helenye_add-rbi-annotations.change.md b/.hark/changes/2025-03-31_helenye_add-rbi-annotations.change.md
new file mode 100644
index 000000000..daeeb1b1d
--- /dev/null
+++ b/.hark/changes/2025-03-31_helenye_add-rbi-annotations.change.md
@@ -0,0 +1,9 @@
+---
+title: Add RBI annotations for fields and params
+pr_url: https://github.com/stripe/stripe-ruby/pull/1559
+released_in_version: 14.0.0
+---
+
+* Adds explicit field types for resources and parameters for methods, and add RBI static annotations for all resources and services
+![image](https://github.com/user-attachments/assets/1b6cd994-d3ea-4f47-8487-f5c7b9ebf885)
+* See [the wiki](https://github.com/stripe/stripe-ruby/wiki/Static-Type-Annotations) for more details
diff --git a/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md b/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md
new file mode 100644
index 000000000..90e5f99c1
--- /dev/null
+++ b/.hark/changes/2025-03-31_stripe-openapi_support-apis-new.change.md
@@ -0,0 +1,28 @@
+---
+title: Support for APIs in the new API version 2025-03-31.basil
+pr_url: https://github.com/stripe/stripe-ruby/pull/1543
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 14.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`
+
+### ⚠️ Other breaking changes in the SDK
+* [#1553](https://github.com/stripe/stripe-ruby/pull/1553) Remove public idempotent_replayed? method
+  * ⚠️ Remove the `idempotent_replayed?` method on `StripeError`
+    * The information is accessible indirectly via the raw response headers, `StripeResponse.http_headers`. For example, use `resource.last_response.http_headers['Idempotent-Replayed']`
+
+### Additions to the Stripe API
+
+* Add support for new resource `InvoicePayment`
+* Add support for `list` and `retrieve` methods on resource `InvoicePayment`
diff --git a/.hark/changes/2025-04-08_helenye_validate-all-instance.change.md b/.hark/changes/2025-04-08_helenye_validate-all-instance.change.md
new file mode 100644
index 000000000..3b3d3166b
--- /dev/null
+++ b/.hark/changes/2025-04-08_helenye_validate-all-instance.change.md
@@ -0,0 +1,14 @@
+---
+title: Validate all instance variable keys returned from the API
+pr_url: https://github.com/stripe/stripe-ruby/pull/1571
+section: Breaking change
+released_in_version: 15.0.0
+---
+
+* Validate all keys returned from the API, including custom response fields, to make sure they can be set in an instance variable, as brought up in https://github.com/stripe/stripe-ruby/issues/1564
+  * We do not set instance variables for invalid field names (as defined by the [Ruby spec](https://ruby-doc.org/docs/ruby-doc-bundle/Manual/man-1.4/syntax.html#ident)). We recommend for custom hash map response fields, use the `[]` accessor.
+     ```ruby
+     c = client.v1.customers.retrieve("cus_123")
+     c.metadata["invalid-variable-name!"]
+     c.metadata["valid_key_name_works_too"]
+    ```
diff --git a/.hark/changes/2025-04-08_ramya_remove-link-stale.change.md b/.hark/changes/2025-04-08_ramya_remove-link-stale.change.md
new file mode 100644
index 000000000..0634d68c7
--- /dev/null
+++ b/.hark/changes/2025-04-08_ramya_remove-link-stale.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove link for stale youtube video playlist
+pr_url: https://github.com/stripe/stripe-ruby/pull/1573
+section: Breaking change
+released_in_version: 15.0.0
+---
diff --git a/.hark/changes/2025-04-08_ramya_remove-unused-youtube.change.md b/.hark/changes/2025-04-08_ramya_remove-unused-youtube.change.md
new file mode 100644
index 000000000..fbf744de6
--- /dev/null
+++ b/.hark/changes/2025-04-08_ramya_remove-unused-youtube.change.md
@@ -0,0 +1,6 @@
+---
+title: Remove unused youtube playlist link
+pr_url: https://github.com/stripe/stripe-ruby/pull/1575
+section: Breaking change
+released_in_version: 15.0.0
+---
diff --git a/.hark/changes/2025-04-09_helenye_explicitly-pass-through.change.md b/.hark/changes/2025-04-09_helenye_explicitly-pass-through.change.md
new file mode 100644
index 000000000..ff5483f70
--- /dev/null
+++ b/.hark/changes/2025-04-09_helenye_explicitly-pass-through.change.md
@@ -0,0 +1,8 @@
+---
+title: Explicitly pass through custom headers in retrieve
+pr_url: https://github.com/stripe/stripe-ruby/pull/1576
+section: Breaking change
+released_in_version: 15.0.0
+---
+
+* Fix custom options passing for resource-based retrieve
diff --git a/.hark/changes/2025-04-09_helenye_rename-objectid-v2.change.md b/.hark/changes/2025-04-09_helenye_rename-objectid-v2.change.md
new file mode 100644
index 000000000..4643f919d
--- /dev/null
+++ b/.hark/changes/2025-04-09_helenye_rename-objectid-v2.change.md
@@ -0,0 +1,10 @@
+---
+title: Rename `object_id` in V2::Core::EventService::ListParams to `object_id_`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1574
+semver_level: major
+section: Breaking change
+released_in_version: 15.0.0
+---
+
+* ⚠️ Change name of parameter from `object_id` to `object_id_` on `Stripe::V2::Core::EventService::ListParams` to avoid conflict with Ruby native attribute, as found in https://github.com/stripe/stripe-ruby/issues/1567
+* This is a no-op unless you are using this specific parameter that was introduced in `v14.0.0`
diff --git a/.hark/changes/2025-04-11_prathmesh_added-rubocop-exclusion.change.md b/.hark/changes/2025-04-11_prathmesh_added-rubocop-exclusion.change.md
new file mode 100644
index 000000000..b256e0e07
--- /dev/null
+++ b/.hark/changes/2025-04-11_prathmesh_added-rubocop-exclusion.change.md
@@ -0,0 +1,5 @@
+---
+title: Added rubocop exclusion for generated tests
+pr_url: https://github.com/stripe/stripe-ruby/pull/1581
+released_in_version: 15.1.0
+---
diff --git a/.hark/changes/2025-04-15_prathmesh_include-new-ruby.change.md b/.hark/changes/2025-04-15_prathmesh_include-new-ruby.change.md
new file mode 100644
index 000000000..13bb2dd15
--- /dev/null
+++ b/.hark/changes/2025-04-15_prathmesh_include-new-ruby.change.md
@@ -0,0 +1,5 @@
+---
+title: Include new Ruby 3.4 in CI
+pr_url: https://github.com/stripe/stripe-ruby/pull/1583
+released_in_version: 15.1.0
+---
diff --git a/.hark/changes/2025-04-16_prathmesh_updated-rubocop-1.change.md b/.hark/changes/2025-04-16_prathmesh_updated-rubocop-1.change.md
new file mode 100644
index 000000000..5fa3a58f7
--- /dev/null
+++ b/.hark/changes/2025-04-16_prathmesh_updated-rubocop-1.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated rubocop from 1.57.2 to 1.75.2
+pr_url: https://github.com/stripe/stripe-ruby/pull/1585
+released_in_version: 15.1.0
+---
diff --git a/.hark/changes/2025-04-21_helenye_explicitly-pass-through.change.md b/.hark/changes/2025-04-21_helenye_explicitly-pass-through.change.md
new file mode 100644
index 000000000..7b1e07de2
--- /dev/null
+++ b/.hark/changes/2025-04-21_helenye_explicitly-pass-through.change.md
@@ -0,0 +1,7 @@
+---
+title: Explicitly pass through custom headers in retrieve
+pr_url: https://github.com/stripe/stripe-ruby/pull/1576
+released_in_version: 13.5.1
+---
+
+* Fix custom options passing for resource-based retrieve
diff --git a/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..c9bff57fc
--- /dev/null
+++ b/.hark/changes/2025-04-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,23 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1566
+is_stripe_api_change: true
+released_in_version: 15.1.0
+---
+
+* Add support for `minority_owned_business_designation` on `Account::BusinessProfile`, `Account::CreateParams::BusinessProfile`, and `Account::UpdateParams::BusinessProfile`
+* Add support for `registration_date` on `Account::Company`, `Account::CreateParams::Company`, `Account::UpdateParams::Company`, and `Token::CreateParams::Account::Company`
+* Add support for `us_cfpb_data` on `Account::CreateParams`, `Account::UpdateParams`, `AccountPerson::CreateParams`, `AccountPerson::UpdateParams`, `Person`, and `Token::CreateParams::Person`
+* Add support for `tax_id` on `Charge::BillingDetail`, `ConfirmationToken::CreateParams::PaymentMethodDatum::BillingDetail`, `ConfirmationToken::PaymentMethodPreview::BillingDetail`, `PaymentIntent::ConfirmParams::PaymentMethodDatum::BillingDetail`, `PaymentIntent::CreateParams::PaymentMethodDatum::BillingDetail`, `PaymentIntent::UpdateParams::PaymentMethodDatum::BillingDetail`, `PaymentMethod::BillingDetail`, `PaymentMethod::CreateParams::BillingDetail`, `PaymentMethod::UpdateParams::BillingDetail`, `SetupIntent::ConfirmParams::PaymentMethodDatum::BillingDetail`, `SetupIntent::CreateParams::PaymentMethodDatum::BillingDetail`, `SetupIntent::UpdateParams::PaymentMethodDatum::BillingDetail`, `TestHelpers::ConfirmationToken::CreateParams::PaymentMethodDatum::BillingDetail`, and `Treasury::OutboundPayment::CreateParams::DestinationPaymentMethodDatum::BillingDetail`
+* Add support for `wallet_options` on `Checkout::Session::CreateParams` and `Checkout::Session`
+* Add support for `provider` on `Checkout::Session::AutomaticTax`, `Invoice::AutomaticTax`, and `Quote::AutomaticTax`
+* Add support for `payment_method_options` on `ConfirmationToken::CreateParams` and `TestHelpers::ConfirmationToken::CreateParams`
+* Add support for `installments` on `ConfirmationToken::PaymentMethodOption::Card`
+* Add support for `context` on `Event`
+* Change type of `InvoiceLineItem::Parent::SubscriptionItemDetail.subscription` from `string` to `nullable(string)`
+* Add support for `billie` on `PaymentIntent::ConfirmParams::PaymentMethodOption`, `PaymentIntent::CreateParams::PaymentMethodOption`, `PaymentIntent::PaymentMethodOption`, and `PaymentIntent::UpdateParams::PaymentMethodOption`
+* Add support for `pix` on `PaymentMethodConfiguration::CreateParams`, `PaymentMethodConfiguration::UpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `klarna` on `PaymentMethodDomain`
+* Add support for `pending_reason` on `Refund`
+* Change type of `Tax::CalculationLineItem.reference` from `nullable(string)` to `string`
+* Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `Tax::Registration::CountryOption` and `Tax::Registration::CreateParams::CountryOption`
diff --git a/.hark/changes/2025-05-02_jar_adds-contributing-md.change.md b/.hark/changes/2025-05-02_jar_adds-contributing-md.change.md
new file mode 100644
index 000000000..414fb0ef5
--- /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-ruby/pull/1601
+released_in_version: 15.2.0
+---
diff --git a/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..94ac760ea
--- /dev/null
+++ b/.hark/changes/2025-05-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,29 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1605
+is_stripe_api_change: true
+released_in_version: 15.2.0
+---
+
+* Add support for `attach_payment` method on resource `Invoice`
+* Add support for `collect_inputs` method on resource `Terminal::Reader`
+* Add support for `succeed_input_collection` and `timeout_input_collection` test helper methods on resource `Terminal::Reader`
+* Add support for `pix_payments` on `Account::Capability`, `Account::CreateParams::Capability`, and `Account::UpdateParams::Capability`
+* Add support for `disputes_list` and `payment_disputes` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
+* Add support for `refund_and_dispute_prefunding` on `Balance`
+* Add support for `balance_type` on `BalanceTransaction`
+* Change `Billing::Alert::CreateParams::UsageThreshold.meter` to be required
+* Add support for `location` and `reader` on `Charge::PaymentMethodDetail::Affirm` and `Charge::PaymentMethodDetail::WechatPay`
+* Add support for `payment_method_remove` on `Checkout::Session::CreateParams::SavedPaymentMethodOption`
+* Add support for `setup_future_usage` on `Checkout::Session::PaymentMethodOption::NaverPay`
+* Change `ConfirmationToken::PaymentMethodPreview::NaverPay.buyer_id` and `PaymentMethod::NaverPay.buyer_id` to be required
+* Add support for `post_payment_amount` and `pre_payment_amount` on `CreditNote`
+* Add support for `sex`, `unparsed_place_of_birth`, and `unparsed_sex` on `Identity::VerificationReport::Document` and `Identity::VerificationSession::VerifiedOutput`
+* Add support for `billing_thresholds` on `Invoice::CreatePreviewParams::ScheduleDetail::Phase::Item`, `Invoice::CreatePreviewParams::ScheduleDetail::Phase`, `Invoice::CreatePreviewParams::SubscriptionDetail::Item`, `Subscription::CreateParams::Item`, `Subscription::CreateParams`, `Subscription::UpdateParams::Item`, `Subscription::UpdateParams`, `SubscriptionItem::CreateParams`, `SubscriptionItem::UpdateParams`, `SubscriptionItem`, `SubscriptionSchedule::CreateParams::DefaultSetting`, `SubscriptionSchedule::CreateParams::Phase::Item`, `SubscriptionSchedule::CreateParams::Phase`, `SubscriptionSchedule::DefaultSetting`, `SubscriptionSchedule::Phase::Item`, `SubscriptionSchedule::Phase`, `SubscriptionSchedule::UpdateParams::DefaultSetting`, `SubscriptionSchedule::UpdateParams::Phase::Item`, `SubscriptionSchedule::UpdateParams::Phase`, and `Subscription`
+* Add support for `satispay` on `PaymentIntent::ConfirmParams::PaymentMethodOption`, `PaymentIntent::CreateParams::PaymentMethodOption`, `PaymentIntent::PaymentMethodOption`, and `PaymentIntent::UpdateParams::PaymentMethodOption`
+* Add support for `capture_method` on `PaymentIntent::PaymentMethodOption::Billie`
+* Add support for `kakao_pay`, `kr_card`, `naver_pay`, `payco`, and `samsung_pay` on `PaymentMethodConfiguration::CreateParams`, `PaymentMethodConfiguration::UpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `network_decline_code` on `Refund::DestinationDetail::Paypal`
+* Add support for `metadata` on `Tax::Calculation::CreateParams::LineItem` and `Tax::CalculationLineItem`
+* Add support for `return_url` on `Terminal::Reader::Action::ProcessPaymentIntent::ProcessConfig` and `Terminal::Reader::ProcessPaymentIntentParams::ProcessConfig`
+* Add support for `collect_inputs` on `Terminal::Reader::Action`
diff --git a/.hark/changes/2025-06-04_helenye_fix-nil-requestor.change.md b/.hark/changes/2025-06-04_helenye_fix-nil-requestor.change.md
new file mode 100644
index 000000000..d6df9c278
--- /dev/null
+++ b/.hark/changes/2025-06-04_helenye_fix-nil-requestor.change.md
@@ -0,0 +1,8 @@
+---
+title: Fix `nil` requestor in `Webhook.construct_event` to allow for event data refresh
+pr_url: https://github.com/stripe/stripe-ruby/pull/1617
+released_in_version: 15.2.1
+---
+
+* Fix bug where `Event` constructed from `Webhook.construct_event` could not be refreshed due to a `nil` APIRequestor
+  * Raised in https://github.com/stripe/stripe-ruby/issues/1616
diff --git a/.hark/changes/2025-06-16_ramya_fix-rawrequest-example.change.md b/.hark/changes/2025-06-16_ramya_fix-rawrequest-example.change.md
new file mode 100644
index 000000000..ea8d8f73b
--- /dev/null
+++ b/.hark/changes/2025-06-16_ramya_fix-rawrequest-example.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix `raw_request` example in README
+pr_url: https://github.com/stripe/stripe-ruby/pull/1620
+released_in_version: 15.3.0
+---
diff --git a/.hark/changes/2025-06-23_prathmesh_updated-stripeclient-snippets.change.md b/.hark/changes/2025-06-23_prathmesh_updated-stripeclient-snippets.change.md
new file mode 100644
index 000000000..c5bf7886f
--- /dev/null
+++ b/.hark/changes/2025-06-23_prathmesh_updated-stripeclient-snippets.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated StripeClient snippets in README
+pr_url: https://github.com/stripe/stripe-ruby/pull/1619
+released_in_version: 15.3.0
+---
diff --git a/.hark/changes/2025-07-01_helenye_update-readme-mention.change.md b/.hark/changes/2025-07-01_helenye_update-readme-mention.change.md
new file mode 100644
index 000000000..b7afcf300
--- /dev/null
+++ b/.hark/changes/2025-07-01_helenye_update-readme-mention.change.md
@@ -0,0 +1,5 @@
+---
+title: Update README to mention that APIResource.request was removed
+pr_url: https://github.com/stripe/stripe-ruby/pull/1615
+released_in_version: 15.3.0
+---
diff --git a/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..526ea35bc
--- /dev/null
+++ b/.hark/changes/2025-07-01_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,27 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1618
+is_stripe_api_change: true
+released_in_version: 15.3.0
+---
+
+* Add support for `migrate` method on resource `Subscription`
+* Add support for `collect_payment_method` and `confirm_payment_intent` methods on resource `Terminal::Reader`
+* Add support for `crypto_payments` on `Account::Capability`, `Account::CreateParams::Capability`, and `Account::UpdateParams::Capability`
+* Add support for `proof_of_address` on `Account::CreateParams::Document` and `Account::UpdateParams::Document`
+* Add support for `monthly_payout_days` and `weekly_payout_days` on `Account::CreateParams::Setting::Payout::Schedule`, `Account::Setting::Payout::Schedule`, and `Account::UpdateParams::Setting::Payout::Schedule`
+* Change `Account::Setting::Invoice.hosted_payment_method_save` to be required
+* Add support for `crypto` on `Charge::PaymentMethodDetail`, `ConfirmationToken::CreateParams::PaymentMethodDatum`, `ConfirmationToken::PaymentMethodPreview`, `PaymentIntent::ConfirmParams::PaymentMethodDatum`, `PaymentIntent::ConfirmParams::PaymentMethodOption`, `PaymentIntent::CreateParams::PaymentMethodDatum`, `PaymentIntent::CreateParams::PaymentMethodOption`, `PaymentIntent::PaymentMethodOption`, `PaymentIntent::UpdateParams::PaymentMethodDatum`, `PaymentIntent::UpdateParams::PaymentMethodOption`, `PaymentMethod::CreateParams`, `PaymentMethod`, `SetupIntent::ConfirmParams::PaymentMethodDatum`, `SetupIntent::CreateParams::PaymentMethodDatum`, and `SetupIntent::UpdateParams::PaymentMethodDatum`
+* Change type of `Charge::PaymentMethodDetail::Card::Installment::Plan.type`, `ConfirmationToken::CreateParams::PaymentMethodOption::Card::Installment::Plan.type`, `ConfirmationToken::PaymentMethodOption::Card::Installment::Plan.type`, `Invoice::CreateParams::PaymentSetting::PaymentMethodOption::Card::Installment::Plan.type`, `Invoice::UpdateParams::PaymentSetting::PaymentMethodOption::Card::Installment::Plan.type`, `PaymentIntent::ConfirmParams::PaymentMethodOption::Card::Installment::Plan.type`, `PaymentIntent::CreateParams::PaymentMethodOption::Card::Installment::Plan.type`, `PaymentIntent::PaymentMethodOption::Card::Installment::AvailablePlan.type`, `PaymentIntent::PaymentMethodOption::Card::Installment::Plan.type`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Card::Installment::Plan.type` from `literal('fixed_count')` to `enum('bonus'|'fixed_count'|'revolving')`
+* Add support for `subscriptions` on `Checkout::Session::CreateParams::PaymentMethodOption::Klarna`, `PaymentIntent::ConfirmParams::PaymentMethodOption::Klarna`, `PaymentIntent::CreateParams::PaymentMethodOption::Klarna`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Klarna`
+* Add support for `billing_mode` on `Checkout::Session::CreateParams::SubscriptionDatum`, `Invoice::CreatePreviewParams::ScheduleDetail`, `Invoice::CreatePreviewParams::SubscriptionDetail`, `Quote::CreateParams::SubscriptionDatum`, `Quote::SubscriptionDatum`, `Subscription::CreateParams`, `SubscriptionSchedule::CreateParams`, `SubscriptionSchedule`, and `Subscription`
+* Change type of `Dispute.enhanced_eligibility_types` from `literal('visa_compelling_evidence_3')` to `enum('visa_compelling_evidence_3'|'visa_compliance')`
+* Add support for `related_person` on `Identity::VerificationSession::CreateParams` and `Identity::VerificationSession`
+* Add support for `matching` on `Identity::VerificationSession::Option`
+* Add support for `klarna` on `Mandate::PaymentMethodDetail`, `SetupIntent::ConfirmParams::PaymentMethodOption`, `SetupIntent::CreateParams::PaymentMethodOption`, `SetupIntent::PaymentMethodOption`, and `SetupIntent::UpdateParams::PaymentMethodOption`
+* Add support for `on_demand` on `PaymentIntent::ConfirmParams::PaymentMethodOption::Klarna`, `PaymentIntent::CreateParams::PaymentMethodOption::Klarna`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Klarna`
+* Change type of `PaymentIntent::ConfirmParams::PaymentMethodOption::Klarna.setup_future_usage`, `PaymentIntent::CreateParams::PaymentMethodOption::Klarna.setup_future_usage`, `PaymentIntent::PaymentMethodOption::Klarna.setup_future_usage`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Klarna.setup_future_usage` from `literal('none')` to `enum('none'|'off_session'|'on_session')`
+* Add support for `ua` on `Tax::Registration::CountryOption` and `Tax::Registration::CreateParams::CountryOption`
+* Change type of `Terminal::Location::UpdateParams.display_name` from `string` to `emptyable(string)`
+* Add support for `collect_payment_method` and `confirm_payment_intent` on `Terminal::Reader::Action`
+* Add support for `status` on `Treasury::FinancialAccount::ListParams`
diff --git a/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..8f1d788e7
--- /dev/null
+++ b/.hark/changes/2025-07-30_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,21 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1627
+is_stripe_api_change: true
+released_in_version: 15.4.0
+---
+
+* Add support for `instant_payouts_promotion` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
+* Add support for `adjustable_quantity` on `BillingPortal::Configuration::CreateParams::Feature::SubscriptionUpdate::Product`, `BillingPortal::Configuration::Feature::SubscriptionUpdate::Product`, and `BillingPortal::Configuration::UpdateParams::Feature::SubscriptionUpdate::Product`
+* Add support for `transaction_id` on `Charge::PaymentMethodDetail::Cashapp`
+* Add support for `origin_context` on `Checkout::Session::CreateParams` and `Checkout::Session`
+* Add support for `template` on `Checkout::Session::CreateParams::InvoiceCreation::InvoiceDatum::RenderingOption`, `Checkout::Session::InvoiceCreation::InvoiceDatum::RenderingOption`, `PaymentLink::CreateParams::InvoiceCreation::InvoiceDatum::RenderingOption`, `PaymentLink::InvoiceCreation::InvoiceDatum::RenderingOption`, and `PaymentLink::UpdateParams::InvoiceCreation::InvoiceDatum::RenderingOption`
+* Add support for `setup_future_usage` on `Checkout::Session::CreateParams::PaymentMethodOption::Pix` and `Checkout::Session::PaymentMethodOption::Pix`
+* Change `Identity::VerificationSession::RelatedPerson.account` to be required
+* Change `Identity::VerificationSession::RelatedPerson.person` to be required
+* Add support for `duration` on `Invoice::CreatePreviewParams::ScheduleDetail::Phase`, `SubscriptionSchedule::CreateParams::Phase`, and `SubscriptionSchedule::UpdateParams::Phase`
+* Change type of `Invoice::CreatePreviewParams::SubscriptionDetail.cancel_at`, `Subscription::CreateParams.cancel_at`, and `Subscription::UpdateParams.cancel_at` from `DateTime` to `DateTime | enum('max_period_end'|'min_period_end')`
+* Add support for `price_data` on `PaymentLink::CreateParams::LineItem`
+* Change `PaymentLink::CreateParams::LineItem.price` to be optional
+* Add support for `standard` on `Tax::Registration::CountryOption::Ae`, `Tax::Registration::CountryOption::Au`, `Tax::Registration::CountryOption::Ch`, `Tax::Registration::CountryOption::Gb`, `Tax::Registration::CountryOption::Jp`, `Tax::Registration::CountryOption::No`, `Tax::Registration::CountryOption::Nz`, `Tax::Registration::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Ae`, `Tax::Registration::CreateParams::CountryOption::Al`, `Tax::Registration::CreateParams::CountryOption::Ao`, `Tax::Registration::CreateParams::CountryOption::Au`, `Tax::Registration::CreateParams::CountryOption::Aw`, `Tax::Registration::CreateParams::CountryOption::B`, `Tax::Registration::CreateParams::CountryOption::Ba`, `Tax::Registration::CreateParams::CountryOption::Bb`, `Tax::Registration::CreateParams::CountryOption::Bd`, `Tax::Registration::CreateParams::CountryOption::Bf`, `Tax::Registration::CreateParams::CountryOption::Bh`, `Tax::Registration::CreateParams::CountryOption::Cd`, `Tax::Registration::CreateParams::CountryOption::Ch`, `Tax::Registration::CreateParams::CountryOption::Et`, `Tax::Registration::CreateParams::CountryOption::Gb`, `Tax::Registration::CreateParams::CountryOption::Gn`, `Tax::Registration::CreateParams::CountryOption::Is`, `Tax::Registration::CreateParams::CountryOption::Jp`, `Tax::Registration::CreateParams::CountryOption::Me`, `Tax::Registration::CreateParams::CountryOption::Mk`, `Tax::Registration::CreateParams::CountryOption::Mr`, `Tax::Registration::CreateParams::CountryOption::No`, `Tax::Registration::CreateParams::CountryOption::Nz`, `Tax::Registration::CreateParams::CountryOption::Om`, `Tax::Registration::CreateParams::CountryOption::R`, `Tax::Registration::CreateParams::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Sr`, `Tax::Registration::CreateParams::CountryOption::Uy`, `Tax::Registration::CreateParams::CountryOption::Za`, and `Tax::Registration::CreateParams::CountryOption::Zw`
+* Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal::Configuration::CreateParams::Tipping`, `Terminal::Configuration::Tipping`, and `Terminal::Configuration::UpdateParams::Tipping`
diff --git a/.hark/changes/2025-08-11_helenye_remove-double-t.change.md b/.hark/changes/2025-08-11_helenye_remove-double-t.change.md
new file mode 100644
index 000000000..9fabf633d
--- /dev/null
+++ b/.hark/changes/2025-08-11_helenye_remove-double-t.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove double `T.nilable` before every emptyable field in update methods
+pr_url: https://github.com/stripe/stripe-ruby/pull/1633
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2025-08-25_helenye_add-stripeclient-usage.change.md b/.hark/changes/2025-08-25_helenye_add-stripeclient-usage.change.md
new file mode 100644
index 000000000..9a20df920
--- /dev/null
+++ b/.hark/changes/2025-08-25_helenye_add-stripeclient-usage.change.md
@@ -0,0 +1,5 @@
+---
+title: Add `stripe_client` usage tracking for StripeClient
+pr_url: https://github.com/stripe/stripe-ruby/pull/1637
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2025-08-27_ramya_add-section-private.change.md b/.hark/changes/2025-08-27_ramya_add-section-private.change.md
new file mode 100644
index 000000000..d61d3a52f
--- /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-ruby/pull/1638
+released_in_version: 15.5.0
+---
diff --git a/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..f9059416f
--- /dev/null
+++ b/.hark/changes/2025-08-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,19 @@
+---
+title: Update generated code.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1631
+is_stripe_api_change: true
+released_in_version: 15.5.0
+---
+
+* Add support for `balance_report`, `payout_details`, and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
+* Add support for `name` on `BillingPortal::Configuration::CreateParams`, `BillingPortal::Configuration::UpdateParams`, and `BillingPortal::Configuration`
+* Add support for `installments` on `Charge::PaymentMethodDetail::Alma`
+* Add support for `transaction_id` on `Charge::PaymentMethodDetail::Alma`, `Charge::PaymentMethodDetail::AmazonPay`, `Charge::PaymentMethodDetail::Billie`, `Charge::PaymentMethodDetail::KakaoPay`, `Charge::PaymentMethodDetail::KrCard`, `Charge::PaymentMethodDetail::NaverPay`, `Charge::PaymentMethodDetail::Payco`, `Charge::PaymentMethodDetail::RevolutPay`, `Charge::PaymentMethodDetail::SamsungPay`, and `Charge::PaymentMethodDetail::Satispay`
+* Add support for `location` and `reader` on `Charge::PaymentMethodDetail::Paynow`
+* Add support for `amount_includes_iof` on `Checkout::Session::CreateParams::PaymentMethodOption::Pix`, `Checkout::Session::PaymentMethodOption::Pix`, `PaymentIntent::ConfirmParams::PaymentMethodOption::Pix`, `PaymentIntent::CreateParams::PaymentMethodOption::Pix`, `PaymentIntent::PaymentMethodOption::Pix`, and `PaymentIntent::UpdateParams::PaymentMethodOption::Pix`
+* Add support for `metadata` and `period` on `Invoice::CreatePreviewParams::ScheduleDetail::Phase::AddInvoiceItem`, `Subscription::CreateParams::AddInvoiceItem`, `Subscription::UpdateParams::AddInvoiceItem`, `SubscriptionSchedule::CreateParams::Phase::AddInvoiceItem`, `SubscriptionSchedule::Phase::AddInvoiceItem`, and `SubscriptionSchedule::UpdateParams::Phase::AddInvoiceItem`
+* Add support for `exp_month` and `exp_year` on `Issuing::Card::CreateParams`
+* Add support for `excluded_payment_method_types` on `PaymentIntent::CreateParams` and `PaymentIntent`
+* Add support for `payout_method` on `Payout::CreateParams` and `Payout`
+* Add support for `mxn` on `Terminal::Configuration::CreateParams::Tipping`, `Terminal::Configuration::Tipping`, and `Terminal::Configuration::UpdateParams::Tipping`
+* Add support for `card` on `Terminal::Reader::PresentPaymentMethodParams`
diff --git a/.hark/changes/2025-09-03_helenye_explicitly-define-methods.change.md b/.hark/changes/2025-09-03_helenye_explicitly-define-methods.change.md
new file mode 100644
index 000000000..9faceb50c
--- /dev/null
+++ b/.hark/changes/2025-09-03_helenye_explicitly-define-methods.change.md
@@ -0,0 +1,9 @@
+---
+title: Explicitly define methods for RBIs and ship combined RBI for Tapioca
+pr_url: https://github.com/stripe/stripe-ruby/pull/1649
+released_in_version: 16.0.0
+---
+
+* Improvements for Tapioca
+     * Explicitly define methods for attributes in RBIs to allow Tapioca to reflect them
+     * Ship combined RBI for shorter Tapioca time
diff --git a/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md b/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md
new file mode 100644
index 000000000..a5cc9efe7
--- /dev/null
+++ b/.hark/changes/2025-09-09_xavdid_build-sdk-w.change.md
@@ -0,0 +1,9 @@
+---
+title: Build SDK w/ V2 OpenAPI spec
+pr_url: https://github.com/stripe/stripe-ruby/pull/1651
+semver_level: major
+released_in_version: 16.0.0
+---
+
+- ⚠️ The delete methods for v2 APIs (the ones in the `StripeClient.v2` namespace) now return a `V2DeletedObject` which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
+- ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `T::Hash[String, T.untyped]`. Because there were no params, it's unlikely you were using these classes.
diff --git a/.hark/changes/2025-09-23_helenye_deserialize-inner-types.change.md b/.hark/changes/2025-09-23_helenye_deserialize-inner-types.change.md
new file mode 100644
index 000000000..a3fdd599f
--- /dev/null
+++ b/.hark/changes/2025-09-23_helenye_deserialize-inner-types.change.md
@@ -0,0 +1,10 @@
+---
+title: Deserialize inner types in resources for more detailed types
+pr_url: https://github.com/stripe/stripe-ruby/pull/1652
+semver_level: major
+released_in_version: 16.0.0
+---
+
+* ⚠️ Deserialize inner classes, so inner class types will now reflect generated inner classes
+  * For example, `Stripe::Customer.address` is deserialized to specific a `Stripe::Customer::Address` class instead of the generic `Stripe::StripeObject`, as is suggested by the static type annotations
+  * This should not affect any normal use cases of the SDK, as inner types remain children of `Stripe::StripeObject`
diff --git a/.hark/changes/2025-09-23_stripe-openapi_1667-1680-1678.change.md b/.hark/changes/2025-09-23_stripe-openapi_1667-1680-1678.change.md
new file mode 100644
index 000000000..5d2ec23e3
--- /dev/null
+++ b/.hark/changes/2025-09-23_stripe-openapi_1667-1680-1678.change.md
@@ -0,0 +1,38 @@
+---
+title: ", [#1667](https://github.com/stripe/stripe-ruby/pull/1667), [#1680](https://github.com/stripe/stripe-ruby/pull/1680), [#1678](https://github.com/stripe/stripe-ruby/pull/1678) Update generated code based on incoming API changes in the `2025-09-30.clover` API version."
+pr_url: https://github.com/stripe/stripe-ruby/pull/1643
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 16.0.0
+---
+
+* ⚠️ Remove support for `balance_report` and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
+* Change `Invoice.id` to be required (i.e. not nilable).
+* Add support for new resource `BalanceSettings`
+* Add support for `retrieve` and `update` methods on resource `BalanceSettings`
+* Add support for `source` on `Discount`
+* Remove support for `coupon` on `Discount`, `PromotionCode::CreateParams`, and `PromotionCode`
+* Add support for `mb_way_payments`on `Account::Capability`, `Account::CreateParams::Capability`, and `Account::UpdateParams::Capability`
+* Add support for `trial_update_behavior` on `BillingPortal::Configuration::CreateParams::Feature::SubscriptionUpdate`, `BillingPortal::Configuration::Feature::SubscriptionUpdate`, and `BillingPortal::Configuration::UpdateParams::Feature::SubscriptionUpdate`
+* Add support for `mb_way` on `Charge::PaymentMethodDetail`, `ConfirmationToken::CreateParams::PaymentMethodDatum`, `ConfirmationToken::PaymentMethodPreview`, `PaymentIntent::ConfirmParams::PaymentMethodDatum`, `PaymentIntent::ConfirmParams::PaymentMethodOption`, `PaymentIntent::CreateParams::PaymentMethodDatum`, `PaymentIntent::CreateParams::PaymentMethodOption`, `PaymentIntent::PaymentMethodOption`, `PaymentIntent::UpdateParams::PaymentMethodDatum`, `PaymentIntent::UpdateParams::PaymentMethodOption`, `PaymentMethod::CreateParams`, `PaymentMethod`, `SetupIntent::ConfirmParams::PaymentMethodDatum`, `SetupIntent::CreateParams::PaymentMethodDatum`, and `SetupIntent::UpdateParams::PaymentMethodDatum`
+* Add support for `branding_settings` and `name_collection` on `Checkout::Session::CreateParams` and `Checkout::Session`
+* Add support for `excluded_payment_method_types` on `Checkout::Session::CreateParams`, `Checkout::Session`, `PaymentIntent::ConfirmParams`, and `PaymentIntent::UpdateParams`
+* Add support for `unit_label` on `Checkout::Session::CreateParams::LineItem::PriceDatum::ProductDatum`, `Invoice::AddLinesParams::Line::PriceDatum::ProductDatum`, `Invoice::UpdateLinesParams::Line::PriceDatum::ProductDatum`, `InvoiceLineItem::UpdateParams::PriceDatum::ProductDatum`, and `PaymentLink::CreateParams::LineItem::PriceDatum::ProductDatum`
+* Add support for `alma`, `billie`, and `satispay` on `Checkout::Session::CreateParams::PaymentMethodOption` and `Checkout::Session::PaymentMethodOption`
+* Add support for `demo_pay` on `Checkout::Session::CreateParams::PaymentMethodOption`
+* Add support for `capture_method` on `Checkout::Session::CreateParams::PaymentMethodOption::Affirm`, `Checkout::Session::CreateParams::PaymentMethodOption::AfterpayClearpay`, `Checkout::Session::CreateParams::PaymentMethodOption::AmazonPay`, `Checkout::Session::CreateParams::PaymentMethodOption::Card`, `Checkout::Session::CreateParams::PaymentMethodOption::Cashapp`, `Checkout::Session::CreateParams::PaymentMethodOption::Klarna`, `Checkout::Session::CreateParams::PaymentMethodOption::Link`, `Checkout::Session::CreateParams::PaymentMethodOption::Mobilepay`, `Checkout::Session::CreateParams::PaymentMethodOption::RevolutPay`, `Checkout::Session::PaymentMethodOption::Affirm`, `Checkout::Session::PaymentMethodOption::AfterpayClearpay`, `Checkout::Session::PaymentMethodOption::AmazonPay`, `Checkout::Session::PaymentMethodOption::Card`, `Checkout::Session::PaymentMethodOption::Cashapp`, `Checkout::Session::PaymentMethodOption::Klarna`, `Checkout::Session::PaymentMethodOption::Link`, `Checkout::Session::PaymentMethodOption::Mobilepay`, and `Checkout::Session::PaymentMethodOption::RevolutPay`
+* Add support for `flexible` on `Checkout::Session::CreateParams::SubscriptionDatum::BillingMode`, `Invoice::CreatePreviewParams::ScheduleDetail::BillingMode`, `Invoice::CreatePreviewParams::SubscriptionDetail::BillingMode`, `Quote::CreateParams::SubscriptionDatum::BillingMode`, `Quote::SubscriptionDatum::BillingMode`, `Subscription::BillingMode`, `Subscription::CreateParams::BillingMode`, `Subscription::MigrateParams::BillingMode`, `SubscriptionSchedule::BillingMode`, and `SubscriptionSchedule::CreateParams::BillingMode`
+* Add support for `business_name` and `individual_name` on `Checkout::Session::CollectedInformation`, `Checkout::Session::CustomerDetail`, `Customer::CreateParams`, `Customer::UpdateParams`, and `Customer`
+* Add support for `chargeback_loss_reason_code` on `Dispute::PaymentMethodDetail::Klarna`
+* Add support for `net_amount` and `proration_details` on `InvoiceItem`
+* Remove support for `iterations` on `Invoice::CreatePreviewParams::ScheduleDetail::Phase`, `SubscriptionSchedule::CreateParams::Phase`, and `SubscriptionSchedule::UpdateParams::Phase`
+* Add support for `fraud_disputability_likelihood` and `risk_assessment` on `Issuing::Authorization::CreateParams`
+* Add support for `second_line` on `Issuing::Card`
+* Add support for `fr_meal_voucher_conecs` on `PaymentMethodConfiguration::CreateParams` and `PaymentMethodConfiguration::UpdateParams`
+* Remove support for `link` and `pay_by_bank` on `PaymentMethod::UpdateParams`
+* Add support for `promotion` on `PromotionCode::CreateParams` and `PromotionCode`
+* Add support for `provider` on `Tax::Settings::Default`
+* Add support for `bbpos_wisepad3` on `Terminal::Configuration::CreateParams`, `Terminal::Configuration::UpdateParams`, and `Terminal::Configuration`
+* Add support for `address_kana`, `address_kanji`, `display_name_kana`, `display_name_kanji`, and `phone` on `Terminal::Location::CreateParams`, `Terminal::Location::UpdateParams`, and `Terminal::Location`
+* Change `Terminal::Location::CreateParams.address` to be optional
+* Change `Terminal::Location::CreateParams.display_name` to be optional
diff --git a/.hark/changes/2025-09-24_xavdid_add-strongly-typed.change.md b/.hark/changes/2025-09-24_xavdid_add-strongly-typed.change.md
new file mode 100644
index 000000000..3b788b492
--- /dev/null
+++ b/.hark/changes/2025-09-24_xavdid_add-strongly-typed.change.md
@@ -0,0 +1,17 @@
+---
+title: Add strongly typed EventNotifications
+pr_url: https://github.com/stripe/stripe-ruby/pull/1650
+semver_level: major
+released_in_version: 16.0.0
+---
+
+We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.
+- Added matching `EventNotification` classes to every v2 `Event`
+  - For example, there's now a `V1BillingMeterErrorReportTriggeredEventNotification` to match the existing `V1BillingMeterErrorReportTriggeredEvent`
+  - Each notification class defines a `fetch_event()` method to retrieve its corresponding event
+  - For events with related objects, there's a `fetch_related_object()` method that performs the API call and casts the response to the correct type on both the `EventNotification` and `Event`.
+- ⚠️ Rename function `StripeClient.parse_thin_event` to `StripeClient.parse_event_notification` and remove the `Stripe::ThinEvent` class.
+    - This function now returns a `Stripe::V2::Core::EventNotification` (which is the shared base class that all of the more specific `Stripe::Event::*EventNotification` classes  share) instead of `Stripe::ThinEvent`. When applicable, these event notifications will have the `relatedObject` property and a `fetch_related_object()` function. They also have a `fetch_event()` method to retrieve their corresponding `Stripe::Events::*Event` instance.
+    - If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of `Stripe::Events::UnknownEventNotification` instead of a more specific type. It has both the `related_object` property and the `fetch_related_object()` function (but they may be/return `nil`)
+- ⚠️ Move all Event Classes into the `Events` module
+  - For example, `Stripe::V1BillingMeterErrorReportTriggeredEvent` is now `Stripe::Events::V1BillingMeterErrorReportTriggeredEvent`
diff --git a/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md b/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md
new file mode 100644
index 000000000..f3533ada9
--- /dev/null
+++ b/.hark/changes/2025-09-25_xavdid_add-stripecontex-object.change.md
@@ -0,0 +1,9 @@
+---
+title: Add `StripeContext` object
+pr_url: https://github.com/stripe/stripe-ruby/pull/1664
+semver_level: major
+released_in_version: 16.0.0
+---
+
+- Add the `StripeContext` class. Previously you could set the stripe_context to only a string value. Now you can use the new class as well
+- ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
diff --git a/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md b/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md
new file mode 100644
index 000000000..d8c71f0ad
--- /dev/null
+++ b/.hark/changes/2025-09-29_xavdid_move-v2-event.change.md
@@ -0,0 +1,8 @@
+---
+title: Move `V2.Event` API resources to `V2.Core.Events`
+pr_url: https://github.com/stripe/stripe-ruby/pull/1677
+semver_level: major
+released_in_version: 16.0.0
+---
+
+- ⚠️ Move `Stripe::V2::Event` and `Stripe::V2::EventDestination` to `Stripe::V2::Core::Event` and `Stripe::V2::Core::EventDestination` respectively. They now correctly match their API path
diff --git a/.hark/changes/2025-09-30_xavdid_drop-support-ruby.change.md b/.hark/changes/2025-09-30_xavdid_drop-support-ruby.change.md
new file mode 100644
index 000000000..f662a1caf
--- /dev/null
+++ b/.hark/changes/2025-09-30_xavdid_drop-support-ruby.change.md
@@ -0,0 +1,10 @@
+---
+title: Drop support for Ruby < 2.6 & clarify version policy
+pr_url: https://github.com/stripe/stripe-ruby/pull/1684
+semver_level: major
+released_in_version: 16.0.0
+---
+
+- Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=ruby#stripe-sdk-language-version-support-policy)
+    - ⚠️ In this release, we drop support for Ruby 2.3, 2.4, and 2.5
+    -  Ruby 2.6 support is deprecated and will be removed in the next scheduled major release (March 2026)
diff --git a/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md b/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md
new file mode 100644
index 000000000..326d1ce48
--- /dev/null
+++ b/.hark/changes/2025-09-30_xavdid_unify-resource-service.change.md
@@ -0,0 +1,10 @@
+---
+title: Unify resource and service method parameters into one class
+pr_url: https://github.com/stripe/stripe-ruby/pull/1670
+semver_level: major
+released_in_version: 16.0.0
+---
+
+* ⚠️ Resource and service request parameter types have been moved to the top-level and are shared.
+  * For example, `Stripe::Account::CreateParams` and `Stripe::AccountService::CreateParams` have moved to `Stripe::AccountCreateParams`
+  * This change only affects users who use Sorbet types for parameters
diff --git a/.hark/changes/2025-10-01_jar_remove-manual-promotion.change.md b/.hark/changes/2025-10-01_jar_remove-manual-promotion.change.md
new file mode 100644
index 000000000..a41dd0007
--- /dev/null
+++ b/.hark/changes/2025-10-01_jar_remove-manual-promotion.change.md
@@ -0,0 +1,5 @@
+---
+title: Remove manual promotion code test
+pr_url: https://github.com/stripe/stripe-ruby/pull/1691
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2025-10-01_ramya_update-changelog-md.change.md b/.hark/changes/2025-10-01_ramya_update-changelog-md.change.md
new file mode 100644
index 000000000..3e2ccccb7
--- /dev/null
+++ b/.hark/changes/2025-10-01_ramya_update-changelog-md.change.md
@@ -0,0 +1,5 @@
+---
+title: Update CHANGELOG.md to point to right API version
+pr_url: https://github.com/stripe/stripe-ruby/pull/1687
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2025-10-01_xavdid_update-param-deprecation.change.md b/.hark/changes/2025-10-01_xavdid_update-param-deprecation.change.md
new file mode 100644
index 000000000..c3229f089
--- /dev/null
+++ b/.hark/changes/2025-10-01_xavdid_update-param-deprecation.change.md
@@ -0,0 +1,5 @@
+---
+title: Update param in deprecation docs link
+pr_url: https://github.com/stripe/stripe-ruby/pull/1690
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2025-10-02_xavdid_improve-event-notification.change.md b/.hark/changes/2025-10-02_xavdid_improve-event-notification.change.md
new file mode 100644
index 000000000..80709abad
--- /dev/null
+++ b/.hark/changes/2025-10-02_xavdid_improve-event-notification.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve event notification example
+pr_url: https://github.com/stripe/stripe-ruby/pull/1693
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2025-10-06_xavdid_improve-event-notification.change.md b/.hark/changes/2025-10-06_xavdid_improve-event-notification.change.md
new file mode 100644
index 000000000..b29ab31c9
--- /dev/null
+++ b/.hark/changes/2025-10-06_xavdid_improve-event-notification.change.md
@@ -0,0 +1,5 @@
+---
+title: Improve event notification example
+pr_url: https://github.com/stripe/stripe-ruby/pull/1699
+released_in_version: 17.0.0
+---
diff --git a/.hark/changes/2025-10-07_mbroshi_remove-expanded-instance.change.md b/.hark/changes/2025-10-07_mbroshi_remove-expanded-instance.change.md
new file mode 100644
index 000000000..661e1ee25
--- /dev/null
+++ b/.hark/changes/2025-10-07_mbroshi_remove-expanded-instance.change.md
@@ -0,0 +1,19 @@
+---
+title: Remove expanded instance variables after a resource has been updated
+pr_url: https://github.com/stripe/stripe-ruby/pull/1698
+semver_level: major
+released_in_version: 17.0.0
+---
+
+- ⚠️ Removes dynamically added instance variables on subsequent non-expanded updates to a resource that had previously been expanded. For example,
+```ruby
+# expand `payments` field on an invoice
+invoice = Stripe::Invoice.retrieve(id: 'in_123', expand: ['payments'])
+
+# `pay` invoice without expanding `payments`, so that field would have stale data
+# Use `expand` to keep `payments` like this: `invoice.pay(expand: ['payments'])`
+invoice.pay
+
+# This is now nil instead of a stale Hash
+invoice.payments
+```
diff --git a/.hark/changes/2025-10-13_helenye_require-v2-amount.change.md b/.hark/changes/2025-10-13_helenye_require-v2-amount.change.md
new file mode 100644
index 000000000..e8c85b7ea
--- /dev/null
+++ b/.hark/changes/2025-10-13_helenye_require-v2-amount.change.md
@@ -0,0 +1,5 @@
+---
+title: Require `V2::Amount` and `V2::DeletedObject` in gem
+pr_url: https://github.com/stripe/stripe-ruby/pull/1705
+released_in_version: 17.0.1
+---
diff --git a/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..02683f962
--- /dev/null
+++ b/.hark/changes/2025-10-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,34 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1700
+is_stripe_api_change: true
+released_in_version: 17.1.0
+---
+
+* Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
+* Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
+* Add support for `report_payment_attempt_canceled`, `report_payment_attempt_failed`, `report_payment_attempt_guaranteed`, `report_payment_attempt_informational`, `report_payment_attempt`, `report_payment`, `report_refund`, and `retrieve` methods on resource `PaymentRecord`
+* Add support for `list` method on resource `PaymentIntentAmountDetailsLineItem`
+* Add support for `representative_declaration` on `Account::Company`, `AccountCreateParams::Company`, `AccountUpdateParams::Company`, and `TokenCreateParams::Account::Company`
+* Change `Billing::CreditGrantCreateParams.category` to be optional
+* Add support for `payment_method_configuration` on `BillingPortal::ConfigurationCreateParams::Feature::PaymentMethodUpdate` and `BillingPortal::ConfigurationUpdateParams::Feature::PaymentMethodUpdate`
+* Add support for `twint` on `Checkout::Session::PaymentMethodOption` and `Checkout::SessionCreateParams::PaymentMethodOption`
+* Add support for `payment_record_refund` and `type` on `CreditNote::Refund`, `CreditNoteCreateParams::Refund`, `CreditNoteListPreviewLineItemsParams::Refund`, and `CreditNotePreviewParams::Refund`
+* Add support for `customer_sheet` and `mobile_payment_element` on `CustomerSession::Component` and `CustomerSessionCreateParams::Component`
+* Add support for `provider` on `Customer::Tax`
+* Add support for `payment_record` 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 `amount_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, and `PaymentIntentUpdateParams`
+* Add support for `payment_details` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
+* Add support for `discount_amount`, `line_items`, `shipping`, and `tax` on `PaymentIntent::AmountDetail`
+* Add support for `name_collection` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `crypto` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, and `Refund::DestinationDetail`
+* Add support for `mb_way` on `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, and `PaymentMethodConfiguration`
+* Add support for `custom` on `PaymentMethodCreateParams` and `PaymentMethod`
+* Add support for `excluded_payment_method_types` on `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntent`
+* Change `SetupIntent.flow_directions` to be optional
+* Add support for `tw` on `Tax::Registration::CountryOption` and `Tax::RegistrationCreateParams::CountryOption`
+* Add support for `gip` on `Terminal::Configuration::Tipping`, `Terminal::ConfigurationCreateParams::Tipping`, and `Terminal::ConfigurationUpdateParams::Tipping`
+* Add support for `last_seen_at` on `Terminal::Reader`
+* Add support for `gt`, `gte`, `lt`, `lte`, and `types` on `V2::Core::EventListParams`
+* Change `V2::Core::EventListParams.object_id` to be optional
diff --git a/.hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-10-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..39489ea0a
--- /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-ruby/pull/1715
+is_stripe_api_change: true
+released_in_version: 17.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 000000000..06898bc70
--- /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-ruby/pull/1721
+is_stripe_api_change: true
+released_in_version: 17.2.0
+---
+
+* Add support for `capture_method` on `PaymentIntent::PaymentMethodOption::CardPresent`, `PaymentIntentConfirmParams::PaymentMethodOption::CardPresent`, `PaymentIntentCreateParams::PaymentMethodOption::CardPresent`, and `PaymentIntentUpdateParams::PaymentMethodOption::CardPresent`
diff --git a/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..02cdd3dff
--- /dev/null
+++ b/.hark/changes/2025-11-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,19 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1725
+is_stripe_api_change: true
+released_in_version: 18.0.0
+---
+
+* Add support for new resources `Tax::Association` and `Terminal::OnboardingLink`
+* Add support for `find` method on resource `Tax::Association`
+* Add support for `create` method on resource `Terminal::OnboardingLink`
+* Add support for `payment_method_configuration` on `BillingPortal::Configuration::Feature::PaymentMethodUpdate`
+* Add support for `transaction_id` on `Charge::PaymentMethodDetail::Ideal`, `PaymentAttemptRecord::PaymentMethodDetail::Ideal`, and `PaymentRecord::PaymentMethodDetail::Ideal`
+* Add support for `created` on `CustomerCustomerBalanceTransactionListParams` and `InvoicePaymentListParams`
+* Add support for `account_numbers` on `FinancialConnections::Account`
+* Change type of `FinancialConnections::Session.client_secret` from `string` to `nullable(string)`
+* Add support for `fraud_risk` on `Issuing::AuthorizationCreateParams::RiskAssessment`
+* Add support for `latest_fraud_warning` on `Issuing::Card`
+* Add support for `hooks` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
+* Add support for `mb_way` and `twint` on `Refund::DestinationDetail`
diff --git a/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md b/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md
new file mode 100644
index 000000000..566c254b9
--- /dev/null
+++ b/.hark/changes/2025-11-17_mbroshi_update-v2-array.change.md
@@ -0,0 +1,7 @@
+---
+title: Update v2 array parameter serialization to use indexed format
+pr_url: https://github.com/stripe/stripe-ruby/pull/1727
+released_in_version: 18.0.0
+---
+
+- `Retrieve` and `List` calls for `/v2` endpoints now use indexed format (e.g., `?include[0]=foo&include[1]=bar`) instead of repeated parameter format (e.g., `?include=foo&include=bar`) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
diff --git a/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..ec27a0b45
--- /dev/null
+++ b/.hark/changes/2025-11-17_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,9 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1729
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 18.0.0
+---
+
+* ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `V2::Core::EventListParams` in favor of `created`.
diff --git a/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md b/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md
new file mode 100644
index 000000000..d71826dc6
--- /dev/null
+++ b/.hark/changes/2025-11-21_xavdid_throw-specific-error.change.md
@@ -0,0 +1,5 @@
+---
+title: Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging.
+pr_url: https://github.com/stripe/stripe-ruby/pull/1736
+released_in_version: 18.0.1
+---
diff --git a/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md b/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md
new file mode 100644
index 000000000..a3102b421
--- /dev/null
+++ b/.hark/changes/2025-12-08_prathmesh_updated-bundled-ca.change.md
@@ -0,0 +1,5 @@
+---
+title: Updated bundled CA certs
+pr_url: https://github.com/stripe/stripe-ruby/pull/1742
+released_in_version: 18.1.0
+---
diff --git a/.hark/changes/2025-12-09_xavdid_format-breaking-change.change.md b/.hark/changes/2025-12-09_xavdid_format-breaking-change.change.md
new file mode 100644
index 000000000..7f8ad5789
--- /dev/null
+++ b/.hark/changes/2025-12-09_xavdid_format-breaking-change.change.md
@@ -0,0 +1,5 @@
+---
+title: Format breaking change warning to improve discoverability
+pr_url: https://github.com/stripe/stripe-ruby/pull/1741
+released_in_version: 18.1.0
+---
diff --git a/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..0a4f98b3a
--- /dev/null
+++ b/.hark/changes/2025-12-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1744
+is_stripe_api_change: true
+released_in_version: 18.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 `customer_account` on `Billing::CreditBalanceSummaryRetrieveParams`, `Billing::CreditBalanceSummary`, `Billing::CreditBalanceTransactionListParams`, `Billing::CreditGrantCreateParams`, `Billing::CreditGrantListParams`, `Billing::CreditGrant`, `BillingPortal::SessionCreateParams`, `BillingPortal::Session`, `CashBalance`, `Checkout::SessionCreateParams`, `Checkout::SessionListParams`, `Checkout::Session`, `ConfirmationToken::PaymentMethodPreview`, `CreditNoteListParams`, `CreditNote`, `CustomerBalanceTransaction`, `CustomerCashBalanceTransaction`, `CustomerSessionCreateParams`, `CustomerSession`, `Customer`, `Discount`, `FinancialConnections::Account::AccountHolder`, `FinancialConnections::AccountListParams::AccountHolder`, `FinancialConnections::Session::AccountHolder`, `FinancialConnections::SessionCreateParams::AccountHolder`, `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`, and `TaxId`
+* Add support for `metadata` on `Checkout::SessionCreateParams::LineItem` and `LineItem`
+* Add support for `payto_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
+* Add support for `signer` on `AccountCreateParams::Document::ProofOfRegistration`, `AccountCreateParams::Document::ProofOfUltimateBeneficialOwnership`, `AccountUpdateParams::Document::ProofOfRegistration`, and `AccountUpdateParams::Document::ProofOfUltimateBeneficialOwnership`
+* Change `Billing::CreditBalanceSummaryRetrieveParams.customer`, `Billing::CreditBalanceTransactionListParams.customer`, `Billing::CreditGrantCreateParams.customer`, `BillingPortal::SessionCreateParams.customer`, `CustomerSessionCreateParams.customer`, `InvoiceItemCreateParams.customer`, `PaymentMethodAttachParams.customer`, and `SubscriptionCreateParams.customer` to be optional
+* Add support for `billing_cycle_anchor` on `BillingPortal::Configuration::Feature::SubscriptionUpdate`, `BillingPortal::ConfigurationCreateParams::Feature::SubscriptionUpdate`, and `BillingPortal::ConfigurationUpdateParams::Feature::SubscriptionUpdate`
+* Add support for `payto` on `Charge::PaymentMethodDetail`, `Checkout::Session::PaymentMethodOption`, `Checkout::SessionCreateParams::PaymentMethodOption`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `Invoice::PaymentSetting::PaymentMethodOption`, `InvoiceCreateParams::PaymentSetting::PaymentMethodOption`, `InvoiceUpdateParams::PaymentSetting::PaymentMethodOption`, `Mandate::PaymentMethodDetail`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodOption`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethodUpdateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupAttempt::PaymentMethodDetail`, `SetupIntent::PaymentMethodOption`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentConfirmParams::PaymentMethodOption`, `SetupIntentCreateParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodOption`, `SetupIntentUpdateParams::PaymentMethodDatum`, `SetupIntentUpdateParams::PaymentMethodOption`, `Subscription::PaymentSetting::PaymentMethodOption`, `SubscriptionCreateParams::PaymentSetting::PaymentMethodOption`, and `SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption`
+* Add support for `expected_debit_date` on `Charge::PaymentMethodDetail::AcssDebit`, `Charge::PaymentMethodDetail::AuBecsDebit`, `Charge::PaymentMethodDetail::BacsDebit`, `Charge::PaymentMethodDetail::NzBankAccount`, `Charge::PaymentMethodDetail::SepaDebit`, `Charge::PaymentMethodDetail::UsBankAccount`, `PaymentAttemptRecord::PaymentMethodDetail::AcssDebit`, `PaymentAttemptRecord::PaymentMethodDetail::AuBecsDebit`, `PaymentAttemptRecord::PaymentMethodDetail::BacsDebit`, `PaymentAttemptRecord::PaymentMethodDetail::NzBankAccount`, `PaymentAttemptRecord::PaymentMethodDetail::SepaDebit`, `PaymentAttemptRecord::PaymentMethodDetail::UsBankAccount`, `PaymentRecord::PaymentMethodDetail::AcssDebit`, `PaymentRecord::PaymentMethodDetail::AuBecsDebit`, `PaymentRecord::PaymentMethodDetail::BacsDebit`, `PaymentRecord::PaymentMethodDetail::NzBankAccount`, `PaymentRecord::PaymentMethodDetail::SepaDebit`, and `PaymentRecord::PaymentMethodDetail::UsBankAccount`
+* Add support for `line_items` on `Checkout::SessionUpdateParams`
+* Add support for `invoice` on `CustomerCustomerBalanceTransactionListParams`
+* Add support for `related_customer_account` on `Identity::VerificationSessionCreateParams`, `Identity::VerificationSessionListParams`, and `Identity::VerificationSession`
+* Change type of `InvoiceItem::Pricing::PriceDetail.price` and `InvoiceLineItem::Pricing::PriceDetail.price` from `string` to `expandable($Price)`
+* Add support for `subtotal` on `InvoiceLineItem`
+* Add support for `authorization_code`, `description`, `iin`, `installments`, `issuer`, `network_advice_code`, `network_decline_code`, and `stored_credential_usage` on `PaymentAttemptRecord::PaymentMethodDetail::Card` and `PaymentRecord::PaymentMethodDetail::Card`
+* Change `PaymentIntent.transfer_data` to be optional
+* Add support for `allow_redisplay` on `PaymentMethodListParams`
+* Add support for `reported_by` on `PaymentRecord`
+* Change `Product.tax_code` to be optional
+* Add support for `changes` on `V2::Core::Event`
diff --git a/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..e4b541b6d
--- /dev/null
+++ b/.hark/changes/2026-01-15_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,10 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1767
+is_stripe_api_change: true
+released_in_version: 18.2.0
+---
+
+* Add support for event notifications `V2CoreAccountClosedEvent`, `V2CoreAccountCreatedEvent`, `V2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationCustomerUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationMerchantUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent`, `V2CoreAccountIncludingConfigurationRecipientUpdatedEvent`, `V2CoreAccountIncludingDefaultsUpdatedEvent`, `V2CoreAccountIncludingFutureRequirementsUpdatedEvent`, `V2CoreAccountIncludingIdentityUpdatedEvent`, `V2CoreAccountIncludingRequirementsUpdatedEvent`, and `V2CoreAccountUpdatedEvent` with related object `V2::Core::Account`
+* Add support for event notification `V2CoreAccountLinkReturnedEvent`
+* Add support for event notifications `V2CoreAccountPersonCreatedEvent`, `V2CoreAccountPersonDeletedEvent`, and `V2CoreAccountPersonUpdatedEvent` with related object `V2::Core::AccountPerson`
diff --git a/.hark/changes/2026-01-19_ramya_document-usage-undocumented.change.md b/.hark/changes/2026-01-19_ramya_document-usage-undocumented.change.md
new file mode 100644
index 000000000..fd1925935
--- /dev/null
+++ b/.hark/changes/2026-01-19_ramya_document-usage-undocumented.change.md
@@ -0,0 +1,5 @@
+---
+title: Document usage of undocumented API parameters
+pr_url: https://github.com/stripe/stripe-ruby/pull/1769
+released_in_version: 18.3.0
+---
diff --git a/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..5e9c00d94
--- /dev/null
+++ b/.hark/changes/2026-01-28_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,17 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1771
+is_stripe_api_change: true
+released_in_version: 18.3.0
+---
+
+* Add support for new resource `Radar::PaymentEvaluation`
+* Add support for `create` method on resource `Radar::PaymentEvaluation`
+* Add support for `adjustable_quantity` on `LineItem`
+* Change `Invoice::PaymentSetting::PaymentMethodOption.payto` and `Subscription::PaymentSetting::PaymentMethodOption.payto` to be required
+* Add support for `enforce_arithmetic_validation` on `PaymentIntentCaptureParams::AmountDetail`, `PaymentIntentConfirmParams::AmountDetail`, `PaymentIntentCreateParams::AmountDetail`, `PaymentIntentIncrementAuthorizationParams::AmountDetail`, and `PaymentIntentUpdateParams::AmountDetail`
+* Add support for `error` on `PaymentIntent::AmountDetail`
+* Remove support for `bgn` on `Terminal::Configuration::Tipping`, `Terminal::ConfigurationCreateParams::Tipping`, and `Terminal::ConfigurationUpdateParams::Tipping`
+* Add support for `topup` on `Treasury::ReceivedDebit::LinkedFlow`
+* Add support for `contact_phone` on `V2::Core::AccountCreateParams`, `V2::Core::AccountTokenCreateParams`, `V2::Core::AccountUpdateParams`, and `V2::Core::Account`
+* Add support for `registration_date` on `V2::Core::Account::Identity::BusinessDetail`, `V2::Core::AccountCreateParams::Identity::BusinessDetail`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail`
diff --git a/.hark/changes/2026-02-04_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-02-04_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..6a38f650c
--- /dev/null
+++ b/.hark/changes/2026-02-04_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,7 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1777
+released_in_version: 18.3.1
+---
+
+* References to Stripe objects from *Param class fields are now fully qualified in `stripe.rbi`.  This ensures that the class fields in .rbi files generated with tapioca are able to refer to the correct type.
diff --git a/.hark/changes/2026-02-16_mbroshi_properly-serialize-null.change.md b/.hark/changes/2026-02-16_mbroshi_properly-serialize-null.change.md
new file mode 100644
index 000000000..c72776287
--- /dev/null
+++ b/.hark/changes/2026-02-16_mbroshi_properly-serialize-null.change.md
@@ -0,0 +1,7 @@
+---
+title: Properly serialize null values in V2
+pr_url: https://github.com/stripe/stripe-ruby/pull/1786
+released_in_version: 18.4.0
+---
+
+- Fixes a bug where V2 POST requests were not serializing `null` values.
diff --git a/.hark/changes/2026-02-23_prathmesh_ignore-unset-properties.change.md b/.hark/changes/2026-02-23_prathmesh_ignore-unset-properties.change.md
new file mode 100644
index 000000000..8c3fd57fc
--- /dev/null
+++ b/.hark/changes/2026-02-23_prathmesh_ignore-unset-properties.change.md
@@ -0,0 +1,5 @@
+---
+title: Ignore unset properties of V2 Request param classes when making requests
+pr_url: https://github.com/stripe/stripe-ruby/pull/1796
+released_in_version: 18.4.0
+---
diff --git a/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..3e4bd4000
--- /dev/null
+++ b/.hark/changes/2026-02-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,18 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1797
+is_stripe_api_change: true
+released_in_version: 18.4.0
+---
+
+* Add support for new resources `Reserve::Hold`, `Reserve::Plan`, and `Reserve::Release`
+* Add support for `location` and `reader` on `Charge::PaymentMethodDetail::CardPresent`, `Charge::PaymentMethodDetail::InteracPresent`, `ConfirmationToken::PaymentMethodPreview::Card::GeneratedFrom::PaymentMethodDetail::CardPresent`, `PaymentAttemptRecord::PaymentMethodDetail::CardPresent`, `PaymentAttemptRecord::PaymentMethodDetail::InteracPresent`, `PaymentMethod::Card::GeneratedFrom::PaymentMethodDetail::CardPresent`, `PaymentRecord::PaymentMethodDetail::CardPresent`, and `PaymentRecord::PaymentMethodDetail::InteracPresent`
+* Add support for `display_name` and `service_user_number` on `Mandate::PaymentMethodDetail::BacsDebit`
+* Change type of `PaymentAttemptRecord::PaymentMethodDetail::Boleto.tax_id` and `PaymentRecord::PaymentMethodDetail::Boleto.tax_id` from `string` to `nullable(string)`
+* Change type of `PaymentAttemptRecord::PaymentMethodDetail::UsBankAccount.expected_debit_date` and `PaymentRecord::PaymentMethodDetail::UsBankAccount.expected_debit_date` from `nullable(string)` to `string`
+* Add support for `transaction_purpose` on `PaymentIntent::PaymentMethodOption::UsBankAccount`, `PaymentIntentConfirmParams::PaymentMethodOption::UsBankAccount`, `PaymentIntentCreateParams::PaymentMethodOption::UsBankAccount`, and `PaymentIntentUpdateParams::PaymentMethodOption::UsBankAccount`
+* Add support for `optional_items` on `PaymentLinkUpdateParams`
+* Remove support for unused `card_issuer_decline` on `Radar::PaymentEvaluation::Insight`
+* Add support for `payment_behavior` on `SubscriptionItemDeleteParams`
+* Add support for `lk` on `Tax::Registration::CountryOption` and `Tax::RegistrationCreateParams::CountryOption`
+* Add support for `cellular` and `stripe_s710` on `Terminal::ConfigurationCreateParams`, `Terminal::ConfigurationUpdateParams`, and `Terminal::Configuration`
diff --git a/.hark/changes/2026-03-03_xavdid_add-agent-information.change.md b/.hark/changes/2026-03-03_xavdid_add-agent-information.change.md
new file mode 100644
index 000000000..b5655f53e
--- /dev/null
+++ b/.hark/changes/2026-03-03_xavdid_add-agent-information.change.md
@@ -0,0 +1,5 @@
+---
+title: Add agent information to UserAgent
+pr_url: https://github.com/stripe/stripe-ruby/pull/1803
+released_in_version: 18.4.1
+---
diff --git a/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md b/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md
new file mode 100644
index 000000000..c2e1fdfe3
--- /dev/null
+++ b/.hark/changes/2026-03-05_xavdid_add-stripe-request.change.md
@@ -0,0 +1,5 @@
+---
+title: Add Stripe-Request-Trigger header
+pr_url: https://github.com/stripe/stripe-ruby/pull/1805
+released_in_version: 18.4.1
+---
diff --git a/.hark/changes/2026-03-10_mbroshi_retry-net-httpfatalerr.change.md b/.hark/changes/2026-03-10_mbroshi_retry-net-httpfatalerr.change.md
new file mode 100644
index 000000000..c22da00af
--- /dev/null
+++ b/.hark/changes/2026-03-10_mbroshi_retry-net-httpfatalerr.change.md
@@ -0,0 +1,7 @@
+---
+title: Retry on Net::HTTPFatalError
+pr_url: https://github.com/stripe/stripe-ruby/pull/1811
+released_in_version: 18.4.2
+---
+
+- Fixes a bug where `Net::HTTPFatalError` errors were being thrown and not retried (unlike other 5xx responses from the Stripe API)
diff --git a/.hark/changes/2026-03-17_mbroshi_remove-alipayaccoun-recipienttra.change.md b/.hark/changes/2026-03-17_mbroshi_remove-alipayaccoun-recipienttra.change.md
new file mode 100644
index 000000000..3f418b5ea
--- /dev/null
+++ b/.hark/changes/2026-03-17_mbroshi_remove-alipayaccoun-recipienttra.change.md
@@ -0,0 +1,8 @@
+---
+title: Remove AlipayAccount and RecipientTransfer resource files
+pr_url: https://github.com/stripe/stripe-ruby/pull/1817
+semver_level: major
+released_in_version: 19.0.0
+---
+
+- ⚠️ Removes `Stripe::AlipayAccount` and `Stripe::RecipientTransfer` resource classes (dead code since v7.0.0)
diff --git a/.hark/changes/2026-03-17_xavdid_remove-v2-specific.change.md b/.hark/changes/2026-03-17_xavdid_remove-v2-specific.change.md
new file mode 100644
index 000000000..4cf3352b0
--- /dev/null
+++ b/.hark/changes/2026-03-17_xavdid_remove-v2-specific.change.md
@@ -0,0 +1,5 @@
+---
+title: remove v2-specific guards for removing nils from request params
+pr_url: https://github.com/stripe/stripe-ruby/pull/1816
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md b/.hark/changes/2026-03-18_mbroshi_add-runtime-support.change.md
new file mode 100644
index 000000000..670cba624
--- /dev/null
+++ b/.hark/changes/2026-03-18_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-ruby/pull/1814
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-18_xavdid_drop-support-ruby.change.md b/.hark/changes/2026-03-18_xavdid_drop-support-ruby.change.md
new file mode 100644
index 000000000..618fe14ec
--- /dev/null
+++ b/.hark/changes/2026-03-18_xavdid_drop-support-ruby.change.md
@@ -0,0 +1,6 @@
+---
+title: Drop support for Ruby 2.6
+pr_url: https://github.com/stripe/stripe-ruby/pull/1823
+semver_level: major
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-19_xavdid_require-cgi-escape.change.md b/.hark/changes/2026-03-19_xavdid_require-cgi-escape.change.md
new file mode 100644
index 000000000..b5402b071
--- /dev/null
+++ b/.hark/changes/2026-03-19_xavdid_require-cgi-escape.change.md
@@ -0,0 +1,5 @@
+---
+title: Require cgi/escape instead of cgi
+pr_url: https://github.com/stripe/stripe-ruby/pull/1825
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-23_xavdid_add-gem-dependency.change.md b/.hark/changes/2026-03-23_xavdid_add-gem-dependency.change.md
new file mode 100644
index 000000000..7aabb9843
--- /dev/null
+++ b/.hark/changes/2026-03-23_xavdid_add-gem-dependency.change.md
@@ -0,0 +1,5 @@
+---
+title: Add gem dependency on logger
+pr_url: https://github.com/stripe/stripe-ruby/pull/1824
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-23_xavdid_throw-error-using.change.md b/.hark/changes/2026-03-23_xavdid_throw-error-using.change.md
new file mode 100644
index 000000000..51390fbe9
--- /dev/null
+++ b/.hark/changes/2026-03-23_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-ruby/pull/1828
+semver_level: major
+released_in_version: 19.0.0
+---
diff --git a/.hark/changes/2026-03-24_jar_add-decimalstrin-coercion.change.md b/.hark/changes/2026-03-24_jar_add-decimalstrin-coercion.change.md
new file mode 100644
index 000000000..189a0b874
--- /dev/null
+++ b/.hark/changes/2026-03-24_jar_add-decimalstrin-coercion.change.md
@@ -0,0 +1,18 @@
+---
+title: Add decimal_string coercion for v1 and v2 API fields
+pr_url: https://github.com/stripe/stripe-ruby/pull/1829
+semver_level: major
+released_in_version: 19.0.0
+---
+
+- All `decimal_string` fields changed type from `String` to `BigDecimal` in both request params and response objects. Code that reads or writes these fields as `String` will need to use `BigDecimal` instead. Affected fields across v1 and v2 APIs:
+  - **Checkout::Session**: `fx_rate`
+  - **Climate::Order**: `metric_tons`; **Climate::Product**: `metric_tons_available`
+  - **CreditNoteLineItem**: `unit_amount_decimal`
+  - **InvoiceItem**: `quantity_decimal`, `unit_amount_decimal`
+  - **InvoiceLineItem**: `quantity_decimal`, `unit_amount_decimal`
+  - **Issuing::Authorization** / **Issuing::Transaction** (and TestHelpers): `quantity_decimal`, `unit_cost_decimal`, `gross_amount_decimal`, `local_amount_decimal`, `national_amount_decimal`
+  - **Plan**: `amount_decimal`, `flat_amount_decimal`, `unit_amount_decimal`
+  - **Price**: `unit_amount_decimal`, `flat_amount_decimal` (including `currency_options` and `tiers`)
+  - **V2::Core::Account** / **V2::Core::AccountPerson**: `percent_ownership`
+  - Request params on **Invoice**, **Product**, **Quote**, **Subscription**, **SubscriptionItem**, **SubscriptionSchedule**, **PaymentLink**: `unit_amount_decimal`, `flat_amount_decimal`, `quantity_decimal` (where applicable)
diff --git a/.hark/changes/2026-03-25_unknown_generated-changes-1804.change.md b/.hark/changes/2026-03-25_unknown_generated-changes-1804.change.md
new file mode 100644
index 000000000..ecf34d7df
--- /dev/null
+++ b/.hark/changes/2026-03-25_unknown_generated-changes-1804.change.md
@@ -0,0 +1,29 @@
+---
+title: "Generated changes from [#1804](https://github.com/stripe/stripe-ruby/pull/1804), [#1834](https://github.com/stripe/stripe-ruby/pull/1834), [#1831](https://github.com/stripe/stripe-ruby/pull/1831), [#1830](https://github.com/stripe/stripe-ruby/pull/1830)"
+semver_level: major
+is_stripe_api_change: true
+section: ⚠️ Breaking changes due to changes in the Stripe API
+released_in_version: 19.0.0
+---
+
+* Add support for `upi_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
+* Add support for `upi` on `Charge::PaymentMethodDetail`, `Checkout::Session::PaymentMethodOption`, `Checkout::SessionCreateParams::PaymentMethodOption`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `Mandate::PaymentMethodDetail`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodOption`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupAttempt::PaymentMethodDetail`, `SetupIntent::PaymentMethodOption`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentConfirmParams::PaymentMethodOption`, `SetupIntentCreateParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodOption`, `SetupIntentUpdateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodOption`
+* Add support for `integration_identifier` on `Checkout::SessionCreateParams` and `Checkout::Session`
+* Add support for `crypto` on `Checkout::SessionCreateParams::PaymentMethodOption`
+* Add support for `pending_invoice_item_interval` on `Checkout::SessionCreateParams::SubscriptionDatum`
+* Add support for `metadata` on `CreditNoteCreateParams::Line`, `CreditNoteLineItem`, `CreditNoteListPreviewLineItemsParams::Line`, and `CreditNotePreviewParams::Line`
+* Add support for `quantity_decimal` on `InvoiceAddLinesParams::Line`, `InvoiceCreatePreviewParams::InvoiceItem`, `InvoiceItemCreateParams`, `InvoiceItemUpdateParams`, `InvoiceItem`, `InvoiceLineItemUpdateParams`, `InvoiceLineItem`, and `InvoiceUpdateLinesParams::Line`
+* ⚠️ Add support for `level` on `Issuing::AuthorizationCreateParams::RiskAssessment::CardTestingRisk` and `Issuing::AuthorizationCreateParams::RiskAssessment::MerchantDisputeRisk`
+* ⚠️ Remove support for `risk_level` on `Issuing::AuthorizationCreateParams::RiskAssessment::CardTestingRisk` and `Issuing::AuthorizationCreateParams::RiskAssessment::MerchantDisputeRisk`
+* Add support for `lifecycle_controls` on `Issuing::CardCreateParams` and `Issuing::Card`
+* ⚠️ Change type of `Issuing::Token::NetworkDatum::Visa.card_reference_id` from `string` to `nullable(string)`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.brand` and `PaymentRecord::PaymentMethodDetail::Card.brand` from `enum` to `nullable(enum)`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.exp_month` and `PaymentRecord::PaymentMethodDetail::Card.exp_month` from `longInteger` to `nullable(longInteger)`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.exp_year` and `PaymentRecord::PaymentMethodDetail::Card.exp_year` from `longInteger` to `nullable(longInteger)`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.funding` and `PaymentRecord::PaymentMethodDetail::Card.funding` from `enum('credit'|'debit'|'prepaid'|'unknown')` to `nullable(enum('credit'|'debit'|'prepaid'|'unknown'))`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.last4` and `PaymentRecord::PaymentMethodDetail::Card.last4` from `string` to `nullable(string)`
+* ⚠️ Change type of `PaymentAttemptRecord::PaymentMethodDetail::Card.moto` and `PaymentRecord::PaymentMethodDetail::Card.moto` from `boolean` to `nullable(boolean)`
+* Add support for `cryptogram`, `electronic_commerce_indicator`, `exemption_indicator_applied`, and `exemption_indicator` on `PaymentAttemptRecord::PaymentMethodDetail::Card::ThreeDSecure` and `PaymentRecord::PaymentMethodDetail::Card::ThreeDSecure`
+* Add support for `upi_handle_redirect_or_display_qr_code` on `PaymentIntent::NextAction` and `SetupIntent::NextAction`
+* Add support for `recommended_action` and `signals` on `Radar::PaymentEvaluation`
+* ⚠️ Remove support for `insights` on `Radar::PaymentEvaluation`
diff --git a/.hark/changes/2026-03-27_xavdid_replace-other-require.change.md b/.hark/changes/2026-03-27_xavdid_replace-other-require.change.md
new file mode 100644
index 000000000..1faffd75f
--- /dev/null
+++ b/.hark/changes/2026-03-27_xavdid_replace-other-require.change.md
@@ -0,0 +1,5 @@
+---
+title: Replace other require cgi with require cgi/escape
+pr_url: https://github.com/stripe/stripe-ruby/pull/1841
+released_in_version: 19.1.0
+---
diff --git a/.hark/changes/2026-04-01_jar_fix-2d-array.change.md b/.hark/changes/2026-04-01_jar_fix-2d-array.change.md
new file mode 100644
index 000000000..f91b73910
--- /dev/null
+++ b/.hark/changes/2026-04-01_jar_fix-2d-array.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix 2D array parameter encoding
+pr_url: https://github.com/stripe/stripe-ruby/pull/1846
+released_in_version: 19.1.0
+---
+
+- Fixes an issue encoding two-dimensional array request params where the SDK incorrectly flattens the array.
diff --git a/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..f0e75af6f
--- /dev/null
+++ b/.hark/changes/2026-04-23_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,26 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1842
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 19.1.0
+---
+
+* Add support for `balance_report` and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSessionCreateParams::Component`
+* Add support for `app_distribution` and `sunbit_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
+* Add support for `sunbit` on `Charge::PaymentMethodDetail`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodDatum`
+* Add support for `location` and `reader` on `Charge::PaymentMethodDetail::Klarna`, `PaymentAttemptRecord::PaymentMethodDetail::Klarna`, and `PaymentRecord::PaymentMethodDetail::Klarna`
+* Add support for `mandate` on `Charge::PaymentMethodDetail::Pix`, `PaymentAttemptRecord::PaymentMethodDetail::Pix`, and `PaymentRecord::PaymentMethodDetail::Pix`
+* Add support for `managed_payments` on `Checkout::SessionCreateParams`, `Checkout::Session`, `PaymentIntent`, `PaymentLinkCreateParams`, `PaymentLink`, `SetupIntent`, and `Subscription`
+* Add support for `mandate_options` on `Checkout::Session::PaymentMethodOption::Pix`, `Checkout::SessionCreateParams::PaymentMethodOption::Pix`, `PaymentIntent::PaymentMethodOption::Pix`, `PaymentIntentConfirmParams::PaymentMethodOption::Pix`, `PaymentIntentCreateParams::PaymentMethodOption::Pix`, and `PaymentIntentUpdateParams::PaymentMethodOption::Pix`
+* Change type of `Checkout::SessionCreateParams::PaymentMethodOption::Pix.setup_future_usage`, `PaymentIntentConfirmParams::PaymentMethodOption::Pix.setup_future_usage`, `PaymentIntentCreateParams::PaymentMethodOption::Pix.setup_future_usage`, and `PaymentIntentUpdateParams::PaymentMethodOption::Pix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* ⚠️ Change type of `Checkout::Session::PaymentMethodOption::Pix.setup_future_usage` and `PaymentIntent::PaymentMethodOption::Pix.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for `pix` on `Invoice::PaymentSetting::PaymentMethodOption`, `InvoiceCreateParams::PaymentSetting::PaymentMethodOption`, `InvoiceUpdateParams::PaymentSetting::PaymentMethodOption`, `Mandate::PaymentMethodDetail`, `SetupAttempt::PaymentMethodDetail`, `SetupIntent::PaymentMethodOption`, `SetupIntentConfirmParams::PaymentMethodOption`, `SetupIntentCreateParams::PaymentMethodOption`, `SetupIntentUpdateParams::PaymentMethodOption`, `Subscription::PaymentSetting::PaymentMethodOption`, `SubscriptionCreateParams::PaymentSetting::PaymentMethodOption`, and `SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption`
+* Add support for `upi` on `Invoice::PaymentSetting::PaymentMethodOption`, `InvoiceCreateParams::PaymentSetting::PaymentMethodOption`, `InvoiceUpdateParams::PaymentSetting::PaymentMethodOption`, `Subscription::PaymentSetting::PaymentMethodOption`, `SubscriptionCreateParams::PaymentSetting::PaymentMethodOption`, and `SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption`
+* Add support for `card_presence` on `Issuing::Authorization`
+* Add support for `allowed_card_presences` and `blocked_card_presences` on `Issuing::Card::SpendingControl`, `Issuing::CardCreateParams::SpendingControl`, `Issuing::CardUpdateParams::SpendingControl`, `Issuing::Cardholder::SpendingControl`, `Issuing::CardholderCreateParams::SpendingControl`, and `Issuing::CardholderUpdateParams::SpendingControl`
+* Add support for `amount` and `currency` on `Mandate::MultiUse`
+* Add support for `amount_to_confirm` on `PaymentIntentConfirmParams`
+* Add support for `klarna_display_qr_code` on `PaymentIntent::NextAction`
+* Add support for `moto` on `SetupAttempt::PaymentMethodDetail::Card`
+* Add support for `pix_display_qr_code` on `SetupIntent::NextAction`
diff --git a/.hark/changes/2026-05-08_mbroshi_use-autoload-instead.change.md b/.hark/changes/2026-05-08_mbroshi_use-autoload-instead.change.md
new file mode 100644
index 000000000..311c6c9d6
--- /dev/null
+++ b/.hark/changes/2026-05-08_mbroshi_use-autoload-instead.change.md
@@ -0,0 +1,5 @@
+---
+title: Use autoload instead of eager require for generated resource, service, and param files
+pr_url: https://github.com/stripe/stripe-ruby/pull/1855
+released_in_version: 19.2.0
+---
diff --git a/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..951ea19d7
--- /dev/null
+++ b/.hark/changes/2026-05-27_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,37 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1864
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 19.2.0
+---
+
+* Add support for new resource `V2::Commerce::ProductCatalogImport`
+* Add support for `create` and `retrieve` methods on resource `V2::Commerce::ProductCatalogImport`
+* Add support for `bizum_payments` and `scalapay_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
+* Add support for `automatic_transfer_rules_by_currency` on `BalanceSettings::Payment::Payout` and `BalanceSettingsUpdateParams::Payment::Payout`
+* Add support for `start_of_day` on `BalanceSettings::Payment::SettlementTiming` and `BalanceSettingsUpdateParams::Payment::SettlementTiming`
+* Add support for `description` on `ChargeCreateParams::TransferDatum`, `PaymentIntent::TransferDatum`, `PaymentIntentCreateParams::TransferDatum`, and `PaymentIntentUpdateParams::TransferDatum`
+* Add support for `bizum` on `Charge::PaymentMethodDetail`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodOption`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupIntent::PaymentMethodOption`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentConfirmParams::PaymentMethodOption`, `SetupIntentCreateParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodOption`, `SetupIntentUpdateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodOption`
+* Add support for `scalapay` on `Charge::PaymentMethodDetail`, `Checkout::Session::PaymentMethodOption`, `Checkout::SessionCreateParams::PaymentMethodOption`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodOption`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `Refund::DestinationDetail`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodDatum`
+* Add support for `mandate` on `Charge::PaymentMethodDetail::Twint`, `PaymentAttemptRecord::PaymentMethodDetail::Twint`, and `PaymentRecord::PaymentMethodDetail::Twint`
+* Change type of `Checkout::SessionCreateParams::PaymentMethodOption::Twint.setup_future_usage`, `PaymentIntentConfirmParams::PaymentMethodOption::Twint.setup_future_usage`, `PaymentIntentCreateParams::PaymentMethodOption::Twint.setup_future_usage`, and `PaymentIntentUpdateParams::PaymentMethodOption::Twint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* ⚠️ Change type of `Checkout::Session::PaymentMethodOption::Twint.setup_future_usage` and `PaymentIntent::PaymentMethodOption::Twint.setup_future_usage` from `literal('none')` to `enum('none'|'off_session')`
+* Add support for `credited_items` on `InvoiceItem::ProrationDetail`
+* Add support for `discountable` on `InvoiceCreatePreviewParams::ScheduleDetail::Phase::AddInvoiceItem`, `SubscriptionCreateParams::AddInvoiceItem`, `SubscriptionSchedule::Phase::AddInvoiceItem`, `SubscriptionScheduleCreateParams::Phase::AddInvoiceItem`, `SubscriptionScheduleUpdateParams::Phase::AddInvoiceItem`, and `SubscriptionUpdateParams::AddInvoiceItem`
+* Add support for `billing_schedules` on `InvoiceCreatePreviewParams::SubscriptionDetail`, `SubscriptionCreateParams`, `SubscriptionUpdateParams`, and `Subscription`
+* Add support for `amount_paid_off_stripe` on `Invoice`
+* Add support for `twint` on `Mandate::PaymentMethodDetail` and `SetupAttempt::PaymentMethodDetail`
+* Add support for `metadata` on `PaymentIntent::TransferDatum`, `PaymentIntentCreateParams::TransferDatum`, `PaymentIntentUpdateParams::TransferDatum`, and `Subscription::PendingUpdate`
+* Add support for `payment_data` on `PaymentIntent::TransferDatum`, `PaymentIntentCreateParams::TransferDatum`, and `PaymentIntentUpdateParams::TransferDatum`
+* Add support for `blik_authorize` on `PaymentIntent::NextAction` and `SetupIntent::NextAction`
+* Add support for `payment_method_options` on `PaymentLinkCreateParams`, `PaymentLinkUpdateParams`, and `PaymentLink`
+* Add support for `active` on `PaymentMethodConfigurationListParams`
+* Add support for `billed_until` on `SubscriptionItem`
+* Add support for `discount` and `discounts` on `Subscription::PendingUpdate`
+* Add support for `verifone_m425`, `verifone_p630`, `verifone_ux700`, and `verifone_v660p` on `Terminal::ConfigurationCreateParams`, `Terminal::ConfigurationUpdateParams`, and `Terminal::Configuration`
+* Add support for `api_error` and `print_content` on `Terminal::Reader::Action`
+* Add support for `customer` on `TestHelpers::TestClockCreateParams`
+* Add support for `signer` on `V2::Core::Account::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::Account::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountCreateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::AccountCreateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountUpdateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`
+* Add support for `azure_event_grid` on `V2::Core::EventDestinationCreateParams` and `V2::Core::EventDestination`
+* Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `V2::Commerce::ProductCatalogImport`
diff --git a/.hark/changes/2026-05-27_xavdid_emit-warning-stripe.change.md b/.hark/changes/2026-05-27_xavdid_emit-warning-stripe.change.md
new file mode 100644
index 000000000..a13b6c341
--- /dev/null
+++ b/.hark/changes/2026-05-27_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-ruby/pull/1866
+released_in_version: 19.2.0
+---
diff --git a/.hark/changes/2026-06-04_xavdid_add-source-field.change.md b/.hark/changes/2026-06-04_xavdid_add-source-field.change.md
new file mode 100644
index 000000000..3778eeb2f
--- /dev/null
+++ b/.hark/changes/2026-06-04_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-ruby/pull/1874
+released_in_version: 19.2.1
+---
diff --git a/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..9d1e10d1d
--- /dev/null
+++ b/.hark/changes/2026-06-24_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,31 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1896
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 19.3.0
+---
+
+* Add support for `release_details` on `Reserve::Hold`
+* Change `Billing::CreditGrant.priority` to be required
+* Add support for `buyer_id` on `Charge::PaymentMethodDetail::Bizum`, `ConfirmationToken::PaymentMethodPreview::Bizum`, `ConfirmationToken::PaymentMethodPreview::Blik`, `PaymentAttemptRecord::PaymentMethodDetail::Bizum`, `PaymentMethod::Bizum`, `PaymentMethod::Blik`, and `PaymentRecord::PaymentMethodDetail::Bizum`
+* Add support for `transaction_link_id` on `Charge::PaymentMethodDetail::Card`
+* Add support for `fingerprint` on `Charge::PaymentMethodDetail::Pix`, `ConfirmationToken::PaymentMethodPreview::Pix`, `PaymentMethod::Pix`, and `SetupAttempt::PaymentMethodDetail::Pix`
+* Add support for `sunbit` on `Checkout::Session::PaymentMethodOption`, `Checkout::SessionCreateParams::PaymentMethodOption`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodOption`, and `PaymentIntentUpdateParams::PaymentMethodOption`
+* Add support for `billing_cycle_anchor_config` on `Checkout::SessionCreateParams::SubscriptionDatum`
+* Add support for `wechat_pay` on `Checkout::Session::PaymentMethodOption`
+* Add support for `mastercard_compliance` on `Dispute::Evidence::EnhancedEvidence`, `Dispute::EvidenceDetail::EnhancedEligibility`, and `DisputeUpdateParams::Evidence::EnhancedEvidence`
+* Add support for `status_details` on `FinancialConnections::Account`
+* ⚠️ Remove support for `stored_credential_usage` on `PaymentAttemptRecord::PaymentMethodDetail::Card` and `PaymentRecord::PaymentMethodDetail::Card`
+* ⚠️ Change `PaymentAttemptRecord::PaymentMethodDetail::Card.description` and `PaymentRecord::PaymentMethodDetail::Card.description` to be optional
+* ⚠️ Change `PaymentAttemptRecord::PaymentMethodDetail::Card.iin` and `PaymentRecord::PaymentMethodDetail::Card.iin` to be optional
+* ⚠️ Change `PaymentAttemptRecord::PaymentMethodDetail::Card.issuer` and `PaymentRecord::PaymentMethodDetail::Card.issuer` to be optional
+* Add support for `setup_future_usage` on `PaymentIntent::PaymentMethodOption::Satispay`, `PaymentIntentConfirmParams::PaymentMethodOption::Satispay`, `PaymentIntentCreateParams::PaymentMethodOption::Satispay`, and `PaymentIntentUpdateParams::PaymentMethodOption::Satispay`
+* Change `PaymentRecordReportRefundParams.refunded` to be optional
+* Add support for `satispay` on `SetupAttempt::PaymentMethodDetail`
+* Add support for `custom_fields`, `description`, and `footer` on `Subscription::InvoiceSetting`, `SubscriptionCreateParams::InvoiceSetting`, and `SubscriptionUpdateParams::InvoiceSetting`
+* Add support for `payment_method_options` and `payment_method` on `TopupCreateParams`
+* Add support for `mode` on `V2::Commerce::ProductCatalogImport`
+* Add support for `sunbit_payments` on `V2::Core::Account::Configuration::Merchant::Capability`, `V2::Core::AccountCreateParams::Configuration::Merchant::Capability`, and `V2::Core::AccountUpdateParams::Configuration::Merchant::Capability`
+* Add support for `crypto_money_manager` and `money_manager` on `V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService`
+* ⚠️ Remove support for `crypto_storer` and `storer` on `V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService`
diff --git a/.hark/changes/2026-07-13_xavdid_make-error-fields.change.md b/.hark/changes/2026-07-13_xavdid_make-error-fields.change.md
new file mode 100644
index 000000000..3edbca2b4
--- /dev/null
+++ b/.hark/changes/2026-07-13_xavdid_make-error-fields.change.md
@@ -0,0 +1,5 @@
+---
+title: Make Error fields generated
+pr_url: https://github.com/stripe/stripe-ruby/pull/1901
+released_in_version: 19.3.1
+---
diff --git a/.hark/changes/2026-07-16_xavdid_replace-source-hash.change.md b/.hark/changes/2026-07-16_xavdid_replace-source-hash.change.md
new file mode 100644
index 000000000..5907f211b
--- /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-ruby/pull/1902
+released_in_version: 19.3.1
+---
diff --git a/.hark/changes/2026-07-17_zacchua_adds-errorobject-rbi.change.md b/.hark/changes/2026-07-17_zacchua_adds-errorobject-rbi.change.md
new file mode 100644
index 000000000..1352c7846
--- /dev/null
+++ b/.hark/changes/2026-07-17_zacchua_adds-errorobject-rbi.change.md
@@ -0,0 +1,5 @@
+---
+title: Adds `error_object.rbi` file, allowing users to get full typing for API Error Objects
+pr_url: https://github.com/stripe/stripe-ruby/pull/1906
+released_in_version: 19.4.0
+---
diff --git a/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md b/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md
new file mode 100644
index 000000000..bc43244b6
--- /dev/null
+++ b/.hark/changes/2026-07-29_stripe-openapi_update-generated-code.change.md
@@ -0,0 +1,33 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1913
+is_stripe_api_change: true
+released_in_version: 19.4.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 `smart_disputes_management` on `AccountSession::Component::DisputesList::Feature`, `AccountSession::Component::Payment::Feature`, `AccountSession::Component::PaymentDetail::Feature`, `AccountSession::Component::PaymentDispute::Feature`, `AccountSessionCreateParams::Component::DisputesList::Feature`, `AccountSessionCreateParams::Component::Payment::Feature`, `AccountSessionCreateParams::Component::PaymentDetail::Feature`, and `AccountSessionCreateParams::Component::PaymentDispute::Feature`
+* Add support for `administrative_address` and `principal_place_of_business` on `Account::Company`, `AccountCreateParams::Company`, `AccountUpdateParams::Company`, and `TokenCreateParams::Account::Company`
+* Add support for `sepa_debit_payments` on `AccountUpdateParams::Setting`
+* Remove support for `proof_of_registration` on `AccountCreateParams::Document`.  This field was limited-use and is being deprecated.
+* Add support for `payouts_action` on `AccountRejectParams`
+* Remove support for `dynamic_tax_rates` on `Checkout::SessionCreateParams::LineItem`.  This field was limited-use and is being deprecated.
+* Add support for `setup_future_usage` on `Checkout::Session::PaymentMethodOption::Payco`, `Checkout::Session::PaymentMethodOption::SamsungPay`, `Checkout::SessionCreateParams::PaymentMethodOption::Payco`, `Checkout::SessionCreateParams::PaymentMethodOption::SamsungPay`, `PaymentIntent::PaymentMethodOption::Payco`, `PaymentIntent::PaymentMethodOption::SamsungPay`, `PaymentIntentConfirmParams::PaymentMethodOption::Payco`, `PaymentIntentConfirmParams::PaymentMethodOption::SamsungPay`, `PaymentIntentCreateParams::PaymentMethodOption::Payco`, `PaymentIntentCreateParams::PaymentMethodOption::SamsungPay`, `PaymentIntentUpdateParams::PaymentMethodOption::Payco`, `PaymentIntentUpdateParams::PaymentMethodOption::SamsungPay`, and `PaymentLinkUpdateParams::PaymentIntentDatum`
+* Add support for `network` on `Dispute::PaymentMethodDetail::Card`
+* Add support for `limits` and `manual_entry` on `FinancialConnections::SessionCreateParams` and `FinancialConnections::Session`
+* Add support for `require_payment_method_support` on `FinancialConnections::Session::Filter` and `FinancialConnections::SessionCreateParams::Filter`
+* Add support for `bank_account_token` on `FinancialConnections::Session`
+* Add support for `metadata` on `InvoiceCreatePreviewParams::SubscriptionDetail`
+* Add support for `business_name` on `Issuing::Card::Shipping`, `Issuing::CardCreateParams::Shipping`, and `Issuing::CardUpdateParams::Shipping`
+* Add support for `allowed_payment_method_types` on `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentUpdateParams`, `PaymentIntent`, `SetupIntentConfirmParams`, `SetupIntentCreateParams`, `SetupIntentUpdateParams`, and `SetupIntent`
+* Add support for `referrer` on `PaymentIntentConfirmParams::RadarOption` and `PaymentIntentCreateParams::RadarOption`
+* Add support for `consent_collection` and `shipping_options` on `PaymentLinkUpdateParams`
+* Add support for `custom_fields`, `description`, and `footer` on `Quote::InvoiceSetting`, `QuoteCreateParams::InvoiceSetting`, `QuoteUpdateParams::InvoiceSetting`, `SubscriptionSchedule::DefaultSetting::InvoiceSetting`, `SubscriptionSchedule::Phase::InvoiceSetting`, `SubscriptionScheduleCreateParams::DefaultSetting::InvoiceSetting`, `SubscriptionScheduleCreateParams::Phase::InvoiceSetting`, `SubscriptionScheduleUpdateParams::DefaultSetting::InvoiceSetting`, and `SubscriptionScheduleUpdateParams::Phase::InvoiceSetting`
+* Add support for `customer_account` and `customer` on `Refund`
+* Add support for `payment_method` on `Refund` and `Topup`
+* Add support for `trial` on `SubscriptionSchedule::Phase`
+* Add support for `mass_transit_parking_tax` and `parking_tax` on `Tax::Registration::CountryOption::Me` and `Tax::RegistrationCreateParams::CountryOption::Me`
+* Add support for `initiated_by` and `payment_method_options` on `Topup`
+* Add support for `additional_addresses` on `V2::Core::Account::Identity::BusinessDetail`, `V2::Core::AccountCreateParams::Identity::BusinessDetail`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail`
diff --git a/.hark/changes/2026-08-05_zacchua_discard-connection-request.change.md b/.hark/changes/2026-08-05_zacchua_discard-connection-request.change.md
new file mode 100644
index 000000000..1423e2edd
--- /dev/null
+++ b/.hark/changes/2026-08-05_zacchua_discard-connection-request.change.md
@@ -0,0 +1,7 @@
+---
+title: Discard the connection when a request is interrupted
+pr_url: https://github.com/stripe/stripe-ruby/pull/1924
+released_in_version: 19.5.0
+---
+
+- Fix connection reuse after a request is interrupted by a non-StandardError exception (e.g. from rack-timeout), which could cause subsequent requests to receive a previous request's response
diff --git a/.hark/changes/2026-08-07_xavdid_add-adjust-event.change.md b/.hark/changes/2026-08-07_xavdid_add-adjust-event.change.md
new file mode 100644
index 000000000..fb6b0f38a
--- /dev/null
+++ b/.hark/changes/2026-08-07_xavdid_add-adjust-event.change.md
@@ -0,0 +1,9 @@
+---
+title: add/adjust event parsing helpers
+pr_url: https://github.com/stripe/stripe-ruby/pull/1918
+released_in_version: 19.5.0
+---
+
+- Added methods that return their respective `Event`/`EventNotification` class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from [AWS EventBridge](https://docs.stripe.com/event-destinations/eventbridge) and [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid) natively.
+  - `Webhook#construct_event_without_verification(payload)`
+  - `StripeClient#parse_event_notification_without_verification(payload)`
diff --git a/.hark/changes/2026-08-07_xavdid_surface-object-property.change.md b/.hark/changes/2026-08-07_xavdid_surface-object-property.change.md
new file mode 100644
index 000000000..1d53803a3
--- /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-ruby/pull/1927
+released_in_version: 19.5.0
+---
diff --git a/.hark/changes/2026-08-10_jar_handle-break-auto.change.md b/.hark/changes/2026-08-10_jar_handle-break-auto.change.md
new file mode 100644
index 000000000..d8b71a8cf
--- /dev/null
+++ b/.hark/changes/2026-08-10_jar_handle-break-auto.change.md
@@ -0,0 +1,7 @@
+---
+title: Handle break in auto-paging blocks
+pr_url: https://github.com/stripe/stripe-ruby/pull/1932
+released_in_version: 19.5.0
+---
+
+- Rescues `LocalJumpError` to prevent crash when calling `break` inside an `auto_paging_each`
diff --git a/.hark/changes/2026-08-11_jar_extract-v2typecoerci-module.change.md b/.hark/changes/2026-08-11_jar_extract-v2typecoerci-module.change.md
new file mode 100644
index 000000000..2b4ba57d5
--- /dev/null
+++ b/.hark/changes/2026-08-11_jar_extract-v2typecoerci-module.change.md
@@ -0,0 +1,7 @@
+---
+title: Extract V2TypeCoercion module for bidirectional field encoding
+pr_url: https://github.com/stripe/stripe-ruby/pull/1926
+released_in_version: 19.6.0
+---
+
+- Fixes V2 `int64_string` response fields so they return `Integer` (to match the field's Sorbet type) instead of `String`
diff --git a/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md b/.hark/changes/2026-08-19_xavdid_add-new-eventnotific.change.md
new file mode 100644
index 000000000..e7fa51d58
--- /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-ruby/pull/1937
+released_in_version: 19.6.0
+---
+
+- We've been putting a lot of time into rethinking the event handling experience in the SDKs. This new class is the culmination [of that effort](https://stripe.dev/blog/event-notification-handlers-thin-events).
+- They're designed for a tight coupling with both `StripeClient` and the fully-typed nature of [thin events](https://docs.stripe.com/event-destinations#thin-events). This delivers painless event destination upgrades, in-editor checks for common mistakes, and better code modularity.
+- Now that we've released [thin event notifications for v1 objects](https://docs.stripe.com/changelog#2026-08-26.dahlia), these new handlers are our recommended path for all integrations using thin event notifications.
+- See more detailed docs here: https://docs.stripe.com/webhooks/event-notification-handlers
diff --git a/.hark/changes/2026-08-25_jar_support-discriminate-unions.change.md b/.hark/changes/2026-08-25_jar_support-discriminate-unions.change.md
new file mode 100644
index 000000000..72d4eae00
--- /dev/null
+++ b/.hark/changes/2026-08-25_jar_support-discriminate-unions.change.md
@@ -0,0 +1,9 @@
+---
+title: Support discriminated unions in the V2 runtime
+pr_url: https://github.com/stripe/stripe-ruby/pull/1923
+released_in_version: 19.6.0
+---
+
+- Adds support for discriminated union (polymorphic) parameters and response fields in the V2 runtime. 
+- Serializing a discriminated union parameter whose discriminator is missing, or not a String or Symbol, raises `ArgumentError` rather than sending the value uncoerced. Callers building a union parameter as a plain Hash must include the discriminator.
+- Adds `nullable` field encoding support, so `int64_string` and `decimal_string` fields wrapped in a nullable coerce correctly.
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 000000000..190932928
--- /dev/null
+++ b/.hark/changes/2026-08-26_xavdid_update-generated-code.change.md
@@ -0,0 +1,25 @@
+---
+title: Update generated code
+pr_url: https://github.com/stripe/stripe-ruby/pull/1934
+semver_level: major
+is_stripe_api_change: true
+released_in_version: 19.6.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 `payment_method_settings` on `AccountSession::Component` and `AccountSessionCreateParams::Component`
+* Add support for `feedback_options` on `BillingPortal::Configuration::Feature::SubscriptionCancel::CancellationReason`, `BillingPortal::ConfigurationCreateParams::Feature::SubscriptionCancel::CancellationReason`, and `BillingPortal::ConfigurationUpdateParams::Feature::SubscriptionCancel::CancellationReason`
+* Add support for `customer_update` on `BillingPortal::Session::Flow`
+* Add support for `funding_source_group` on `Charge::PaymentMethodDetail::Card::Wallet::Link` and `Charge::PaymentMethodDetail::Link`
+* Add support for `funding_types_blocked` on `Checkout::Session::PaymentMethodOption::Card::Restriction` and `Checkout::SessionCreateParams::PaymentMethodOption::Card::Restriction`
+* Add support for `metadata` on `ConfirmationToken`
+* Add support for `active_entitlements` and `customer_portal` on `CustomerSession::Component` and `CustomerSessionCreateParams::Component`
+* Add support for `country` on `FinancialConnections::Session::Filter`
+* Add support for `frozen_fields` on `InvoiceItem`
+* Add support for `billie` on `Invoice::PaymentSetting::PaymentMethodOption`, `InvoiceCreateParams::PaymentSetting::PaymentMethodOption`, `InvoiceUpdateParams::PaymentSetting::PaymentMethodOption`, `Subscription::PaymentSetting::PaymentMethodOption`, `SubscriptionCreateParams::PaymentSetting::PaymentMethodOption`, and `SubscriptionUpdateParams::PaymentSetting::PaymentMethodOption`
+* ⚠️ Remove support for `cryptogram` on `PaymentAttemptRecord::PaymentMethodDetail::Card::ThreeDSecure` and `PaymentRecord::PaymentMethodDetail::Card::ThreeDSecure`
+* Change `PaymentIntent.allowed_payment_method_types` and `SetupIntent.allowed_payment_method_types` to be required
+* Add support for `application_fee_amount`, `application_fee_percent`, `on_behalf_of`, and `transfer_data` on `PaymentLinkUpdateParams`
+* Add support for `feedback_option` on `Subscription::CancellationDetail`, `SubscriptionCancelParams::CancellationDetail`, and `SubscriptionUpdateParams::CancellationDetail`
+* Add support for `igic` on `Tax::Registration::CountryOption::At`, `Tax::Registration::CountryOption::Be`, `Tax::Registration::CountryOption::Bg`, `Tax::Registration::CountryOption::Cy`, `Tax::Registration::CountryOption::Cz`, `Tax::Registration::CountryOption::De`, `Tax::Registration::CountryOption::Dk`, `Tax::Registration::CountryOption::E`, `Tax::Registration::CountryOption::Ee`, `Tax::Registration::CountryOption::Fi`, `Tax::Registration::CountryOption::Fr`, `Tax::Registration::CountryOption::Gr`, `Tax::Registration::CountryOption::Hr`, `Tax::Registration::CountryOption::Hu`, `Tax::Registration::CountryOption::Ie`, `Tax::Registration::CountryOption::It`, `Tax::Registration::CountryOption::Lt`, `Tax::Registration::CountryOption::Lu`, `Tax::Registration::CountryOption::Lv`, `Tax::Registration::CountryOption::Mt`, `Tax::Registration::CountryOption::Nl`, `Tax::Registration::CountryOption::Pl`, `Tax::Registration::CountryOption::Pt`, `Tax::Registration::CountryOption::Ro`, `Tax::Registration::CountryOption::Se`, `Tax::Registration::CountryOption::Si`, `Tax::Registration::CountryOption::Sk`, `Tax::RegistrationCreateParams::CountryOption::At`, `Tax::RegistrationCreateParams::CountryOption::Be`, `Tax::RegistrationCreateParams::CountryOption::Bg`, `Tax::RegistrationCreateParams::CountryOption::Cy`, `Tax::RegistrationCreateParams::CountryOption::Cz`, `Tax::RegistrationCreateParams::CountryOption::De`, `Tax::RegistrationCreateParams::CountryOption::Dk`, `Tax::RegistrationCreateParams::CountryOption::E`, `Tax::RegistrationCreateParams::CountryOption::Ee`, `Tax::RegistrationCreateParams::CountryOption::Fi`, `Tax::RegistrationCreateParams::CountryOption::Fr`, `Tax::RegistrationCreateParams::CountryOption::Gr`, `Tax::RegistrationCreateParams::CountryOption::Hr`, `Tax::RegistrationCreateParams::CountryOption::Hu`, `Tax::RegistrationCreateParams::CountryOption::Ie`, `Tax::RegistrationCreateParams::CountryOption::It`, `Tax::RegistrationCreateParams::CountryOption::Lt`, `Tax::RegistrationCreateParams::CountryOption::Lu`, `Tax::RegistrationCreateParams::CountryOption::Lv`, `Tax::RegistrationCreateParams::CountryOption::Mt`, `Tax::RegistrationCreateParams::CountryOption::Nl`, `Tax::RegistrationCreateParams::CountryOption::Pl`, `Tax::RegistrationCreateParams::CountryOption::Pt`, `Tax::RegistrationCreateParams::CountryOption::Ro`, `Tax::RegistrationCreateParams::CountryOption::Se`, `Tax::RegistrationCreateParams::CountryOption::Si`, and `Tax::RegistrationCreateParams::CountryOption::Sk`
diff --git a/.hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md b/.hark/changes/2026-08-31_xavdid_harden-api-requestor.change.md
new file mode 100644
index 000000000..f0ceab560
--- /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-ruby/pull/1950
+released_in_version: 19.6.1
+---
diff --git a/.hark/changes/2026-09-01_jar_fix-oauth-authorize.change.md b/.hark/changes/2026-09-01_jar_fix-oauth-authorize.change.md
new file mode 100644
index 000000000..29497e681
--- /dev/null
+++ b/.hark/changes/2026-09-01_jar_fix-oauth-authorize.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix OAuth authorize response type defaulting
+pr_url: https://github.com/stripe/stripe-ruby/pull/1956
+released_in_version: 19.6.1
+---
+
+- Fixes `OAuthService#authorize_url` to default `response_type` to `code` without overwriting an explicit value.
diff --git a/.hark/changes/2026-09-01_jar_forward-request-options.change.md b/.hark/changes/2026-09-01_jar_forward-request-options.change.md
new file mode 100644
index 000000000..8b6f25749
--- /dev/null
+++ b/.hark/changes/2026-09-01_jar_forward-request-options.change.md
@@ -0,0 +1,7 @@
+---
+title: Forward request options when fetching V2 list pages
+pr_url: https://github.com/stripe/stripe-ruby/pull/1955
+released_in_version: 19.6.1
+---
+
+- Fixes V2 `fetch_next_page` ignoring per-request API key and Stripe context overrides.
diff --git a/.hark/changes/2026-09-04_jar_fix-stripecontex-hash.change.md b/.hark/changes/2026-09-04_jar_fix-stripecontex-hash.change.md
new file mode 100644
index 000000000..bd394919f
--- /dev/null
+++ b/.hark/changes/2026-09-04_jar_fix-stripecontex-hash.change.md
@@ -0,0 +1,7 @@
+---
+title: Fix `StripeContext` hash key behavior
+pr_url: https://github.com/stripe/stripe-ruby/pull/1959
+released_in_version: 19.6.2
+---
+
+- Fixes `StripeContext` value hashing so equivalent contexts work interchangeably as `Hash` and `Set` keys.
diff --git a/.hark/changes/2026-09-09_xavdid_fix-webhook-tolerance.change.md b/.hark/changes/2026-09-09_xavdid_fix-webhook-tolerance.change.md
new file mode 100644
index 000000000..a55b7b99f
--- /dev/null
+++ b/.hark/changes/2026-09-09_xavdid_fix-webhook-tolerance.change.md
@@ -0,0 +1,5 @@
+---
+title: Fix webhook tolerance reference
+pr_url: https://github.com/stripe/stripe-ruby/pull/1962
+released_in_version: 19.6.2
+---
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 000000000..aafafe68a
--- /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-ruby/pull/1960
+released_in_version: 19.6.2
+---
diff --git a/.hark/intros/intro-1.55.1.md b/.hark/intros/intro-1.55.1.md
new file mode 100644
index 000000000..dea080b5c
--- /dev/null
+++ b/.hark/intros/intro-1.55.1.md
@@ -0,0 +1 @@
+Identical to 1.56.0 above. I incorrectly cut a patch-level release.
diff --git a/.hark/intros/intro-16.0.0.md b/.hark/intros/intro-16.0.0.md
new file mode 100644
index 000000000..caec7ed1d
--- /dev/null
+++ b/.hark/intros/intro-16.0.0.md
@@ -0,0 +1 @@
+This release contains breaking changes (prefixed with ⚠️ below)
diff --git a/.hark/intros/intro-19.0.0.md b/.hark/intros/intro-19.0.0.md
new file mode 100644
index 000000000..68edaeec8
--- /dev/null
+++ b/.hark/intros/intro-19.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-ruby/wiki/Migration-guide-for-v19) 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-3.0.2.md b/.hark/intros/intro-3.0.2.md
new file mode 100644
index 000000000..3141b9a73
--- /dev/null
+++ b/.hark/intros/intro-3.0.2.md
@@ -0,0 +1 @@
+**Important:** This version is non-functional and has been yanked in favor of 3.0.3.
diff --git a/.hark/intros/intro-5.0.0.md b/.hark/intros/intro-5.0.0.md
new file mode 100644
index 000000000..c05dfaa16
--- /dev/null
+++ b/.hark/intros/intro-5.0.0.md
@@ -0,0 +1,3 @@
+Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v5) contains a detailed list of backwards-incompatible changes with upgrade instructions.
+
+Pull requests included in this release (cf. [#815](https://github.com/stripe/stripe-ruby/pull/815)) (⚠️ = breaking changes):
diff --git a/.hark/intros/intro-7.0.0.md b/.hark/intros/intro-7.0.0.md
new file mode 100644
index 000000000..910c9d318
--- /dev/null
+++ b/.hark/intros/intro-7.0.0.md
@@ -0,0 +1,3 @@
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v7. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
+
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-8.0.0.md b/.hark/intros/intro-8.0.0.md
new file mode 100644
index 000000000..7c0d7a180
--- /dev/null
+++ b/.hark/intros/intro-8.0.0.md
@@ -0,0 +1,3 @@
+Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-11-15.
+
+"⚠️" symbol highlights breaking changes.
diff --git a/.hark/intros/intro-9.0.0.md b/.hark/intros/intro-9.0.0.md
new file mode 100644
index 000000000..9c37c78db
--- /dev/null
+++ b/.hark/intros/intro-9.0.0.md
@@ -0,0 +1 @@
+**⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
diff --git a/.hark/releases.json b/.hark/releases.json
new file mode 100644
index 000000000..8d8a93b8e
--- /dev/null
+++ b/.hark/releases.json
@@ -0,0 +1,2066 @@
+{
+  "metadata": {
+    "language": "ruby",
+    "channel": "ga"
+  },
+  "releases": [
+    {
+      "version": "19.6.2",
+      "released_on": "2026-09-09",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.6.1",
+      "released_on": "2026-09-01",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.6.0",
+      "released_on": "2026-08-26",
+      "pinned_api_version": "2026-08-26.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.5.0",
+      "released_on": "2026-08-10",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.4.0",
+      "released_on": "2026-07-29",
+      "pinned_api_version": "2026-07-29.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.3.1",
+      "released_on": "2026-07-15",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.3.0",
+      "released_on": "2026-06-24",
+      "pinned_api_version": "2026-06-24.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.2.1",
+      "released_on": "2026-06-12",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.2.0",
+      "released_on": "2026-05-27",
+      "pinned_api_version": "2026-05-27.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.1.0",
+      "released_on": "2026-04-23",
+      "pinned_api_version": "2026-04-22.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "19.0.0",
+      "released_on": "2026-03-25",
+      "pinned_api_version": "2026-03-25.dahlia",
+      "minimum_runtime_version": "2.7.0"
+    },
+    {
+      "version": "18.4.2",
+      "released_on": "2026-03-10",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.4.1",
+      "released_on": "2026-03-06",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.4.0",
+      "released_on": "2026-02-25",
+      "pinned_api_version": "2026-02-25.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.3.1",
+      "released_on": "2026-02-03",
+      "pinned_api_version": "2026-01-28.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.3.0",
+      "released_on": "2026-01-28",
+      "pinned_api_version": "2026-01-28.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.2.0",
+      "released_on": "2026-01-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.1.0",
+      "released_on": "2025-12-16",
+      "pinned_api_version": "2025-12-15.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.0.1",
+      "released_on": "2025-11-21",
+      "pinned_api_version": "2025-11-17.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "18.0.0",
+      "released_on": "2025-11-18",
+      "pinned_api_version": "2025-11-17.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "17.2.0",
+      "released_on": "2025-11-05",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "17.1.0",
+      "released_on": "2025-10-29",
+      "pinned_api_version": "2025-10-29.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "17.0.1",
+      "released_on": "2025-10-16",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "17.0.0",
+      "released_on": "2025-10-09",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "16.0.0",
+      "released_on": "2025-09-30",
+      "pinned_api_version": "2025-09-30.clover",
+      "minimum_runtime_version": "2.6.0"
+    },
+    {
+      "version": "15.5.0",
+      "released_on": "2025-08-27",
+      "pinned_api_version": "2025-08-27.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.4.0",
+      "released_on": "2025-07-30",
+      "pinned_api_version": "2025-07-30.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.3.0",
+      "released_on": "2025-07-01",
+      "pinned_api_version": "2025-06-30.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.2.1",
+      "released_on": "2025-06-04",
+      "pinned_api_version": "2025-05-28.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.2.0",
+      "released_on": "2025-05-29",
+      "pinned_api_version": "2025-05-28.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.1.0",
+      "released_on": "2025-04-30",
+      "pinned_api_version": "2025-04-30.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.5.1",
+      "released_on": "2025-04-21",
+      "pinned_api_version": "2025-02-24.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "15.0.0",
+      "released_on": "2025-04-09",
+      "pinned_api_version": "2025-03-31.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "14.0.0",
+      "released_on": "2025-04-01",
+      "pinned_api_version": "2025-03-31.basil",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.5.0",
+      "released_on": "2025-02-24",
+      "pinned_api_version": "2025-02-24.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.4.1",
+      "released_on": "2025-01-28",
+      "pinned_api_version": "2025-01-27.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.4.0",
+      "released_on": "2025-01-27",
+      "pinned_api_version": "2025-01-27.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.3.1",
+      "released_on": "2025-01-13",
+      "pinned_api_version": "2024-12-18.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.3.0",
+      "released_on": "2024-12-18",
+      "pinned_api_version": "2024-12-18.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.2.0",
+      "released_on": "2024-11-20",
+      "pinned_api_version": "2024-11-20.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.1.2",
+      "released_on": "2024-11-15",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.1.1",
+      "released_on": "2024-11-06",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.1.0",
+      "released_on": "2024-10-29",
+      "pinned_api_version": "2024-10-28.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.0.2",
+      "released_on": "2024-10-23",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.0.1",
+      "released_on": "2024-10-18",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "13.0.0",
+      "released_on": "2024-10-01",
+      "pinned_api_version": "2024-09-30.acacia",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.6.0",
+      "released_on": "2024-09-12",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.5.0",
+      "released_on": "2024-08-08",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.4.0",
+      "released_on": "2024-07-25",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.3.0",
+      "released_on": "2024-07-18",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.2.0",
+      "released_on": "2024-07-12",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.1.0",
+      "released_on": "2024-07-05",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "12.0.0",
+      "released_on": "2024-06-24",
+      "pinned_api_version": "2024-06-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.7.0",
+      "released_on": "2024-06-13",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.6.0",
+      "released_on": "2024-05-30",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.5.0",
+      "released_on": "2024-05-23",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.4.0",
+      "released_on": "2024-05-09",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.3.0",
+      "released_on": "2024-05-02",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.2.0",
+      "released_on": "2024-04-18",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.1.0",
+      "released_on": "2024-04-16",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "11.0.0",
+      "released_on": "2024-04-10",
+      "pinned_api_version": "2024-04-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.15.0",
+      "released_on": "2024-04-09",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.14.0",
+      "released_on": "2024-03-28",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.13.0",
+      "released_on": "2024-03-21",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.12.0",
+      "released_on": "2024-03-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.11.0",
+      "released_on": "2024-02-29",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.10.0",
+      "released_on": "2024-02-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.9.0",
+      "released_on": "2024-02-15",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.8.0",
+      "released_on": "2024-02-08",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.7.1",
+      "released_on": "2024-02-05",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.7.0",
+      "released_on": "2024-02-01",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.6.0",
+      "released_on": "2024-01-12",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.5.0",
+      "released_on": "2024-01-04",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.4.0",
+      "released_on": "2023-12-22",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.3.0",
+      "released_on": "2023-12-14",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.2.0",
+      "released_on": "2023-11-30",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.1.0",
+      "released_on": "2023-11-02",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "10.0.0",
+      "released_on": "2023-10-16",
+      "pinned_api_version": "2023-10-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "9.4.0",
+      "released_on": "2023-10-05",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "9.3.0",
+      "released_on": "2023-09-14",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "9.2.0",
+      "released_on": "2023-09-07",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "9.1.0",
+      "released_on": "2023-08-31",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "9.0.0",
+      "released_on": "2023-08-16",
+      "pinned_api_version": "2023-08-16",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.7.0",
+      "released_on": "2023-08-10",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.6.0",
+      "released_on": "2023-07-13",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.5.0",
+      "released_on": "2023-03-30",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.4.0",
+      "released_on": "2023-03-23",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.3.0",
+      "released_on": "2023-02-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.2.0",
+      "released_on": "2023-02-02",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.1.0",
+      "released_on": "2023-01-12",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "8.0.0",
+      "released_on": "2022-11-16",
+      "pinned_api_version": "2022-11-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "7.1.0",
+      "released_on": "2022-08-19",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "7.0.0",
+      "released_on": "2022-08-02",
+      "pinned_api_version": "2022-08-01",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.5.0",
+      "released_on": "2022-06-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.4.0",
+      "released_on": "2022-06-17",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.3.0",
+      "released_on": "2022-06-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.2.0",
+      "released_on": "2022-05-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.1.0",
+      "released_on": "2022-05-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "6.0.0",
+      "released_on": "2022-05-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.55.0",
+      "released_on": "2022-05-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.54.0",
+      "released_on": "2022-05-03",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.53.0",
+      "released_on": "2022-04-21",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.52.0",
+      "released_on": "2022-04-18",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.51.0",
+      "released_on": "2022-04-15",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.50.0",
+      "released_on": "2022-04-13",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.49.0",
+      "released_on": "2022-04-08",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.48.0",
+      "released_on": "2022-03-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.47.0",
+      "released_on": "2022-03-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.46.0",
+      "released_on": "2022-03-23",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.45.0",
+      "released_on": "2022-03-01",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.44.0",
+      "released_on": "2022-02-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.43.0",
+      "released_on": "2022-01-20",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.42.0",
+      "released_on": "2021-12-13",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.41.0",
+      "released_on": "2021-11-16",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.40.0",
+      "released_on": "2021-11-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.39.0",
+      "released_on": "2021-10-11",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.38.0",
+      "released_on": "2021-08-10",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.37.0",
+      "released_on": "2021-07-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.36.0",
+      "released_on": "2021-07-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.35.0",
+      "released_on": "2021-06-30",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.34.0",
+      "released_on": "2021-06-04",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.33.0",
+      "released_on": "2021-05-19",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.32.1",
+      "released_on": "2021-04-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.32.0",
+      "released_on": "2021-04-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.31.0",
+      "released_on": "2021-04-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.30.0",
+      "released_on": "2021-02-22",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.29.1",
+      "released_on": "2021-02-09",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.29.0",
+      "released_on": "2021-01-05",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.28.0",
+      "released_on": "2020-10-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.27.0",
+      "released_on": "2020-10-14",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.26.0",
+      "released_on": "2020-09-29",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.25.0",
+      "released_on": "2020-09-02",
+      "pinned_api_version": "2020-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.24.0",
+      "released_on": "2020-08-26",
+      "pinned_api_version": "2020-03-02",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.23.1",
+      "released_on": "2020-08-05",
+      "pinned_api_version": "2020-03-02",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.23.0",
+      "released_on": "2020-08-05",
+      "pinned_api_version": "2020-03-02",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.22.0",
+      "released_on": "2020-05-11",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.21.0",
+      "released_on": "2020-04-29",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.20.0",
+      "released_on": "2020-04-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.19.0",
+      "released_on": "2020-04-24",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.18.0",
+      "released_on": "2020-04-22",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.17.0",
+      "released_on": "2020-02-26",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.16.0",
+      "released_on": "2020-02-26",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.15.0",
+      "released_on": "2020-02-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.14.0",
+      "released_on": "2020-01-14",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.13.0",
+      "released_on": "2020-01-08",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.12.1",
+      "released_on": "2020-01-06",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.12.0",
+      "released_on": "2020-01-02",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.11.0",
+      "released_on": "2019-11-26",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.10.0",
+      "released_on": "2019-11-08",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.9.0",
+      "released_on": "2019-11-07",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.8.0",
+      "released_on": "2019-11-05",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.7.1",
+      "released_on": "2019-10-15",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.7.0",
+      "released_on": "2019-10-10",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.6.0",
+      "released_on": "2019-10-04",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.5.0",
+      "released_on": "2019-10-03",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.4.1",
+      "released_on": "2019-10-01",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.4.0",
+      "released_on": "2019-10-01",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.3.0",
+      "released_on": "2019-10-01",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.2.0",
+      "released_on": "2019-09-19",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.1.1",
+      "released_on": "2019-09-04",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.1.0",
+      "released_on": "2019-08-27",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.0.1",
+      "released_on": "2019-08-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "5.0.0",
+      "released_on": "2019-08-20",
+      "minimum_runtime_version": "2.3.0"
+    },
+    {
+      "version": "4.24.0",
+      "released_on": "2019-08-12",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.23.0",
+      "released_on": "2019-08-09",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.22.1",
+      "released_on": "2019-08-09",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.22.0",
+      "released_on": "2019-07-30",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.21.3",
+      "released_on": "2019-07-15",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.21.2",
+      "released_on": "2019-07-05",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.21.1",
+      "released_on": "2019-07-04",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.21.0",
+      "released_on": "2019-06-28",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.20.1",
+      "released_on": "2019-06-28",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.20.0",
+      "released_on": "2019-06-24",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.19.0",
+      "released_on": "2019-06-17",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.18.1",
+      "released_on": "2019-05-27",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.18.0",
+      "released_on": "2019-05-23",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.17.0",
+      "released_on": "2019-05-14",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.16.0",
+      "released_on": "2019-04-24",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.15.0",
+      "released_on": "2019-04-22",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.14.0",
+      "released_on": "2019-04-18",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.13.0",
+      "released_on": "2019-04-16",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.12.0",
+      "released_on": "2019-04-02",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.11.0",
+      "released_on": "2019-03-26",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.10.0",
+      "released_on": "2019-03-18",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.9.1",
+      "released_on": "2019-03-18",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.9.0",
+      "released_on": "2019-02-12",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.8.1",
+      "released_on": "2019-02-11",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.8.0",
+      "released_on": "2019-02-03",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.7.1",
+      "released_on": "2019-02-01",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.7.0",
+      "released_on": "2019-01-23",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.6.0",
+      "released_on": "2019-01-21",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.5.0",
+      "released_on": "2019-01-02",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.4.1",
+      "released_on": "2018-12-31",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.4.0",
+      "released_on": "2018-12-21",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.3.0",
+      "released_on": "2018-12-10",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.2.0",
+      "released_on": "2018-11-28",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.1.0",
+      "released_on": "2018-11-27",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.0.3",
+      "released_on": "2018-11-19",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.0.2",
+      "released_on": "2018-11-16",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.0.1",
+      "released_on": "2018-11-15",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "4.0.0",
+      "released_on": "2018-11-15",
+      "minimum_runtime_version": "2.1.0"
+    },
+    {
+      "version": "3.31.1",
+      "released_on": "2018-11-12",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.31.0",
+      "released_on": "2018-11-12",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.30.0",
+      "released_on": "2018-11-08",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.29.0",
+      "released_on": "2018-10-30",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.28.0",
+      "released_on": "2018-09-24",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.27.0",
+      "released_on": "2018-09-24",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.26.1",
+      "released_on": "2018-09-14",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.26.0",
+      "released_on": "2018-09-05",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.25.0",
+      "released_on": "2018-08-28",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.24.0",
+      "released_on": "2018-08-27",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.23.0",
+      "released_on": "2018-08-23",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.22.0",
+      "released_on": "2018-08-15",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.21.0",
+      "released_on": "2018-08-03",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.20.0",
+      "released_on": "2018-08-03",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.19.0",
+      "released_on": "2018-07-27",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.18.0",
+      "released_on": "2018-07-26",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.17.2",
+      "released_on": "2018-07-19",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.17.1",
+      "released_on": "2018-07-19",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.17.0",
+      "released_on": "2018-06-28",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.16.0",
+      "released_on": "2018-06-28",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.15.0",
+      "released_on": "2018-05-10",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.14.0",
+      "released_on": "2018-05-09",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.13.1",
+      "released_on": "2018-05-07",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.13.0",
+      "released_on": "2018-04-11",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.12.1",
+      "released_on": "2018-04-05",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.12.0",
+      "released_on": "2018-04-05",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.11.0",
+      "released_on": "2018-02-26",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.10.0",
+      "released_on": "2018-02-21",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.9.2",
+      "released_on": "2018-02-12",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.9.1",
+      "released_on": "2017-12-15",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.9.0",
+      "released_on": "2017-12-08",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.8.2",
+      "released_on": "2017-12-07",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.8.1",
+      "released_on": "2017-12-06",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.8.0",
+      "released_on": "2017-10-31",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.7.0",
+      "released_on": "2017-10-26",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.6.0",
+      "released_on": "2017-10-17",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.5.3",
+      "released_on": "2017-10-16",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.5.2",
+      "released_on": "2017-10-13",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.5.1",
+      "released_on": "2017-10-12",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.5.0",
+      "released_on": "2017-10-11",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.4.1",
+      "released_on": "2017-10-05",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.4.0",
+      "released_on": "2017-09-20"
+    },
+    {
+      "version": "3.3.2",
+      "released_on": "2017-09-20",
+      "minimum_runtime_version": "2.0.0"
+    },
+    {
+      "version": "3.3.1",
+      "released_on": "2017-08-18",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.3.0",
+      "released_on": "2017-08-11",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.2.0",
+      "released_on": "2017-08-03",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.1.0",
+      "released_on": "2017-08-03",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.0.3",
+      "released_on": "2017-07-28",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.0.2",
+      "released_on": "2017-07-12",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.0.1",
+      "released_on": "2017-07-11",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "3.0.0",
+      "released_on": "2017-06-27",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.12.0",
+      "released_on": "2017-06-20",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.11.0",
+      "released_on": "2017-05-26",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.10.0",
+      "released_on": "2017-05-25",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.9.0",
+      "released_on": "2017-05-18",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.8.0",
+      "released_on": "2017-04-28",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.7.0",
+      "released_on": "2017-04-26",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.6.0",
+      "released_on": "2017-04-26",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.5.0",
+      "released_on": "2017-04-24",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.4.0",
+      "released_on": "2017-04-18",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.3.0",
+      "released_on": "2017-04-14",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.2.1",
+      "released_on": "2017-04-07",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.2.0",
+      "released_on": "2017-04-06",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.1.0",
+      "released_on": "2017-03-17",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.0.3",
+      "released_on": "2017-03-16",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.0.2",
+      "released_on": "2017-03-16",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.0.1",
+      "released_on": "2017-02-22",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "2.0.0",
+      "released_on": "2017-02-14",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.58.0",
+      "released_on": "2017-01-19",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.57.1",
+      "released_on": "2016-11-28",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.57.0",
+      "released_on": "2016-11-21",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.56.2",
+      "released_on": "2016-11-17",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.56.1",
+      "released_on": "2016-11-09",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.56.0",
+      "released_on": "2016-10-24",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.55.1",
+      "released_on": "2016-10-24",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.55.0",
+      "released_on": "2016-09-15",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.54.0",
+      "released_on": "2016-09-01",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.53.0",
+      "released_on": "2016-08-31",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.52.0",
+      "released_on": "2016-08-30",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.51.1",
+      "released_on": "2016-08-30",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.51.0",
+      "released_on": "2016-08-26",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.50.1",
+      "released_on": "2016-08-25",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.50.0",
+      "released_on": "2016-08-15",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.49.0",
+      "released_on": "2016-07-28",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.48.0",
+      "released_on": "2016-07-12",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.47.0",
+      "released_on": "2016-07-11",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.46.0",
+      "released_on": "2016-07-07",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.45.0",
+      "released_on": "2016-07-07",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.44.0",
+      "released_on": "2016-06-29",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.43.1",
+      "released_on": "2016-06-17",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.43.0",
+      "released_on": "2016-05-20",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.42.0",
+      "released_on": "2016-05-04",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.41.0",
+      "released_on": "2016-04-13",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.40.0",
+      "released_on": "2016-04-06",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.39.0",
+      "released_on": "2016-03-31",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.38.0",
+      "released_on": "2016-03-18",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.37.0",
+      "released_on": "2016-03-14",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.36.2",
+      "released_on": "2016-03-14",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.36.1",
+      "released_on": "2016-03-04",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.36.0",
+      "released_on": "2016-02-08",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.35.1",
+      "released_on": "2016-02-03",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.35.0",
+      "released_on": "2016-02-01",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.34.0",
+      "released_on": "2016-01-25",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.33.1",
+      "released_on": "2016-01-21",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.33.0",
+      "released_on": "2016-01-19",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.32.1",
+      "released_on": "2016-01-07",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.32.0",
+      "released_on": "2016-01-05",
+      "minimum_runtime_version": "1.9.3"
+    },
+    {
+      "version": "1.31.0",
+      "released_on": "2015-10-29"
+    },
+    {
+      "version": "1.30.3",
+      "released_on": "2015-10-28"
+    },
+    {
+      "version": "1.30.2",
+      "released_on": "2015-10-12"
+    },
+    {
+      "version": "1.30.1",
+      "released_on": "2015-10-10"
+    },
+    {
+      "version": "1.30.0",
+      "released_on": "2015-10-09"
+    },
+    {
+      "version": "1.29.1",
+      "released_on": "2015-10-06"
+    },
+    {
+      "version": "1.29.0",
+      "released_on": "2015-10-05"
+    },
+    {
+      "version": "1.28.1",
+      "released_on": "2015-10-05"
+    },
+    {
+      "version": "1.28.0",
+      "released_on": "2015-10-05"
+    },
+    {
+      "version": "1.27.2",
+      "released_on": "2015-09-25"
+    },
+    {
+      "version": "1.27.1",
+      "released_on": "2015-09-20"
+    },
+    {
+      "version": "1.27.0",
+      "released_on": "2015-09-14"
+    },
+    {
+      "version": "1.26.0",
+      "released_on": "2015-09-11"
+    },
+    {
+      "version": "1.25.0",
+      "released_on": "2015-08-17"
+    },
+    {
+      "version": "1.24.0",
+      "released_on": "2015-08-03"
+    },
+    {
+      "version": "1.23.0",
+      "released_on": "2015-07-06"
+    },
+    {
+      "version": "1.22.0",
+      "released_on": "2015-06-10"
+    },
+    {
+      "version": "1.21.0",
+      "released_on": "2015-04-14"
+    },
+    {
+      "version": "1.20.4",
+      "released_on": "2015-03-26"
+    },
+    {
+      "version": "1.20.3",
+      "released_on": "2015-03-13"
+    },
+    {
+      "version": "1.20.2",
+      "released_on": "2015-03-10"
+    },
+    {
+      "version": "1.20.1",
+      "released_on": "2015-02-26"
+    },
+    {
+      "version": "1.20.0",
+      "released_on": "2015-02-19"
+    },
+    {
+      "version": "1.19.1",
+      "released_on": "2015-02-18"
+    },
+    {
+      "version": "1.19.0",
+      "released_on": "2015-02-15"
+    },
+    {
+      "version": "1.18.0",
+      "released_on": "2015-01-21"
+    },
+    {
+      "version": "1.17.3",
+      "released_on": "2015-01-12"
+    },
+    {
+      "version": "1.17.2",
+      "released_on": "2015-01-08"
+    },
+    {
+      "version": "1.17.1",
+      "released_on": "2015-01-07"
+    },
+    {
+      "version": "1.17.0",
+      "released_on": "2014-12-23"
+    },
+    {
+      "version": "1.16.1",
+      "released_on": "2014-12-19"
+    },
+    {
+      "version": "1.16.0",
+      "released_on": "2014-10-08"
+    },
+    {
+      "version": "1.15.0",
+      "released_on": "2014-07-29"
+    },
+    {
+      "version": "1.14.0",
+      "released_on": "2014-06-17"
+    },
+    {
+      "version": "1.13.0",
+      "released_on": "2014-05-28"
+    },
+    {
+      "version": "1.12.0",
+      "released_on": "2014-05-21"
+    },
+    {
+      "version": "1.11.0",
+      "released_on": "2014-04-09"
+    },
+    {
+      "version": "1.10.2",
+      "released_on": "2014-02-18"
+    },
+    {
+      "version": "1.10.1",
+      "released_on": "2014-02-03"
+    },
+    {
+      "version": "1.10.0",
+      "released_on": "2014-01-29"
+    },
+    {
+      "version": "1.9.9",
+      "released_on": "2013-12-04"
+    },
+    {
+      "version": "1.8.9",
+      "released_on": "2013-11-14"
+    },
+    {
+      "version": "1.8.8",
+      "released_on": "2013-10-17"
+    },
+    {
+      "version": "1.8.7",
+      "released_on": "2013-09-19"
+    },
+    {
+      "version": "1.8.6",
+      "released_on": "2013-08-20"
+    },
+    {
+      "version": "1.8.5",
+      "released_on": "2013-08-12"
+    },
+    {
+      "version": "1.8.4",
+      "released_on": "2013-07-11"
+    },
+    {
+      "version": "1.8.3",
+      "released_on": "2013-05-06"
+    },
+    {
+      "version": "1.8.2",
+      "released_on": "2013-05-01"
+    },
+    {
+      "version": "1.8.1",
+      "released_on": "2013-04-19"
+    },
+    {
+      "version": "1.8.0",
+      "released_on": "2013-04-11"
+    },
+    {
+      "version": "1.7.11",
+      "released_on": "2013-02-21"
+    },
+    {
+      "version": "1.7.10",
+      "released_on": "2013-02-04"
+    },
+    {
+      "version": "1.7.9",
+      "released_on": "2013-01-15"
+    },
+    {
+      "version": "1.7.8",
+      "released_on": "2012-11-21"
+    },
+    {
+      "version": "1.7.7",
+      "released_on": "2012-11-08"
+    },
+    {
+      "version": "1.7.6",
+      "released_on": "2012-10-30"
+    },
+    {
+      "version": "1.7.5",
+      "released_on": "2012-10-25"
+    },
+    {
+      "version": "1.7.4",
+      "released_on": "2012-10-08"
+    },
+    {
+      "version": "1.7.3",
+      "released_on": "2012-09-14"
+    },
+    {
+      "version": "1.7.2",
+      "released_on": "2012-08-31"
+    },
+    {
+      "version": "1.7.1",
+      "released_on": "2012-08-17"
+    },
+    {
+      "version": "1.7.0",
+      "released_on": "2012-05-17"
+    },
+    {
+      "version": "1.6.3",
+      "released_on": "2012-03-22"
+    },
+    {
+      "version": "1.6.2",
+      "released_on": "2012-02-24"
+    },
+    {
+      "version": "1.6.1",
+      "released_on": "2012-02-22"
+    },
+    {
+      "version": "1.6.0",
+      "released_on": "2012-01-27"
+    },
+    {
+      "version": "1.5.26",
+      "released_on": "2012-01-26"
+    },
+    {
+      "version": "1.5.25",
+      "released_on": "2011-12-06"
+    },
+    {
+      "version": "1.5.24",
+      "released_on": "2011-11-25"
+    },
+    {
+      "version": "1.5.21",
+      "released_on": "2011-10-21"
+    },
+    {
+      "version": "1.5.20",
+      "released_on": "2011-10-05"
+    },
+    {
+      "version": "1.5.19",
+      "released_on": "2011-10-05"
+    },
+    {
+      "version": "1.5.18",
+      "released_on": "2011-10-03"
+    },
+    {
+      "version": "1.5.17",
+      "released_on": "2011-09-25"
+    },
+    {
+      "version": "1.5.16",
+      "released_on": "2011-09-08"
+    },
+    {
+      "version": "1.5.15",
+      "released_on": "2011-09-05"
+    },
+    {
+      "version": "1.5.14",
+      "released_on": "2011-08-08"
+    },
+    {
+      "version": "1.5.13",
+      "released_on": "2011-07-29"
+    },
+    {
+      "version": "1.5.12",
+      "released_on": "2011-07-27"
+    },
+    {
+      "version": "1.5.11",
+      "released_on": "2011-07-12"
+    },
+    {
+      "version": "1.5.10",
+      "released_on": "2011-07-12"
+    },
+    {
+      "version": "1.5.9",
+      "released_on": "2011-07-08"
+    },
+    {
+      "version": "1.5.8",
+      "released_on": "2011-07-04"
+    },
+    {
+      "version": "1.5.7",
+      "released_on": "2011-06-29"
+    },
+    {
+      "version": "1.5.6",
+      "released_on": "2011-06-27"
+    },
+    {
+      "version": "1.5.5",
+      "released_on": "2011-06-26"
+    },
+    {
+      "version": "1.5.4",
+      "released_on": "2011-06-26"
+    },
+    {
+      "version": "1.5.3",
+      "released_on": "2011-06-20"
+    },
+    {
+      "version": "1.5.2",
+      "released_on": "2011-06-19"
+    },
+    {
+      "version": "1.5.1",
+      "released_on": "2011-06-02"
+    },
+    {
+      "version": "1.5.0",
+      "released_on": "2011-05-26"
+    },
+    {
+      "version": "1.3.4",
+      "released_on": "2011-01-07"
+    },
+    {
+      "version": "1.2.0",
+      "released_on": "2010-06-06"
+    },
+    {
+      "version": "1.1.0",
+      "released_on": "2010-03-14"
+    },
+    {
+      "version": "1.0.0",
+      "released_on": "2010-01-05"
+    }
+  ]
+}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4b1f58bd..58b73261b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,36 +1,38 @@
+<!--
+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
 
-## 19.6.2 - 2026-09-09
-* [#1960](https://github.com/stripe/stripe-ruby/pull/1960) Validate that webhook secrets are non-empty
-* [#1962](https://github.com/stripe/stripe-ruby/pull/1962) Fix webhook tolerance reference
+## <a id="19-6-2"></a>19.6.2 - 2026-09-09
 * [#1959](https://github.com/stripe/stripe-ruby/pull/1959) Fix `StripeContext` hash key behavior
   - Fixes `StripeContext` value hashing so equivalent contexts work interchangeably as `Hash` and `Set` keys.
+* [#1962](https://github.com/stripe/stripe-ruby/pull/1962) Fix webhook tolerance reference
+* [#1960](https://github.com/stripe/stripe-ruby/pull/1960) Validate that webhook secrets are non-empty
 
-## 19.6.1 - 2026-09-01
-* [#1955](https://github.com/stripe/stripe-ruby/pull/1955) Forward request options when fetching V2 list pages
-  - Fixes V2 `fetch_next_page` ignoring per-request API key and Stripe context overrides.
+## <a id="19-6-1"></a>19.6.1 - 2026-09-01
+* [#1950](https://github.com/stripe/stripe-ruby/pull/1950) Harden API requestor code against malicious URLs
 * [#1956](https://github.com/stripe/stripe-ruby/pull/1956) Fix OAuth authorize response type defaulting
   - Fixes `OAuthService#authorize_url` to default `response_type` to `code` without overwriting an explicit value.
-* [#1950](https://github.com/stripe/stripe-ruby/pull/1950) Harden API requestor code against malicious URLs
+* [#1955](https://github.com/stripe/stripe-ruby/pull/1955) Forward request options when fetching V2 list pages
+  - Fixes V2 `fetch_next_page` ignoring per-request API key and Stripe context overrides.
 
-## 19.6.0 - 2026-08-26
-This release changes the pinned API version to 2026-08-26.dahlia.
+## <a id="19-6-0"></a>19.6.0 - 2026-08-26
+This release changes the pinned API version to `2026-08-26.dahlia`.
 
-* [#1923](https://github.com/stripe/stripe-ruby/pull/1923) Support discriminated unions in the V2 runtime
-  
-  - Adds support for discriminated union (polymorphic) parameters and response fields in the V2 runtime. 
-  - Serializing a discriminated union parameter whose discriminator is missing, or not a String or Symbol, raises `ArgumentError` rather than sending the value uncoerced. Callers building a union parameter as a plain Hash must include the discriminator.
-  - Adds `nullable` field encoding support, so `int64_string` and `decimal_string` fields wrapped in a nullable coerce correctly.
+* [#1926](https://github.com/stripe/stripe-ruby/pull/1926) Extract V2TypeCoercion module for bidirectional field encoding
+  - Fixes V2 `int64_string` response fields so they return `Integer` (to match the field's Sorbet type) instead of `String`
 * [#1937](https://github.com/stripe/stripe-ruby/pull/1937) 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
-* [#1926](https://github.com/stripe/stripe-ruby/pull/1926) Extract V2TypeCoercion module for bidirectional field encoding
-  
-  - Fixes V2 `int64_string` response fields so they return `Integer` (to match the field's Sorbet type) instead of `String`
-* [#1934](https://github.com/stripe/stripe-ruby/pull/1934) Update generated code
+* [#1923](https://github.com/stripe/stripe-ruby/pull/1923) Support discriminated unions in the V2 runtime
+  - Adds support for discriminated union (polymorphic) parameters and response fields in the V2 runtime. 
+  - Serializing a discriminated union parameter whose discriminator is missing, or not a String or Symbol, raises `ArgumentError` rather than sending the value uncoerced. Callers building a union parameter as a plain Hash must include the discriminator.
+  - Adds `nullable` field encoding support, so `int64_string` and `decimal_string` fields wrapped in a nullable coerce correctly.
+* ⚠️ [#1934](https://github.com/stripe/stripe-ruby/pull/1934) 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 `payment_method_settings` on `AccountSession::Component` and `AccountSessionCreateParams::Component`
@@ -49,21 +51,21 @@ This release changes the pinned API version to 2026-08-26.dahlia.
   * Add support for `feedback_option` on `Subscription::CancellationDetail`, `SubscriptionCancelParams::CancellationDetail`, and `SubscriptionUpdateParams::CancellationDetail`
   * Add support for `igic` on `Tax::Registration::CountryOption::At`, `Tax::Registration::CountryOption::Be`, `Tax::Registration::CountryOption::Bg`, `Tax::Registration::CountryOption::Cy`, `Tax::Registration::CountryOption::Cz`, `Tax::Registration::CountryOption::De`, `Tax::Registration::CountryOption::Dk`, `Tax::Registration::CountryOption::E`, `Tax::Registration::CountryOption::Ee`, `Tax::Registration::CountryOption::Fi`, `Tax::Registration::CountryOption::Fr`, `Tax::Registration::CountryOption::Gr`, `Tax::Registration::CountryOption::Hr`, `Tax::Registration::CountryOption::Hu`, `Tax::Registration::CountryOption::Ie`, `Tax::Registration::CountryOption::It`, `Tax::Registration::CountryOption::Lt`, `Tax::Registration::CountryOption::Lu`, `Tax::Registration::CountryOption::Lv`, `Tax::Registration::CountryOption::Mt`, `Tax::Registration::CountryOption::Nl`, `Tax::Registration::CountryOption::Pl`, `Tax::Registration::CountryOption::Pt`, `Tax::Registration::CountryOption::Ro`, `Tax::Registration::CountryOption::Se`, `Tax::Registration::CountryOption::Si`, `Tax::Registration::CountryOption::Sk`, `Tax::RegistrationCreateParams::CountryOption::At`, `Tax::RegistrationCreateParams::CountryOption::Be`, `Tax::RegistrationCreateParams::CountryOption::Bg`, `Tax::RegistrationCreateParams::CountryOption::Cy`, `Tax::RegistrationCreateParams::CountryOption::Cz`, `Tax::RegistrationCreateParams::CountryOption::De`, `Tax::RegistrationCreateParams::CountryOption::Dk`, `Tax::RegistrationCreateParams::CountryOption::E`, `Tax::RegistrationCreateParams::CountryOption::Ee`, `Tax::RegistrationCreateParams::CountryOption::Fi`, `Tax::RegistrationCreateParams::CountryOption::Fr`, `Tax::RegistrationCreateParams::CountryOption::Gr`, `Tax::RegistrationCreateParams::CountryOption::Hr`, `Tax::RegistrationCreateParams::CountryOption::Hu`, `Tax::RegistrationCreateParams::CountryOption::Ie`, `Tax::RegistrationCreateParams::CountryOption::It`, `Tax::RegistrationCreateParams::CountryOption::Lt`, `Tax::RegistrationCreateParams::CountryOption::Lu`, `Tax::RegistrationCreateParams::CountryOption::Lv`, `Tax::RegistrationCreateParams::CountryOption::Mt`, `Tax::RegistrationCreateParams::CountryOption::Nl`, `Tax::RegistrationCreateParams::CountryOption::Pl`, `Tax::RegistrationCreateParams::CountryOption::Pt`, `Tax::RegistrationCreateParams::CountryOption::Ro`, `Tax::RegistrationCreateParams::CountryOption::Se`, `Tax::RegistrationCreateParams::CountryOption::Si`, and `Tax::RegistrationCreateParams::CountryOption::Sk`
 
-## 19.5.0 - 2026-08-10
-* [#1932](https://github.com/stripe/stripe-ruby/pull/1932) Handle break in auto-paging blocks
-  - Rescues `LocalJumpError` to prevent crash when calling `break` inside an `auto_paging_each`
-* [#1927](https://github.com/stripe/stripe-ruby/pull/1927) Surface `object` property on `EventNotification`
+## <a id="19-5-0"></a>19.5.0 - 2026-08-10
+* [#1924](https://github.com/stripe/stripe-ruby/pull/1924) Discard the connection when a request is interrupted
+  - Fix connection reuse after a request is interrupted by a non-StandardError exception (e.g. from rack-timeout), which could cause subsequent requests to receive a previous request's response
 * [#1918](https://github.com/stripe/stripe-ruby/pull/1918) add/adjust event parsing helpers
-  
   - Added methods that return their respective `Event`/`EventNotification` class instances without verifying authenticity. Use them when you've previously verified an event (e.g. you verified, put the event in a queue, and are now processing). Supports events from [AWS EventBridge](https://docs.stripe.com/event-destinations/eventbridge) and [Azure Event Grid](https://docs.stripe.com/event-destinations/eventgrid) natively.
     - `Webhook#construct_event_without_verification(payload)`
     - `StripeClient#parse_event_notification_without_verification(payload)`
-* [#1924](https://github.com/stripe/stripe-ruby/pull/1924) Discard the connection when a request is interrupted
-  - Fix connection reuse after a request is interrupted by a non-StandardError exception (e.g. from rack-timeout), which could cause subsequent requests to receive a previous request's response
+* [#1927](https://github.com/stripe/stripe-ruby/pull/1927) Surface `object` property on `EventNotification`
+* [#1932](https://github.com/stripe/stripe-ruby/pull/1932) Handle break in auto-paging blocks
+  - Rescues `LocalJumpError` to prevent crash when calling `break` inside an `auto_paging_each`
 
-## 19.4.0 - 2026-07-29
-This release changes the pinned API version to 2026-07-29.dahlia.
+## <a id="19-4-0"></a>19.4.0 - 2026-07-29
+This release changes the pinned API version to `2026-07-29.dahlia`.
 
+* [#1906](https://github.com/stripe/stripe-ruby/pull/1906) Adds `error_object.rbi` file, allowing users to get full typing for API Error Objects
 * [#1913](https://github.com/stripe/stripe-ruby/pull/1913) Update generated code
   * Add support for new resource `FinancialConnections::Authorization`
   * Add support for `unreject` method on resource `Account`
@@ -91,16 +93,15 @@ This release changes the pinned API version to 2026-07-29.dahlia.
   * Add support for `mass_transit_parking_tax` and `parking_tax` on `Tax::Registration::CountryOption::Me` and `Tax::RegistrationCreateParams::CountryOption::Me`
   * Add support for `initiated_by` and `payment_method_options` on `Topup`
   * Add support for `additional_addresses` on `V2::Core::Account::Identity::BusinessDetail`, `V2::Core::AccountCreateParams::Identity::BusinessDetail`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail`
-* [#1906](https://github.com/stripe/stripe-ruby/pull/1906) Adds `error_object.rbi` file, allowing users to get full typing for API Error Objects
 
-## 19.3.1 - 2026-07-15
-* [#1902](https://github.com/stripe/stripe-ruby/pull/1902) Replace source hash with Telemetry UUID
+## <a id="19-3-1"></a>19.3.1 - 2026-07-15
 * [#1901](https://github.com/stripe/stripe-ruby/pull/1901) Make Error fields generated
+* [#1902](https://github.com/stripe/stripe-ruby/pull/1902) Replace source hash with Telemetry UUID
 
-## 19.3.0 - 2026-06-24
-This release changes the pinned API version to 2026-06-24.dahlia.
+## <a id="19-3-0"></a>19.3.0 - 2026-06-24
+This release changes the pinned API version to `2026-06-24.dahlia`.
 
-* [#1896](https://github.com/stripe/stripe-ruby/pull/1896) Update generated code
+* ⚠️ [#1896](https://github.com/stripe/stripe-ruby/pull/1896) Update generated code
   * Add support for `release_details` on `Reserve::Hold`
   * Change `Billing::CreditGrant.priority` to be required
   * Add support for `buyer_id` on `Charge::PaymentMethodDetail::Bizum`, `ConfirmationToken::PaymentMethodPreview::Bizum`, `ConfirmationToken::PaymentMethodPreview::Blik`, `PaymentAttemptRecord::PaymentMethodDetail::Bizum`, `PaymentMethod::Bizum`, `PaymentMethod::Blik`, and `PaymentRecord::PaymentMethodDetail::Bizum`
@@ -125,13 +126,15 @@ This release changes the pinned API version to 2026-06-24.dahlia.
   * Add support for `crypto_money_manager` and `money_manager` on `V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService`
   * ⚠️ Remove support for `crypto_storer` and `storer` on `V2::Core::AccountUpdateParams::Identity::Attestation::TermsOfService`
 
-## 19.2.1 - 2026-06-12
+## <a id="19-2-1"></a>19.2.1 - 2026-06-12
 * [#1874](https://github.com/stripe/stripe-ruby/pull/1874) Add "source" field to user-agent header
 
-## 19.2.0 - 2026-05-27
-This release changes the pinned API version to 2026-05-27.dahlia.
+## <a id="19-2-0"></a>19.2.0 - 2026-05-27
+This release changes the pinned API version to `2026-05-27.dahlia`.
 
-* [#1864](https://github.com/stripe/stripe-ruby/pull/1864) Update generated code
+* [#1855](https://github.com/stripe/stripe-ruby/pull/1855) Use autoload instead of eager require for generated resource, service, and param files
+* [#1866](https://github.com/stripe/stripe-ruby/pull/1866) Emit warning when `stripe-notify` header is present in response
+* ⚠️ [#1864](https://github.com/stripe/stripe-ruby/pull/1864) Update generated code
   * Add support for new resource `V2::Commerce::ProductCatalogImport`
   * Add support for `create` and `retrieve` methods on resource `V2::Commerce::ProductCatalogImport`
   * Add support for `bizum_payments` and `scalapay_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
@@ -161,13 +164,14 @@ This release changes the pinned API version to 2026-05-27.dahlia.
   * Add support for `signer` on `V2::Core::Account::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::Account::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountCreateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::AccountCreateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`, `V2::Core::AccountUpdateParams::Identity::BusinessDetail::Document::ProofOfRegistration`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail::Document::ProofOfUltimateBeneficialOwnership`
   * Add support for `azure_event_grid` on `V2::Core::EventDestinationCreateParams` and `V2::Core::EventDestination`
   * Add support for event notifications `V2CommerceProductCatalogImportsFailedEvent`, `V2CommerceProductCatalogImportsProcessingEvent`, `V2CommerceProductCatalogImportsSucceededEvent`, and `V2CommerceProductCatalogImportsSucceededWithErrorsEvent` with related object `V2::Commerce::ProductCatalogImport`
-* [#1866](https://github.com/stripe/stripe-ruby/pull/1866) Emit warning when `stripe-notify` header is present in response
-* [#1855](https://github.com/stripe/stripe-ruby/pull/1855) Use autoload instead of eager require for generated resource, service, and param files
 
-## 19.1.0 - 2026-04-23
-This release changes the pinned API version to 2026-04-22.dahlia.
+## <a id="19-1-0"></a>19.1.0 - 2026-04-23
+This release changes the pinned API version to `2026-04-22.dahlia`.
 
-* [#1842](https://github.com/stripe/stripe-ruby/pull/1842) Update generated code
+* [#1841](https://github.com/stripe/stripe-ruby/pull/1841) Replace other require cgi with require cgi/escape
+* [#1846](https://github.com/stripe/stripe-ruby/pull/1846) Fix 2D array parameter encoding
+  - Fixes an issue encoding two-dimensional array request params where the SDK incorrectly flattens the array.
+* ⚠️ [#1842](https://github.com/stripe/stripe-ruby/pull/1842) Update generated code
   * Add support for `balance_report` and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSessionCreateParams::Component`
   * Add support for `app_distribution` and `sunbit_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
   * Add support for `sunbit` on `Charge::PaymentMethodDetail`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodDatum`
@@ -186,17 +190,23 @@ This release changes the pinned API version to 2026-04-22.dahlia.
   * Add support for `klarna_display_qr_code` on `PaymentIntent::NextAction`
   * Add support for `moto` on `SetupAttempt::PaymentMethodDetail::Card`
   * Add support for `pix_display_qr_code` on `SetupIntent::NextAction`
-* [#1846](https://github.com/stripe/stripe-ruby/pull/1846) Fix 2D array parameter encoding
-  - Fixes an issue encoding two-dimensional array request params where the SDK incorrectly flattens the array.
-* [#1841](https://github.com/stripe/stripe-ruby/pull/1841) Replace other require cgi with require cgi/escape
 
-## 19.0.0 - 2026-03-25
+## <a id="19-0-0"></a>19.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-ruby/wiki/Migration-guide-for-v19) 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-ruby/wiki/Migration-guide-for-v19) 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:** [#1829](https://github.com/stripe/stripe-ruby/pull/1829) Add decimal_string coercion for v1 and v2 API fields
+* ⚠️ [#1817](https://github.com/stripe/stripe-ruby/pull/1817) Remove AlipayAccount and RecipientTransfer resource files
+  - ⚠️ Removes `Stripe::AlipayAccount` and `Stripe::RecipientTransfer` resource classes (dead code since v7.0.0)
+* [#1816](https://github.com/stripe/stripe-ruby/pull/1816) remove v2-specific guards for removing nils from request params
+* [#1814](https://github.com/stripe/stripe-ruby/pull/1814) Add runtime support for V2 int64 string-encoded fields
+* ⚠️ [#1823](https://github.com/stripe/stripe-ruby/pull/1823) Drop support for Ruby 2.6
+* [#1825](https://github.com/stripe/stripe-ruby/pull/1825) Require cgi/escape instead of cgi
+* [#1824](https://github.com/stripe/stripe-ruby/pull/1824) Add gem dependency on logger
+* ⚠️ [#1828](https://github.com/stripe/stripe-ruby/pull/1828) Throw an error when using the wrong webhook parsing method
+* ⚠️ [#1829](https://github.com/stripe/stripe-ruby/pull/1829) Add decimal_string coercion for v1 and v2 API fields
   - All `decimal_string` fields changed type from `String` to `BigDecimal` in both request params and response objects. Code that reads or writes these fields as `String` will need to use `BigDecimal` instead. Affected fields across v1 and v2 APIs:
     - **Checkout::Session**: `fx_rate`
     - **Climate::Order**: `metric_tons`; **Climate::Product**: `metric_tons_available`
@@ -208,18 +218,9 @@ Please review details for the breaking changes and alternatives in the [Stripe A
     - **Price**: `unit_amount_decimal`, `flat_amount_decimal` (including `currency_options` and `tiers`)
     - **V2::Core::Account** / **V2::Core::AccountPerson**: `percent_ownership`
     - Request params on **Invoice**, **Product**, **Quote**, **Subscription**, **SubscriptionItem**, **SubscriptionSchedule**, **PaymentLink**: `unit_amount_decimal`, `flat_amount_decimal`, `quantity_decimal` (where applicable)
-* ⚠️ **Breaking change:** [#1828](https://github.com/stripe/stripe-ruby/pull/1828) ⚠️ Throw an error when using the wrong webhook parsing method
-* ⚠️ **Breaking change:** [#1823](https://github.com/stripe/stripe-ruby/pull/1823) ⚠️ Drop support for Ruby 2.6
-* [#1825](https://github.com/stripe/stripe-ruby/pull/1825) Require cgi/escape instead of cgi
-* [#1814](https://github.com/stripe/stripe-ruby/pull/1814) Add runtime support for V2 int64 string-encoded fields
-* [#1817](https://github.com/stripe/stripe-ruby/pull/1817) Remove AlipayAccount and RecipientTransfer resource files
-  - ⚠️ Removes `Stripe::AlipayAccount` and `Stripe::RecipientTransfer` resource classes (dead code since v7.0.0)
-* [#1816](https://github.com/stripe/stripe-ruby/pull/1816) remove v2-specific guards for removing nils from request params
-* [#1824](https://github.com/stripe/stripe-ruby/pull/1824) Add gem dependency on logger
 
 ### ⚠️ Breaking changes due to changes in the Stripe API
-
-* Generated changes from [#1804](https://github.com/stripe/stripe-ruby/pull/1804), [#1834](https://github.com/stripe/stripe-ruby/pull/1834), [#1831](https://github.com/stripe/stripe-ruby/pull/1831), [#1830](https://github.com/stripe/stripe-ruby/pull/1830)
+* ⚠️ Generated changes from [#1804](https://github.com/stripe/stripe-ruby/pull/1804), [#1834](https://github.com/stripe/stripe-ruby/pull/1834), [#1831](https://github.com/stripe/stripe-ruby/pull/1831), [#1830](https://github.com/stripe/stripe-ruby/pull/1830)
   * Add support for `upi_payments` on `Account::Capability`, `AccountCreateParams::Capability`, and `AccountUpdateParams::Capability`
   * Add support for `upi` on `Charge::PaymentMethodDetail`, `Checkout::Session::PaymentMethodOption`, `Checkout::SessionCreateParams::PaymentMethodOption`, `ConfirmationToken::PaymentMethodPreview`, `ConfirmationTokenCreateParams::PaymentMethodDatum`, `Mandate::PaymentMethodDetail`, `PaymentAttemptRecord::PaymentMethodDetail`, `PaymentIntent::PaymentMethodOption`, `PaymentIntentConfirmParams::PaymentMethodDatum`, `PaymentIntentConfirmParams::PaymentMethodOption`, `PaymentIntentCreateParams::PaymentMethodDatum`, `PaymentIntentCreateParams::PaymentMethodOption`, `PaymentIntentUpdateParams::PaymentMethodDatum`, `PaymentIntentUpdateParams::PaymentMethodOption`, `PaymentMethodConfigurationCreateParams`, `PaymentMethodConfigurationUpdateParams`, `PaymentMethodConfiguration`, `PaymentMethodCreateParams`, `PaymentMethod`, `PaymentRecord::PaymentMethodDetail`, `SetupAttempt::PaymentMethodDetail`, `SetupIntent::PaymentMethodOption`, `SetupIntentConfirmParams::PaymentMethodDatum`, `SetupIntentConfirmParams::PaymentMethodOption`, `SetupIntentCreateParams::PaymentMethodDatum`, `SetupIntentCreateParams::PaymentMethodOption`, `SetupIntentUpdateParams::PaymentMethodDatum`, and `SetupIntentUpdateParams::PaymentMethodOption`
   * Add support for `integration_identifier` on `Checkout::SessionCreateParams` and `Checkout::Session`
@@ -242,18 +243,20 @@ Please review details for the breaking changes and alternatives in the [Stripe A
   * Add support for `recommended_action` and `signals` on `Radar::PaymentEvaluation`
   * ⚠️ Remove support for `insights` on `Radar::PaymentEvaluation`
 
-## 18.4.2 - 2026-03-10
+## <a id="18-4-2"></a>18.4.2 - 2026-03-10
 * [#1811](https://github.com/stripe/stripe-ruby/pull/1811) Retry on Net::HTTPFatalError
   - Fixes a bug where `Net::HTTPFatalError` errors were being thrown and not retried (unlike other 5xx responses from the Stripe API)
-  
 
-## 18.4.1 - 2026-03-06
-* [#1805](https://github.com/stripe/stripe-ruby/pull/1805) Add Stripe-Request-Trigger header
+## <a id="18-4-1"></a>18.4.1 - 2026-03-06
 * [#1803](https://github.com/stripe/stripe-ruby/pull/1803) Add agent information to UserAgent
+* [#1805](https://github.com/stripe/stripe-ruby/pull/1805) Add Stripe-Request-Trigger header
 
-## 18.4.0 - 2026-02-25
+## <a id="18-4-0"></a>18.4.0 - 2026-02-25
 This release changes the pinned API version to `2026-02-25.clover`.
 
+* [#1786](https://github.com/stripe/stripe-ruby/pull/1786) Properly serialize null values in V2
+  - Fixes a bug where V2 POST requests were not serializing `null` values.
+* [#1796](https://github.com/stripe/stripe-ruby/pull/1796) Ignore unset properties of V2 Request param classes when making requests
 * [#1797](https://github.com/stripe/stripe-ruby/pull/1797) Update generated code
   * Add support for new resources `Reserve::Hold`, `Reserve::Plan`, and `Reserve::Release`
   * Add support for `location` and `reader` on `Charge::PaymentMethodDetail::CardPresent`, `Charge::PaymentMethodDetail::InteracPresent`, `ConfirmationToken::PaymentMethodPreview::Card::GeneratedFrom::PaymentMethodDetail::CardPresent`, `PaymentAttemptRecord::PaymentMethodDetail::CardPresent`, `PaymentAttemptRecord::PaymentMethodDetail::InteracPresent`, `PaymentMethod::Card::GeneratedFrom::PaymentMethodDetail::CardPresent`, `PaymentRecord::PaymentMethodDetail::CardPresent`, and `PaymentRecord::PaymentMethodDetail::InteracPresent`
@@ -266,18 +269,15 @@ This release changes the pinned API version to `2026-02-25.clover`.
   * Add support for `payment_behavior` on `SubscriptionItemDeleteParams`
   * Add support for `lk` on `Tax::Registration::CountryOption` and `Tax::RegistrationCreateParams::CountryOption`
   * Add support for `cellular` and `stripe_s710` on `Terminal::ConfigurationCreateParams`, `Terminal::ConfigurationUpdateParams`, and `Terminal::Configuration`
-* [#1796](https://github.com/stripe/stripe-ruby/pull/1796) Ignore unset properties of V2 Request param classes when making requests
-* [#1786](https://github.com/stripe/stripe-ruby/pull/1786) Properly serialize null values in V2
-  - Fixes a bug where V2 POST requests were not serializing `null` values.
-
 
-## 18.3.1 - 2026-02-03
-* [#1777](https://github.com/stripe/stripe-ruby/pull/1777)
+## <a id="18-3-1"></a>18.3.1 - 2026-02-03
+* [#1777](https://github.com/stripe/stripe-ruby/pull/1777) Update generated code
   * References to Stripe objects from *Param class fields are now fully qualified in `stripe.rbi`.  This ensures that the class fields in .rbi files generated with tapioca are able to refer to the correct type.
 
-## 18.3.0 - 2026-01-28
+## <a id="18-3-0"></a>18.3.0 - 2026-01-28
 This release changes the pinned API version to `2026-01-28.clover`.
 
+* [#1769](https://github.com/stripe/stripe-ruby/pull/1769) Document usage of undocumented API parameters
 * [#1771](https://github.com/stripe/stripe-ruby/pull/1771) Update generated code
   * Add support for new resource `Radar::PaymentEvaluation`
   * Add support for `create` method on resource `Radar::PaymentEvaluation`
@@ -289,17 +289,18 @@ This release changes the pinned API version to `2026-01-28.clover`.
   * Add support for `topup` on `Treasury::ReceivedDebit::LinkedFlow`
   * Add support for `contact_phone` on `V2::Core::AccountCreateParams`, `V2::Core::AccountTokenCreateParams`, `V2::Core::AccountUpdateParams`, and `V2::Core::Account`
   * Add support for `registration_date` on `V2::Core::Account::Identity::BusinessDetail`, `V2::Core::AccountCreateParams::Identity::BusinessDetail`, `V2::Core::AccountTokenCreateParams::Identity::BusinessDetail`, and `V2::Core::AccountUpdateParams::Identity::BusinessDetail`
-* [#1769](https://github.com/stripe/stripe-ruby/pull/1769) Document usage of undocumented API parameters
 
-## 18.2.0 - 2026-01-16
+## <a id="18-2-0"></a>18.2.0 - 2026-01-16
 * [#1767](https://github.com/stripe/stripe-ruby/pull/1767) 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`
 
-## 18.1.0 - 2025-12-16
+## <a id="18-1-0"></a>18.1.0 - 2025-12-16
 This release changes the pinned API version to `2025-12-15.clover`.
 
+* [#1742](https://github.com/stripe/stripe-ruby/pull/1742) Updated bundled CA certs
+* [#1741](https://github.com/stripe/stripe-ruby/pull/1741) Format breaking change warning to improve discoverability
 * [#1744](https://github.com/stripe/stripe-ruby/pull/1744) 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`
@@ -325,17 +326,13 @@ This release changes the pinned API version to `2025-12-15.clover`.
   * Add support for `reported_by` on `PaymentRecord`
   * Change `Product.tax_code` to be optional
   * Add support for `changes` on `V2::Core::Event`
-* [#1741](https://github.com/stripe/stripe-ruby/pull/1741) Format breaking change warning to improve discoverability
-* [#1742](https://github.com/stripe/stripe-ruby/pull/1742) Updated bundled CA certs
 
-## 18.0.1 - 2025-11-21
-* [#1736](https://github.com/stripe/stripe-ruby/pull/1736) Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging. 
+## <a id="18-0-1"></a>18.0.1 - 2025-11-21
+* [#1736](https://github.com/stripe/stripe-ruby/pull/1736) Throw a specific error when accessing `payment_intent` property on `Invoice` object to ease debugging.
 
-## 18.0.0 - 2025-11-18
+## <a id="18-0-0"></a>18.0.0 - 2025-11-18
 This release changes the pinned API version to `2025-11-17.clover`.
 
-* [#1729](https://github.com/stripe/stripe-ruby/pull/1729) Update generated code
-  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `V2::Core::EventListParams` in favor of `created`.
 * [#1727](https://github.com/stripe/stripe-ruby/pull/1727) 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.
 * [#1725](https://github.com/stripe/stripe-ruby/pull/1725) Update generated code
@@ -351,17 +348,16 @@ This release changes the pinned API version to `2025-11-17.clover`.
   * Add support for `latest_fraud_warning` on `Issuing::Card`
   * Add support for `hooks` on `PaymentIntentCaptureParams`, `PaymentIntentConfirmParams`, `PaymentIntentCreateParams`, `PaymentIntentIncrementAuthorizationParams`, `PaymentIntentUpdateParams`, and `PaymentIntent`
   * Add support for `mb_way` and `twint` on `Refund::DestinationDetail`
+* ⚠️ [#1729](https://github.com/stripe/stripe-ruby/pull/1729) Update generated code
+  * ⚠️ Remove support for `gt`, `gte`, `lt`, and `lte` on `V2::Core::EventListParams` in favor of `created`.
 
-## 17.2.0 - 2025-11-05
+## <a id="17-2-0"></a>17.2.0 - 2025-11-05
 * [#1721](https://github.com/stripe/stripe-ruby/pull/1721) Update generated code
   * Add support for `capture_method` on `PaymentIntent::PaymentMethodOption::CardPresent`, `PaymentIntentConfirmParams::PaymentMethodOption::CardPresent`, `PaymentIntentCreateParams::PaymentMethodOption::CardPresent`, and `PaymentIntentUpdateParams::PaymentMethodOption::CardPresent`
 
-## 17.1.0 - 2025-10-29
-
+## <a id="17-1-0"></a>17.1.0 - 2025-10-29
 This release changes the pinned API version to `2025-10-29.clover`.
 
-* [#1715](https://github.com/stripe/stripe-ruby/pull/1715) Update generated code
-  * Improve docs for PaymentIntent related endpoints
 * [#1700](https://github.com/stripe/stripe-ruby/pull/1700) Update generated code
   * Add support for new resources `PaymentAttemptRecord`, `PaymentIntentAmountDetailsLineItem`, and `PaymentRecord`
   * Add support for `list` and `retrieve` methods on resource `PaymentAttemptRecord`
@@ -390,54 +386,49 @@ This release changes the pinned API version to `2025-10-29.clover`.
   * Add support for `last_seen_at` on `Terminal::Reader`
   * Add support for `gt`, `gte`, `lt`, `lte`, and `types` on `V2::Core::EventListParams`
   * Change `V2::Core::EventListParams.object_id` to be optional
+* [#1715](https://github.com/stripe/stripe-ruby/pull/1715) Update generated code
+  * Improve docs for PaymentIntent related endpoints
 
-## 17.0.1 - 2025-10-16
+## <a id="17-0-1"></a>17.0.1 - 2025-10-16
 * [#1705](https://github.com/stripe/stripe-ruby/pull/1705) Require `V2::Amount` and `V2::DeletedObject` in gem
 
-## 17.0.0 - 2025-10-09
-* [#1698](https://github.com/stripe/stripe-ruby/pull/1698) Remove expanded instance variables after a resource has been updated
+## <a id="17-0-0"></a>17.0.0 - 2025-10-09
+* [#1691](https://github.com/stripe/stripe-ruby/pull/1691) Remove manual promotion code test
+* [#1687](https://github.com/stripe/stripe-ruby/pull/1687) Update CHANGELOG.md to point to right API version
+* [#1690](https://github.com/stripe/stripe-ruby/pull/1690) Update param in deprecation docs link
+* [#1693](https://github.com/stripe/stripe-ruby/pull/1693) Improve event notification example
+* [#1699](https://github.com/stripe/stripe-ruby/pull/1699) Improve event notification example
+* ⚠️ [#1698](https://github.com/stripe/stripe-ruby/pull/1698) Remove expanded instance variables after a resource has been updated
   - ⚠️ Removes dynamically added instance variables on subsequent non-expanded updates to a resource that had previously been expanded. For example,
   ```ruby
   # expand `payments` field on an invoice
   invoice = Stripe::Invoice.retrieve(id: 'in_123', expand: ['payments'])
-  
+
   # `pay` invoice without expanding `payments`, so that field would have stale data
   # Use `expand` to keep `payments` like this: `invoice.pay(expand: ['payments'])`
   invoice.pay
-  
+
   # This is now nil instead of a stale Hash
   invoice.payments
   ```
-* [#1699](https://github.com/stripe/stripe-ruby/pull/1699) Improve event notification example
-* [#1693](https://github.com/stripe/stripe-ruby/pull/1693) Improve event notification example
-* [#1691](https://github.com/stripe/stripe-ruby/pull/1691) Remove manual promotion code test
-* [#1690](https://github.com/stripe/stripe-ruby/pull/1690) Update param in deprecation docs link
-* [#1687](https://github.com/stripe/stripe-ruby/pull/1687) Update CHANGELOG.md to point to right API version
 
-## 16.0.0 - 2025-09-30
-This release changes the pinned API version to `2025-09-30.clover` and contains breaking changes (prefixed with ⚠️ below)
+## <a id="16-0-0"></a>16.0.0 - 2025-09-30
+This release changes the pinned API version to `2025-09-30.clover`.
+
+This release contains breaking changes (prefixed with ⚠️ below)
 
-* [#1652](https://github.com/stripe/stripe-ruby/pull/1652) ⚠️  Deserialize inner types in resources for more detailed types
-  * ⚠️ Deserialize inner classes, so inner class types will now reflect generated inner classes
-    * For example, `Stripe::Customer.address` is deserialized to specific a `Stripe::Customer::Address` class instead of the generic `Stripe::StripeObject`, as is suggested by the static type annotations
-    * This should not affect any normal use cases of the SDK, as inner types remain children of `Stripe::StripeObject`
 * [#1649](https://github.com/stripe/stripe-ruby/pull/1649) Explicitly define methods for RBIs and ship combined RBI for Tapioca
   * Improvements for Tapioca
        * Explicitly define methods for attributes in RBIs to allow Tapioca to reflect them
        * Ship combined RBI for shorter Tapioca time
-* [#1677](https://github.com/stripe/stripe-ruby/pull/1677) Move `V2.Event` API resources to `V2.Core.Events`
-  - ⚠️ Move `Stripe::V2::Event` and `Stripe::V2::EventDestination` to `Stripe::V2::Core::Event` and `Stripe::V2::Core::EventDestination` respectively. They now correctly match their API path 
-* [#1664](https://github.com/stripe/stripe-ruby/pull/1664) Add `StripeContext` object
-  - Add the `StripeContext` class. Previously you could set the stripe_context to only a string value. Now you can use the new class as well
-  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
-* [#1684](https://github.com/stripe/stripe-ruby/pull/1684) ⚠️ Drop support for Ruby < 2.6 & clarify version policy
-  - Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=ruby#stripe-sdk-language-version-support-policy)
-      - ⚠️ In this release, we drop support for Ruby 2.3, 2.4, and 2.5
-      -  Ruby 2.6 support is deprecated and will be removed in the next scheduled major release (March 2026)
-* [#1651](https://github.com/stripe/stripe-ruby/pull/1651) ⚠️ Build SDK w/ V2 OpenAPI spec
+* ⚠️ [#1651](https://github.com/stripe/stripe-ruby/pull/1651) Build SDK w/ V2 OpenAPI spec
   - ⚠️ The delete methods for v2 APIs (the ones in the `StripeClient.v2` namespace) now return a `V2DeletedObject` which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
   - ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as `T::Hash[String, T.untyped]`. Because there were no params, it's unlikely you were using these classes.
-* [#1650](https://github.com/stripe/stripe-ruby/pull/1650) ⚠️ Add strongly typed EventNotifications
+* ⚠️ [#1652](https://github.com/stripe/stripe-ruby/pull/1652) Deserialize inner types in resources for more detailed types
+  * ⚠️ Deserialize inner classes, so inner class types will now reflect generated inner classes
+    * For example, `Stripe::Customer.address` is deserialized to specific a `Stripe::Customer::Address` class instead of the generic `Stripe::StripeObject`, as is suggested by the static type annotations
+    * This should not affect any normal use cases of the SDK, as inner types remain children of `Stripe::StripeObject`
+* ⚠️ [#1650](https://github.com/stripe/stripe-ruby/pull/1650) 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`
@@ -448,12 +439,20 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
       - 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 `related_object` property and the `fetch_related_object()` function (but they may be/return `nil`)
   - ⚠️ Move all Event Classes into the `Events` module
     - For example, `Stripe::V1BillingMeterErrorReportTriggeredEvent` is now `Stripe::Events::V1BillingMeterErrorReportTriggeredEvent`
-* [#1670](https://github.com/stripe/stripe-ruby/pull/1670) ⚠️ Unify resource and service method parameters into one class
+* ⚠️ [#1664](https://github.com/stripe/stripe-ruby/pull/1664) Add `StripeContext` object
+  - Add the `StripeContext` class. Previously you could set the stripe_context to only a string value. Now you can use the new class as well
+  - ⚠️ Change `EventNotification` (formerly known as `ThinEvent`)'s `context` property from `string` to `StripeContext`
+* ⚠️ [#1677](https://github.com/stripe/stripe-ruby/pull/1677) Move `V2.Event` API resources to `V2.Core.Events`
+  - ⚠️ Move `Stripe::V2::Event` and `Stripe::V2::EventDestination` to `Stripe::V2::Core::Event` and `Stripe::V2::Core::EventDestination` respectively. They now correctly match their API path
+* ⚠️ [#1684](https://github.com/stripe/stripe-ruby/pull/1684) Drop support for Ruby < 2.6 & clarify version policy
+  - Read our new [language version support policy](https://docs.stripe.com/sdks/versioning?lang=ruby#stripe-sdk-language-version-support-policy)
+      - ⚠️ In this release, we drop support for Ruby 2.3, 2.4, and 2.5
+      -  Ruby 2.6 support is deprecated and will be removed in the next scheduled major release (March 2026)
+* ⚠️ [#1670](https://github.com/stripe/stripe-ruby/pull/1670) Unify resource and service method parameters into one class
   * ⚠️ Resource and service request parameter types have been moved to the top-level and are shared.
     * For example, `Stripe::Account::CreateParams` and `Stripe::AccountService::CreateParams` have moved to `Stripe::AccountCreateParams`
     * This change only affects users who use Sorbet types for parameters
-    
-* [#1643](https://github.com/stripe/stripe-ruby/pull/1643), [#1667](https://github.com/stripe/stripe-ruby/pull/1667), [#1680](https://github.com/stripe/stripe-ruby/pull/1680), [#1678](https://github.com/stripe/stripe-ruby/pull/1678) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
+* ⚠️ [#1643](https://github.com/stripe/stripe-ruby/pull/1643) , [#1667](https://github.com/stripe/stripe-ruby/pull/1667), [#1680](https://github.com/stripe/stripe-ruby/pull/1680), [#1678](https://github.com/stripe/stripe-ruby/pull/1678) Update generated code based on incoming API changes in the `2025-09-30.clover` API version.
   * ⚠️ Remove support for `balance_report` and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
   * Change `Invoice.id` to be required (i.e. not nilable).
   * Add support for new resource `BalanceSettings`
@@ -485,10 +484,13 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Change `Terminal::Location::CreateParams.address` to be optional
   * Change `Terminal::Location::CreateParams.display_name` to be optional
 
+## <a id="15-5-0"></a>15.5.0 - 2025-08-27
+This release changes the pinned API version to `2025-08-27.basil`.
 
-## 15.5.0 - 2025-08-27
+* [#1633](https://github.com/stripe/stripe-ruby/pull/1633) Remove double `T.nilable` before every emptyable field in update methods
+* [#1637](https://github.com/stripe/stripe-ruby/pull/1637) Add `stripe_client` usage tracking for StripeClient
 * [#1638](https://github.com/stripe/stripe-ruby/pull/1638) Add section on private preview SDKs in readme
-* [#1631](https://github.com/stripe/stripe-ruby/pull/1631) Update generated code. This release changes the pinned API version to `2025-08-27.basil`.
+* [#1631](https://github.com/stripe/stripe-ruby/pull/1631) Update generated code.
   * Add support for `balance_report`, `payout_details`, and `payout_reconciliation_report` on `AccountSession::Component` and `AccountSession::CreateParams::Component`
   * Add support for `name` on `BillingPortal::Configuration::CreateParams`, `BillingPortal::Configuration::UpdateParams`, and `BillingPortal::Configuration`
   * Add support for `installments` on `Charge::PaymentMethodDetail::Alma`
@@ -501,10 +503,8 @@ This release changes the pinned API version to `2025-09-30.clover` and contains
   * Add support for `payout_method` on `Payout::CreateParams` and `Payout`
   * Add support for `mxn` on `Terminal::Configuration::CreateParams::Tipping`, `Terminal::Configuration::Tipping`, and `Terminal::Configuration::UpdateParams::Tipping`
   * Add support for `card` on `Terminal::Reader::PresentPaymentMethodParams`
-* [#1637](https://github.com/stripe/stripe-ruby/pull/1637) Add `stripe_client` usage tracking for StripeClient
-* [#1633](https://github.com/stripe/stripe-ruby/pull/1633) Remove double `T.nilable` before every emptyable field in update methods
 
-## 15.4.0 - 2025-07-30
+## <a id="15-4-0"></a>15.4.0 - 2025-07-30
 This release changes the pinned API version to `2025-07-30.basil`.
 
 * [#1627](https://github.com/stripe/stripe-ruby/pull/1627) Update generated code
@@ -523,9 +523,12 @@ This release changes the pinned API version to `2025-07-30.basil`.
   * Add support for `standard` on `Tax::Registration::CountryOption::Ae`, `Tax::Registration::CountryOption::Au`, `Tax::Registration::CountryOption::Ch`, `Tax::Registration::CountryOption::Gb`, `Tax::Registration::CountryOption::Jp`, `Tax::Registration::CountryOption::No`, `Tax::Registration::CountryOption::Nz`, `Tax::Registration::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Ae`, `Tax::Registration::CreateParams::CountryOption::Al`, `Tax::Registration::CreateParams::CountryOption::Ao`, `Tax::Registration::CreateParams::CountryOption::Au`, `Tax::Registration::CreateParams::CountryOption::Aw`, `Tax::Registration::CreateParams::CountryOption::B`, `Tax::Registration::CreateParams::CountryOption::Ba`, `Tax::Registration::CreateParams::CountryOption::Bb`, `Tax::Registration::CreateParams::CountryOption::Bd`, `Tax::Registration::CreateParams::CountryOption::Bf`, `Tax::Registration::CreateParams::CountryOption::Bh`, `Tax::Registration::CreateParams::CountryOption::Cd`, `Tax::Registration::CreateParams::CountryOption::Ch`, `Tax::Registration::CreateParams::CountryOption::Et`, `Tax::Registration::CreateParams::CountryOption::Gb`, `Tax::Registration::CreateParams::CountryOption::Gn`, `Tax::Registration::CreateParams::CountryOption::Is`, `Tax::Registration::CreateParams::CountryOption::Jp`, `Tax::Registration::CreateParams::CountryOption::Me`, `Tax::Registration::CreateParams::CountryOption::Mk`, `Tax::Registration::CreateParams::CountryOption::Mr`, `Tax::Registration::CreateParams::CountryOption::No`, `Tax::Registration::CreateParams::CountryOption::Nz`, `Tax::Registration::CreateParams::CountryOption::Om`, `Tax::Registration::CreateParams::CountryOption::R`, `Tax::Registration::CreateParams::CountryOption::Sg`, `Tax::Registration::CreateParams::CountryOption::Sr`, `Tax::Registration::CreateParams::CountryOption::Uy`, `Tax::Registration::CreateParams::CountryOption::Za`, and `Tax::Registration::CreateParams::CountryOption::Zw`
   * Add support for `aed`, `bgn`, `huf`, and `ron` on `Terminal::Configuration::CreateParams::Tipping`, `Terminal::Configuration::Tipping`, and `Terminal::Configuration::UpdateParams::Tipping`
 
-## 15.3.0 - 2025-07-01
+## <a id="15-3-0"></a>15.3.0 - 2025-07-01
 This release changes the pinned API version to `2025-06-30.basil`.
 
+* [#1620](https://github.com/stripe/stripe-ruby/pull/1620) Fix `raw_request` example in README
+* [#1619](https://github.com/stripe/stripe-ruby/pull/1619) Updated StripeClient snippets in README
+* [#1615](https://github.com/stripe/stripe-ruby/pull/1615) Update README to mention that APIResource.request was removed
 * [#1618](https://github.com/stripe/stripe-ruby/pull/1618) 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`
@@ -547,18 +550,16 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Change type of `Terminal::Location::UpdateParams.display_name` from `string` to `emptyable(string)`
   * Add support for `collect_payment_method` and `confirm_payment_intent` on `Terminal::Reader::Action`
   * Add support for `status` on `Treasury::FinancialAccount::ListParams`
-* [#1615](https://github.com/stripe/stripe-ruby/pull/1615) Update README to mention that APIResource.request was removed
-* [#1619](https://github.com/stripe/stripe-ruby/pull/1619) Updated StripeClient snippets in README
-* [#1620](https://github.com/stripe/stripe-ruby/pull/1620) Fix `raw_request` example in README
 
-## 15.2.1 - 2025-06-04
+## <a id="15-2-1"></a>15.2.1 - 2025-06-04
 * [#1617](https://github.com/stripe/stripe-ruby/pull/1617) Fix `nil` requestor in `Webhook.construct_event` to allow for event data refresh
   * Fix bug where `Event` constructed from `Webhook.construct_event` could not be refreshed due to a `nil` APIRequestor
     * Raised in https://github.com/stripe/stripe-ruby/issues/1616
 
-## 15.2.0 - 2025-05-29
- This release changes the pinned API version to `2025-05-28.basil`.
+## <a id="15-2-0"></a>15.2.0 - 2025-05-29
+This release changes the pinned API version to `2025-05-28.basil`.
 
+* [#1601](https://github.com/stripe/stripe-ruby/pull/1601) Adds CONTRIBUTING.md
 * [#1605](https://github.com/stripe/stripe-ruby/pull/1605) Update generated code
   * Add support for `attach_payment` method on resource `Invoice`
   * Add support for `collect_inputs` method on resource `Terminal::Reader`
@@ -582,12 +583,13 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for `metadata` on `Tax::Calculation::CreateParams::LineItem` and `Tax::CalculationLineItem`
   * Add support for `return_url` on `Terminal::Reader::Action::ProcessPaymentIntent::ProcessConfig` and `Terminal::Reader::ProcessPaymentIntentParams::ProcessConfig`
   * Add support for `collect_inputs` on `Terminal::Reader::Action`
-* [#1601](https://github.com/stripe/stripe-ruby/pull/1601) Adds CONTRIBUTING.md
-
-## 15.1.0 - 2025-04-30
 
-  This release changes the pinned API version to `2025-04-30.basil`.
+## <a id="15-1-0"></a>15.1.0 - 2025-04-30
+This release changes the pinned API version to `2025-04-30.basil`.
 
+* [#1581](https://github.com/stripe/stripe-ruby/pull/1581) Added rubocop exclusion for generated tests
+* [#1583](https://github.com/stripe/stripe-ruby/pull/1583) Include new Ruby 3.4 in CI
+* [#1585](https://github.com/stripe/stripe-ruby/pull/1585) Updated rubocop from 1.57.2 to 1.75.2
 * [#1566](https://github.com/stripe/stripe-ruby/pull/1566) Update generated code
   * Add support for `minority_owned_business_designation` on `Account::BusinessProfile`, `Account::CreateParams::BusinessProfile`, and `Account::UpdateParams::BusinessProfile`
   * Add support for `registration_date` on `Account::Company`, `Account::CreateParams::Company`, `Account::UpdateParams::Company`, and `Token::CreateParams::Account::Company`
@@ -605,19 +607,14 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for `pending_reason` on `Refund`
   * Change type of `Tax::CalculationLineItem.reference` from `nullable(string)` to `string`
   * Add support for `aw`, `az`, `bd`, `bf`, `bj`, `cm`, `cv`, `et`, `in`, `kg`, `la`, and `ph` on `Tax::Registration::CountryOption` and `Tax::Registration::CreateParams::CountryOption`
-* [#1585](https://github.com/stripe/stripe-ruby/pull/1585) Updated rubocop from 1.57.2 to 1.75.2
-* [#1583](https://github.com/stripe/stripe-ruby/pull/1583) Include new Ruby 3.4 in CI
-* [#1581](https://github.com/stripe/stripe-ruby/pull/1581) Added rubocop exclusion for generated tests
-
-## 15.0.0 - 2025-04-09
-
-### Breaking change
-* [#1574](https://github.com/stripe/stripe-ruby/pull/1574) Rename `object_id` in V2::Core::EventService::ListParams to `object_id_`
-  * ⚠️ Change name of parameter from `object_id` to `object_id_` on `Stripe::V2::Core::EventService::ListParams` to avoid conflict with Ruby native attribute, as found in https://github.com/stripe/stripe-ruby/issues/1567
-  * This is a no-op unless you are using this specific parameter that was introduced in `v14.0.0`
 
+## <a id="13-5-1"></a>13.5.1 - 2025-04-21
 * [#1576](https://github.com/stripe/stripe-ruby/pull/1576) Explicitly pass through custom headers in retrieve
   * Fix custom options passing for resource-based retrieve
+
+## <a id="15-0-0"></a>15.0.0 - 2025-04-09
+
+### Breaking change
 * [#1571](https://github.com/stripe/stripe-ruby/pull/1571) Validate all instance variable keys returned from the API
   * Validate all keys returned from the API, including custom response fields, to make sure they can be set in an instance variable, as brought up in https://github.com/stripe/stripe-ruby/issues/1564
     * We do not set instance variables for invalid field names (as defined by the [Ruby spec](https://ruby-doc.org/docs/ruby-doc-bundle/Manual/man-1.4/syntax.html#ident)). We recommend for custom hash map response fields, use the `[]` accessor.
@@ -626,17 +623,22 @@ This release changes the pinned API version to `2025-06-30.basil`.
        c.metadata["invalid-variable-name!"]
        c.metadata["valid_key_name_works_too"]
       ```
-* [#1575](https://github.com/stripe/stripe-ruby/pull/1575) Remove unused youtube playlist link
 * [#1573](https://github.com/stripe/stripe-ruby/pull/1573) Remove link for stale youtube video playlist
+* [#1575](https://github.com/stripe/stripe-ruby/pull/1575) Remove unused youtube playlist link
+* [#1576](https://github.com/stripe/stripe-ruby/pull/1576) Explicitly pass through custom headers in retrieve
+  * Fix custom options passing for resource-based retrieve
+* ⚠️ [#1574](https://github.com/stripe/stripe-ruby/pull/1574) Rename `object_id` in V2::Core::EventService::ListParams to `object_id_`
+  * ⚠️ Change name of parameter from `object_id` to `object_id_` on `Stripe::V2::Core::EventService::ListParams` to avoid conflict with Ruby native attribute, as found in https://github.com/stripe/stripe-ruby/issues/1567
+  * This is a no-op unless you are using this specific parameter that was introduced in `v14.0.0`
+
+## <a id="14-0-0"></a>14.0.0 - 2025-04-01
+This release changes the pinned API version to `2025-03-31.basil`.
 
-## 14.0.0 - 2025-04-01
 * [#1559](https://github.com/stripe/stripe-ruby/pull/1559) Add RBI annotations for fields and params
   * Adds explicit field types for resources and parameters for methods, and add RBI static annotations for all resources and services
   ![image](https://github.com/user-attachments/assets/1b6cd994-d3ea-4f47-8487-f5c7b9ebf885)
   * See [the wiki](https://github.com/stripe/stripe-ruby/wiki/Static-Type-Annotations) for more details
-
-* [#1543](https://github.com/stripe/stripe-ruby/pull/1543) Support for APIs in the new API version 2025-03-31.basil
-
+* ⚠️ [#1543](https://github.com/stripe/stripe-ruby/pull/1543) 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
@@ -658,73 +660,79 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for new resource `InvoicePayment`
   * Add support for `list` and `retrieve` methods on resource `InvoicePayment`
 
+## <a id="13-5-0"></a>13.5.0 - 2025-02-24
+This release changes the pinned API version to `2025-02-24.acacia`.
 
-## 13.5.0 - 2025-02-24
-* [#1534](https://github.com/stripe/stripe-ruby/pull/1534) Update generated code
-  * Fixed `Stripe::InvoiceLineItem.update` method.
+* [#1533](https://github.com/stripe/stripe-ruby/pull/1533) add codeowners file
 * [#1536](https://github.com/stripe/stripe-ruby/pull/1536) Fix InvoiceLineItem parent class
   * Fix bug where `Stripe::InvoiceLineItem` had the incorrect parent class, making it error when `update` was called
-* [#1533](https://github.com/stripe/stripe-ruby/pull/1533) add codeowners file
+* [#1534](https://github.com/stripe/stripe-ruby/pull/1534) Update generated code
+  * Fixed `Stripe::InvoiceLineItem.update` method.
 
-## 13.4.1 - 2025-01-28
-* [#1528](https://github.com/stripe/stripe-ruby/pull/1528) Update generated code
+## <a id="13-4-1"></a>13.4.1 - 2025-01-28
+* ⚠️ [#1528](https://github.com/stripe/stripe-ruby/pull/1528) Update generated code
   * ⚠️ Bugfix: `invoice` and `line_item_id` can be passed to `update` method in `InvoiceLineItem`.
 
-## 13.4.0 - 2025-01-27
+## <a id="13-4-0"></a>13.4.0 - 2025-01-27
+This release changes the pinned API version to `2025-01-27.acacia`.
+
+* [#1515](https://github.com/stripe/stripe-ruby/pull/1515) Added CONTRIBUTING.md file
+* [#1513](https://github.com/stripe/stripe-ruby/pull/1513) add justfile
+* [#1519](https://github.com/stripe/stripe-ruby/pull/1519) Fixed typos in CONTRIBUTING.MD
+* [#1521](https://github.com/stripe/stripe-ruby/pull/1521) pipe rubocop output to devnull
 * [#1510](https://github.com/stripe/stripe-ruby/pull/1510) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`
-* [#1521](https://github.com/stripe/stripe-ruby/pull/1521) pipe rubocop output to devnull
-* [#1519](https://github.com/stripe/stripe-ruby/pull/1519) Fixed typos in CONTRIBUTING.MD
-* [#1513](https://github.com/stripe/stripe-ruby/pull/1513) add justfile
-* [#1515](https://github.com/stripe/stripe-ruby/pull/1515) Added CONTRIBUTING.md file
 
-## 13.3.1 - 2025-01-13
+## <a id="13-3-1"></a>13.3.1 - 2025-01-13
+* [#1508](https://github.com/stripe/stripe-ruby/pull/1508) Added pull request template
 * [#1512](https://github.com/stripe/stripe-ruby/pull/1512) Import global configuration for options not available on StripeClient options
   * Fixes bug where `StripeClient` was not falling back to global options for options that are not available to be set per-client
+* [#1518](https://github.com/stripe/stripe-ruby/pull/1518) Pin ubuntu version in Test action
 * [#1516](https://github.com/stripe/stripe-ruby/pull/1516) ThinEvent reason and livemode
   - Add `livemode` and optional `reason` fields to ThinEvent
-* [#1518](https://github.com/stripe/stripe-ruby/pull/1518) Pin ubuntu version in Test action
-* [#1508](https://github.com/stripe/stripe-ruby/pull/1508) Added pull request template
 
-## 13.3.0 - 2024-12-18
-* [#1500](https://github.com/stripe/stripe-ruby/pull/1500) This release changes the pinned API version to `2024-12-18.acacia`.
+## <a id="13-3-0"></a>13.3.0 - 2024-12-18
+This release changes the pinned API version to `2024-12-18.acacia`.
 
 * [#1507](https://github.com/stripe/stripe-ruby/pull/1507) Pass requestor to all deserialized objects including lists
-
   * Fixes bug where `StripeObject` retrieved from lists could not be used to make requests, such as `refresh`
+* [#1500](https://github.com/stripe/stripe-ruby/pull/1500) Update generated code
 
-## 13.2.0 - 2024-11-20
-* [#1486](https://github.com/stripe/stripe-ruby/pull/1486) This release changes the pinned API version to `2024-11-20.acacia`.
+## <a id="13-2-0"></a>13.2.0 - 2024-11-20
+This release changes the pinned API version to `2024-11-20.acacia`.
+
+* [#1486](https://github.com/stripe/stripe-ruby/pull/1486) Update generated code
   * Add support for `respond` test helper method on resource `Issuing.Authorization`
 
-## 13.1.2 - 2024-11-15
+## <a id="13-1-2"></a>13.1.2 - 2024-11-15
 * [#1488](https://github.com/stripe/stripe-ruby/pull/1488) Fix incorrect key in param encoding
 
-## 13.1.1 - 2024-11-06
+## <a id="13-1-1"></a>13.1.1 - 2024-11-06
 * [#1483](https://github.com/stripe/stripe-ruby/pull/1483) Fix APIResource#retrieve not sending `stripe_version`
 
-## 13.1.0 - 2024-10-29
-* [#1472](https://github.com/stripe/stripe-ruby/pull/1472) This release changes the pinned API version to `2024-10-28.acacia`.
+## <a id="13-1-0"></a>13.1.0 - 2024-10-29
+This release changes the pinned API version to `2024-10-28.acacia`.
+
+* [#1476](https://github.com/stripe/stripe-ruby/pull/1476) Fix APIResource#retrieve bug not returning instance of custom resources
+  * Fix bug in APIResource#refresh and APIResource#retrieve where they returned an instance of `StripeObject` for custom resources. They should now return the instance of the custom resource.
+* [#1472](https://github.com/stripe/stripe-ruby/pull/1472) Update generated code
   * Add support for `submit_card` test helper method on resource `Issuing.Card`
   * Add support for new resource `V2.EventDestinations`
   * Add support for `create`, `retrieve`, `update`, `list`, `delete`, `disable`, `enable` and `ping` methods on resource `V2.EventDestinations`
-* [#1476](https://github.com/stripe/stripe-ruby/pull/1476) Fix APIResource#retrieve bug not returning instance of custom resources
-  * Fix bug in APIResource#refresh and APIResource#retrieve where they returned an instance of `StripeObject` for custom resources. They should now return the instance of the custom resource.
 
-## 13.0.2 - 2024-10-23
+## <a id="13-0-2"></a>13.0.2 - 2024-10-23
 * [#1473](https://github.com/stripe/stripe-ruby/pull/1473) Always return the result of APIResource#refresh in APIResource.retrieve
-
   * Fix bug where we would not return the mutated `self` object when calling `APIResource.retrieve`
 
-## 13.0.1 - 2024-10-18
+## <a id="13-0-1"></a>13.0.1 - 2024-10-18
+* [#1470](https://github.com/stripe/stripe-ruby/pull/1470) Cleaned up examples and added documentation
 * [#1471](https://github.com/stripe/stripe-ruby/pull/1471) 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.
-* [#1470](https://github.com/stripe/stripe-ruby/pull/1470) Cleaned up examples and added documentation
 
-## 13.0.0 - 2024-10-01
-* [#1458](https://github.com/stripe/stripe-ruby/pull/1458) Support for APIs in the new API version 2024-09-30.acacia
+## <a id="13-0-0"></a>13.0.0 - 2024-10-01
+This release changes the pinned API version to `2024-09-30.acacia`.
 
+* [#1458](https://github.com/stripe/stripe-ruby/pull/1458) 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
@@ -790,38 +798,35 @@ This release changes the pinned API version to `2025-06-30.basil`.
   * Add support for new Usage Billing APIs `Billing.MeterEvent`, `Billing.MeterEventAdjustments`, `Billing.MeterEventSession`, `Billing.MeterEventStream` and the new Events API `Core.Events` in the [v2 namespace ](https://docs.corp.stripe.com/api-v2-overview)
   * Add method `parse_thin_event()` on the `StripeClient` class to parse [thin events](https://docs.corp.stripe.com/event-destinations#events-overview).
 
-
-## 12.6.0 - 2024-09-12
+## <a id="12-6-0"></a>12.6.0 - 2024-09-12
+* [#1443](https://github.com/stripe/stripe-ruby/pull/1443) Removed v1/files override
 * [#1442](https://github.com/stripe/stripe-ruby/pull/1442) Update generated code
   * Add support for new resource `InvoiceRenderingTemplate`
   * Add support for `archive`, `list`, `retrieve`, and `unarchive` methods on resource `InvoiceRenderingTemplate`
-* [#1443](https://github.com/stripe/stripe-ruby/pull/1443) Removed v1/files override
 
-## 12.5.0 - 2024-08-08
+## <a id="12-5-0"></a>12.5.0 - 2024-08-08
 * [#1440](https://github.com/stripe/stripe-ruby/pull/1440) Update generated code
   * Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`
   * Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Alert`
   * Add support for `retrieve` method on resource `Tax.Calculation`
 
-## 12.4.0 - 2024-07-25
+## <a id="12-4-0"></a>12.4.0 - 2024-07-25
 * [#1437](https://github.com/stripe/stripe-ruby/pull/1437) Update generated code
   * Add support for `update` method on resource `Checkout.Session`
 
-## 12.3.0 - 2024-07-18
-* [#1436](https://github.com/stripe/stripe-ruby/pull/1436) Fixed changelog for major release 12.0.0
+## <a id="12-3-0"></a>12.3.0 - 2024-07-18
 * [#1435](https://github.com/stripe/stripe-ruby/pull/1435) Add deprecation warning for `APIResource.request`
+* [#1436](https://github.com/stripe/stripe-ruby/pull/1436) Fixed changelog for major release 12.0.0
 
-## 12.2.0 - 2024-07-12
-* [#1430](https://github.com/stripe/stripe-ruby/pull/1430) Update generated code
-
-* [#1433](https://github.com/stripe/stripe-ruby/pull/1433) Add usage to raw_request call
+## <a id="12-2-0"></a>12.2.0 - 2024-07-12
 * [#1431](https://github.com/stripe/stripe-ruby/pull/1431) Add `raw_request`
-
   - Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. This is an alternative to using `Stripe::APIResource.request(...)` to make custom requests, which is discouraged and will be broken in a future major version.
+* [#1433](https://github.com/stripe/stripe-ruby/pull/1433) Add usage to raw_request call
+* [#1430](https://github.com/stripe/stripe-ruby/pull/1430) Update generated code
 
-## 12.1.0 - 2024-07-05
-* [#1425](https://github.com/stripe/stripe-ruby/pull/1425) Update generated code
-  * Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
+## <a id="12-1-0"></a>12.1.0 - 2024-07-05
+* [#1427](https://github.com/stripe/stripe-ruby/pull/1427) Regenerate rbis
+* [#1426](https://github.com/stripe/stripe-ruby/pull/1426) Remove coveralls and re-added JRuby
 * [#1420](https://github.com/stripe/stripe-ruby/pull/1420) Update static methods for delete/list on BankAccount/Card to throw NotImplementedError
   * The below methods have been throwing `InvalidRequestError` because the urls used to make the requests have been buggy. Updating them to throw `NotImplementedError` instead just like their counterparts for update & retrieve because they cannot be implemented without the parent id.
 
@@ -831,202 +836,200 @@ This release changes the pinned API version to `2025-06-30.basil`.
   Stripe:: BankAccount.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
   Stripe:: Card.delete | Stripe::Customer.delete_source | Stripe::Account.delete_external_account
   Stripe:: Card.list | Stripe::Customer.list_sources | Stripe::Customer.list_external_accounts
-* [#1427](https://github.com/stripe/stripe-ruby/pull/1427) Regenerate rbis
-* [#1426](https://github.com/stripe/stripe-ruby/pull/1426) Remove coveralls and re-added JRuby
-
-## 12.0.0 - 2024-06-24
-* [#1418](https://github.com/stripe/stripe-ruby/pull/1418) Add missing static method for verify on BankAccount
-* [#1419](https://github.com/stripe/stripe-ruby/pull/1419)
+* [#1425](https://github.com/stripe/stripe-ruby/pull/1425) Update generated code
+  * Add support for `add_lines`, `remove_lines`, and `update_lines` methods on resource `Invoice`
 
-  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="12-0-0"></a>12.0.0 - 2024-06-24
+This release changes the pinned API version to `2024-06-20`.
 
+* [#1418](https://github.com/stripe/stripe-ruby/pull/1418) Add missing static method for verify on BankAccount
+* [#1419](https://github.com/stripe/stripe-ruby/pull/1419) Please read the [API Changelog](https://docs.stripe.com/changelog/2024-06-20) and carefully review the API changes before upgrading.
   ### Additions
 
   * Add support for `finalize_amount` test helper method on resource `Issuing.Authorization`
 
-## 11.7.0 - 2024-06-13
+## <a id="11-7-0"></a>11.7.0 - 2024-06-13
 * [#1415](https://github.com/stripe/stripe-ruby/pull/1415) Deprecate StripeClient#request
   * Add deprecation warning for `StripeClient#request`. This helper method will be removed in a future major version. To access response objects, use the `last_response` property on the returned resource instead. Refer to [Accessing a response object](https://github.com/stripe/stripe-ruby?tab=readme-ov-file#accessing-a-response-object) in the README for usage details.
 
-## 11.6.0 - 2024-05-30
+## <a id="11-6-0"></a>11.6.0 - 2024-05-30
 * [#1404](https://github.com/stripe/stripe-ruby/pull/1404) Add method to list invoice line items
   * Add methods `list_lines()` on the class `Invoice` to list the invoice line items
 
-## 11.5.0 - 2024-05-23
+## <a id="11-5-0"></a>11.5.0 - 2024-05-23
 * This release has no changes.
 
-## 11.4.0 - 2024-05-09
-* [#1397](https://github.com/stripe/stripe-ruby/pull/1397) Update generated code
-  * Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
+## <a id="11-4-0"></a>11.4.0 - 2024-05-09
+* [#1396](https://github.com/stripe/stripe-ruby/pull/1396) Start tracking `StripeClient#request` usage
+* [#1389](https://github.com/stripe/stripe-ruby/pull/1389) Removed jaro_winkler as a dependency
 * [#1399](https://github.com/stripe/stripe-ruby/pull/1399) Pass params to transfer reversal
   * Allow `Stripe::Transfer.retrieve_reversal()` to accept a params hash as the third argument, followed by opts. No changes to existing calls are necessary, but in a future major version this method will be updated to only accept params as the first argument. Fixes [#1393](https://github.com/stripe/stripe-ruby/issues/1393)
-* [#1389](https://github.com/stripe/stripe-ruby/pull/1389) Removed jaro_winkler as a dependency
-* [#1396](https://github.com/stripe/stripe-ruby/pull/1396) Start tracking `StripeClient#request` usage
-
-## 11.3.0 - 2024-05-02
-* [#1387](https://github.com/stripe/stripe-ruby/pull/1387) Update generated code
+* [#1397](https://github.com/stripe/stripe-ruby/pull/1397) Update generated code
+  * Add support for `update` test helper method on resources `Treasury.OutboundPayment` and `Treasury.OutboundTransfer`
 
+## <a id="11-3-0"></a>11.3.0 - 2024-05-02
+* [#1391](https://github.com/stripe/stripe-ruby/pull/1391) Add Ruby 3.3 to CI test matrix
 * [#1392](https://github.com/stripe/stripe-ruby/pull/1392) Deprecate Ruby methods based on OpenAPI spec
   - Mark as deprecated the `approve` and `decline` methods in `lib/stripe/resources/issuing/authorization.rb`. Instead, [respond directly to the webhook request to approve an authorization](https://stripe.com/docs/issuing/controls/real-time-authorizations#authorization-handling).
-* [#1391](https://github.com/stripe/stripe-ruby/pull/1391) Add Ruby 3.3 to CI test matrix
+* [#1387](https://github.com/stripe/stripe-ruby/pull/1387) Update generated code
 
-## 11.2.0 - 2024-04-18
+## <a id="11-2-0"></a>11.2.0 - 2024-04-18
 * [#1385](https://github.com/stripe/stripe-ruby/pull/1385) Update generated code
   * Add support for `create_preview` method on resource `Invoice`
 
-## 11.1.0 - 2024-04-16
+## <a id="11-1-0"></a>11.1.0 - 2024-04-16
 * [#1379](https://github.com/stripe/stripe-ruby/pull/1379) Update generated code
   * Add support for new resource `Entitlements.ActiveEntitlementSummary`
 
-## 11.0.0 - 2024-04-10
-* [#1374](https://github.com/stripe/stripe-ruby/pull/1374)
+## <a id="11-0-0"></a>11.0.0 - 2024-04-10
+This release changes the pinned API version to `2024-04-10`.
 
+* [#1374](https://github.com/stripe/stripe-ruby/pull/1374) Change retry logic
   * This release changes the pinned API version to `2024-04-10`. Please read the [API Changelog](https://docs.stripe.com/changelog/2024-04-10) and carefully review the API changes before upgrading.
 
   ### ⚠️ Breaking changes
 
   * When no `x-stripe-should-retry` header is set in the response, the library now retries all requests with `status >= 500`, not just non-POST methods.
 
-## 10.15.0 - 2024-04-09
+## <a id="10-15-0"></a>10.15.0 - 2024-04-09
+* [#1366](https://github.com/stripe/stripe-ruby/pull/1366) Move executables to `exe` folder
 * [#1377](https://github.com/stripe/stripe-ruby/pull/1377) Add last_response to StripeObject
   * Users can now retrieve raw response from the returned resource, using the `last_response` property. See [README](https://github.com/stripe/stripe-ruby/blob/master/README.md) for an example.
 * [#1372](https://github.com/stripe/stripe-ruby/pull/1372) Update generated code
   * 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`
-* [#1366](https://github.com/stripe/stripe-ruby/pull/1366) Move executables to `exe` folder
 
-## 10.14.0 - 2024-03-28
+## <a id="10-14-0"></a>10.14.0 - 2024-03-28
 * [#1369](https://github.com/stripe/stripe-ruby/pull/1369) 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`
   * Add support for `create` method on resources `MeterEventAdjustment` and `MeterEvent`
 
-## 10.13.0 - 2024-03-21
+## <a id="10-13-0"></a>10.13.0 - 2024-03-21
+* [#1362](https://github.com/stripe/stripe-ruby/pull/1362) Exclude sorbet directory and tapioca script when packing gem
 * [#1367](https://github.com/stripe/stripe-ruby/pull/1367) Update generated code
   * 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`
-* [#1362](https://github.com/stripe/stripe-ruby/pull/1362) Exclude sorbet directory and tapioca script when packing gem
 
-## 10.12.0 - 2024-03-14
+## <a id="10-12-0"></a>10.12.0 - 2024-03-14
+* [#1351](https://github.com/stripe/stripe-ruby/pull/1351) Update CHANGELOG.md
+* [#1355](https://github.com/stripe/stripe-ruby/pull/1355) Disable Metrics/ClassLength
+* [#1347](https://github.com/stripe/stripe-ruby/pull/1347) Reorder methods with lexographical sort
+* [#1354](https://github.com/stripe/stripe-ruby/pull/1354) Refactor after SDK based generation pattern
 * [#1359](https://github.com/stripe/stripe-ruby/pull/1359) 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`
   * Add support for `list` and `retrieve` methods on resource `PhysicalBundle`
-* [#1354](https://github.com/stripe/stripe-ruby/pull/1354) Refactor after SDK based generation pattern
-* [#1347](https://github.com/stripe/stripe-ruby/pull/1347) Reorder methods with lexographical sort
-* [#1355](https://github.com/stripe/stripe-ruby/pull/1355) Disable Metrics/ClassLength
-* [#1351](https://github.com/stripe/stripe-ruby/pull/1351) Update CHANGELOG.md
 
-## 10.11.0 - 2024-02-29
+## <a id="10-11-0"></a>10.11.0 - 2024-02-29
+* [#1345](https://github.com/stripe/stripe-ruby/pull/1345) Update README to use add_beta_version
 * [#1348](https://github.com/stripe/stripe-ruby/pull/1348) Use sorbet gem instead of sorbet-static
 * [#1342](https://github.com/stripe/stripe-ruby/pull/1342) Update generated code
   * Add `list_refunds` and `retrieve_refund` methods on resource `Charge`.
-* [#1345](https://github.com/stripe/stripe-ruby/pull/1345) Update README to use add_beta_version
 
-## 10.10.0 - 2024-02-22
-* [#1336](https://github.com/stripe/stripe-ruby/pull/1336) Update generated code
-  - Add `InvoiceLineItem.update` method.
+## <a id="10-10-0"></a>10.10.0 - 2024-02-22
 * [#1334](https://github.com/stripe/stripe-ruby/pull/1334) Add TaxIds API
   * Add support for `all`, `create`, and `retrieve` methods on resource `TaxId`
   * The `delete` method now sends a DELETE request to `/v1/tax_ids/{id}` instead of `/v1/customers/{customer}/tax_ids/{id}`. The endpoints are functionally the same when operating on a Customer Tax ID.
   * The `resource_url` method on `TaxId` now returns the top-level `/v1/tax_ids/{id}` path instead of the `/v1/customers/{customer}/tax_ids/{id}` path.
+* [#1336](https://github.com/stripe/stripe-ruby/pull/1336) Update generated code
+  - Add `InvoiceLineItem.update` method.
 
-## 10.9.0 - 2024-02-15
+## <a id="10-9-0"></a>10.9.0 - 2024-02-15
+* [#1327](https://github.com/stripe/stripe-ruby/pull/1327) Add methods for dynamically referenced constants
+* [#1324](https://github.com/stripe/stripe-ruby/pull/1324) Start running Sorbet in CI
 * [#1329](https://github.com/stripe/stripe-ruby/pull/1329) Update generated code
   * Fixed bug where `TaxId` resource `delete` method sent request to wrong URL (https://github.com/stripe/stripe-ruby/issues/1333)
-* [#1324](https://github.com/stripe/stripe-ruby/pull/1324) Start running Sorbet in CI
-* [#1327](https://github.com/stripe/stripe-ruby/pull/1327) Add methods for dynamically referenced constants
 
-## 10.8.0 - 2024-02-08
-* [#1322](https://github.com/stripe/stripe-ruby/pull/1322) Update generated code
+## <a id="10-8-0"></a>10.8.0 - 2024-02-08
+* [#1314](https://github.com/stripe/stripe-ruby/pull/1314) Update mocha gem to 1.16
 * [#1323](https://github.com/stripe/stripe-ruby/pull/1323) Extract other CRUDL api operations from mixins
   * Extract more CRUDL operations, namely `create`, `delete`, `update`, and `list` into the resources. These methods will no longer rely on the APIOperation mixins.
-* [#1314](https://github.com/stripe/stripe-ruby/pull/1314) Update mocha gem to 1.16
+* [#1322](https://github.com/stripe/stripe-ruby/pull/1322) Update generated code
 
-## 10.7.1 - 2024-02-05
+## <a id="10-7-1"></a>10.7.1 - 2024-02-05
 * [#1320](https://github.com/stripe/stripe-ruby/pull/1320) Remove spurious _search deprecation messages (https://github.com/stripe/stripe-ruby/issues/1319)
 
-## 10.7.0 - 2024-02-01
+## <a id="10-7-0"></a>10.7.0 - 2024-02-01
+* [#1311](https://github.com/stripe/stripe-ruby/pull/1311) Use the deprecation gem in search and clean up usage of the gem
 * [#1317](https://github.com/stripe/stripe-ruby/pull/1317) Remove list method in child resources
   * Removes list method mixin from child resources, as these methods always return `InvalidRequestError` and never succeed
-* [#1311](https://github.com/stripe/stripe-ruby/pull/1311) Use the deprecation gem in search and clean up usage of the gem
 
-## 10.6.0 - 2024-01-12
+## <a id="10-6-0"></a>10.6.0 - 2024-01-12
 * [#1310](https://github.com/stripe/stripe-ruby/pull/1310) Update generated code
   * Add support for new resource `CustomerSession`
   * Add support for `create` method on resource `CustomerSession`
 
-## 10.5.0 - 2024-01-04
+## <a id="10-5-0"></a>10.5.0 - 2024-01-04
 * [#1306](https://github.com/stripe/stripe-ruby/pull/1306) Update generated code
   * Add support for `retrieve` method on resource `Tax.Registration`
 
-## 10.4.0 - 2023-12-22
+## <a id="10-4-0"></a>10.4.0 - 2023-12-22
+* [#1304](https://github.com/stripe/stripe-ruby/pull/1304) Add support for updatable singleton resources
 * [#1303](https://github.com/stripe/stripe-ruby/pull/1303) Update generated code
   * 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`
-* [#1304](https://github.com/stripe/stripe-ruby/pull/1304) Add support for updatable singleton resources
 
-## 10.3.0 - 2023-12-14
+## <a id="10-3-0"></a>10.3.0 - 2023-12-14
 * [#1294](https://github.com/stripe/stripe-ruby/pull/1294) Support sending parameters inside singleton retrieve
 
-## 10.2.0 - 2023-11-30
+## <a id="10-2-0"></a>10.2.0 - 2023-11-30
+* [#1295](https://github.com/stripe/stripe-ruby/pull/1295) Upgrade rubocop
+* [#1290](https://github.com/stripe/stripe-ruby/pull/1290) Update generated code
+* [#1288](https://github.com/stripe/stripe-ruby/pull/1288) Update generated code
+* [#1291](https://github.com/stripe/stripe-ruby/pull/1291) Update generated code
 * [#1292](https://github.com/stripe/stripe-ruby/pull/1292) 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`
   * Add support for `list` and `retrieve` methods on resources `Product` and `Supplier`
-* [#1295](https://github.com/stripe/stripe-ruby/pull/1295) Upgrade rubocop
-* [#1291](https://github.com/stripe/stripe-ruby/pull/1291) Update generated code
 
-* [#1290](https://github.com/stripe/stripe-ruby/pull/1290) Update generated code
-
-* [#1288](https://github.com/stripe/stripe-ruby/pull/1288) Update generated code
-
-
-## 10.1.0 - 2023-11-02
+## <a id="10-1-0"></a>10.1.0 - 2023-11-02
 * [#1286](https://github.com/stripe/stripe-ruby/pull/1286) Update generated code
   * Add support for new resource `Tax.Registration`
   * Add support for `create`, `list`, and `update` methods on resource `Registration`
 
-## 10.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-ruby`.
+## <a id="10-0-0"></a>10.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-ruby`.
 * [#1283](https://github.com/stripe/stripe-ruby/pull/1283) Update generated code
   - Updated pinned API version
 * [#1281](https://github.com/stripe/stripe-ruby/pull/1281) Update generated code
   * Documentation only changes
 
-## 9.4.0 - 2023-10-05
+## <a id="9-4-0"></a>9.4.0 - 2023-10-05
 * [#1277](https://github.com/stripe/stripe-ruby/pull/1277) Update generated code
   * Add support for new resources `Issuing.Token`
   * Add support for `list`, `retrieve`, and `update` methods on resource `Token`
 
-## 9.3.0 - 2023-09-14
-* [#1272](https://github.com/stripe/stripe-ruby/pull/1272) Update generated code
-  * Add support for new resource `PaymentMethodConfiguration`
-  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
+## <a id="9-3-0"></a>9.3.0 - 2023-09-14
 * [#1271](https://github.com/stripe/stripe-ruby/pull/1271) Update generated code
   * Add support for `capture`, `create`, `expire`, `increment`, and `reverse` test helper methods on resource `Issuing.Authorization`
   * Add support for `create_force_capture`, `create_unlinked_refund`, and `refund` test helper methods on resource `Issuing.Transaction`
+* [#1272](https://github.com/stripe/stripe-ruby/pull/1272) Update generated code
+  * Add support for new resource `PaymentMethodConfiguration`
+  * Add support for `create`, `list`, `retrieve`, and `update` methods on resource `PaymentMethodConfiguration`
 
-## 9.2.0 - 2023-09-07
+## <a id="9-2-0"></a>9.2.0 - 2023-09-07
 * [#1267](https://github.com/stripe/stripe-ruby/pull/1267) Update generated code
   * Add support for new resource `PaymentMethodDomain`
   * Add support for `create`, `list`, `retrieve`, `update`, and `validate` methods on resource `PaymentMethodDomain`
 
-## 9.1.0 - 2023-08-31
+## <a id="9-1-0"></a>9.1.0 - 2023-08-31
+* [#1262](https://github.com/stripe/stripe-ruby/pull/1262) Explicitly format timestamp in SignatureVerificationError message
 * [#1266](https://github.com/stripe/stripe-ruby/pull/1266) Update generated code
   * Add support for new resource `AccountSession`
   * Add support for `create` method on resource `AccountSession`
-* [#1262](https://github.com/stripe/stripe-ruby/pull/1262) Explicitly format timestamp in SignatureVerificationError message
 
+## <a id="9-0-0"></a>9.0.0 - 2023-08-16
+This release changes the pinned API version to `2023-08-16`.
 
-## 9.0.0 - 2023-08-16
 **⚠️ ACTION REQUIRED: the breaking change in this release likely affects you ⚠️**
 
 * [#1253](https://github.com/stripe/stripe-ruby/pull/1253) [#1260](https://github.com/stripe/stripe-ruby/pull/1260) Pin latest API version as the default
-
   In this release, Stripe API Version `2023-08-16` (the latest at time of release) will be sent by default on all requests. This is a significant change with wide ramifications. The API version affects the properties you see on responses, the parameters you are allowed to send on requests, and so on. The previous default was to use your [Stripe account's default API version](https://stripe.com/docs/development/dashboard/request-logs#view-your-default-api-version).
 
   To successfully upgrade to stripe-ruby v9, you must either
@@ -1054,73 +1057,67 @@ This release changes the pinned API version to `2025-06-30.basil`.
 
   That is, instead of upgrading stripe-ruby and separately upgrading your Stripe API Version through the Stripe Dashboard. whenever you upgrade major versions of stripe-ruby, you should also upgrade your integration to be compatible with the latest Stripe API version.
 
-## 8.7.0 - 2023-08-10
+## <a id="8-7-0"></a>8.7.0 - 2023-08-10
 * [#1256](https://github.com/stripe/stripe-ruby/pull/1256) Update generated code
   Add resources `Tax::CalculationLineItem`, `Tax::TransactionLineItem`, and `Treasury::FinancialAccountFeatures`. These resources have no methods on them, but do represent the return type of methods elsewhere.
 
-## 8.6.0 - 2023-07-13
-* [#1244](https://github.com/stripe/stripe-ruby/pull/1244) Update generated code
-  * Add support for new resource `Tax.Settings`
-  * Add support for `retrieve` and `update` methods on resource `Settings`
-* [#1241](https://github.com/stripe/stripe-ruby/pull/1241) Update generated code
-
+## <a id="8-6-0"></a>8.6.0 - 2023-07-13
 * [#1209](https://github.com/stripe/stripe-ruby/pull/1209) Update shoulda-context version
+* [#1225](https://github.com/stripe/stripe-ruby/pull/1225) Downgrade jaro_winkler
+* [#1231](https://github.com/stripe/stripe-ruby/pull/1231) fix: variable typo in README for instrumentation
 * [#1235](https://github.com/stripe/stripe-ruby/pull/1235) Allow "error" string as log level
 * [#1238](https://github.com/stripe/stripe-ruby/pull/1238) Update log level error message to include `error`
-* [#1231](https://github.com/stripe/stripe-ruby/pull/1231) fix: variable typo in README for instrumentation
-* [#1234](https://github.com/stripe/stripe-ruby/pull/1234) Update generated code
-
-* [#1230](https://github.com/stripe/stripe-ruby/pull/1230) Update generated code
-  * Release specs are identical.
-* [#1226](https://github.com/stripe/stripe-ruby/pull/1226) Update generated code
-
-* [#1223](https://github.com/stripe/stripe-ruby/pull/1223) Update generated code
-
-* [#1225](https://github.com/stripe/stripe-ruby/pull/1225) Downgrade jaro_winkler
+* [#1204](https://github.com/stripe/stripe-ruby/pull/1204) Update generated code
+* [#1208](https://github.com/stripe/stripe-ruby/pull/1208) Update generated code
+* [#1215](https://github.com/stripe/stripe-ruby/pull/1215) Update generated code
 * [#1219](https://github.com/stripe/stripe-ruby/pull/1219) Update generated code
-
   Documentation updates.
-* [#1215](https://github.com/stripe/stripe-ruby/pull/1215) Update generated code
-
-* [#1208](https://github.com/stripe/stripe-ruby/pull/1208) Update generated code
-
-* [#1204](https://github.com/stripe/stripe-ruby/pull/1204) Update generated code
-
+* [#1223](https://github.com/stripe/stripe-ruby/pull/1223) Update generated code
+* [#1226](https://github.com/stripe/stripe-ruby/pull/1226) Update generated code
+* [#1230](https://github.com/stripe/stripe-ruby/pull/1230) Update generated code
+  * Release specs are identical.
+* [#1234](https://github.com/stripe/stripe-ruby/pull/1234) Update generated code
+* [#1241](https://github.com/stripe/stripe-ruby/pull/1241) Update generated code
+* [#1244](https://github.com/stripe/stripe-ruby/pull/1244) Update generated code
+  * Add support for new resource `Tax.Settings`
+  * Add support for `retrieve` and `update` methods on resource `Settings`
 
-## 8.5.0 - 2023-03-30
+## <a id="8-5-0"></a>8.5.0 - 2023-03-30
+* [#1201](https://github.com/stripe/stripe-ruby/pull/1201) Update save deprecation message
 * [#1203](https://github.com/stripe/stripe-ruby/pull/1203) Update generated code
   * Remove support for `create` method on resource `Tax.Transaction`
     * This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the `create_from_calculation` method.
-* [#1201](https://github.com/stripe/stripe-ruby/pull/1201) Update save deprecation message
 
-## 8.4.0 - 2023-03-23
+## <a id="8-4-0"></a>8.4.0 - 2023-03-23
+* [#1152](https://github.com/stripe/stripe-ruby/pull/1152) Symbolize hash keys inside `convert_to_stripe_object_with_params`
 * [#1197](https://github.com/stripe/stripe-ruby/pull/1197) Update generated code (new)
   * 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`
-* [#1152](https://github.com/stripe/stripe-ruby/pull/1152) Symbolize hash keys inside `convert_to_stripe_object_with_params`
 
-## 8.3.0 - 2023-02-16
+## <a id="8-3-0"></a>8.3.0 - 2023-02-16
 * [#1175](https://github.com/stripe/stripe-ruby/pull/1175) API Updates
   * Add support for `refund_payment` method on resource `Terminal.Reader`
 
-## 8.2.0 - 2023-02-02
+## <a id="8-2-0"></a>8.2.0 - 2023-02-02
+* [#1171](https://github.com/stripe/stripe-ruby/pull/1171) Remove unused `partial` param from `initialize_from`
 * [#1173](https://github.com/stripe/stripe-ruby/pull/1173) API Updates
   * Add support for `resume` method on resource `Subscription`
-* [#1171](https://github.com/stripe/stripe-ruby/pull/1171) Remove unused `partial` param from `initialize_from`
 
-## 8.1.0 - 2023-01-12
+## <a id="8-1-0"></a>8.1.0 - 2023-01-12
 * [#1162](https://github.com/stripe/stripe-ruby/pull/1162) Improve request events instrumentation
 
-## 8.0.0 - 2022-11-16
-* [#1144](https://github.com/stripe/stripe-ruby/pull/1144) Next major release changes
+## <a id="8-0-0"></a>8.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.
 
+* [#1144](https://github.com/stripe/stripe-ruby/pull/1144) Next major release changes
+
 ### Deprecated
-- The `save` method is deprecated. Prefer the static `update` method that doesn't require retrieval of the resource to update it.
+* The `save` method is deprecated. Prefer the static `update` method that doesn't require retrieval of the resource to update it.
   ``` ruby
   # before
   refund = Stripe::Refund.retrieve("re_123")
@@ -1132,9 +1129,7 @@ Breaking changes that arose during code generation of the library that we postpo
   ```
 
 ### ⚠️ Removed
-- Removed deprecated `Sku` resource.
-- Removed deprecated `Orders` resource.
-- Removed deprecated `delete` method on `Subscription` resource. Please use `cancel` method instead.
+* ⚠️ Removed deprecated `delete` method on `Subscription` resource. Please use `cancel` method instead.
   ```ruby
   # before
   Stripe::Subscription::delete("sub_12345")
@@ -1142,75 +1137,74 @@ Breaking changes that arose during code generation of the library that we postpo
   # after
   Stripe::Subscription::cancel("sub_12345")
   ```
+* ⚠️ Removed deprecated `Orders` resource.
+* ⚠️ Removed deprecated `Sku` resource.
 
-
-## 7.1.0 - 2022-08-19
+## <a id="7-1-0"></a>7.1.0 - 2022-08-19
+* [#1115](https://github.com/stripe/stripe-ruby/pull/1115) Add a support section to the readme
+* [#1117](https://github.com/stripe/stripe-ruby/pull/1117) Refresh rubocop config.
+* [#1118](https://github.com/stripe/stripe-ruby/pull/1118) Update AllowedChars in rubocop config
 * [#1116](https://github.com/stripe/stripe-ruby/pull/1116) API Updates
   * Add support for new resource `CustomerCashBalanceTransaction`
-* [#1118](https://github.com/stripe/stripe-ruby/pull/1118) Update AllowedChars in rubocop config
-* [#1117](https://github.com/stripe/stripe-ruby/pull/1117) Refresh rubocop config.
-* [#1115](https://github.com/stripe/stripe-ruby/pull/1115) Add a support section to the readme
 
-## 7.0.0 - 2022-08-02
+## <a id="7-0-0"></a>7.0.0 - 2022-08-02
+This release changes the pinned API version to `2022-08-01`.
 
 Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v7. For changes to the Stripe products, read more at https://docs.stripe.com/changelog/2022-08-01.
 
 "⚠️" symbol highlights breaking changes.
 
-* [#1106](https://github.com/stripe/stripe-ruby/pull/1106) API Updates
-* [#1092](https://github.com/stripe/stripe-ruby/pull/1092) API Updates
 * [#1090](https://github.com/stripe/stripe-ruby/pull/1090) Use auto-generation for `Invoice` methods
+* [#1092](https://github.com/stripe/stripe-ruby/pull/1092) API Updates
 * [#1103](https://github.com/stripe/stripe-ruby/pull/1103) Next major release changes
+* [#1106](https://github.com/stripe/stripe-ruby/pull/1106) API Updates
 
 ### ⚠️ Changed
-* `retrieve_cash_balance` and `update_cash_balance` methods on `Customer` resource no longer requires the second argument to always be `nil`. The methods now now take in `customer_id`, `params`, and `opts` parameters.
-* Update default bundle of CA certificates to April 26, 2022.
+* ⚠️ `retrieve_cash_balance` and `update_cash_balance` methods on `Customer` resource no longer requires the second argument to always be `nil`. The methods now now take in `customer_id`, `params`, and `opts` parameters.
+* ⚠️ Update default bundle of CA certificates to April 26, 2022.
 
 ### Deprecated
 * Deprecate `delete` method on `Subscription` resource. Please use `cancel` method instead.
 
 ### ⚠️ Removed
-* Remove `details` method from `Issuing.Card` resource. The method was not supported.
-* Remove `Issuing.CardDetails` resource. Read more at https://stripe.com/docs/issuing/cards/virtual.
-* Remove `create` method from `ReportType` resource. The method was not supported.
-* Remove `usage_record_summaries` method from `SubscriptionItem` resource. Please use `list_usage_record_summaries` method instead.
-* Remove `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `Issuing::CardDetails`, `Recipient`, ` RecipientTransfer`, and `ThreeDSecure` resources. The resources were deprecated or no longer in use.
-* Remove ability to list `Card` resource for a `Recipient`.
-* Remove `cancel` method from `Transfer` resource. The method was deprecated.
-
-## 6.5.0 - 2022-06-29
+* ⚠️ Remove ability to list `Card` resource for a `Recipient`.
+* ⚠️ Remove `AlipayAccount`, `BitcoinReceiver`, `BitcoinTransaction`, `Issuing::CardDetails`, `Recipient`, ` RecipientTransfer`, and `ThreeDSecure` resources. The resources were deprecated or no longer in use.
+* ⚠️ Remove `cancel` method from `Transfer` resource. The method was deprecated.
+* ⚠️ Remove `create` method from `ReportType` resource. The method was not supported.
+* ⚠️ Remove `details` method from `Issuing.Card` resource. The method was not supported.
+* ⚠️ Remove `Issuing.CardDetails` resource. Read more at https://stripe.com/docs/issuing/cards/virtual.
+* ⚠️ Remove `usage_record_summaries` method from `SubscriptionItem` resource. Please use `list_usage_record_summaries` method instead.
+
+## <a id="6-5-0"></a>6.5.0 - 2022-06-29
+* [#1076](https://github.com/stripe/stripe-ruby/pull/1076) fix: Update logging to coerce ASCII-8BIT into UTF-8.
 * [#1084](https://github.com/stripe/stripe-ruby/pull/1084) API Updates
   * Add support for `deliver_card`, `fail_card`, `return_card`, and `ship_card` test helper methods on resource `Issuing.Card`
-* [#1076](https://github.com/stripe/stripe-ruby/pull/1076) fix: Update logging to coerce ASCII-8BIT into UTF-8.
 
-## 6.4.0 - 2022-06-17
-* [#1073](https://github.com/stripe/stripe-ruby/pull/1073) API Updates
-  * Add support for `fund_cash_balance` test helper method on resource `Customer`
+## <a id="6-4-0"></a>6.4.0 - 2022-06-17
+* [#1069](https://github.com/stripe/stripe-ruby/pull/1069) chore: Stop special implementation of Account.persons method.
+* [#1071](https://github.com/stripe/stripe-ruby/pull/1071) Use request_stripe_object for all requests
 * [#1074](https://github.com/stripe/stripe-ruby/pull/1074) Support updating pre-release versions
 * [#1072](https://github.com/stripe/stripe-ruby/pull/1072) Trigger workflows on beta branches
-* [#1071](https://github.com/stripe/stripe-ruby/pull/1071) Use request_stripe_object for all requests
 * [#1070](https://github.com/stripe/stripe-ruby/pull/1070) API Updates
-
   Switch from using meta-programing to generating explicit methods for custom methods.
-* [#1069](https://github.com/stripe/stripe-ruby/pull/1069) chore: Stop special implementation of Account.persons method.
+* [#1073](https://github.com/stripe/stripe-ruby/pull/1073) API Updates
+  * Add support for `fund_cash_balance` test helper method on resource `Customer`
 
-## 6.3.0 - 2022-06-08
+## <a id="6-3-0"></a>6.3.0 - 2022-06-08
 * [#1063](https://github.com/stripe/stripe-ruby/pull/1063) fix: Update cash balance methods to no longer require nested ID.
 
-## 6.2.0 - 2022-05-23
+## <a id="6-2-0"></a>6.2.0 - 2022-05-23
 * [#1060](https://github.com/stripe/stripe-ruby/pull/1060) API Updates
   * Add support for new resource `Apps.Secret`
 
-## 6.1.0 - 2022-05-19
+## <a id="6-1-0"></a>6.1.0 - 2022-05-19
 * [#1057](https://github.com/stripe/stripe-ruby/pull/1057) 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`
 
-
-
-## 6.0.0 - 2022-05-09
-* [#1056](https://github.com/stripe/stripe-ruby/pull/1056) API Updates
+## <a id="6-0-0"></a>6.0.0 - 2022-05-09
+* ⚠️ [#1056](https://github.com/stripe/stripe-ruby/pull/1056) API Updates
   Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-Guide-for-v6) contains more information.
 
   (⚠️ = breaking changes):
@@ -1220,1037 +1214,1027 @@ Breaking changes that arose during code generation of the library that we postpo
     * Removed resources: `OrderItem` and `OrderReturn`
   * ⚠️ Rename `FinancialConnections::Account.refresh` to `FinancialConnections::Account.refresh_account
 
-## 5.55.0 - 2022-05-05
+## <a id="5-55-0"></a>5.55.0 - 2022-05-05
 * [#1055](https://github.com/stripe/stripe-ruby/pull/1055) API Updates
   * Add support for new resources `FinancialConnections.AccountOwner`, `FinancialConnections.AccountOwnership`, `FinancialConnections.Account`, and `FinancialConnections.Session`
 
-
-## 5.54.0 - 2022-05-03
+## <a id="5-54-0"></a>5.54.0 - 2022-05-03
 * [#1053](https://github.com/stripe/stripe-ruby/pull/1053) API Updates
   * Add support for new resource `CashBalance`
 
-## 5.53.0 - 2022-04-21
+## <a id="5-53-0"></a>5.53.0 - 2022-04-21
 * [#1050](https://github.com/stripe/stripe-ruby/pull/1050) API Updates
   * Add support for `expire` test helper method on resource `Refund`
 
-## 5.52.0 - 2022-04-18
+## <a id="5-52-0"></a>5.52.0 - 2022-04-18
 * [#1046](https://github.com/stripe/stripe-ruby/pull/1046) [#1047](https://github.com/stripe/stripe-ruby/pull/1047) API Updates
   * Add support for new resources `FundingInstructions` and `Terminal.Configuration`
 
-## 5.51.0 - 2022-04-15
+## <a id="5-51-0"></a>5.51.0 - 2022-04-15
 * [#1046](https://github.com/stripe/stripe-ruby/pull/1046) This release was incomplete and was yanked from RubyGems immediately after it was published.
 
-## 5.50.0 - 2022-04-13
+## <a id="5-50-0"></a>5.50.0 - 2022-04-13
 * [#1045](https://github.com/stripe/stripe-ruby/pull/1045) API Updates
   * Add support for `increment_authorization` method on resource `PaymentIntent`
 
-## 5.49.0 - 2022-04-08
+## <a id="5-49-0"></a>5.49.0 - 2022-04-08
 * [#1043](https://github.com/stripe/stripe-ruby/pull/1043) API Updates
   * Add support for `apply_customer_balance` method on resource `PaymentIntent`
 
-## 5.48.0 - 2022-03-30
+## <a id="5-48-0"></a>5.48.0 - 2022-03-30
 * [#1041](https://github.com/stripe/stripe-ruby/pull/1041) API Updates
   * Add support for `cancel_action`, `process_payment_intent`, `process_setup_intent`, and `set_reader_display` methods on resource `Terminal.Reader`
 
-## 5.47.0 - 2022-03-29
+## <a id="5-47-0"></a>5.47.0 - 2022-03-29
+* [#1034](https://github.com/stripe/stripe-ruby/pull/1034) Add supporting classes for test helper generation
 * [#1040](https://github.com/stripe/stripe-ruby/pull/1040) API Updates
   * Add support for Search API
     * Add support for `search` method on resources `Charge`, `Customer`, `Invoice`, `PaymentIntent`, `Price`, `Product`, and `Subscription`
 
-* [#1034](https://github.com/stripe/stripe-ruby/pull/1034) Add supporting classes for test helper generation
-
-## 5.46.0 - 2022-03-23
+## <a id="5-46-0"></a>5.46.0 - 2022-03-23
+* [#992](https://github.com/stripe/stripe-ruby/pull/992) Add support for Search API
 * [#1039](https://github.com/stripe/stripe-ruby/pull/1039) API Updates
   * Add support for `cancel` method on resource `Refund`
-* [#992](https://github.com/stripe/stripe-ruby/pull/992) Add support for Search API
 
-## 5.45.0 - 2022-03-01
+## <a id="5-45-0"></a>5.45.0 - 2022-03-01
 * [#1035](https://github.com/stripe/stripe-ruby/pull/1035) API Updates
   * Add support for new resource `TestHelpers.TestClock`
 
-## 5.44.0 - 2022-02-16
+## <a id="5-44-0"></a>5.44.0 - 2022-02-16
 * [#1032](https://github.com/stripe/stripe-ruby/pull/1032) API Updates
   * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
 
-## 5.43.0 - 2022-01-20
+## <a id="5-43-0"></a>5.43.0 - 2022-01-20
 * [#1031](https://github.com/stripe/stripe-ruby/pull/1031) API Updates
   * Add support for new resource `PaymentLink`
 
-## 5.42.0 - 2021-12-13
+## <a id="5-42-0"></a>5.42.0 - 2021-12-13
 * [#1022](https://github.com/stripe/stripe-ruby/pull/1022) Add connection manager logging and include object IDs in logging.
 
-## 5.41.0 - 2021-11-16
+## <a id="5-41-0"></a>5.41.0 - 2021-11-16
 * [#1017](https://github.com/stripe/stripe-ruby/pull/1017) API Updates
   * Add support for new resource `ShippingRate`
 
-## 5.40.0 - 2021-11-11
-* [#1015](https://github.com/stripe/stripe-ruby/pull/1015) API Updates
-  * Add support for `expire` method on resource `Checkout.Session`
-* [#1013](https://github.com/stripe/stripe-ruby/pull/1013) Add tests for child resources.
+## <a id="5-40-0"></a>5.40.0 - 2021-11-11
 * [#1012](https://github.com/stripe/stripe-ruby/pull/1012) Add tests for namespaced resources.
 * [#1011](https://github.com/stripe/stripe-ruby/pull/1011) codegen: 3 more files
+* [#1013](https://github.com/stripe/stripe-ruby/pull/1013) Add tests for child resources.
+* [#1015](https://github.com/stripe/stripe-ruby/pull/1015) API Updates
+  * Add support for `expire` method on resource `Checkout.Session`
 
-## 5.39.0 - 2021-10-11
+## <a id="5-39-0"></a>5.39.0 - 2021-10-11
 * [#1010](https://github.com/stripe/stripe-ruby/pull/1010) API Updates
   * Add support for `list_payment_methods` method on resource `Customer`
 
-## 5.38.0 - 2021-08-10
-* [#993](https://github.com/stripe/stripe-ruby/pull/993) Add `request_id` to RequestEndEvent
-* [#991](https://github.com/stripe/stripe-ruby/pull/991) Codegen more files
+## <a id="5-38-0"></a>5.38.0 - 2021-08-10
 * [#989](https://github.com/stripe/stripe-ruby/pull/989) Remove unused API error types from docs.
+* [#991](https://github.com/stripe/stripe-ruby/pull/991) Codegen more files
+* [#993](https://github.com/stripe/stripe-ruby/pull/993) Add `request_id` to RequestEndEvent
 
-## 5.37.0 - 2021-07-14
+## <a id="5-37-0"></a>5.37.0 - 2021-07-14
 * [#988](https://github.com/stripe/stripe-ruby/pull/988) API Updates
   * Add support for `list_computed_upfront_line_items` method on resource `Quote`
 
-## 5.36.0 - 2021-07-09
+## <a id="5-36-0"></a>5.36.0 - 2021-07-09
 * [#987](https://github.com/stripe/stripe-ruby/pull/987) Add support for `Quote` API
 
-## 5.35.0 - 2021-06-30
-* [#985](https://github.com/stripe/stripe-ruby/pull/985) Update normalize_opts to use dup instead of clone.
-* [#982](https://github.com/stripe/stripe-ruby/pull/982) Deprecate travis
+## <a id="5-35-0"></a>5.35.0 - 2021-06-30
 * [#983](https://github.com/stripe/stripe-ruby/pull/983) Add support for making a request and receiving the response as a stream.
+* [#982](https://github.com/stripe/stripe-ruby/pull/982) Deprecate travis
+* [#985](https://github.com/stripe/stripe-ruby/pull/985) Update normalize_opts to use dup instead of clone.
 
-## 5.34.0 - 2021-06-04
+## <a id="5-34-0"></a>5.34.0 - 2021-06-04
 * [#981](https://github.com/stripe/stripe-ruby/pull/981) API Updates
   * Add support for `TaxCode` API.
 
-## 5.33.0 - 2021-05-19
+## <a id="5-33-0"></a>5.33.0 - 2021-05-19
 * [#979](https://github.com/stripe/stripe-ruby/pull/979) Add support for the Identify VerificationSession and VerificationReport APIs
 
-## 5.32.1 - 2021-04-05
+## <a id="5-32-1"></a>5.32.1 - 2021-04-05
 * Correct use of regexp `match` in gemspec for old versions of Ruby
 
-## 5.32.0 - 2021-04-05
+## <a id="5-32-0"></a>5.32.0 - 2021-04-05
 * [#973](https://github.com/stripe/stripe-ruby/pull/973) Reduce packed gem size
 
-## 5.31.0 - 2021-04-02
+## <a id="5-31-0"></a>5.31.0 - 2021-04-02
+* [#967](https://github.com/stripe/stripe-ruby/pull/967) CI: github actions
 * [#968](https://github.com/stripe/stripe-ruby/pull/968) Allow StripeClient to be configured per instance
 * [#971](https://github.com/stripe/stripe-ruby/pull/971) On config change, only clear connection managers for changed config
 * [#972](https://github.com/stripe/stripe-ruby/pull/972) Rename `Stripe.configuration` to `Stripe.config`
 * [#970](https://github.com/stripe/stripe-ruby/pull/970) Reserve some critical field names when adding `StripeObject` accessors
-* [#967](https://github.com/stripe/stripe-ruby/pull/967) CI: github actions
 
-## 5.30.0 - 2021-02-22
+## <a id="5-30-0"></a>5.30.0 - 2021-02-22
 * [#965](https://github.com/stripe/stripe-ruby/pull/965) Add support for the Billing Portal Configuration API
 
-## 5.29.1 - 2021-02-09
+## <a id="5-29-1"></a>5.29.1 - 2021-02-09
 * [#964](https://github.com/stripe/stripe-ruby/pull/964) Fix return value of `Customer#delete_discount`
 
-## 5.29.0 - 2021-01-05
+## <a id="5-29-0"></a>5.29.0 - 2021-01-05
 * [#952](https://github.com/stripe/stripe-ruby/pull/952) Allow client_id configuration on instance config
 
-## 5.28.0 - 2020-10-14
+## <a id="5-28-0"></a>5.28.0 - 2020-10-14
 * [#950](https://github.com/stripe/stripe-ruby/pull/950) Add configuration option for `write_timeout` for connections on Ruby 2.6+
 
-## 5.27.0 - 2020-10-14
+## <a id="5-27-0"></a>5.27.0 - 2020-10-14
 * [#951](https://github.com/stripe/stripe-ruby/pull/951) Add support for the Payout Reverse API
 
-## 5.26.0 - 2020-09-29
+## <a id="5-26-0"></a>5.26.0 - 2020-09-29
 * [#949](https://github.com/stripe/stripe-ruby/pull/949) Add support for the `SetupAttempt` resource and List API
 
-## 5.25.0 - 2020-09-02
+## <a id="5-25-0"></a>5.25.0 - 2020-09-02
+This release changes the pinned API version to `2020-08-27`.
+
 * [#944](https://github.com/stripe/stripe-ruby/pull/944) Add support for the Issuing Dispute Submit API
 
-## 5.24.0 - 2020-08-26
-* [#939](https://github.com/stripe/stripe-ruby/pull/939) Extract configurations into separate object
+## <a id="5-24-0"></a>5.24.0 - 2020-08-26
 * [#940](https://github.com/stripe/stripe-ruby/pull/940) Fix typo in documentation of `stripe_object.rb`
+* [#939](https://github.com/stripe/stripe-ruby/pull/939) Extract configurations into separate object
 
-## 5.23.1 - 2020-08-05
+## <a id="5-23-1"></a>5.23.1 - 2020-08-05
 * [#936](https://github.com/stripe/stripe-ruby/pull/936) Rename API resource's `request` method
 
-## 5.23.0 - 2020-08-05
+## <a id="5-23-0"></a>5.23.0 - 2020-08-05
 * [#937](https://github.com/stripe/stripe-ruby/pull/937) Add support for the `PromotionCode` resource and APIs
 
-## 5.22.0 - 2020-05-11
+## <a id="5-22-0"></a>5.22.0 - 2020-05-11
 * [#918](https://github.com/stripe/stripe-ruby/pull/918) Add support for the `LineItem` resource and APIs
 
-## 5.21.0 - 2020-04-29
+## <a id="5-21-0"></a>5.21.0 - 2020-04-29
 * [#917](https://github.com/stripe/stripe-ruby/pull/917) Add support for the `Price` resource and APIs
 
-## 5.20.0 - 2020-04-27
+## <a id="5-20-0"></a>5.20.0 - 2020-04-27
 * [#916](https://github.com/stripe/stripe-ruby/pull/916) Add new `.generate_header` method for webhooks
 
-## 5.19.0 - 2020-04-24
+## <a id="5-19-0"></a>5.19.0 - 2020-04-24
 * [#915](https://github.com/stripe/stripe-ruby/pull/915) Expose `Stripe::Webhook.compute_signature` publicly
 
-## 5.18.0 - 2020-04-22
+## <a id="5-18-0"></a>5.18.0 - 2020-04-22
 * [#911](https://github.com/stripe/stripe-ruby/pull/911) Add support for `BillingPortal` namespace and `Session` resource and APIs
 
-## 5.17.0 - 2020-02-26
+## <a id="5-17-0"></a>5.17.0 - 2020-02-26
 * [#907](https://github.com/stripe/stripe-ruby/pull/907) Add `StripeError#idempotent_replayed?`
 
-## 5.16.0 - 2020-02-26
-* [#906](https://github.com/stripe/stripe-ruby/pull/906) Add support for listing Checkout sessions
+## <a id="5-16-0"></a>5.16.0 - 2020-02-26
 * [#903](https://github.com/stripe/stripe-ruby/pull/903) Upgrade to Rubocop 0.80
+* [#906](https://github.com/stripe/stripe-ruby/pull/906) Add support for listing Checkout sessions
 
-## 5.15.0 - 2020-02-10
+## <a id="5-15-0"></a>5.15.0 - 2020-02-10
 * [#902](https://github.com/stripe/stripe-ruby/pull/902) Add `request_begin` instrumentation callback
 
-## 5.14.0 - 2020-01-14
-* [#896](https://github.com/stripe/stripe-ruby/pull/896) Add support for `CreditNoteLineItem`
+## <a id="5-14-0"></a>5.14.0 - 2020-01-14
+* [#893](https://github.com/stripe/stripe-ruby/pull/893) Upgrade Rubocop to 0.79
 * [#894](https://github.com/stripe/stripe-ruby/pull/894) Clean up test output by capturing `$stderr` when we expect warnings
 * [#892](https://github.com/stripe/stripe-ruby/pull/892) Explicitly pass a parameter as hash to be more ruby 2.7 friendly
-* [#893](https://github.com/stripe/stripe-ruby/pull/893) Upgrade Rubocop to 0.79
+* [#896](https://github.com/stripe/stripe-ruby/pull/896) Add support for `CreditNoteLineItem`
 
-## 5.13.0 - 2020-01-08
+## <a id="5-13-0"></a>5.13.0 - 2020-01-08
 * [#891](https://github.com/stripe/stripe-ruby/pull/891) Fix most Ruby 2.7 warnings
 
-## 5.12.1 - 2020-01-06
+## <a id="5-12-1"></a>5.12.1 - 2020-01-06
 * [#890](https://github.com/stripe/stripe-ruby/pull/890) Override API key with `client_secret` in `OAuth.token`
 
-## 5.12.0 - 2020-01-02
+## <a id="5-12-0"></a>5.12.0 - 2020-01-02
 * [#889](https://github.com/stripe/stripe-ruby/pull/889) Add support for retrieve source transaction API method
 
-## 5.11.0 - 2019-11-26
+## <a id="5-11-0"></a>5.11.0 - 2019-11-26
 * [#885](https://github.com/stripe/stripe-ruby/pull/885) Add support for `CreditNote` preview
 
-## 5.10.0 - 2019-11-08
+## <a id="5-10-0"></a>5.10.0 - 2019-11-08
 * [#882](https://github.com/stripe/stripe-ruby/pull/882) Add list_usage_record_summaries and list_source_transactions
 
-## 5.9.0 - 2019-11-07
+## <a id="5-9-0"></a>5.9.0 - 2019-11-07
 * [#870](https://github.com/stripe/stripe-ruby/pull/870) Add request instrumentation callback (see `README.md` for usage example)
 
-## 5.8.0 - 2019-11-05
-* [#879](https://github.com/stripe/stripe-ruby/pull/879) Add support for `Mandate`
-* [#876](https://github.com/stripe/stripe-ruby/pull/876) Add additional per-request configuration documentation
-* [#874](https://github.com/stripe/stripe-ruby/pull/874) Raise an error when requests params are invalid
+## <a id="5-8-0"></a>5.8.0 - 2019-11-05
 * [#873](https://github.com/stripe/stripe-ruby/pull/873) Contributor Covenant
+* [#874](https://github.com/stripe/stripe-ruby/pull/874) Raise an error when requests params are invalid
+* [#876](https://github.com/stripe/stripe-ruby/pull/876) Add additional per-request configuration documentation
+* [#879](https://github.com/stripe/stripe-ruby/pull/879) Add support for `Mandate`
 
-## 5.7.1 - 2019-10-15
+## <a id="5-7-1"></a>5.7.1 - 2019-10-15
 * [#869](https://github.com/stripe/stripe-ruby/pull/869) Fixes the misnamed `connection_base=` setter to be named `connect_base=`
 
-## 5.7.0 - 2019-10-10
+## <a id="5-7-0"></a>5.7.0 - 2019-10-10
 * [#865](https://github.com/stripe/stripe-ruby/pull/865) Support backwards pagination with list's `#auto_paging_each`
 
-## 5.6.0 - 2019-10-04
+## <a id="5-6-0"></a>5.6.0 - 2019-10-04
 * [#861](https://github.com/stripe/stripe-ruby/pull/861) Nicer error when specifying non-nil non-string opt value
 
-## 5.5.0 - 2019-10-03
+## <a id="5-5-0"></a>5.5.0 - 2019-10-03
 * [#859](https://github.com/stripe/stripe-ruby/pull/859) User-friendly messages and retries for `EOFError`, `Errno::ECONNRESET`, `Errno::ETIMEDOUT`, and `Errno::EHOSTUNREACH` network errors
 
-## 5.4.1 - 2019-10-01
+## <a id="5-4-1"></a>5.4.1 - 2019-10-01
 * [#858](https://github.com/stripe/stripe-ruby/pull/858) Drop Timecop dependency
 
-## 5.4.0 - 2019-10-01
+## <a id="5-4-0"></a>5.4.0 - 2019-10-01
 * [#857](https://github.com/stripe/stripe-ruby/pull/857) Move to monotonic time for duration calculations
 
-## 5.3.0 - 2019-10-01
+## <a id="5-3-0"></a>5.3.0 - 2019-10-01
 * [#853](https://github.com/stripe/stripe-ruby/pull/853) Support `Stripe-Should-Retry` header
 
-## 5.2.0 - 2019-09-19
+## <a id="5-2-0"></a>5.2.0 - 2019-09-19
 * [#851](https://github.com/stripe/stripe-ruby/pull/851) Introduce system for garbage collecting connection managers
 
-## 5.1.1 - 2019-09-04
+## <a id="5-1-1"></a>5.1.1 - 2019-09-04
 * [#845](https://github.com/stripe/stripe-ruby/pull/845) Transfer the request_id from the http_headers to error.
 
-## 5.1.0 - 2019-08-27
+## <a id="5-1-0"></a>5.1.0 - 2019-08-27
 * [#841](https://github.com/stripe/stripe-ruby/pull/841) Retry requests on a 429 that's a lock timeout
 
-## 5.0.1 - 2019-08-20
+## <a id="5-0-1"></a>5.0.1 - 2019-08-20
 * [#836](https://github.com/stripe/stripe-ruby/pull/836) Increase connection keep alive timeout to 30 seconds
 
-## 5.0.0 - 2019-08-20
+## <a id="5-0-0"></a>5.0.0 - 2019-08-20
 Major version release. The [migration guide](https://github.com/stripe/stripe-ruby/wiki/Migration-guide-for-v5) contains a detailed list of backwards-incompatible changes with upgrade instructions.
 
 Pull requests included in this release (cf. [#815](https://github.com/stripe/stripe-ruby/pull/815)) (⚠️ = breaking changes):
-* ⚠️ [#813](https://github.com/stripe/stripe-ruby/pull/813): Convert library to use built-in `Net::HTTP`
-* ⚠️ [#816](https://github.com/stripe/stripe-ruby/pull/816): Make `code` argument in `CardError` named instead of positional.
-* ⚠️ [#817](https://github.com/stripe/stripe-ruby/pull/817): Drop support for very old Ruby versions.
-* [#818](https://github.com/stripe/stripe-ruby/pull/818): Bump Rubocop to latest version
-* [#819](https://github.com/stripe/stripe-ruby/pull/819): Ruby minimum version increase followup
-* ⚠️ [#820](https://github.com/stripe/stripe-ruby/pull/820): Remove old deprecated methods
-* ⚠️ [#823](https://github.com/stripe/stripe-ruby/pull/823): Remove all alias for list methods
-* ⚠️ [#826](https://github.com/stripe/stripe-ruby/pull/826): Remove `UsageRecord.create` method
-* ⚠️ [#827](https://github.com/stripe/stripe-ruby/pull/827): Remove `IssuerFraudRecord`
-* [#811](https://github.com/stripe/stripe-ruby/pull/811): Add `ErrorObject` to `StripeError` exceptions
-* [#828](https://github.com/stripe/stripe-ruby/pull/828): Tweak retry logic to be a little more like stripe-node
-* [#829](https://github.com/stripe/stripe-ruby/pull/829): Reset connections when connection-changing configuration changes (optional)
-* [#830](https://github.com/stripe/stripe-ruby/pull/830): Fix inverted sign for 500 retries
-* ⚠️[#831](https://github.com/stripe/stripe-ruby/pull/831): Remove a few more very old deprecated methods
-* [#832](https://github.com/stripe/stripe-ruby/pull/832): Minor cleanup in `StripeClient`
-* [#833](https://github.com/stripe/stripe-ruby/pull/833): Do better bookkeeping when tracking state in `Thread.current`
-* [#834](https://github.com/stripe/stripe-ruby/pull/834): Add `Invoice.list_upcoming_line_items` method
-
-## 4.24.0 - 2019-08-12
+
+* ⚠️ [#813](https://github.com/stripe/stripe-ruby/pull/813) Convert library to use built-in `Net::HTTP`
+* ⚠️ [#817](https://github.com/stripe/stripe-ruby/pull/817) Drop support for very old Ruby versions.
+* [#818](https://github.com/stripe/stripe-ruby/pull/818) Bump Rubocop to latest version
+* ⚠️ [#816](https://github.com/stripe/stripe-ruby/pull/816) Make `code` argument in `CardError` named instead of positional.
+* [#819](https://github.com/stripe/stripe-ruby/pull/819) Ruby minimum version increase followup
+* ⚠️ [#823](https://github.com/stripe/stripe-ruby/pull/823) Remove all alias for list methods
+* ⚠️ [#820](https://github.com/stripe/stripe-ruby/pull/820) Remove old deprecated methods
+* ⚠️ [#826](https://github.com/stripe/stripe-ruby/pull/826) Remove `UsageRecord.create` method
+* ⚠️ [#827](https://github.com/stripe/stripe-ruby/pull/827) Remove `IssuerFraudRecord`
+* [#828](https://github.com/stripe/stripe-ruby/pull/828) Tweak retry logic to be a little more like stripe-node
+* [#811](https://github.com/stripe/stripe-ruby/pull/811) Add `ErrorObject` to `StripeError` exceptions
+* [#830](https://github.com/stripe/stripe-ruby/pull/830) Fix inverted sign for 500 retries
+* ⚠️ [#831](https://github.com/stripe/stripe-ruby/pull/831) Remove a few more very old deprecated methods
+* [#832](https://github.com/stripe/stripe-ruby/pull/832) Minor cleanup in `StripeClient`
+* [#829](https://github.com/stripe/stripe-ruby/pull/829) Reset connections when connection-changing configuration changes (optional)
+* [#833](https://github.com/stripe/stripe-ruby/pull/833) Do better bookkeeping when tracking state in `Thread.current`
+* [#834](https://github.com/stripe/stripe-ruby/pull/834) Add `Invoice.list_upcoming_line_items` method
+
+## <a id="4-24-0"></a>4.24.0 - 2019-08-12
 * [#825](https://github.com/stripe/stripe-ruby/pull/825) Add `SubscriptionItem.create_usage_record` method
   - This release also removed the `SubscriptionSchedule.revisions` method. This should have been included in the previous release (4.23.0)
 
-## 4.23.0 - 2019-08-09
+## <a id="4-23-0"></a>4.23.0 - 2019-08-09
 * [#824](https://github.com/stripe/stripe-ruby/pull/824) Remove SubscriptionScheduleRevision
   - This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
 
-## 4.22.1 - 2019-08-09
+## <a id="4-22-1"></a>4.22.1 - 2019-08-09
 * [#808](https://github.com/stripe/stripe-ruby/pull/808) Unify request/response handling
 
-## 4.22.0 - 2019-07-30
+## <a id="4-22-0"></a>4.22.0 - 2019-07-30
 * [#821](https://github.com/stripe/stripe-ruby/pull/821) Listing `BalanceTransaction` objects now uses `/v1/balance_transactions` instead of `/v1/balance/history`
 
-## 4.21.3 - 2019-07-15
+## <a id="4-21-3"></a>4.21.3 - 2019-07-15
 * [#810](https://github.com/stripe/stripe-ruby/pull/810) Better error message when passing non-string to custom method
 
-## 4.21.2 - 2019-07-05
+## <a id="4-21-2"></a>4.21.2 - 2019-07-05
 * [#806](https://github.com/stripe/stripe-ruby/pull/806) Revert back to `initialize_from` from `Util.convert_to_stripe_object`
 
-## 4.21.1 - 2019-07-04
+## <a id="4-21-1"></a>4.21.1 - 2019-07-04
 * [#807](https://github.com/stripe/stripe-ruby/pull/807) Add gem metadata
 
-## 4.21.0 - 2019-06-28
+## <a id="4-21-0"></a>4.21.0 - 2019-06-28
 * [#803](https://github.com/stripe/stripe-ruby/pull/803) Add support for the `SetupIntent` resource and APIs
 
-## 4.20.1 - 2019-06-28
+## <a id="4-20-1"></a>4.20.1 - 2019-06-28
 * [#805](https://github.com/stripe/stripe-ruby/pull/805) Fix formatting in `ConnectionFailed` error message
 
-## 4.20.0 - 2019-06-24
+## <a id="4-20-0"></a>4.20.0 - 2019-06-24
 * [#800](https://github.com/stripe/stripe-ruby/pull/800) Enable request latency telemetry by default
 
-## 4.19.0 - 2019-06-17
+## <a id="4-19-0"></a>4.19.0 - 2019-06-17
 * [#770](https://github.com/stripe/stripe-ruby/pull/770) Add support for `CustomerBalanceTransaction` resource and APIs
 
-## 4.18.1 - 2019-05-27
+## <a id="4-18-1"></a>4.18.1 - 2019-05-27
 * [#789](https://github.com/stripe/stripe-ruby/pull/789) Allow `Order#pay` to be called without arguments
 
-## 4.18.0 - 2019-05-23
+## <a id="4-18-0"></a>4.18.0 - 2019-05-23
 * [#783](https://github.com/stripe/stripe-ruby/pull/783) Add support for `radar.early_fraud_warning` resource
 
-## 4.17.0 - 2019-05-14
+## <a id="4-17-0"></a>4.17.0 - 2019-05-14
 * [#779](https://github.com/stripe/stripe-ruby/pull/779) Add support for the Capability resource and APIs
 
-## 4.16.0 - 2019-04-24
+## <a id="4-16-0"></a>4.16.0 - 2019-04-24
 * [#760](https://github.com/stripe/stripe-ruby/pull/760) Add support for the `TaxRate` resource and APIs
 
-## 4.15.0 - 2019-04-22
+## <a id="4-15-0"></a>4.15.0 - 2019-04-22
 * [#762](https://github.com/stripe/stripe-ruby/pull/762) Add support for the `TaxId` resource and APIs
 
-## 4.14.0 - 2019-04-18
+## <a id="4-14-0"></a>4.14.0 - 2019-04-18
 * [#758](https://github.com/stripe/stripe-ruby/pull/758) Add support for the `CreditNote` resource and APIs
 
-## 4.13.0 - 2019-04-16
+## <a id="4-13-0"></a>4.13.0 - 2019-04-16
 * [#766](https://github.com/stripe/stripe-ruby/pull/766) Relax constraints on objects that we'll accept as a file (now they just need to respond to `#read`)
 
-## 4.12.0 - 2019-04-02
-* [#752](https://github.com/stripe/stripe-ruby/pull/752) Add `.delete` class method on deletable API resources
+## <a id="4-12-0"></a>4.12.0 - 2019-04-02
 * [#754](https://github.com/stripe/stripe-ruby/pull/754) Add class methods for all custom API requests (e.g. `Charge.capture`)
+* [#752](https://github.com/stripe/stripe-ruby/pull/752) Add `.delete` class method on deletable API resources
 
-## 4.11.0 - 2019-03-26
+## <a id="4-11-0"></a>4.11.0 - 2019-03-26
 * [#753](https://github.com/stripe/stripe-ruby/pull/753) Add a global proxy configuration parameter
 
-## 4.10.0 - 2019-03-18
+## <a id="4-10-0"></a>4.10.0 - 2019-03-18
+* [#748](https://github.com/stripe/stripe-ruby/pull/748) Add support for deleting a Terminal `Location` and `Reader`
 * [#745](https://github.com/stripe/stripe-ruby/pull/745) Add support for the `PaymentMethod` resource and APIs
 * [#747](https://github.com/stripe/stripe-ruby/pull/747) Add support for retrieving a Checkout `Session`
-* [#748](https://github.com/stripe/stripe-ruby/pull/748) Add support for deleting a Terminal `Location` and `Reader`
 
-## 4.9.1 - 2019-03-18
+## <a id="4-9-1"></a>4.9.1 - 2019-03-18
 * [#750](https://github.com/stripe/stripe-ruby/pull/750) Catch error and warn if unable to remove a method
 
-## 4.9.0 - 2019-02-12
+## <a id="4-9-0"></a>4.9.0 - 2019-02-12
 * [#739](https://github.com/stripe/stripe-ruby/pull/739) Add support for `SubscriptionSchedule` and `SubscriptionScheduleRevision`
 
-## 4.8.1 - 2019-02-11
+## <a id="4-8-1"></a>4.8.1 - 2019-02-11
 * [#743](https://github.com/stripe/stripe-ruby/pull/743) Fix bug in file uploading introduced in #741
 
-## 4.8.0 - 2019-02-03
+## <a id="4-8-0"></a>4.8.0 - 2019-02-03
 * [#741](https://github.com/stripe/stripe-ruby/pull/741) Use `FaradayStripeEncoder` to encode all parameter styles
 
-## 4.7.1 - 2019-02-01
+## <a id="4-7-1"></a>4.7.1 - 2019-02-01
 * [#740](https://github.com/stripe/stripe-ruby/pull/740) Fix query encoding for integer-indexed maps
 
-## 4.7.0 - 2019-01-23
+## <a id="4-7-0"></a>4.7.0 - 2019-01-23
 * [#735](https://github.com/stripe/stripe-ruby/pull/735) Rename `CheckoutSession` to `Session` and move it under the `Checkout` namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.
 
-## 4.6.0 - 2019-01-21
+## <a id="4-6-0"></a>4.6.0 - 2019-01-21
 * [#736](https://github.com/stripe/stripe-ruby/pull/736) Properly serialize `individual` on `Account` objects
 
-## 4.5.0 - 2019-01-02
+## <a id="4-5-0"></a>4.5.0 - 2019-01-02
 * [#719](https://github.com/stripe/stripe-ruby/pull/719) Generate OAuth authorize URLs for Express accounts as well as standard
 
-## 4.4.1 - 2018-12-31
+## <a id="4-4-1"></a>4.4.1 - 2018-12-31
 * [#718](https://github.com/stripe/stripe-ruby/pull/718) Fix an error message typo
 
-## 4.4.0 - 2018-12-21
+## <a id="4-4-0"></a>4.4.0 - 2018-12-21
 * [#716](https://github.com/stripe/stripe-ruby/pull/716) Add support for the `CheckoutSession` resource
 
-## 4.3.0 - 2018-12-10
+## <a id="4-3-0"></a>4.3.0 - 2018-12-10
 * [#711](https://github.com/stripe/stripe-ruby/pull/711) Add support for account links
 
-## 4.2.0 - 2018-11-28
+## <a id="4-2-0"></a>4.2.0 - 2018-11-28
 * [#705](https://github.com/stripe/stripe-ruby/pull/705) Add support for the `Review` APIs
 
-## 4.1.0 - 2018-11-27
+## <a id="4-1-0"></a>4.1.0 - 2018-11-27
 * [#695](https://github.com/stripe/stripe-ruby/pull/695) Add support for `ValueList` and `ValueListItem` for Radar
 
-## 4.0.3 - 2018-11-19
+## <a id="4-0-3"></a>4.0.3 - 2018-11-19
 * [#703](https://github.com/stripe/stripe-ruby/pull/703) Don't use `Net::HTTP::Persistent` on Windows where it's not well supported
 
-## 4.0.2 - 2018-11-16
+## <a id="4-0-2"></a>4.0.2 - 2018-11-16
 * [#701](https://github.com/stripe/stripe-ruby/pull/701) Require minimum Faraday 0.13 for proper support of persistent connections
 
-## 4.0.1 - 2018-11-15
+## <a id="4-0-1"></a>4.0.1 - 2018-11-15
 * [#699](https://github.com/stripe/stripe-ruby/pull/699) Only send telemetry if `Request-Id` was present in the response
 
-## 4.0.0 - 2018-11-15
-* [#698](https://github.com/stripe/stripe-ruby/pull/698) Use persistent connections by default through `Net::HTTP::Persistent`
+## <a id="4-0-0"></a>4.0.0 - 2018-11-15
 * [#698](https://github.com/stripe/stripe-ruby/pull/698) Drop support for Ruby 2.0 (which we consider a breaking change here)
+* [#698](https://github.com/stripe/stripe-ruby/pull/698) Use persistent connections by default through `Net::HTTP::Persistent`
 
-## 3.31.1 - 2018-11-12
+## <a id="3-31-1"></a>3.31.1 - 2018-11-12
 * [#697](https://github.com/stripe/stripe-ruby/pull/697) Send telemetry in milliseconds specifically
 
-## 3.31.0 - 2018-11-12
+## <a id="3-31-0"></a>3.31.0 - 2018-11-12
 * [#696](https://github.com/stripe/stripe-ruby/pull/696) Add configurable telemetry to gather information on client-side request latency
 
-## 3.30.0 - 2018-11-08
+## <a id="3-30-0"></a>3.30.0 - 2018-11-08
 * [#693](https://github.com/stripe/stripe-ruby/pull/693) Add new API endpoints for the `Invoice` resource.
 
-## 3.29.0 - 2018-10-30
+## <a id="3-29-0"></a>3.29.0 - 2018-10-30
 * [#692](https://github.com/stripe/stripe-ruby/pull/692) Add support for the `Person` resource
 * [#694](https://github.com/stripe/stripe-ruby/pull/694) Add support for the `WebhookEndpoint` resource
 
-## 3.28.0 - 2018-09-24
+## <a id="3-28-0"></a>3.28.0 - 2018-09-24
 * [#690](https://github.com/stripe/stripe-ruby/pull/690) Add support for Stripe Terminal
 
-## 3.27.0 - 2018-09-24
+## <a id="3-27-0"></a>3.27.0 - 2018-09-24
 * [#689](https://github.com/stripe/stripe-ruby/pull/689) Rename `FileUpload` to `File`
 
-## 3.26.1 - 2018-09-14
+## <a id="3-26-1"></a>3.26.1 - 2018-09-14
 * [#688](https://github.com/stripe/stripe-ruby/pull/688) Fix hash equality on `StripeObject`
 
-## 3.26.0 - 2018-09-05
+## <a id="3-26-0"></a>3.26.0 - 2018-09-05
 * [#681](https://github.com/stripe/stripe-ruby/pull/681) Add support for reporting resources
 
-## 3.25.0 - 2018-08-28
+## <a id="3-25-0"></a>3.25.0 - 2018-08-28
 * [#678](https://github.com/stripe/stripe-ruby/pull/678) Allow payment intent `#cancel`, `#capture`, and `#confirm` to take their own parameters
 
-## 3.24.0 - 2018-08-27
+## <a id="3-24-0"></a>3.24.0 - 2018-08-27
 * [#675](https://github.com/stripe/stripe-ruby/pull/675) Remove support for `BitcoinReceiver` write-actions
 
-## 3.23.0 - 2018-08-23
+## <a id="3-23-0"></a>3.23.0 - 2018-08-23
 * [#676](https://github.com/stripe/stripe-ruby/pull/676) Add support for usage record summaries
 
-## 3.22.0 - 2018-08-15
+## <a id="3-22-0"></a>3.22.0 - 2018-08-15
 * [#674](https://github.com/stripe/stripe-ruby/pull/674) Use integer-indexed encoding for all arrays
 
-## 3.21.0 - 2018-08-03
+## <a id="3-21-0"></a>3.21.0 - 2018-08-03
 * [#671](https://github.com/stripe/stripe-ruby/pull/671) Add cancel support for topups
 
-## 3.20.0 - 2018-08-03
+## <a id="3-20-0"></a>3.20.0 - 2018-08-03
 * [#669](https://github.com/stripe/stripe-ruby/pull/669) Add support for file links
 
-## 3.19.0 - 2018-07-27
+## <a id="3-19-0"></a>3.19.0 - 2018-07-27
 * [#666](https://github.com/stripe/stripe-ruby/pull/666) Add support for scheduled query runs (`Stripe::Sigma::ScheduledQueryRun`) for Sigma
 
-## 3.18.0 - 2018-07-26
+## <a id="3-18-0"></a>3.18.0 - 2018-07-26
 * [#665](https://github.com/stripe/stripe-ruby/pull/665) Add support for Stripe Issuing
 
-## 3.17.2 - 2018-07-19
+## <a id="3-17-2"></a>3.17.2 - 2018-07-19
 * [#664](https://github.com/stripe/stripe-ruby/pull/664) Don't colorize log output being sent to a configured logger
 
-## 3.17.1 - 2018-07-19
+## <a id="3-17-1"></a>3.17.1 - 2018-07-19
 * [#663](https://github.com/stripe/stripe-ruby/pull/663) Internal improvements to `ApiResource.class_url`
 
-## 3.17.0 - 2018-06-28
+## <a id="3-17-0"></a>3.17.0 - 2018-06-28
 * [#658](https://github.com/stripe/stripe-ruby/pull/658) Add support for `partner_id` from `Stripe.set_app_info`
 
-## 3.16.0 - 2018-06-28
+## <a id="3-16-0"></a>3.16.0 - 2018-06-28
 * [#657](https://github.com/stripe/stripe-ruby/pull/657) Add support for payment intents
 
-## 3.15.0 - 2018-05-10
+## <a id="3-15-0"></a>3.15.0 - 2018-05-10
 * [#649](https://github.com/stripe/stripe-ruby/pull/649) Freeze all string literals
 
-## 3.14.0 - 2018-05-09
+## <a id="3-14-0"></a>3.14.0 - 2018-05-09
 * [#645](https://github.com/stripe/stripe-ruby/pull/645) Add support for issuer fraud records
 
-## 3.13.1 - 2018-05-07
+## <a id="3-13-1"></a>3.13.1 - 2018-05-07
 * [#647](https://github.com/stripe/stripe-ruby/pull/647) Merge query parameters coming from path with `params` argument
 
-## 3.13.0 - 2018-04-11
+## <a id="3-13-0"></a>3.13.0 - 2018-04-11
 * [#498](https://github.com/stripe/stripe-ruby/pull/498) Add support for flexible billing primitives
 
-## 3.12.1 - 2018-04-05
+## <a id="3-12-1"></a>3.12.1 - 2018-04-05
 * [#636](https://github.com/stripe/stripe-ruby/pull/636) Fix a warning for uninitialized instance variable `@additive_params`
 
-## 3.12.0 - 2018-04-05
+## <a id="3-12-0"></a>3.12.0 - 2018-04-05
 * [#632](https://github.com/stripe/stripe-ruby/pull/632) Introduce `additive_object_param` so that non-`metadata` subobjects don't zero their keys as they're being replaced
 
-## 3.11.0 - 2018-02-26
+## <a id="3-11-0"></a>3.11.0 - 2018-02-26
 * [#628](https://github.com/stripe/stripe-ruby/pull/628) Add support for `code` attribute on all Stripe exceptions
 
-## 3.10.0 - 2018-02-21
+## <a id="3-10-0"></a>3.10.0 - 2018-02-21
 * [#627](https://github.com/stripe/stripe-ruby/pull/627) Add support for topups
 
-## 3.9.2 - 2018-02-12
+## <a id="3-9-2"></a>3.9.2 - 2018-02-12
 * [#625](https://github.com/stripe/stripe-ruby/pull/625) Skip calling `to_hash` for `nil`
 
-## 3.9.1 - 2017-12-15
+## <a id="3-9-1"></a>3.9.1 - 2017-12-15
 * [#616](https://github.com/stripe/stripe-ruby/pull/616) Support all file-like objects for uploads with duck typed checks on `path` and `read` (we previously whitelisted only certain classes)
 
-## 3.9.0 - 2017-12-08
+## <a id="3-9-0"></a>3.9.0 - 2017-12-08
 * [#613](https://github.com/stripe/stripe-ruby/pull/613) Introduce new `IdempotencyError` type for idempotency-specific failures
 
-## 3.8.2 - 2017-12-07
+## <a id="3-8-2"></a>3.8.2 - 2017-12-07
 * [#612](https://github.com/stripe/stripe-ruby/pull/612) Fix integer-indexed array encoding when sent as query parameter (subscription items can now be used when fetching an upcoming invoice)
 
-## 3.8.1 - 2017-12-06
+## <a id="3-8-1"></a>3.8.1 - 2017-12-06
 * [#611](https://github.com/stripe/stripe-ruby/pull/611) Support `Tempfile` (as well as `File`) in file uploads
 
-## 3.8.0 - 2017-10-31
+## <a id="3-8-0"></a>3.8.0 - 2017-10-31
 * [#606](https://github.com/stripe/stripe-ruby/pull/606) Support for exchange rates APIs
 
-## 3.7.0 - 2017-10-26
+## <a id="3-7-0"></a>3.7.0 - 2017-10-26
 * [#603](https://github.com/stripe/stripe-ruby/pull/603) Support for listing source transactions
 
-## 3.6.0 - 2017-10-17
+## <a id="3-6-0"></a>3.6.0 - 2017-10-17
 * [#597](https://github.com/stripe/stripe-ruby/pull/597) Add static methods to manipulate resources from parent
-    * `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
-    * `ApplicationFee` gains methods for refunds
-    * `Customer` gains methods for sources
-    * `Transfer` gains methods for reversals
+  * `Account` gains methods for external accounts and login links (e.g. `.create_account`, `create_login_link`)
+  * `ApplicationFee` gains methods for refunds
+  * `Customer` gains methods for sources
+  * `Transfer` gains methods for reversals
 
-## 3.5.3 - 2017-10-16
-* [#594](https://github.com/stripe/stripe-ruby/pull/594) Make sure that `StripeObject`'s `#deep_copy` maintains original class
+## <a id="3-5-3"></a>3.5.3 - 2017-10-16
 * [#595](https://github.com/stripe/stripe-ruby/pull/595) Allow `Object#method` to be called on `StripeObject` even if it conflicts with an accessor
 * [#596](https://github.com/stripe/stripe-ruby/pull/596) Encode arrays as integer-indexed hashes where appropriate
+* [#594](https://github.com/stripe/stripe-ruby/pull/594) Make sure that `StripeObject`'s `#deep_copy` maintains original class
 * [#598](https://github.com/stripe/stripe-ruby/pull/598) Don't persist `idempotency_key` opt between requests
 
-## 3.5.2 - 2017-10-13
+## <a id="3-5-2"></a>3.5.2 - 2017-10-13
 * [#592](https://github.com/stripe/stripe-ruby/pull/592) Bring back `Marshal.dump/load` support with custom marshal encoder/decoder
 
-## 3.5.1 - 2017-10-12
+## <a id="3-5-1"></a>3.5.1 - 2017-10-12
 * [#591](https://github.com/stripe/stripe-ruby/pull/591) Use thread-local `StripeClient` instances for thread safety
 
-## 3.5.0 - 2017-10-11
+## <a id="3-5-0"></a>3.5.0 - 2017-10-11
 * [#589](https://github.com/stripe/stripe-ruby/pull/589) Rename source `delete` to `detach` (and deprecate the former)
 
-## 3.4.1 - 2017-10-05
+## <a id="3-4-1"></a>3.4.1 - 2017-10-05
 * [#586](https://github.com/stripe/stripe-ruby/pull/586) Log query strings as well as form bodies with STRIPE_LOG
 * [#588](https://github.com/stripe/stripe-ruby/pull/588) Require minimum Faraday 0.10 for bug fix in parameter encoding
 
-## 3.4.0 - 2017-09-20
+## <a id="3-4-0"></a>3.4.0 - 2017-09-20
 * Mark legacy Bitcoin API as deprecated, and remove corresponding tests
 * Mark recipients API as deprecated, and remove recipient card tests
 
-## 3.3.2 - 2017-09-20
+## <a id="3-3-2"></a>3.3.2 - 2017-09-20
 * Correct minimum required Ruby version in gemspec (it's 2.0.0)
 
-## 3.3.1 - 2017-08-18
+## <a id="3-3-1"></a>3.3.1 - 2017-08-18
 * Only parse webhook payload after verification to decrease likelihood of
   attack
 
-## 3.3.0 - 2017-08-11
+## <a id="3-3-0"></a>3.3.0 - 2017-08-11
 * Add support for standard library logger interface with `Stripe.logger`
 * Error logs now go to stderr if using `Stripe.log_level`/`STRIPE_LOG`
 * `Stripe.log_level`/`STRIPE_LOG` now support `Stipe::LEVEL_ERROR`
 
-## 3.2.0 - 2017-08-03
+## <a id="3-2-0"></a>3.2.0 - 2017-08-03
 * Add logging for request retry account and `Stripe-Account` header
 
-## 3.1.0 - 2017-08-03
+## <a id="3-1-0"></a>3.1.0 - 2017-08-03
 * Implement request logging with `Stripe.log_level` and `STRIPE_LOG`
 
-## 3.0.3 - 2017-07-28
-* Revert `nil` to empty string coercion from 3.0.2
+## <a id="3-0-3"></a>3.0.3 - 2017-07-28
 * Handle `invalid_client` OAuth error code
 * Improve safety of error handling logic safer for unrecognized OAuth error codes
+* Revert `nil` to empty string coercion from 3.0.2
 
-## 3.0.2 - 2017-07-12
+## <a id="3-0-2"></a>3.0.2 - 2017-07-12
 **Important:** This version is non-functional and has been yanked in favor of 3.0.3.
+
 * Convert `nil` to empty string when serializing parameters (instead of opaquely dropping it) -- NOTE: this change has since been reverted
 
-## 3.0.1 - 2017-07-11
-* Properties set with an API resource will now serialize that resource's ID if possible
+## <a id="3-0-1"></a>3.0.1 - 2017-07-11
 * API resources will throw an ArgumentError on save if a property has been with an API resource that cannot be serialized
+* Properties set with an API resource will now serialize that resource's ID if possible
 
-## 3.0.0 - 2017-06-27
+## <a id="3-0-0"></a>3.0.0 - 2017-06-27
 * `#pay` on invoice now takes params as well as opts
 
-## 2.12.0 - 2017-06-20
+## <a id="2-12-0"></a>2.12.0 - 2017-06-20
 * Add support for ephemeral keys
 
-## 2.11.0 - 2017-05-26
+## <a id="2-11-0"></a>2.11.0 - 2017-05-26
 * Warn when keys that look like opts are included as parameters
 
-## 2.10.0 - 2017-05-25
+## <a id="2-10-0"></a>2.10.0 - 2017-05-25
 * Add support for account login links
 
-## 2.9.0 - 2017-05-18
+## <a id="2-9-0"></a>2.9.0 - 2017-05-18
 * Support for OAuth operations in `Stripe::OAuth`
 
-## 2.8.0 - 2017-04-28
+## <a id="2-8-0"></a>2.8.0 - 2017-04-28
 * Support for checking webhook signatures
 
-## 2.7.0 - 2017-04-26
+## <a id="2-7-0"></a>2.7.0 - 2017-04-26
 * Add model `InvoiceLineItem`
 
-## 2.6.0 - 2017-04-26
+## <a id="2-6-0"></a>2.6.0 - 2017-04-26
 * Add `OBJECT_NAME` constants to all API resources
 
-## 2.5.0 - 2017-04-24
+## <a id="2-5-0"></a>2.5.0 - 2017-04-24
 * Make `opts` argument in `Util.convert_to_stripe_object` optional
 
-## 2.4.0 - 2017-04-18
+## <a id="2-4-0"></a>2.4.0 - 2017-04-18
 * Add `Stripe.set_app_info` for use by plugin creators
 
-## 2.3.0 - 2017-04-14
+## <a id="2-3-0"></a>2.3.0 - 2017-04-14
 * Add question mark accessor when assigning boolean value to undefined field
 
-## 2.2.1 - 2017-04-07
+## <a id="2-2-1"></a>2.2.1 - 2017-04-07
 * Declare minimum required Faraday as 0.9
 
-## 2.2.0 - 2017-04-06
+## <a id="2-2-0"></a>2.2.0 - 2017-04-06
 * Add support for payouts and recipient transfers
 
-## 2.1.0 - 2017-03-17
+## <a id="2-1-0"></a>2.1.0 - 2017-03-17
 * Support for detaching sources from customers
 
-## 2.0.3 - 2017-03-16
+## <a id="2-0-3"></a>2.0.3 - 2017-03-16
 * Fix marshalling of `StripeObjects` that have an embedded client
 
-## 2.0.2 - 2017-03-16
+## <a id="2-0-2"></a>2.0.2 - 2017-03-16
 * Fix bad field reference when recovering from a JSON parsing problem
 
-## 2.0.1 - 2017-02-22
+## <a id="2-0-1"></a>2.0.1 - 2017-02-22
 * Fix multipart parameter encoding to repair broken file uploads
 
-## 2.0.0 - 2017-02-14
-* Drop support for Ruby 1.9
+## <a id="2-0-0"></a>2.0.0 - 2017-02-14
 * Allow HTTP client that makes Stripe calls to be configured via Faraday
 * Drop RestClient
+* Drop support for Ruby 1.9
 * Switch to OpenAPI 2.0 spec and generated fixtures in test suite
 * Switch to Webmock in test suite
 
-## 1.58.0 - 2017-01-19
+## <a id="1-58-0"></a>1.58.0 - 2017-01-19
 * Remove erroneously added list methods for `Source` model
 
-## 1.57.1 - 2016-11-28
+## <a id="1-57-1"></a>1.57.1 - 2016-11-28
 * Disallow sending protected fields along with API resource `.update`
 
-## 1.57.0 - 2016-11-21
+## <a id="1-57-0"></a>1.57.0 - 2016-11-21
 * Add retrieve method for 3-D Secure resources
 
-## 1.56.2 - 2016-11-17
+## <a id="1-56-2"></a>1.56.2 - 2016-11-17
 * Improve `StripeObject`'s `#to_s` to better handle how embedded objects are displayed
 
-## 1.56.1 - 2016-11-09
+## <a id="1-56-1"></a>1.56.1 - 2016-11-09
 * Fix (fairly serious) memory like in `StripeObject`
 
-## 1.56.0 - 2016-10-24
+## <a id="1-56-0"></a>1.56.0 - 2016-10-24
 * Add accessors for new fields added in `#update_attributes`
-* Handle multi-plan subscriptions through new subscription items
 * Handle 403 status codes from the API
+* Handle multi-plan subscriptions through new subscription items
 
-## 1.55.1 - 2016-10-24
+## <a id="1-55-1"></a>1.55.1 - 2016-10-24
 Identical to 1.56.0 above. I incorrectly cut a patch-level release.
 
-## 1.55.0 - 2016-09-15
+## <a id="1-55-0"></a>1.55.0 - 2016-09-15
 * Add support for Apple Pay domains
 
-## 1.54.0 - 2016-09-01
+## <a id="1-54-0"></a>1.54.0 - 2016-09-01
 * Whitelist errors that should be retried; scope to known socket and HTTP errors
 
-## 1.53.0 - 2016-08-31
+## <a id="1-53-0"></a>1.53.0 - 2016-08-31
 * Relax version constraint on rest-client (and by extension mime-types) for users on Ruby 2+
 
-## 1.52.0 - 2016-08-30
+## <a id="1-52-0"></a>1.52.0 - 2016-08-30
 * Make sure `Subscription`'s `source` is saved with its parent
 
-## 1.51.1 - 2016-08-30
+## <a id="1-51-1"></a>1.51.1 - 2016-08-30
 * Make sure `Account`'s `external_account` is saved with its parent
 
-## 1.51.0 - 2016-08-26
+## <a id="1-51-0"></a>1.51.0 - 2016-08-26
 * Error when an array of maps is detected that cannot be accurately encoded
 * Start using strings for header names instead of symbols for better clarity
 
-## 1.50.1 - 2016-08-25
+## <a id="1-50-1"></a>1.50.1 - 2016-08-25
 * Fix encoding of arrays of maps where maps unequal sets of keys
 
-## 1.50.0 - 2016-08-15
+## <a id="1-50-0"></a>1.50.0 - 2016-08-15
 * Allow sources to be created
 
-## 1.49.0 - 2016-07-28
+## <a id="1-49-0"></a>1.49.0 - 2016-07-28
 * Add top-level `Source` model
 
-## 1.48.0 - 2016-07-12
+## <a id="1-48-0"></a>1.48.0 - 2016-07-12
 * Add `ThreeDSecure` model for 3-D secure payments
 
-## 1.47.0 - 2016-07-11
+## <a id="1-47-0"></a>1.47.0 - 2016-07-11
 * Allow rest-client version 2.0+ to be used with the gem
 
-## 1.46.0 - 2016-07-07
+## <a id="1-46-0"></a>1.46.0 - 2016-07-07
 * Allow retry when a 409 conflict is encountered
 
-## 1.45.0 - 2016-07-07
+## <a id="1-45-0"></a>1.45.0 - 2016-07-07
 * Do not send subresources when updating except when explicitly told to do so (see #433)
 
-## 1.44.0 - 2016-06-29
+## <a id="1-44-0"></a>1.44.0 - 2016-06-29
 * Add `update` class method to all resources that can be updated
 
-## 1.43.1 - 2016-06-17
+## <a id="1-43-1"></a>1.43.1 - 2016-06-17
 * Fix type of resource returned from `Order#return_order`
 
-## 1.43.0 - 2016-05-20
+## <a id="1-43-0"></a>1.43.0 - 2016-05-20
 * Allow Relay orders to be returned and add associated types
 * Support Alipay account retrieval and deletion
 
-## 1.42.0 - 2016-05-04
+## <a id="1-42-0"></a>1.42.0 - 2016-05-04
 * Add support for the new /v1/subscriptions endpoint (retrieve, list, create, update, and delete)
 
-## 1.41.0 - 2016-04-13
+## <a id="1-41-0"></a>1.41.0 - 2016-04-13
 * Add global `stripe_account` option that adds a `Stripe-Account` header to all requests
 
-## 1.40.0 - 2016-04-06
+## <a id="1-40-0"></a>1.40.0 - 2016-04-06
 * Fix bug that omitted subresources from serialization
 
-## 1.39.0 - 2016-03-31
+## <a id="1-39-0"></a>1.39.0 - 2016-03-31
 * Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
 
-## 1.38.0 - 2016-03-18
+## <a id="1-38-0"></a>1.38.0 - 2016-03-18
 * Allow `opts` to be passed to an API resource's `#save` method
 
-## 1.37.0 - 2016-03-14
+## <a id="1-37-0"></a>1.37.0 - 2016-03-14
 * Add `Account#reject` to support the new API feature
 
-## 1.36.2 - 2016-03-14
+## <a id="1-36-2"></a>1.36.2 - 2016-03-14
 * Fix reference to non-existent `#url` in `ListObject`
 
-## 1.36.1 - 2016-03-04
+## <a id="1-36-1"></a>1.36.1 - 2016-03-04
 * Fix serialization when subhash given to `#save` or `#update_attributes`
 
-## 1.36.0 - 2016-02-08
+## <a id="1-36-0"></a>1.36.0 - 2016-02-08
 * Add `CountrySpec` model for looking up country payment information
 
-## 1.35.1 - 2016-02-03
+## <a id="1-35-1"></a>1.35.1 - 2016-02-03
 * Add compatibility layer for old API versions on `Charge#refund`
 
-## 1.35.0 - 2016-02-01
+## <a id="1-35-0"></a>1.35.0 - 2016-02-01
 * Allow CA cert bundle location to be configured
 * Updated bundled CA certs
 
-## 1.34.0 - 2016-01-25
+## <a id="1-34-0"></a>1.34.0 - 2016-01-25
 * Add support for deleting products and SKUs
 
-## 1.33.1 - 2016-01-21
+## <a id="1-33-1"></a>1.33.1 - 2016-01-21
 * Pass through arguments of `Charge#refund`
 
-## 1.33.0 - 2016-01-19
+## <a id="1-33-0"></a>1.33.0 - 2016-01-19
 * Re-implement `Charge#refund` helper to use the modern endpoint suggested by docs
 
-## 1.32.1 - 2016-01-07
+## <a id="1-32-1"></a>1.32.1 - 2016-01-07
 * Fix bug where ivar left uninitialized in StripeObject could error on serialization
 * Fix bug where a nil customer from API could error Bitcoin model on refresh
 
-## 1.32.0 - 2016-01-05
+## <a id="1-32-0"></a>1.32.0 - 2016-01-05
 * Add configuration to optionally retry network failures
 * Use modern API endpoint for producing application fee refunds
 
-## 1.31.0 - 2015-10-29
+## <a id="1-31-0"></a>1.31.0 - 2015-10-29
 * Add BankAccount#verify convenience method
 
-## 1.30.3 - 2015-10-28
+## <a id="1-30-3"></a>1.30.3 - 2015-10-28
 * Fix bug where arrays that were not `additional_owners` were not properly encoded for requests
 
-## 1.30.2 - 2015-10-12
+## <a id="1-30-2"></a>1.30.2 - 2015-10-12
 * Fix bug where `opts` didn't properly propagate to descendant `StripeObjects`
 
-## 1.30.1 - 2015-10-10
+## <a id="1-30-1"></a>1.30.1 - 2015-10-10
 * Fix bug that prevent lists of hashes from being URI-encoded properly
 * Fix bug where filter conditions were not making it past the first instantiated `ListObject`
 
-## 1.30.0 - 2015-10-09
+## <a id="1-30-0"></a>1.30.0 - 2015-10-09
 * Add `StripeObject#deleted?` for a reliable way to check whether an object is alive
 * Deprecate `StripeObject#refresh_from`
 * New parameter encoding scheme that doesn't use `URI.escape`
 
-## 1.29.1 - 2015-10-06
+## <a id="1-29-1"></a>1.29.1 - 2015-10-06
 * Fix bug where ampersands were not being properly encoded
 
-## 1.29.0 - 2015-10-05
+## <a id="1-29-0"></a>1.29.0 - 2015-10-05
 * Add pagination helpers `#auto_paging_each`, `#previous_page`, and `#next_page`
 
-## 1.28.1 - 2015-10-05
+## <a id="1-28-1"></a>1.28.1 - 2015-10-05
 * Fix URI being referenced by file upload resources
 
-## 1.28.0 - 2015-10-05
-* Make StripeObject's #save "upsert"-like; creates an object if new
-* Add #update_attributes to StripeObject for safe mass assignment
-* Properly mass assign attributes on calls to #save
+## <a id="1-28-0"></a>1.28.0 - 2015-10-05
 * Add question mark helpers for boolean fields (e.g. #paid? as well as old #paid)
+* Add #update_attributes to StripeObject for safe mass assignment
 * Fix a bug that broke the API for StripeObject initialization
+* Make StripeObject's #save "upsert"-like; creates an object if new
+* Properly mass assign attributes on calls to #save
 * Remove use of deprecated URI.escape
 
-## 1.27.2 - 2015-09-25
+## <a id="1-27-2"></a>1.27.2 - 2015-09-25
 * Correct the URLs used to fetch Bitcoin transactions.
 
-## 1.27.1 - 2015-09-20
+## <a id="1-27-1"></a>1.27.1 - 2015-09-20
 * Use hash rockets for backwards compatibility.
 
-## 1.27.0 - 2015-09-14
+## <a id="1-27-0"></a>1.27.0 - 2015-09-14
 * Add Orders, Products, and SKUs for Relay
 
-## 1.26.0 - 2015-09-11
+## <a id="1-26-0"></a>1.26.0 - 2015-09-11
 * Add support for 429 Rate Limited response
 
-## 1.25.0 - 2015-08-17
+## <a id="1-25-0"></a>1.25.0 - 2015-08-17
 * Added support for refund listing and retrieval without an associated charge
 
-## 1.24.0 - 2015-08-03
+## <a id="1-24-0"></a>1.24.0 - 2015-08-03
 * Added support for deleting managed accounts
 * Added support for dispute listing and retrieval
 * Bugfix: token objects now are the correct class
 
-## 1.23.0 - 2015-07-06
+## <a id="1-23-0"></a>1.23.0 - 2015-07-06
 * Added request IDs and HTTP headers to errors
 
-## 1.22.0 - 2015-06-10
+## <a id="1-22-0"></a>1.22.0 - 2015-06-10
 * Added support for bank accounts and debit cards in managed accounts (via the `external_accounts` param)
 
-## 1.21.0 - 2015-04-14
-* Remove TLS cert revocation check (all pre-heartbleed certs have expired)
+## <a id="1-21-0"></a>1.21.0 - 2015-04-14
 * Bugfix: don't unset keys when they don't exist on StripeObject
+* Remove TLS cert revocation check (all pre-heartbleed certs have expired)
 
-## 1.20.4 - 2015-03-26
-* Raise an error when explicitly passing nil as the API key on resource methods
+## <a id="1-20-4"></a>1.20.4 - 2015-03-26
 * Fix error when passing an API key to Balance.retrieve (github issue #232)
+* Raise an error when explicitly passing nil as the API key on resource methods
 
-## 1.20.3 - 2015-03-13
+## <a id="1-20-3"></a>1.20.3 - 2015-03-13
 * Fixed error when updating certain resources (github issue #224)
 
-## 1.20.2 - 2015-03-10
+## <a id="1-20-2"></a>1.20.2 - 2015-03-10
 * Added support for updating nested hashes besides `metadata` (which was already supported)
 * Fixed bug in balance retrieval
 
-## 1.20.1 - 2015-02-26
+## <a id="1-20-1"></a>1.20.1 - 2015-02-26
 * Updated Card to point to customer sources endpoint when customer property is set
 
-## 1.20.0 - 2015-02-19
+## <a id="1-20-0"></a>1.20.0 - 2015-02-19
 * Added Update & Delete operations to Bitcoin Receivers
 
-## 1.19.1 - 2015-02-18
+## <a id="1-19-1"></a>1.19.1 - 2015-02-18
 * Fixed fetching upcoming invoice/paying invoice methods
 
-## 1.19.0 - 2015-02-15
-* Support for new Transfers /reversals endpoint
+## <a id="1-19-0"></a>1.19.0 - 2015-02-15
 * Account retrieval now optionally accepts an account ID
 * Better support for passing custom headers, like Stripe-Account, through requests
+* Support for new Transfers /reversals endpoint
 
-## 1.18.0 - 2015-01-21
-* 1 major enhancement:
-  * Added support for making bitcoin charges through BitcoinReceiver source object
-
-## 1.17.3 - 2015-01-12
-* 1 bugfix:
-  * Fixed API key propagation for ApplicationFee#refund
-
-## 1.17.2 - 2015-01-08
-* 1 bugfix:
-  * Fixed API key propagation for child resources
-
-## 1.17.1 - 2015-01-07
-* 2 minor enhacements:
-  * Fixed dependencies for Ruby versions less than 1.9.3
-  * Added deauthorize method to Account object
-
-## 1.17.0 - 2014-12-15
-* 1 major enhacement:
-  * File uploads resource was added (for uploading pdf or image documents for disputes)
-
-## 1.16.1 - 2014-12-19
-* 2 minor enhancements:
-  * Ability to send idempotent requests
-  * Ability to specify stripe account as a header
-
-## 1.16.0 - 2014-10-08
-* 1 minor enhacement:
-  * Coupons now support update operations - useful for manipulating metadata
-
-## 1.15.0 - 2014-07-26
-* 1 major enhacement:
-  * Application Fee refunds now a list instead of array
-
-## 1.14.0 - 2014-06-17
-* 1 major enhancement:
-  * Add metadata for refunds and disputes
-
-## 1.13.0 - 2014-05-28
-* 1 major enhancement:
-  * Support for canceling transfers
-
-## 1.12.0 - 2014-05-21
-* 1 major enhancement:
-  * Support for cards for recipients
-
-## 1.11.0 - 2014-04-09
-* 2 minor enhancements:
-  * Update included ca bundles
-  * Implement certificate blacklisting
-
-## 1.10.2 - 2014-02-18
-* 1 minor enhancement:
-  * Add create_subscription on Customer resources, so you can create
-    subscriptions without needing to retrieve the customer first (github
-    issue #120)
-
-## 1.10.1 - 2014-02-03
-* 1 bugfix:
-  * Fix marshaling of StripeObjects
-
-## 1.10.0 - 2014-01-29
-* 2 major enhancements
-  * Support for multiple subscriptions per customer
-  * Testing ruby 2.1.0
-
-* 2 minor enhancements
-  * Replace multi_json with json
-  * Allow #save to take opts (for :expand)
-
-* 1 bugfix
-  * Fix #try and #respond_to? on StripeObjects
-
-## 1.9.9 - 2013-12-02
-* 1 major enhancement
-  * Add ApplicationFee resource
-
-## 1.8.9 - 2013-11-14
-* 2 bugfixes:
-  * Fix gemspec dependencies so the gem doesn't break for Ruby 1.8 users
-  * Fix api_resource_test to not use returns as a way of testing rescue behavior
-
-## 1.8.8 - 2013-10-3
-* 1 major enhancement
-  * Add support for metadata on resources
-
-## 1.8.7 - 2013-08-18
-* 1 minor enhancement
-  * Add support for closing disputes.
-
-## 1.8.6 - 2013-08-13
-* 1 major enhancement
-  * Add Balance and BalanceTransaction resources
-
-## 1.8.5 - 2013-08-12
-* 1 major enhancement
-  * Add support for unsetting attributes by setting to nil. This permits unsetting email and description on customers and description on charges. Setting properties to a blank string is now an error.
-  * Attempting to set an object's id is now an error
-
-## 1.8.4 - 2013-07-11
-* 1 major enhancement
-  * Add support for new cards API (Stripe API version - 2013-07-05)
-
-## 1.8.3 - 2013-05-06
-* 1 bugfix:
-  * Fix handling of per-call API keys (github issue #67)
-
-## 1.8.2 - 2013-05-01
-* 3 minor enhancements:
-  * Use to_sym instead of type checking for minor performance improvement (github issue #59)
-  * Handle low-memory situations without throwing an exception (github issue #61)
-  * Add an Customer#upcoming_invoice convenience method (github issue #65)
-
-* 1 bugfix:
-  * Allow updating resources without first retrieving them (github issue #60)
-
-## 1.8.1 - 2013-04-19
-* 1 minor enhancement:
-  * Add support for specifying an API key when retrieving an upcoming invoice
-
-## 1.8.0 - 2013-04-11
-* 1 major enhancement:
-  * Add new Recipient resource
-  * Allow Transfers to be createable
-
-## 1.7.11 - 2013-02-21
-* 1 minor enhancement
-  * Add 'id' to the list of permanent attributes
-
-## 1.7.10 - 2013-02-01
-* 1 major enhancement
-  * Add support for passing options when retrieving Stripe objects e.g., Stripe::Charge.retrieve({id:"foo", expand:["customer"]}) Stripe::Charge("foo") is still supported as well
-
-## 1.7.9 - 2013-01-15
-* 1 major enhancement
-  * Add support for setting a Stripe API version override.
-
-## 1.7.8 - 2012-11-21
-* 1 bugfix
-  * Relax the version constraint on multi_json (github issue #44)
-
-## 1.7.7 - 2012-11-07
-* 1 minor enhancement:
-  * Add support for updating charge disputes
-
-* 1 bugfix
-  * Fix Account API resource bug
-
-## 1.7.6 - 2012-10-30
-* 1 major enhancement
-  * Add support for creating invoices
-
-## 1.7.5 - 2012-10-25
-* 1 major enhancement
-  * Add support for new API lists
-
-## 1.7.4 - 2012-10-08
-* 1 bugfix
-  * Fix bug introduced in 1.7.3 calling API methods that take no
-    arguments, like Stripe::Invoice#pay (github issue #42)
-
-## 1.7.3 - 2012-09-14
-* 2 bugfixes
-  * Make sure that both keys and values of GET params are URL-encoded. NOTE: If you were previously URL-encoding values yourself, you may need to adjust your code.
-  * URL-encode POST params directly, instead of allowing rest-client to do it to work around an unfortunate interaction with the hashery gem (github issue #38)
-
-## 1.7.2 - 2012-08-31
-* 1 major enhancement
-  * Add support for new pay and update methods for Invoice objects
-
-## 1.7.1 - 2012-08-15
-* 1 major enhancement
-  * Add new Account API resource
-
-## 1.7.0 - 2012-05-17
-* 3 major enhancements:
-  * Switch from vendored stripe-json to multi_json for all JSON parsing and rendering. This should not impact programmatic usage of the library, but may cause small rendering differences from, e.g., StripeObject#inspect (github issue #22)
-  * Add new delete_discount method to Customer objects
-  * Add new Transfer API resource
-
-* 2 minor enhancements:
-  * Switch from HTTP Basic auth to Bearer auth (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
-  * Numerous test suite improvements
-
-## 1.6.3 - 2012-03-22
-* 1 bugfix:
-  * Encode GET query strings ourselves instead of using rest-client to work around a bug
-
-## 1.6.2 - 2012-02-24
-* 1 bugfix:
-  * Correct argument handling in StripeObject#as_json
-
-## 1.6.1 - 2012-02-22
-* 1 bugfix:
-  * Fix StripeObject#inspect when ActiveSupport 3.0 is loaded
-
-## 1.6.0 - 2012-02-01
-* A whole bunch of releases between 1.5.0 and 1.6.0, but few changes, mainly the addition of plans, coupons, events, and tokens
+## <a id="1-18-0"></a>1.18.0 - 2015-01-21
+* Added support for making bitcoin charges through BitcoinReceiver source object
+
+## <a id="1-17-3"></a>1.17.3 - 2015-01-12
+* Fixed API key propagation for ApplicationFee#refund
+
+## <a id="1-17-2"></a>1.17.2 - 2015-01-08
+* Fixed API key propagation for child resources
+
+## <a id="1-17-1"></a>1.17.1 - 2015-01-07
+* Added deauthorize method to Account object
+* Fixed dependencies for Ruby versions less than 1.9.3
+
+## <a id="1-17-0"></a>1.17.0 - 2014-12-23
+* File uploads resource was added (for uploading pdf or image documents for disputes)
+
+## <a id="1-16-1"></a>1.16.1 - 2014-12-19
+* Ability to send idempotent requests
+* Ability to specify stripe account as a header
+
+## <a id="1-16-0"></a>1.16.0 - 2014-10-08
+* Coupons now support update operations - useful for manipulating metadata
+
+## <a id="1-15-0"></a>1.15.0 - 2014-07-29
+* Application Fee refunds now a list instead of array
+
+## <a id="1-14-0"></a>1.14.0 - 2014-06-17
+* Add metadata for refunds and disputes
+
+## <a id="1-13-0"></a>1.13.0 - 2014-05-28
+* Support for canceling transfers
+
+## <a id="1-12-0"></a>1.12.0 - 2014-05-21
+* Support for cards for recipients
+
+## <a id="1-11-0"></a>1.11.0 - 2014-04-09
+* Implement certificate blacklisting
+* Update included ca bundles
+
+## <a id="1-10-2"></a>1.10.2 - 2014-02-18
+* Add create_subscription on Customer resources, so you can create
+  subscriptions without needing to retrieve the customer first (github
+  issue #120)
+
+## <a id="1-10-1"></a>1.10.1 - 2014-02-03
+* Fix marshaling of StripeObjects
+
+## <a id="1-10-0"></a>1.10.0 - 2014-01-29
+* Allow #save to take opts (for :expand)
+* Fix #try and #respond_to? on StripeObjects
+* Replace multi_json with json
+* Support for multiple subscriptions per customer
+* Testing ruby 2.1.0
+
+## <a id="1-9-9"></a>1.9.9 - 2013-12-04
+* Add ApplicationFee resource
+
+## <a id="1-8-9"></a>1.8.9 - 2013-11-14
+* Fix api_resource_test to not use returns as a way of testing rescue behavior
+* Fix gemspec dependencies so the gem doesn't break for Ruby 1.8 users
+
+## <a id="1-8-8"></a>1.8.8 - 2013-10-17
+* Add support for metadata on resources
+
+## <a id="1-8-7"></a>1.8.7 - 2013-09-19
+* Add support for closing disputes.
+
+## <a id="1-8-6"></a>1.8.6 - 2013-08-20
+* Add Balance and BalanceTransaction resources
+
+## <a id="1-8-5"></a>1.8.5 - 2013-08-12
+* Add support for unsetting attributes by setting to nil. This permits unsetting email and description on customers and description on charges. Setting properties to a blank string is now an error.
+* Attempting to set an object's id is now an error
+
+## <a id="1-8-4"></a>1.8.4 - 2013-07-11
+* Add support for new cards API (Stripe API version - 2013-07-05)
+
+## <a id="1-8-3"></a>1.8.3 - 2013-05-06
+* Fix handling of per-call API keys (github issue #67)
+
+## <a id="1-8-2"></a>1.8.2 - 2013-05-01
+* Add an Customer#upcoming_invoice convenience method (github issue #65)
+* Allow updating resources without first retrieving them (github issue #60)
+* Handle low-memory situations without throwing an exception (github issue #61)
+* Use to_sym instead of type checking for minor performance improvement (github issue #59)
+
+## <a id="1-8-1"></a>1.8.1 - 2013-04-19
+* Add support for specifying an API key when retrieving an upcoming invoice
+
+## <a id="1-8-0"></a>1.8.0 - 2013-04-11
+* Add new Recipient resource
+* Allow Transfers to be createable
+
+## <a id="1-7-11"></a>1.7.11 - 2013-02-21
+* Add 'id' to the list of permanent attributes
+
+## <a id="1-7-10"></a>1.7.10 - 2013-02-04
+* Add support for passing options when retrieving Stripe objects e.g., Stripe::Charge.retrieve({id:"foo", expand:["customer"]}) Stripe::Charge("foo") is still supported as well
+
+## <a id="1-7-9"></a>1.7.9 - 2013-01-15
+* Add support for setting a Stripe API version override.
+
+## <a id="1-7-8"></a>1.7.8 - 2012-11-21
+* Relax the version constraint on multi_json (github issue #44)
+
+## <a id="1-7-7"></a>1.7.7 - 2012-11-08
+* Add support for updating charge disputes
+* Fix Account API resource bug
+
+## <a id="1-7-6"></a>1.7.6 - 2012-10-30
+* Add support for creating invoices
+
+## <a id="1-7-5"></a>1.7.5 - 2012-10-25
+* Add support for new API lists
+
+## <a id="1-7-4"></a>1.7.4 - 2012-10-08
+* Fix bug introduced in 1.7.3 calling API methods that take no
+  arguments, like Stripe::Invoice#pay (github issue #42)
+
+## <a id="1-7-3"></a>1.7.3 - 2012-09-14
+* Make sure that both keys and values of GET params are URL-encoded. NOTE: If you were previously URL-encoding values yourself, you may need to adjust your code.
+* URL-encode POST params directly, instead of allowing rest-client to do it to work around an unfortunate interaction with the hashery gem (github issue #38)
+
+## <a id="1-7-2"></a>1.7.2 - 2012-08-31
+* Add support for new pay and update methods for Invoice objects
+
+## <a id="1-7-1"></a>1.7.1 - 2012-08-17
+* Add new Account API resource
+
+## <a id="1-7-0"></a>1.7.0 - 2012-05-17
+* Add new delete_discount method to Customer objects
+* Add new Transfer API resource
+* Numerous test suite improvements
+* Switch from HTTP Basic auth to Bearer auth (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
+* Switch from vendored stripe-json to multi_json for all JSON parsing and rendering. This should not impact programmatic usage of the library, but may cause small rendering differences from, e.g., StripeObject#inspect (github issue #22)
+
+## <a id="1-6-3"></a>1.6.3 - 2012-03-22
+* Encode GET query strings ourselves instead of using rest-client to work around a bug
+
+## <a id="1-6-2"></a>1.6.2 - 2012-02-24
+* Correct argument handling in StripeObject#as_json
+
+## <a id="1-6-1"></a>1.6.1 - 2012-02-22
+* Fix StripeObject#inspect when ActiveSupport 3.0 is loaded
+
+## <a id="1-6-0"></a>1.6.0 - 2012-01-27
 * 1.6.0 also contains a new inspect/to_string implementation
+* A whole bunch of releases between 1.5.0 and 1.6.0, but few changes, mainly the addition of plans, coupons, events, and tokens
 
-## 1.5.0 - 2011-05-09
-* 1 major enhancement:
-  * Update for new RESTful API
+## <a id="1-5-26"></a>1.5.26 - 2012-01-26
 
-## 1.3.4 - 2011-01-07
-* 1 major enhancement:
-  * Rename to Stripe
+## <a id="1-5-25"></a>1.5.25 - 2011-12-06
 
-## 1.2 - 2010-06-06
-* 1 major enhancement:
-  * Support for the set_customer_subscription and delete_customer API methods
+## <a id="1-5-24"></a>1.5.24 - 2011-11-25
 
-## 1.1 - 2010-03-14
-* 1 major enhancement:
-  * Support for recurring billing
+## <a id="1-5-21"></a>1.5.21 - 2011-10-21
 
-## 1.0 - 2010-01-05
-* 1 major enhancement:
-  * Initial release
+## <a id="1-5-20"></a>1.5.20 - 2011-10-05
 
-<!--
-# vim: set tw=0:
--->
+## <a id="1-5-19"></a>1.5.19 - 2011-10-05
+
+## <a id="1-5-18"></a>1.5.18 - 2011-10-03
+
+## <a id="1-5-17"></a>1.5.17 - 2011-09-25
+
+## <a id="1-5-16"></a>1.5.16 - 2011-09-08
+
+## <a id="1-5-15"></a>1.5.15 - 2011-09-05
+
+## <a id="1-5-14"></a>1.5.14 - 2011-08-08
+
+## <a id="1-5-13"></a>1.5.13 - 2011-07-29
+
+## <a id="1-5-12"></a>1.5.12 - 2011-07-27
+
+## <a id="1-5-11"></a>1.5.11 - 2011-07-12
+
+## <a id="1-5-10"></a>1.5.10 - 2011-07-12
+
+## <a id="1-5-9"></a>1.5.9 - 2011-07-08
+
+## <a id="1-5-8"></a>1.5.8 - 2011-07-04
+
+## <a id="1-5-7"></a>1.5.7 - 2011-06-29
+
+## <a id="1-5-6"></a>1.5.6 - 2011-06-27
+
+## <a id="1-5-5"></a>1.5.5 - 2011-06-26
+
+## <a id="1-5-4"></a>1.5.4 - 2011-06-26
+
+## <a id="1-5-3"></a>1.5.3 - 2011-06-20
+
+## <a id="1-5-2"></a>1.5.2 - 2011-06-19
+
+## <a id="1-5-1"></a>1.5.1 - 2011-06-02
+
+## <a id="1-5-0"></a>1.5.0 - 2011-05-26
+* Update for new RESTful API
+
+## <a id="1-3-4"></a>1.3.4 - 2011-01-07
+* Rename to Stripe
+
+## <a id="1-2-0"></a>1.2.0 - 2010-06-06
+* Support for the set_customer_subscription and delete_customer API methods
+
+## <a id="1-1-0"></a>1.1.0 - 2010-03-14
+* Support for recurring billing
+
+## <a id="1-0-0"></a>1.0.0 - 2010-01-05
+* Initial release
diff --git a/justfile b/justfile
index 760bd3bb0..6af454ada 100644
--- a/justfile
+++ b/justfile
@@ -44,3 +44,10 @@ typecheck: install
 update-version version:
     echo "{{ version }}" > VERSION
     perl -pi -e 's|VERSION = "[.\-\w\d]+"|VERSION = "{{ version }}"|' lib/stripe/version.rb
+
+# ⭐ 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-]*' lib/stripe/api_version.rb)"
+    echo "minimum-runtime-version: $(rg -N --color never -o 'required_ruby_version = ">= ([^"]+)"' --replace '$1' stripe.gemspec)"