@stripe/stripe-js 9.12.1 → 9.14.0

package/dist/index.js

@@ -71,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "9.12.1",
+    version: "9.14.0",
     startTime: startTime
   });
 };
@@ -172,7 +172,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.12.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.14.0", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/index.mjs

@@ -67,7 +67,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "9.12.1",
+    version: "9.14.0",
     startTime: startTime
   });
 };
@@ -168,7 +168,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.12.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.14.0", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/pure.js

@@ -71,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "9.12.1",
+    version: "9.14.0",
     startTime: startTime
   });
 };
@@ -172,7 +172,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.12.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.14.0", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

package/dist/pure.mjs

@@ -67,7 +67,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "9.12.1",
+    version: "9.14.0",
     startTime: startTime
   });
 };
@@ -168,7 +168,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var expectedVersion = RELEASE_TRAIN;
 
   if (isTestKey && version !== expectedVersion) {
-    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.12.1", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
+    console.warn("Stripe.js@".concat(version, " was loaded on the page, but @stripe/stripe-js@").concat("9.14.0", " expected Stripe.js@").concat(expectedVersion, ". This may result in unexpected behavior. For more information, see https://docs.stripe.com/sdks/stripejs-versioning"));
   }
 
   var stripe = maybeStripe.apply(undefined, args);

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

@@ -3,6 +3,7 @@ import {
   Layout,
   TermsOption,
   StripePaymentElement,
+  PaymentWalletOptionsOption,
 } from './elements/payment';
 import {ContactOption, StripeAddressElement} from './elements/address';
 import {Appearance, CssFontSource, CustomFontSource} from './elements-group';
@@ -405,6 +406,7 @@ export type StripeCheckoutPaymentElementOptions = {
   terms?: TermsOption;
   fields?: FieldsOption;
   wallets?: PaymentWalletsOption;
+  walletOptions?: PaymentWalletOptionsOption;
 };
 
 export type StripeCheckoutAddressElementOptions = {
@@ -468,6 +470,21 @@ export type StripeCheckoutFormOptions = {
      */
     paymentMethods?: ExpressCheckoutPaymentMethodsOption;
   };
+
+  /**
+   * Client-side feature configuration for the CheckoutForm.
+   */
+  features?: {
+    /**
+     * Control whether the promotion code collection UI is displayed in the CheckoutForm.
+     *
+     * Only applies when `allow_promotion_codes`is enabled on the Checkout Session.
+     *
+     * @default 'auto'
+     * @docs https://stripe.com/docs/checkout/promotion-codes
+     */
+    promotionCodeCollection?: 'auto' | 'never';
+  };
 };
 
 export type StripeCheckoutExpressCheckoutElementOptions = {

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

@@ -3,6 +3,7 @@ import {
   Layout,
   TermsOption,
   StripePaymentElement,
+  PaymentWalletOptionsOption,
 } from './elements/payment';
 import {ContactOption, StripeAddressElement} from './elements/address';
 import {Appearance, CssFontSource, CustomFontSource} from './elements-group';
@@ -405,6 +406,7 @@ export type StripeCheckoutPaymentElementOptions = {
   terms?: TermsOption;
   fields?: FieldsOption;
   wallets?: PaymentWalletsOption;
+  walletOptions?: PaymentWalletOptionsOption;
 };
 
 export type StripeCheckoutAddressElementOptions = {
@@ -468,6 +470,21 @@ export type StripeCheckoutFormOptions = {
      */
     paymentMethods?: ExpressCheckoutPaymentMethodsOption;
   };
+
+  /**
+   * Client-side feature configuration for the CheckoutForm.
+   */
+  features?: {
+    /**
+     * Control whether the promotion code collection UI is displayed in the CheckoutForm.
+     *
+     * Only applies when `allow_promotion_codes`is enabled on the Checkout Session.
+     *
+     * @default 'auto'
+     * @docs https://stripe.com/docs/checkout/promotion-codes
+     */
+    promotionCodeCollection?: 'auto' | 'never';
+  };
 };
 
 export type StripeCheckoutExpressCheckoutElementOptions = {

package/dist/stripe-js/elements/express-checkout.d.mts

@@ -607,6 +607,7 @@ export interface StripeExpressCheckoutElementAvailablePaymentMethodsChangeEvent
         paypal?: {available: boolean};
         amazonPay?: {available: boolean};
         klarna?: {available: boolean};
+        [customPaymentMethodId: string]: {available: boolean} | undefined;
       }
     | undefined;
 }

package/dist/stripe-js/elements/express-checkout.d.ts

