• #2088 Update generated code for private-preview
  • Add support for new resource v2.billing.PricingPlanSubscriptionComponents
  • Add support for retrieve method on resource v2.billing.PricingPlanSubscriptionComponents
  • Add support for dimensionPayloadKeys on billing.MeterCreateParams and billing.Meter
  • Add support for dimensionFilters and dimensionGroupByKeys on billing.MeterEventSummaryListParams
  • Add support for dimensions on billing.MeterEventSummary
  • Add support for fulfillmentDetails and paymentMethodData on delegatedcheckout.RequestedSessionCreateParams and delegatedcheckout.RequestedSessionUpdateParams
  • Add support for lineItemDetails, metadata, paymentMethod, and sharedMetadata on delegatedcheckout.RequestedSessionCreateParams, delegatedcheckout.RequestedSessionUpdateParams, and delegatedcheckout.RequestedSession
  • Add support for currency, customer, and riskDetails on delegatedcheckout.RequestedSessionCreateParams
  • Add support for sellerDetails and setupFutureUsage on delegatedcheckout.RequestedSessionCreateParams and delegatedcheckout.RequestedSession
  • Add support for amountSubtotal, amountTotal, createdAt, expiresAt, orderDetails, sharedPaymentIssuedToken, status, totalDetails, and updatedAt on delegatedcheckout.RequestedSession
  • Add support for address, email, fulfillmentOptions, name, phone, and selectedFulfillmentOption on delegatedcheckout.RequestedSession.fulfillment_details
  • Add support for new values billie, crypto, kr_card, kriya, mb_way, mondu, ng_bank_transfer, ng_bank, ng_card, ng_market, ng_ussd, ng_wallet, payco, paypay, rechnung, samsung_pay, satispay, scalapay, sequra, sunbit, us_bank_account, and vipps on enums EventsV2CoreHealthAuthorizationRateDropFiringEvent.impact.paymentMethodType, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.impact.paymentMethodType, EventsV2CoreHealthPaymentMethodErrorFiringEvent.impact.paymentMethodType, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.impact.paymentMethodType

See the changelog for more details.

• #2087 Update generated code for private-preview
  • Add support for new resources delegatedcheckout.RequestedSession and identity.BlocklistEntry
  • Add support for confirm, create, expire, retrieve, and update methods on resource delegatedcheckout.RequestedSession
  • Add support for create, disable, list, and retrieve methods on resource identity.BlocklistEntry
  • Add support for blockedByEntry on identity.VerificationReport.document, identity.VerificationReport.selfie, and identity.VerificationReportListParams

See the changelog for more details.

• #2085 Update generated code for private-preview
  • Add support for new resource PaymentMethodBalance
  • Add support for check_balance method on resource PaymentMethod
  • Add support for benefits on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.card
  • Add support for benefit on PaymentIntent.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for setupDetails on SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Add support for cardCreator on v2.core.Account.configuration, v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.configuration, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountUpdateParams.configuration, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for new value configuration.card_creator on enums v2.core.AccountCreateParams.include, v2.core.AccountRetrieveParams.include, and v2.core.AccountUpdateParams.include
  • Add support for new value card_creator on enum v2.core.AccountCloseParams.appliedConfigurations
  • Add support for thin events V2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationCardCreatorUpdatedEvent with related object v2.core.Account
  • Remove support for thin events V1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, and V1CustomerDiscountUpdatedEvent with related object Discount

See the changelog for more details.

This release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 30.0.0 which contains breaking changes. Please review the changelog for 30.0.0 if upgrading from older SDK versions.

• #2060 Update generated code for beta
  • Add support for attach_cadence method on resource Subscription
  • Add support for billingCadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Add support for billingCadenceDetails on Invoice.parent and QuotePreviewInvoice.parent
