@stripe/stripe-js 1.25.0 → 1.28.0

package/dist/pure.esm.js

@@ -54,7 +54,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.25.0",
+    version: "1.28.0",
     startTime: startTime
   });
 };
@@ -117,7 +117,8 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var stripe = maybeStripe.apply(undefined, args);
   registerWrapper(stripe, startTime);
   return stripe;
-};
+}; // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+
 var validateLoadParams = function validateLoadParams(params) {
   var errorMessage = "invalid load parameters; expected object of shape\n\n    {advancedFraudSignals: boolean}\n\nbut received\n\n    ".concat(JSON.stringify(params), "\n");
 

package/dist/pure.js

@@ -58,7 +58,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.25.0",
+    version: "1.28.0",
     startTime: startTime
   });
 };
@@ -121,7 +121,8 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var stripe = maybeStripe.apply(undefined, args);
   registerWrapper(stripe, startTime);
   return stripe;
-};
+}; // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+
 var validateLoadParams = function validateLoadParams(params) {
   var errorMessage = "invalid load parameters; expected object of shape\n\n    {advancedFraudSignals: boolean}\n\nbut received\n\n    ".concat(JSON.stringify(params), "\n");
 

package/dist/stripe.esm.js

@@ -38,7 +38,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.25.0",
+    version: "1.28.0",
     startTime: startTime
   });
 };
@@ -101,7 +101,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var stripe = maybeStripe.apply(undefined, args);
   registerWrapper(stripe, startTime);
   return stripe;
-};
+}; // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
 
 // own script injection.
 

package/dist/stripe.js

@@ -42,7 +42,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.25.0",
+    version: "1.28.0",
     startTime: startTime
   });
 };
@@ -105,7 +105,7 @@ var initStripe = function initStripe(maybeStripe, args, startTime) {
   var stripe = maybeStripe.apply(undefined, args);
   registerWrapper(stripe, startTime);
   return stripe;
-};
+}; // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
 
 // own script injection.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/stripe-js",
-  "version": "1.25.0",
+  "version": "1.28.0",
   "description": "Stripe.js loading utility",
   "main": "dist/stripe.js",
   "module": "dist/stripe.esm.js",

package/src/shared.ts