@@ -607,6 +607,7 @@ export interface StripeExpressCheckoutElementAvailablePaymentMethodsChangeEvent
         paypal?: {available: boolean};
         amazonPay?: {available: boolean};
         klarna?: {available: boolean};
+        [customPaymentMethodId: string]: {available: boolean} | undefined;
       }
     | undefined;
 }

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

@@ -167,7 +167,9 @@ export type StripePaymentElement = StripeElementBase & {
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
    */
-  update(options: Partial<StripePaymentElementOptions>): StripePaymentElement;
+  update(
+    options: Partial<StripePaymentElementUpdateOptions>
+  ): StripePaymentElement;
 
   /**
    * Collapses the Payment Element into a row of payment method tabs.
@@ -334,6 +336,11 @@ export interface PaymentWalletsOption {
   link?: PaymentWalletOption;
 }
 
+export interface PaymentWalletOptionsOption {
+  emailRequired?: boolean;
+  phoneNumberRequired?: boolean;
+}
+
 export type Layout = 'tabs' | 'accordion' | 'auto';
 type RadiosOption = 'auto' | 'never' | 'always' | 'if_multiple';
 
@@ -390,6 +397,11 @@ export interface StripePaymentElementOptions {
    */
   wallets?: PaymentWalletsOption;
 
+  /**
+   * Control wallet behavior options in the Payment Element.
+   */
+  walletOptions?: PaymentWalletOptionsOption;
+
   /**
    * Specify a layout to use when rendering a Payment Element.
    */
@@ -401,6 +413,25 @@ export interface StripePaymentElementOptions {
   applePay?: ApplePayOption;
 }
 
+/**
+ * The subset of `StripePaymentElementOptions` that can be updated after the
+ * `PaymentElement` has been created.
+ *
+ * @see https://docs.stripe.com/js/elements_object/update_payment_element
+ */
+export type StripePaymentElementUpdateOptions = Pick<
+  StripePaymentElementOptions,
+  | 'defaultValues'
+  | 'business'
+  | 'paymentMethodOrder'
+  | 'fields'
+  | 'readOnly'
+  | 'terms'
+  | 'layout'
+  | 'applePay'
+  | 'walletOptions'
+>;
+
 export interface StripePaymentElementChangeEvent {
   /**
    * The type of element that emitted this event.

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

@@ -167,7 +167,9 @@ export type StripePaymentElement = StripeElementBase & {
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.
    */
-  update(options: Partial<StripePaymentElementOptions>): StripePaymentElement;
+  update(
+    options: Partial<StripePaymentElementUpdateOptions>
+  ): StripePaymentElement;
 
   /**
    * Collapses the Payment Element into a row of payment method tabs.
@@ -334,6 +336,11 @@ export interface PaymentWalletsOption {
   link?: PaymentWalletOption;
 }
 
+export interface PaymentWalletOptionsOption {
+  emailRequired?: boolean;
+  phoneNumberRequired?: boolean;
+}
+
 export type Layout = 'tabs' | 'accordion' | 'auto';
 type RadiosOption = 'auto' | 'never' | 'always' | 'if_multiple';
 
@@ -390,6 +397,11 @@ export interface StripePaymentElementOptions {
    */
   wallets?: PaymentWalletsOption;
 
+  /**
+   * Control wallet behavior options in the Payment Element.
+   */
+  walletOptions?: PaymentWalletOptionsOption;
+
   /**
    * Specify a layout to use when rendering a Payment Element.
    */
@@ -401,6 +413,25 @@ export interface StripePaymentElementOptions {
   applePay?: ApplePayOption;
 }
 
+/**
+ * The subset of `StripePaymentElementOptions` that can be updated after the
+ * `PaymentElement` has been created.
+ *
+ * @see https://docs.stripe.com/js/elements_object/update_payment_element
+ */
+export type StripePaymentElementUpdateOptions = Pick<
+  StripePaymentElementOptions,
+  | 'defaultValues'
+  | 'business'
+  | 'paymentMethodOrder'
+  | 'fields'
+  | 'readOnly'
+  | 'terms'
+  | 'layout'
+  | 'applePay'
+  | 'walletOptions'
+>;
+
 export interface StripePaymentElementChangeEvent {
   /**
    * The type of element that emitted this event.

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

@@ -1404,15 +1404,94 @@ export interface CustomPaymentMethod {
   /**
    * Additional options to configure the Custom Payment Method.
    */
-  options: {
+  options?: {
     /**
      * The payment form type.
      */
-    type: 'static';
+    type: 'static' | 'embedded';
 
     /**
      * Display additional information about the payment method, max 100 characters.
      */
     subtitle?: string;
+
+    /**
+     * Requires beta access:
+     * Contact [Stripe support](https://support.stripe.com/) for more information.
+     *
+     * Options for the embedded Custom Payment Method. Required for type: 'embedded'.
+     */
+    embedded?: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method form, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method form, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
+  };
+
+  /**
+   * Additional options to configure the Custom Payment Method in the Payment Element. Alias for `options`.
+   */
+  payment?: {
+    /**
+     * The payment form type.
+     */
+    type: 'static' | 'embedded';
+
+    /**
+     * Display additional information about the payment method, max 100 characters.
+     */
+    subtitle?: string;
+
+    /**
+     * Requires beta access:
+     * Contact [Stripe support](https://support.stripe.com/) for more information.
+     *
+     * Options for the embedded Custom Payment Method. Required for type: 'embedded'.
+     */
+    embedded?: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method form, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method form, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
+  };
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   *
+   * Additional options to configure the Custom Payment Method in the Express Checkout Element.
+   */
+  expressCheckout?: {
+    /**
+     * The payment button type.
+     */
+    type: 'embedded';
+
+    /**
+     * Options for the embedded Custom Payment Method.
+     */
+    embedded: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method button, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method button, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
   };
 }

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

@@ -1404,15 +1404,94 @@ export interface CustomPaymentMethod {
   /**
    * Additional options to configure the Custom Payment Method.
    */
-  options: {
+  options?: {
     /**
      * The payment form type.
      */
-    type: 'static';
+    type: 'static' | 'embedded';
 
     /**
      * Display additional information about the payment method, max 100 characters.
      */
     subtitle?: string;
+
+    /**
+     * Requires beta access:
+     * Contact [Stripe support](https://support.stripe.com/) for more information.
+     *
+     * Options for the embedded Custom Payment Method. Required for type: 'embedded'.
+     */
+    embedded?: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method form, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method form, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
+  };
+
+  /**
+   * Additional options to configure the Custom Payment Method in the Payment Element. Alias for `options`.
+   */
+  payment?: {
+    /**
+     * The payment form type.
+     */
+    type: 'static' | 'embedded';
+
+    /**
+     * Display additional information about the payment method, max 100 characters.
+     */
+    subtitle?: string;
+
+    /**
+     * Requires beta access:
+     * Contact [Stripe support](https://support.stripe.com/) for more information.
+     *
+     * Options for the embedded Custom Payment Method. Required for type: 'embedded'.
+     */
+    embedded?: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method form, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method form, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
+  };
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   *
+   * Additional options to configure the Custom Payment Method in the Express Checkout Element.
+   */
+  expressCheckout?: {
+    /**
+     * The payment button type.
+     */
+    type: 'embedded';
+
+    /**
+     * Options for the embedded Custom Payment Method.
+     */
+    embedded: {
+      /**
+       * Function for rendering custom content in the Custom Payment Method button, called on mount.
+       */
+      handleRender: (container: HTMLDivElement) => void;
+
+      /**
+       * Function for cleaning up the Custom Payment Method button, called when the Custom Payment Method is removed and on unmount.
+       */
+      handleDestroy?: () => void;
+    };
   };
 }

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

@@ -162,10 +162,7 @@ export interface StripeEmbeddedCheckoutOptions {
    */
   onComplete?: () => void;
   /**
-   * onShippingDetailsChange is called when the customer completes the shipping details form.
-   *
-   * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`.
-   * For a step-by-step guide on using this callback to customize shipping options during checkout, see [Customize Shipping Options](https://docs.stripe.com/payments/checkout/custom-shipping-options).
+   * @deprecated Dynamic shipping updates are deprecated in Embedded Checkout.
    */
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent

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

@@ -162,10 +162,7 @@ export interface StripeEmbeddedCheckoutOptions {
    */
   onComplete?: () => void;
   /**
-   * onShippingDetailsChange is called when the customer completes the shipping details form.
-   *
-   * The callback is required when [permissions.update.shipping_details](https://docs.stripe.com/api/checkout/sessions/create#create_checkout_session-permissions-update-shipping_details) is set to `server_only`.
-   * For a step-by-step guide on using this callback to customize shipping options during checkout, see [Customize Shipping Options](https://docs.stripe.com/payments/checkout/custom-shipping-options).
+   * @deprecated Dynamic shipping updates are deprecated in Embedded Checkout.
    */
   onShippingDetailsChange?: (
     event: StripeEmbeddedCheckoutShippingDetailsChangeEvent

package/package.json

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