stripe 17.7.0 → 18.0.0

package/types/Terminal/Configurations.d.ts

@@ -48,12 +48,14 @@ declare module 'stripe' {
         tipping?: Configuration.Tipping;
 
         verifone_p400?: Configuration.VerifoneP400;
+
+        wifi?: Configuration.Wifi;
       }
 
       namespace Configuration {
         interface BbposWiseposE {
           /**
-           * A File ID representing an image you would like displayed on the reader.
+           * A File ID representing an image to display on the reader
            */
           splashscreen?: string | Stripe.File;
         }
@@ -79,7 +81,7 @@ declare module 'stripe' {
 
         interface StripeS700 {
           /**
-           * A File ID representing an image you would like displayed on the reader.
+           * A File ID representing an image to display on the reader
            */
           splashscreen?: string | Stripe.File;
         }
@@ -394,10 +396,91 @@ declare module 'stripe' {
 
         interface VerifoneP400 {
           /**
-           * A File ID representing an image you would like displayed on the reader.
+           * A File ID representing an image to display on the reader
            */
           splashscreen?: string | Stripe.File;
         }
+
+        interface Wifi {
+          enterprise_eap_peap?: Wifi.EnterpriseEapPeap;
+
+          enterprise_eap_tls?: Wifi.EnterpriseEapTls;
+
+          personal_psk?: Wifi.PersonalPsk;
+
+          /**
+           * Security type of the WiFi network. The hash with the corresponding name contains the credentials for this security type.
+           */
+          type: Wifi.Type;
+        }
+
+        namespace Wifi {
+          interface EnterpriseEapPeap {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+
+            /**
+             * Username for connecting to the WiFi network
+             */
+            username: string;
+          }
+
+          interface EnterpriseEapTls {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * A File ID representing a PEM file containing the client certificate
+             */
+            client_certificate_file: string;
+
+            /**
+             * A File ID representing a PEM file containing the client RSA private key
+             */
+            private_key_file: string;
+
+            /**
+             * Password for the private key file
+             */
+            private_key_file_password?: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          interface PersonalPsk {
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          type Type =
+            | 'enterprise_eap_peap'
+            | 'enterprise_eap_tls'
+            | 'personal_psk';
+        }
       }
 
       /**

package/types/Terminal/ConfigurationsResource.d.ts

@@ -43,12 +43,17 @@ declare module 'stripe' {
          * An object containing device type specific settings for Verifone P400 readers
          */
         verifone_p400?: ConfigurationCreateParams.VerifoneP400;
+
+        /**
+         * Configurations for connecting to a WiFi network.
+         */
+        wifi?: Stripe.Emptyable<ConfigurationCreateParams.Wifi>;
       }
 
       namespace ConfigurationCreateParams {
         interface BbposWiseposE {
           /**
-           * A File ID representing an image you would like displayed on the reader.
+           * A File ID representing an image to display on the reader
            */
           splashscreen?: Stripe.Emptyable<string>;
         }
@@ -441,6 +446,96 @@ declare module 'stripe' {
            */
           splashscreen?: Stripe.Emptyable<string>;
         }
+
+        interface Wifi {
+          /**
+           * Credentials for a WPA-Enterprise WiFi network using the EAP-PEAP authentication method.
+           */
+          enterprise_eap_peap?: Wifi.EnterpriseEapPeap;
+
+          /**
+           * Credentials for a WPA-Enterprise WiFi network using the EAP-TLS authentication method.
+           */
+          enterprise_eap_tls?: Wifi.EnterpriseEapTls;
+
+          /**
+           * Credentials for a WPA-Personal WiFi network.
+           */
+          personal_psk?: Wifi.PersonalPsk;
+
+          /**
+           * Security type of the WiFi network. Fill out the hash with the corresponding name to provide the set of credentials for this security type.
+           */
+          type: Wifi.Type;
+        }
+
+        namespace Wifi {
+          interface EnterpriseEapPeap {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+
+            /**
+             * Username for connecting to the WiFi network
+             */
+            username: string;
+          }
+
+          interface EnterpriseEapTls {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * A File ID representing a PEM file containing the client certificate
+             */
+            client_certificate_file: string;
+
+            /**
+             * A File ID representing a PEM file containing the client RSA private key
+             */
+            private_key_file: string;
+
+            /**
+             * Password for the private key file
+             */
+            private_key_file_password?: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          interface PersonalPsk {
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          type Type =
+            | 'enterprise_eap_peap'
+            | 'enterprise_eap_tls'
+            | 'personal_psk';
+        }
       }
 
       interface ConfigurationRetrieveParams {
@@ -496,12 +591,17 @@ declare module 'stripe' {
         verifone_p400?: Stripe.Emptyable<
           ConfigurationUpdateParams.VerifoneP400
         >;
+
+        /**
+         * Configurations for connecting to a WiFi network.
+         */
+        wifi?: Stripe.Emptyable<ConfigurationUpdateParams.Wifi>;
       }
 
       namespace ConfigurationUpdateParams {
         interface BbposWiseposE {
           /**
-           * A File ID representing an image you would like displayed on the reader.
+           * A File ID representing an image to display on the reader
            */
           splashscreen?: Stripe.Emptyable<string>;
         }
@@ -894,6 +994,96 @@ declare module 'stripe' {
            */
           splashscreen?: Stripe.Emptyable<string>;
         }
+
+        interface Wifi {
+          /**
+           * Credentials for a WPA-Enterprise WiFi network using the EAP-PEAP authentication method.
+           */
+          enterprise_eap_peap?: Wifi.EnterpriseEapPeap;
+
+          /**
+           * Credentials for a WPA-Enterprise WiFi network using the EAP-TLS authentication method.
+           */
+          enterprise_eap_tls?: Wifi.EnterpriseEapTls;
+
+          /**
+           * Credentials for a WPA-Personal WiFi network.
+           */
+          personal_psk?: Wifi.PersonalPsk;
+
+          /**
+           * Security type of the WiFi network. Fill out the hash with the corresponding name to provide the set of credentials for this security type.
+           */
+          type: Wifi.Type;
+        }
+
+        namespace Wifi {
+          interface EnterpriseEapPeap {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+
+            /**
+             * Username for connecting to the WiFi network
+             */
+            username: string;
+          }
+
+          interface EnterpriseEapTls {
+            /**
+             * A File ID representing a PEM file containing the server certificate
+             */
+            ca_certificate_file?: string;
+
+            /**
+             * A File ID representing a PEM file containing the client certificate
+             */
+            client_certificate_file: string;
+
+            /**
+             * A File ID representing a PEM file containing the client RSA private key
+             */
+            private_key_file: string;
+
+            /**
+             * Password for the private key file
+             */
+            private_key_file_password?: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          interface PersonalPsk {
+            /**
+             * Password for connecting to the WiFi network
+             */
+            password: string;
+
+            /**
+             * Name of the WiFi network
+             */
+            ssid: string;
+          }
+
+          type Type =
+            | 'enterprise_eap_peap'
+            | 'enterprise_eap_tls'
+            | 'personal_psk';
+        }
       }
 
       interface ConfigurationListParams extends PaginationParams {

package/types/TestHelpers/ConfirmationTokensResource.d.ts

@@ -89,6 +89,11 @@ declare module 'stripe' {
            */
           bancontact?: PaymentMethodData.Bancontact;
 
+          /**
+           * If this is a `billie` PaymentMethod, this hash contains details about the billie payment method.
+           */
+          billie?: PaymentMethodData.Billie;
+
           /**
            * Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
            */
@@ -189,6 +194,11 @@ declare module 'stripe' {
            */
           naver_pay?: PaymentMethodData.NaverPay;
 
+          /**
+           * If this is an nz_bank_account PaymentMethod, this hash contains details about the nz_bank_account payment method.
+           */
+          nz_bank_account?: PaymentMethodData.NzBankAccount;
+
           /**
            * If this is an `oxxo` PaymentMethod, this hash contains details about the OXXO payment method.
            */
@@ -244,6 +254,11 @@ declare module 'stripe' {
            */
           samsung_pay?: PaymentMethodData.SamsungPay;
 
+          /**
+           * If this is a `satispay` PaymentMethod, this hash contains details about the satispay payment method.
+           */
+          satispay?: PaymentMethodData.Satispay;
+
           /**
            * If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
            */
@@ -341,6 +356,8 @@ declare module 'stripe' {
 
           interface Bancontact {}
 
+          interface Billie {}
+
           interface BillingDetails {
             /**
              * Billing address.
@@ -537,6 +554,35 @@ declare module 'stripe' {
             type Funding = 'card' | 'points';
           }
 
+          interface NzBankAccount {
+            /**
+             * The name on the bank account. Only required if the account holder name is different from the name of the authorized signatory collected in the PaymentMethod's billing details.
+             */
+            account_holder_name?: string;
+
+            /**
+             * The account number for the bank account.
+             */
+            account_number: string;
+
+            /**
+             * The numeric code for the bank account's bank.
+             */
+            bank_code: string;
+
+            /**
+             * The numeric code for the bank account's bank branch.
+             */
+            branch_code: string;
+
+            reference?: string;
+
+            /**
+             * The suffix of the bank account number.
+             */
+            suffix: string;
+          }
+
           interface Oxxo {}
 
           interface P24 {
@@ -599,6 +645,8 @@ declare module 'stripe' {
 
           interface SamsungPay {}
 
+          interface Satispay {}
+
           interface SepaDebit {
             /**
              * IBAN of the bank account.
@@ -631,6 +679,7 @@ declare module 'stripe' {
             | 'au_becs_debit'
             | 'bacs_debit'
             | 'bancontact'
+            | 'billie'
             | 'blik'
             | 'boleto'
             | 'cashapp'
@@ -648,6 +697,7 @@ declare module 'stripe' {
             | 'mobilepay'
             | 'multibanco'
             | 'naver_pay'
+            | 'nz_bank_account'
             | 'oxxo'
             | 'p24'
             | 'pay_by_bank'
@@ -658,6 +708,7 @@ declare module 'stripe' {
             | 'promptpay'
             | 'revolut_pay'
             | 'samsung_pay'
+            | 'satispay'
             | 'sepa_debit'
             | 'sofort'
             | 'swish'

package/types/TokensResource.d.ts

@@ -145,6 +145,9 @@ declare module 'stripe' {
            */
           ownership_declaration_shown_and_signed?: boolean;
 
+          /**
+           * This value is used to determine if a business is exempt from providing ultimate beneficial owners. See [this support article](https://support.stripe.com/questions/exemption-from-providing-ownership-details) and [changelog](https://docs.stripe.com/changelog/acacia/2025-01-27/ownership-exemption-reason-accounts-api) for more details.
+           */
           ownership_exemption_reason?: Stripe.Emptyable<
             Company.OwnershipExemptionReason
           >;
@@ -719,7 +722,7 @@ declare module 'stripe' {
         /**
          * Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
          */
-        political_exposure?: string;
+        political_exposure?: Person.PoliticalExposure;
 
         /**
          * The person's registered address.
@@ -826,6 +829,8 @@ declare module 'stripe' {
           }
         }
 
+        type PoliticalExposure = 'existing' | 'none';
+
         interface Relationship {
           /**
            * Whether the person is the authorizer of the account's representative.

package/types/Treasury/FinancialAccountsResource.d.ts

@@ -640,7 +640,7 @@ declare module 'stripe' {
 
       class FinancialAccountsResource {
         /**
-         * Creates a new FinancialAccount. For now, each connected account can only have one FinancialAccount.
+         * Creates a new FinancialAccount. Each connected account can have up to three FinancialAccounts by default.
          */
         create(
           params: FinancialAccountCreateParams,

package/types/V2/Core/EventDestinationsResource.d.ts

@@ -156,11 +156,6 @@ declare module 'stripe' {
            * The page size.
            */
           limit?: number;
-
-          /**
-           * The requested page.
-           */
-          page?: string;
         }
       }
 

package/types/V2/Core/EventsResource.d.ts

@@ -20,11 +20,6 @@ declare module 'stripe' {
            * The page size.
            */
           limit?: number;
-
-          /**
-           * The requested page.
-           */
-          page?: string;
         }
       }
 

package/types/V2/EventDestinations.d.ts

@@ -4,7 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace V2 {
       /**
-       * The EventDestination object.
+       * Set up an event destination to receive events from Stripe across multiple destination types, including [webhook endpoints](https://docs.stripe.com/webhooks) and [Amazon EventBridge](https://docs.stripe.com/event-destinations/eventbridge). Event destinations support receiving [thin events](https://docs.stripe.com/api/v2/events) and [snapshot events](https://docs.stripe.com/api/events).
        */
       interface EventDestination {
         /**

package/types/V2/Events.d.ts

@@ -32,7 +32,7 @@ declare module 'stripe' {
       }
 
       /**
-       * The Event object.
+       * Events are generated to keep you informed of activity in your business account. APIs in the /v2 namespace generate [thin events](https://docs.stripe.com/event-destinations#benefits-of-thin-events) which have small, unversioned payloads that include a reference to the ID of the object that has changed. The Events v2 API returns these new thin events. [Retrieve the event object](https://docs.stripe.com/event-destinations#fetch-data) for additional data about the event. Use the related object ID in the event payload to [fetch the API resource](https://docs.stripe.com/event-destinations#retrieve-the-object-associated-with-thin-events) of the object associated with the event. Comparatively, events generated by most API v1 include a versioned snapshot of an API object in their payload.
        */
       interface EventBase {
         /**

package/types/WebhookEndpointsResource.d.ts

@@ -148,7 +148,9 @@ declare module 'stripe' {
         | '2024-11-20.acacia'
         | '2024-12-18.acacia'
         | '2025-01-27.acacia'
-        | '2025-02-24.acacia';
+        | '2025-02-24.acacia'
+        | '2025-03-01.dashboard'
+        | '2025-03-31.basil';
 
       type EnabledEvent =
         | '*'
@@ -241,6 +243,7 @@ declare module 'stripe' {
         | 'invoice.finalized'
         | 'invoice.marked_uncollectible'
         | 'invoice.overdue'
+        | 'invoice.overpaid'
         | 'invoice.paid'
         | 'invoice.payment_action_required'
         | 'invoice.payment_failed'
@@ -390,7 +393,14 @@ declare module 'stripe' {
         | 'treasury.received_credit.created'
         | 'treasury.received_credit.failed'
         | 'treasury.received_credit.succeeded'
-        | 'treasury.received_debit.created';
+        | 'treasury.received_debit.created'
+        | 'billing.credit_balance_transaction.created'
+        | 'billing.credit_grant.created'
+        | 'billing.credit_grant.updated'
+        | 'billing.meter.created'
+        | 'billing.meter.deactivated'
+        | 'billing.meter.reactivated'
+        | 'billing.meter.updated';
     }
 
     interface WebhookEndpointRetrieveParams {
@@ -524,6 +534,7 @@ declare module 'stripe' {
         | 'invoice.finalized'
         | 'invoice.marked_uncollectible'
         | 'invoice.overdue'
+        | 'invoice.overpaid'
         | 'invoice.paid'
         | 'invoice.payment_action_required'
         | 'invoice.payment_failed'
@@ -673,7 +684,14 @@ declare module 'stripe' {
         | 'treasury.received_credit.created'
         | 'treasury.received_credit.failed'
         | 'treasury.received_credit.succeeded'
-        | 'treasury.received_debit.created';
+        | 'treasury.received_debit.created'
+        | 'billing.credit_balance_transaction.created'
+        | 'billing.credit_grant.created'
+        | 'billing.credit_grant.updated'
+        | 'billing.meter.created'
+        | 'billing.meter.deactivated'
+        | 'billing.meter.reactivated'
+        | 'billing.meter.updated';
     }
 
     interface WebhookEndpointListParams extends PaginationParams {

package/types/index.d.ts

@@ -7,7 +7,6 @@
 ///<reference path='./Webhooks.d.ts' />
 ///<reference path='./EventTypes.d.ts' />
 ///<reference path='./UpcomingInvoices.d.ts' />
-///<reference path='./Deprecations.d.ts' />
 ///<reference path='./ThinEvent.d.ts' />
 ///<reference path='./crypto/crypto.d.ts' />
 // Imports: The beginning of the section generated from our OpenAPI spec
@@ -54,6 +53,7 @@
 ///<reference path='./Identity/VerificationReportsResource.d.ts' />
 ///<reference path='./Identity/VerificationSessionsResource.d.ts' />
 ///<reference path='./InvoiceItemsResource.d.ts' />
+///<reference path='./InvoicePaymentsResource.d.ts' />
 ///<reference path='./InvoiceRenderingTemplatesResource.d.ts' />
 ///<reference path='./InvoicesResource.d.ts' />
 ///<reference path='./Issuing/AuthorizationsResource.d.ts' />
@@ -200,6 +200,7 @@
 ///<reference path='./Identity/VerificationSessions.d.ts' />
 ///<reference path='./InvoiceItems.d.ts' />
 ///<reference path='./InvoiceLineItems.d.ts' />
+///<reference path='./InvoicePayments.d.ts' />
 ///<reference path='./InvoiceRenderingTemplates.d.ts' />
 ///<reference path='./Invoices.d.ts' />
 ///<reference path='./Issuing/Authorizations.d.ts' />
@@ -274,8 +275,6 @@
 ///<reference path='./Treasury/ReceivedDebits.d.ts' />
 ///<reference path='./Treasury/TransactionEntries.d.ts' />
 ///<reference path='./Treasury/Transactions.d.ts' />
-///<reference path='./UsageRecordSummaries.d.ts' />
-///<reference path='./UsageRecords.d.ts' />
 ///<reference path='./V2/Billing/MeterEventAdjustments.d.ts' />
 ///<reference path='./V2/Billing/MeterEventSessions.d.ts' />
 ///<reference path='./V2/Billing/MeterEvents.d.ts' />
@@ -323,6 +322,7 @@ declare module 'stripe' {
     fileLinks: Stripe.FileLinksResource;
     files: Stripe.FilesResource;
     invoiceItems: Stripe.InvoiceItemsResource;
+    invoicePayments: Stripe.InvoicePaymentsResource;
     invoiceRenderingTemplates: Stripe.InvoiceRenderingTemplatesResource;
     invoices: Stripe.InvoicesResource;
     mandates: Stripe.MandatesResource;

package/types/lib.d.ts

@@ -27,7 +27,7 @@ declare module 'stripe' {
       }): (...args: any[]) => Response<ResponseObject>; //eslint-disable-line @typescript-eslint/no-explicit-any
       static MAX_BUFFERED_REQUEST_METRICS: number;
     }
-    export type LatestApiVersion = '2025-02-24.acacia';
+    export type LatestApiVersion = '2025-03-31.basil';
     export type HttpAgent = Agent;
     export type HttpProtocol = 'http' | 'https';
 

package/types/test/typescriptTest.ts

@@ -9,7 +9,7 @@
 import Stripe from 'stripe';
 
 let stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-02-24.acacia',
+  apiVersion: '2025-03-31.basil',
 });
 
 stripe = new Stripe('sk_test_123');
@@ -26,7 +26,7 @@ stripe = new Stripe('sk_test_123', {
 
 // Check config object.
 stripe = new Stripe('sk_test_123', {
-  apiVersion: '2025-02-24.acacia',
+  apiVersion: '2025-03-31.basil',
   typescript: true,
   maxNetworkRetries: 1,
   timeout: 1000,
@@ -44,7 +44,7 @@ stripe = new Stripe('sk_test_123', {
     description: 'test',
   };
   const opts: Stripe.RequestOptions = {
-    apiVersion: '2025-02-24.acacia',
+    apiVersion: '2025-03-31.basil',
   };
   const customer: Stripe.Customer = await stripe.customers.create(params, opts);
 
@@ -303,6 +303,3 @@ stripe.files.create({
   },
   file_link_data: {create: true},
 });
-
-// Test deprecated parameters still work
-const param: Stripe.UsageRecordSummaryListParams = {expand: []};