stripe 16.6.0 → 16.7.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 16.7.0 - 2024-08-08
+* [#2147](https://github.com/stripe/stripe-node/pull/2147) Update generated code
+  * Add support for `activate`, `archive`, `create`, `deactivate`, `list`, and `retrieve` methods on resource `Billing.Alert`
+  * Add support for `retrieve` method on resource `Tax.Calculation`
+  * Add support for new value `invalid_mandate_reference_prefix_format` on enums `Invoice.last_finalization_error.code`, `PaymentIntent.last_payment_error.code`, `SetupAttempt.setup_error.code`, `SetupIntent.last_setup_error.code`, and `StripeError.code`
+  * Add support for `type` on `Charge.payment_method_details.card_present.offline`, `ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present.offline`, `PaymentMethod.card.generated_from.payment_method_details.card_present.offline`, and `SetupAttempt.payment_method_details.card_present.offline`
+  * Add support for `offline` on `ConfirmationToken.payment_method_preview.card_present` and `PaymentMethod.card_present`
+  * Add support for `related_customer` on `Identity.VerificationSessionCreateParams`, `Identity.VerificationSessionListParams`, and `Identity.VerificationSession`
+  * Change `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.count`, `InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.interval`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.count`, `PaymentIntentConfirmParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.count`, `PaymentIntentCreateParams.payment_method_options.card.installments.plan.interval`, `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.count`, and `PaymentIntentUpdateParams.payment_method_options.card.installments.plan.interval` to be optional
+  * Add support for new value `girocard` on enums `PaymentIntent.payment_method_options.card.network`, `PaymentIntentConfirmParams.payment_method_options.card.network`, `PaymentIntentCreateParams.payment_method_options.card.network`, `PaymentIntentUpdateParams.payment_method_options.card.network`, `SetupIntent.payment_method_options.card.network`, `SetupIntentConfirmParams.payment_method_options.card.network`, `SetupIntentCreateParams.payment_method_options.card.network`, `SetupIntentUpdateParams.payment_method_options.card.network`, `Subscription.payment_settings.payment_method_options.card.network`, `SubscriptionCreateParams.payment_settings.payment_method_options.card.network`, and `SubscriptionUpdateParams.payment_settings.payment_method_options.card.network`
+  * Add support for new value `financial_addresses.aba.forwarding` on enums `Treasury.FinancialAccount.active_features[]`, `Treasury.FinancialAccount.pending_features[]`, and `Treasury.FinancialAccount.restricted_features[]`
+
 ## 16.6.0 - 2024-08-01
 * [#2144](https://github.com/stripe/stripe-node/pull/2144) Update generated code
   * Add support for new resources `Billing.AlertTriggered` and `Billing.Alert`

package/VERSION

@@ -1 +1 @@
-16.6.0
+16.7.0

package/cjs/resources/Billing/Alerts.js

@@ -0,0 +1,27 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Alerts = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Alerts = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/billing/alerts' }),
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v1/billing/alerts/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/billing/alerts',
+        methodType: 'list',
+    }),
+    activate: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/activate',
+    }),
+    archive: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/archive',
+    }),
+    deactivate: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/deactivate',
+    }),
+});

package/cjs/resources/Tax/Calculations.js

@@ -6,6 +6,10 @@ const StripeResource_js_1 = require("../../StripeResource.js");
 const stripeMethod = StripeResource_js_1.StripeResource.method;
 exports.Calculations = StripeResource_js_1.StripeResource.extend({
     create: stripeMethod({ method: 'POST', fullPath: '/v1/tax/calculations' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/calculations/{calculation}',
+    }),
     listLineItems: stripeMethod({
         method: 'GET',
         fullPath: '/v1/tax/calculations/{calculation}/line_items',

package/cjs/resources.js

@@ -6,6 +6,7 @@ exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = export
 const ResourceNamespace_js_1 = require("./ResourceNamespace.js");
 const Accounts_js_1 = require("./resources/FinancialConnections/Accounts.js");
 const ActiveEntitlements_js_1 = require("./resources/Entitlements/ActiveEntitlements.js");
+const Alerts_js_1 = require("./resources/Billing/Alerts.js");
 const Authorizations_js_1 = require("./resources/TestHelpers/Issuing/Authorizations.js");
 const Authorizations_js_2 = require("./resources/Issuing/Authorizations.js");
 const Calculations_js_1 = require("./resources/Tax/Calculations.js");
@@ -174,6 +175,7 @@ var WebhookEndpoints_js_1 = require("./resources/WebhookEndpoints.js");
 Object.defineProperty(exports, "WebhookEndpoints", { enumerable: true, get: function () { return WebhookEndpoints_js_1.WebhookEndpoints; } });
 exports.Apps = (0, ResourceNamespace_js_1.resourceNamespace)('apps', { Secrets: Secrets_js_1.Secrets });
 exports.Billing = (0, ResourceNamespace_js_1.resourceNamespace)('billing', {
+    Alerts: Alerts_js_1.Alerts,
     MeterEventAdjustments: MeterEventAdjustments_js_1.MeterEventAdjustments,
     MeterEvents: MeterEvents_js_1.MeterEvents,
     Meters: Meters_js_1.Meters,

package/cjs/stripe.core.js

@@ -34,7 +34,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '16.6.0';
+    Stripe.PACKAGE_VERSION = '16.7.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/resources/Billing/Alerts.js

@@ -0,0 +1,24 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Alerts = StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/billing/alerts' }),
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v1/billing/alerts/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/billing/alerts',
+        methodType: 'list',
+    }),
+    activate: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/activate',
+    }),
+    archive: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/archive',
+    }),
+    deactivate: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/billing/alerts/{id}/deactivate',
+    }),
+});

package/esm/resources/Tax/Calculations.js

@@ -3,6 +3,10 @@ import { StripeResource } from '../../StripeResource.js';
 const stripeMethod = StripeResource.method;
 export const Calculations = StripeResource.extend({
     create: stripeMethod({ method: 'POST', fullPath: '/v1/tax/calculations' }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/calculations/{calculation}',
+    }),
     listLineItems: stripeMethod({
         method: 'GET',
         fullPath: '/v1/tax/calculations/{calculation}/line_items',

package/esm/resources.js

@@ -2,6 +2,7 @@
 import { resourceNamespace } from './ResourceNamespace.js';
 import { Accounts as FinancialConnectionsAccounts } from './resources/FinancialConnections/Accounts.js';
 import { ActiveEntitlements as EntitlementsActiveEntitlements } from './resources/Entitlements/ActiveEntitlements.js';
+import { Alerts as BillingAlerts } from './resources/Billing/Alerts.js';
 import { Authorizations as TestHelpersIssuingAuthorizations } from './resources/TestHelpers/Issuing/Authorizations.js';
 import { Authorizations as IssuingAuthorizations } from './resources/Issuing/Authorizations.js';
 import { Calculations as TaxCalculations } from './resources/Tax/Calculations.js';
@@ -118,6 +119,7 @@ export { Transfers } from './resources/Transfers.js';
 export { WebhookEndpoints } from './resources/WebhookEndpoints.js';
 export const Apps = resourceNamespace('apps', { Secrets: AppsSecrets });
 export const Billing = resourceNamespace('billing', {
+    Alerts: BillingAlerts,
     MeterEventAdjustments: BillingMeterEventAdjustments,
     MeterEvents: BillingMeterEvents,
     Meters: BillingMeters,

package/esm/stripe.core.js

@@ -31,7 +31,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '16.6.0';
+    Stripe.PACKAGE_VERSION = '16.7.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "16.6.0",
+  "version": "16.7.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Accounts.d.ts

@@ -1316,22 +1316,22 @@ declare module 'stripe' {
           statement_descriptor: string | null;
 
           /**
-           * The Kana variation of the default text that appears on credit card statements when a charge is made (Japan only)
+           * The Kana variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kana: string | null;
 
           /**
-           * The Kanji variation of the default text that appears on credit card statements when a charge is made (Japan only)
+           * The Kanji variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kanji: string | null;
 
           /**
-           * The Kana variation of the default text that appears on credit card statements when a charge is made (Japan only). This field prefixes any dynamic `statement_descriptor_suffix_kana` specified on the charge. `statement_descriptor_prefix_kana` is useful for maximizing descriptor space for the dynamic portion.
+           * The Kana variation of `statement_descriptor_prefix` used for card charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_prefix_kana: string | null;
 
           /**
-           * The Kanji variation of the default text that appears on credit card statements when a charge is made (Japan only). This field prefixes any dynamic `statement_descriptor_suffix_kanji` specified on the charge. `statement_descriptor_prefix_kanji` is useful for maximizing descriptor space for the dynamic portion.
+           * The Kanji variation of `statement_descriptor_prefix` used for card charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_prefix_kanji: string | null;
         }

package/types/AccountsResource.d.ts

@@ -1441,17 +1441,17 @@ declare module 'stripe' {
 
         interface Payments {
           /**
-           * The default text that appears on credit card statements when a charge is made. This field prefixes any dynamic `statement_descriptor` specified on the charge.
+           * The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
            */
           statement_descriptor?: string;
 
           /**
-           * The Kana variation of the default text that appears on credit card statements when a charge is made (Japan only).
+           * The Kana variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kana?: string;
 
           /**
-           * The Kanji variation of the default text that appears on credit card statements when a charge is made (Japan only).
+           * The Kanji variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kanji?: string;
         }
@@ -2995,17 +2995,17 @@ declare module 'stripe' {
 
         interface Payments {
           /**
-           * The default text that appears on credit card statements when a charge is made. This field prefixes any dynamic `statement_descriptor` specified on the charge.
+           * The default text that appears on statements for non-card charges outside of Japan. For card charges, if you don't set a `statement_descriptor_prefix`, this text is also used as the statement descriptor prefix. In that case, if concatenating the statement descriptor suffix causes the combined statement descriptor to exceed 22 characters, we truncate the `statement_descriptor` text to limit the full descriptor to 22 characters. For more information about statement descriptors and their requirements, see the [account settings documentation](https://docs.stripe.com/get-started/account/statement-descriptors).
            */
           statement_descriptor?: string;
 
           /**
-           * The Kana variation of the default text that appears on credit card statements when a charge is made (Japan only).
+           * The Kana variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kana?: string;
 
           /**
-           * The Kanji variation of the default text that appears on credit card statements when a charge is made (Japan only).
+           * The Kanji variation of `statement_descriptor` used for charges in Japan. Japanese statement descriptors have [special requirements](https://docs.stripe.com/get-started/account/statement-descriptors#set-japanese-statement-descriptors).
            */
           statement_descriptor_kanji?: string;
         }

package/types/Billing/AlertsResource.d.ts

@@ -0,0 +1,176 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Billing {
+      interface AlertCreateParams {
+        /**
+         * The type of alert to create.
+         */
+        alert_type: 'usage_threshold';
+
+        /**
+         * The title of the alert.
+         */
+        title: string;
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * Filters to limit the scope of an alert.
+         */
+        filter?: AlertCreateParams.Filter;
+
+        /**
+         * The configuration of the usage threshold.
+         */
+        usage_threshold_config?: AlertCreateParams.UsageThresholdConfig;
+      }
+
+      namespace AlertCreateParams {
+        interface Filter {
+          /**
+           * Limit the scope to this alert only to this customer.
+           */
+          customer?: string;
+        }
+
+        interface UsageThresholdConfig {
+          /**
+           * Defines at which value the alert will fire.
+           */
+          gte: number;
+
+          /**
+           * The [Billing Meter](https://stripe.com/api/billing/meter) ID whose usage is monitored.
+           */
+          meter?: string;
+
+          /**
+           * Whether the alert should only fire only once, or once per billing cycle.
+           */
+          recurrence: 'one_time';
+        }
+      }
+
+      interface AlertRetrieveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface AlertListParams extends PaginationParams {
+        /**
+         * Filter results to only include this type of alert.
+         */
+        alert_type?: 'usage_threshold';
+
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+
+        /**
+         * Filter results to only include alerts with the given meter.
+         */
+        meter?: string;
+      }
+
+      interface AlertActivateParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface AlertArchiveParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      interface AlertDeactivateParams {
+        /**
+         * Specifies which fields in the response should be expanded.
+         */
+        expand?: Array<string>;
+      }
+
+      class AlertsResource {
+        /**
+         * Creates a billing alert
+         */
+        create(
+          params: AlertCreateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+
+        /**
+         * Retrieves a billing alert given an ID
+         */
+        retrieve(
+          id: string,
+          params?: AlertRetrieveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+        retrieve(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+
+        /**
+         * Lists billing active and inactive alerts
+         */
+        list(
+          params?: AlertListParams,
+          options?: RequestOptions
+        ): ApiListPromise<Stripe.Billing.Alert>;
+        list(options?: RequestOptions): ApiListPromise<Stripe.Billing.Alert>;
+
+        /**
+         * Reactivates this alert, allowing it to trigger again.
+         */
+        activate(
+          id: string,
+          params?: AlertActivateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+        activate(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+
+        /**
+         * Archives this alert, removing it from the list view and APIs. This is non-reversible.
+         */
+        archive(
+          id: string,
+          params?: AlertArchiveParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+        archive(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+
+        /**
+         * Deactivates this alert, preventing it from triggering.
+         */
+        deactivate(
+          id: string,
+          params?: AlertDeactivateParams,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+        deactivate(
+          id: string,
+          options?: RequestOptions
+        ): Promise<Stripe.Response<Stripe.Billing.Alert>>;
+      }
+    }
+  }
+}

package/types/Cards.d.ts

@@ -71,7 +71,7 @@ declare module 'stripe' {
       available_payout_methods?: Array<Card.AvailablePayoutMethod> | null;
 
       /**
-       * Card brand. Can be `American Express`, `Diners Club`, `Discover`, `Eftpos Australia`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
+       * Card brand. Can be `American Express`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
        */
       brand: string;
 
@@ -81,7 +81,7 @@ declare module 'stripe' {
       country: string | null;
 
       /**
-       * Three-letter [ISO code for currency](https://stripe.com/docs/payouts). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
+       * Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
        */
       currency?: string | null;
 

package/types/Charges.d.ts

@@ -62,7 +62,7 @@ declare module 'stripe' {
       billing_details: Charge.BillingDetails;
 
       /**
-       * The full statement descriptor that is passed to card networks, and that is displayed on your customers' credit card and bank statements. Allows you to see what the statement descriptor looks like after the static and dynamic portions are combined. This only works for card payments.
+       * The full statement descriptor that is passed to card networks, and that is displayed on your customers' credit card and bank statements. Allows you to see what the statement descriptor looks like after the static and dynamic portions are combined. This value only exists for card payments.
        */
       calculated_statement_descriptor: string | null;
 
@@ -214,12 +214,12 @@ declare module 'stripe' {
       source_transfer: string | Stripe.Transfer | null;
 
       /**
-       * For card charges, use `statement_descriptor_suffix` instead. Otherwise, you can use this value as the complete description of a charge on your customers' statements. Must contain at least one letter, maximum 22 characters.
+       * For a non-card charge, text that appears on the customer's statement as the [statement descriptor](https://docs.stripe.com/get-started/account/statement-descriptors). This value overrides the account's default statement descriptor. For a card charge, this value is ignored unless you don't specify a `statement_descriptor_suffix`, in which case this value is used as the suffix.
        */
       statement_descriptor: string | null;
 
       /**
-       * Provides information about the charge that customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor that's set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor.
+       * Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.corp.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement. If the account has no prefix value, the suffix is concatenated to the account's statement descriptor.
        */
       statement_descriptor_suffix: string | null;
 
@@ -1211,6 +1211,11 @@ declare module 'stripe' {
              * Time at which the payment was collected while offline
              */
             stored_at: number | null;
+
+            /**
+             * The method used to process this payment method offline. Only deferred is allowed.
+             */
+            type: 'deferred' | null;
           }
 
           type ReadMethod =

package/types/ChargesResource.d.ts

@@ -73,12 +73,12 @@ declare module 'stripe' {
       source?: string;
 
       /**
-       * For card charges, use `statement_descriptor_suffix` instead. Otherwise, you can use this value as the complete description of a charge on your customers' statements. Must contain at least one letter, maximum 22 characters.
+       * For a non-card charge, text that appears on the customer's statement as the [statement descriptor](https://docs.stripe.com/get-started/account/statement-descriptors). This value overrides the account's default statement descriptor. For a card charge, this value is ignored unless you don't specify a `statement_descriptor_suffix`, in which case this value is used as the suffix.
        */
       statement_descriptor?: string;
 
       /**
-       * Provides information about the charge that customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor that's set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor.
+       * Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.corp.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement. If the account has no prefix value, the suffix is concatenated to the account's statement descriptor.
        */
       statement_descriptor_suffix?: string;
 
@@ -264,7 +264,7 @@ declare module 'stripe' {
       payment_intent?: string;
 
       /**
-       * Only return charges for this transfer group.
+       * Only return charges for this transfer group, limited to 100.
        */
       transfer_group?: string;
     }
@@ -296,12 +296,12 @@ declare module 'stripe' {
       receipt_email?: string;
 
       /**
-       * For card charges, use `statement_descriptor_suffix` instead. Otherwise, you can use this value as the complete description of a charge on your customers' statements. Must contain at least one letter, maximum 22 characters.
+       * For a non-card charge, text that appears on the customer's statement as the [statement descriptor](https://docs.stripe.com/get-started/account/statement-descriptors). This value overrides the account's default statement descriptor. For a card charge, this value is ignored unless you don't specify a `statement_descriptor_suffix`, in which case this value is used as the suffix.
        */
       statement_descriptor?: string;
 
       /**
-       * Provides information about the charge that customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor that's set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor.
+       * Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.corp.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement. If the account has no prefix value, the suffix is concatenated to the account's statement descriptor.
        */
       statement_descriptor_suffix?: string;