stripe 19.2.0-beta.1 → 19.3.0-alpha.1

package/types/CustomerSessionsResource.d.ts

@@ -31,6 +31,16 @@ declare module 'stripe' {
          */
         buy_button?: Components.BuyButton;
 
+        /**
+         * Configuration for the customer sheet.
+         */
+        customer_sheet?: Components.CustomerSheet;
+
+        /**
+         * Configuration for the mobile payment element.
+         */
+        mobile_payment_element?: Components.MobilePaymentElement;
+
         /**
          * Configuration for the Payment Element.
          */
@@ -40,6 +50,11 @@ declare module 'stripe' {
          * Configuration for the pricing table.
          */
         pricing_table?: Components.PricingTable;
+
+        /**
+         * Configuration for the Tax ID Element.
+         */
+        tax_id_element?: Components.TaxIdElement;
       }
 
       namespace Components {
@@ -50,6 +65,116 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
+        interface CustomerSheet {
+          /**
+           * Whether the customer sheet is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the customer sheet supports certain features.
+           */
+          features?: CustomerSheet.Features;
+        }
+
+        namespace CustomerSheet {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the customer sheet displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether the customer sheet displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove?: Features.PaymentMethodRemove;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+          }
+        }
+
+        interface MobilePaymentElement {
+          /**
+           * Whether the mobile payment element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the mobile payment element supports certain features.
+           */
+          features?: MobilePaymentElement.Features;
+        }
+
+        namespace MobilePaymentElement {
+          interface Features {
+            /**
+             * A list of [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) values that controls which saved payment methods the mobile payment element displays by filtering to only show payment methods with an `allow_redisplay` value that is present in this list.
+             *
+             * If not specified, defaults to ["always"]. In order to display all saved payment methods, specify ["always", "limited", "unspecified"].
+             */
+            payment_method_allow_redisplay_filters?: Array<
+              Features.PaymentMethodAllowRedisplayFilter
+            >;
+
+            /**
+             * Controls whether or not the mobile payment element shows saved payment methods.
+             */
+            payment_method_redisplay?: Features.PaymentMethodRedisplay;
+
+            /**
+             * Controls whether the mobile payment element displays the option to remove a saved payment method."
+             *
+             * Allowing buyers to remove their saved payment methods impacts subscriptions that depend on that payment method. Removing the payment method detaches the [`customer` object](https://docs.stripe.com/api/payment_methods/object#payment_method_object-customer) from that [PaymentMethod](https://docs.stripe.com/api/payment_methods).
+             */
+            payment_method_remove?: Features.PaymentMethodRemove;
+
+            /**
+             * Controls whether the mobile payment element displays a checkbox offering to save a new payment method.
+             *
+             * If a customer checks the box, the [`allow_redisplay`](https://docs.stripe.com/api/payment_methods/object#payment_method_object-allow_redisplay) value on the PaymentMethod is set to `'always'` at confirmation time. For PaymentIntents, the [`setup_future_usage`](https://docs.stripe.com/api/payment_intents/object#payment_intent_object-setup_future_usage) value is also set to the value defined in `payment_method_save_usage`.
+             */
+            payment_method_save?: Features.PaymentMethodSave;
+
+            /**
+             * Allows overriding the value of allow_override when saving a new payment method when payment_method_save is set to disabled. Use values: "always", "limited", or "unspecified".
+             *
+             * If not specified, defaults to `nil` (no override value).
+             */
+            payment_method_save_allow_redisplay_override?: Features.PaymentMethodSaveAllowRedisplayOverride;
+          }
+
+          namespace Features {
+            type PaymentMethodAllowRedisplayFilter =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+
+            type PaymentMethodRedisplay = 'disabled' | 'enabled';
+
+            type PaymentMethodRemove = 'disabled' | 'enabled';
+
+            type PaymentMethodSave = 'disabled' | 'enabled';
+
+            type PaymentMethodSaveAllowRedisplayOverride =
+              | 'always'
+              | 'limited'
+              | 'unspecified';
+          }
+        }
+
         interface PaymentElement {
           /**
            * Whether the Payment Element is enabled.
@@ -127,6 +252,42 @@ declare module 'stripe' {
            */
           enabled: boolean;
         }
+
+        interface TaxIdElement {
+          /**
+           * Whether the Tax ID Element is enabled.
+           */
+          enabled: boolean;
+
+          /**
+           * This hash defines whether the Tax ID Element supports certain features.
+           */
+          features?: TaxIdElement.Features;
+        }
+
+        namespace TaxIdElement {
+          interface Features {
+            /**
+             * Controls whether the Tax ID Element displays saved tax IDs for the customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, the Tax ID Element will show existing tax IDs associated with the customer, allowing them to select from previously saved tax identification numbers.
+             */
+            tax_id_redisplay?: Features.TaxIdRedisplay;
+
+            /**
+             * Controls whether the Tax ID Element allows merchants to save new tax IDs for their customer. This parameter defaults to `disabled`.
+             *
+             * When enabled, customers can enter and save new tax identification numbers during the payment flow, which will be stored securely and associated with their customer object for future use.
+             */
+            tax_id_save?: Features.TaxIdSave;
+          }
+
+          namespace Features {
+            type TaxIdRedisplay = 'disabled' | 'enabled';
+
+            type TaxIdSave = 'disabled' | 'enabled';
+          }
+        }
       }
     }
 

