v31.1.0-alpha.1

• #2112 Update generated code for private-preview
  • Add support for new resources BalanceTransfer and radar.AccountEvaluation
  • Add support for create method on resource BalanceTransfer
  • Add support for create, retrieve, and update methods on resource radar.AccountEvaluation
  • Add support for specifiedCommercialTransactionsActUrl on Account.business_profile, AccountCreateParams.business_profile, and AccountUpdateParams.business_profile
  • Add support for paypayPayments on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
  • Change type of billing.analytics.MeterUsageRetrieveParams.meters[].dimensionFilters from string to array(string)
  • Change type of billing.analytics.MeterUsageRetrieveParams.meters[].tenantFilters from string to array(string)
  • Add support for paymentMethodConfiguration on billingportal.Configuration.features.payment_method_update
  • Add support for carRentalData, flightData, and lodgingData on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, PaymentIntentCaptureParams.payment_details, PaymentIntentConfirmParams.payment_details, PaymentIntentCreateParams.payment_details, and PaymentIntentUpdateParams.payment_details
  • Add support for transactionId on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
  • Add support for new value finom on enums ConfirmationTokenCreateParams.payment_method_data.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethodCreateParams.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for created on CustomerBalanceTransactionListParams and InvoicePaymentListParams
  • Add support for accountNumbers on financialconnections.Account
  • Add support for billingSchedulesActions on InvoiceCreatePreviewParams.schedule_details.amendments[] and SubscriptionScheduleAmendParams.amendments[]
  • Add support for fraudRisk on issuing.AuthorizationCreateParams.risk_assessment
  • Add support for latestFraudWarning on issuing.Card
  • Add support for supplementaryPurchaseData on OrderCreateParams.payment.settings.payment_method_options.klarna, OrderUpdateParams.payment.settings.payment_method_options.klarna, PaymentIntentConfirmParams.payment_method_options.klarna, PaymentIntentCreateParams.payment_method_options.klarna, and PaymentIntentUpdateParams.payment_method_options.klarna
  • Add support for captureMethod on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
  • Add support for allowRedisplay and customerAccount on PaymentMethodListParams
  • Add support for mbWay and twint on Refund.destination_details
  • Change type of SubscriptionScheduleUpdateParams.billingSchedules from array(billing_schedules_update_params) to emptyable(array(billing_schedules_update_params))
  • Add support for new values capital.financing_offer.accepted_other_offer, financial_connections.account.account_numbers_updated, and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabledEvents and WebhookEndpointUpdateParams.enabledEvents
  • Add support for new value 2025-11-17.clover on enum WebhookEndpointCreateParams.apiVersion
  • Add support for snapshot events financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financialconnections.Account

See the changelog for more details.

v31.0.0

This release changes the pinned API version to 2025-11-17.clover.

• #2113 Update generated code
  • ⚠️ Remove support for gt, gte, lt, and lte on v2.core.EventListParams in favor of created.
• #2110 Update v2 array parameter serialization to use indexed format
  • Retrieve and List calls for /v2 endpoints now use indexed format (e.g., ?include[0]=foo&include[1]=bar) instead of repeated parameter format (e.g., ?include=foo&include=bar) when communicating with the Stripe API. This may break any unit tests that expect the latter behavior when setting up a mock server. Instead, they should now expect the former.
  • The arraysAsRepeated parameter was removed from the internal-use-only method FormEncoder#createQueryString
• #2108 Update generated code
  • Add support for new resources tax.Association and terminal.OnboardingLink
  • Add support for find method on resource tax.Association
  • Add support for create method on resource terminal.OnboardingLink
  • Add support for paymentMethodConfiguration on billingportal.Configuration.features.payment_method_update
  • Add support for transactionId on Charge.payment_method_details.ideal, PaymentAttemptRecord.payment_method_details.ideal, and PaymentRecord.payment_method_details.ideal
  • Add support for new value finom on enums ConfirmationTokenCreateParams.payment_method_data.ideal.bank, PaymentIntentConfirmParams.payment_method_data.ideal.bank, PaymentIntentCreateParams.payment_method_data.ideal.bank, PaymentIntentUpdateParams.payment_method_data.ideal.bank, PaymentMethodCreateParams.ideal.bank, SetupIntentConfirmParams.payment_method_data.ideal.bank, SetupIntentCreateParams.payment_method_data.ideal.bank, and SetupIntentUpdateParams.payment_method_data.ideal.bank
  • Add support for created on CustomerBalanceTransactionListParams and InvoicePaymentListParams
  • Add support for accountNumbers on financialconnections.Account
  • Add support for fraudRisk on issuing.AuthorizationCreateParams.risk_assessment
  • Add support for latestFraudWarning on issuing.Card
  • Add support for hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Add support for mbWay and twint on Refund.destination_details
  • Add support for new values financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry on enums WebhookEndpointCreateParams.enabledEvents and WebhookEndpointUpdateParams.enabledEvents
  • Add support for snapshot events financial_connections.account.account_numbers_updated and financial_connections.account.upcoming_account_number_expiry with resource financialconnections.Account

