@stripe/stripe-js 3.4.1 → 4.0.0

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

@@ -403,17 +403,17 @@ export namespace PaymentMethodCreateParams {
     /**
      * Email address.
      */
-    email?: string;
+    email?: string | null;
 
     /**
      * Full name.
      */
-    name?: string;
+    name?: string | null;
 
     /**
      * Billing phone number (including extension).
      */
-    phone?: string;
+    phone?: string | null;
   }
 
   export namespace BillingDetails {
@@ -421,32 +421,32 @@ export namespace PaymentMethodCreateParams {
       /**
        * City, district, suburb, town, or village.
        */
-      city?: string;
+      city?: string | null;
 
       /**
        * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        */
-      country?: string;
+      country?: string | null;
 
       /**
        * Address line 1 (e.g., street, PO Box, or company name).
        */
-      line1?: string;
+      line1?: string | null;
 
       /**
        * Address line 2 (e.g., apartment, suite, unit, or building).
        */
-      line2?: string;
+      line2?: string | null;
 
       /**
        * ZIP or postal code.
        */
-      postal_code?: string;
+      postal_code?: string | null;
 
       /**
        * State, county, province, or region.
        */
-      state?: string;
+      state?: string | null;
     }
   }
 }

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

@@ -403,17 +403,17 @@ export namespace PaymentMethodCreateParams {
     /**
      * Email address.
      */
-    email?: string;
+    email?: string | null;
 
     /**
      * Full name.
      */
-    name?: string;
+    name?: string | null;
 
     /**
      * Billing phone number (including extension).
      */
-    phone?: string;
+    phone?: string | null;
   }
 
   export namespace BillingDetails {
@@ -421,32 +421,32 @@ export namespace PaymentMethodCreateParams {
       /**
        * City, district, suburb, town, or village.
        */
-      city?: string;
+      city?: string | null;
 
       /**
        * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
        */
-      country?: string;
+      country?: string | null;
 
       /**
        * Address line 1 (e.g., street, PO Box, or company name).
        */
-      line1?: string;
+      line1?: string | null;
 
       /**
        * Address line 2 (e.g., apartment, suite, unit, or building).
        */
-      line2?: string;
+      line2?: string | null;
 
       /**
        * ZIP or postal code.
        */
-      postal_code?: string;
+      postal_code?: string | null;
 
       /**
        * State, county, province, or region.
        */
-      state?: string;
+      state?: string | null;
     }
   }
 }

package/dist/index.js

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

package/dist/index.mjs

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

package/dist/pure.js

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

package/dist/pure.mjs

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

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