• #2049 Update generated code for beta
  • Add support for new resources v2.billing.BillSettingVersion, v2.billing.BillSetting, v2.billing.Cadence, v2.billing.CollectionSettingVersion, v2.billing.CollectionSetting, and v2.billing.Profile
  • Add support for create, list, retrieve, and update methods on resources v2.billing.BillSetting, v2.billing.CollectionSetting, and v2.billing.Profile
  • Add support for list and retrieve methods on resources v2.billing.BillSettingVersion and v2.billing.CollectionSettingVersion
  • Add support for cancel, create, list, retrieve, and update methods on resource v2.billing.Cadence
  • Add support for profile on v2.core.Account.defaults, v2.core.AccountCreateParams.defaults, and v2.core.AccountUpdateParams.defaults
  • Add support for iP on v2.core.Account.identity.attestations.directorship_declaration, v2.core.Account.identity.attestations.ownership_declaration, v2.core.Account.identity.attestations.terms_of_service.account, v2.core.Account.identity.attestations.terms_of_service.storer, v2.core.Account.identity.individual.additional_terms_of_service.account, v2.core.AccountCreateParams.identity.attestations.terms_of_service.account, v2.core.AccountCreateParams.identity.attestations.terms_of_service.storer, v2.core.AccountUpdateParams.identity.attestations.terms_of_service.account, v2.core.AccountUpdateParams.identity.attestations.terms_of_service.storer, v2.core.Person.additional_terms_of_service.account, v2.core.PersonCreateParams.additional_terms_of_service.account, and v2.core.PersonUpdateParams.additional_terms_of_service.account
  • Remove support for ip on v2.core.Account.identity.attestations.directorship_declaration, v2.core.Account.identity.attestations.ownership_declaration, v2.core.Account.identity.attestations.terms_of_service.account, v2.core.Account.identity.attestations.terms_of_service.storer, v2.core.Account.identity.individual.additional_terms_of_service.account, v2.core.AccountCreateParams.identity.attestations.terms_of_service.account, v2.core.AccountCreateParams.identity.attestations.terms_of_service.storer, v2.core.AccountUpdateParams.identity.attestations.terms_of_service.account, v2.core.AccountUpdateParams.identity.attestations.terms_of_service.storer, v2.core.Person.additional_terms_of_service.account, v2.core.PersonCreateParams.additional_terms_of_service.account, and v2.core.PersonUpdateParams.additional_terms_of_service.account
  • Remove support for doingBusinessAs, productDescription, and url on v2.core.Account.identity.business_details, v2.core.AccountCreateParams.identity.business_details, and v2.core.AccountUpdateParams.identity.business_details
  • Add support for settlementCurrency on v2.moneymanagement.FinancialAddress
  • Add support for sepaBankAccount on v2.moneymanagement.FinancialAddress.credentials and v2.moneymanagement.ReceivedCredit.bank_transfer
  • Add support for amountDetails and paymentsOrchestration on v2.payments.OffSessionPaymentCreateParams and v2.payments.OffSessionPayment
  • Add support for retryPolicy on v2.payments.OffSessionPayment.retry_details and v2.payments.OffSessionPaymentCreateParams.retry_details
  • Change type of v2.moneymanagement.OutboundPaymentQuote.fx_quote.lockDuration from literal('five_minutes') to enum('five_minutes'|'none')
  • Add support for originType on v2.moneymanagement.ReceivedCredit.bank_transfer
  • Remove support for paymentMethodType on v2.moneymanagement.ReceivedCredit.bank_transfer
  • Add support for mandateData and paymentMethodOptions on v2.payments.OffSessionPaymentCreateParams
  • Add support for new values heuristic and scheduled on enum v2.payments.OffSessionPaymentCreateParams.retry_details.retryStrategy
  • Add support for new value crypto_wallet on enums v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data.type and v2.moneymanagement.OutboundSetupIntentUpdateParams.payout_method_data.type
  • Add support for type on v2.moneymanagement.FinancialAddressCreateParams
  • Remove support for currency on v2.moneymanagement.FinancialAddressCreateParams
  • Add support for new values financial_addressses.crypto_wallets, holds_currencies.usdc, outbound_payments.crypto_wallets, and outbound_transfers.crypto_wallets on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updatedCapability
  • Add support for thin event V2BillingBillSettingUpdatedEvent with related object v2.billing.BillSetting
  • Add support for error type RateLimitException
• #2047 Update generated code for beta
  • Add support for new resources billing.analytics.MeterUsageRow and billing.analytics.MeterUsage
  • Remove support for resources billing.MeterUsageRow and billing.MeterUsage
  • Add support for retrieve method on resource billing.analytics.MeterUsage
  • Remove support for retrieve method on resource billing.MeterUsage
  • Add support for report_payment_attempt_informational method on resource PaymentRecord
  • Add support for minimumBalanceByCurrency on BalanceSettings.payments.payouts and BalanceSettingsUpdateParams.payments.payouts
  • Remove support for values saturday and sunday from enum BalanceSettingsUpdateParams.payments.payouts.schedule.weeklyPayoutDays
  • Change type of BalanceSettingsUpdateParams.payments.settlement_timing.delayDaysOverride from longInteger to emptyable(longInteger)
  • Change BalanceSettingsUpdateParams.payments to be optional
  • Add support for delayDaysOverride on BalanceSettings.payments.settlement_timing
  • Add support for automaticTax and invoiceCreation on checkout.SessionUpdateParams
  • Add support for unitLabel on checkout.SessionUpdateParams.line_items[].price_data.product_data
  • Add support for invoiceSettings on checkout.SessionUpdateParams.subscription_data
  • Add support for intendedSubmissionMethod on DisputeUpdateParams and Dispute
  • Change type of Dispute.smart_disputes.recommendedEvidence from string to array(string)
  • Add support for pix on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for new value pix on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for billingSchedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Add support for paypay on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_details
  • Add support for wallet on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • Add support for flexible on QuotePreviewSubscriptionSchedule.billing_mode
  • Add support for billedUntil on SubscriptionItem

See the changelog for more details.

This release changes the pinned API version to 2025-09-30.preview. It is built on top of SDK version 30.0.0 and 30.1.0-beta.1 which contain breaking changes. Please review the changelog for these versions if upgrading from older SDK versions.

