@stripe/stripe-js 1.29.0 → 1.32.0

package/dist/pure.esm.js

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

package/dist/pure.js

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

package/dist/stripe.esm.js

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

package/dist/stripe.js

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

package/package.json

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

package/types/api/index.d.ts

@@ -1,6 +1,7 @@
 export * from './shared';
 export * from './payment-methods';
 export * from './payment-intents';
+export * from './orders';
 export * from './setup-intents';
 export * from './sources';
 export * from './tokens';

package/types/api/orders.d.ts

@@ -0,0 +1,122 @@
+import {Address} from './shared';
+import {PaymentIntent} from './payment-intents';
+
+/**
+ * The Order object.
+ */
+export interface Order {
+  /**
+   * Unique identifier for the object.
+   */
+  id: string;
+
+  /**
+   * String representing the object's type. Objects of the same type share the same value.
+   */
+  object: 'order';
+
+  /**
+   * Total order cost after discounts and taxes are applied. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). To submit an order, the total must be either 0 or at least $0.50 USD or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts).
+   */
+  amount_total: number;
+
+  /**
+   * Order cost before any discounts or taxes are applied. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency).
+   */
+  amount_subtotal: number;
+
+  /**
+   * Customer billing details associated with the order.
+   */
+  billing_details: Order.Billing | null;
+
+  /**
+   * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+   */
+  currency: string;
+
+  /**
+   * Time at which the object was created. Measured in seconds since the Unix epoch.
+   */
+  created: number;
+
+  /**
+   * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+   */
+  livemode: boolean;
+
+  /**
+   * Customer shipping information associated with the order.
+   */
+  shipping_details: Order.Shipping | null;
+
+  /**
+   * Payment information associated with the order.
+   */
+  payment: Order.Payment;
+
+  /**
+   * The overall status of the order.
+   */
+  status: Order.Status;
+}
+
+export namespace Order {
+  export interface Billing {
+    /**
+     * Billing address for the order.
+     */
+    address?: Address;
+
+    /**
+     * Email address for the order.
+     */
+    email?: string | null;
+
+    /**
+     * Full name for the order.
+     */
+    name?: string | null;
+
+    /**
+     * Billing phone number for the order (including extension).
+     */
+    phone?: string | null;
+  }
+
+  export interface Shipping {
+    /**
+     * Recipient shipping address. Required if the order includes products that are shippable.
+     */
+    address?: Address;
+
+    /**
+     * Recipient name.
+     */
+    name?: string | null;
+
+    /**
+     * Recipient phone (including extension).
+     */
+    phone?: string | null;
+  }
+
+  export interface Payment {
+    /**
+     * Payment intent associated with this order. Null when the order is `open`.
+     */
+    payment_intent?: PaymentIntent | null;
+
+    /**
+     * The status of the underlying payment associated with this order, if any. Null when the order is `open`.
+     */
+    status?: PaymentIntent.Status | null;
+  }
+
+  export type Status =
+    | 'open'
+    | 'submitted'
+    | 'processing'
+    | 'complete'
+    | 'canceled';
+}

package/types/stripe-js/elements/link-authentication.d.ts

@@ -1,4 +1,5 @@
 import {StripeElementBase, StripeElementChangeEvent} from './base';
