@stripe/stripe-js 4.1.0 → 4.3.0

package/dist/api/payment-methods.d.mts

@@ -150,6 +150,21 @@ export namespace PaymentMethod {
      */
     last4: string;
 
+    /**
+     * Contains information about card networks that can be used to process the payment.
+     */
+    networks: {
+      /**
+       * The preferred network for co-branded cards.
+       */
+      preferred: string | null;
+
+      /**
+       * All available networks for the card.
+       */
+      available: string[];
+    } | null;
+
     /**
      * Contains details on how this Card maybe be used for 3D Secure authentication.
      */

package/dist/api/payment-methods.d.ts

@@ -150,6 +150,21 @@ export namespace PaymentMethod {
      */
     last4: string;
 
+    /**
+     * Contains information about card networks that can be used to process the payment.
+     */
+    networks: {
+      /**
+       * The preferred network for co-branded cards.
+       */
+      preferred: string | null;
+
+      /**
+       * All available networks for the card.
+       */
+      available: string[];
+    } | null;
+
     /**
      * Contains details on how this Card maybe be used for 3D Secure authentication.
      */

package/dist/index.js

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

package/dist/index.mjs

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

package/dist/pure.js

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

package/dist/pure.mjs

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

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

@@ -100,6 +100,32 @@ export type StripeCustomCheckoutLastPaymentError = {
   message: string;
 };
 
+export type StripeCustomCheckoutRedirectBehavior = 'always' | 'if_required';
+
+export type StripeCustomCheckoutSavedPaymentMethod = {
+  id: string;
+  type: 'card';
+  card: {
+    brand: string;
+    expMonth: number;
+    expYear: number;
+    last4: string;
+  };
+  billingDetails: {
+    email?: string | null;
+    name?: string | null;
+    phone?: string | null;
+    address?: {
+      line1?: string | null;
+      line2?: string | null;
+      city?: string | null;
+      postal_code?: string | null;
+      state?: string | null;
+      country?: string | null;
+    } | null;
+  };
+};
+
 export type StripeCustomCheckoutTaxAmount = {
   amount: number;
   inclusive: boolean;
@@ -179,15 +205,19 @@ export type StripeCustomCheckoutTrial = {
 /* Custom Checkout session */
 export interface StripeCustomCheckoutSession {
   billingAddress: StripeCustomCheckoutContact | null;
+  businessName: string | null;
   canConfirm: boolean;
   confirmationRequirements: StripeCustomCheckoutConfirmationRequirement[];
   currency: string;
   discountAmounts: Array<StripeCustomCheckoutDiscountAmount> | null;
   email: string | null;
+  id: string;
   lastPaymentError: StripeCustomCheckoutLastPaymentError | null;
   lineItems: Array<StripeCustomCheckoutLineItem>;
+  livemode: boolean;
   phoneNumber: string | null;
   recurring: StripeCustomCheckoutRecurring | null;
+  savedPaymentMethods: Array<StripeCustomCheckoutSavedPaymentMethod> | null;
   shipping: StripeCustomCheckoutShipping | null;
   shippingAddress: StripeCustomCheckoutContact | null;
   shippingOptions: Array<StripeCustomCheckoutShippingOption>;
@@ -374,6 +404,10 @@ export interface StripeCustomCheckout {
   ) => Promise<StripeCustomCheckoutResult>;
   confirm: (args?: {
     return_url?: string;
+    returnUrl?: string;
+    redirect?: StripeCustomCheckoutRedirectBehavior;
+    paymentMethod?: string;
+    savePaymentMethod?: boolean;
   }) => Promise<StripeCustomCheckoutResult>;
   session: () => StripeCustomCheckoutSession;
   on: (event: 'change', handler: StripeCustomCheckoutUpdateHandler) => void;

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

@@ -100,6 +100,32 @@ export type StripeCustomCheckoutLastPaymentError = {
   message: string;
 };
 
+export type StripeCustomCheckoutRedirectBehavior = 'always' | 'if_required';
+
+export type StripeCustomCheckoutSavedPaymentMethod = {
+  id: string;
+  type: 'card';
+  card: {
+    brand: string;
+    expMonth: number;
+    expYear: number;
+    last4: string;
+  };
+  billingDetails: {
+    email?: string | null;
+    name?: string | null;
+    phone?: string | null;
+    address?: {
+      line1?: string | null;
+      line2?: string | null;
+      city?: string | null;
+      postal_code?: string | null;
+      state?: string | null;
+      country?: string | null;
+    } | null;
+  };
+};
+
 export type StripeCustomCheckoutTaxAmount = {
   amount: number;
   inclusive: boolean;
@@ -179,15 +205,19 @@ export type StripeCustomCheckoutTrial = {
 /* Custom Checkout session */
 export interface StripeCustomCheckoutSession {
   billingAddress: StripeCustomCheckoutContact | null;
+  businessName: string | null;
   canConfirm: boolean;
   confirmationRequirements: StripeCustomCheckoutConfirmationRequirement[];
   currency: string;
   discountAmounts: Array<StripeCustomCheckoutDiscountAmount> | null;
   email: string | null;
+  id: string;
   lastPaymentError: StripeCustomCheckoutLastPaymentError | null;
   lineItems: Array<StripeCustomCheckoutLineItem>;
+  livemode: boolean;
   phoneNumber: string | null;
   recurring: StripeCustomCheckoutRecurring | null;
+  savedPaymentMethods: Array<StripeCustomCheckoutSavedPaymentMethod> | null;
   shipping: StripeCustomCheckoutShipping | null;
   shippingAddress: StripeCustomCheckoutContact | null;
   shippingOptions: Array<StripeCustomCheckoutShippingOption>;
@@ -374,6 +404,10 @@ export interface StripeCustomCheckout {
   ) => Promise<StripeCustomCheckoutResult>;
   confirm: (args?: {
     return_url?: string;
+    returnUrl?: string;
+    redirect?: StripeCustomCheckoutRedirectBehavior;
+    paymentMethod?: string;
+    savePaymentMethod?: boolean;
   }) => Promise<StripeCustomCheckoutResult>;
   session: () => StripeCustomCheckoutSession;
   on: (event: 'change', handler: StripeCustomCheckoutUpdateHandler) => void;

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

@@ -259,3 +259,7 @@ export interface StripeAddressElementChangeEvent {
     phone?: string;
   };
 }
+
+export interface StripeAddressElementGetElementOptions {
+  mode: AddressMode;
+}

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

@@ -259,3 +259,7 @@ export interface StripeAddressElementChangeEvent {
     phone?: string;
   };
 }
+
+export interface StripeAddressElementGetElementOptions {
+  mode: AddressMode;
+}

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

@@ -47,6 +47,7 @@ import {
   StripeIssuingCardCopyButtonElementOptions,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementOptions,
+  StripeAddressElementGetElementOptions,
 } from './elements';
 import {StripeError} from './stripe';
 
@@ -84,7 +85,10 @@ export interface StripeElements {
   /**
    * Looks up a previously created `Element` by its type.
    */
-  getElement(elementType: 'address'): StripeAddressElement | null;
+  getElement(
+    elementType: 'address',
+    options?: StripeAddressElementGetElementOptions
+  ): StripeAddressElement | null;
 
   /////////////////////////////
   /// paymentMethodMessaging

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

@@ -47,6 +47,7 @@ import {
   StripeIssuingCardCopyButtonElementOptions,
   StripeExpressCheckoutElement,
   StripeExpressCheckoutElementOptions,
+  StripeAddressElementGetElementOptions,
 } from './elements';
 import {StripeError} from './stripe';
 
@@ -84,7 +85,10 @@ export interface StripeElements {
   /**
    * Looks up a previously created `Element` by its type.
    */
-  getElement(elementType: 'address'): StripeAddressElement | null;
+  getElement(
+    elementType: 'address',
+    options?: StripeAddressElementGetElementOptions
+  ): StripeAddressElement | null;
 
   /////////////////////////////
   /// paymentMethodMessaging

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

@@ -1,3 +1,26 @@
+export type StripeEmbeddedCheckoutAddress = {
+  country: string;
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  postal_code?: string | null;
+  state?: string | null;
+};
+
+export type StripeEmbeddedCheckoutShippingDetails = {
+  name: string;
+  address: StripeEmbeddedCheckoutAddress;
+};
+
+export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
+  checkoutSessionId: string;
+  shippingDetails: StripeEmbeddedCheckoutShippingDetails;
+};
+
+export type ResultAction =
+  | {type: 'accept'}
+  | {type: 'reject'; errorMessage?: string};
+
 export interface StripeEmbeddedCheckoutOptions {
   /**
    * The client secret of the [Checkout Session](https://stripe.com/docs/api/checkout/sessions).
@@ -13,6 +36,15 @@ export interface StripeEmbeddedCheckoutOptions {
    * You can use it to unmount Embedded Checkout and render a custom success UI.
    */
   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).
+   */
+  onShippingDetailsChange?: (
+    event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

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

@@ -1,3 +1,26 @@
+export type StripeEmbeddedCheckoutAddress = {
+  country: string;
+  line1?: string | null;
+  line2?: string | null;
+  city?: string | null;
+  postal_code?: string | null;
+  state?: string | null;
+};
+
+export type StripeEmbeddedCheckoutShippingDetails = {
+  name: string;
+  address: StripeEmbeddedCheckoutAddress;
+};
+
+export type StripeEmbeddedCheckoutShippingDetailsChangeEvent = {
+  checkoutSessionId: string;
+  shippingDetails: StripeEmbeddedCheckoutShippingDetails;
+};
+
+export type ResultAction =
+  | {type: 'accept'}
+  | {type: 'reject'; errorMessage?: string};
+
 export interface StripeEmbeddedCheckoutOptions {
   /**
    * The client secret of the [Checkout Session](https://stripe.com/docs/api/checkout/sessions).
@@ -13,6 +36,15 @@ export interface StripeEmbeddedCheckoutOptions {
    * You can use it to unmount Embedded Checkout and render a custom success UI.
    */
   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).
+   */
+  onShippingDetailsChange?: (
+    event: StripeEmbeddedCheckoutShippingDetailsChangeEvent
+  ) => Promise<ResultAction>;
 }
 
 export interface StripeEmbeddedCheckout {

package/package.json

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