• #2052 Update generated code for private-preview
  • Add support for new resource v2.moneymanagement.RecipientVerification
  • Add support for acknowledge, create, recipient_verifications, and retrieve methods on resource v2.moneymanagement.RecipientVerification
  • Add support for update method on resources v2.billing.PricingPlanSubscription and v2.billing.ServiceAction
  • Add support for cryptoWallets on v2.Account.configuration.recipient_data.features, v2.AccountCreateParams.configuration.recipient_data.features, v2.AccountUpdateParams.configuration.recipient_data.features, v2.core.Account.configuration.recipient.capabilities, v2.core.AccountCreateParams.configuration.recipient.capabilities, and v2.core.AccountUpdateParams.configuration.recipient.capabilities
  • Add support for lookupKey on v2.billing.CadenceCreateParams, v2.billing.CadenceUpdateParams, and v2.billing.Cadence
  • Add support for settingsData on v2.billing.Cadence
  • Add support for v1EventId on v2.core.Event
  • Add support for recipientVerification on v2.moneymanagement.OutboundPaymentCreateParams, v2.moneymanagement.OutboundPayment, v2.moneymanagement.OutboundTransferCreateParams, and v2.moneymanagement.OutboundTransfer
  • Add support for cryptoWallet on v2.moneymanagement.OutboundSetupIntentCreateParams.payout_method_data and v2.moneymanagement.PayoutMethod
  • Add support for willActivateAt and willCancelAt on v2.billing.PricingPlanSubscription.servicing_status_transitions and v2.billing.RateCardSubscription.servicing_status_transitions
  • Add support for customPricingUnitDetails on v2.billing.RateCardRate.custom_pricing_unit_amount, v2.billing.ServiceAction.credit_grant.amount.custom_pricing_unit, and v2.billing.ServiceAction.credit_grant_per_tenant.amount.custom_pricing_unit
  • Add support for originType on v2.moneymanagement.ReceivedDebit.bank_transfer
  • Add support for new value sepa_credit_transfer on enum v2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for new value credentials.sepa_bank_account.iban on enums v2.moneymanagement.FinancialAddressListParams.include and v2.moneymanagement.FinancialAddressRetrieveParams.include
  • Add support for sepaBankAccount on v2.moneymanagement.FinancialAddressCreateParams
  • Remove support for price on v2.billing.RateCardRateCreateParams
  • Add support for lookupKeys on v2.billing.CadenceListParams
  • Change type of v2.billing.CadenceCancelParams.include, v2.billing.CadenceCreateParams.include, v2.billing.CadenceListParams.include, v2.billing.CadenceRetrieveParams.include, and v2.billing.CadenceUpdateParams.include from literal('invoice_discount_rules') to enum('invoice_discount_rules'|'settings_data')
  • Remove support for customer and type on v2.billing.CadenceCreateParams.payer
  • Change v2.billing.CadenceCreateParams.payer.billingProfile to be required
  • Add support for new value crypto_wallets on enum EventsAccountConfigurationRecipientDataFeatureStatusUpdatedEvent.featureName
  • Add support for new value crypto_wallets_v2 on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updatedCapability
  • Remove support for alertId on EventsV2CoreHealthApiErrorResolvedEvent, EventsV2CoreHealthApiLatencyResolvedEvent, EventsV2CoreHealthAuthorizationRateDropResolvedEvent, EventsV2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, EventsV2CoreHealthPaymentMethodErrorResolvedEvent, EventsV2CoreHealthTrafficVolumeDropResolvedEvent, and EventsV2CoreHealthWebhookLatencyResolvedEvent
  • Add support for thin event V1AccountUpdatedEvent with related object v2.Account
  • Add support for thin events V1ApplicationFeeCreatedEvent, V1ApplicationFeeRefundedEvent, V1BillingPortalConfigurationCreatedEvent, V1BillingPortalConfigurationUpdatedEvent, V1CapabilityUpdatedEvent, V1ChargeCapturedEvent, V1ChargeDisputeClosedEvent, V1ChargeDisputeCreatedEvent, V1ChargeDisputeFundsReinstatedEvent, V1ChargeDisputeFundsWithdrawnEvent, V1ChargeDisputeUpdatedEvent, V1ChargeExpiredEvent, V1ChargeFailedEvent, V1ChargePendingEvent, V1ChargeRefundUpdatedEvent, V1ChargeRefundedEvent, V1ChargeSucceededEvent, V1ChargeUpdatedEvent, V1CheckoutSessionAsyncPaymentFailedEvent, V1CheckoutSessionAsyncPaymentSucceededEvent, V1CheckoutSessionCompletedEvent, V1CheckoutSessionExpiredEvent, V1ClimateOrderCanceledEvent, V1ClimateOrderCreatedEvent, V1ClimateOrderDelayedEvent, V1ClimateOrderDeliveredEvent, V1ClimateOrderProductSubstitutedEvent, V1ClimateProductCreatedEvent, V1ClimateProductPricingUpdatedEvent, V1CouponCreatedEvent, V1CouponDeletedEvent, V1CouponUpdatedEvent, V1CreditNoteCreatedEvent, V1CreditNoteUpdatedEvent, V1CreditNoteVoidedEvent, V1CustomerCreatedEvent, V1CustomerDeletedEvent, V1CustomerDiscountCreatedEvent, V1CustomerDiscountDeletedEvent, V1CustomerDiscountUpdatedEvent, V1CustomerSubscriptionCreatedEvent, V1CustomerSubscriptionDeletedEvent, V1CustomerSubscriptionPausedEvent, V1CustomerSubscriptionPendingUpdateAppliedEvent, V1CustomerSubscriptionPendingUpdateExpiredEvent, V1CustomerSubscriptionResumedEvent, V1CustomerSubscriptionTrialWillEndEvent, V1CustomerSubscriptionUpdatedEvent, V1CustomerTaxIdCreatedEvent, V1CustomerTaxIdDeletedEvent, V1CustomerTaxIdUpdatedEvent, V1CustomerUpdatedEvent, V1FileCreatedEvent, V1FinancialConnectionsAccountCreatedEvent, V1FinancialConnectionsAccountDeactivatedEvent, V1FinancialConnectionsAccountDisconnectedEvent, V1FinancialConnectionsAccountReactivatedEvent, V1FinancialConnectionsAccountRefreshedBalanceEvent, V1FinancialConnectionsAccountRefreshedOwnershipEvent, V1FinancialConnectionsAccountRefreshedTransactionsEvent, V1IdentityVerificationSessionCanceledEvent, V1IdentityVerificationSessionCreatedEvent, V1IdentityVerificationSessionProcessingEvent, V1IdentityVerificationSessionRedactedEvent, V1IdentityVerificationSessionRequiresInputEvent, V1IdentityVerificationSessionVerifiedEvent, V1InvoiceCreatedEvent, V1InvoiceDeletedEvent, V1InvoiceFinalizationFailedEvent, V1InvoiceFinalizedEvent, V1InvoiceMarkedUncollectibleEvent, V1InvoiceOverdueEvent, V1InvoiceOverpaidEvent, V1InvoicePaidEvent, V1InvoicePaymentActionRequiredEvent, V1InvoicePaymentFailedEvent, V1InvoicePaymentPaidEvent, V1InvoicePaymentSucceededEvent, V1InvoiceSentEvent, V1InvoiceUpcomingEvent, V1InvoiceUpdatedEvent, V1InvoiceVoidedEvent, V1InvoiceWillBeDueEvent, V1InvoiceitemCreatedEvent, V1InvoiceitemDeletedEvent, V1IssuingAuthorizationCreatedEvent, V1IssuingAuthorizationRequestEvent, V1IssuingAuthorizationUpdatedEvent, V1IssuingCardCreatedEvent, V1IssuingCardUpdatedEvent, V1IssuingCardholderCreatedEvent, V1IssuingCardholderUpdatedEvent, V1IssuingDisputeClosedEvent, V1IssuingDisputeCreatedEvent, V1IssuingDisputeFundsReinstatedEvent, V1IssuingDisputeFundsRescindedEvent, V1IssuingDisputeSubmittedEvent, V1IssuingDisputeUpdatedEvent, V1IssuingPersonalizationDesignActivatedEvent, V1IssuingPersonalizationDesignDeactivatedEvent, V1IssuingPersonalizationDesignRejectedEvent, V1IssuingPersonalizationDesignUpdatedEvent, V1IssuingTokenCreatedEvent, V1IssuingTokenUpdatedEvent, V1IssuingTransactionCreatedEvent, V1IssuingTransactionPurchaseDetailsReceiptUpdatedEvent, V1IssuingTransactionUpdatedEvent, V1MandateUpdatedEvent, V1PaymentIntentAmountCapturableUpdatedEvent, V1PaymentIntentCanceledEvent, V1PaymentIntentCreatedEvent, V1PaymentIntentPartiallyFundedEvent, V1PaymentIntentPaymentFailedEvent, V1PaymentIntentProcessingEvent, V1PaymentIntentRequiresActionEvent, V1PaymentIntentSucceededEvent, V1PaymentLinkCreatedEvent, V1PaymentLinkUpdatedEvent, V1PaymentMethodAttachedEvent, V1PaymentMethodAutomaticallyUpdatedEvent, V1PaymentMethodDetachedEvent, V1PaymentMethodUpdatedEvent, V1PayoutCanceledEvent, V1PayoutCreatedEvent, V1PayoutFailedEvent, V1PayoutPaidEvent, V1PayoutReconciliationCompletedEvent, V1PayoutUpdatedEvent, V1PersonCreatedEvent, V1PersonDeletedEvent, V1PersonUpdatedEvent, V1PlanCreatedEvent, V1PlanDeletedEvent, V1PlanUpdatedEvent, V1PriceCreatedEvent, V1PriceDeletedEvent, V1PriceUpdatedEvent, V1ProductCreatedEvent, V1ProductDeletedEvent, V1ProductUpdatedEvent, V1PromotionCodeCreatedEvent, V1PromotionCodeUpdatedEvent, V1QuoteAcceptedEvent, V1QuoteCanceledEvent, V1QuoteCreatedEvent, V1QuoteFinalizedEvent, V1RadarEarlyFraudWarningCreatedEvent, V1RadarEarlyFraudWarningUpdatedEvent, V1RefundCreatedEvent, V1RefundFailedEvent, V1RefundUpdatedEvent, V1ReviewClosedEvent, V1ReviewOpenedEvent, V1SetupIntentCanceledEvent, V1SetupIntentCreatedEvent, V1SetupIntentRequiresActionEvent, V1SetupIntentSetupFailedEvent, V1SetupIntentSucceededEvent, V1SigmaScheduledQueryRunCreatedEvent, V1SourceCanceledEvent, V1SourceChargeableEvent, V1SourceFailedEvent, V1SourceRefundAttributesRequiredEvent, V1SubscriptionScheduleAbortedEvent, V1SubscriptionScheduleCanceledEvent, V1SubscriptionScheduleCompletedEvent, V1SubscriptionScheduleCreatedEvent, V1SubscriptionScheduleExpiringEvent, V1SubscriptionScheduleReleasedEvent, V1SubscriptionScheduleUpdatedEvent, V1TaxRateCreatedEvent, V1TaxRateUpdatedEvent, V1TerminalReaderActionFailedEvent, V1TerminalReaderActionSucceededEvent, V1TerminalReaderActionUpdatedEvent, V1TestHelpersTestClockAdvancingEvent, V1TestHelpersTestClockCreatedEvent, `V1TestHelpersTe...

This release changes the pinned API version to 2025-09-30.clover and contains breaking changes (prefixed with ⚠️ below)

• #2036 ⚠️ Add strongly typed EventNotifications
  We've overhauled how V2 Events are handled in the SDK! This approach should provide a lot more information at authoring and compile time, leading to more robust integrations. As part of this process, there are a number of changes to be aware of.

  • Added matching EventNotification classes to every v2 Event. For example, there's now a V1BillingMeterErrorReportTriggeredEventNotification to match the existing V1BillingMeterErrorReportTriggeredEvent. Each notification class defines a fetchEvent() method to retrieve its corresponding event. For events with related objects, there's a fetchRelatedObject() method that performs the API call and casts the response to the correct type.
  • ⚠️ Rename function StripeClient.parseThinEvent to StripeClient.parseEventNotification and remove the Stripe.ThinEvent class.
    • This function now returns a Stripe.V2.Core.EventNotification (which is the shared base class that all of the more specific Stripe.Events.*EventNotification classes share) instead of Stripe.ThinEvent. When applicable, these event notifications will have the relatedObject property and a fetchRelatedObject() function. They also have a fetchEvent() method to retrieve their corresponding Stripe.Event.*Event instance.
    • If you parse an event the SDK doesn't have types for (e.g. it's newer than the SDK you're using), you'll get an instance of Stripe.Events.UnknownEventNotification instead of a more specific type. It has both the relatedObject property and the fetchRelatedObject() function (but they may be/return null)

• #2069 Move V2.Event API resources to V2.Core.Events

  • ⚠️ Move the below event related classes from com.stripe.model.v2 to com.stripe.model.v2.core. This enables us to correctly match the API path to the namespace
    • com.stripe.model.v2.Event -> com.stripe.model.v2.core.Event
    • com.stripe.model.v2.EventDestination -> com.stripe.model.v2.core.EventDestination

• #2057 Add StripeContext object

  • Add the StripeContext class. Previously, you could set the stripe context only as a string via StripeClientBuilder .setStripeContext(). The same method can now take an instance of the StripeContext class as well
  • ⚠️ Change EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext

• #2041 Throw ApiKeyMissingException instead of IllegalArgumentException for unset API keys

  • ⚠️ throw ApiKeyMissingException instead of IllegalArgumentException when making a request before setting an API key initializing a client without an API key. Tweak the wording of that message to better indicate how to fix.

• #2039 ⚠️ Build SDK w/ V2 OpenAPI spec

  • ⚠️ The delete methods for v2 APIs (the ones in the StripeClient.v2 namespace) now return a V2DeletedObject which has the id of the object that has been deleted and a string representing the type of the object that has been deleted.
  • ⚠️ Query params on v2 APIs (like limit) are now Long instead of Integer (to match v1 APIs)
  • ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as Map<String, Object>. Because there were no params, it's unlikely you were using these classes.

• ⚠️ Deprecated the V1 service accessors living directly under StripeClient(e.g. customers, products) as they were copied under the new V1 service in our last release. Service accessors living directly under StripeClient(e.g. customers, products) will be removed from StripeClient in a future release. E.g.

  StripeClient client = new StripeClient("sk_test...")
  
  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
  - client.customers().list()
  + client.v1().customers().list()

  Refer to the migration guide for help upgrading.

• #2046 Adds v2 support to RateLimitException

  • ⚠️ The base class of RateLimitException has been changed from InvalidRequestException to ApiException. There is no change to the public interface for the RateLimitException class.

• #2037 Fix type bounds on request

  • ⚠️ Changes the signature of LiveResponseGetter#request, ApiService#request, and StripeResponseGetter#request to return <T extends StripeObject> instead of <T extends StripeObjectInterface>. This only affects advanced use cases where users are extending StripeObjectInterface with their own objects to deserialize Stripe responses. Those objects will now need to extend StripeObject.

• #2040, #2058, #2059, #2073 Update generated code based on incoming API changes in the 2025-09-30.clover API version.

  • ⚠️ Remove support for balanceReport and payoutReconciliationReport on AccountSession.components and AccountSessionCreateParams.components
  • ⚠️ Change type of InvoiceCreatePreviewParams.subscription_details.cancelAt, SubscriptionCreateParams.cancelAt and SubscriptionUpdateParams.cancelAt from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • ⚠️ Remove support for values saturday and sunday from enums AccountCreateParams.settings.payouts.schedule.weeklyPayoutDays and AccountUpdateParams.settings.payouts.schedule.weeklyPayoutDays
  • ⚠️ Remove support for iterations on InvoiceCreatePreviewParams.schedule_details.phases[], SubscriptionScheduleCreateParams.phases[], and SubscriptionScheduleUpdateParams.phases[]
  • ⚠️ Remove support for link and payByBank on PaymentMethodUpdateParams
  • ⚠️ Remove support for coupon on Discount, PromotionCodeCreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCodeCreateParams.promotion.coupon, and PromotionCode.promotion.coupon instead
  • Add support for new resource BalanceSettings
  • Add support for retrieve and update methods on resource BalanceSettings
  • Add support for source on Discount
  • Add support for mbWayPayments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for trialUpdateBehavior on billingportal.Configuration.features.subscription_update, billingportal.ConfigurationCreateParams.features.subscription_update, and billingportal.ConfigurationUpdateParams.features.subscription_update
  • Add support for mbWay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for brandingSettings and nameCollection on checkout.SessionCreateParams and checkout.Session
  • Add support for excludedPaymentMethodTypes on PaymentIntentConfirmParams, PaymentIntentUpdateParams, checkout.SessionCreateParams, and checkout.Session
  • Add support for unitLabel on InvoiceAddLinesParams.lines[].price_data.product_data, InvoiceLineItemUpdateParams.price_data.product_data, InvoiceUpdateLinesParams.lines[].price_data.product_data, PaymentLinkCreateParams.line_items[].price_data.product_data, and checkout.SessionCreateParams.line_items[].price_data.product_data
  • Add support for alma, billie, and satispay on checkout.Session.payment_method_options and checkout.SessionCreateParams.payment_method_options
  • Add support for demoPay on checkout.SessionCreateParams.payment_method_options
  • Add support for captureMethod on checkout.Session.payment_method_options.affirm, checkout.Session.payment_method_options.afterpay_clearpay, checkout.Session.payment_method_options.amazon_pay, checkout.Session.payment_method_options.card, checkout.Session.payment_method_options.cashapp, checkout.Session.payment_method_options.klarna, checkout.Session.payment_method_options.link, checkout.Session.payment_method_options.mobilepay, checkout.Session.payment_method_options.revolut_pay, checkout.SessionCreateParams.payment_method_options.affirm, checkout.SessionCreateParams.payment_method_options.afterpay_clearpay, checkout.SessionCreateParams.payment_method_options.amazon_pay, checkout.SessionCreateParams.payment_method_options.card, checkout.SessionCreateParams.payment_method_options.cashapp, checkout.SessionCreateParams.payment_method_options.klarna, checkout.SessionCreateParams.payment_method_options.link, checkout.SessionCreateParams.payment_method_options.mobilepay, and checkout.SessionCreateParams.payment_method_options.revolut_pay
  • Add support for flexible on InvoiceCreatePreviewParams.schedule_details.billing_mode, InvoiceCreatePreviewParams.subscription_details.billing_mode, `Quote...