+import {StripeError} from '../stripe';
 
 export type StripeLinkAuthenticationElement = StripeElementBase & {
   /**
@@ -80,6 +81,31 @@ export type StripeLinkAuthenticationElement = StripeElementBase & {
     eventType: 'escape',
     handler?: (event: {elementType: 'linkAuthentication'}) => any
   ): StripeLinkAuthenticationElement;
+
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'linkAuthentication';
+      error: StripeError;
+    }) => any
+  ): StripeLinkAuthenticationElement;
 };
 
 export interface StripeLinkAuthenticationElementOptions {

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

@@ -1,4 +1,5 @@
 import {StripeElementBase} from './base';
+import {StripeError} from '../stripe';
 
 export type StripePaymentElement = StripeElementBase & {
   /**
@@ -81,6 +82,22 @@ export type StripePaymentElement = StripeElementBase & {
     handler?: (event: {elementType: 'payment'}) => any
   ): StripePaymentElement;
 
+  /**
+   * Triggered when the element fails to load.
+   */
+  on(
+    eventType: 'loaderror',
+    handler: (event: {elementType: 'payment'; error: StripeError}) => any
+  ): StripePaymentElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {elementType: 'payment'; error: StripeError}) => any
+  ): StripePaymentElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {elementType: 'payment'; error: StripeError}) => any
+  ): StripePaymentElement;
+
   /**
    * Updates the options the `PaymentElement` was initialized with.
    * Updates are merged into the existing configuration.

package/types/stripe-js/elements/shipping-address.d.ts

@@ -1,4 +1,5 @@
 import {StripeElementBase, StripeElementChangeEvent} from './base';
+import {StripeError} from '../stripe';
 
 export type StripeShippingAddressElement = StripeElementBase & {
   /**
@@ -82,11 +83,28 @@ export type StripeShippingAddressElement = StripeElementBase & {
   ): StripeShippingAddressElement;
 
   /**
-   * Updates the options the `ShippingAddressElement` was initialized with.
-   * Updates are merged into the existing configuration.
+   * Triggered when the element fails to load.
    */
-  update(
-    options: Partial<StripeShippingAddressElementOptions>
+  on(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
+  ): StripeShippingAddressElement;
+  once(
+    eventType: 'loaderror',
+    handler: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
+  ): StripeShippingAddressElement;
+  off(
+    eventType: 'loaderror',
+    handler?: (event: {
+      elementType: 'shippingAddress';
+      error: StripeError;
+    }) => any
   ): StripeShippingAddressElement;
 };
 
