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

package/types/V2/Payments/OffSessionPaymentsResource.d.ts

@@ -6,57 +6,65 @@ declare module 'stripe' {
       namespace Payments {
         interface OffSessionPaymentCreateParams {
           /**
-           * Amount you want to collect.
+           * The “presentment amount” to be collected from the customer.
            */
           amount: Amount;
 
           /**
-           * The frequency of the OSP.
+           * The frequency of the underlying payment.
            */
           cadence: OffSessionPaymentCreateParams.Cadence;
 
           /**
-           * Customer that owns the provided payment method.
+           * ID of the Customer to which this OffSessionPayment belongs.
            */
           customer: string;
 
           /**
-           * Any of your internal data you want to track here.
+           * Set of [key-value pairs](https://docs.corp.stripe.com/api/metadata) that you can
+           * attach to an object. This can be useful for storing additional information about
+           * the object in a structured format. Learn more about
+           * [storing information in metadata](https://docs.corp.stripe.com/payments/payment-intents#storing-information-in-metadata).
            */
           metadata: Stripe.MetadataParam;
 
           /**
-           * Payment method you want to debit. Must be attached to a customer and set up for off-session usage.
+           * ID of the payment method used in this OffSessionPayment.
            */
           payment_method: string;
 
           /**
-           * The OBO merchant you want to use.
+           * The account (if any) for which the funds of the OffSessionPayment are intended.
            */
           on_behalf_of?: string;
 
           /**
-           * How you want stripe to retry the OSP.
+           * Details about the OffSessionPayment retries.
            */
           retry_details?: OffSessionPaymentCreateParams.RetryDetails;
 
           /**
-           * String you want to appear on your customer's statement.
+           * 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).
            */
           statement_descriptor?: string;
 
           /**
-           * Suffix appended to your account level descriptor.
+           * 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;
 
           /**
-           * Test clock to be used for testing your retry handling. Only usable in a sandbox.
+           * Test clock that can be used to advance the retry attempts in a sandbox.
            */
           test_clock?: string;
 
           /**
-           * How you want to transfer the funds to your connected accounts.
+           * The data that automatically creates a Transfer after the payment finalizes. Learn more about the use case for [connected accounts](https://docs.corp.stripe.com/payments/connected-accounts).
            */
           transfer_data?: OffSessionPaymentCreateParams.TransferData;
         }
@@ -66,7 +74,7 @@ declare module 'stripe' {
 
           interface RetryDetails {
             /**
-             * How you want Stripe to retry the payment.
+             * Indicates the strategy for how you want Stripe to retry the payment.
              */
             retry_strategy: RetryDetails.RetryStrategy;
           }
@@ -77,12 +85,19 @@ declare module 'stripe' {
 
           interface TransferData {
             /**
-             * Amount in minor units that you want to transfer.
+             * The amount transferred to the destination account. This transfer will occur
+             * automatically after the payment succeeds. If no amount is specified, by default
+             * the entire payment amount is transferred to the destination account. The amount
+             * must be less than or equal to the
+             * [amount_requested](https://docs.corp.stripe.com/api/v2/off-session-payments/object?api-version=2025-05-28.preview#v2_off_session_payment_object-amount_requested),
+             * and must be a positive integer representing how much to transfer in the smallest
+             * currency unit (e.g., 100 cents to charge $1.00).
              */
             amount?: number;
 
             /**
-             * ID of the connected account where you want money to go.
+             * The account (if any) that the payment is attributed to for tax reporting, and
+             * where funds from the payment are transferred to after payment success.
              */
             destination: string;
           }
@@ -96,7 +111,7 @@ declare module 'stripe' {
       namespace Payments {
         interface OffSessionPaymentListParams {
           /**
-           * The page size limit, if not provided the default is 20.
+           * The page size limit. If not provided, the default is 20.
            */
           limit?: number;
         }
@@ -109,7 +124,7 @@ declare module 'stripe' {
       namespace Payments {
         class OffSessionPaymentsResource {
           /**
-           * Create OSP.
+           * Creates an OffSessionPayment object.
            */
           create(
             params: OffSessionPaymentCreateParams,
@@ -117,7 +132,7 @@ declare module 'stripe' {
           ): Promise<Stripe.Response<Stripe.V2.Payments.OffSessionPayment>>;
 
           /**
-           * Retrieve OSP by ID.
+           * Retrieves the details of an OffSessionPayment that has previously been created.
            */
           retrieve(
             id: string,
@@ -130,7 +145,7 @@ declare module 'stripe' {
           ): Promise<Stripe.Response<Stripe.V2.Payments.OffSessionPayment>>;
 
           /**
-           * List OSPs matching filter.
+           * Returns a list of OffSessionPayments matching a filter.
            */
           list(
             params?: OffSessionPaymentListParams,
@@ -141,7 +156,7 @@ declare module 'stripe' {
           ): ApiListPromise<Stripe.V2.Payments.OffSessionPayment>;
 
           /**
-           * Cancel OSP.
+           * Cancel an OffSessionPayment that has previously been created.
            */
           cancel(
             id: string,

package/types/V2/TestHelpers/FinancialAddressesResource.d.ts

@@ -34,6 +34,7 @@ declare module 'stripe' {
         class FinancialAddressesResource {
           /**
            * Simulate crediting a FinancialAddress in a Sandbox environment. This can be used to add virtual funds and increase your balance for testing.
+           * @throws Stripe.FeatureNotEnabledError
            */
           credit(
             id: string,
@@ -45,6 +46,7 @@ declare module 'stripe' {
 
           /**
            * Generates microdeposits for a FinancialAddress in a Sandbox environment.
+           * @throws Stripe.FeatureNotEnabledError
            */
           generateMicrodeposits(
             id: string,

package/types/WebhookEndpointsResource.d.ts

@@ -153,7 +153,8 @@ declare module 'stripe' {
         | '2025-03-31.basil'
         | '2025-04-30.basil'
         | '2025-05-28.basil'
-        | '2025-06-30.basil';
+        | '2025-06-30.basil'
+        | '2025-07-30.basil';
 
       type EnabledEvent =
         | '*'

package/types/index.d.ts

@@ -26,6 +26,7 @@
 ///<reference path='./Billing/CreditGrantsResource.d.ts' />
 ///<reference path='./Billing/MeterEventAdjustmentsResource.d.ts' />
 ///<reference path='./Billing/MeterEventsResource.d.ts' />
+///<reference path='./Billing/MeterUsageResource.d.ts' />
 ///<reference path='./Billing/MetersResource.d.ts' />
 ///<reference path='./BillingPortal/ConfigurationsResource.d.ts' />
 ///<reference path='./BillingPortal/SessionsResource.d.ts' />
@@ -118,6 +119,7 @@
 ///<reference path='./Terminal/ConfigurationsResource.d.ts' />
 ///<reference path='./Terminal/ConnectionTokensResource.d.ts' />
 ///<reference path='./Terminal/LocationsResource.d.ts' />
+///<reference path='./Terminal/OnboardingLinksResource.d.ts' />
 ///<reference path='./Terminal/ReaderCollectedDataResource.d.ts' />
 ///<reference path='./Terminal/ReadersResource.d.ts' />
 ///<reference path='./TestHelpers/ConfirmationTokensResource.d.ts' />
@@ -196,6 +198,8 @@
 ///<reference path='./Billing/MeterEventAdjustments.d.ts' />
 ///<reference path='./Billing/MeterEventSummaries.d.ts' />
 ///<reference path='./Billing/MeterEvents.d.ts' />
+///<reference path='./Billing/MeterUsage.d.ts' />
+///<reference path='./Billing/MeterUsageRows.d.ts' />
 ///<reference path='./Billing/Meters.d.ts' />
 ///<reference path='./BillingPortal/Configurations.d.ts' />
 ///<reference path='./BillingPortal/Sessions.d.ts' />
@@ -321,6 +325,7 @@
 ///<reference path='./Terminal/Configurations.d.ts' />
 ///<reference path='./Terminal/ConnectionTokens.d.ts' />
 ///<reference path='./Terminal/Locations.d.ts' />
+///<reference path='./Terminal/OnboardingLinks.d.ts' />
 ///<reference path='./Terminal/ReaderCollectedData.d.ts' />
 ///<reference path='./Terminal/Readers.d.ts' />
 ///<reference path='./TestHelpers/TestClocks.d.ts' />
@@ -457,6 +462,7 @@ declare module 'stripe' {
       meters: Stripe.Billing.MetersResource;
       meterEvents: Stripe.Billing.MeterEventsResource;
       meterEventAdjustments: Stripe.Billing.MeterEventAdjustmentsResource;
+      meterUsage: Stripe.Billing.MeterUsageResource;
     };
     billingPortal: {
       configurations: Stripe.BillingPortal.ConfigurationsResource;
@@ -532,6 +538,7 @@ declare module 'stripe' {
       configurations: Stripe.Terminal.ConfigurationsResource;
       connectionTokens: Stripe.Terminal.ConnectionTokensResource;
       locations: Stripe.Terminal.LocationsResource;
+      onboardingLinks: Stripe.Terminal.OnboardingLinksResource;
       readers: Stripe.Terminal.ReadersResource;
       readerCollectedData: Stripe.Terminal.ReaderCollectedDataResource;
     };

package/types/lib.d.ts

@@ -27,7 +27,8 @@ 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-06-30.preview';
+    export type LatestApiVersion = '2025-07-30.preview';
+    export const API_VERSION: string;
     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-06-30.preview',
+  apiVersion: '2025-07-30.preview',
 });
 
 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-06-30.preview',
+  apiVersion: '2025-07-30.preview',
   typescript: true,
   maxNetworkRetries: 1,
   timeout: 1000,
@@ -44,7 +44,7 @@ stripe = new Stripe('sk_test_123', {
     description: 'test',
   };
   const opts: Stripe.RequestOptions = {
-    apiVersion: '2025-06-30.preview',
+    apiVersion: '2025-07-30.preview',
   };
   const customer: Stripe.Customer = await stripe.customers.create(params, opts);