@stripe/stripe-js 4.7.0 → 4.9.0

package/dist/api/confirmation-tokens.d.mts

@@ -84,9 +84,6 @@ export interface ConfirmationTokenCreateParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/api/confirmation-tokens.d.ts

@@ -84,9 +84,6 @@ export interface ConfirmationTokenCreateParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/index.js

@@ -42,7 +42,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.6.0",
+    version: "4.8.0",
     startTime: startTime
   });
 };

package/dist/index.mjs

@@ -38,7 +38,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.6.0",
+    version: "4.8.0",
     startTime: startTime
   });
 };

package/dist/pure.js

@@ -58,7 +58,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.6.0",
+    version: "4.8.0",
     startTime: startTime
   });
 };

package/dist/pure.mjs

@@ -54,7 +54,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "4.6.0",
+    version: "4.8.0",
     startTime: startTime
   });
 };

package/dist/stripe-js/custom-checkout.d.mts

@@ -12,6 +12,8 @@ import {
 import {Appearance, CssFontSource, CustomFontSource} from './elements-group';
 import {StripeError} from './stripe';
 import {
+  StripeCurrencySelectorElement,
+  FieldsOption,
   StripeElementBase,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementConfirmEvent,
@@ -151,6 +153,7 @@ export type StripeCustomCheckoutLineItem = {
     usageType: 'metered' | 'licensed';
   } | null;
   adjustableQuantity: StripeCustomCheckoutAdjustableQuantity | null;
+  images: string[];
 };
 
 export type StripeCustomCheckoutRecurring = {
@@ -202,6 +205,12 @@ export type StripeCustomCheckoutTrial = {
   trialPeriodDays: number;
 };
 
+export type StripeCustomCheckoutCurrencyOption = {
+  unitAmount: number;
+  currency: string;
+  currencyConversion?: {fxRate: number; sourceCurrency: string};
+};
+
 /* Custom Checkout session */
 export interface StripeCustomCheckoutSession {
   billingAddress: StripeCustomCheckoutContact | null;
@@ -209,6 +218,7 @@ export interface StripeCustomCheckoutSession {
   canConfirm: boolean;
   confirmationRequirements: StripeCustomCheckoutConfirmationRequirement[];
   currency: string;
+  currencyOptions: Array<StripeCustomCheckoutCurrencyOption> | null;
   discountAmounts: Array<StripeCustomCheckoutDiscountAmount> | null;
   email: string | null;
   id: string;
@@ -236,6 +246,7 @@ export type StripeCustomCheckoutPaymentElementOptions = {
   paymentMethodOrder?: Array<string>;
   readonly?: boolean;
   terms?: TermsOption;
+  fields?: FieldsOption;
 };
 
 export type StripeCustomCheckoutAddressElementOptions = {
@@ -252,6 +263,7 @@ export type StripeCustomCheckoutExpressCheckoutElementOptions = {
   buttonType: StripeExpressCheckoutElementOptions['buttonType'];
   layout: StripeExpressCheckoutElementOptions['layout'];
   paymentMethodOrder: StripeExpressCheckoutElementOptions['paymentMethodOrder'];
+  paymentMethods: StripeExpressCheckoutElementOptions['paymentMethods'];
 };
 
 export type StripeCustomCheckoutUpdateHandler = (
@@ -393,8 +405,10 @@ export interface StripeCustomCheckout {
   updateBillingAddress: (
     billingAddress: StripeCustomCheckoutContact | null
   ) => Promise<StripeCustomCheckoutResult>;
-  updatePhoneNumber: (phoneNumber: string) => void;
-  updateEmail: (email: string) => void;
+  updatePhoneNumber: (
+    phoneNumber: string
+  ) => Promise<StripeCustomCheckoutResult>;
+  updateEmail: (email: string) => Promise<StripeCustomCheckoutResult>;
   updateLineItemQuantity: (args: {
     lineItem: string;
     quantity: number;
@@ -403,7 +417,6 @@ export interface StripeCustomCheckout {
     shippingOption: string
   ) => Promise<StripeCustomCheckoutResult>;
   confirm: (args?: {
-    return_url?: string;
     returnUrl?: string;
     redirect?: StripeCustomCheckoutRedirectBehavior;
     paymentMethod?: string;
@@ -422,6 +435,10 @@ export interface StripeCustomCheckout {
   getElement(
     elementType: 'expressCheckout'
   ): StripeCustomCheckoutExpressCheckoutElement | null;
+  /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
+  getElement(
+    elementType: 'currencySelector'
+  ): StripeCurrencySelectorElement | null;
   createElement(
     elementType: 'payment',
     options?: StripeCustomCheckoutPaymentElementOptions
@@ -434,4 +451,6 @@ export interface StripeCustomCheckout {
     elementType: 'expressCheckout',
     options: StripeCustomCheckoutExpressCheckoutElementOptions
   ): StripeCustomCheckoutExpressCheckoutElement;
+  /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
+  createElement(elementType: 'currencySelector'): StripeCurrencySelectorElement;
 }

package/dist/stripe-js/custom-checkout.d.ts

@@ -12,6 +12,8 @@ import {
 import {Appearance, CssFontSource, CustomFontSource} from './elements-group';
 import {StripeError} from './stripe';
 import {
+  StripeCurrencySelectorElement,
+  FieldsOption,
   StripeElementBase,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementConfirmEvent,
@@ -151,6 +153,7 @@ export type StripeCustomCheckoutLineItem = {
     usageType: 'metered' | 'licensed';
   } | null;
   adjustableQuantity: StripeCustomCheckoutAdjustableQuantity | null;
+  images: string[];
 };
 
 export type StripeCustomCheckoutRecurring = {
@@ -202,6 +205,12 @@ export type StripeCustomCheckoutTrial = {
   trialPeriodDays: number;
 };
 
+export type StripeCustomCheckoutCurrencyOption = {
+  unitAmount: number;
+  currency: string;
+  currencyConversion?: {fxRate: number; sourceCurrency: string};
+};
+
 /* Custom Checkout session */
 export interface StripeCustomCheckoutSession {
   billingAddress: StripeCustomCheckoutContact | null;
@@ -209,6 +218,7 @@ export interface StripeCustomCheckoutSession {
   canConfirm: boolean;
   confirmationRequirements: StripeCustomCheckoutConfirmationRequirement[];
   currency: string;
+  currencyOptions: Array<StripeCustomCheckoutCurrencyOption> | null;
   discountAmounts: Array<StripeCustomCheckoutDiscountAmount> | null;
   email: string | null;
   id: string;
@@ -236,6 +246,7 @@ export type StripeCustomCheckoutPaymentElementOptions = {
   paymentMethodOrder?: Array<string>;
   readonly?: boolean;
   terms?: TermsOption;
+  fields?: FieldsOption;
 };
 
 export type StripeCustomCheckoutAddressElementOptions = {
@@ -252,6 +263,7 @@ export type StripeCustomCheckoutExpressCheckoutElementOptions = {
   buttonType: StripeExpressCheckoutElementOptions['buttonType'];
   layout: StripeExpressCheckoutElementOptions['layout'];
   paymentMethodOrder: StripeExpressCheckoutElementOptions['paymentMethodOrder'];
+  paymentMethods: StripeExpressCheckoutElementOptions['paymentMethods'];
 };
 
 export type StripeCustomCheckoutUpdateHandler = (
@@ -393,8 +405,10 @@ export interface StripeCustomCheckout {
   updateBillingAddress: (
     billingAddress: StripeCustomCheckoutContact | null
   ) => Promise<StripeCustomCheckoutResult>;
-  updatePhoneNumber: (phoneNumber: string) => void;
-  updateEmail: (email: string) => void;
+  updatePhoneNumber: (
+    phoneNumber: string
+  ) => Promise<StripeCustomCheckoutResult>;
+  updateEmail: (email: string) => Promise<StripeCustomCheckoutResult>;
   updateLineItemQuantity: (args: {
     lineItem: string;
     quantity: number;
@@ -403,7 +417,6 @@ export interface StripeCustomCheckout {
     shippingOption: string
   ) => Promise<StripeCustomCheckoutResult>;
   confirm: (args?: {
-    return_url?: string;
     returnUrl?: string;
     redirect?: StripeCustomCheckoutRedirectBehavior;
     paymentMethod?: string;
@@ -422,6 +435,10 @@ export interface StripeCustomCheckout {
   getElement(
     elementType: 'expressCheckout'
   ): StripeCustomCheckoutExpressCheckoutElement | null;
+  /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
+  getElement(
+    elementType: 'currencySelector'
+  ): StripeCurrencySelectorElement | null;
   createElement(
     elementType: 'payment',
     options?: StripeCustomCheckoutPaymentElementOptions
@@ -434,4 +451,6 @@ export interface StripeCustomCheckout {
     elementType: 'expressCheckout',
     options: StripeCustomCheckoutExpressCheckoutElementOptions
   ): StripeCustomCheckoutExpressCheckoutElement;
+  /* Requires beta access: Contact [Stripe support](https://support.stripe.com/) for more information. */
+  createElement(elementType: 'currencySelector'): StripeCurrencySelectorElement;
 }

package/dist/stripe-js/elements/currency-selector.d.mts

@@ -0,0 +1,93 @@
+import {StripeElementBase} from './base';
+import {StripeError} from '../stripe';
+
+export type StripeCurrencySelectorElement = StripeElementBase & {
+  /**
+   * Triggered when the element is fully rendered and can accept `element.focus` calls.
+   */
+  on(
+    eventType: 'ready',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'ready',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'ready',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element gains focus.
+   */
+  on(
+    eventType: 'focus',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'focus',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'focus',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element loses focus.
+   */
+  on(
+    eventType: 'blur',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'blur',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'blur',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the escape key is pressed within the element.
+   */
+  on(
+    eventType: 'escape',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'escape',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'escape',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+};

package/dist/stripe-js/elements/currency-selector.d.ts

@@ -0,0 +1,93 @@
+import {StripeElementBase} from './base';
+import {StripeError} from '../stripe';
+
+export type StripeCurrencySelectorElement = StripeElementBase & {
+  /**
+   * Triggered when the element is fully rendered and can accept `element.focus` calls.
+   */
+  on(
+    eventType: 'ready',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'ready',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'ready',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element gains focus.
+   */
+  on(
+    eventType: 'focus',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'focus',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'focus',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element loses focus.
+   */
+  on(
+    eventType: 'blur',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'blur',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'blur',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the escape key is pressed within the element.
+   */
+  on(
+    eventType: 'escape',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'escape',
+    handler: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'escape',
+    handler?: (event: {elementType: 'currencySelector'}) => any
+  ): StripeCurrencySelectorElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'currencySelector';
+      error: StripeError;
+    }) => any
+  ): StripeCurrencySelectorElement;
+};

package/dist/stripe-js/elements/index.d.mts

@@ -8,6 +8,7 @@ export * from './card-cvc';
 export * from './card-expiry';
 export * from './card-number';
 export * from './card';
+export * from './currency-selector';
 export * from './eps-bank';
 export * from './express-checkout';
 export * from './fpx-bank';

package/dist/stripe-js/elements/index.d.ts

@@ -8,6 +8,7 @@ export * from './card-cvc';
 export * from './card-expiry';
 export * from './card-number';
 export * from './card';
+export * from './currency-selector';
 export * from './eps-bank';
 export * from './express-checkout';
 export * from './fpx-bank';

package/dist/stripe-js/elements/payment.d.mts

@@ -116,6 +116,31 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'}) => any
   ): StripePaymentElement;
 
+  /**
+   * The change event is triggered when the `Element`'s value changes.
+   * Represents the details of a selected Card payment method.
+   */
+  on(
+    eventType: 'carddetailschange',
+    handler: (event: StripePaymentElementCardDetailsChangeEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is updated.
+   */
+  on(
+    eventType: 'savedpaymentmethodupdate',
+    handler: (event: StripePaymentElementSavedPaymentMethodUpdateEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is removed.
+   */
+  on(
+    eventType: 'savedpaymentmethodremove',
+    handler: (event: StripePaymentElementSavedPaymentMethodRemoveEvent) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
@@ -158,6 +183,7 @@ export interface FieldsOption {
         phone?: FieldOption;
         address?:
           | FieldOption
+          | 'if_required'
           | {
               country?: FieldOption;
               postalCode?: FieldOption;
@@ -297,3 +323,112 @@ export interface StripePaymentElementChangeEvent {
     };
   };
 }
+
+type CardBrand =
+  | 'amex'
+  | 'diners'
+  | 'discover'
+  | 'eftpos_au'
+  | 'jcb'
+  | 'mastercard'
+  | 'unionpay'
+  | 'visa'
+  | 'unknown';
+type CardFunding = 'credit' | 'debit' | 'prepaid' | 'unknown';
+
+export interface StripePaymentElementCardDetailsChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the card details are loading.
+   */
+  loading: boolean;
+
+  /**
+   * The card details for the selected payment method.
+   * Undefined while loading and for non card payment methods.
+   */
+  details?: {
+    brands: CardBrand[] | null;
+    funding: CardFunding | null;
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodUpdateEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully updated.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method update fails.
+   */
+  error?: string;
+
+  /**
+   * The updated saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodRemoveEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully removed.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method removal fails.
+   */
+  error?: string;
+
+  /**
+   * The removed saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}

package/dist/stripe-js/elements/payment.d.ts

@@ -116,6 +116,31 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'}) => any
   ): StripePaymentElement;
 
+  /**
+   * The change event is triggered when the `Element`'s value changes.
+   * Represents the details of a selected Card payment method.
+   */
+  on(
+    eventType: 'carddetailschange',
+    handler: (event: StripePaymentElementCardDetailsChangeEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is updated.
+   */
+  on(
+    eventType: 'savedpaymentmethodupdate',
+    handler: (event: StripePaymentElementSavedPaymentMethodUpdateEvent) => any
+  ): StripePaymentElement;
+
+  /**
+   * Triggered when a Saved Payment Method is removed.
+   */
+  on(
+    eventType: 'savedpaymentmethodremove',
+    handler: (event: StripePaymentElementSavedPaymentMethodRemoveEvent) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
@@ -158,6 +183,7 @@ export interface FieldsOption {
         phone?: FieldOption;
         address?:
           | FieldOption
+          | 'if_required'
           | {
               country?: FieldOption;
               postalCode?: FieldOption;
@@ -297,3 +323,112 @@ export interface StripePaymentElementChangeEvent {
     };
   };
 }
+
+type CardBrand =
+  | 'amex'
+  | 'diners'
+  | 'discover'
+  | 'eftpos_au'
+  | 'jcb'
+  | 'mastercard'
+  | 'unionpay'
+  | 'visa'
+  | 'unknown';
+type CardFunding = 'credit' | 'debit' | 'prepaid' | 'unknown';
+
+export interface StripePaymentElementCardDetailsChangeEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the card details are loading.
+   */
+  loading: boolean;
+
+  /**
+   * The card details for the selected payment method.
+   * Undefined while loading and for non card payment methods.
+   */
+  details?: {
+    brands: CardBrand[] | null;
+    funding: CardFunding | null;
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodUpdateEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully updated.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method update fails.
+   */
+  error?: string;
+
+  /**
+   * The updated saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}
+
+export interface StripePaymentElementSavedPaymentMethodRemoveEvent {
+  /**
+   * The type of element that emitted this event.
+   */
+  elementType: 'payment';
+
+  /**
+   * `true` when the saved payment method is successfully removed.
+   */
+  success: boolean;
+
+  /**
+   * Error message if the saved payment method removal fails.
+   */
+  error?: string;
+
+  /**
+   * The removed saved payment method.
+   */
+  payment_method: {
+    id: string;
+    type: string;
+    billing_details: {
+      address: {
+        city: null | string;
+        country: null | string;
+        line1: null | string;
+        line2: null | string;
+        postal_code: null | string;
+        state: null | string;
+      };
+      name: null | string;
+      email: null | string;
+      phone: null | string;
+    };
+  };
+}

package/dist/stripe-js/elements-group.d.mts

@@ -1,6 +1,7 @@
 import {
   StripeAddressElement,
   StripeAddressElementOptions,
+  StripeCurrencySelectorElement,
   StripeShippingAddressElement,
   StripeShippingAddressElementOptions,
   StripePaymentRequestButtonElement,
@@ -332,9 +333,6 @@ export interface StripeElements {
   /////////////////////////////
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Creates a `LinkAuthenticationElement`.
    */
   create(
@@ -343,9 +341,6 @@ export interface StripeElements {
   ): StripeLinkAuthenticationElement;
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Looks up a previously created `Element` by its type.
    */
   getElement(
@@ -500,6 +495,7 @@ export type StripeElementType =
   | 'cardNumber'
   | 'cardExpiry'
   | 'cardCvc'
+  | 'currencySelector'
   | 'epsBank'
   | 'expressCheckout'
   | 'fpxBank'
@@ -531,6 +527,7 @@ export type StripeElement =
   | StripeIbanElement
   | StripeIdealBankElement
   | StripeP24BankElement
+  | StripeCurrencySelectorElement
   | StripeExpressCheckoutElement
   | StripePaymentElement
   | StripePaymentMethodMessagingElement

package/dist/stripe-js/elements-group.d.ts

@@ -1,6 +1,7 @@
 import {
   StripeAddressElement,
   StripeAddressElementOptions,
+  StripeCurrencySelectorElement,
   StripeShippingAddressElement,
   StripeShippingAddressElementOptions,
   StripePaymentRequestButtonElement,
@@ -332,9 +333,6 @@ export interface StripeElements {
   /////////////////////////////
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Creates a `LinkAuthenticationElement`.
    */
   create(
@@ -343,9 +341,6 @@ export interface StripeElements {
   ): StripeLinkAuthenticationElement;
 
   /**
-   * Requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Looks up a previously created `Element` by its type.
    */
   getElement(
@@ -500,6 +495,7 @@ export type StripeElementType =
   | 'cardNumber'
   | 'cardExpiry'
   | 'cardCvc'
+  | 'currencySelector'
   | 'epsBank'
   | 'expressCheckout'
   | 'fpxBank'
@@ -531,6 +527,7 @@ export type StripeElement =
   | StripeIbanElement
   | StripeIdealBankElement
   | StripeP24BankElement
+  | StripeCurrencySelectorElement
   | StripeExpressCheckoutElement
   | StripePaymentElement
   | StripePaymentMethodMessagingElement

package/dist/stripe-js/embedded-checkout.d.mts

@@ -17,6 +17,29 @@ export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
   shippingDetails: StripeEmbeddedCheckoutShippingDetails;
 };
 
+export type StripeEmbeddedCheckoutLineItem = {
+  id?: string;
+  quantity?: number;
+  price?: string;
+  display?: {
+    name?: string;
+    description?: string;
+    images?: string[];
+  };
+  pricingSpec?: {
+    unitAmount?: number;
+    unitAmountDecimal?: string;
+    currency?: string;
+    taxBehavior?: 'inclusive' | 'exclusive' | 'unspecified';
+    taxCode?: string;
+  };
+};
+
+export type StripeEmbeddedCheckoutLineItemsChangeEvent = {
+  checkoutSessionId: string;
+  lineItems: StripeEmbeddedCheckoutLineItem[];
+};
+
 export type ResultAction =
   | {type: 'accept'}
   | {type: 'reject'; errorMessage?: string};
@@ -45,6 +68,13 @@ export interface StripeEmbeddedCheckoutOptions {
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
   ) => Promise<ResultAction>;
+  /**
+   * onLineItemsChange is called when the customer adds, removes, or modifies a line item.
+   * The callback is required when [permissions.update.line_items](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-line_items) is set to `server_only`.
+   */
+  onLineItemsChange?: (
+    event: StripeEmbeddedCheckoutLineItemsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

package/dist/stripe-js/embedded-checkout.d.ts

@@ -17,6 +17,29 @@ export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
   shippingDetails: StripeEmbeddedCheckoutShippingDetails;
 };
 
+export type StripeEmbeddedCheckoutLineItem = {
+  id?: string;
+  quantity?: number;
+  price?: string;
+  display?: {
+    name?: string;
+    description?: string;
+    images?: string[];
+  };
+  pricingSpec?: {
+    unitAmount?: number;
+    unitAmountDecimal?: string;
+    currency?: string;
+    taxBehavior?: 'inclusive' | 'exclusive' | 'unspecified';
+    taxCode?: string;
+  };
+};
+
+export type StripeEmbeddedCheckoutLineItemsChangeEvent = {
+  checkoutSessionId: string;
+  lineItems: StripeEmbeddedCheckoutLineItem[];
+};
+
 export type ResultAction =
   | {type: 'accept'}
   | {type: 'reject'; errorMessage?: string};
@@ -45,6 +68,13 @@ export interface StripeEmbeddedCheckoutOptions {
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
   ) => Promise<ResultAction>;
+  /**
+   * onLineItemsChange is called when the customer adds, removes, or modifies a line item.
+   * The callback is required when [permissions.update.line_items](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-line_items) is set to `server_only`.
+   */
+  onLineItemsChange?: (
+    event: StripeEmbeddedCheckoutLineItemsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

package/dist/stripe-js/payment-intents.d.mts

@@ -269,6 +269,21 @@ export interface CreatePaymentMethodMobilepayData
   type: 'mobilepay';
 }
 
+export interface CreatePaymentMethodMultibancoData
+  extends PaymentMethodCreateParams {
+  type: 'multibanco';
+
+  /**
+   * The customer's billing details.
+   * `email` is required.
+   *
+   * @docs https://stripe.com/docs/api/payment_methods/create#create_payment_method-billing_details
+   */
+  billing_details: PaymentMethodCreateParams.BillingDetails & {
+    email: string;
+  };
+}
+
 export interface CreatePaymentMethodOxxoData extends PaymentMethodCreateParams {
   type: 'oxxo';
 
@@ -370,6 +385,11 @@ export interface CreatePaymentMethodSofortData
   billing_details?: PaymentMethodCreateParams.BillingDetails;
 }
 
+export interface CreatePaymentMethodTwintData
+  extends PaymentMethodCreateParams {
+  type: 'twint';
+}
+
 export interface CreatePaymentMethodAuBecsDebitData
   extends PaymentMethodCreateParams {
   /**
@@ -1076,6 +1096,36 @@ export interface ConfirmMobilepayPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmMultibancoPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmMultibancoPaymentData
+  extends PaymentIntentConfirmParams {
+  /**
+   * Either the `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods), or an object containing data to create a `PaymentMethod` with.
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent`.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodMultibancoData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   *
+   * @recommended
+   */
+  return_url?: string;
+}
+
+export interface ConfirmMultibancoPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmOxxoPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1278,6 +1328,35 @@ export interface ConfirmSofortPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmTwintPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmTwintPaymentData extends PaymentIntentConfirmParams {
+  /**
+   * Either the `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods), or an object containing data to create a `PaymentMethod` with.
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent`.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodTwintData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   *
+   * @recommended
+   */
+  return_url?: string;
+}
+
+export interface ConfirmTwintPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmWechatPayPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1460,9 +1539,6 @@ export interface ConfirmPaymentData extends PaymentIntentConfirmParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/stripe-js/payment-intents.d.ts

@@ -269,6 +269,21 @@ export interface CreatePaymentMethodMobilepayData
   type: 'mobilepay';
 }
 
+export interface CreatePaymentMethodMultibancoData
+  extends PaymentMethodCreateParams {
+  type: 'multibanco';
+
+  /**
+   * The customer's billing details.
+   * `email` is required.
+   *
+   * @docs https://stripe.com/docs/api/payment_methods/create#create_payment_method-billing_details
+   */
+  billing_details: PaymentMethodCreateParams.BillingDetails & {
+    email: string;
+  };
+}
+
 export interface CreatePaymentMethodOxxoData extends PaymentMethodCreateParams {
   type: 'oxxo';
 
@@ -370,6 +385,11 @@ export interface CreatePaymentMethodSofortData
   billing_details?: PaymentMethodCreateParams.BillingDetails;
 }
 
+export interface CreatePaymentMethodTwintData
+  extends PaymentMethodCreateParams {
+  type: 'twint';
+}
+
 export interface CreatePaymentMethodAuBecsDebitData
   extends PaymentMethodCreateParams {
   /**
@@ -1076,6 +1096,36 @@ export interface ConfirmMobilepayPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmMultibancoPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmMultibancoPaymentData
+  extends PaymentIntentConfirmParams {
+  /**
+   * Either the `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods), or an object containing data to create a `PaymentMethod` with.
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent`.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodMultibancoData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   *
+   * @recommended
+   */
+  return_url?: string;
+}
+
+export interface ConfirmMultibancoPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmOxxoPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1278,6 +1328,35 @@ export interface ConfirmSofortPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmTwintPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmTwintPaymentData extends PaymentIntentConfirmParams {
+  /**
+   * Either the `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods), or an object containing data to create a `PaymentMethod` with.
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent`.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodTwintData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   *
+   * @recommended
+   */
+  return_url?: string;
+}
+
+export interface ConfirmTwintPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmWechatPayPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1460,9 +1539,6 @@ export interface ConfirmPaymentData extends PaymentIntentConfirmParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/stripe-js/setup-intents.d.mts

@@ -42,9 +42,6 @@ export interface ConfirmSetupData extends SetupIntentConfirmParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/stripe-js/setup-intents.d.ts

@@ -42,9 +42,6 @@ export interface ConfirmSetupData extends SetupIntentConfirmParams {
     billing_details?: PaymentMethodCreateParams.BillingDetails;
 
     /**
-     * Requires beta access:
-     * Contact [Stripe support](https://support.stripe.com/) for more information.
-     *
      * Specifies if the PaymentMethod should be redisplayed when using the Saved Payment Method feature
      */
     allow_redisplay?: 'always' | 'limited' | 'unspecified';

package/dist/stripe-js/stripe.d.mts

@@ -437,6 +437,24 @@ export interface Stripe {
     options?: paymentIntents.ConfirmMobilepayPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmMultibancoPayment` in the [Multibanco Payment](https://stripe.com/docs/payments/multibanco) with Payment Methods flow when the customer submits your payment form.
+   * When called, it will confirm the [PaymentIntent](https://stripe.com/docs/api/payment_intents) with `data` you provide.
+   * Note that there are some additional requirements to this flow that are not covered in this reference.
+   * Refer to our [integration guide](https://stripe.com/docs/payments/multibanco) for more details.
+   *
+   * When you confirm a `PaymentIntent`, it needs to have an attached [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * In addition to confirming the `PaymentIntent`, this method can automatically create and attach a new PaymentMethod for you.
+   * If you have already attached a `PaymentMethod` you can call this method without needing to provide any additional data.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/confirm_multibanco_payment
+   */
+  confirmMultibancoPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmMultibancoPaymentData,
+    options?: paymentIntents.ConfirmMultibancoPaymentOptions
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Use `stripe.confirmOxxoPayment` in the [OXXO Payment](https://stripe.com/docs/payments/oxxo) with Payment Methods flow when the customer submits your payment form.
    * When called, it will confirm the [PaymentIntent](https://stripe.com/docs/api/payment_intents) with `data` you provide.
@@ -579,6 +597,23 @@ export interface Stripe {
     options?: paymentIntents.ConfirmSofortPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmTwintPayment` in the [TWINT Payments with Payment Methods](https://stripe.com/docs/payments/twint) flow when the customer submits your payment form.
+   * When called, it will confirm the `PaymentIntent` with `data` you provide, and it will automatically redirect the customer to authorize the transaction.
+   * Once authorization is complete, the customer will be redirected back to your specified `return_url`.
+   *
+   * When you confirm a `PaymentIntent`, it needs to have an attached [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * In addition to confirming the `PaymentIntent`, this method can automatically create and attach a new `PaymentMethod` for you.
+   * If you have already attached a `PaymentMethod` you can call this method without needing to provide any additional data.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/confirm_twint_payment
+   */
+  confirmTwintPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmTwintPaymentData,
+    options?: paymentIntents.ConfirmTwintPaymentOptions
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Requires beta access:
    * Contact [Stripe support](https://support.stripe.com/) for more information.

package/dist/stripe-js/stripe.d.ts

@@ -437,6 +437,24 @@ export interface Stripe {
     options?: paymentIntents.ConfirmMobilepayPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmMultibancoPayment` in the [Multibanco Payment](https://stripe.com/docs/payments/multibanco) with Payment Methods flow when the customer submits your payment form.
+   * When called, it will confirm the [PaymentIntent](https://stripe.com/docs/api/payment_intents) with `data` you provide.
+   * Note that there are some additional requirements to this flow that are not covered in this reference.
+   * Refer to our [integration guide](https://stripe.com/docs/payments/multibanco) for more details.
+   *
+   * When you confirm a `PaymentIntent`, it needs to have an attached [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * In addition to confirming the `PaymentIntent`, this method can automatically create and attach a new PaymentMethod for you.
+   * If you have already attached a `PaymentMethod` you can call this method without needing to provide any additional data.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/confirm_multibanco_payment
+   */
+  confirmMultibancoPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmMultibancoPaymentData,
+    options?: paymentIntents.ConfirmMultibancoPaymentOptions
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Use `stripe.confirmOxxoPayment` in the [OXXO Payment](https://stripe.com/docs/payments/oxxo) with Payment Methods flow when the customer submits your payment form.
    * When called, it will confirm the [PaymentIntent](https://stripe.com/docs/api/payment_intents) with `data` you provide.
@@ -579,6 +597,23 @@ export interface Stripe {
     options?: paymentIntents.ConfirmSofortPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmTwintPayment` in the [TWINT Payments with Payment Methods](https://stripe.com/docs/payments/twint) flow when the customer submits your payment form.
+   * When called, it will confirm the `PaymentIntent` with `data` you provide, and it will automatically redirect the customer to authorize the transaction.
+   * Once authorization is complete, the customer will be redirected back to your specified `return_url`.
+   *
+   * When you confirm a `PaymentIntent`, it needs to have an attached [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * In addition to confirming the `PaymentIntent`, this method can automatically create and attach a new `PaymentMethod` for you.
+   * If you have already attached a `PaymentMethod` you can call this method without needing to provide any additional data.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/confirm_twint_payment
+   */
+  confirmTwintPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmTwintPaymentData,
+    options?: paymentIntents.ConfirmTwintPaymentOptions
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Requires beta access:
    * Contact [Stripe support](https://support.stripe.com/) for more information.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-js",
-  "version": "4.7.0",
+  "version": "4.9.0",
   "description": "Stripe.js loading utility",
   "repository": "github:stripe/stripe-js",
   "main": "lib/index.js",