See the changelog for more details.

v30.3.0-alpha.2

This release changes the pinned API version to 2025-10-29.preview.

• #2111 Update generated code for private-preview
  • Add support for new resource issuing.Program
  • Add support for create, list, retrieve, and update methods on resource issuing.Program
  • Add support for schedule on Discount
  • Add support for applicableFees on delegatedcheckout.RequestedSession.total_details
  • Add support for scheduleDetails on Invoice.parent, InvoiceItem.parent, InvoiceLineItem.parent, and QuotePreviewInvoice.parent
  • Add support for billingSchedules on InvoiceCreatePreviewParams.schedule_details, QuotePreviewSubscriptionSchedule, SubscriptionScheduleCreateParams, SubscriptionScheduleUpdateParams, and SubscriptionSchedule
  • Add support for latestInvoice on QuotePreviewSubscriptionSchedule and SubscriptionSchedule
  • Add support for phaseEffectiveAt on QuotePreviewSubscriptionSchedule.default_settings, SubscriptionSchedule.default_settings, SubscriptionScheduleCreateParams.default_settings, and SubscriptionScheduleUpdateParams.default_settings
• #2107 Update generated code for private-preview
  • ⚠️ Remove support for resource v2.tax.AutomaticRule
  • ⚠️ Remove support for create, deactivate, find, retrieve, and update methods on resource v2.tax.AutomaticRule
  • Add support for selfReportedIncome and selfReportedMonthlyHousingPayment on AccountCreateParams.individual, AccountUpdateParams.individual, PersonCreateParams, PersonUpdateParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.person
  • Add support for new values amendment_end, line_ends_at, schedule_end, and upcoming_invoice on enums InvoiceCreatePreviewParams.subscription_details.billing_schedules[].bill_until.type, SubscriptionCreateParams.billing_schedules[].bill_until.type, and SubscriptionUpdateParams.billing_schedules[].bill_until.type
  • Add support for billingSchedules and phaseEffectiveAt on Quote.subscription_data_overrides[], Quote.subscription_data, QuoteCreateParams.subscription_data_overrides[], QuoteCreateParams.subscription_data, QuoteUpdateParams.subscription_data_overrides[], and QuoteUpdateParams.subscription_data
  • Add support for billFrom on Subscription.billing_schedules[]
  • Add support for amendmentEnd and lineEndsAt on Subscription.billing_schedules[].bill_until

See the changelog for more details.

v30.3.0-alpha.1

• #2105 Update generated code for private-preview
  • Add support for new resources TransitBalance, v2.reporting.ReportRun, v2.reporting.Report
  • Add support for create and retrieve methods on resource v2.reporting.ReportRun
  • Add support for retrieve method on resource v2.reporting.Report
  • Add support for create and refill test helper methods on resource capital.FinancingOffer
  • Add support for allocatedFunds on Charge, PaymentIntentConfirmParams, PaymentIntentCreateParams, and PaymentIntentUpdateParams
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRun

See the changelog for more details.

v30.2.1-alpha.1

• Updated publishing configuration. No changes to SDK content.

See the changelog for more details.

v30.2.0

• #2102 Update generated code
  • Add support for captureMethod on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present

See the changelog for more details.

v30.2.0-alpha.2

• #2099 Update generated code for private-preview
  • Change delegatedcheckout.RequestedSessionUpdateParams.line_item_details[].quantity to be required
  • Add support for paymentMethodPreview on delegatedcheckout.RequestedSession
  • Add support for orderId on delegatedcheckout.RequestedSession.order_details
  • Add support for lead on v2.core.Account.configuration.card_creator.capabilities.commercial, v2.core.Account.identity.attestations.terms_of_service.card_creator.commercial, v2.core.AccountCreateParams.configuration.card_creator.capabilities.commercial, v2.core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, v2.core.AccountUpdateParams.configuration.card_creator.capabilities.commercial, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for globalAccountHolder on v2.core.Account.identity.attestations.terms_of_service.card_creator.commercial, v2.core.AccountCreateParams.identity.attestations.terms_of_service.card_creator.commercial, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service.card_creator.commercial
  • Add support for new value commercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updatedCapability

See the changelog for more details.

v30.2.0-beta.1

This release changes the pinned API version to 2025-10-29.preview.

• #2092 Update generated code for beta
  • Add support for cryptoStorer on v2.core.AccountUpdateParams.identity.attestations.terms_of_service