package/types/Customers.d.ts

@@ -255,6 +255,11 @@ declare module 'stripe' {
          * The identified tax location of the customer.
          */
         location: Tax.Location | null;
+
+        /**
+         * The tax calculation provider used for location resolution. Defaults to `stripe` when not using a [third-party provider](https://docs.stripe.com/tax/third-party-apps).
+         */
+        provider: Tax.Provider;
       }
 
       namespace Tax {
@@ -288,6 +293,8 @@ declare module 'stripe' {
             | 'payment_method'
             | 'shipping_destination';
         }
+
+        type Provider = 'anrok' | 'avalara' | 'sphere' | 'stripe';
       }
 
       type TaxExempt = 'exempt' | 'none' | 'reverse';

package/types/CustomersResource.d.ts

@@ -896,6 +896,7 @@ declare module 'stripe' {
         | 'card'
         | 'cashapp'
         | 'crypto'
+        | 'custom'
         | 'customer_balance'
         | 'eps'
         | 'fpx'

package/types/DelegatedCheckout/RequestedSessions.d.ts

@@ -0,0 +1,292 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace DelegatedCheckout {
+      /**
+       * A requested session is a session that has been requested by a customer.
+       */
+      interface RequestedSession {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'delegated_checkout.requested_session';
+
+        /**
+         * The subtotal amount of the requested session.
+         */
+        amount_subtotal: number;
+
+        /**
+         * The total amount of the requested session.
+         */
+        amount_total: number;
+
+        /**
+         * Time at which the object was created. Measured in seconds since the Unix epoch.
+         */
+        created_at: number;
+
+        /**
+         * 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;
+
+        /**
+         * The customer for this requested session.
+         */
+        customer: string | null;
+
+        /**
+         * Time at which the requested session expires. Measured in seconds since the Unix epoch.
+         */
+        expires_at: number;
+
+        /**
+         * The details of the fulfillment.
+         */
+        fulfillment_details: RequestedSession.FulfillmentDetails | null;
+
+        /**
+         * The line items to be purchased.
+         */
+        line_item_details: Array<RequestedSession.LineItemDetail>;
+
+        /**
+         * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+         */
+        livemode: boolean;
+
+        /**
+         * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+         */
+        metadata: Stripe.Metadata | null;
+
+        /**
+         * The details of the order.
+         */
+        order_details: RequestedSession.OrderDetails | null;
+
+        /**
+         * The payment method used for the requested session.
+         */
+        payment_method: string | null;
+
+        seller_details: RequestedSession.SellerDetails;
+
+        /**
+         * Whether or not the payment method should be saved for future use.
+         */
+        setup_future_usage: 'on_session' | null;
+
+        /**
+         * The metadata shared with the seller.
+         */
+        shared_metadata: {
+          [key: string]: string;
+        } | null;
+
+        /**
+         * The SPT used for payment.
+         */
+        shared_payment_issued_token: string | null;
+
+        /**
+         * The status of the requested session.
+         */
+        status: RequestedSession.Status;
+
+        total_details: RequestedSession.TotalDetails;
+
+        /**
+         * Time at which the object was last updated. Measured in seconds since the Unix epoch.
+         */
+        updated_at: number;
+      }
+
+      namespace RequestedSession {
+        interface FulfillmentDetails {
+          /**
+           * The fulfillment address.
+           */
+          address: Stripe.Address | null;
+
+          /**
+           * The email address for the fulfillment details.
+           */
+          email: string | null;
+
+          /**
+           * The fulfillment options.
+           */
+          fulfillment_options: Array<
+            FulfillmentDetails.FulfillmentOption
+          > | null;
+
+          /**
+           * The name for the fulfillment details.
+           */
+          name: string | null;
+
+          /**
+           * The phone number for the fulfillment details.
+           */
+          phone: string | null;
+
+          /**
+           * The fulfillment option.
+           */
+          selected_fulfillment_option: FulfillmentDetails.SelectedFulfillmentOption | null;
+        }
+
+        namespace FulfillmentDetails {
+          interface FulfillmentOption {
+            /**
+             * The shipping option.
+             */
+            shipping: FulfillmentOption.Shipping | null;
+
+            /**
+             * The type of the fulfillment option.
+             */
+            type: string;
+          }
+
+          namespace FulfillmentOption {
+            interface Shipping {
+              /**
+               * The shipping options.
+               */
+              shipping_options: Array<Shipping.ShippingOption> | null;
+            }
+
+            namespace Shipping {
+              interface ShippingOption {
+                /**
+                 * The description of the shipping option.
+                 */
+                description: string | null;
+
+                /**
+                 * The display name of the shipping option.
+                 */
+                display_name: string;
+
+                /**
+                 * The earliest delivery time of the shipping option.
+                 */
+                earliest_delivery_time: number | null;
+
+                /**
+                 * The key of the shipping option.
+                 */
+                key: string;
+
+                /**
+                 * The latest delivery time of the shipping option.
+                 */
+                latest_delivery_time: number | null;
+
+                /**
+                 * The shipping amount of the shipping option.
+                 */
+                shipping_amount: number;
+              }
+            }
+          }
+
+          interface SelectedFulfillmentOption {
+            /**
+             * The shipping option.
+             */
+            shipping: SelectedFulfillmentOption.Shipping | null;
+
+            /**
+             * The type of the selected fulfillment option.
+             */
+            type: string;
+          }
+
+          namespace SelectedFulfillmentOption {
+            interface Shipping {
+              /**
+               * The shipping option.
+               */
+              shipping_option: string | null;
+            }
+          }
+        }
+
+        interface LineItemDetail {
+          /**
+           * The description of the line item.
+           */
+          description: string | null;
+
+          /**
+           * The images of the line item.
+           */
+          images: Array<string> | null;
+
+          /**
+           * The key of the line item.
+           */
+          key: string;
+
+          /**
+           * The name of the line item.
+           */
+          name: string;
+
+          /**
+           * The quantity of the line item.
+           */
+          quantity: number;
+
+          /**
+           * The SKU ID of the line item.
+           */
+          sku_id: string;
+
+          /**
+           * The unit amount of the line item.
+           */
+          unit_amount: number;
+        }
+
+        interface OrderDetails {
+          /**
+           * The URL to the order status.
+           */
+          order_status_url: string | null;
+        }
+
+        interface SellerDetails {}
+
+        type Status = 'completed' | 'expired' | 'open';
+
+        interface TotalDetails {
+          /**
+           * The amount discount of the total details.
+           */
+          amount_discount: number | null;
+
+          /**
+           * The amount fulfillment of the total details.
+           */
+          amount_fulfillment: number | null;
+
+          /**
+           * The amount tax of the total details.
+           */
+          amount_tax: number | null;
+        }
+      }
+    }
+  }
+}