stripe 16.2.0 → 16.4.0-beta.1

package/types/Checkout/Sessions.d.ts

@@ -1435,6 +1435,11 @@ declare module 'stripe' {
              * 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?: 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 {
@@ -1518,6 +1523,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.
                */
@@ -1540,19 +1547,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';

package/types/Checkout/SessionsResource.d.ts

@@ -1634,6 +1634,11 @@ declare module 'stripe' {
              */
             reference?: string;
 
+            /**
+             * A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
+             */
+            reference_id?: string;
+
             /**
              * The risk correlation ID for an on-session payment using a saved PayPal payment method.
              */
@@ -1649,6 +1654,11 @@ declare module 'stripe' {
              * 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<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 {
@@ -1774,7 +1784,11 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch = 'balances' | 'ownership' | 'transactions';
+              type Prefetch =
+                | 'balances'
+                | 'inferred_balances'
+                | 'ownership'
+                | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';

package/types/ConfirmationTokens.d.ts

@@ -47,6 +47,11 @@ declare module 'stripe' {
        */
       payment_intent: string | null;
 
+      /**
+       * Payment-method-specific configuration for this ConfirmationToken.
+       */
+      payment_method_options: ConfirmationToken.PaymentMethodOptions | null;
+
       /**
        * Payment details collected by the Payment Element, used to create a PaymentMethod when a PaymentIntent or SetupIntent is confirmed with this ConfirmationToken.
        */
@@ -116,6 +121,22 @@ declare module 'stripe' {
         }
       }
 
+      interface PaymentMethodOptions {
+        /**
+         * This hash contains the card payment method options.
+         */
+        card: PaymentMethodOptions.Card | null;
+      }
+
+      namespace PaymentMethodOptions {
+        interface Card {
+          /**
+           * The `cvc_update` Token collected from the Payment Element.
+           */
+          cvc_token: string | null;
+        }
+      }
+
       interface PaymentMethodPreview {
         acss_debit?: PaymentMethodPreview.AcssDebit;
 
@@ -182,10 +203,14 @@ declare module 'stripe' {
 
         paypal?: PaymentMethodPreview.Paypal;
 
+        payto?: PaymentMethodPreview.Payto;
+
         pix?: PaymentMethodPreview.Pix;
 
         promptpay?: PaymentMethodPreview.Promptpay;
 
+        rechnung?: PaymentMethodPreview.Rechnung;
+
         revolut_pay?: PaymentMethodPreview.RevolutPay;
 
         sepa_debit?: PaymentMethodPreview.SepaDebit;
@@ -1166,6 +1191,11 @@ declare module 'stripe' {
         interface Paynow {}
 
         interface Paypal {
+          /**
+           * Uniquely identifies this particular PayPal account. You can use this attribute to check whether two PayPal accounts are the same.
+           */
+          fingerprint?: string | null;
+
           /**
            * Owner's email. Values are provided by PayPal directly
            * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
@@ -1176,12 +1206,58 @@ declare module 'stripe' {
            * PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
            */
           payer_id: string | null;
+
+          /**
+           * Owner's verified email. Values are verified or provided by PayPal directly
+           * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+           */
+          verified_email?: string | null;
+        }
+
+        interface Payto {
+          /**
+           * Bank-State-Branch number of the bank account.
+           */
+          bsb_number: string | null;
+
+          /**
+           * Last four digits of the bank account number.
+           */
+          last4: string | null;
+
+          /**
+           * The PayID alias for the bank account.
+           */
+          pay_id: string | null;
         }
 
         interface Pix {}
 
         interface Promptpay {}
 
+        interface Rechnung {
+          dob?: Rechnung.Dob;
+        }
+
+        namespace Rechnung {
+          interface Dob {
+            /**
+             * The day of birth, between 1 and 31.
+             */
+            day: number;
+
+            /**
+             * The month of birth, between 1 and 12.
+             */
+            month: number;
+
+            /**
+             * The four-digit year of birth.
+             */
+            year: number;
+          }
+        }
+
         interface RevolutPay {}
 
         interface SepaDebit {
@@ -1271,8 +1347,10 @@ declare module 'stripe' {
           | 'p24'
           | 'paynow'
           | 'paypal'
+          | 'payto'
           | 'pix'
           | 'promptpay'
+          | 'rechnung'
           | 'revolut_pay'
           | 'sepa_debit'
           | 'sofort'
@@ -1288,6 +1366,11 @@ declare module 'stripe' {
            */
           account_holder_type: UsBankAccount.AccountHolderType | null;
 
+          /**
+           * Account number of the bank account.
+           */
+          account_number?: string | null;
+
           /**
            * Account type: checkings or savings. Defaults to checking if omitted.
            */

package/types/Coupons.d.ts

@@ -113,7 +113,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating';
+      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
     }
 
     /**

package/types/CouponsResource.d.ts

@@ -86,7 +86,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating';
+      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
     }
 
     interface CouponRetrieveParams {

package/types/CreditNotes.d.ts

@@ -106,6 +106,10 @@ declare module 'stripe' {
        */
       pdf: string;
 
+      post_payment_amount?: number;
+
+      pre_payment_amount?: number;
+
       /**
        * Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
        */
@@ -116,6 +120,11 @@ declare module 'stripe' {
        */
       refund: string | Stripe.Refund | null;
 
+      /**
+       * Refunds related to this credit note.
+       */
+      refunds?: Array<CreditNote.Refund>;
+
       /**
        * The details of the cost of shipping, including the ShippingRate applied to the invoice.
        */
@@ -181,6 +190,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent).
+         */
+        amount_refunded: number;
+
+        /**
+         * ID of the refund.
+         */
+        refund: string | Stripe.Refund;
+      }
+
       interface ShippingCost {
         /**
          * Total shipping cost before any taxes are applied.

package/types/CreditNotesResource.d.ts

@@ -68,6 +68,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNoteCreateParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -151,6 +156,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.
@@ -278,6 +295,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNoteListPreviewLineItemsParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -361,6 +383,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.
@@ -435,6 +469,11 @@ declare module 'stripe' {
        */
       refund_amount?: number;
 
+      /**
+       * Refunds to link to this credit note.
+       */
+      refunds?: Array<CreditNotePreviewParams.Refund>;
+
       /**
        * When shipping_cost contains the shipping_rate from the invoice, the shipping_cost is included in the credit note.
        */
@@ -518,6 +557,18 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
+      interface Refund {
+        /**
+         * Amount of the refund that applies to this credit note, in cents (or local equivalent). Defaults to the entire refund amount.
+         */
+        amount_refunded?: number;
+
+        /**
+         * ID of an existing refund to link this credit note to.
+         */
+        refund?: string;
+      }
+
       interface ShippingCost {
         /**
          * The ID of the shipping rate to use for this order.

package/types/CustomerSessions.d.ts

@@ -52,6 +52,11 @@ declare module 'stripe' {
          */
         buy_button: Components.BuyButton;
 
+        /**
+         * This hash contains whether the Payment Element is enabled and the features it supports.
+         */
+        payment_element: Components.PaymentElement;
+
         /**
          * This hash contains whether the pricing table is enabled.
          */
@@ -66,6 +71,77 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface PaymentElement {
+          /**
+           * Whether the Payment Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Payment Element supports certain features.
+           */
+          features: PaymentElement.Features | null;
+        }
+
+        namespace PaymentElement {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
+             */
+            payment_method_redisplay: Features.PaymentMethodRedisplay;
+
+            /**
+             * Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `10`.
+             */
+            payment_method_redisplay_limit: number | null;
+
+            /**
+             * Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove: Features.PaymentMethodRemove;
+
+            /**
+             * Controls whether the Payment Element displays a checkbox offering to save a new payment method. This parameter defaults to `disabled`.
+             *
+             * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+             */
+            payment_method_save: Features.PaymentMethodSave;
+
+            /**
+             * When using PaymentIntents and the customer checks the save checkbox, this field determines the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value used to confirm the PaymentIntent.
+             *
+             * When using SetupIntents, directly configure the [`usage`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) value on SetupIntent creation.
+             */
+            payment_method_save_usage: Features.PaymentMethodSaveUsage | null;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+
+            type PaymentMethodSave = 'disabled' | 'enabled';
+
+            type PaymentMethodSaveUsage = 'off_session' | 'on_session';
+          }
+        }
+
         interface PricingTable {
           /**
            * Whether the pricing table is enabled.

package/types/CustomerSessionsResource.d.ts

@@ -26,6 +26,11 @@ declare module 'stripe' {
          */
         buy_button?: Components.BuyButton;
 
+        /**
+         * Configuration for the Payment Element.
+         */
+        payment_element?: Components.PaymentElement;
+
         /**
          * Configuration for the pricing table.
          */
@@ -40,6 +45,77 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface PaymentElement {
+          /**
+           * Whether the Payment Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Payment Element supports certain features.
+           */
+          features?: PaymentElement.Features;
+        }
+
+        namespace PaymentElement {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the Payment Element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the Payment Element shows saved payment methods. This parameter defaults to `disabled`.
+             */
+            payment_method_redisplay?: Features.PaymentMethodRedisplay;
+
+            /**
+             * Determines the max number of saved payment methods for the Payment Element to display. This parameter defaults to `10`.
+             */
+            payment_method_redisplay_limit?: number;
+
+            /**
+             * Controls whether the Payment Element displays the option to remove a saved payment method. This parameter defaults to `disabled`.
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove?: Features.PaymentMethodRemove;
+
+            /**
+             * Controls whether the Payment Element displays a checkbox offering to save a new payment method. This parameter defaults to `disabled`.
+             *
+             * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+             */
+            payment_method_save?: Features.PaymentMethodSave;
+
+            /**
+             * When using PaymentIntents and the customer checks the save checkbox, this field determines the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value used to confirm the PaymentIntent.
+             *
+             * When using SetupIntents, directly configure the [`usage`](https://docs.stripe.com/api/setup_intents/object#setup_intent_object-usage) value on SetupIntent creation.
+             */
+            payment_method_save_usage?: Features.PaymentMethodSaveUsage;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+
+            type PaymentMethodSave = 'disabled' | 'enabled';
+
+            type PaymentMethodSaveUsage = 'off_session' | 'on_session';
+          }
+        }
+
         interface PricingTable {
           /**
            * Whether the pricing table is enabled.

package/types/CustomersResource.d.ts

@@ -818,8 +818,10 @@ declare module 'stripe' {
         | 'p24'
         | 'paynow'
         | 'paypal'
+        | 'payto'
         | 'pix'
         | 'promptpay'
+        | 'rechnung'
         | 'revolut_pay'
         | 'sepa_debit'
         | 'sofort'