stripe 8.191.0 → 8.195.0

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # CHANGELOG
 
+## 8.195.0 - 2021-12-22
+* [#1314](https://github.com/stripe/stripe-node/pull/1314) API Updates
+  * Add support for `au_becs_debit` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+  * Change type of `PaymentIntent.processing.type` from `string` to `literal('card')`. This is not considered a breaking change as the field was added in the same release.
+* [#1313](https://github.com/stripe/stripe-node/pull/1313) API Updates
+  * Add support for new values `en-FR`, `es-US`, and `fr-FR` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
+  * Add support for `boleto` on `SetupAttempt.payment_method_details`
+  
+* [#1312](https://github.com/stripe/stripe-node/pull/1312) API Updates
+  * Add support for `processing` on `PaymentIntent`
+
+## 8.194.0 - 2021-12-15
+* [#1309](https://github.com/stripe/stripe-node/pull/1309) API Updates
+  * Add support for new resource `PaymentIntentTypeSpecificPaymentMethodOptionsClient`
+  * Add support for `setup_future_usage` on `PaymentIntentCreateParams.payment_method_options.card`, `PaymentIntentUpdateParams.payment_method_options.card`, `PaymentIntentConfirmParams.payment_method_options.card`, and `PaymentIntent.payment_method_options.card`
+
+## 8.193.0 - 2021-12-09
+* [#1308](https://github.com/stripe/stripe-node/pull/1308) API Updates
+  * Add support for `metadata` on `BillingPortalConfigurationCreateParams`, `BillingPortalConfigurationUpdateParams`, and `BillingPortal.Configuration`
+
+## 8.192.0 - 2021-12-09
+* [#1307](https://github.com/stripe/stripe-node/pull/1307) API Updates
+  * Add support for new values `ge_vat` and `ua_vat` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, and `TaxId.type`
+  * Add support for new values `ge_vat` and `ua_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  * Change type of `PaymentIntentCreateParams.payment_method_data.billing_details.email`, `PaymentIntentUpdateParams.payment_method_data.billing_details.email`, `PaymentIntentConfirmParams.payment_method_data.billing_details.email`, `PaymentMethodCreateParams.billing_details.email`, and `PaymentMethodUpdateParams.billing_details.email` from `string` to `emptyStringable(string)`
+  * Add support for `giropay` on `PaymentIntentCreateParams.payment_method_options`, `PaymentIntentUpdateParams.payment_method_options`, `PaymentIntentConfirmParams.payment_method_options`, and `PaymentIntent.payment_method_options`
+  * Add support for new value `en-IE` on enums `PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale`, `PaymentIntentUpdateParams.payment_method_options.klarna.preferred_locale`, and `PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale`
+* [#1301](https://github.com/stripe/stripe-node/pull/1301) Remove coveralls from package.json
+* [#1300](https://github.com/stripe/stripe-node/pull/1300) Fix broken link in docstring
+
 ## 8.191.0 - 2021-11-19
 * [#1299](https://github.com/stripe/stripe-node/pull/1299) API Updates
   * Add support for `wallets` on `Issuing.Card`

package/README.md

@@ -2,7 +2,6 @@
 
 [![Version](https://img.shields.io/npm/v/stripe.svg)](https://www.npmjs.org/package/stripe)
 [![Build Status](https://travis-ci.org/stripe/stripe-node.svg?branch=master)](https://travis-ci.org/stripe/stripe-node)
-[![Coverage Status](https://coveralls.io/repos/github/stripe/stripe-node/badge.svg)](https://coveralls.io/github/stripe/stripe-node)
 [![Downloads](https://img.shields.io/npm/dm/stripe.svg)](https://www.npmjs.com/package/stripe)
 [![Try on RunKit](https://badge.runkitcdn.com/stripe.svg)](https://runkit.com/npm/stripe)
 

package/VERSION

@@ -1 +1 @@
-8.191.0
+8.195.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "8.191.0",
+  "version": "8.195.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",
@@ -31,7 +31,6 @@
     "@typescript-eslint/parser": "^2.13.0",
     "chai": "~4.2.0",
     "chai-as-promised": "~7.1.1",
-    "coveralls": "^3.0.0",
     "eslint": "^6.8.0",
     "eslint-config-prettier": "^4.1.0",
     "eslint-plugin-chai-friendly": "^0.4.0",

package/types/2020-08-27/BillingPortal/Configurations.d.ts

@@ -51,6 +51,11 @@ declare module 'stripe' {
          */
         livemode: boolean;
 
+        /**
+         * 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;
+
         /**
          * Time at which the object was last updated. Measured in seconds since the Unix epoch.
          */
@@ -251,6 +256,11 @@ declare module 'stripe' {
          * Specifies which fields in the response should be expanded.
          */
         expand?: Array<string>;
+
+        /**
+         * 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;
       }
 
       namespace ConfigurationCreateParams {
@@ -482,6 +492,11 @@ declare module 'stripe' {
          * Information about the features available in the portal.
          */
         features?: ConfigurationUpdateParams.Features;
+
+        /**
+         * 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.Emptyable<Stripe.MetadataParam>;
       }
 
       namespace ConfigurationUpdateParams {

package/types/2020-08-27/Capabilities.d.ts

@@ -187,7 +187,7 @@ declare module 'stripe' {
          *
          * - [Afterpay Clearpay's terms of service](https://stripe.com/afterpay-clearpay/legal#restricted-businesses)
          *
-         * If you believe that the rejection is in error, please contact support@stripe.com for assistance.
+         * If you believe that the rejection is in error, please contact support at https://support.stripe.com/contact/ for assistance.
          */
         disabled_reason: string | null;
 

package/types/2020-08-27/Charges.d.ts

@@ -1419,7 +1419,7 @@ declare module 'stripe' {
 
           /**
            * Preferred language of the Klarna authorization page that the customer is redirected to.
-           * Can be one of `de-AT`, `en-AT`, `nl-BE`, `fr-BE`, `en-BE`, `de-DE`, `en-DE`, `da-DK`, `en-DK`, `es-ES`, `en-ES`, `fi-FI`, `sv-FI`, `en-FI`, `en-GB`, `it-IT`, `en-IT`, `nl-NL`, `en-NL`, `nb-NO`, `en-NO`, `sv-SE`, `en-SE`, `en-US`, `fr-FR`, or `en-FR`
+           * Can be one of `de-AT`, `en-AT`, `nl-BE`, `fr-BE`, `en-BE`, `de-DE`, `en-DE`, `da-DK`, `en-DK`, `es-ES`, `en-ES`, `fi-FI`, `sv-FI`, `en-FI`, `en-GB`, `en-IE`, `it-IT`, `en-IT`, `nl-NL`, `en-NL`, `nb-NO`, `en-NO`, `sv-SE`, `en-SE`, `en-US`, `es-US`, `fr-FR`, or `en-FR`
            */
           preferred_locale: string | null;
         }

package/types/2020-08-27/Checkout/Sessions.d.ts

@@ -317,7 +317,7 @@ declare module 'stripe' {
 
           interface TaxId {
             /**
-             * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, or `unknown`
+             * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, or `unknown`
              */
             type: TaxId.Type;
 
@@ -345,6 +345,7 @@ declare module 'stripe' {
               | 'es_cif'
               | 'eu_vat'
               | 'gb_vat'
+              | 'ge_vat'
               | 'hk_br'
               | 'id_npwp'
               | 'il_vat'
@@ -366,6 +367,7 @@ declare module 'stripe' {
               | 'sg_uen'
               | 'th_vat'
               | 'tw_vat'
+              | 'ua_vat'
               | 'unknown'
               | 'us_ein'
               | 'za_vat';

package/types/2020-08-27/Customers.d.ts

@@ -420,7 +420,7 @@ declare module 'stripe' {
 
       interface TaxIdDatum {
         /**
-         * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `us_ein`, or `za_vat`
+         * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
          */
         type: TaxIdDatum.Type;
 
@@ -448,6 +448,7 @@ declare module 'stripe' {
           | 'es_cif'
           | 'eu_vat'
           | 'gb_vat'
+          | 'ge_vat'
           | 'hk_br'
           | 'id_npwp'
           | 'il_vat'
@@ -469,6 +470,7 @@ declare module 'stripe' {
           | 'sg_uen'
           | 'th_vat'
           | 'tw_vat'
+          | 'ua_vat'
           | 'us_ein'
           | 'za_vat';
       }
@@ -713,7 +715,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Customer>>;
 
       /**
-       * Retrieves the details of an existing customer. You need only supply the unique customer identifier that was returned upon customer creation.
+       * Retrieves a Customer object.
        */
       retrieve(
         id: string,

package/types/2020-08-27/Discounts.d.ts

@@ -24,7 +24,7 @@ declare module 'stripe' {
       /**
        * A coupon contains information about a percent-off or amount-off discount you
        * might want to apply to a customer. Coupons may be applied to [invoices](https://stripe.com/docs/api#invoices) or
-       * [orders](https://stripe.com/docs/api#create_order-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
+       * [orders](https://stripe.com/docs/api#create_order_legacy-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
        */
       coupon: Stripe.Coupon;
 
@@ -88,7 +88,7 @@ declare module 'stripe' {
       /**
        * A coupon contains information about a percent-off or amount-off discount you
        * might want to apply to a customer. Coupons may be applied to [invoices](https://stripe.com/docs/api#invoices) or
-       * [orders](https://stripe.com/docs/api#create_order-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
+       * [orders](https://stripe.com/docs/api#create_order_legacy-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
        */
       coupon: Stripe.Coupon;
 

package/types/2020-08-27/InvoiceLineItems.d.ts

@@ -268,7 +268,7 @@ declare module 'stripe' {
       subscription_trial_end?: 'now' | number;
 
       /**
-       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       subscription_trial_from_plan?: boolean;
     }
@@ -347,7 +347,7 @@ declare module 'stripe' {
 
         interface TaxId {
           /**
-           * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `us_ein`, or `za_vat`
+           * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
            */
           type: TaxId.Type;
 
@@ -375,6 +375,7 @@ declare module 'stripe' {
             | 'es_cif'
             | 'eu_vat'
             | 'gb_vat'
+            | 'ge_vat'
             | 'hk_br'
             | 'id_npwp'
             | 'il_vat'
@@ -396,6 +397,7 @@ declare module 'stripe' {
             | 'sg_uen'
             | 'th_vat'
             | 'tw_vat'
+            | 'ua_vat'
             | 'us_ein'
             | 'za_vat';
         }

package/types/2020-08-27/Invoices.d.ts

@@ -399,7 +399,7 @@ declare module 'stripe' {
 
       interface CustomerTaxId {
         /**
-         * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, or `unknown`
+         * The type of the tax ID, one of `eu_vat`, `br_cnpj`, `br_cpf`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `li_uid`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, or `unknown`
          */
         type: CustomerTaxId.Type;
 
@@ -427,6 +427,7 @@ declare module 'stripe' {
           | 'es_cif'
           | 'eu_vat'
           | 'gb_vat'
+          | 'ge_vat'
           | 'hk_br'
           | 'id_npwp'
           | 'il_vat'
@@ -448,6 +449,7 @@ declare module 'stripe' {
           | 'sg_uen'
           | 'th_vat'
           | 'tw_vat'
+          | 'ua_vat'
           | 'unknown'
           | 'us_ein'
           | 'za_vat';
@@ -1339,7 +1341,7 @@ declare module 'stripe' {
 
     interface InvoiceFinalizeInvoiceParams {
       /**
-       * Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/billing/invoices/overview#auto-advance) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action.
+       * Controls whether Stripe will perform [automatic collection](https://stripe.com/docs/invoicing/automatic-charging) of the invoice. When `false`, the invoice's state will not automatically advance without an explicit action.
        */
       auto_advance?: boolean;
 
@@ -1497,7 +1499,7 @@ declare module 'stripe' {
       subscription_trial_end?: 'now' | number;
 
       /**
-       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `subscription_trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `subscription_trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       subscription_trial_from_plan?: boolean;
     }
@@ -1576,7 +1578,7 @@ declare module 'stripe' {
 
         interface TaxId {
           /**
-           * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `us_ein`, or `za_vat`
+           * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
            */
           type: TaxId.Type;
 
@@ -1604,6 +1606,7 @@ declare module 'stripe' {
             | 'es_cif'
             | 'eu_vat'
             | 'gb_vat'
+            | 'ge_vat'
             | 'hk_br'
             | 'id_npwp'
             | 'il_vat'
@@ -1625,6 +1628,7 @@ declare module 'stripe' {
             | 'sg_uen'
             | 'th_vat'
             | 'tw_vat'
+            | 'ua_vat'
             | 'us_ein'
             | 'za_vat';
         }

package/types/2020-08-27/Issuing/Cardholders.d.ts

@@ -1109,7 +1109,7 @@ declare module 'stripe' {
         billing: CardholderCreateParams.Billing;
 
         /**
-         * The cardholder's name. This will be printed on cards issued to them.
+         * The cardholder's name. This will be printed on cards issued to them. The maximum length of this field is 24 characters.
          */
         name: string;
 

package/types/2020-08-27/PaymentIntents.d.ts

@@ -146,6 +146,11 @@ declare module 'stripe' {
        */
       payment_method_types: Array<string>;
 
+      /**
+       * If present, this property tells you about the processing state of the payment.
+       */
+      processing: PaymentIntent.Processing | null;
+
       /**
        * Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
        */
@@ -511,6 +516,8 @@ declare module 'stripe' {
 
         alipay?: PaymentMethodOptions.Alipay;
 
+        au_becs_debit?: PaymentMethodOptions.AuBecsDebit;
+
         bancontact?: PaymentMethodOptions.Bancontact;
 
         boleto?: PaymentMethodOptions.Boleto;
@@ -519,6 +526,8 @@ declare module 'stripe' {
 
         card_present?: PaymentMethodOptions.CardPresent;
 
+        giropay?: PaymentMethodOptions.Giropay;
+
         ideal?: PaymentMethodOptions.Ideal;
 
         interac_present?: PaymentMethodOptions.InteracPresent;
@@ -588,6 +597,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -623,6 +634,15 @@ declare module 'stripe' {
            * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
            */
           request_three_d_secure: Card.RequestThreeDSecure | null;
+
+          /**
+           * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+           *
+           * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+           *
+           * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+           */
+          setup_future_usage?: Card.SetupFutureUsage;
         }
 
         namespace Card {
@@ -694,10 +714,14 @@ declare module 'stripe' {
             | 'visa';
 
           type RequestThreeDSecure = 'any' | 'automatic' | 'challenge_only';
+
+          type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
 
         interface CardPresent {}
 
+        interface Giropay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -761,6 +785,19 @@ declare module 'stripe' {
         }
       }
 
+      interface Processing {
+        card?: Processing.Card;
+
+        /**
+         * Type of the payment method for which payment is in `processing` state, one of `card`.
+         */
+        type: 'card';
+      }
+
+      namespace Processing {
+        interface Card {}
+      }
+
       type SetupFutureUsage = 'off_session' | 'on_session';
 
       interface Shipping {
@@ -1200,7 +1237,7 @@ declare module 'stripe' {
           /**
            * Email address.
            */
-          email?: string;
+          email?: Stripe.Emptyable<string>;
 
           /**
            * Full name.
@@ -1456,6 +1493,11 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -1476,6 +1518,11 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
+         */
+        giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -1574,6 +1621,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -1621,6 +1670,17 @@ declare module 'stripe' {
            * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
            */
           request_three_d_secure?: Card.RequestThreeDSecure;
+
+          /**
+           * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+           *
+           * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+           *
+           * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+           *
+           * If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.
+           */
+          setup_future_usage?: Stripe.Emptyable<Card.SetupFutureUsage>;
         }
 
         namespace Card {
@@ -1672,10 +1732,14 @@ declare module 'stripe' {
             | 'visa';
 
           type RequestThreeDSecure = 'any' | 'automatic';
+
+          type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
 
         interface CardPresent {}
 
+        interface Giropay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -1698,15 +1762,19 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
+            | 'en-IE'
             | 'en-IT'
             | 'en-NL'
             | 'en-NO'
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'
@@ -2120,7 +2188,7 @@ declare module 'stripe' {
           /**
            * Email address.
            */
-          email?: string;
+          email?: Stripe.Emptyable<string>;
 
           /**
            * Full name.
@@ -2376,6 +2444,11 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -2396,6 +2469,11 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
+         */
+        giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -2494,6 +2572,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -2541,6 +2621,17 @@ declare module 'stripe' {
            * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
            */
           request_three_d_secure?: Card.RequestThreeDSecure;
+
+          /**
+           * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+           *
+           * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+           *
+           * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+           *
+           * If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.
+           */
+          setup_future_usage?: Stripe.Emptyable<Card.SetupFutureUsage>;
         }
 
         namespace Card {
@@ -2592,10 +2683,14 @@ declare module 'stripe' {
             | 'visa';
 
           type RequestThreeDSecure = 'any' | 'automatic';
+
+          type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
 
         interface CardPresent {}
 
+        interface Giropay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -2618,15 +2713,19 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
+            | 'en-IE'
             | 'en-IT'
             | 'en-NL'
             | 'en-NO'
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'
@@ -3154,7 +3253,7 @@ declare module 'stripe' {
           /**
            * Email address.
            */
-          email?: string;
+          email?: Stripe.Emptyable<string>;
 
           /**
            * Full name.
@@ -3410,6 +3509,11 @@ declare module 'stripe' {
          */
         alipay?: Stripe.Emptyable<PaymentMethodOptions.Alipay>;
 
+        /**
+         * If this is a `au_becs_debit` PaymentMethod, this sub-hash contains details about the AU BECS Direct Debit payment method options.
+         */
+        au_becs_debit?: Stripe.Emptyable<PaymentMethodOptions.AuBecsDebit>;
+
         /**
          * If this is a `bancontact` PaymentMethod, this sub-hash contains details about the Bancontact payment method options.
          */
@@ -3430,6 +3534,11 @@ declare module 'stripe' {
          */
         card_present?: Stripe.Emptyable<PaymentMethodOptions.CardPresent>;
 
+        /**
+         * If this is a `giropay` PaymentMethod, this sub-hash contains details about the Giropay payment method options.
+         */
+        giropay?: Stripe.Emptyable<PaymentMethodOptions.Giropay>;
+
         /**
          * If this is a `ideal` PaymentMethod, this sub-hash contains details about the Ideal payment method options.
          */
@@ -3528,6 +3637,8 @@ declare module 'stripe' {
 
         interface Alipay {}
 
+        interface AuBecsDebit {}
+
         interface Bancontact {
           /**
            * Preferred language of the Bancontact authorization page that the customer is redirected to.
@@ -3575,6 +3686,17 @@ declare module 'stripe' {
            * We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. Permitted values include: `automatic` or `any`. If not provided, defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
            */
           request_three_d_secure?: Card.RequestThreeDSecure;
+
+          /**
+           * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+           *
+           * Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.
+           *
+           * When processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).
+           *
+           * If `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.
+           */
+          setup_future_usage?: Stripe.Emptyable<Card.SetupFutureUsage>;
         }
 
         namespace Card {
@@ -3626,10 +3748,14 @@ declare module 'stripe' {
             | 'visa';
 
           type RequestThreeDSecure = 'any' | 'automatic';
+
+          type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
         }
 
         interface CardPresent {}
 
+        interface Giropay {}
+
         interface Ideal {}
 
         interface InteracPresent {}
@@ -3652,15 +3778,19 @@ declare module 'stripe' {
             | 'en-DK'
             | 'en-ES'
             | 'en-FI'
+            | 'en-FR'
             | 'en-GB'
+            | 'en-IE'
             | 'en-IT'
             | 'en-NL'
             | 'en-NO'
             | 'en-SE'
             | 'en-US'
             | 'es-ES'
+            | 'es-US'
             | 'fi-FI'
             | 'fr-BE'
+            | 'fr-FR'
             | 'it-IT'
             | 'nb-NO'
             | 'nl-BE'

package/types/2020-08-27/PaymentMethods.d.ts

@@ -842,7 +842,7 @@ declare module 'stripe' {
         /**
          * Email address.
          */
-        email?: string;
+        email?: Stripe.Emptyable<string>;
 
         /**
          * Full name.
@@ -1172,7 +1172,7 @@ declare module 'stripe' {
         /**
          * Email address.
          */
-        email?: string;
+        email?: Stripe.Emptyable<string>;
 
         /**
          * Full name.

package/types/2020-08-27/Persons.d.ts

@@ -345,7 +345,7 @@ declare module 'stripe' {
 
       interface Relationship {
         /**
-         * Whether the person is a director of the account's legal entity. Currently only required for accounts in the EU. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+         * Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
          */
         director: boolean | null;
 
@@ -769,7 +769,7 @@ declare module 'stripe' {
 
       interface Relationship {
         /**
-         * Whether the person is a director of the account's legal entity. Currently only required for accounts in the EU. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+         * Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
          */
         director?: boolean;
 
@@ -1036,7 +1036,7 @@ declare module 'stripe' {
 
       interface Relationship {
         /**
-         * Whether the person is a director of the account's legal entity. Currently only required for accounts in the EU. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+         * Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
          */
         director?: boolean;
 

package/types/2020-08-27/PromotionCodes.d.ts

@@ -29,7 +29,7 @@ declare module 'stripe' {
       /**
        * A coupon contains information about a percent-off or amount-off discount you
        * might want to apply to a customer. Coupons may be applied to [invoices](https://stripe.com/docs/api#invoices) or
-       * [orders](https://stripe.com/docs/api#create_order-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
+       * [orders](https://stripe.com/docs/api#create_order_legacy-coupon). Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge).
        */
       coupon: Stripe.Coupon;
 
@@ -222,7 +222,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.PromotionCode>>;
 
       /**
-       * Retrieves the promotion code with the given ID.
+       * Retrieves the promotion code with the given ID. In order to retrieve a promotion code by the customer-facing code use [list](https://stripe.com/docs/api/promotion_codes/list) with the desired code.
        */
       retrieve(
         id: string,

package/types/2020-08-27/SetupAttempts.d.ts

@@ -79,6 +79,8 @@ declare module 'stripe' {
 
         bancontact?: PaymentMethodDetails.Bancontact;
 
+        boleto?: PaymentMethodDetails.Boleto;
+
         card?: PaymentMethodDetails.Card;
 
         card_present?: PaymentMethodDetails.CardPresent;
@@ -150,6 +152,8 @@ declare module 'stripe' {
           type PreferredLanguage = 'de' | 'en' | 'fr' | 'nl';
         }
 
+        interface Boleto {}
+
         interface Card {
           /**
            * Populated if this authorization used 3D Secure authentication.

package/types/2020-08-27/Subscriptions.d.ts

@@ -364,7 +364,7 @@ declare module 'stripe' {
         trial_end: number | null;
 
         /**
-         * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+         * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
          */
         trial_from_plan: boolean | null;
       }
@@ -530,17 +530,17 @@ declare module 'stripe' {
       transfer_data?: SubscriptionCreateParams.TransferData;
 
       /**
-       * Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. If set, trial_end will override the default trial period of the plan the customer is being subscribed to. The special value `now` can be provided to end the customer's trial immediately. Can be at most two years from `billing_cycle_anchor`. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. If set, trial_end will override the default trial period of the plan the customer is being subscribed to. The special value `now` can be provided to end the customer's trial immediately. Can be at most two years from `billing_cycle_anchor`. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       trial_end?: 'now' | number;
 
       /**
-       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       trial_from_plan?: boolean;
 
       /**
-       * Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Integer representing the number of trial period days before the customer is charged for the first time. This will always overwrite any trials that might apply via a subscribed plan. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       trial_period_days?: number;
     }
@@ -1013,7 +1013,7 @@ declare module 'stripe' {
       trial_end?: 'now' | number;
 
       /**
-       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](docs/billing/subscriptions/trials) to learn more.
+       * Indicates if a plan's `trial_period_days` should be applied to the subscription. Setting `trial_end` per subscription is preferred, and this defaults to `false`. Setting this flag to `true` together with `trial_end` is not allowed. See [Using trial periods on subscriptions](https://stripe.com/docs/billing/subscriptions/trials) to learn more.
        */
       trial_from_plan?: boolean;
     }

package/types/2020-08-27/TaxIds.d.ts

@@ -39,7 +39,7 @@ declare module 'stripe' {
       livemode: boolean;
 
       /**
-       * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `us_ein`, or `za_vat`. Note that some legacy tax IDs have type `unknown`
+       * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`. Note that some legacy tax IDs have type `unknown`
        */
       type: TaxId.Type;
 
@@ -72,6 +72,7 @@ declare module 'stripe' {
         | 'es_cif'
         | 'eu_vat'
         | 'gb_vat'
+        | 'ge_vat'
         | 'hk_br'
         | 'id_npwp'
         | 'il_vat'
@@ -93,6 +94,7 @@ declare module 'stripe' {
         | 'sg_uen'
         | 'th_vat'
         | 'tw_vat'
+        | 'ua_vat'
         | 'unknown'
         | 'us_ein'
         | 'za_vat';
@@ -141,7 +143,7 @@ declare module 'stripe' {
 
     interface TaxIdCreateParams {
       /**
-       * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `us_ein`, or `za_vat`
+       * Type of the tax ID, one of `ae_trn`, `au_abn`, `au_arn`, `br_cnpj`, `br_cpf`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `ch_vat`, `cl_tin`, `es_cif`, `eu_vat`, `gb_vat`, `ge_vat`, `hk_br`, `id_npwp`, `il_vat`, `in_gst`, `jp_cn`, `jp_rn`, `kr_brn`, `li_uid`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `no_vat`, `nz_gst`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `th_vat`, `tw_vat`, `ua_vat`, `us_ein`, or `za_vat`
        */
       type: TaxIdCreateParams.Type;
 
@@ -174,6 +176,7 @@ declare module 'stripe' {
         | 'es_cif'
         | 'eu_vat'
         | 'gb_vat'
+        | 'ge_vat'
         | 'hk_br'
         | 'id_npwp'
         | 'il_vat'
@@ -195,6 +198,7 @@ declare module 'stripe' {
         | 'sg_uen'
         | 'th_vat'
         | 'tw_vat'
+        | 'ua_vat'
         | 'us_ein'
         | 'za_vat';
     }

package/types/2020-08-27/Terminal/Locations.d.ts

@@ -160,6 +160,7 @@ declare module 'stripe' {
       class LocationsResource {
         /**
          * Creates a new Location object.
+         * For further details, including which address fields are required in each country, see the [Manage locations](https://stripe.com/docs/terminal/fleet/locations) guide.
          */
         create(
           params: LocationCreateParams,

package/types/2020-08-27/Terminal/Readers.d.ts

@@ -109,7 +109,7 @@ declare module 'stripe' {
         label?: string;
 
         /**
-         * The location to assign the reader to. If no location is specified, the reader will be assigned to the account's default location.
+         * The location to assign the reader to.
          */
         location?: string;
 

package/types/2020-08-27/Tokens.d.ts

@@ -712,7 +712,7 @@ declare module 'stripe' {
 
         interface Relationship {
           /**
-           * Whether the person is a director of the account's legal entity. Currently only required for accounts in the EU. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
+           * Whether the person is a director of the account's legal entity. Directors are typically members of the governing board of the company, or responsible for ensuring the company meets its regulatory obligations.
            */
           director?: boolean;
 

package/types/lib.d.ts

@@ -138,7 +138,7 @@ declare module 'stripe' {
       api_key?: string;
 
       /**
-       * See the [idempotency key docs](https://stripe.com/docs/api/idempotency).
+       * See the [idempotency key docs](https://stripe.com/docs/api/idempotent_requests).
        */
       idempotencyKey?: string;
       /** @deprecated Please use idempotencyKey instead. */