@@ -221,6 +221,7 @@ export type StripeCustomCheckoutExpressCheckoutElementOptions = {
   buttonTheme: StripeExpressCheckoutElementOptions['buttonTheme'];
   buttonType: StripeExpressCheckoutElementOptions['buttonType'];
   layout: StripeExpressCheckoutElementOptions['layout'];
+  paymentMethodOrder: StripeExpressCheckoutElementOptions['paymentMethodOrder'];
 };
 
 export type StripeCustomCheckoutUpdateHandler = (

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

@@ -221,6 +221,7 @@ export type StripeCustomCheckoutExpressCheckoutElementOptions = {
   buttonTheme: StripeExpressCheckoutElementOptions['buttonTheme'];
   buttonType: StripeExpressCheckoutElementOptions['buttonType'];
   layout: StripeExpressCheckoutElementOptions['layout'];
+  paymentMethodOrder: StripeExpressCheckoutElementOptions['paymentMethodOrder'];
 };
 
 export type StripeCustomCheckoutUpdateHandler = (

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

@@ -245,20 +245,34 @@ export type LayoutOption = {
   overflow?: 'auto' | 'never';
 };
 
-export type ExpressCheckoutWalletOption = 'always' | 'auto' | 'never';
+export type ExpressCheckoutPaymentMethodOptionWithAlways =
+  | 'always'
+  | ExpressCheckoutPaymentMethodOption;
+export type ExpressCheckoutPaymentMethodOption = 'auto' | 'never';
+
+export type ExpressCheckoutPaymentMethodsOption = {
+  amazonPay?: ExpressCheckoutPaymentMethodOption;
+  applePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  googlePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  link?: ExpressCheckoutPaymentMethodOption;
+  paypal?: ExpressCheckoutPaymentMethodOption;
+};
 
 export type ExpressCheckoutWalletsOption = {
-  applePay?: ExpressCheckoutWalletOption;
-  googlePay?: ExpressCheckoutWalletOption;
+  applePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  googlePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
 };
 
 export type ApplePayButtonTheme = 'black' | 'white' | 'white-outline';
 
 export type GooglePayButtonTheme = 'black' | 'white';
 
+export type PayPalButtonTheme = 'gold' | 'blue' | 'silver' | 'white' | 'black';
+
 export type ButtonThemeOption = {
   applePay?: ApplePayButtonTheme;
   googlePay?: GooglePayButtonTheme;
+  paypal?: PayPalButtonTheme;
 };
 
 export type ApplePayButtonType =
@@ -320,6 +334,14 @@ export interface StripeExpressCheckoutElementOptions {
   paymentMethodOrder?: string[];
 
   /**
+   * Control payment method display in the Express Checkout Element.
+   */
+  paymentMethods?: ExpressCheckoutPaymentMethodsOption;
+
+  /**
+   * @deprecated
+   * Use `paymentMethods` instead.
+   *
    * Control wallets display in the Express Checkout Element.
    */
   wallets?: ExpressCheckoutWalletsOption;

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

@@ -245,20 +245,34 @@ export type LayoutOption = {
   overflow?: 'auto' | 'never';
 };
 
-export type ExpressCheckoutWalletOption = 'always' | 'auto' | 'never';
+export type ExpressCheckoutPaymentMethodOptionWithAlways =
+  | 'always'
+  | ExpressCheckoutPaymentMethodOption;
+export type ExpressCheckoutPaymentMethodOption = 'auto' | 'never';
+
+export type ExpressCheckoutPaymentMethodsOption = {
+  amazonPay?: ExpressCheckoutPaymentMethodOption;
+  applePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  googlePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  link?: ExpressCheckoutPaymentMethodOption;
+  paypal?: ExpressCheckoutPaymentMethodOption;
+};
 
 export type ExpressCheckoutWalletsOption = {
-  applePay?: ExpressCheckoutWalletOption;
-  googlePay?: ExpressCheckoutWalletOption;
+  applePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
+  googlePay?: ExpressCheckoutPaymentMethodOptionWithAlways;
 };
 
 export type ApplePayButtonTheme = 'black' | 'white' | 'white-outline';
 
 export type GooglePayButtonTheme = 'black' | 'white';
 
+export type PayPalButtonTheme = 'gold' | 'blue' | 'silver' | 'white' | 'black';
+
 export type ButtonThemeOption = {
   applePay?: ApplePayButtonTheme;
   googlePay?: GooglePayButtonTheme;
+  paypal?: PayPalButtonTheme;
 };
 
 export type ApplePayButtonType =
@@ -320,6 +334,14 @@ export interface StripeExpressCheckoutElementOptions {
   paymentMethodOrder?: string[];
 
   /**
+   * Control payment method display in the Express Checkout Element.
+   */
+  paymentMethods?: ExpressCheckoutPaymentMethodsOption;
+
+  /**
+   * @deprecated
+   * Use `paymentMethods` instead.
+   *
    * Control wallets display in the Express Checkout Element.
    */
   wallets?: ExpressCheckoutWalletsOption;

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

@@ -264,6 +264,11 @@ export interface CreatePaymentMethodKonbiniData
   };
 }
 
+export interface CreatePaymentMethodMobilepayData
+  extends PaymentMethodCreateParams {
+  type: 'mobilepay';
+}
+
 export interface CreatePaymentMethodOxxoData extends PaymentMethodCreateParams {
   type: 'oxxo';
 
@@ -1040,6 +1045,37 @@ export interface ConfirmKonbiniPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmMobilepayPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmMobilepayPaymentData
+  extends PaymentIntentConfirmParams {
+  /**
+   * The `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent` or a new `PaymentMethod` will be created.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodMobilepayData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   */
+  return_url?: string;
+}
+
+/**
+ * An options object to control the behavior of `stripe.confirmMobilepayPayment`.
+ */
+export interface ConfirmMobilepayPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the redirect](https://docs.stripe.com/payments/mobilepay/accept-a-payment?web-or-mobile=web&payments-ui-type=direct-api#web-confirm-payment-intent).
+   * 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.

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

@@ -264,6 +264,11 @@ export interface CreatePaymentMethodKonbiniData
   };
 }
 
+export interface CreatePaymentMethodMobilepayData
+  extends PaymentMethodCreateParams {
+  type: 'mobilepay';
+}
+
 export interface CreatePaymentMethodOxxoData extends PaymentMethodCreateParams {
   type: 'oxxo';
 
@@ -1040,6 +1045,37 @@ export interface ConfirmKonbiniPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmMobilepayPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmMobilepayPaymentData
+  extends PaymentIntentConfirmParams {
+  /**
+   * The `id` of an existing [PaymentMethod](https://stripe.com/docs/api/payment_methods).
+   * This field is optional if a `PaymentMethod` has already been attached to this `PaymentIntent` or a new `PaymentMethod` will be created.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodMobilepayData, 'type'>;
+
+  /**
+   * The url your customer will be directed to after they complete authentication.
+   */
+  return_url?: string;
+}
+
+/**
+ * An options object to control the behavior of `stripe.confirmMobilepayPayment`.
+ */
+export interface ConfirmMobilepayPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the redirect](https://docs.stripe.com/payments/mobilepay/accept-a-payment?web-or-mobile=web&payments-ui-type=direct-api#web-confirm-payment-intent).
+   * 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.

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

@@ -420,6 +420,23 @@ export interface Stripe {
     options?: paymentIntents.ConfirmKonbiniPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmMobilepayPayment` in the [Mobilepay Payments](https://docs.stripe.com/payments/mobilepay) 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.
+   * Refer to our [integration guide](https://docs.stripe.com/payments/mobilepay) 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_mobilepay_payment
+   */
+  confirmMobilepayPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmMobilepayPaymentData,
+    options?: paymentIntents.ConfirmMobilepayPaymentOptions
+  ): 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.

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

@@ -420,6 +420,23 @@ export interface Stripe {
     options?: paymentIntents.ConfirmKonbiniPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmMobilepayPayment` in the [Mobilepay Payments](https://docs.stripe.com/payments/mobilepay) 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.
+   * Refer to our [integration guide](https://docs.stripe.com/payments/mobilepay) 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_mobilepay_payment
+   */
+  confirmMobilepayPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmMobilepayPaymentData,
+    options?: paymentIntents.ConfirmMobilepayPaymentOptions
+  ): 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.

package/package.json

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