@@ -151,7 +169,7 @@ export interface StripeShippingAddressElementChangeEvent
     name: string;
     address: {
       line1: string;
-      line2: string;
+      line2: string | null;
       city: string;
       state: string;
       postal_code: string;

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

@@ -471,6 +471,15 @@ export interface StripeElementsOptions {
    * Default is `'auto'` (Stripe determines if a loader UI should be shown).
    */
   loader?: 'auto' | 'always' | 'never';
+
+  /**
+   * Requires beta access:
+   * Contact [Stripe support](https://support.stripe.com/) for more information.
+   *
+   * Display saved PaymentMethods and Customer information.
+   * Supported for the `payment`, `shippingAddress`, and `linkAuthentication` Elements.
+   */
+  customerOptions?: CustomerOptions;
 }
 
 /*
@@ -485,9 +494,6 @@ export interface StripeElementsUpdateOptions {
   locale?: StripeElementLocale;
 
   /**
-   * Used with the Payment Element, requires beta access:
-   * Contact [Stripe support](https://support.stripe.com/) for more information.
-   *
    * Match the design of your site with the appearance option.
    * The layout of each Element stays consistent, but you can modify colors, fonts, borders, padding, and more.
    *
@@ -638,3 +644,15 @@ export interface Appearance {
 
   labels?: 'above' | 'floating';
 }
+
+export interface CustomerOptions {
+  /**
+   * The Customer id.
+   */
+  customer: string;
+
+  /**
+   * The ephemeral key for a Customer that grants temporary access to Customer data.
+   */
+  ephemeralKey: string;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Parameters that will be passed on to the Stripe API to confirm payment for an Order's PaymentIntent.
+ */
+export interface ProcessOrderParams {
+  /**
+   * The url your customer will be directed to after they complete payment.
+   */
+  return_url: string;
+}

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

@@ -14,6 +14,11 @@ export interface PaymentRequest {
    */
   show(): void;
 
+  /**
+   * Closes the browser’s payment interface.
+   */
+  abort: () => void;
+
   /**
    * `true` if the browser’s payment interface is showing.
    * When using the `PaymentRequestButtonElement`, this is called for you automatically.

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

@@ -187,6 +187,11 @@ export interface VerifyMicrodepositsForSetupData {
    * An array of two positive integers, in cents, equal to the values of the microdeposits sent to the bank account.
    */
   amounts?: Array<number>;
+
+  /**
+   * A six-character code starting with SM present in the microdeposit sent to the bank account.
+   */
+  descriptor_code?: string;
 }
 
 export interface ConfirmUsBankAccountSetupData

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

@@ -1,6 +1,7 @@
 import * as api from '../api';
 import * as paymentIntents from './payment-intents';
 import * as setupIntents from './setup-intents';
+import * as orders from './orders';
 import * as tokens from './token-and-sources';
 import * as elements from './elements';
 
@@ -47,7 +48,7 @@ export interface Stripe {
    * When called, `stripe.confirmPayment` will attempt to complete any [required actions](https://stripe.com/docs/payments/intents), such as authenticating your user by displaying a 3DS dialog or redirecting them to a bank authorization page.
    * Your user will be redirected to the return_url you pass once the confirmation is complete.
    *
-   * By default, stripe.`confirmPayment` will always redirect to your return_url after a successful confirmation.
+   * By default, `stripe.confirmPayment` will always redirect to your return_url after a successful confirmation.
    * If you set `redirect: "if_required"`, then `stripe.confirmPayment` will only redirect if your user chooses a redirect-based payment method.
    * Setting `if_required` requires that you handle successful confirmations for redirect-based and non-redirect based payment methods separately.
    *
@@ -795,6 +796,49 @@ export interface Stripe {
    */
   retrieveSetupIntent(clientSecret: string): Promise<SetupIntentResult>;
 
+  /////////////////////////////
+  /// Orders
+  ///
+  /// https://stripe.com/docs/js/orders
+  /////////////////////////////
+
+  /**
+   * Use `stripe.processOrder` to submit and confirm payment for an [Order](https://stripe.com/docs/api/orders_v2) using data collected by the [Payment Element](https://stripe.com/docs/js/element/payment_element).
+   * When called, `stripe.processOrder` will attempt to complete any required actions, such as authenticating your user by displaying a 3DS dialog or redirecting them to a bank authorization page.
+   * Your user will be redirected to the return_url you pass once the confirmation is complete.
+   *
+   * By default, `stripe.processOrder` will always redirect to your return_url after a successful confirmation.
+   * If you set `redirect: "if_required"`, then `stripe.processOrder` will only redirect if your user chooses a redirect-based method.
+   * Setting `if_required` requires that you handle successful confirmations for redirect-based and non-redirect based payment methods separately.
+   *
+   * @docs https://stripe.com/docs/js/orders/process_order
+   */
+  processOrder(options: {
+    elements: StripeElements;
+    confirmParams?: Partial<orders.ProcessOrderParams>;
+    redirect: 'if_required';
+  }): Promise<ProcessOrderResult>;
+
+  /**
+   * Use `stripe.processOrder` to submit and confirm payment for an [Order](https://stripe.com/docs/api/orders_v2) using data collected by the [Payment Element](https://stripe.com/docs/js/element/payment_element).
+   * When called, `stripe.processOrder` will attempt to complete any required actions, such as authenticating your user by displaying a 3DS dialog or redirecting them to a bank authorization page.
+   * Your user will be redirected to the return_url you pass once the confirmation is complete.
+   *
+   * @docs https://stripe.com/docs/js/orders/process_order
+   */
+  processOrder(options: {
+    elements: StripeElements;
+    confirmParams: orders.ProcessOrderParams;
+    redirect?: 'always';
+  }): Promise<never | {error: StripeError}>;
+
+  /**
+   * Retrieve an [Order](https://stripe.com/docs/api/orders_v2) using its [client secret](https://stripe.com/docs/api/orders_v2/object#order_v2_object-client_secret).
+   *
+   * @docs https://stripe.com/docs/js/orders/retrieve_order
+   */
+  retrieveOrder(clientSecret: string): Promise<RetrieveOrderResult>;
+
   /////////////////////////////
   /// Payment Request
   ///
@@ -941,6 +985,15 @@ export type SetupIntentResult =
   | {setupIntent: api.SetupIntent; error?: undefined}
   | {setupIntent?: undefined; error: StripeError};
 
+export type ProcessOrderResult =
+  | {paymentIntent: api.PaymentIntent; order: api.Order; error?: undefined}
+  | {paymentIntent?: undefined; order: api.Order; error?: undefined}
+  | {paymentIntent?: undefined; order?: undefined; error: StripeError};
+
+export type RetrieveOrderResult =
+  | {order: api.Order; error?: undefined}
+  | {order?: undefined; error: StripeError};
+
 export type PaymentMethodResult =
   | {paymentMethod: api.PaymentMethod; error?: undefined}
   | {paymentMethod?: undefined; error: StripeError};