• #2081 Update generated code for beta
  • Add support for update method on resource v2.moneymanagement.FinancialAccount
  • Add support for confirm_microdeposits, list, and send_microdeposits methods on resource v2.core.vault.UsBankAccount
  • Add support for list method on resource v2.core.vault.GbBankAccount
  • Add support for paymentPortalUrl on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
  • Add support for taxIdElement on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for startingAfter on PaymentAttemptRecordListParams
  • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
  • Add support for subscriptionReference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
  • Add support for closed on v2.core.AccountListParams and v2.core.Account
  • Add support for usd on v2.core.Account.configuration.storer.capabilities.holds_currencies, v2.core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and v2.core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for representativeDeclaration on v2.core.Account.identity.attestations, v2.core.AccountCreateParams.identity.attestations, and v2.core.AccountUpdateParams.identity.attestations
  • Add support for verification on v2.core.vault.UsBankAccount
  • Add support for new value payment_method on enums v2.core.AccountCreateParams.configuration.customer.automatic_indirect_tax.locationSource and v2.core.AccountUpdateParams.configuration.customer.automatic_indirect_tax.locationSource
  • Add support for new values application_custom and application_express on enums v2.core.AccountCreateParams.defaults.responsibilities.feesCollector and v2.core.AccountUpdateParams.defaults.responsibilities.feesCollector
  • Add support for v1Id on EventsV2MoneyManagementTransactionCreatedEvent
  • Remove support for thin event V2BillingBillSettingUpdatedEvent with related object v2.billing.BillSetting
• #2080 Update generated code for beta
  • Add support for lastSeenAt on terminal.Reader
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.apiVersion

See the changelog for more details.

v30.2.0-alpha.1

• #2091 Update generated code for private-preview
  • Add support for report_refund method on resource PaymentRecord
  • Add support for tenants on billing.analytics.MeterUsageRow
  • Add support for representativeDeclaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Add support for transfer on ApplicationFee.fee_source
  • Add support for transitBalancesTotal on Balance
  • Add support for tenantGroupByKeys on billing.analytics.MeterUsageRetrieveParams.meters[]
  • Change billing.CreditGrantCreateParams.category to be optional
  • Add support for paymentMethodConfiguration on billingportal.ConfigurationCreateParams.features.payment_method_update and billingportal.ConfigurationUpdateParams.features.payment_method_update
  • Add support for paymentPortalUrl on Charge.payment_method_details.rechnung, PaymentAttemptRecord.payment_method_details.rechnung, and PaymentRecord.payment_method_details.rechnung
  • Add support for twint on checkout.Session.payment_method_options and checkout.SessionCreateParams.payment_method_options
  • Add support for customerSheet, mobilePaymentElement, and taxIdElement on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for provider on Customer.tax
  • Remove support for riskDetails on delegatedcheckout.RequestedSessionCreateParams
  • Add support for riskDetails on delegatedcheckout.RequestedSessionConfirmParams
  • Add support for new value platform_terms_of_service on enum FileListParams.purpose
  • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
  • Add support for startingAfter on PaymentAttemptRecordListParams
  • Add support for reference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna, PaymentIntentCaptureParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentConfirmParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentCreateParams.amount_details.line_items[].payment_method_options.klarna, PaymentIntentIncrementAuthorizationParams.amount_details.line_items[].payment_method_options.klarna, and PaymentIntentUpdateParams.amount_details.line_items[].payment_method_options.klarna
  • Add support for allocatedFunds on PaymentIntent
  • Add support for subscriptionReference on PaymentIntentAmountDetailsLineItem.payment_method_options.klarna
  • Add support for nameCollection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
  • Add support for mbWay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for custom on PaymentMethodCreateParams and PaymentMethod
  • Add support for excludedPaymentMethodTypes on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Add support for tw on tax.Registration.country_options and tax.RegistrationCreateParams.country_options
  • Add support for gip on terminal.Configuration.tipping, terminal.ConfigurationCreateParams.tipping, and terminal.ConfigurationUpdateParams.tipping
  • Add support for lastSeenAt on terminal.Reader
  • Add support for applicationFeeAmount on TransferCreateParams and Transfer
  • Add support for applicationFee on Transfer
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.apiVersion
  • Add support for highRiskActivitiesDescription, highRiskActivities, moneyServicesDescription, operatesInProhibitedCountries, participatesInRegulatedActivity, purposeOfFundsDescription, purposeOfFunds, regulatedActivity, sourceOfFundsDescription, and sourceOfFunds on v2.core.Account.configuration.storer, v2.core.AccountCreateParams.configuration.storer, and v2.core.AccountUpdateParams.configuration.storer
  • Add support for cryptoWallets on v2.core.Account.configuration.storer.capabilities.financial_addresses, v2.core.Account.configuration.storer.capabilities.outbound_payments, v2.core.Account.configuration.storer.capabilities.outbound_transfers, v2.core.AccountCreateParams.configuration.storer.capabilities.financial_addresses, v2.core.AccountCreateParams.configuration.storer.capabilities.outbound_payments, v2.core.AccountCreateParams.configuration.storer.capabilities.outbound_transfers, v2.core.AccountUpdateParams.configuration.storer.capabilities.financial_addresses, v2.core.AccountUpdateParams.configuration.storer.capabilities.outbound_payments, and v2.core.AccountUpdateParams.configuration.storer.capabilities.outbound_transfers
  • Add support for usdc on v2.core.Account.configuration.storer.capabilities.holds_currencies, v2.core.AccountCreateParams.configuration.storer.capabilities.holds_currencies, and v2.core.AccountUpdateParams.configuration.storer.capabilities.holds_currencies
  • Add support for cryptoStorer on v2.core.Account.identity.attestations.terms_of_service and v2.core.AccountCreateParams.identity.attestations.terms_of_service
  • Add support for complianceScreeningDescription on v2.core.Account.identity.business_details, v2.core.AccountCreateParams.identity.business_details, and v2.core.AccountUpdateParams.identity.business_details
  • Add support for externalAmount on v2.moneymanagement.ReceivedCredit and v2.moneymanagement.ReceivedDebit

