stripe 10.12.0 → 10.13.0

package/CHANGELOG.md

@@ -1,11 +1,21 @@
 # Changelog
 
+## 10.13.0 - 2022-10-06
+* [#1571](https://github.com/stripe/stripe-node/pull/1571) API Updates
+  * Add support for new value `invalid_dob_age_under_18` on enums `Account.future_requirements.errors[].code`, `Account.requirements.errors[].code`, `Capability.future_requirements.errors[].code`, `Capability.requirements.errors[].code`, `Person.future_requirements.errors[].code`, and `Person.requirements.errors[].code`
+  * Add support for new value `bank_of_china` on enums `Charge.payment_method_details.fpx.bank`, `PaymentIntentConfirmParams.payment_method_data.fpx.bank`, `PaymentIntentCreateParams.payment_method_data.fpx.bank`, `PaymentIntentUpdateParams.payment_method_data.fpx.bank`, `PaymentMethod.fpx.bank`, `PaymentMethodCreateParams.fpx.bank`, `SetupIntentConfirmParams.payment_method_data.fpx.bank`, `SetupIntentCreateParams.payment_method_data.fpx.bank`, and `SetupIntentUpdateParams.payment_method_data.fpx.bank`
+  * Add support for new values `America/Nuuk`, `Europe/Kyiv`, and `Pacific/Kanton` on enum `ReportingReportRunCreateParams.parameters.timezone`
+  * Add support for `klarna` on `SetupAttempt.payment_method_details`
+* [#1570](https://github.com/stripe/stripe-node/pull/1570) Update node-fetch to 2.6.7
+* [#1568](https://github.com/stripe/stripe-node/pull/1568) Upgrade dependencies
+* [#1567](https://github.com/stripe/stripe-node/pull/1567) Fix release tag calculation
+
 ## 10.12.0 - 2022-09-29
 * [#1564](https://github.com/stripe/stripe-node/pull/1564) API Updates
-  * Change type of `Charge.payment_method_details.card_present.incremental_authorization_supported` and `Charge.payment_method_details.card_present.overcapture_supported` from `boolean | null` to `boolean`
-  * Add support for `created` on `Checkout.Session`
-  * Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
-  * Deprecate `CheckoutSessionCreateParams.subscription_data.items` (use the `line_items` param instead). This will be removed in the next major version.
+  * Change type of `Charge.payment_method_details.card_present.incremental_authorization_supported` and `Charge.payment_method_details.card_present.overcapture_supported` from `boolean | null` to `boolean`
+  * Add support for `created` on `Checkout.Session`
+  * Add support for `setup_future_usage` on `PaymentIntent.payment_method_options.pix`, `PaymentIntentConfirmParams.payment_method_options.pix`, `PaymentIntentCreateParams.payment_method_options.pix`, and `PaymentIntentUpdateParams.payment_method_options.pix`
+  * Deprecate `CheckoutSessionCreateParams.subscription_data.items` (use the `line_items` param instead). This will be removed in the next major version.
 * [#1563](https://github.com/stripe/stripe-node/pull/1563) Migrate other Stripe infrastructure to TS
 * [#1562](https://github.com/stripe/stripe-node/pull/1562) Restore lib after generating
 * [#1551](https://github.com/stripe/stripe-node/pull/1551) Re-introduce Typescript changes

package/VERSION

@@ -1 +1 @@
-10.12.0
+10.13.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "10.12.0",
+  "version": "10.13.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",
@@ -27,31 +27,30 @@
   "main": "lib/stripe.js",
   "types": "types/2022-08-01/index.d.ts",
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^2.13.0",
-    "@typescript-eslint/parser": "^2.13.0",
-    "chai": "~4.2.0",
+    "@typescript-eslint/eslint-plugin": "^4.33.0",
+    "@typescript-eslint/parser": "^4.33.0",
+    "chai": "^4.3.6",
     "chai-as-promised": "~7.1.1",
     "coveralls": "^3.1.1",
-    "eslint": "^6.8.0",
-    "eslint-config-prettier": "^4.1.0",
-    "eslint-plugin-chai-friendly": "^0.4.0",
-    "eslint-plugin-prettier": "^3.0.1",
-    "mocha": "^8.3.2",
-    "mocha-junit-reporter": "^1.23.1",
-    "nock": "^13.1.1",
-    "node-fetch": "^2.6.2",
+    "eslint": "^7.32.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-chai-friendly": "^0.7.2",
+    "eslint-plugin-prettier": "^3.4.1",
+    "mocha": "^8.4.0",
+    "mocha-junit-reporter": "^2.1.0",
+    "nock": "^13.2.9",
+    "node-fetch": "^2.6.7",
     "nyc": "^15.1.0",
     "prettier": "^1.16.4",
-    "typescript": "^4.8.3"
+    "typescript": "^4.8.4"
   },
   "resolutions": {
-    "ansi-regex": "5.0.1",
     "minimist": "1.2.6",
-    "nanoid": "3.2.0"
+    "nanoid": "^3.2.0"
   },
   "dependencies": {
     "@types/node": ">=8.1.0",
-    "qs": "^6.10.3"
+    "qs": "^6.11.0"
   },
   "license": "MIT",
   "scripts": {
@@ -68,5 +67,5 @@
     "report": "nyc -r text -r lcov report",
     "coveralls": "cat coverage/lcov.info | ./node_modules/coveralls/bin/coveralls.js",
     "prettier-format": "prettier --config .prettierrc 'lib/**/*.js' --write"
-}
+  }
 }

package/types/.eslintrc.js

@@ -1,5 +1,8 @@
 module.exports = {
   root: true,
+  env: {
+    node: true,
+  },
   parser: '@typescript-eslint/parser',
   plugins: ['@typescript-eslint', 'prettier'],
   extends: [
@@ -14,5 +17,6 @@ module.exports = {
     '@typescript-eslint/no-unused-vars': 0,
     '@typescript-eslint/triple-slash-reference': 0,
     '@typescript-eslint/ban-ts-ignore': 0,
+    '@typescript-eslint/ban-types': 0,
   },
 };

package/types/2022-08-01/Accounts.d.ts

@@ -708,6 +708,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'
@@ -831,6 +832,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'

package/types/2022-08-01/Capabilities.d.ts

@@ -119,6 +119,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'
@@ -248,6 +249,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'

package/types/2022-08-01/Charges.d.ts

@@ -1178,7 +1178,7 @@ declare module 'stripe' {
           account_holder_type: Fpx.AccountHolderType | null;
 
           /**
-           * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, or `pb_enterprise`.
+           * The customer's bank. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
            */
           bank: Fpx.Bank;
 
@@ -1198,6 +1198,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'

package/types/2022-08-01/Customers.d.ts

@@ -29,7 +29,7 @@ declare module 'stripe' {
       balance: number;
 
       /**
-       * The current funds being held by Stripe on behalf of the customer. These funds can be applied towards payment intents with source "cash_balance".The settings[reconciliation_mode] field describes whether these funds are applied to such payment intents manually or automatically.
+       * The current funds being held by Stripe on behalf of the customer. These funds can be applied towards payment intents with source "cash_balance". The settings[reconciliation_mode] field describes whether these funds are applied to such payment intents manually or automatically.
        */
       cash_balance?: Stripe.CashBalance | null;
 
@@ -75,7 +75,7 @@ declare module 'stripe' {
       email: string | null;
 
       /**
-       * The current multi-currency balances, if any, being stored on the customer.If positive in a currency, the customer has a credit to apply to their next invoice denominated in that currency.If negative, the customer has an amount owed that will be added to their next invoice denominated in that currency. These balances do not refer to any unpaid invoices.They solely track amounts that have yet to be successfully applied to any invoice. A balance in a particular currency is only applied to any invoice as an invoice in that currency is finalized.
+       * The current multi-currency balances, if any, being stored on the customer. If positive in a currency, the customer has a credit to apply to their next invoice denominated in that currency. If negative, the customer has an amount owed that will be added to their next invoice denominated in that currency. These balances do not refer to any unpaid invoices. They solely track amounts that have yet to be successfully applied to any invoice. A balance in a particular currency is only applied to any invoice as an invoice in that currency is finalized.
        */
       invoice_credit_balance?: {
         [key: string]: number;

package/types/2022-08-01/Invoices.d.ts

@@ -337,7 +337,7 @@ declare module 'stripe' {
       rendering_options: Invoice.RenderingOptions | null;
 
       /**
-       * Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance.
+       * Starting customer balance before the invoice is finalized. If the invoice has not been finalized yet, this will be the current customer balance. For revision invoices, this also includes any customer balance that was applied to the original invoice.
        */
       starting_balance: number;
 

package/types/2022-08-01/PaymentIntents.d.ts

@@ -2328,6 +2328,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'
@@ -4085,6 +4086,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'
@@ -5977,6 +5979,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'

package/types/2022-08-01/PaymentMethods.d.ts

@@ -462,7 +462,7 @@ declare module 'stripe' {
         account_holder_type: Fpx.AccountHolderType | null;
 
         /**
-         * The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, or `pb_enterprise`.
+         * The customer's bank, if provided. Can be one of `affin_bank`, `agrobank`, `alliance_bank`, `ambank`, `bank_islam`, `bank_muamalat`, `bank_rakyat`, `bsn`, `cimb`, `hong_leong_bank`, `hsbc`, `kfh`, `maybank2u`, `ocbc`, `public_bank`, `rhb`, `standard_chartered`, `uob`, `deutsche_bank`, `maybank2e`, `pb_enterprise`, or `bank_of_china`.
          */
         bank: Fpx.Bank;
       }
@@ -477,6 +477,7 @@ declare module 'stripe' {
           | 'ambank'
           | 'bank_islam'
           | 'bank_muamalat'
+          | 'bank_of_china'
           | 'bank_rakyat'
           | 'bsn'
           | 'cimb'
@@ -1139,6 +1140,7 @@ declare module 'stripe' {
           | 'ambank'
           | 'bank_islam'
           | 'bank_muamalat'
+          | 'bank_of_china'
           | 'bank_rakyat'
           | 'bsn'
           | 'cimb'

package/types/2022-08-01/Persons.d.ts

@@ -306,6 +306,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'
@@ -453,6 +454,7 @@ declare module 'stripe' {
         namespace Error {
           type Code =
             | 'invalid_address_city_state_postal_code'
+            | 'invalid_dob_age_under_18'
             | 'invalid_street_address'
             | 'invalid_tos_acceptance'
             | 'invalid_value_other'

package/types/2022-08-01/Quotes.d.ts

@@ -49,7 +49,7 @@ declare module 'stripe' {
       automatic_tax: Quote.AutomaticTax;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or on finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically`.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or on finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically`.
        */
       collection_method: Quote.CollectionMethod;
 
@@ -533,7 +533,7 @@ declare module 'stripe' {
       automatic_tax?: QuoteCreateParams.AutomaticTax;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or at invoice finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically`.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or at invoice finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically`.
        */
       collection_method?: QuoteCreateParams.CollectionMethod;
 
@@ -794,7 +794,7 @@ declare module 'stripe' {
       automatic_tax?: QuoteUpdateParams.AutomaticTax;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or at invoice finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically`.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay invoices at the end of the subscription cycle or at invoice finalization using the default payment method attached to the subscription or customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically`.
        */
       collection_method?: QuoteUpdateParams.CollectionMethod;
 

package/types/2022-08-01/Reporting/ReportRuns.d.ts

@@ -384,6 +384,7 @@ declare module 'stripe' {
             | 'America/North_Dakota/Beulah'
             | 'America/North_Dakota/Center'
             | 'America/North_Dakota/New_Salem'
+            | 'America/Nuuk'
             | 'America/Ojinaga'
             | 'America/Panama'
             | 'America/Pangnirtung'
@@ -657,6 +658,7 @@ declare module 'stripe' {
             | 'Europe/Kaliningrad'
             | 'Europe/Kiev'
             | 'Europe/Kirov'
+            | 'Europe/Kyiv'
             | 'Europe/Lisbon'
             | 'Europe/Ljubljana'
             | 'Europe/London'
@@ -752,6 +754,7 @@ declare module 'stripe' {
             | 'Pacific/Guam'
             | 'Pacific/Honolulu'
             | 'Pacific/Johnston'
+            | 'Pacific/Kanton'
             | 'Pacific/Kiritimati'
             | 'Pacific/Kosrae'
             | 'Pacific/Kwajalein'

package/types/2022-08-01/SetupAttempts.d.ts

@@ -108,6 +108,8 @@ declare module 'stripe' {
 
         ideal?: PaymentMethodDetails.Ideal;
 
+        klarna?: PaymentMethodDetails.Klarna;
+
         link?: PaymentMethodDetails.Link;
 
         sepa_debit?: PaymentMethodDetails.SepaDebit;
@@ -309,6 +311,8 @@ declare module 'stripe' {
             | 'TRIONL2U';
         }
 
+        interface Klarna {}
+
         interface Link {}
 
         interface SepaDebit {}

package/types/2022-08-01/SetupIntents.d.ts

@@ -1032,6 +1032,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'
@@ -1907,6 +1908,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'
@@ -2864,6 +2866,7 @@ declare module 'stripe' {
             | 'ambank'
             | 'bank_islam'
             | 'bank_muamalat'
+            | 'bank_of_china'
             | 'bank_rakyat'
             | 'bsn'
             | 'cimb'

package/types/2022-08-01/SubscriptionSchedules.d.ts

@@ -132,7 +132,7 @@ declare module 'stripe' {
         billing_thresholds: DefaultSettings.BillingThresholds | null;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`.
          */
         collection_method: DefaultSettings.CollectionMethod | null;
 
@@ -227,7 +227,7 @@ declare module 'stripe' {
         billing_thresholds: Phase.BillingThresholds | null;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`.
          */
         collection_method: Phase.CollectionMethod | null;
 
@@ -474,7 +474,7 @@ declare module 'stripe' {
         >;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically` on creation.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically` on creation.
          */
         collection_method?: DefaultSettings.CollectionMethod;
 
@@ -572,7 +572,7 @@ declare module 'stripe' {
         billing_thresholds?: Stripe.Emptyable<Phase.BillingThresholds>;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically` on creation.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically` on creation.
          */
         collection_method?: Phase.CollectionMethod;
 
@@ -909,7 +909,7 @@ declare module 'stripe' {
         >;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically` on creation.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically` on creation.
          */
         collection_method?: DefaultSettings.CollectionMethod;
 
@@ -1007,7 +1007,7 @@ declare module 'stripe' {
         billing_thresholds?: Stripe.Emptyable<Phase.BillingThresholds>;
 
         /**
-         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically` on creation.
+         * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay the underlying subscription at the end of each billing cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically` on creation.
          */
         collection_method?: Phase.CollectionMethod;
 

package/types/2022-08-01/Subscriptions.d.ts

@@ -60,7 +60,7 @@ declare module 'stripe' {
       canceled_at: number | null;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`.
        */
       collection_method: Subscription.CollectionMethod;
 
@@ -594,7 +594,7 @@ declare module 'stripe' {
       cancel_at_period_end?: boolean;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically`.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically`.
        */
       collection_method?: SubscriptionCreateParams.CollectionMethod;
 
@@ -654,6 +654,8 @@ declare module 'stripe' {
       off_session?: boolean;
 
       /**
+       * Only applies to subscriptions with `collection_method=charge_automatically`.
+       *
        * Use `allow_incomplete` to create subscriptions with `status=incomplete` if the first invoice cannot be paid. Creating subscriptions with this status allows you to manage scenarios where additional user actions are needed to pay a subscription's invoice. For example, SCA regulation may require 3DS authentication to complete payment. See the [SCA Migration Guide](https://stripe.com/docs/billing/migration/strong-customer-authentication) for Billing to learn more. This is the default behavior.
        *
        * Use `default_incomplete` to create Subscriptions with `status=incomplete` when the first invoice requires payment, otherwise start as active. Subscriptions transition to `status=active` when successfully confirming the payment intent on the first invoice. This allows simpler management of scenarios where additional user actions are needed to pay a subscription's invoice. Such as failed payments, [SCA regulation](https://stripe.com/docs/billing/migration/strong-customer-authentication), or collecting a mandate for a bank debit payment method. If the payment intent is not confirmed within 23 hours subscriptions transition to `status=incomplete_expired`, which is a terminal state.
@@ -661,6 +663,8 @@ declare module 'stripe' {
        * Use `error_if_incomplete` if you want Stripe to return an HTTP 402 status code if a subscription's first invoice cannot be paid. For example, if a payment method requires 3DS authentication due to SCA regulation and further user action is needed, this parameter does not create a subscription and returns an error instead. This was the default behavior for API versions prior to 2019-03-14. See the [changelog](https://stripe.com/docs/upgrades#2019-03-14) to learn more.
        *
        * `pending_if_incomplete` is only used with updates and cannot be passed when creating a subscription.
+       *
+       * Subscriptions with `collection_method=send_invoice` are automatically activated regardless of the first invoice status.
        */
       payment_behavior?: SubscriptionCreateParams.PaymentBehavior;
 
@@ -1210,7 +1214,7 @@ declare module 'stripe' {
       cancel_at_period_end?: boolean;
 
       /**
-       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions. Defaults to `charge_automatically`.
+       * Either `charge_automatically`, or `send_invoice`. When charging automatically, Stripe will attempt to pay this subscription at the end of the cycle using the default source attached to the customer. When sending an invoice, Stripe will email your customer an invoice with payment instructions and mark the subscription as `active`. Defaults to `charge_automatically`.
        */
       collection_method?: SubscriptionUpdateParams.CollectionMethod;
 

package/types/2022-08-01/Treasury/FinancialAccountFeatures.d.ts

@@ -235,7 +235,7 @@ declare module 'stripe' {
 
         interface InboundTransfers {
           /**
-           * Toggle settings for enabling/disabling a feature
+           * Toggle settings for enabling/disabling an ACH specific feature
            */
           ach?: InboundTransfers.Ach;
         }
@@ -360,7 +360,7 @@ declare module 'stripe' {
 
         interface OutboundPayments {
           /**
-           * Toggle settings for enabling/disabling a feature
+           * Toggle settings for enabling/disabling an ACH specific feature
            */
           ach?: OutboundPayments.Ach;
 
@@ -490,7 +490,7 @@ declare module 'stripe' {
 
         interface OutboundTransfers {
           /**
-           * Toggle settings for enabling/disabling a feature
+           * Toggle settings for enabling/disabling an ACH specific feature
            */
           ach?: OutboundTransfers.Ach;
 

package/types/Webhooks.d.ts

@@ -13,7 +13,6 @@ declare module 'stripe' {
          * Raw text body payload received from Stripe.
          */
         payload: string | Buffer,
-
         /**
          * Value of the `stripe-signature` header from Stripe.
          * Typically a string.
@@ -25,18 +24,15 @@ declare module 'stripe' {
          * only a string.
          */
         header: string | Buffer | Array<string>,
-
         /**
          * Your Webhook Signing Secret for this endpoint (e.g., 'whsec_...').
          * You can get this [in your dashboard](https://dashboard.stripe.com/webhooks).
          */
         secret: string,
-
         /**
          * Seconds of tolerance on timestamps.
          */
         tolerance?: number,
-
         /**
          * Optional CryptoProvider to use for computing HMAC signatures.
          */
@@ -54,7 +50,6 @@ declare module 'stripe' {
          * Raw text body payload received from Stripe.
          */
         payload: string | Buffer,
-
         /**
          * Value of the `stripe-signature` header from Stripe.
          * Typically a string.
@@ -66,18 +61,15 @@ declare module 'stripe' {
          * only a string.
          */
         header: string | Buffer | Array<string>,
-
         /**
          * Your Webhook Signing Secret for this endpoint (e.g., 'whsec_...').
          * You can get this [in your dashboard](https://dashboard.stripe.com/webhooks).
          */
         secret: string,
-
         /**
          * Seconds of tolerance on timestamps.
          */
         tolerance?: number,
-
         /**
          * Optional CryptoProvider to use for computing HMAC signatures.
          */

package/types/test/.eslintrc.js

@@ -0,0 +1,6 @@
+module.exports = {
+  extends: '../.eslintrc.js',
+  rules: {
+    '@typescript-eslint/ban-ts-comment': 0,
+  },
+};