@@ -132,6 +132,7 @@ export const initStripe = (
   return stripe;
 };
 
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
 export const validateLoadParams = (params: any): LoadParams => {
   const errorMessage = `invalid load parameters; expected object of shape
 

package/types/api/payment-intents.d.ts

@@ -77,9 +77,9 @@ export interface PaymentIntent {
   next_action: PaymentIntent.NextAction | null;
 
   /**
-   * ID of the payment method used in this PaymentIntent.
+   * ID of the payment method used in this PaymentIntent, or the PaymentMethod itself if this field is expanded.
    */
-  payment_method: string | null;
+  payment_method: string | null | PaymentMethod;
 
   /**
    * The list of payment method types (e.g. card) that this PaymentIntent is allowed to use.

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

@@ -62,6 +62,8 @@ export interface PaymentMethod {
   afterpay_clearpay?: PaymentMethod.AfterpayClearpay;
 
   acss_debit?: PaymentMethod.AcssDebit;
+
+  us_bank_account?: PaymentMethod.UsBankAccount;
 }
 
 export namespace PaymentMethod {
@@ -266,6 +268,28 @@ export namespace PaymentMethod {
      */
     transit_number: string;
   }
+
+  export interface UsBankAccount {
+    /**
+     * Customer’s bank account number.
+     */
+    account_number: string;
+
+    /**
+     * The routing transit number for the bank account.
+     */
+    routing_number: string;
+
+    /**
+     * The type of entity that holds the account. This can be either `individual` or `company`.
+     */
+    account_holder_type: string;
+
+    /**
+     * Account type: checkings or savings. Defaults to checking if omitted.
+     */
+    account_type: string;
+  }
 }
 
 export interface PaymentMethodCreateParams {

package/types/api/setup-intents.d.ts

@@ -52,9 +52,9 @@ export interface SetupIntent {
   next_action: SetupIntent.NextAction | null;
 
   /**
-   * ID of the payment method used with this SetupIntent.
+   * ID of the payment method used with this SetupIntent, or the PaymentMethod itself if this field is expanded.
    */
-  payment_method: string | null;
+  payment_method: string | null | PaymentMethod;
 
   /**
    * The list of payment method types (e.g. card) that this SetupIntent is allowed to set up.

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

@@ -40,6 +40,12 @@ export interface StripeElements {
    */
   update(options: StripeElementsUpdateOptions): void;
 
+  /**
+   * Fetches updates from the associated PaymentIntent or SetupIntent on an existing
+   * instance of Elements, and reflects these updates in the Payment Element.
+   */
+  fetchUpdates(): Promise<{error?: {message: string; status?: string}}>;
+
   /////////////////////////////
   /// affirmMessage
   /////////////////////////////
@@ -458,6 +464,13 @@ export interface StripeElementsOptions {
    * @docs https://stripe.com/docs/api/payment_intents/object#payment_intent_object-client_secret
    */
   clientSecret?: string;
+
+  /**
+   * Display skeleton loader UI while waiting for Elements to be fully loaded, after they are mounted.
+   * Supported for the `payment`, `shippingAddress`, and `linkAuthentication` Elements.
+   * Default is `'auto'` (Stripe determines if a loader UI should be shown).
+   */
+  loader?: 'auto' | 'always' | 'never';
 }
 
 /*

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

@@ -34,6 +34,7 @@ export type CreatePaymentMethodData =
   | CreatePaymentMethodPayNowData
   | CreatePaymentMethodPromptPayData
   | CreatePaymentMethodFpxData
+  | CreatePaymentMethodUsBankAccountData
   | CreatePaymentMethodSepaDebitData
   | CreatePaymentMethodSofortData
   | CreatePaymentMethodWechatPayData;
@@ -443,6 +444,66 @@ export interface CreatePaymentMethodAcssDebitData
   billing_details: PaymentMethodCreateParams.BillingDetails;
 }
 
+export interface CreatePaymentMethodUsBankAccountData
+  extends PaymentMethodCreateParams {
+  type: 'us_bank_account';
+
+  /**
+   * Can be omitted as Stripe will help to collect bank account details and verification.
+   * Refer to our [integration guide](https://stripe.com/docs/payments/acss-debit/accept-a-payment) for more details.
+   */
+  us_bank_account: {
+    /**
+     * Customer’s bank account number.
+     */
+    account_number: string;
+
+    /**
+     * The routing transit number for the bank account.
+     */
+    routing_number: string;
+
+    /**
+     * The type of entity that holds the account. This can be either `individual` or `company`.
+     */
+    account_holder_type: string;
+
+    /**
+     * Account type: checkings or savings. Defaults to checking if omitted.
+     */
+    account_type?: string;
+  };
+
+  /**
+   * The customer's billing details.
+   * `name`, `email`, and `address` are required.
+   *
+   * @docs https://stripe.com/docs/api/payment_methods/create#create_payment_method-billing_details
+   */
+  billing_details: PaymentMethodCreateParams.BillingDetails;
+}
+
+export interface CollectBankAccountParams {
+  /**
+   * The payment method type for the bank account details (e.g. `us_bank_account`)
+   */
+  payment_method_type: string;
+  /**
+   * Payment method specific data to be sent with the request (billing details)
+   */
+  payment_method_data: CollectBankAccountPaymentMethodData;
+}
+
+export interface CollectBankAccountPaymentMethodData {
+  /**
+   * The customer's billing details.
+   * `name`, `email`, and `address` are required.
+   *
+   * @docs https://stripe.com/docs/api/payment_methods/create#create_payment_method-billing_details
+   */
+  billing_details: PaymentMethodCreateParams.BillingDetails;
+}
+
 /**
  * Data to be sent with a `stripe.confirmBancontactPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1207,6 +1268,17 @@ export interface ConfirmAcssDebitPaymentOptions {
   skipMandate?: boolean;
 }
 
+export interface ConfirmUsBankAccountPaymentData
+  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<CreatePaymentMethodUsBankAccountData, 'type'>;
+}
+
 /**
  * Data to be sent with a `stripe.confirmPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1231,6 +1303,11 @@ export interface ConfirmPaymentData extends PaymentIntentConfirmParams {
      */
     billing_details?: PaymentMethodCreateParams.BillingDetails;
   };
+
+  /**
+   * Specifies which fields in the response should be expanded.
+   */
+  expand?: Array<string>;
 }
 
 /**
@@ -1242,3 +1319,20 @@ export interface VerifyMicrodepositsForPaymentData {
    */
   amounts?: Array<number>;
 }
+
+/**
+ * Data to be sent with a `stripe.collectBankAccountForPayment` request.
+ */
+export interface CollectBankAccountForPaymentOptions {
+  /**
+   * The client secret of the PaymentIntent.
+   */
+  clientSecret: string;
+
+  params: CollectBankAccountParams;
+
+  /**
+   * Specifies which fields in the response should be expanded.
+   */
+  expand?: Array<string>;
+}

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

@@ -10,6 +10,8 @@ import {
   CreatePaymentMethodSofortData,
   CreatePaymentMethodPayPalData,
   CreatePaymentMethodBacsDebitData,
+  CreatePaymentMethodUsBankAccountData,
+  CollectBankAccountParams,
 } from './payment-intents';
 
 import {Omit} from '../utils';
@@ -186,3 +188,31 @@ export interface VerifyMicrodepositsForSetupData {
    */
   amounts?: Array<number>;
 }