• #2042 generate private-preview SDK w/ mid Sept changes
  • Add support for retrieve method on resource V2.Core.ClaimableSandbox
  • Add support for month_of_year on V2.Billing.Cadence#create.billing_cycle.month and V2.Billing.Cadence.billing_cycle.month
  • Add support for claimed_at, expires_at, sandbox_details, and status on V2.Core.ClaimableSandbox
  • Remove support for api_keys on V2.Core.ClaimableSandbox
  • Change type of V2.Core.ClaimableSandbox.claim_url from string to nullable(string)
  • Add support for new value current_billing_period_end on enums V2.Billing.Intent#create.actions[].deactivate.effective_at.type and V2.Billing.IntentAction.deactivate.effective_at.type
  • Add support for will_activate_at and will_cancel_at on V2.Billing.PricingPlanSubscription.servicing_status_transitions and V2.Billing.RateCardSubscription.servicing_status_transitions
  • Add support for category and priority on V2.Billing.ServiceAction#create.credit_grant_per_tenant, V2.Billing.ServiceAction#create.credit_grant, V2.Billing.ServiceAction.credit_grant_per_tenant, and V2.Billing.ServiceAction.credit_grant
  • Change V2.Billing.LicenseFee#update.display_name to be optional
  • Add support for invoices on EventsV2BillingCadenceBilledEvent
  • Add support for thin events V2CoreClaimableSandboxClaimedEvent, V2CoreClaimableSandboxExpiredEvent, V2CoreClaimableSandboxExpiringEvent, and V2CoreClaimableSandboxSandboxDetailsOwnerAccountUpdatedEvent with related object V2.Core.ClaimableSandbox
  • Remove support for thin event V2BillingCadenceErroredEvent with related object V2.Billing.Cadence

