stripe 19.2.1 → 19.3.0-alpha.2

package/types/Checkout/Sessions.d.ts

@@ -69,6 +69,8 @@ declare module 'stripe' {
          */
         cancel_url: string | null;
 
+        checkout_items?: Array<Session.CheckoutItem>;
+
         /**
          * A unique string to reference the Checkout Session. This can be a
          * customer ID, a cart ID, or similar, and can be used to reconcile the
@@ -128,6 +130,11 @@ declare module 'stripe' {
          */
         customer: string | Stripe.Customer | Stripe.DeletedCustomer | null;
 
+        /**
+         * The ID of the account for this Session.
+         */
+        customer_account?: string | null;
+
         /**
          * Configure whether a Checkout Session creates a Customer when the Checkout Session completes.
          */
@@ -512,21 +519,92 @@ declare module 'stripe' {
           }
         }
 
+        interface CheckoutItem {
+          type: CheckoutItem.Type;
+
+          rate_card_subscription_item?: CheckoutItem.RateCardSubscriptionItem;
+
+          pricing_plan_subscription_item?: CheckoutItem.PricingPlanSubscriptionItem;
+        }
+
+        namespace CheckoutItem {
+          interface PricingPlanSubscriptionItem {
+            pricing_plan: string;
+
+            pricing_plan_version: string;
+
+            metadata: Stripe.Metadata;
+
+            component_configurations: {
+              [key: string]: PricingPlanSubscriptionItem.ComponentConfigurations;
+            };
+
+            pricing_plan_subscription?: string;
+
+            billing_cadence?: string;
+          }
+
+          namespace PricingPlanSubscriptionItem {
+            interface ComponentConfigurations {
+              type: 'license_fee_component';
+
+              license_fee_component?: ComponentConfigurations.LicenseFeeComponent;
+            }
+
+            namespace ComponentConfigurations {
+              interface LicenseFeeComponent {
+                quantity: number;
+              }
+            }
+          }
+
+          interface RateCardSubscriptionItem {
+            rate_card: string;
+
+            metadata: Stripe.Metadata;
+
+            rate_card_version: string;
+
+            billing_cadence?: string;
+
+            rate_card_subscription?: string;
+          }
+
+          type Type =
+            | 'rate_card_subscription_item'
+            | 'pricing_plan_subscription_item';
+        }
+
         interface CollectedInformation {
           /**
            * Customer's business name for this Checkout Session
            */
           business_name: string | null;
 
+          /**
+           * Customer's email for this Checkout Session
+           */
+          email?: string | null;
+
           /**
            * Customer's individual name for this Checkout Session
            */
           individual_name: string | null;
 
+          /**
+           * Customer's phone number for this Checkout Session
+           */
+          phone?: string | null;
+
           /**
            * Shipping information for this Checkout Session.
            */
           shipping_details: CollectedInformation.ShippingDetails | null;
+
+          /**
+           * Customer's tax ids for this Checkout Session.
+           */
+          tax_ids?: Array<CollectedInformation.TaxId> | null;
         }
 
         namespace CollectedInformation {
@@ -538,6 +616,133 @@ declare module 'stripe' {
              */
             name: string;
           }
+
+          interface TaxId {
+            /**
+             * The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `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`, `jp_trn`, `li_uid`, `li_vat`, `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`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+             */
+            type: TaxId.Type;
+
+            /**
+             * The value of the tax ID.
+             */
+            value: string | null;
+          }
+
+          namespace TaxId {
+            type Type =
+              | 'ad_nrt'
+              | 'ae_trn'
+              | 'al_tin'
+              | 'am_tin'
+              | 'ao_tin'
+              | 'ar_cuit'
+              | 'au_abn'
+              | 'au_arn'
+              | 'aw_tin'
+              | 'az_tin'
+              | 'ba_tin'
+              | 'bb_tin'
+              | 'bd_bin'
+              | 'bf_ifu'
+              | 'bg_uic'
+              | 'bh_vat'
+              | 'bj_ifu'
+              | 'bo_tin'
+              | 'br_cnpj'
+              | 'br_cpf'
+              | 'bs_tin'
+              | 'by_tin'
+              | 'ca_bn'
+              | 'ca_gst_hst'
+              | 'ca_pst_bc'
+              | 'ca_pst_mb'
+              | 'ca_pst_sk'
+              | 'ca_qst'
+              | 'cd_nif'
+              | 'ch_uid'
+              | 'ch_vat'
+              | 'cl_tin'
+              | 'cm_niu'
+              | 'cn_tin'
+              | 'co_nit'
+              | 'cr_tin'
+              | 'cv_nif'
+              | 'de_stn'
+              | 'do_rcn'
+              | 'ec_ruc'
+              | 'eg_tin'
+              | 'es_cif'
+              | 'et_tin'
+              | 'eu_oss_vat'
+              | 'eu_vat'
+              | 'gb_vat'
+              | 'ge_vat'
+              | 'gn_nif'
+              | 'hk_br'
+              | 'hr_oib'
+              | 'hu_tin'
+              | 'id_npwp'
+              | 'il_vat'
+              | 'in_gst'
+              | 'is_vat'
+              | 'jp_cn'
+              | 'jp_rn'
+              | 'jp_trn'
+              | 'ke_pin'
+              | 'kg_tin'
+              | 'kh_tin'
+              | 'kr_brn'
+              | 'kz_bin'
+              | 'la_tin'
+              | 'li_uid'
+              | 'li_vat'
+              | 'ma_vat'
+              | 'md_vat'
+              | 'me_pib'
+              | 'mk_vat'
+              | 'mr_nif'
+              | 'mx_rfc'
+              | 'my_frp'
+              | 'my_itn'
+              | 'my_sst'
+              | 'ng_tin'
+              | 'no_vat'
+              | 'no_voec'
+              | 'np_pan'
+              | 'nz_gst'
+              | 'om_vat'
+              | 'pe_ruc'
+              | 'ph_tin'
+              | 'ro_tin'
+              | 'rs_pib'
+              | 'ru_inn'
+              | 'ru_kpp'
+              | 'sa_vat'
+              | 'sg_gst'
+              | 'sg_uen'
+              | 'si_tin'
+              | 'sn_ninea'
+              | 'sr_fin'
+              | 'sv_nit'
+              | 'th_vat'
+              | 'tj_tin'
+              | 'tr_tin'
+              | 'tw_vat'
+              | 'tz_vat'
+              | 'ua_vat'
+              | 'ug_tin'
+              | 'unknown'
+              | 'us_ein'
+              | 'uy_ruc'
+              | 'uz_tin'
+              | 'uz_vat'
+              | 've_rif'
+              | 'vn_tin'
+              | 'za_vat'
+              | 'zm_tin'
+              | 'zw_tin';
+          }
         }
 
         interface Consent {
@@ -1250,6 +1455,8 @@ declare module 'stripe' {
 
           paypal?: PaymentMethodOptions.Paypal;
 
+          payto?: PaymentMethodOptions.Payto;
+
           pix?: PaymentMethodOptions.Pix;
 
           revolut_pay?: PaymentMethodOptions.RevolutPay;
@@ -1520,6 +1727,11 @@ declare module 'stripe' {
 
             installments?: Card.Installments;
 
+            /**
+             * Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this CheckoutSession.
+             */
+            request_decremental_authorization?: Card.RequestDecrementalAuthorization;
+
             /**
              * Request ability to [capture beyond the standard authorization validity window](https://docs.stripe.com/payments/extended-authorization) for this CheckoutSession.
              */
@@ -1577,6 +1789,8 @@ declare module 'stripe' {
               enabled?: boolean;
             }
 
+            type RequestDecrementalAuthorization = 'if_available' | 'never';
+
             type RequestExtendedAuthorization = 'if_available' | 'never';
 
             type RequestIncrementalAuthorization = 'if_available' | 'never';
@@ -1993,12 +2207,100 @@ declare module 'stripe' {
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: Paypal.SetupFutureUsage;
+
+            /**
+             * The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
+             */
+            subsellers?: Array<string>;
           }
 
           namespace Paypal {
             type SetupFutureUsage = 'none' | 'off_session';
           }
 
+          interface Payto {
+            mandate_options?: Payto.MandateOptions;
+
+            /**
+             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
+             *
+             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://docs.stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://docs.stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
+             *
+             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://docs.stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
+             *
+             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
+             */
+            setup_future_usage?: Payto.SetupFutureUsage;
+          }
+
+          namespace Payto {
+            interface MandateOptions {
+              /**
+               * Amount that will be collected. It is required when `amount_type` is `fixed`.
+               */
+              amount: number | null;
+
+              /**
+               * The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
+               */
+              amount_type: MandateOptions.AmountType | null;
+
+              /**
+               * Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
+               */
+              end_date: string | null;
+
+              /**
+               * The periodicity at which payments will be collected.
+               */
+              payment_schedule: MandateOptions.PaymentSchedule | null;
+
+              /**
+               * The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
+               */
+              payments_per_period: number | null;
+
+              /**
+               * The purpose for which payments are made. Defaults to retail.
+               */
+              purpose: MandateOptions.Purpose | null;
+
+              /**
+               * Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
+               */
+              start_date: string | null;
+            }
+
+            namespace MandateOptions {
+              type AmountType = 'fixed' | 'maximum';
+
+              type PaymentSchedule =
+                | 'adhoc'
+                | 'annual'
+                | 'daily'
+                | 'fortnightly'
+                | 'monthly'
+                | 'quarterly'
+                | 'semi_annual'
+                | 'weekly';
+
+              type Purpose =
+                | 'dependant_support'
+                | 'government'
+                | 'loan'
+                | 'mortgage'
+                | 'other'
+                | 'pension'
+                | 'personal'
+                | 'retail'
+                | 'salary'
+                | 'tax'
+                | 'utility';
+            }
+
+            type SetupFutureUsage = 'none' | 'off_session';
+          }
+
           interface Pix {
             /**
              * Determines if the amount includes the IOF tax.
@@ -2010,6 +2312,8 @@ declare module 'stripe' {
              */
             expires_after_seconds: number | null;
 
+            mandate_options?: Pix.MandateOptions;
+
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
              *
@@ -2019,11 +2323,68 @@ declare module 'stripe' {
              *
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
              */
-            setup_future_usage?: 'none';
+            setup_future_usage?: Pix.SetupFutureUsage;
           }
 
           namespace Pix {
             type AmountIncludesIof = 'always' | 'never';
+
+            interface MandateOptions {
+              /**
+               * Amount to be charged for future payments.
+               */
+              amount?: number;
+
+              /**
+               * Determines if the amount includes the IOF tax.
+               */
+              amount_includes_iof?: MandateOptions.AmountIncludesIof;
+
+              /**
+               * Type of amount.
+               */
+              amount_type?: MandateOptions.AmountType;
+
+              /**
+               * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase.
+               */
+              currency?: string;
+
+              /**
+               * Date when the mandate expires and no further payments will be charged, in `YYYY-MM-DD`.
+               */
+              end_date?: string;
+
+              /**
+               * Schedule at which the future payments will be charged.
+               */
+              payment_schedule?: MandateOptions.PaymentSchedule;
+
+              /**
+               * Subscription name displayed to buyers in their bank app.
+               */
+              reference?: string;
+
+              /**
+               * Start date of the mandate, in `YYYY-MM-DD`.
+               */
+              start_date?: string;
+            }
+
+            namespace MandateOptions {
+              type AmountIncludesIof = 'always' | 'never';
+
+              type AmountType = 'fixed' | 'maximum';
+
+              type PaymentSchedule =
+                | 'halfyearly'
+                | 'monthly'
+                | 'quarterly'
+                | 'weekly'
+                | 'yearly';
+            }
+
+            type SetupFutureUsage = 'none' | 'off_session';
           }
 
           interface RevolutPay {
@@ -2155,6 +2516,8 @@ declare module 'stripe' {
             interface FinancialConnections {
               filters?: FinancialConnections.Filters;
 
+              manual_entry?: FinancialConnections.ManualEntry;
+
               /**
                * The list of permissions to request. The `payment_method` permission must be included.
                */
@@ -2177,19 +2540,39 @@ declare module 'stripe' {
                  * The account subcategories to use to filter for possible accounts to link. Valid subcategories are `checking` and `savings`.
                  */
                 account_subcategories?: Array<Filters.AccountSubcategory>;
+
+                /**
+                 * The institution to use to filter for possible accounts to link.
+                 */
+                institution?: string;
               }
 
               namespace Filters {
                 type AccountSubcategory = 'checking' | 'savings';
               }
 
+              interface ManualEntry {
+                /**
+                 * Settings for configuring manual entry of account details.
+                 */
+                mode?: ManualEntry.Mode;
+              }
+
+              namespace ManualEntry {
+                type Mode = 'automatic' | 'custom';
+              }
+
               type Permission =
                 | 'balances'
                 | 'ownership'
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -2201,6 +2584,20 @@ declare module 'stripe' {
         type PaymentStatus = 'no_payment_required' | 'paid' | 'unpaid';
 
         interface Permissions {
+          /**
+           * Permissions for updating the Checkout Session.
+           */
+          update?: Permissions.Update | null;
+
+          /**
+           * Determines which entity is allowed to update the line items.
+           *
+           * Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
+           *
+           * When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
+           */
+          update_line_items?: Permissions.UpdateLineItems | null;
+
           /**
            * Determines which entity is allowed to update the shipping details.
            *
@@ -2212,6 +2609,34 @@ declare module 'stripe' {
         }
 
         namespace Permissions {
+          interface Update {
+            /**
+             * Determines which entity is allowed to update the line items.
+             *
+             * Default is `client_only`. Stripe Checkout client will automatically update the line items. If set to `server_only`, only your server is allowed to update the line items.
+             *
+             * When set to `server_only`, you must add the onLineItemsChange event handler when initializing the Stripe Checkout client and manually update the line items from your server using the Stripe API.
+             */
+            line_items?: Update.LineItems | null;
+
+            /**
+             * Determines which entity is allowed to update the shipping details.
+             *
+             * Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
+             *
+             * When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
+             */
+            shipping_details: Update.ShippingDetails | null;
+          }
+
+          namespace Update {
+            type LineItems = 'client_only' | 'server_only';
+
+            type ShippingDetails = 'client_only' | 'server_only';
+          }
+
+          type UpdateLineItems = 'client_only' | 'server_only';
+
           type UpdateShippingDetails = 'client_only' | 'server_only';
         }