Merge pull request #2552 from stripe/latest-codegen-beta

Update generated code for beta

Author: stripe-openapi[bot]

CHANGELOG.md

@@ -1,8 +1,14 @@
 # Changelog
 
+## 20.2.0 - 2026-01-16
+* [#2551](https://github.com/stripe/stripe-node/pull/2551) 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`
+
 ## 20.2.0-beta.2 - 2026-01-08
 
-This release is purely for pulling in fixes from the releases 20.1.1 and 20.1.2 into the public preview release. 
+This release is purely for pulling in fixes from the releases 20.1.1 and 20.1.2 into the public preview release.
 
 ## 20.2.0-beta.1 - 2025-12-16
 This release changes the pinned API version to `2025-12-15.preview`.

CODEGEN_VERSION

@@ -1 +1 @@
-32e3565a276ee2b159a3bb1eb3ea0a7e4fdc4977
+529796460735eb8ef64a29787291f1b4d4b29f1c

OPENAPI_VERSION

@@ -1 +1 @@
-v2150
+v2160

README.md

@@ -414,6 +414,11 @@ const event = stripe.webhooks.constructEvent(payloadString, header, secret);
 // Do something with mocked signed event
 expect(event.id).to.equal(payload.id);
 ```
+### How to use undocumented parameters and properties
+
+In some cases, you might encounter parameters on an API request or fields on an API response that aren’t available in the SDKs.
+This might happen when they’re undocumented or when they’re in preview and you aren’t using a preview SDK. 
+See [undocumented params and properties](https://docs.stripe.com/sdks/server-side?lang=node#undocumented-params-and-fields) to send those parameters or access those fields.
 
 ### Writing a Plugin
 
@@ -533,7 +538,7 @@ We would love for you to try these as we incrementally release new features and
 The easiest way to install a public-preview release is to use the dedicated npm tag:
 
 ```
-npm install stripe@public-preview --save
+npm install stripe@public-preview --save-exact
 ```
 
 Or, to install a specific version from the [releases page](https://github.com/stripe/stripe-node/releases/), you can specify that version explicitly:
@@ -545,7 +550,7 @@ npm install stripe@<some-version>
 ```
 
 > **Note**
-> There can be breaking changes between two versions of the public preview SDKs without a bump in the major version. Therefore we recommend pinning the package version to a specific version in your package.json file. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest public preview SDK.
+> There can be breaking changes between two versions of the public preview SDKs without a bump in the major version. Therefore we recommend pinning the package version to a specific version (i.e. using --save-exact) in your package.json file. This way you can install the same version each time without breaking changes unless you are intentionally looking for the latest public preview SDK.
 
 Some preview features require a name and version to be set in the `Stripe-Version` header like `feature_beta=v3`. If your preview feature has this requirement, use the `apiVersion` property of `config` object to set it:
 
@@ -560,7 +565,7 @@ const stripe = new Stripe('sk_test_...', {
 Stripe has features in the [private preview phase](https://docs.stripe.com/release-phases) that can be accessed via versions of this package that have the `-alpha.X` suffix like `18.6.0-alpha.1`. These are invite-only features. Once invited, you can install the private preview SDKs by following the same instructions as for the [public preview SDKs](https://github.com/stripe/stripe-node?tab=readme-ov-file#public-preview-sdks) above and replacing the term `public-preview` with `private-preview`:
 
 ```
-npm install stripe@private-preview --save
+npm install stripe@private-preview --save-exact
 ```
 
 ### Custom requests

package.json

@@ -30,7 +30,6 @@
     "@types/chai": "^4.3.4",
     "@types/chai-as-promised": "^7.1.5",
     "@types/mocha": "^10.0.1",
-    "@types/qs": "^6.9.7",
     "@types/node": "~22",
     "@typescript-eslint/eslint-plugin": "^4.33.0",
     "@typescript-eslint/parser": "^4.33.0",
@@ -55,9 +54,7 @@
     "minimist": "1.2.6",
     "nanoid": "^3.2.0"
   },
-  "dependencies": {
-    "qs": "^6.14.1"
-  },
+  "dependencies": {},
   "peerDependencies": {
     "@types/node": ">=16"
   },

src/Error.ts

@@ -59,6 +59,8 @@ export const generateV2Error = (
       return new NotCancelableError(rawStripeError);
     case 'quota_exceeded':
       return new QuotaExceededError(rawStripeError);
+    case 'rate_limit':
+      return new RateLimitError(rawStripeError);
     case 'recipient_not_notifiable':
       return new RecipientNotNotifiableError(rawStripeError);
     case 'temporary_session_expired':
@@ -328,6 +330,11 @@ export class QuotaExceededError extends StripeError {
     super(rawStripeError, 'QuotaExceededError');
   }
 }
+export class RateLimitError extends StripeError {
+  constructor(rawStripeError: StripeRawError = {}) {
+    super(rawStripeError, 'RateLimitError');
+  }
+}
 export class RecipientNotNotifiableError extends StripeError {
   constructor(rawStripeError: StripeRawError = {}) {
     super(rawStripeError, 'RecipientNotNotifiableError');

src/RequestSender.ts

@@ -767,7 +767,7 @@ export class RequestSender {
       if (apiMode == 'v2') {
         stringifiedData = data ? jsonStringifyRequestData(data) : '';
       } else {
-        stringifiedData = queryStringifyRequestData(data || {}, apiMode);
+        stringifiedData = queryStringifyRequestData(data || {});
       }
 
       prepareAndMakeRequest(null, stringifiedData);

src/StripeEventNotificationHandler.ts

@@ -21,6 +21,7 @@ const KNOWN_EVENT_TYPES = new Set([
   'v2.core.account[configuration.storer].capability_status_updated',
   'v2.core.account[configuration.storer].updated',
   'v2.core.account[defaults].updated',
+  'v2.core.account[future_requirements].updated',
   'v2.core.account[identity].updated',
   'v2.core.account[requirements].updated',
   'v2.core.account_link.returned',

src/StripeResource.ts

@@ -4,7 +4,6 @@ import {
   makeURLInterpolator,
   protoExtend,
   queryStringifyRequestData,
-  getAPIMode,
 } from './utils.js';
 import {stripeMethod} from './StripeMethod.js';
 import {
@@ -229,7 +228,7 @@ StripeResource.prototype = {
       const path = [
         opts.requestPath,
         emptyQuery ? '' : '?',
-        queryStringifyRequestData(opts.queryData, getAPIMode(opts.requestPath)),
+        queryStringifyRequestData(opts.queryData),
       ].join('');
 
       const {headers, settings} = opts;

src/Types.d.ts

@@ -53,6 +53,7 @@ export type RawErrorType =
   | 'non_zero_balance'
   | 'not_cancelable'
   | 'quota_exceeded'
+  | 'rate_limit'
   | 'recipient_not_notifiable'
   | 'temporary_session_expired';
 // rawErrorTypeEnum: The end of the section generated from our OpenAPI spec