@stripe/stripe-js 1.23.0 → 1.26.0

package/dist/pure.esm.js

@@ -54,7 +54,7 @@ var registerWrapper = function registerWrapper(stripe, startTime) {
 
   stripe._registerWrapper({
     name: 'stripe-js',
-    version: "1.23.0",
+    version: "1.26.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.23.0",
+    version: "1.26.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.23.0",
+    version: "1.26.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.23.0",
+    version: "1.26.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.23.0",
+  "version": "1.26.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-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/stripe-js/elements/shipping-address.d.ts

@@ -95,6 +95,31 @@ export interface StripeShippingAddressElementOptions {
    * Control which countries are displayed in the shippingAddress Element.
    */
   allowedCountries?: string[] | null;
+
+  /**
+   * Whether or not ShippingAddressElement accepts PO boxes
+   */
+  blockPoBox?: boolean;
+
+  /**
+   * Default value for ShippingAddressElement fields
+   */
+  defaultValues?: {
+    name?: string | null;
+    address?: {
+      line1?: string | null;
+      line2?: string | null;
+      city?: string | null;
+      state?: string | null;
+      postal_code?: string | null;
+      country: string;
+    };
+  };
+
+  /**
+   * Whether or not ShippingAddressElement provides autocomplete suggestions
+   */
+  disableAutocomplete?: boolean;
 }
 
 export interface StripeShippingAddressElementChangeEvent
@@ -124,13 +149,13 @@ export interface StripeShippingAddressElementChangeEvent
    */
   value: {
     name: string;
-    addressLine1: string;
-    addressLine2: string;
-    locality: string;
-    administrativeArea: string;
-    postalCode: string;
-    country: string;
-    dependentLocality: string;
-    sortingCode: string;
+    address: {
+      line1: string;
+      line2: string;
+      city: string;
+      state: string;
+      postal_code: string;
+      country: string;
+    };
   };
 }

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

@@ -28,11 +28,13 @@ export type CreatePaymentMethodData =
   | CreatePaymentMethodGrabPayData
   | CreatePaymentMethodIdealData
   | CreatePaymentMethodKlarnaData
+  | CreatePaymentMethodKonbiniData
   | CreatePaymentMethodP24Data
   | CreatePaymentMethodPayPalData
   | CreatePaymentMethodPayNowData
   | CreatePaymentMethodPromptPayData
   | CreatePaymentMethodFpxData
+  | CreatePaymentMethodUsBankAccountData
   | CreatePaymentMethodSepaDebitData
   | CreatePaymentMethodSofortData
   | CreatePaymentMethodWechatPayData;
@@ -224,6 +226,22 @@ export interface CreatePaymentMethodKlarnaData
   };
 }
 