+
+export interface ConfirmUsBankAccountSetupData
+  extends SetupIntentConfirmParams {
+  /**
+   * 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 `SetupIntent`.
+   *
+   * @recommended
+   */
+  payment_method?: string | Omit<CreatePaymentMethodUsBankAccountData, 'type'>;
+}
+
+/**
+ * Data to be sent with a `stripe.collectBankAccountForSetup` request.
+ */
+export interface CollectBankAccountForSetupOptions {
+  /**
+   * The client secret of the SetupIntent.
+   */
+  clientSecret: string;
+
+  params: CollectBankAccountParams;
+
+  /**
+   * Specifies which fields in the response should be expanded.
+   */
+  expand?: Array<string>;
+}

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

@@ -89,6 +89,19 @@ export interface Stripe {
     options?: paymentIntents.ConfirmAcssDebitPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmUsBankAccountPayment` in the [Accept a payment](https://stripe.com/docs/payments/ach-debit/accept-a-payment) flow for the [ACH Direct Debit]((https://stripe.com/docs/payments/ach-debit) payment method to record the customer’s authorization for payment.
+   *
+   * When you confirm a [PaymentIntent](https://stripe.com/docs/api/payment_intents), it needs to have an attached PaymentMethod.
+   * Use `stripe.collectBankAccountForPayment` to collect and attach a [PaymentMethod](https://stripe.com/docs/api/payment_methods), or provide bank account details using the `data` parameter if a `PaymentMethod` was not already provided.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/confirm_us_bank_account_payment
+   */
+  confirmUsBankAccountPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmUsBankAccountPaymentData
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Use `stripe.confirmAlipayPayment` in the [Alipay Payments](https://stripe.com/docs/payments/alipay) 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, and it will automatically redirect the customer to authorize the transaction.
@@ -493,6 +506,16 @@ export interface Stripe {
     data?: paymentIntents.VerifyMicrodepositsForPaymentData
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.collectBankAccountForPayment` in the [Accept a payment flow](https://stripe.com/docs/payments/ach-debit/accept-a-payment) for the [ACH Direct Debit](https://stripe.com/docs/payments/ach-debit)
+   * payment method to collect the customer’s bank account in your payment form.
+   *
+   * @docs https://stripe.com/docs/js/payment_intents/collect_bank_account_for_payment
+   */
+  collectBankAccountForPayment(
+    options: paymentIntents.CollectBankAccountForPaymentOptions
+  ): Promise<PaymentIntentResult>;
+
   /**
    * Use stripe.createPaymentMethod to convert payment information collected by elements into a [PaymentMethod](https://stripe.com/docs/api/payment_methods) object that you safely pass to your server to use in an API call.
    *
@@ -562,6 +585,19 @@ export interface Stripe {
     options?: setupIntents.ConfirmAcssDebitSetupOptions
   ): Promise<SetupIntentResult>;
 
+  /**
+   * Use `stripe.confirmUsBankAccountSetup` in the [Save bank details](https://stripe.com/docs/payments/ach-debit/set-up-payment) flow for the [ACH Direct Debit payment](https://stripe.com/docs/payments/ach-debit) method to record the customer’s authorization for future payments.
+   *
+   * When you confirm a [SetupIntent](https://stripe.com/docs/api/setup_intents), it needs to have an attached PaymentMethod.
+   * Use `stripe.collectBankAccountForSetup` to collect and attach a [PaymentMethod](https://stripe.com/docs/api/payment_methods), or provide bank account details using the `data` parameter if a `PaymentMethod` was not already provided.
+   *
+   * @docs https://stripe.com/docs/js/setup_intents/confirm_us_bank_account_setup
+   */
+  confirmUsBankAccountSetup(
+    clientSecret: string,
+    data?: setupIntents.ConfirmUsBankAccountSetupData
+  ): Promise<SetupIntentResult>;
+
   /**
    * Requires beta access:
    * Contact [Stripe support](https://support.stripe.com/) for more information.
@@ -742,6 +778,16 @@ export interface Stripe {
     data?: setupIntents.VerifyMicrodepositsForSetupData
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.collectBankAccountForSetup` in the [Save bank details](https://stripe.com/docs/payments/ach-debit/set-up-payment) flow for the [ACH Direct Debit](https://stripe.com/docs/payments/ach-debit)
+   * payment method to collect the customer’s bank account in your payment form.
+   *
+   * @docs https://stripe.com/docs/js/setup_intents/collect_bank_account_for_setup
+   */
+  collectBankAccountForSetup(
+    options: setupIntents.CollectBankAccountForSetupOptions
+  ): Promise<SetupIntentResult>;
+
   /**
    * Retrieve a [SetupIntent](https://stripe.com/docs/api/setup_intents) using its client secret.
    *