@stripe/stripe-js 9.13.0 → 9.15.0

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

@@ -1,5 +1,5 @@
 import {StripeElements} from '../stripe-js';
-import {Address} from './shared';
+import {Address, MetadataParam} from './shared';
 import {PaymentMethod, PaymentMethodCreateParams} from './payment-methods';
 import {PaymentIntent} from './payment-intents';
 
@@ -105,6 +105,15 @@ export interface ConfirmationTokenCreateParams {
    * The url your customer will be directed to after they complete authentication.
    */
   return_url?: string | null;
+
+  /**
+   * Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+   *
+   * This can be a maximum of 50 keys.
+   *
+   * @docs https://docs.stripe.com/js/confirmation_tokens/create_confirmation_token#create_confirmation_token-options-params-metadata
+   */
+  metadata?: MetadataParam;
 }
 
 export interface CreateConfirmationToken {

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

@@ -1,5 +1,5 @@
 import {StripeElements} from '../stripe-js';
-import {Address} from './shared';
+import {Address, MetadataParam} from './shared';
 import {PaymentMethod, PaymentMethodCreateParams} from './payment-methods';
 import {PaymentIntent} from './payment-intents';
 
@@ -105,6 +105,15 @@ export interface ConfirmationTokenCreateParams {
    * The url your customer will be directed to after they complete authentication.
    */
   return_url?: string | null;
+
+  /**
+   * Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+   *
+   * This can be a maximum of 50 keys.
+   *
+   * @docs https://docs.stripe.com/js/confirmation_tokens/create_confirmation_token#create_confirmation_token-options-params-metadata
+   */
+  metadata?: MetadataParam;
 }
 
 export interface CreateConfirmationToken {

package/dist/index.js

@@ -71,7 +71,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "9.13.0",
+    version: "9.15.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.13.0", " 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.15.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.13.0",
+    version: "9.15.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.13.0", " 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.15.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.13.0",
+    version: "9.15.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.13.0", " 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.15.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.13.0",
+    version: "9.15.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.13.0", " 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.15.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 = {

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 = {

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

@@ -336,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';
 
@@ -392,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.
    */
@@ -419,6 +429,7 @@ export type StripePaymentElementUpdateOptions = Pick<
   | 'terms'
   | 'layout'
   | 'applePay'
+  | 'walletOptions'
 >;
 
 export interface StripePaymentElementChangeEvent {

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

@@ -336,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';
 
@@ -392,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.
    */
@@ -419,6 +429,7 @@ export type StripePaymentElementUpdateOptions = Pick<
   | 'terms'
   | 'layout'
   | 'applePay'
+  | 'walletOptions'
 >;
 
 export interface StripePaymentElementChangeEvent {

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

@@ -1247,6 +1247,7 @@ export interface Appearance {
     colorWarning?: string;
 
     // Buttons
+    buttonBoxShadow?: string;
     buttonColorBackground?: string;
     buttonColorText?: string;
     buttonFontSize?: string;
@@ -1404,15 +1405,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

@@ -1247,6 +1247,7 @@ export interface Appearance {
     colorWarning?: string;
 
     // Buttons
+    buttonBoxShadow?: string;
     buttonColorBackground?: string;
     buttonColorText?: string;
     buttonFontSize?: string;
@@ -1404,15 +1405,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.13.0",
+  "version": "9.15.0",
   "description": "Stripe.js loading utility",
   "repository": "github:stripe/stripe-js",
   "main": "lib/index.js",