+export interface CreatePaymentMethodKonbiniData
+  extends PaymentMethodCreateParams {
+  type: 'konbini';
+
+  /**
+   * The customer's billing details.
+   * `email` and `name` are required.
+   *
+   * @docs https://stripe.com/docs/api/payment_methods/create#create_payment_method-billing_details
+   */
+  billing_details: PaymentMethodCreateParams.BillingDetails & {
+    email: string;
+    name: string;
+  };
+}
+
 export interface CreatePaymentMethodOxxoData extends PaymentMethodCreateParams {
   type: 'oxxo';
 
@@ -426,6 +444,55 @@ 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 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.
@@ -828,6 +895,45 @@ export interface ConfirmKlarnaPaymentOptions {
   handleActions?: boolean;
 }
 
+/**
+ * Data to be sent with a `stripe.confirmKonbiniPayment` request.
+ * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
+ */
+export interface ConfirmKonbiniPaymentData 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<CreatePaymentMethodKonbiniData, 'type'>;
+
+  /**
+   * An object containing payment-method-specific configuration to confirm the [PaymentIntent](https://stripe.com/docs/api/payment_intents) with.
+   */
+  payment_method_options?: {
+    /**
+     * Configuration for this Konbini payment.
+     */
+    konbini: {
+      /**
+       * An optional 10 to 11 digit numeric-only string determining the confirmation code at applicable convenience stores. May not be all 0 and could be rejected in case of insufficient uniqueness. We recommend to use the customer’s phone number.
+       */
+      confirmation_number?: string;
+    };
+  };
+}
+
+/**
+ * An options object to control the behavior of `stripe.confirmKonbiniPayment`.
+ */
+export interface ConfirmKonbiniPaymentOptions {
+  /**
+   * Set this to `false` if you want to handle next actions yourself. Please refer to our [integration guide](https://stripe.com/docs/payments/konbini/accept-a-payment) for more info. 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.
@@ -994,6 +1100,17 @@ export interface ConfirmSofortPaymentData extends PaymentIntentConfirmParams {
   setup_future_usage?: 'off_session';
 }
 
+/**
+ * An options object to control the behavior of `stripe.confirmSofortPayment`.
+ */
+export interface ConfirmSofortPaymentOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmWechatPayPayment` request.
  * Refer to the [Payment Intents API](https://stripe.com/docs/api/payment_intents/confirm) for a full list of parameters.
@@ -1140,6 +1257,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.
@@ -1175,3 +1303,17 @@ export interface VerifyMicrodepositsForPaymentData {
    */
   amounts?: Array<number>;
 }
+
+/**
+ * Data to be sent with a `stripe.collectBankAccountForPayment` request.
+ */
+export interface CollectBankAccountForPaymentOptions {
+  /**
+   * 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;
+}

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

@@ -10,6 +10,8 @@ import {
   CreatePaymentMethodSofortData,
   CreatePaymentMethodPayPalData,
   CreatePaymentMethodBacsDebitData,
+  CreatePaymentMethodUsBankAccountData,
+  CollectBankAccountPaymentMethodData,
 } from './payment-intents';
 
 import {Omit} from '../utils';
@@ -100,6 +102,17 @@ export interface ConfirmSofortSetupData extends SetupIntentConfirmParams {
   payment_method?: string | Omit<CreatePaymentMethodSofortData, 'type'>;
 }
 
+/**
+ * An options object to control the behavior of `stripe.confirmSofortSetup`.
+ */
+export interface ConfirmSofortSetupOptions {
+  /**
+   * Set this to `false` if you want to [manually handle the authorization redirect](https://stripe.com/docs/payments/sofort/accept-a-payment?platform=web#handle-redirect).
+   * Default is `true`.
+   */
+  handleActions?: boolean;
+}
+
 /**
  * Data to be sent with a `stripe.confirmAuBecsDebitSetup` request.
  * Refer to the [Setup Intents API](https://stripe.com/docs/api/setup_intents/confirm) for a full list of parameters.
@@ -175,3 +188,28 @@ 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 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;
+}

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.
@@ -304,6 +317,24 @@ export interface Stripe {
     options?: paymentIntents.ConfirmKlarnaPaymentOptions
   ): Promise<PaymentIntentResult>;
 
+  /**
+   * Use `stripe.confirmKonbiniPayment` in the [Konbini](https://stripe.com/docs/payments/konbini) payment 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.
+   * Note that there are some additional requirements to this flow that are not covered in this reference.
+   * Refer to our [integration guide](https://stripe.com/docs/payments/konbini/accept-a-payment) 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_konbini_payment
+   */
+  confirmKonbiniPayment(
+    clientSecret: string,
+    data?: paymentIntents.ConfirmKonbiniPaymentData,
+    options?: paymentIntents.ConfirmKonbiniPaymentOptions
+  ): 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.
@@ -424,7 +455,8 @@ export interface Stripe {
    */
   confirmSofortPayment(
     clientSecret: string,
-    data?: paymentIntents.ConfirmSofortPaymentData
+    data?: paymentIntents.ConfirmSofortPaymentData,
+    options?: paymentIntents.ConfirmSofortPaymentOptions
   ): Promise<PaymentIntentResult>;
 
   /**
@@ -474,6 +506,17 @@ 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(
+    clientSecret: string,
+    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.
    *
@@ -543,6 +586,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.
@@ -680,7 +736,8 @@ export interface Stripe {
    */
   confirmSofortSetup(
     clientSecret: string,
-    data?: setupIntents.ConfirmSofortSetupData
+    data?: setupIntents.ConfirmSofortSetupData,
+    options?: setupIntents.ConfirmSofortSetupOptions
   ): Promise<SetupIntentResult>;
 
   /**
@@ -722,6 +779,17 @@ 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(
+    clientSecret: string,
+    options: setupIntents.CollectBankAccountForSetupOptions
+  ): Promise<SetupIntentResult>;
+
   /**
    * Retrieve a [SetupIntent](https://stripe.com/docs/api/setup_intents) using its client secret.
    *