stripe 18.2.0-beta.1 → 18.3.0-beta.1

package/types/PaymentMethodsResource.d.ts

@@ -1172,9 +1172,9 @@ declare module 'stripe' {
 
     class PaymentMethodsResource {
       /**
-       * Creates a PaymentMethod object. Read the [Stripe.js reference](https://stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
+       * Creates a PaymentMethod object. Read the [Stripe.js reference](https://docs.stripe.com/docs/stripe-js/reference#stripe-create-payment-method) to learn how to create PaymentMethods via Stripe.js.
        *
-       * Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
+       * Instead of creating a PaymentMethod directly, we recommend using the [PaymentIntents API to accept a payment immediately or the <a href="/docs/payments/save-and-reuse">SetupIntent](https://docs.stripe.com/docs/payments/accept-a-payment) API to collect payment method details ahead of a future payment.
        */
       create(
         params?: PaymentMethodCreateParams,
@@ -1185,7 +1185,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PaymentMethod>>;
 
       /**
-       * Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer)
+       * Retrieves a PaymentMethod object attached to the StripeAccount. To retrieve a payment method attached to a Customer, you should use [Retrieve a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer)
        */
       retrieve(
         id: string,
@@ -1207,7 +1207,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PaymentMethod>>;
 
       /**
-       * Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://stripe.com/docs/api/payment_methods/customer_list) API instead.
+       * Returns a list of PaymentMethods for Treasury flows. If you want to list the PaymentMethods attached to a Customer for payments, you should use the [List a Customer's PaymentMethods](https://docs.stripe.com/docs/api/payment_methods/customer_list) API instead.
        */
       list(
         params?: PaymentMethodListParams,
@@ -1218,16 +1218,16 @@ declare module 'stripe' {
       /**
        * Attaches a PaymentMethod object to a Customer.
        *
-       * To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://stripe.com/docs/api/setup_intents)
-       * or a PaymentIntent with [setup_future_usage](https://stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
+       * To attach a new PaymentMethod to a customer for future payments, we recommend you use a [SetupIntent](https://docs.stripe.com/docs/api/setup_intents)
+       * or a PaymentIntent with [setup_future_usage](https://docs.stripe.com/docs/api/payment_intents/create#create_payment_intent-setup_future_usage).
        * These approaches will perform any necessary steps to set up the PaymentMethod for future payments. Using the /v1/payment_methods/:id/attach
        * endpoint without first using a SetupIntent or PaymentIntent with setup_future_usage does not optimize the PaymentMethod for
        * future use, which makes later declines and payment friction more likely.
-       * See [Optimizing cards for future payments](https://stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
+       * See [Optimizing cards for future payments](https://docs.stripe.com/docs/payments/payment-intents#future-usage) for more information about setting up
        * future payments.
        *
        * To use this PaymentMethod as the default for invoice or subscription payments,
-       * set [invoice_settings.default_payment_method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
+       * set [invoice_settings.default_payment_method](https://docs.stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method),
        * on the Customer to the PaymentMethod's ID.
        */
       attach(

package/types/PaymentRecords.d.ts

@@ -72,7 +72,7 @@ declare module 'stripe' {
       /**
        * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
        */
-      metadata: Stripe.Metadata | null;
+      metadata: Stripe.Metadata;
 
       /**
        * Information about the Payment Method debited for this payment.
@@ -408,6 +408,16 @@ declare module 'stripe' {
         }
 
         interface Affirm {
+          /**
+           * ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+           */
+          location?: string;
+
+          /**
+           * ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+           */
+          reader?: string;
+
           /**
            * The Affirm transaction ID associated with this payment.
            */
@@ -2075,6 +2085,16 @@ declare module 'stripe' {
            */
           fingerprint: string | null;
 
+          /**
+           * ID of the [location](https://stripe.com/docs/api/terminal/locations) that this transaction's reader is assigned to.
+           */
+          location?: string;
+
+          /**
+           * ID of the [reader](https://stripe.com/docs/api/terminal/readers) this transaction was made on.
+           */
+          reader?: string;
+
           /**
            * Transaction ID of this particular WeChat Pay transaction.
            */

package/types/PaymentRecordsResource.d.ts

@@ -58,7 +58,7 @@ declare module 'stripe' {
       /**
        * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
-      metadata?: Stripe.MetadataParam;
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
       /**
        * The outcome of the reported payment.
@@ -234,7 +234,7 @@ declare module 'stripe' {
       /**
        * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
        */
-      metadata?: Stripe.MetadataParam;
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
       /**
        * The outcome of the reported payment.
@@ -356,7 +356,7 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
-      metadata?: Stripe.MetadataParam;
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
     }
 
     interface PaymentRecordReportPaymentAttemptFailedParams {
@@ -370,7 +370,7 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
-      metadata?: Stripe.MetadataParam;
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
     }
 
     interface PaymentRecordReportPaymentAttemptGuaranteedParams {
@@ -384,7 +384,7 @@ declare module 'stripe' {
        */
       expand?: Array<string>;
 
-      metadata?: Stripe.MetadataParam;
+      metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
     }
 
     class PaymentRecordsResource {

package/types/Payouts.d.ts

@@ -5,9 +5,9 @@ declare module 'stripe' {
     /**
      * A `Payout` object is created when you receive funds from Stripe, or when you
      * initiate a payout to either a bank account or debit card of a [connected
-     * Stripe account](https://stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
+     * Stripe account](https://docs.stripe.com/docs/connect/bank-debit-card-payouts). You can retrieve individual payouts,
      * and list all payouts. Payouts are made on [varying
-     * schedules](https://stripe.com/docs/connect/manage-payout-schedule), depending on your country and
+     * schedules](https://docs.stripe.com/docs/connect/manage-payout-schedule), depending on your country and
      * industry.
      *
      * Related guide: [Receiving payouts](https://stripe.com/docs/payouts)

package/types/PayoutsResource.d.ts

@@ -127,11 +127,11 @@ declare module 'stripe' {
 
     class PayoutsResource {
       /**
-       * To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://stripe.com/docs/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
+       * To send funds to your own bank account, create a new payout object. Your [Stripe balance](https://docs.stripe.com/api#balance) must cover the payout amount. If it doesn't, you receive an “Insufficient Funds” error.
        *
        * If your API key is in test mode, money won't actually be sent, though every other action occurs as if you're in live mode.
        *
-       * If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://stripe.com/docs/api#balance_object) details available and pending amounts by source type.
+       * If you create a manual payout on a Stripe account that uses multiple payment source types, you need to specify the source type balance that the payout draws from. The [balance object](https://docs.stripe.com/api#balance_object) details available and pending amounts by source type.
        */
       create(
         params: PayoutCreateParams,

package/types/Persons.d.ts

@@ -25,9 +25,9 @@ declare module 'stripe' {
     /**
      * This is an object representing a person associated with a Stripe account.
      *
-     * A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
+     * A platform can only access a subset of data in a person for an account where [account.controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`, which includes Standard and Express accounts, after creating an Account Link or Account Session to start Connect onboarding.
      *
-     * See the [Standard onboarding](https://stripe.com/connect/standard-accounts) or [Express onboarding](https://stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://stripe.com/connect/handling-api-verification#person-information).
+     * See the [Standard onboarding](https://docs.stripe.com/connect/standard-accounts) or [Express onboarding](https://docs.stripe.com/connect/express-accounts) documentation for information about prefilling information and account onboarding steps. Learn more about [handling identity verification with the API](https://docs.stripe.com/connect/handling-api-verification#person-information).
      */
     interface Person {
       /**
@@ -72,27 +72,27 @@ declare module 'stripe' {
       dob?: Person.Dob;
 
       /**
-       * The person's email address. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's email address. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       email?: string | null;
 
       /**
-       * The person's first name. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's first name. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name?: string | null;
 
       /**
-       * The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kana variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name_kana?: string | null;
 
       /**
-       * The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kanji variation of the person's first name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       first_name_kanji?: string | null;
 
       /**
-       * A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * A list of alternate names or aliases that the person is known by. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       full_name_aliases?: Array<string>;
 
@@ -117,17 +117,17 @@ declare module 'stripe' {
       id_number_secondary_provided?: boolean;
 
       /**
-       * The person's last name. Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The person's last name. Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name?: string | null;
 
       /**
-       * The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kana variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name_kana?: string | null;
 
       /**
-       * The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
+       * The Kanji variation of the person's last name (Japan only). Also available for accounts where [controller.requirement_collection](https://docs.stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `stripe`.
        */
       last_name_kanji?: string | null;
 

package/types/PlansResource.d.ts

@@ -248,7 +248,7 @@ declare module 'stripe' {
 
     class PlansResource {
       /**
-       * You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
+       * You can now model subscriptions more flexibly using the [Prices API](https://docs.stripe.com/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
        */
       create(
         params: PlanCreateParams,

package/types/PricesResource.d.ts

@@ -606,7 +606,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Price>>;
 
       /**
-       * Returns a list of your active prices, excluding [inline prices](https://stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
+       * Returns a list of your active prices, excluding [inline prices](https://docs.stripe.com/docs/products-prices/pricing-models#inline-pricing). For the list of inactive prices, set active to false.
        */
       list(
         params?: PriceListParams,
@@ -615,7 +615,7 @@ declare module 'stripe' {
       list(options?: RequestOptions): ApiListPromise<Stripe.Price>;
 
       /**
-       * Search for prices you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+       * Search for prices you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
        * Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
        * conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
        * to an hour behind during outages. Search functionality is not available to merchants in India.

package/types/Privacy/RedactionJobValidationErrors.d.ts

@@ -4,7 +4,9 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Privacy {
       /**
-       * Validation errors
+       * The Redaction Job validation error object contains information about
+       * errors that affect the ability to redact a specific object in a
+       * redaction job.
        */
       interface RedactionJobValidationError {
         /**
@@ -17,14 +19,42 @@ declare module 'stripe' {
          */
         object: 'privacy.redaction_job_validation_error';
 
-        code: string;
+        /**
+         * A code indicating the reason for the error.
+         */
+        code: RedactionJobValidationError.Code;
 
-        erroring_object: {
-          [key: string]: string;
-        } | null;
+        /**
+         * If the error is related to a specific object, this field includes the object's identifier and object type.
+         */
+        erroring_object: RedactionJobValidationError.ErroringObject | null;
 
+        /**
+         * A human-readable message providing more details about the error.
+         */
         message: string;
       }
+
+      namespace RedactionJobValidationError {
+        type Code =
+          | 'invalid_cascading_source'
+          | 'invalid_file_purpose'
+          | 'invalid_state'
+          | 'locked_by_other_job'
+          | 'too_many_objects';
+
+        interface ErroringObject {
+          /**
+           * Unique identifier for the object.
+           */
+          id: string;
+
+          /**
+           * Erroring object type
+           */
+          object_type: string;
+        }
+      }
     }
   }
 }

package/types/Privacy/RedactionJobs.d.ts

@@ -4,8 +4,10 @@ declare module 'stripe' {
   namespace Stripe {
     namespace Privacy {
       /**
-       * Redaction Jobs store the status of a redaction request. They are created
-       * when a redaction request is made and track the redaction validation and execution.
+       * The Redaction Job object redacts Stripe objects. You can use it
+       * to coordinate the removal of personal information from selected
+       * objects, making them permanently inaccessible in the Stripe Dashboard
+       * and API.
        */
       interface RedactionJob {
         /**
@@ -24,41 +26,85 @@ declare module 'stripe' {
         created: number;
 
         /**
-         * The objects at the root level that are subject to redaction.
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * The objects to redact in this job.
          */
         objects?: RedactionJob.Objects | null;
 
         /**
-         * The status field represents the current state of the redaction job. It can take on any of the following values: VALIDATING, READY, REDACTING, SUCCEEDED, CANCELED, FAILED.
+         * The status of the job.
          */
-        status: string;
+        status: RedactionJob.Status;
 
         /**
-         * Default is "error". If "error", we will make sure all objects in the graph are redactable in the 1st traversal, otherwise error. If "fix", where possible, we will auto-fix any validation errors (e.g. by auto-transitioning objects to a terminal state, etc.) in the 2nd traversal before redacting
+         * Validation behavior determines how a job validates objects for redaction eligibility. Default is `error`.
          */
-        validation_behavior: string | null;
+        validation_behavior: RedactionJob.ValidationBehavior | null;
       }
 
       namespace RedactionJob {
         interface Objects {
+          /**
+           * Charge object identifiers usually starting with `ch_`
+           */
           charges: Array<string> | null;
 
+          /**
+           * CheckoutSession object identifiers starting with `cs_`
+           */
           checkout_sessions: Array<string> | null;
 
+          /**
+           * Customer object identifiers starting with `cus_`
+           */
           customers: Array<string> | null;
 
+          /**
+           * Identity VerificationSessions object identifiers starting with `vs_`
+           */
           identity_verification_sessions: Array<string> | null;
 
+          /**
+           * Invoice object identifiers starting with `in_`
+           */
           invoices: Array<string> | null;
 
+          /**
+           * Issuing Cardholder object identifiers starting with `ich_`
+           */
           issuing_cardholders: Array<string> | null;
 
+          /**
+           * PaymentIntent object identifiers starting with `pi_`
+           */
           payment_intents: Array<string> | null;
 
+          /**
+           * Fraud ValueListItem object identifiers starting with `rsli_`
+           */
           radar_value_list_items: Array<string> | null;
 
+          /**
+           * SetupIntent object identifiers starting with `seti_`
+           */
           setup_intents: Array<string> | null;
         }
+
+        type Status =
+          | 'canceled'
+          | 'canceling'
+          | 'created'
+          | 'failed'
+          | 'ready'
+          | 'redacting'
+          | 'succeeded'
+          | 'validating';
+
+        type ValidationBehavior = 'error' | 'fix';
       }
     }
   }

package/types/Privacy/RedactionJobsResource.d.ts

@@ -5,7 +5,7 @@ declare module 'stripe' {
     namespace Privacy {
       interface RedactionJobCreateParams {
         /**
-         * The objects at the root level that are subject to redaction.
+         * The objects to redact. These root objects and their related ones will be validated for redaction.
          */
         objects: RedactionJobCreateParams.Objects;
 
@@ -15,10 +15,7 @@ declare module 'stripe' {
         expand?: Array<string>;
 
         /**
-         * Default is "error". If "error", we will make sure all objects in the graph are
-         * redactable in the 1st traversal, otherwise error. If "fix", where possible, we will
-         * auto-fix any validation errors (e.g. by auto-transitioning objects to a terminal
-         * state, etc.) in the 2nd traversal before redacting
+         * Determines the validation behavior of the job. Default is `error`.
          */
         validation_behavior?: RedactionJobCreateParams.ValidationBehavior;
       }
@@ -62,6 +59,9 @@ declare module 'stripe' {
          */
         expand?: Array<string>;
 
+        /**
+         * Determines the validation behavior of the job. Default is `error`.
+         */
         validation_behavior?: RedactionJobUpdateParams.ValidationBehavior;
       }
 
@@ -121,7 +121,7 @@ declare module 'stripe' {
 
       class RedactionJobsResource {
         /**
-         * Create redaction job method
+         * Creates a redaction job. When a job is created, it will start to validate.
          */
         create(
           params: RedactionJobCreateParams,
@@ -129,7 +129,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Privacy.RedactionJob>>;
 
         /**
-         * Retrieve redaction job method
+         * Retrieves the details of a previously created redaction job.
          */
         retrieve(
           id: string,
@@ -142,7 +142,9 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Privacy.RedactionJob>>;
 
         /**
-         * Update redaction job method
+         * Updates the properties of a redaction job without running or canceling the job.
+         *
+         * If the job to update is in a failed status, it will not automatically start to validate. Once you applied all of the changes, use the validate API to start validation again.
          */
         update(
           id: string,
@@ -151,7 +153,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Privacy.RedactionJob>>;
 
         /**
-         * List redaction jobs method...
+         * Returns a list of redaction jobs.
          */
         list(
           params?: RedactionJobListParams,
@@ -162,7 +164,9 @@ declare module 'stripe' {
         ): ApiListPromise<Stripe.Privacy.RedactionJob>;
 
         /**
-         * Cancel redaction job method
+         * You can cancel a redaction job when it's in one of these statuses: ready, failed.
+         *
+         * Canceling the redaction job will abandon its attempt to redact the configured objects. A canceled job cannot be used again.
          */
         cancel(
           id: string,
@@ -175,7 +179,7 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Privacy.RedactionJob>>;
 
         /**
-         * List validation errors method
+         * Returns a list of validation errors for the specified redaction job.
          */
         listValidationErrors(
           id: string,
@@ -188,7 +192,11 @@ declare module 'stripe' {
         ): ApiListPromise<Stripe.Privacy.RedactionJobValidationError>;
 
         /**
-         * Run redaction job method
+         * Run a redaction job in a ready status.
+         *
+         * When you run a job, the configured objects will be redacted asynchronously. This action is irreversible and cannot be canceled once started.
+         *
+         * The status of the job will move to redacting. Once all of the objects are redacted, the status will become succeeded. If the job's validation_behavior is set to fix, the automatic fixes will be applied to objects at this step.
          */
         run(
           id: string,
@@ -201,7 +209,11 @@ declare module 'stripe' {
         ): Promise<Stripe.Response<Stripe.Privacy.RedactionJob>>;
 
         /**
-         * Validate redaction job method
+         * Validate a redaction job when it is in a failed status.
+         *
+         * When a job is created, it automatically begins to validate on the configured objects' eligibility for redaction. Use this to validate the job again after its validation errors are resolved or the job's validation_behavior is changed.
+         *
+         * The status of the job will move to validating. Once all of the objects are validated, the status of the job will become ready. If there are any validation errors preventing the job from running, the status will become failed.
          */
         validate(
           id: string,

package/types/Products.d.ts

@@ -98,11 +98,6 @@ declare module 'stripe' {
        */
       package_dimensions: Product.PackageDimensions | null;
 
-      /**
-       * Provisioning configuration for this product.
-       */
-      provisioning?: Product.Provisioning | null;
-
       /**
        * Whether this product is shipped (i.e., physical goods).
        */
@@ -169,40 +164,6 @@ declare module 'stripe' {
         width: number;
       }
 
-      interface Provisioning {
-        gift_card: Provisioning.GiftCard | null;
-
-        /**
-         * The type of provisioning, only `gift_card` currently supported.
-         */
-        type: 'gift_card';
-      }
-
-      namespace Provisioning {
-        interface GiftCard {
-          fixed_amount: GiftCard.FixedAmount | null;
-
-          /**
-           * The specific type of gift_card provisioning, only `fixed_amount` currently supported.
-           */
-          type: 'fixed_amount';
-        }
-
-        namespace GiftCard {
-          interface FixedAmount {
-            /**
-             * The initial amount with which the provisioned gift card will be created.
-             */
-            amount: number;
-
-            /**
-             * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
-             */
-            currency: string;
-          }
-        }
-      }
-
       type Type = 'good' | 'service';
     }
   }

package/types/ProductsResource.d.ts

@@ -53,11 +53,6 @@ declare module 'stripe' {
        */
       package_dimensions?: ProductCreateParams.PackageDimensions;
 
-      /**
-       * Provisioning configuration for this product.
-       */
-      provisioning?: ProductCreateParams.Provisioning;
-
       /**
        * Whether this product is shipped (i.e., physical goods).
        */
@@ -288,37 +283,6 @@ declare module 'stripe' {
         width: number;
       }
 
-      interface Provisioning {
-        gift_card?: Provisioning.GiftCard;
-
-        /**
-         * The type of provisioning, only `gift_card` currently supported.
-         */
-        type: 'gift_card';
-      }
-
-      namespace Provisioning {
-        interface GiftCard {
-          fixed_amount?: GiftCard.FixedAmount;
-
-          /**
-           * The specific type of gift_card provisioning, only `fixed_amount` currently supported.
-           */
-          type: 'fixed_amount';
-        }
-
-        namespace GiftCard {
-          interface FixedAmount {
-            /**
-             * The initial amount with which the provisioned gift card will be created.
-             */
-            amount: number;
-
-            currency: string;
-          }
-        }
-      }
-
       type Type = 'good' | 'service';
     }
 
@@ -638,7 +602,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.ProductFeature>>;
 
       /**
-       * Search for products you've previously created using Stripe's [Search Query Language](https://stripe.com/docs/search#search-query-language).
+       * Search for products you've previously created using Stripe's [Search Query Language](https://docs.stripe.com/docs/search#search-query-language).
        * Don't use search in read-after-write flows where strict consistency is necessary. Under normal operating
        * conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up
        * to an hour behind during outages. Search functionality is not available to merchants in India.