See the changelog for more details.

• #2033 Update generated code for private-preview
  • Add support for attach_cadence method on resource Subscription
  • Add support for currency and externalCustomerId on billing.AlertTriggered
  • Add support for customPricingUnit on billing.AlertTriggered, billing.CreditBalanceSummary.balances[].available_balance, billing.CreditBalanceSummary.balances[].ledger_balance, billing.CreditBalanceTransaction.credit.amount, billing.CreditBalanceTransaction.debit.amount, billing.CreditGrant.amount, and billing.CreditGrantCreateParams.amount
  • Add support for customer on billing.AlertListParams
  • Change type of billing.Alert.alertType, billing.AlertCreateParams.alertType, and billing.AlertListParams.alertType from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')
  • Add support for creditBalanceThreshold on billing.AlertCreateParams and billing.Alert
  • Add support for billableItems on billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, billing.CreditGrant.applicability_config.scope, and billing.CreditGrantCreateParams.applicability_config.scope
  • Change type of billing.CreditBalanceSummary.balances[].available_balance.type, billing.CreditBalanceSummary.balances[].ledger_balance.type, billing.CreditBalanceTransaction.credit.amount.type, billing.CreditBalanceTransaction.debit.amount.type, billing.CreditGrant.amount.type, and billing.CreditGrantCreateParams.amount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')
  • Add support for licenseFeeSubscriptionDetails and rateCardSubscriptionDetails on InvoiceItem.parent and InvoiceLineItem.parent
  • Change type of InvoiceItem.parent.type from literal('subscription_details') to enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')
  • Add support for licenseFeeDetails and rateCardRateDetails on InvoiceItem.pricing and InvoiceLineItem.pricing
  • Change type of InvoiceItem.pricing.type and InvoiceLineItem.pricing.type from literal('price_details') to enum('license_fee_details'|'price_details'|'rate_card_rate_details')
  • Add support for billingCadence on InvoiceCreatePreviewParams, SubscriptionCreateParams, and Subscription
  • Add support for billingCadenceDetails on Invoice.parent and QuotePreviewInvoice.parent
  • Add support for new resources v2.billing.BillSettingVersion, v2.billing.BillSetting, v2.billing.Cadence, v2.billing.CollectionSettingVersion, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.IntentAction, v2.billing.Intent, v2.billing.LicenseFeeSubscription, v2.billing.LicenseFeeVersion, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlanComponent, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, v2.billing.PricingPlan, v2.billing.Profile, v2.billing.RateCardRate, v2.billing.RateCardSubscription, v2.billing.RateCardVersion, v2.billing.RateCard, v2.billing.ServiceAction, v2.core.ClaimableSandbox, v2.reporting.ReportRun, v2.reporting.Report, and v2.tax.AutomaticRule
  • Add support for create, deactivate, find, retrieve, and update methods on resource v2.tax.AutomaticRule
  • Add support for create and retrieve methods on resources v2.billing.ServiceAction and v2.reporting.ReportRun
  • Add support for retrieve method on resources v2.billing.LicenseFeeSubscription and v2.reporting.Report
  • Add support for create method on resources v2.core.ClaimableSandbox
  • Add support for cancel, create, list, retrieve, and update methods on resources v2.billing.Cadence and v2.billing.RateCardSubscription
  • Add support for create, list, retrieve, and update methods on resources v2.billing.BillSetting, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlan, v2.billing.Profile, and v2.billing.RateCard
  • Add support for list and retrieve methods on resources v2.billing.BillSettingVersion, v2.billing.CollectionSettingVersion, v2.billing.IntentAction, v2.billing.LicenseFeeVersion, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, and v2.billing.RateCardVersion
  • Add support for create, delete, list, and retrieve methods on resource v2.billing.RateCardRate
  • Add support for create, delete, list, retrieve, and update methods on resource v2.billing.PricingPlanComponent
  • Add support for cancel, commit, create, list, release_reservation, reserve, and retrieve methods on resource v2.billing.Intent
  • Add support for changes on v2.Event
  • Add support for thin events V2BillingCadenceBilledEvent, V2BillingCadenceCanceledEvent, V2BillingCadenceCreatedEvent, and V2BillingCadenceErroredEvent with related object v2.billing.Cadence
  • Add support for thin events V2BillingLicenseFeeCreatedEvent and V2BillingLicenseFeeUpdatedEvent with related object v2.billing.LicenseFee
  • Add support for thin event V2BillingLicenseFeeVersionCreatedEvent with related object v2.billing.LicenseFeeVersion
  • Add support for thin events V2BillingLicensedItemCreatedEvent and V2BillingLicensedItemUpdatedEvent with related object v2.billing.LicensedItem
  • Add support for thin events V2BillingMeteredItemCreatedEvent and V2BillingMeteredItemUpdatedEvent with related object v2.billing.MeteredItem
  • Add support for thin events V2BillingPricingPlanCreatedEvent and V2BillingPricingPlanUpdatedEvent with related object v2.billing.PricingPlan
  • Add support for thin events V2BillingPricingPlanComponentCreatedEvent and V2BillingPricingPlanComponentUpdatedEvent with related object v2.billing.PricingPlanComponent
  • Add support for thin events V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingPricingPlanSubscriptionCollectionCurrentEvent, V2BillingPricingPlanSubscriptionCollectionPastDueEvent, V2BillingPricingPlanSubscriptionCollectionPausedEvent, V2BillingPricingPlanSubscriptionCollectionUnpaidEvent, V2BillingPricingPlanSubscriptionServicingActivatedEvent, V2BillingPricingPlanSubscriptionServicingCanceledEvent, and V2BillingPricingPlanSubscriptionServicingPausedEvent with related object v2.billing.PricingPlanSubscription
  • Add support for thin event V2BillingPricingPlanVersionCreatedEvent with related object v2.billing.PricingPlanVersion
  • Add support for thin events V2BillingRateCardCreatedEvent and V2BillingRateCardUpdatedEvent with related object v2.billing.RateCard
  • Add support for thin event V2BillingRateCardRateCreatedEvent with related object v2.billing.RateCardRate
  • Add support for thin events V2BillingRateCardSubscriptionActivatedEvent, V2BillingRateCardSubscriptionCanceledEvent, V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingRateCardSubscriptionCollectionCurrentEvent, V2BillingRateCardSubscriptionCollectionPastDueEvent, V2BillingRateCardSubscriptionCollectionPausedEvent, V2BillingRateCardSubscriptionCollectionUnpaidEvent, V2BillingRateCardSubscriptionServicingActivatedEvent, V2BillingRateCardSubscriptionServicingCanceledEvent, and V2BillingRateCardSubscriptionServicingPausedEvent with related object v2.billing.RateCardSubscription
  • Add support for thin event V2BillingRateCardVersionCreatedEvent with related object v2.billing.RateCardVersion
  • Add support for thin events V2CoreHealthApiErrorFiringEvent, V2CoreHealthApiErrorResolvedEvent, V2CoreHealthApiLatencyFiringEvent, V2CoreHealthApiLatencyResolvedEvent, V2CoreHealthAuthorizationRateDropFiringEvent, V2CoreHealthAuthorizationRateDropResolvedEvent, V2CoreHealthEventGenerationFailureResolvedEvent, V2CoreHealthFraudRateIncreasedEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, V2CoreHealthPaymentMethodErrorFiringEvent, V2CoreHealthPaymentMethodErrorResolvedEvent, V2CoreHealthTrafficVolumeDropFiringEvent, V2CoreHealthTrafficVolumeDropResolvedEvent, V2CoreHealthWebhookLatencyFiringEvent, and V2CoreHealthWebhookLatencyResolvedEvent
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRun
  • Add support for error type RateLimitException
  • ⚠️ The base class of RateLimitException has been changed from InvalidRequestException to ApiException. There is no change to the public interface for the RateLimitException class.

