stripe 18.3.0-beta.2 → 18.4.0-beta.1

package/types/AccountsResource.d.ts

@@ -303,6 +303,11 @@ declare module 'stripe' {
          */
         cashapp_payments?: Capabilities.CashappPayments;
 
+        /**
+         * The crypto_payments capability.
+         */
+        crypto_payments?: Capabilities.CryptoPayments;
+
         /**
          * The eps_payments capability.
          */
@@ -699,6 +704,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface CryptoPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface EpsPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -1163,6 +1175,9 @@ declare module 'stripe' {
          */
         phone?: string;
 
+        /**
+         * When the business was incorporated or registered.
+         */
         registration_date?: Stripe.Emptyable<Company.RegistrationDate>;
 
         /**
@@ -1427,6 +1442,11 @@ declare module 'stripe' {
          */
         company_tax_id_verification?: Documents.CompanyTaxIdVerification;
 
+        /**
+         * One or more documents that demonstrate proof of address.
+         */
+        proof_of_address?: Documents.ProofOfAddress;
+
         /**
          * One or more documents showing the company's proof of registration with the national business registry.
          */
@@ -1481,6 +1501,13 @@ declare module 'stripe' {
           files?: Array<string>;
         }
 
+        interface ProofOfAddress {
+          /**
+           * One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
+           */
+          files?: Array<string>;
+        }
+
         interface ProofOfRegistration {
           /**
            * One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
@@ -2012,10 +2039,20 @@ declare module 'stripe' {
              */
             monthly_anchor?: number;
 
+            /**
+             * The days of the month when available funds are paid out, specified as an array of numbers between 1--31. Payouts nominally scheduled between the 29th and 31st of the month are instead sent on the last day of a shorter month. Required and applicable only if `interval` is `monthly` and `monthly_anchor` is not set.
+             */
+            monthly_payout_days?: Array<number>;
+
             /**
              * The day of the week when available funds are paid out, specified as `monday`, `tuesday`, etc. (required and applicable only if `interval` is `weekly`.)
              */
             weekly_anchor?: Schedule.WeeklyAnchor;
+
+            /**
+             * The days of the week when available funds are paid out, specified as an array, e.g., [`monday`, `tuesday`]. (required and applicable only if `interval` is `weekly` and `weekly_anchor` is not set.)
+             */
+            weekly_payout_days?: Array<Schedule.WeeklyPayoutDay>;
           }
 
           namespace Schedule {
@@ -2029,6 +2066,15 @@ declare module 'stripe' {
               | 'thursday'
               | 'tuesday'
               | 'wednesday';
+
+            type WeeklyPayoutDay =
+              | 'friday'
+              | 'monday'
+              | 'saturday'
+              | 'sunday'
+              | 'thursday'
+              | 'tuesday'
+              | 'wednesday';
           }
         }
 
@@ -2427,6 +2473,11 @@ declare module 'stripe' {
          */
         cashapp_payments?: Capabilities.CashappPayments;
 
+        /**
+         * The crypto_payments capability.
+         */
+        crypto_payments?: Capabilities.CryptoPayments;
+
         /**
          * The eps_payments capability.
          */
@@ -2823,6 +2874,13 @@ declare module 'stripe' {
           requested?: boolean;
         }
 
+        interface CryptoPayments {
+          /**
+           * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+           */
+          requested?: boolean;
+        }
+
         interface EpsPayments {
           /**
            * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
@@ -3497,6 +3555,11 @@ declare module 'stripe' {
          */
         company_tax_id_verification?: Documents.CompanyTaxIdVerification;
 
+        /**
+         * One or more documents that demonstrate proof of address.
+         */
+        proof_of_address?: Documents.ProofOfAddress;
+
         /**
          * One or more documents showing the company's proof of registration with the national business registry.
          */
@@ -3551,6 +3614,13 @@ declare module 'stripe' {
           files?: Array<string>;
         }
 
+        interface ProofOfAddress {
+          /**
+           * One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
+           */
+          files?: Array<string>;
+        }
+
         interface ProofOfRegistration {
           /**
            * One or more document ids returned by a [file upload](https://stripe.com/docs/api#create_file) with a `purpose` value of `account_requirement`.
@@ -4050,10 +4120,20 @@ declare module 'stripe' {
              */
             monthly_anchor?: number;
 
+            /**
+             * The days of the month when available funds are paid out, specified as an array of numbers between 1--31. Payouts nominally scheduled between the 29th and 31st of the month are instead sent on the last day of a shorter month. Required and applicable only if `interval` is `monthly` and `monthly_anchor` is not set.
+             */
+            monthly_payout_days?: Array<number>;
+
             /**
              * The day of the week when available funds are paid out, specified as `monday`, `tuesday`, etc. (required and applicable only if `interval` is `weekly`.)
              */
             weekly_anchor?: Schedule.WeeklyAnchor;
+
+            /**
+             * The days of the week when available funds are paid out, specified as an array, e.g., [`monday`, `tuesday`]. (required and applicable only if `interval` is `weekly` and `weekly_anchor` is not set.)
+             */
+            weekly_payout_days?: Array<Schedule.WeeklyPayoutDay>;
           }
 
           namespace Schedule {
@@ -4067,6 +4147,15 @@ declare module 'stripe' {
               | 'thursday'
               | 'tuesday'
               | 'wednesday';
+
+            type WeeklyPayoutDay =
+              | 'friday'
+              | 'monday'
+              | 'saturday'
+              | 'sunday'
+              | 'thursday'
+              | 'tuesday'
+              | 'wednesday';
           }
         }
 

package/types/BillingPortal/Sessions.d.ts

@@ -186,7 +186,7 @@ declare module 'stripe' {
 
           interface SubscriptionUpdateConfirm {
             /**
-             * The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+             * The coupon or promotion code to apply to this subscription update.
              */
             discounts: Array<SubscriptionUpdateConfirm.Discount> | null;
 

package/types/BillingPortal/SessionsResource.d.ts

@@ -153,7 +153,7 @@ declare module 'stripe' {
 
           interface SubscriptionUpdateConfirm {
             /**
-             * The coupon or promotion code to apply to this subscription update. Currently, only up to one may be specified.
+             * The coupon or promotion code to apply to this subscription update.
              */
             discounts?: Array<SubscriptionUpdateConfirm.Discount>;
 

package/types/Charges.d.ts

@@ -424,6 +424,8 @@ declare module 'stripe' {
 
         cashapp?: PaymentMethodDetails.Cashapp;
 
+        crypto?: PaymentMethodDetails.Crypto;
+
         customer_balance?: PaymentMethodDetails.CustomerBalance;
 
         eps?: PaymentMethodDetails.Eps;
@@ -898,7 +900,7 @@ declare module 'stripe' {
           incremental_authorization?: Card.IncrementalAuthorization;
 
           /**
-           * Installment details for this payment (Mexico only).
+           * Installment details for this payment.
            *
            * For more information, see the [installments integration guide](https://stripe.com/docs/payments/installments).
            */
@@ -1033,9 +1035,13 @@ declare module 'stripe' {
               interval: 'month' | null;
 
               /**
-               * Type of installment plan, one of `fixed_count`.
+               * Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
                */
-              type: 'fixed_count';
+              type: Plan.Type;
+            }
+
+            namespace Plan {
+              type Type = 'bonus' | 'fixed_count' | 'revolving';
             }
           }
 
@@ -1365,7 +1371,7 @@ declare module 'stripe' {
           overcapture_supported: boolean;
 
           /**
-           * EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+           * The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
            */
           preferred_locales: Array<string> | null;
 
@@ -1409,12 +1415,12 @@ declare module 'stripe' {
             account_type?: Receipt.AccountType;
 
             /**
-             * EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+             * The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
              */
             application_cryptogram: string | null;
 
             /**
-             * Mnenomic of the Application Identifier.
+             * The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
              */
             application_preferred_name: string | null;
 
@@ -1434,17 +1440,17 @@ declare module 'stripe' {
             cardholder_verification_method: string | null;
 
             /**
-             * EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+             * Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
              */
             dedicated_file_name: string | null;
 
             /**
-             * The outcome of a series of EMV functions performed by the card reader.
+             * A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
              */
             terminal_verification_results: string | null;
 
             /**
-             * An indication of various EMV functions performed during the transaction.
+             * An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
              */
             transaction_status_information: string | null;
           }
@@ -1477,6 +1483,34 @@ declare module 'stripe' {
           cashtag: string | null;
         }
 
+        interface Crypto {
+          /**
+           * The wallet address of the customer.
+           */
+          buyer_address?: string;
+
+          /**
+           * The blockchain network that the transaction was sent on.
+           */
+          network?: Crypto.Network;
+
+          /**
+           * The token currency that the transaction was sent with.
+           */
+          token_currency?: Crypto.TokenCurrency;
+
+          /**
+           * The blockchain transaction hash of the crypto payment.
+           */
+          transaction_hash?: string;
+        }
+
+        namespace Crypto {
+          type Network = 'base' | 'ethereum' | 'polygon';
+
+          type TokenCurrency = 'usdc' | 'usdg' | 'usdp';
+        }
+
         interface CustomerBalance {}
 
         interface Eps {
@@ -1636,7 +1670,7 @@ declare module 'stripe' {
 
         interface Ideal {
           /**
-           * The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+           * The customer's bank. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
            */
           bank: Ideal.Bank | null;
 
@@ -1672,6 +1706,7 @@ declare module 'stripe' {
             | 'abn_amro'
             | 'asn_bank'
             | 'bunq'
+            | 'buut'
             | 'handelsbanken'
             | 'ing'
             | 'knab'
@@ -1691,6 +1726,7 @@ declare module 'stripe' {
             | 'ASNBNL21'
             | 'BITSNL2A'
             | 'BUNQNL2A'
+            | 'BUUTNL2A'
             | 'FVLBNL22'
             | 'HANDNL2A'
             | 'INGBNL2A'
@@ -1785,7 +1821,7 @@ declare module 'stripe' {
           network_transaction_id: string | null;
 
           /**
-           * EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+           * The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
            */
           preferred_locales: Array<string> | null;
 
@@ -1815,12 +1851,12 @@ declare module 'stripe' {
             account_type?: Receipt.AccountType;
 
             /**
-             * EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+             * The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
              */
             application_cryptogram: string | null;
 
             /**
-             * Mnenomic of the Application Identifier.
+             * The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
              */
             application_preferred_name: string | null;
 
@@ -1840,17 +1876,17 @@ declare module 'stripe' {
             cardholder_verification_method: string | null;
 
             /**
-             * EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+             * Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
              */
             dedicated_file_name: string | null;
 
             /**
-             * The outcome of a series of EMV functions performed by the card reader.
+             * A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
              */
             terminal_verification_results: string | null;
 
             /**
-             * An indication of various EMV functions performed during the transaction.
+             * An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
              */
             transaction_status_information: string | null;
           }

package/types/Checkout/SessionsResource.d.ts

@@ -129,7 +129,7 @@ declare module 'stripe' {
         invoice_creation?: SessionCreateParams.InvoiceCreation;
 
         /**
-         * A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
+         * A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices). The parameter is required for `payment` and `subscription` mode.
          *
          * For `payment` mode, there is a maximum of 100 line items, however it is recommended to consolidate line items if there are more than a few dozen.
          *
@@ -1778,6 +1778,56 @@ declare module 'stripe' {
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://docs.stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: 'none';
+
+            /**
+             * Subscription details if the Checkout Session sets up a future subscription.
+             */
+            subscriptions?: Stripe.Emptyable<Array<Klarna.Subscription>>;
+          }
+
+          namespace Klarna {
+            interface Subscription {
+              /**
+               * Unit of time between subscription charges.
+               */
+              interval: Subscription.Interval;
+
+              /**
+               * The number of intervals (specified in the `interval` attribute) between subscription charges. For example, `interval=month` and `interval_count=3` charges every 3 months.
+               */
+              interval_count?: number;
+
+              /**
+               * Name for subscription.
+               */
+              name?: string;
+
+              /**
+               * Describes the upcoming charge for this subscription.
+               */
+              next_billing: Subscription.NextBilling;
+
+              /**
+               * A non-customer-facing reference to correlate subscription charges in the Klarna app. Use a value that persists across subscription charges.
+               */
+              reference: string;
+            }
+
+            namespace Subscription {
+              type Interval = 'day' | 'month' | 'week' | 'year';
+
+              interface NextBilling {
+                /**
+                 * The amount of the next charge for the subscription.
+                 */
+                amount: number;
+
+                /**
+                 * The date of the next charge for the subscription in YYYY-MM-DD format.
+                 */
+                date: string;
+              }
+            }
           }
 
           interface Konbini {
@@ -2289,6 +2339,7 @@ declare module 'stripe' {
           | 'boleto'
           | 'card'
           | 'cashapp'
+          | 'crypto'
           | 'customer_balance'
           | 'eps'
           | 'fpx'
@@ -2886,15 +2937,12 @@ declare module 'stripe' {
           transfer_data?: SubscriptionData.TransferData;
 
           /**
-           * Unix timestamp representing the end of the trial period the customer
-           * will get before being charged for the first time. Has to be at least
-           * 48 hours in the future.
+           * Unix timestamp representing the end of the trial period the customer will get before being charged for the first time. Has to be at least 48 hours in the future.
            */
           trial_end?: number;
 
           /**
-           * Integer representing the number of trial period days before the
-           * customer is charged for the first time. Has to be at least 1.
+           * Integer representing the number of trial period days before the customer is charged for the first time. Has to be at least 1.
            */
           trial_period_days?: number;
 
@@ -2905,7 +2953,13 @@ declare module 'stripe' {
         }
 
         namespace SubscriptionData {
-          type BillingMode = 'classic' | 'flexible';
+          interface BillingMode {
+            type: BillingMode.Type;
+          }
+
+          namespace BillingMode {
+            type Type = 'classic' | 'flexible';
+          }
 
           interface InvoiceSettings {
             /**

package/types/ConfirmationTokens.d.ts

@@ -160,9 +160,13 @@ declare module 'stripe' {
               interval: 'month' | null;
 
               /**
-               * Type of installment plan, one of `fixed_count`.
+               * Type of installment plan, one of `fixed_count`, `bonus`, or `revolving`.
                */
-              type: 'fixed_count';
+              type: Plan.Type;
+            }
+
+            namespace Plan {
+              type Type = 'bonus' | 'fixed_count' | 'revolving';
             }
           }
         }
@@ -206,6 +210,8 @@ declare module 'stripe' {
 
         cashapp?: PaymentMethodPreview.Cashapp;
 
+        crypto?: PaymentMethodPreview.Crypto;
+
         /**
          * The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
          */
@@ -666,7 +672,7 @@ declare module 'stripe' {
                 overcapture_supported: boolean;
 
                 /**
-                 * EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+                 * The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
                  */
                 preferred_locales: Array<string> | null;
 
@@ -710,12 +716,12 @@ declare module 'stripe' {
                   account_type?: Receipt.AccountType;
 
                   /**
-                   * EMV tag 9F26, cryptogram generated by the integrated circuit chip.
+                   * The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
                    */
                   application_cryptogram: string | null;
 
                   /**
-                   * Mnenomic of the Application Identifier.
+                   * The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card's chip.
                    */
                   application_preferred_name: string | null;
 
@@ -735,17 +741,17 @@ declare module 'stripe' {
                   cardholder_verification_method: string | null;
 
                   /**
-                   * EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
+                   * Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
                    */
                   dedicated_file_name: string | null;
 
                   /**
-                   * The outcome of a series of EMV functions performed by the card reader.
+                   * A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
                    */
                   terminal_verification_results: string | null;
 
                   /**
-                   * An indication of various EMV functions performed during the transaction.
+                   * An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
                    */
                   transaction_status_information: string | null;
                 }
@@ -963,7 +969,7 @@ declare module 'stripe' {
           offline: CardPresent.Offline | null;
 
           /**
-           * EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+           * The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
            */
           preferred_locales: Array<string> | null;
 
@@ -1031,6 +1037,8 @@ declare module 'stripe' {
           cashtag: string | null;
         }
 
+        interface Crypto {}
+
         interface CustomerBalance {}
 
         interface Eps {
@@ -1134,7 +1142,7 @@ declare module 'stripe' {
 
         interface Ideal {
           /**
-           * The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
+           * The customer's bank, if provided. Can be one of `abn_amro`, `asn_bank`, `bunq`, `buut`, `handelsbanken`, `ing`, `knab`, `moneyou`, `n26`, `nn`, `rabobank`, `regiobank`, `revolut`, `sns_bank`, `triodos_bank`, `van_lanschot`, or `yoursafe`.
            */
           bank: Ideal.Bank | null;
 
@@ -1149,6 +1157,7 @@ declare module 'stripe' {
             | 'abn_amro'
             | 'asn_bank'
             | 'bunq'
+            | 'buut'
             | 'handelsbanken'
             | 'ing'
             | 'knab'
@@ -1168,6 +1177,7 @@ declare module 'stripe' {
             | 'ASNBNL21'
             | 'BITSNL2A'
             | 'BUNQNL2A'
+            | 'BUUTNL2A'
             | 'FVLBNL22'
             | 'HANDNL2A'
             | 'INGBNL2A'
@@ -1247,7 +1257,7 @@ declare module 'stripe' {
           networks: InteracPresent.Networks | null;
 
           /**
-           * EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.
+           * The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card's chip.
            */
           preferred_locales: Array<string> | null;
 
@@ -1630,6 +1640,7 @@ declare module 'stripe' {
           | 'card'
           | 'card_present'
           | 'cashapp'
+          | 'crypto'
           | 'customer_balance'
           | 'eps'
           | 'fpx'