stripe 16.9.0-beta.1 → 16.9.0

package/types/Checkout/SessionsResource.d.ts

@@ -25,7 +25,7 @@ declare module 'stripe' {
         billing_address_collection?: SessionCreateParams.BillingAddressCollection;
 
         /**
-         * If set, Checkout displays a back button and customers will be directed to this URL if they decide to cancel payment and return to your website. This parameter is not allowed if ui_mode is `embedded` or `custom`.
+         * If set, Checkout displays a back button and customers will be directed to this URL if they decide to cancel payment and return to your website. This parameter is not allowed if ui_mode is `embedded`.
          */
         cancel_url?: string;
 
@@ -187,13 +187,6 @@ declare module 'stripe' {
          */
         payment_method_types?: Array<SessionCreateParams.PaymentMethodType>;
 
-        /**
-         * This property is used to set up permissions for various actions (e.g., update) on the CheckoutSession object.
-         *
-         * For specific permissions, please refer to their dedicated subsections, such as `permissions.update.shipping_details`.
-         */
-        permissions?: SessionCreateParams.Permissions;
-
         /**
          * Controls phone number collection settings for the session.
          *
@@ -209,7 +202,7 @@ declare module 'stripe' {
 
         /**
          * The URL to redirect your customer back to after they authenticate or cancel their payment on the
-         * payment method's app or site. This parameter is required if `ui_mode` is `embedded` or `custom`
+         * payment method's app or site. This parameter is required if ui_mode is `embedded`
          * and redirect-based payment methods are enabled on the session.
          */
         return_url?: string;
@@ -249,7 +242,7 @@ declare module 'stripe' {
         /**
          * The URL to which Stripe should send customers when payment or setup
          * is complete.
-         * This parameter is not allowed if ui_mode is `embedded` or `custom`. If you'd like to use
+         * This parameter is not allowed if ui_mode is `embedded`. If you'd like to use
          * information from the successful Checkout Session on your page, read the
          * guide on [customizing your success page](https://stripe.com/docs/payments/checkout/custom-success-page).
          */
@@ -905,12 +898,14 @@ declare module 'stripe' {
           shipping?: PaymentIntentData.Shipping;
 
           /**
-           * Text that appears on the customer's statement as the [statement descriptor](https://docs.stripe.com/get-started/account/statement-descriptors) for a non-card charge. This value overrides the account's default statement descriptor. Setting this value for a card charge returns an error. For card charges, set the [statement_descriptor_suffix](https://docs.stripe.com/get-started/account/statement-descriptors#dynamic) instead.
+           * Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
+           *
+           * Setting this value for a card charge returns an error. For card charges, set the [statement_descriptor_suffix](https://docs.stripe.com/get-started/account/statement-descriptors#dynamic) instead.
            */
           statement_descriptor?: string;
 
           /**
-           * Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.corp.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement.
+           * Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement.
            */
           statement_descriptor_suffix?: string;
 
@@ -1118,11 +1113,6 @@ declare module 'stripe' {
            */
           paypal?: PaymentMethodOptions.Paypal;
 
-          /**
-           * contains details about the PayTo payment method options.
-           */
-          payto?: PaymentMethodOptions.Payto;
-
           /**
            * contains details about the Pix payment method options.
            */
@@ -1693,11 +1683,6 @@ declare module 'stripe' {
              */
             reference?: string;
 
-            /**
-             * A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
-             */
-            reference_id?: string;
-
             /**
              * The risk correlation ID for an on-session payment using a saved PayPal payment method.
              */
@@ -1715,11 +1700,6 @@ declare module 'stripe' {
              * If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
              */
             setup_future_usage?: Stripe.Emptyable<Paypal.SetupFutureUsage>;
-
-            /**
-             * The Stripe connected account IDs of the sellers on the platform for this transaction (optional). Only allowed when [separate charges and transfers](https://stripe.com/docs/connect/separate-charges-and-transfers) are used.
-             */
-            subsellers?: Array<string>;
           }
 
           namespace Paypal {
@@ -1749,92 +1729,6 @@ declare module 'stripe' {
             type SetupFutureUsage = 'none' | 'off_session';
           }
 
-          interface Payto {
-            /**
-             * Additional fields for Mandate creation
-             */
-            mandate_options?: Payto.MandateOptions;
-
-            /**
-             * Indicates that you intend to make future payments with this PaymentIntent's payment method.
-             *
-             * If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](https://stripe.com/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](https://stripe.com/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
-             *
-             * If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](https://stripe.com/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
-             *
-             * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
-             */
-            setup_future_usage?: Payto.SetupFutureUsage;
-          }
-
-          namespace Payto {
-            interface MandateOptions {
-              /**
-               * Amount that will be collected. It is required when `amount_type` is `fixed`.
-               */
-              amount?: number;
-
-              /**
-               * The type of amount that will be collected. The amount charged must be exact or up to the value of `amount` param for `fixed` or `maximum` type respectively.
-               */
-              amount_type?: MandateOptions.AmountType;
-
-              /**
-               * Date, in YYYY-MM-DD format, after which payments will not be collected. Defaults to no end date.
-               */
-              end_date?: string;
-
-              /**
-               * The periodicity at which payments will be collected.
-               */
-              payment_schedule?: MandateOptions.PaymentSchedule;
-
-              /**
-               * The number of payments that will be made during a payment period. Defaults to 1 except for when `payment_schedule` is `adhoc`. In that case, it defaults to no limit.
-               */
-              payments_per_period?: number;
-
-              /**
-               * The purpose for which payments are made. Defaults to retail.
-               */
-              purpose?: MandateOptions.Purpose;
-
-              /**
-               * Date, in YYYY-MM-DD format, from which payments will be collected. Defaults to confirmation time.
-               */
-              start_date?: string;
-            }
-
-            namespace MandateOptions {
-              type AmountType = 'fixed' | 'maximum';
-
-              type PaymentSchedule =
-                | 'adhoc'
-                | 'annual'
-                | 'daily'
-                | 'fortnightly'
-                | 'monthly'
-                | 'quarterly'
-                | 'semi_annual'
-                | 'weekly';
-
-              type Purpose =
-                | 'dependant_support'
-                | 'government'
-                | 'loan'
-                | 'mortgage'
-                | 'other'
-                | 'pension'
-                | 'personal'
-                | 'retail'
-                | 'salary'
-                | 'tax'
-                | 'utility';
-            }
-
-            type SetupFutureUsage = 'none' | 'off_session';
-          }
-
           interface Pix {
             /**
              * The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
@@ -1939,11 +1833,7 @@ declare module 'stripe' {
                 | 'payment_method'
                 | 'transactions';
 
-              type Prefetch =
-                | 'balances'
-                | 'inferred_balances'
-                | 'ownership'
-                | 'transactions';
+              type Prefetch = 'balances' | 'ownership' | 'transactions';
             }
 
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
@@ -2007,7 +1897,6 @@ declare module 'stripe' {
           | 'p24'
           | 'paynow'
           | 'paypal'
-          | 'payto'
           | 'pix'
           | 'promptpay'
           | 'revolut_pay'
@@ -2019,30 +1908,6 @@ declare module 'stripe' {
           | 'wechat_pay'
           | 'zip';
 
-        interface Permissions {
-          /**
-           * Permissions for updating the Checkout Session.
-           */
-          update?: Permissions.Update;
-        }
-
-        namespace Permissions {
-          interface Update {
-            /**
-             * Determines which entity is allowed to update the shipping details.
-             *
-             * Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
-             *
-             * When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
-             */
-            shipping_details?: Update.ShippingDetails;
-          }
-
-          namespace Update {
-            type ShippingDetails = 'client_only' | 'server_only';
-          }
-        }
-
         interface PhoneNumberCollection {
           /**
            * Set to `true` to enable phone number collection.
@@ -2615,7 +2480,7 @@ declare module 'stripe' {
           enabled: boolean;
         }
 
-        type UiMode = 'custom' | 'embedded' | 'hosted';
+        type UiMode = 'embedded' | 'hosted';
       }
 
       interface SessionRetrieveParams {
@@ -2626,11 +2491,6 @@ declare module 'stripe' {
       }
 
       interface SessionUpdateParams {
-        /**
-         * Information about the customer collected within the Checkout Session.
-         */
-        collected_information?: SessionUpdateParams.CollectedInformation;
-
         /**
          * Specifies which fields in the response should be expanded.
          */
@@ -2640,208 +2500,6 @@ declare module 'stripe' {
          * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
          */
         metadata?: Stripe.Emptyable<Stripe.MetadataParam>;
-
-        /**
-         * The shipping rate options to apply to this Session. Up to a maximum of 5.
-         */
-        shipping_options?: Stripe.Emptyable<
-          Array<SessionUpdateParams.ShippingOption>
-        >;
-      }
-
-      namespace SessionUpdateParams {
-        interface CollectedInformation {
-          /**
-           * The shipping details to apply to this Session.
-           */
-          shipping_details?: CollectedInformation.ShippingDetails;
-        }
-
-        namespace CollectedInformation {
-          interface ShippingDetails {
-            /**
-             * The address of the customer
-             */
-            address: ShippingDetails.Address;
-
-            /**
-             * The name of customer
-             */
-            name: string;
-          }
-
-          namespace ShippingDetails {
-            interface Address {
-              /**
-               * City, district, suburb, town, or village.
-               */
-              city?: string;
-
-              /**
-               * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
-               */
-              country: string;
-
-              /**
-               * Address line 1 (e.g., street, PO Box, or company name).
-               */
-              line1: string;
-
-              /**
-               * Address line 2 (e.g., apartment, suite, unit, or building).
-               */
-              line2?: string;
-
-              /**
-               * ZIP or postal code.
-               */
-              postal_code?: string;
-
-              /**
-               * State, county, province, or region.
-               */
-              state?: string;
-            }
-          }
-        }
-
-        interface ShippingOption {
-          /**
-           * The ID of the Shipping Rate to use for this shipping option.
-           */
-          shipping_rate?: string;
-
-          /**
-           * Parameters to be passed to Shipping Rate creation for this shipping option.
-           */
-          shipping_rate_data?: ShippingOption.ShippingRateData;
-        }
-
-        namespace ShippingOption {
-          interface ShippingRateData {
-            /**
-             * The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
-             */
-            delivery_estimate?: ShippingRateData.DeliveryEstimate;
-
-            /**
-             * The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
-             */
-            display_name: string;
-
-            /**
-             * Describes a fixed amount to charge for shipping. Must be present if type is `fixed_amount`.
-             */
-            fixed_amount?: ShippingRateData.FixedAmount;
-
-            /**
-             * 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
-             */
-            metadata?: Stripe.MetadataParam;
-
-            /**
-             * Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
-             */
-            tax_behavior?: ShippingRateData.TaxBehavior;
-
-            /**
-             * A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
-             */
-            tax_code?: string;
-
-            /**
-             * The type of calculation to use on the shipping rate.
-             */
-            type?: 'fixed_amount';
-          }
-
-          namespace ShippingRateData {
-            interface DeliveryEstimate {
-              /**
-               * The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
-               */
-              maximum?: DeliveryEstimate.Maximum;
-
-              /**
-               * The lower bound of the estimated range. If empty, represents no lower bound.
-               */
-              minimum?: DeliveryEstimate.Minimum;
-            }
-
-            namespace DeliveryEstimate {
-              interface Maximum {
-                /**
-                 * A unit of time.
-                 */
-                unit: Maximum.Unit;
-
-                /**
-                 * Must be greater than 0.
-                 */
-                value: number;
-              }
-
-              namespace Maximum {
-                type Unit = 'business_day' | 'day' | 'hour' | 'month' | 'week';
-              }
-
-              interface Minimum {
-                /**
-                 * A unit of time.
-                 */
-                unit: Minimum.Unit;
-
-                /**
-                 * Must be greater than 0.
-                 */
-                value: number;
-              }
-
-              namespace Minimum {
-                type Unit = 'business_day' | 'day' | 'hour' | 'month' | 'week';
-              }
-            }
-
-            interface FixedAmount {
-              /**
-               * A non-negative integer in cents representing how much to charge.
-               */
-              amount: 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;
-
-              /**
-               * Shipping rates defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
-               */
-              currency_options?: {
-                [key: string]: FixedAmount.CurrencyOptions;
-              };
-            }
-
-            namespace FixedAmount {
-              interface CurrencyOptions {
-                /**
-                 * A non-negative integer in cents representing how much to charge.
-                 */
-                amount: number;
-
-                /**
-                 * Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
-                 */
-                tax_behavior?: CurrencyOptions.TaxBehavior;
-              }
-
-              namespace CurrencyOptions {
-                type TaxBehavior = 'exclusive' | 'inclusive' | 'unspecified';
-              }
-            }
-
-            type TaxBehavior = 'exclusive' | 'inclusive' | 'unspecified';
-          }
-        }
       }
 
       interface SessionListParams extends PaginationParams {

package/types/ConfirmationTokens.d.ts

@@ -208,14 +208,10 @@ declare module 'stripe' {
 
         paypal?: PaymentMethodPreview.Paypal;
 
-        payto?: PaymentMethodPreview.Payto;
-
         pix?: PaymentMethodPreview.Pix;
 
         promptpay?: PaymentMethodPreview.Promptpay;
 
-        rechnung?: PaymentMethodPreview.Rechnung;
-
         revolut_pay?: PaymentMethodPreview.RevolutPay;
 
         sepa_debit?: PaymentMethodPreview.SepaDebit;
@@ -1263,11 +1259,6 @@ declare module 'stripe' {
         interface Paynow {}
 
         interface Paypal {
-          /**
-           * Uniquely identifies this particular PayPal account. You can use this attribute to check whether two PayPal accounts are the same.
-           */
-          fingerprint?: string | null;
-
           /**
            * Owner's email. Values are provided by PayPal directly
            * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
@@ -1278,58 +1269,12 @@ declare module 'stripe' {
            * PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
            */
           payer_id: string | null;
-
-          /**
-           * Owner's verified email. Values are verified or provided by PayPal directly
-           * (if supported) at the time of authorization or settlement. They cannot be set or mutated.
-           */
-          verified_email?: string | null;
-        }
-
-        interface Payto {
-          /**
-           * Bank-State-Branch number of the bank account.
-           */
-          bsb_number: string | null;
-
-          /**
-           * Last four digits of the bank account number.
-           */
-          last4: string | null;
-
-          /**
-           * The PayID alias for the bank account.
-           */
-          pay_id: string | null;
         }
 
         interface Pix {}
 
         interface Promptpay {}
 
-        interface Rechnung {
-          dob?: Rechnung.Dob;
-        }
-
-        namespace Rechnung {
-          interface Dob {
-            /**
-             * The day of birth, between 1 and 31.
-             */
-            day: number;
-
-            /**
-             * The month of birth, between 1 and 12.
-             */
-            month: number;
-
-            /**
-             * The four-digit year of birth.
-             */
-            year: number;
-          }
-        }
-
         interface RevolutPay {}
 
         interface SepaDebit {
@@ -1419,10 +1364,8 @@ declare module 'stripe' {
           | 'p24'
           | 'paynow'
           | 'paypal'
-          | 'payto'
           | 'pix'
           | 'promptpay'
-          | 'rechnung'
           | 'revolut_pay'
           | 'sepa_debit'
           | 'sofort'
@@ -1438,11 +1381,6 @@ declare module 'stripe' {
            */
           account_holder_type: UsBankAccount.AccountHolderType | null;
 
-          /**
-           * Account number of the bank account.
-           */
-          account_number?: string | null;
-
           /**
            * Account type: checkings or savings. Defaults to checking if omitted.
            */

package/types/Coupons.d.ts

@@ -113,7 +113,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
+      type Duration = 'forever' | 'once' | 'repeating';
     }
 
     /**

package/types/CouponsResource.d.ts

@@ -86,7 +86,7 @@ declare module 'stripe' {
         amount_off: number;
       }
 
-      type Duration = 'forever' | 'once' | 'repeating' | 'variable';
+      type Duration = 'forever' | 'once' | 'repeating';
     }
 
     interface CouponRetrieveParams {

package/types/CreditNotes.d.ts

@@ -106,10 +106,6 @@ declare module 'stripe' {
        */
       pdf: string;
 
-      post_payment_amount?: number;
-
-      pre_payment_amount?: number;
-
       /**
        * Reason for issuing this credit note, one of `duplicate`, `fraudulent`, `order_change`, or `product_unsatisfactory`
        */
@@ -120,11 +116,6 @@ declare module 'stripe' {
        */
       refund: string | Stripe.Refund | null;
 
-      /**
-       * Refunds related to this credit note.
-       */
-      refunds?: Array<CreditNote.Refund>;
-
       /**
        * The details of the cost of shipping, including the ShippingRate applied to the invoice.
        */
@@ -190,18 +181,6 @@ declare module 'stripe' {
         | 'order_change'
         | 'product_unsatisfactory';
 
-      interface Refund {
-        /**
-         * Amount of the refund that applies to this credit note, in cents (or local equivalent).
-         */
-        amount_refunded: number;
-
-        /**
-         * ID of the refund.
-         */
-        refund: string | Stripe.Refund;
-      }
-
       interface ShippingCost {
         /**
          * Total shipping cost before any taxes are applied.