See the changelog for more details.

This release changes the pinned API version to 2025-08-27.preview.

• #2029 Update generated code for beta
  • Add support for list and retrieve methods on resource InvoicePayment
  • Add support for list method on resource Mandate
  • Add support for applied on v2.core.Account.configuration.customer, v2.core.Account.configuration.merchant, v2.core.Account.configuration.recipient, v2.core.Account.configuration.storer, v2.core.AccountUpdateParams.configuration.customer, v2.core.AccountUpdateParams.configuration.merchant, v2.core.AccountUpdateParams.configuration.recipient, and v2.core.AccountUpdateParams.configuration.storer
  • Change type of billing.AlertTriggered.value from longInteger to decimal_string
  • Add support for displayName on v2.moneymanagement.FinancialAccountCreateParams and v2.moneymanagement.FinancialAccount
  • Add support for currencyConversion on v2.moneymanagement.Transaction.flow and v2.moneymanagement.TransactionEntry.transaction_details.flow
  • Add support for payments on BalanceSettingsUpdateParams and BalanceSettings
  • Remove support for debitNegativeBalances, payouts, and settlementTiming on BalanceSettingsUpdateParams and BalanceSettings
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for couponData on checkout.SessionCreateParams.discounts[]
  • Add support for mandateOptions on PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, PaymentIntentUpdateParams.payment_method_options.pix, checkout.Session.payment_method_options.pix, and checkout.SessionCreateParams.payment_method_options.pix
  • Change type of PaymentIntent.payment_method_options.pix.setupFutureUsage, PaymentIntentConfirmParams.payment_method_options.pix.setupFutureUsage, PaymentIntentCreateParams.payment_method_options.pix.setupFutureUsage, PaymentIntentUpdateParams.payment_method_options.pix.setupFutureUsage, checkout.Session.payment_method_options.pix.setupFutureUsage, and checkout.SessionCreateParams.payment_method_options.pix.setupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for amount on Mandate.multi_use, PaymentAttemptRecord, and PaymentRecord
  • Add support for currency on Mandate.multi_use
  • Add support for pix on Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_options
  • Add support for limit on PaymentAttemptRecordListParams
  • Add support for amountAuthorized, amountRefunded, and application on PaymentAttemptRecord and PaymentRecord
  • Add support for processorDetails on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecord
  • Remove support for paymentReference on PaymentAttemptRecord, PaymentRecordReportPaymentParams, and PaymentRecord
  • Add support for installments on PaymentAttemptRecord.payment_method_details.alma and PaymentRecord.payment_method_details.alma
  • Add support for transactionId on PaymentAttemptRecord.payment_method_details.alma, PaymentAttemptRecord.payment_method_details.amazon_pay, PaymentAttemptRecord.payment_method_details.billie, PaymentAttemptRecord.payment_method_details.kakao_pay, PaymentAttemptRecord.payment_method_details.kr_card, PaymentAttemptRecord.payment_method_details.naver_pay, PaymentAttemptRecord.payment_method_details.payco, PaymentAttemptRecord.payment_method_details.revolut_pay, PaymentAttemptRecord.payment_method_details.samsung_pay, PaymentAttemptRecord.payment_method_details.satispay, PaymentRecord.payment_method_details.alma, PaymentRecord.payment_method_details.amazon_pay, PaymentRecord.payment_method_details.billie, PaymentRecord.payment_method_details.kakao_pay, PaymentRecord.payment_method_details.kr_card, PaymentRecord.payment_method_details.naver_pay, PaymentRecord.payment_method_details.payco, PaymentRecord.payment_method_details.revolut_pay, PaymentRecord.payment_method_details.samsung_pay, and PaymentRecord.payment_method_details.satispay
  • Add support for location and reader on PaymentAttemptRecord.payment_method_details.paynow and PaymentRecord.payment_method_details.paynow
  • Add support for latestActiveMandate on PaymentMethod
  • Add support for metadata and period on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]
  • Add support for pixDisplayQrCode on SetupIntent.next_action
  • Add support for readerSecurity on terminal.ConfigurationCreateParams, terminal.ConfigurationUpdateParams, and terminal.Configuration
  • Add support for new values ao_nif, az_tin, bd_etin, cr_cpj, cr_nite, do_rcn, gt_nit, kz_bin, mz_nuit, pe_ruc, pk_ntn, sa_crn, and sa_tin on enums v2.core.AccountCreateParams.identity.business_details.id_numbers[].type and v2.core.AccountUpdateParams.identity.business_details.id_numbers[].type
  • Add support for new values ao_nif, az_tin, bd_brc, bd_etin, bd_nid, cr_cpf, cr_dimex, cr_nite, do_rcn, gt_nit, kz_iin, mz_nuit, pe_dni, pk_cnic, pk_snic, and sa_tin on enums v2.core.AccountCreateParams.identity.individual.id_numbers[].type, v2.core.AccountUpdateParams.identity.individual.id_numbers[].type, v2.core.PersonCreateParams.id_numbers[].type, and v2.core.PersonUpdateParams.id_numbers[].type

