stripe 8.199.0 → 8.203.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # CHANGELOG
 
+## 8.203.0 - 2022-02-15
+* [#1350](https://github.com/stripe/stripe-node/pull/1350) API Updates
+  * Add support for `verify_microdeposits` method on resources `PaymentIntent` and `SetupIntent`
+  * Add support for new value `grabpay` on enums `InvoiceCreateParams.payment_settings.payment_method_types[]`, `InvoiceUpdateParams.payment_settings.payment_method_types[]`, `Invoice.payment_settings.payment_method_types[]`, `SubscriptionCreateParams.payment_settings.payment_method_types[]`, `SubscriptionUpdateParams.payment_settings.payment_method_types[]`, and `Subscription.payment_settings.payment_method_types[]`
+* [#1348](https://github.com/stripe/stripe-node/pull/1348) API Updates
+  * Add support for `pin` on `IssuingCardUpdateParams`
+
+## 8.202.0 - 2022-02-03
+* [#1344](https://github.com/stripe/stripe-node/pull/1344) API Updates
+  * Add support for new value `au_becs_debit` on enum `CheckoutSessionCreateParams.payment_method_types[]`
+  * Change type of `Refund.reason` from `string` to `enum('duplicate'|'expired_uncaptured_charge'|'fraudulent'|'requested_by_customer')`
+
+## 8.201.0 - 2022-01-28
+* [#1342](https://github.com/stripe/stripe-node/pull/1342) Bump nanoid from 3.1.20 to 3.2.0.
+* [#1335](https://github.com/stripe/stripe-node/pull/1335) Fix StripeResource to successfully import TIMEOUT_ERROR_CODE.
+* [#1339](https://github.com/stripe/stripe-node/pull/1339) Bump node-fetch from 2.6.2 to 2.6.7
+
+## 8.200.0 - 2022-01-25
+* [#1338](https://github.com/stripe/stripe-node/pull/1338) API Updates
+  * Change `Checkout.Session.payment_link` to be required
+  * Add support for `phone_number_collection` on `PaymentLinkCreateParams` and `PaymentLink`
+  * Add support for new values `payment_link.created` and `payment_link.updated` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+  * Add support for new value `is_vat` on enums `Checkout.Session.customer_details.tax_ids[].type`, `Invoice.customer_tax_ids[].type`, and `TaxId.type`
+  * Add support for new value `is_vat` on enums `CustomerCreateParams.tax_id_data[].type`, `InvoiceUpcomingParams.customer_details.tax_ids[].type`, `InvoiceUpcomingLinesParams.customer_details.tax_ids[].type`, and `TaxIdCreateParams.type`
+  
+* [#1333](https://github.com/stripe/stripe-node/pull/1333) Customer tax_ids is not included by default
+
 ## 8.199.0 - 2022-01-20
 * [#1332](https://github.com/stripe/stripe-node/pull/1332) API Updates
   * Add support for new resource `PaymentLink`

package/VERSION

@@ -1 +1 @@
-8.199.0
+8.203.0

package/lib/StripeResource.js

@@ -12,7 +12,7 @@ const {
   StripeAPIError,
 } = require('./Error');
 
-const HttpClient = require('./net/HttpClient');
+const {HttpClient} = require('./net/HttpClient');
 
 // Provide extension mechanism for Stripe Resource Sub-Classes
 StripeResource.extend = utils.protoExtend;

package/lib/resources/PaymentIntents.js

@@ -43,4 +43,9 @@ module.exports = StripeResource.extend({
     method: 'POST',
     path: '/{intent}/confirm',
   }),
+
+  verifyMicrodeposits: stripeMethod({
+    method: 'POST',
+    path: '/{intent}/verify_microdeposits',
+  }),
 });

package/lib/resources/SetupIntents.js

@@ -38,4 +38,9 @@ module.exports = StripeResource.extend({
     method: 'POST',
     path: '/{intent}/confirm',
   }),
+
+  verifyMicrodeposits: stripeMethod({
+    method: 'POST',
+    path: '/{intent}/verify_microdeposits',
+  }),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "8.199.0",
+  "version": "8.203.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",
@@ -44,7 +44,8 @@
     "typescript": "^3.7.2"
   },
   "resolutions": {
-    "ansi-regex": "5.0.1"
+    "ansi-regex": "5.0.1",
+    "nanoid": "3.2.0"
   },
   "dependencies": {
     "@types/node": ">=8.1.0",

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

@@ -3210,7 +3210,7 @@ declare module 'stripe' {
       /**
        * With [Connect](https://stripe.com/docs/connect), you can delete accounts you manage.
        *
-       * Accounts created using test-mode keys can be deleted at any time. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero.
+       * Accounts created using test-mode keys can be deleted at any time. Standard accounts created using live-mode keys cannot be deleted. Custom or Express accounts created using live-mode keys can only be deleted once all balances are zero.
        *
        * If you want to delete your own account, use the [account information tab in your account settings](https://dashboard.stripe.com/account) instead.
        */

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

@@ -138,7 +138,7 @@ declare module 'stripe' {
         /**
          * The ID of the Payment Link that created this Session.
          */
-        payment_link?: string | Stripe.PaymentLink | null;
+        payment_link: string | Stripe.PaymentLink | null;
 
         /**
          * Payment-method-specific configuration for the PaymentIntent or SetupIntent of this CheckoutSession.
@@ -329,7 +329,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`, `ge_vat`, `ua_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`, `is_vat`, or `unknown`
              */
             type: TaxId.Type;
 
@@ -362,6 +362,7 @@ declare module 'stripe' {
               | 'id_npwp'
               | 'il_vat'
               | 'in_gst'
+              | 'is_vat'
               | 'jp_cn'
               | 'jp_rn'
               | 'kr_brn'
@@ -1363,11 +1364,7 @@ declare module 'stripe' {
 
         interface PaymentIntentData {
           /**
-           * The amount of the application fee (if any) that will be requested to be applied to the payment and
-           * transferred to the application owner's Stripe account. The amount of the application fee collected
-           * will be capped at the total payment amount. To use an application fee, the request must be made on
-           * behalf of another account, using the `Stripe-Account` header or an OAuth key. For more information,
-           * see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
+           * The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total payment amount. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
            */
           application_fee_amount?: number;
 
@@ -1618,6 +1615,7 @@ declare module 'stripe' {
           | 'acss_debit'
           | 'afterpay_clearpay'
           | 'alipay'
+          | 'au_becs_debit'
           | 'bacs_debit'
           | 'bancontact'
           | 'boleto'

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

@@ -129,7 +129,7 @@ declare module 'stripe' {
       /**
        * The customer's tax IDs.
        */
-      tax_ids: ApiList<Stripe.TaxId>;
+      tax_ids?: ApiList<Stripe.TaxId>;
     }
 
     namespace Customer {
@@ -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`, `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 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`, `is_vat`, `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;
 
@@ -453,6 +453,7 @@ declare module 'stripe' {
           | 'id_npwp'
           | 'il_vat'
           | 'in_gst'
+          | 'is_vat'
           | 'jp_cn'
           | 'jp_rn'
           | 'kr_brn'

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

@@ -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`, `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 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`, `is_vat`, `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;
 
@@ -380,6 +380,7 @@ declare module 'stripe' {
             | 'id_npwp'
             | 'il_vat'
             | 'in_gst'
+            | 'is_vat'
             | 'jp_cn'
             | 'jp_rn'
             | 'kr_brn'

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

@@ -404,7 +404,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`, `ge_vat`, `ua_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`, `is_vat`, or `unknown`
          */
         type: CustomerTaxId.Type;
 
@@ -437,6 +437,7 @@ declare module 'stripe' {
           | 'id_npwp'
           | 'il_vat'
           | 'in_gst'
+          | 'is_vat'
           | 'jp_cn'
           | 'jp_rn'
           | 'kr_brn'
@@ -663,6 +664,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1028,6 +1030,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1285,6 +1288,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1583,7 +1587,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`, `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 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`, `is_vat`, `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;
 
@@ -1616,6 +1620,7 @@ declare module 'stripe' {
             | 'id_npwp'
             | 'il_vat'
             | 'in_gst'
+            | 'is_vat'
             | 'jp_cn'
             | 'jp_rn'
             | 'kr_brn'

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

@@ -2218,6 +2218,11 @@ declare module 'stripe' {
          */
         metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
 
+        /**
+         * The desired new PIN for this card.
+         */
+        pin?: CardUpdateParams.Pin;
+
         /**
          * Rules that control spending for this card. Refer to our [documentation](https://stripe.com/docs/issuing/controls/spending-controls) for more details.
          */
@@ -2232,6 +2237,13 @@ declare module 'stripe' {
       namespace CardUpdateParams {
         type CancellationReason = 'lost' | 'stolen';
 
+        interface Pin {
+          /**
+           * The card's desired new PIN, encrypted under Stripe's public key.
+           */
+          encrypted_number?: string;
+        }
+
         interface SpendingControls {
           /**
            * Array of strings containing [categories](https://stripe.com/docs/api#issuing_authorization_object-merchant_data-category) of authorizations to allow. All other categories will be blocked. Cannot be set with `blocked_categories`.

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

@@ -464,12 +464,12 @@ declare module 'stripe' {
           image_data_url: string;
 
           /**
-           * The image_url_png string used to render QR code, can be used as <img src="…" />
+           * The image_url_png string used to render QR code
            */
           image_url_png: string;
 
           /**
-           * The image_url_svg string used to render QR code, can be used as <img src="…" />
+           * The image_url_svg string used to render QR code
            */
           image_url_svg: string;
         }
@@ -4005,6 +4005,18 @@ declare module 'stripe' {
       }
     }
 
+    interface PaymentIntentVerifyMicrodepositsParams {
+      /**
+       * Two positive integers, in *cents*, equal to the values of the microdeposits sent to the bank account.
+       */
+      amounts?: Array<number>;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
     class PaymentIntentsResource {
       /**
        * Creates a PaymentIntent object.
@@ -4132,6 +4144,19 @@ declare module 'stripe' {
         id: string,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.PaymentIntent>>;
+
+      /**
+       * Verifies microdeposits on a PaymentIntent object.
+       */
+      verifyMicrodeposits(
+        id: string,
+        params?: PaymentIntentVerifyMicrodepositsParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentIntent>>;
+      verifyMicrodeposits(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentIntent>>;
     }
   }
 }

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

@@ -17,7 +17,7 @@ declare module 'stripe' {
       object: 'payment_link';
 
       /**
-       * Whether the payment link's `url` is active. If `false`, customers visiting the url will be redirected.
+       * Whether the payment link's `url` is active. If `false`, customers visiting the URL will be shown a page saying that the link has been deactivated.
        */
       active: boolean;
 
@@ -66,10 +66,12 @@ declare module 'stripe' {
       on_behalf_of: string | Stripe.Account | null;
 
       /**
-       * The list of payment method types that customers can use. When `null`, your [payment methods settings](https://dashboard.stripe.com/settings/payment_methods) will be used.
+       * The list of payment method types that customers can use. When `null`, Stripe will dynamically show relevant payment methods you've enabled in your [payment method settings](https://dashboard.stripe.com/settings/payment_methods).
        */
       payment_method_types: Array<'card'> | null;
 
+      phone_number_collection: PaymentLink.PhoneNumberCollection;
+
       /**
        * Configuration for collecting the customer's shipping address.
        */
@@ -86,7 +88,7 @@ declare module 'stripe' {
       transfer_data: PaymentLink.TransferData | null;
 
       /**
-       * The public url that can be shared with customers.
+       * The public URL that can be shared with customers.
        */
       url: string;
     }
@@ -113,7 +115,7 @@ declare module 'stripe' {
 
         interface Redirect {
           /**
-           * The `url` the customer will be redirected to after the purchase is complete.
+           * The URL the customer will be redirected to after the purchase is complete.
            */
           url: string;
         }
@@ -130,6 +132,13 @@ declare module 'stripe' {
 
       type BillingAddressCollection = 'auto' | 'required';
 
+      interface PhoneNumberCollection {
+        /**
+         * If `true`, a phone number will be collected during checkout.
+         */
+        enabled: boolean;
+      }
+
       interface ShippingAddressCollection {
         /**
          * An array of two-letter ISO country codes representing which countries Checkout should provide as options for shipping locations. Unsupported country codes: `AS, CX, CC, CU, HM, IR, KP, MH, FM, NF, MP, PW, SD, SY, UM, VI`.
@@ -380,7 +389,7 @@ declare module 'stripe' {
 
       interface SubscriptionData {
         /**
-         * When creating a subscription, the specified configuration data will be used. There must be at least one line item with a recurring price to use `subscription_data`.
+         * Integer representing the number of trial period days before the customer is charged for the first time.
          */
         trial_period_days: number | null;
       }
@@ -440,7 +449,7 @@ declare module 'stripe' {
       line_items?: Array<PaymentLinkCreateParams.LineItem>;
 
       /**
-       * 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 associated with this Payment Link will automatically be copied to Checkout Sessions created by this Payment Link.
+       * 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 associated with this Payment Link will automatically be copied to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link.
        */
       metadata?: Stripe.MetadataParam;
 
@@ -450,10 +459,17 @@ declare module 'stripe' {
       on_behalf_of?: string;
 
       /**
-       * The list of payment method types (e.g., card) that customers can use. Only `card` is supported. If no value is passed, your [payment methods settings](https://dashboard.stripe.com/settings/payment_methods) will be used.
+       * The list of payment method types that customers can use. Only `card` is supported. If no value is passed, Stripe will dynamically show relevant payment methods from your [payment method settings](https://dashboard.stripe.com/settings/payment_methods) (20+ payment methods [supported](https://stripe.com/docs/payments/payment-methods/integration-options#payment-method-product-support)).
        */
       payment_method_types?: Array<'card'>;
 
+      /**
+       * Controls phone number collection settings during checkout.
+       *
+       * We recommend that you review your privacy policy and check with your legal contacts.
+       */
+      phone_number_collection?: PaymentLinkCreateParams.PhoneNumberCollection;
+
       /**
        * Configuration for collecting the customer's shipping address.
        */
@@ -527,7 +543,7 @@ declare module 'stripe' {
         price: string;
 
         /**
-         * The quantity of the line item being purchased. Only `1` is supported.
+         * The quantity of the line item being purchased.
          */
         quantity: number;
       }
@@ -545,12 +561,19 @@ declare module 'stripe' {
           maximum?: number;
 
           /**
-           * The minimum quantity the customer can purchase. By default this value is 0. You can specify a value up to 98.
+           * The minimum quantity the customer can purchase. By default this value is 0. You can specify a value up to 98. If there is only one item in the cart then that item's quantity cannot go down to 0.
            */
           minimum?: number;
         }
       }
 
+      interface PhoneNumberCollection {
+        /**
+         * Set to `true` to enable phone number collection.
+         */
+        enabled: boolean;
+      }
+
       interface ShippingAddressCollection {
         /**
          * An array of two-letter ISO country codes representing which countries Checkout should provide as options for
@@ -832,7 +855,7 @@ declare module 'stripe' {
 
     interface PaymentLinkUpdateParams {
       /**
-       * Whether the payment link's `url` is active. If `false`, customers visiting the url will be redirected.
+       * Whether the payment link's `url` is active. If `false`, customers visiting the URL will be shown a page saying that the link has been deactivated.
        */
       active?: boolean;
 
@@ -867,12 +890,12 @@ declare module 'stripe' {
       line_items?: Array<PaymentLinkUpdateParams.LineItem>;
 
       /**
-       * 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 associated with this Payment Link will automatically be copied to Checkout Sessions created by this Payment Link.
+       * 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 associated with this Payment Link will automatically be copied to [checkout sessions](https://stripe.com/docs/api/checkout/sessions) created by this payment link.
        */
       metadata?: Stripe.MetadataParam;
 
       /**
-       * The list of payment method types (e.g., card) that customers can use. Only `card` is supported. Pass an empty string to enable automatic payment methods that use your [payment methods settings](https://dashboard.stripe.com/settings/payment_methods).
+       * The list of payment method types that customers can use. Only `card` is supported. Pass an empty string to enable automatic payment methods that use your [payment method settings](https://dashboard.stripe.com/settings/payment_methods).
        */
       payment_method_types?: Stripe.Emptyable<Array<'card'>>;
 
@@ -941,7 +964,7 @@ declare module 'stripe' {
         id: string;
 
         /**
-         * The quantity of the line item being purchased. Only `1` is supported.
+         * The quantity of the line item being purchased.
          */
         quantity?: number;
       }
@@ -959,7 +982,7 @@ declare module 'stripe' {
           maximum?: number;
 
           /**
-           * The minimum quantity the customer can purchase. By default this value is 0. You can specify a value up to 98.
+           * The minimum quantity the customer can purchase. By default this value is 0. You can specify a value up to 98. If there is only one item in the cart then that item's quantity cannot go down to 0.
            */
           minimum?: number;
         }

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

@@ -69,7 +69,7 @@ declare module 'stripe' {
       /**
        * Reason for the refund, either user-provided (`duplicate`, `fraudulent`, or `requested_by_customer`) or generated by Stripe internally (`expired_uncaptured_charge`).
        */
-      reason: string | null;
+      reason: Refund.Reason | null;
 
       /**
        * This is the transaction number that appears on email receipts sent for this refund.
@@ -92,6 +92,14 @@ declare module 'stripe' {
       transfer_reversal: string | Stripe.TransferReversal | null;
     }
 
+    namespace Refund {
+      type Reason =
+        | 'duplicate'
+        | 'expired_uncaptured_charge'
+        | 'fraudulent'
+        | 'requested_by_customer';
+    }
+
     interface RefundCreateParams {
       amount?: number;
 

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

@@ -1032,6 +1032,18 @@ declare module 'stripe' {
       }
     }
 
+    interface SetupIntentVerifyMicrodepositsParams {
+      /**
+       * Two positive integers, in *cents*, equal to the values of the microdeposits sent to the bank account.
+       */
+      amounts?: Array<number>;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
     class SetupIntentsResource {
       /**
        * Creates a SetupIntent object.
@@ -1121,6 +1133,19 @@ declare module 'stripe' {
         id: string,
         options?: RequestOptions
       ): Promise<Stripe.Response<Stripe.SetupIntent>>;
+
+      /**
+       * Verifies microdeposits on a SetupIntent object.
+       */
+      verifyMicrodeposits(
+        id: string,
+        params?: SetupIntentVerifyMicrodepositsParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.SetupIntent>>;
+      verifyMicrodeposits(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.SetupIntent>>;
     }
   }
 }

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

@@ -41,7 +41,7 @@ declare module 'stripe' {
        *
        * For example, you might have a single "gold" product that has plans for $10/month, $100/year, €9/month, and €90/year.
        *
-       * Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/billing/prices-guide).
+       * Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription) and more about [products and prices](https://stripe.com/docs/products-prices/overview).
        */
       plan: Stripe.Plan;
 
@@ -51,7 +51,7 @@ declare module 'stripe' {
        *
        * For example, you might have a single "gold" product that has prices for $10/month, $100/year, and €9 once.
        *
-       * Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/billing/prices-guide).
+       * Related guides: [Set up a subscription](https://stripe.com/docs/billing/subscriptions/set-up-subscription), [create an invoice](https://stripe.com/docs/billing/invoices/create), and more about [products and prices](https://stripe.com/docs/products-prices/overview).
        */
       price: Stripe.Price;
 

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

@@ -342,6 +342,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -869,6 +870,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'
@@ -1401,6 +1403,7 @@ declare module 'stripe' {
           | 'card'
           | 'fpx'
           | 'giropay'
+          | 'grabpay'
           | 'ideal'
           | 'sepa_credit_transfer'
           | 'sepa_debit'

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`, `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 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`, `is_vat`, `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;
 
@@ -77,6 +77,7 @@ declare module 'stripe' {
         | 'id_npwp'
         | 'il_vat'
         | 'in_gst'
+        | 'is_vat'
         | 'jp_cn'
         | 'jp_rn'
         | 'kr_brn'
@@ -143,7 +144,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`, `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 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`, `is_vat`, `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;
 
@@ -181,6 +182,7 @@ declare module 'stripe' {
         | 'id_npwp'
         | 'il_vat'
         | 'in_gst'
+        | 'is_vat'
         | 'jp_cn'
         | 'jp_rn'
         | 'kr_brn'

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

@@ -192,11 +192,19 @@ declare module 'stripe' {
           id: string,
           params?: ReaderRetrieveParams,
           options?: RequestOptions
-        ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+        ): Promise<
+          Stripe.Response<
+            Stripe.Terminal.Reader | Stripe.Terminal.DeletedReader
+          >
+        >;
         retrieve(
           id: string,
           options?: RequestOptions
-        ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+        ): Promise<
+          Stripe.Response<
+            Stripe.Terminal.Reader | Stripe.Terminal.DeletedReader
+          >
+        >;
 
         /**
          * Updates a Reader object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.
@@ -205,7 +213,11 @@ declare module 'stripe' {
           id: string,
           params?: ReaderUpdateParams,
           options?: RequestOptions
-        ): Promise<Stripe.Response<Stripe.Terminal.Reader>>;
+        ): Promise<
+          Stripe.Response<
+            Stripe.Terminal.Reader | Stripe.Terminal.DeletedReader
+          >
+        >;
 
         /**
          * Returns a list of Reader objects.

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

@@ -332,6 +332,8 @@ declare module 'stripe' {
         | 'payment_intent.processing'
         | 'payment_intent.requires_action'
         | 'payment_intent.succeeded'
+        | 'payment_link.created'
+        | 'payment_link.updated'
         | 'payment_method.attached'
         | 'payment_method.automatically_updated'
         | 'payment_method.detached'
@@ -553,6 +555,8 @@ declare module 'stripe' {
         | 'payment_intent.processing'
         | 'payment_intent.requires_action'
         | 'payment_intent.succeeded'
+        | 'payment_link.created'
+        | 'payment_link.updated'
         | 'payment_method.attached'
         | 'payment_method.automatically_updated'
         | 'payment_method.detached'