See the changelog for more details.

v30.1.0

• #2093 Update generated code
  • Improve docs for PaymentIntent related endpoints
• #2086 Update generated code
  • Add support for new resources PaymentAttemptRecord, PaymentIntentAmountDetailsLineItem, and PaymentRecord
  • Add support for list and retrieve methods on resource PaymentAttemptRecord
  • Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt_informational, report_payment_attempt, report_payment, report_refund, and retrieve methods on resource PaymentRecord
  • Add support for list method on resource PaymentIntentAmountDetailsLineItem
  • Add support for representativeDeclaration on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.company
  • Change billing.CreditGrantCreateParams.category to be optional
  • Add support for paymentMethodConfiguration on billingportal.ConfigurationCreateParams.features.payment_method_update and billingportal.ConfigurationUpdateParams.features.payment_method_update
  • Add support for new value mb_way on enum checkout.SessionCreateParams.excludedPaymentMethodTypes
  • Add support for twint on checkout.Session.payment_method_options and checkout.SessionCreateParams.payment_method_options
  • Add support for new value mb_way on enum checkout.SessionCreateParams.paymentMethodTypes
  • Add support for paymentRecordRefund and type on CreditNote.refunds[], CreditNoteCreateParams.refunds[], CreditNotePreviewLinesParams.refunds[], and CreditNotePreviewParams.refunds[]
  • Add support for customerSheet and mobilePaymentElement on CustomerSession.components and CustomerSessionCreateParams.components
  • Add support for new value custom on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for provider on Customer.tax
  • Add support for new value platform_terms_of_service on enum FileListParams.purpose
  • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
  • Add support for paymentRecord on InvoiceAttachPaymentParams, InvoicePayment.payment, and InvoicePaymentListParams.payment
  • Change type of InvoicePaymentListParams.payment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
  • Add support for new value custom on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for amountDetails on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentUpdateParams
  • Add support for paymentDetails on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntent
  • Add support for discountAmount, lineItems, shipping, and tax on PaymentIntent.amount_details
  • Add support for nameCollection on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for new value mb_way on enums PaymentLinkCreateParams.paymentMethodTypes and PaymentLinkUpdateParams.paymentMethodTypes
  • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, and Refund.destination_details
  • Add support for mbWay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for custom on PaymentMethodCreateParams and PaymentMethod
  • Add support for excludedPaymentMethodTypes on SetupIntentCreateParams, SetupIntentUpdateParams, and SetupIntent
  • Add support for tw on tax.Registration.country_options and tax.RegistrationCreateParams.country_options
  • Add support for gip on terminal.Configuration.tipping, terminal.ConfigurationCreateParams.tipping, and terminal.ConfigurationUpdateParams.tipping
  • Add support for lastSeenAt on terminal.Reader
  • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enums WebhookEndpointCreateParams.enabledEvents and WebhookEndpointUpdateParams.enabledEvents
  • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.apiVersion
  • Add support for gt, gte, lt, lte, and types on v2.core.EventListParams
  • Change v2.core.EventListParams.objectId to be optional
  • Add support for snapshot event balance_settings.updated with resource BalanceSettings
  • Add support for snapshot event invoice.payment_attempt_required with resource Invoice

See the changelog for more details.