See the changelog for more details.

• #2034 Add section on private preview SDKs in readme
• #2030 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balanceReport, payoutDetails, and payoutReconciliationReport on AccountSession.components and AccountSessionCreateParams.components
  • Add support for name on billingportal.ConfigurationCreateParams, billingportal.ConfigurationUpdateParams, and billingportal.Configuration
  • Add support for installments on Charge.payment_method_details.alma
  • Add support for transactionId on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
  • Add support for location and reader on Charge.payment_method_details.paynow
  • Add support for amountIncludesIof on PaymentIntent.payment_method_options.pix, PaymentIntentConfirmParams.payment_method_options.pix, PaymentIntentCreateParams.payment_method_options.pix, PaymentIntentUpdateParams.payment_method_options.pix, checkout.Session.payment_method_options.pix, and checkout.SessionCreateParams.payment_method_options.pix
  • Add support for new value terminal_android_apk on enum FileListParams.purpose
  • Add support for new value terminal_android_apk on enum FileCreateParams.purpose
  • Add support for metadata and period on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for expMonth and expYear on issuing.CardCreateParams
  • Add support for excludedPaymentMethodTypes on PaymentIntentCreateParams and PaymentIntent
  • Add support for payoutMethod on PayoutCreateParams and Payout
  • Add support for mxn on terminal.Configuration.tipping, terminal.ConfigurationCreateParams.tipping, and terminal.ConfigurationUpdateParams.tipping
  • Add support for card on terminal.ReaderPresentPaymentMethodParams
  • Add support for new value card on enum terminal.ReaderPresentPaymentMethodParams.type
  • Add support for new value 2025-08-27.basil on enum WebhookEndpointCreateParams.apiVersion
• #2032 Introduce V1 namespaces in StripeClient
  • All the top level non-namespaced services under StripeClient services(eg. customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major release and will be removed in a future release. Eg.

  StripeClient client = new StripeClient("sk_test...")
  
  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
  - client.customers().list()
  + client.v1().customers().list()

  Refer to the migration guide for help upgrading.

See the changelog for more details.