v25.5.0

• #1785 Update generated code
  • Add support for paypal on Dispute.payment_method_details
  • Change type of Dispute.payment_method_details.type from literal('card') to enum('card'|'paypal')
  • Change type of entitlements.FeatureUpdateParams.metadata from map(string: string) to emptyable(map(string: string))
  • Add support for payment_method_types on PaymentIntentConfirmParams
  • Add support for ship_from_details on Tax.Calculation, Tax.Transaction, and tax.CalculationCreateParams
  • Add support for bh, eg, ge, ke, kz, ng, and om on Tax.Registration.country_options and tax.RegistrationCreateParams.country_options
• #1787 Deprecate Java params based on OpenAPI spec
  • Mark as deprecated the persistent_token property on ConfirmationToken.Link.persistentToken, PaymentIntent.Link.persistentToken, PaymentMethod.Link.persistentToken, SetupIntent.Link.persistentToken, PaymentIntentConfirmParams.Link.persistentToken, PaymentIntentCreateParams.Link.persistentToken, PaymentIntentUpdateParams.Link.persistentToken, SetupIntentConfirmParams.Link.persistentToken, SetupIntentCreateParams.Link.persistentToken, SetupIntentUpdateParams.Link.persistentToken. This is a legacy parameter that no longer has any function.

See the changelog for more details.

v25.5.0-beta.1

• #1783 Update generated code for beta
  • Add support for payment_method_settings on AccountSessionCreateParams.components
  • Add support for cancel_subscription_schedule on QuoteCreateParams.lines[], QuoteLine, and QuoteUpdateParams.lines[]

See the changelog for more details.

v25.4.0

• #1784 Update generated code
  • Add support for setup_future_usage on Checkout.Session.payment_method_options.amazon_pay, Checkout.Session.payment_method_options.revolut_pay, PaymentIntent.payment_method_options.amazon_pay, and PaymentIntent.payment_method_options.revolut_pay
  • Change type of Entitlements.ActiveEntitlement.feature from string to expandable($Entitlements.Feature)
  • Remove support for inadvertently released identity verification features email and phone on identity.VerificationSessionCreateParams.options and identity.VerificationSessionUpdateParams.options
  • Add support for new values amazon_pay and revolut_pay on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]
  • Add support for amazon_pay and revolut_pay on Mandate.payment_method_details and SetupAttempt.payment_method_details
  • Add support for ending_before, limit, and starting_after on PaymentMethodConfigurationListParams
  • Add support for mobilepay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
• Deprecate Java methods based on OpenAPI spec
  • Mark as deprecated the approve and decline methods on Authorization. Instead, respond directly to the webhook request to approve an authorization.

See the changelog for more details.

v25.4.0-beta.1

• #1781 Update generated code for beta
  • Add support for capital_overview, tax_registrations, and tax_settings on AccountSessionCreateParams.components
  • Add support for external_account_collection on AccountSessionCreateParams.components.financial_account.features
  • Add support for subscription_trial_from_plan on InvoiceUpcomingLinesParams and InvoiceUpcomingParams

See the changelog for more details.

v25.3.0

• #1782 Update generated code
  • Add support for create_preview method on resource Invoice
  • Add support for payment_method_data on checkout.SessionCreateParams
  • Add support for saved_payment_method_options on Checkout.Session and checkout.SessionCreateParams
  • Add support for mobilepay on Checkout.Session.payment_method_options and checkout.SessionCreateParams.payment_method_options
  • Add support for new value mobilepay on enum checkout.SessionCreateParams.payment_method_types[]
  • Add support for allow_redisplay on ConfirmationTokenCreateParams.payment_method_data, CustomerListPaymentMethodsParams, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethodUpdateParams, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_data
  • Add support for schedule_details and subscription_details on InvoiceUpcomingLinesParams and InvoiceUpcomingParams
  • Add support for new value other on enums issuing.AuthorizationCaptureParams.purchase_details.fuel.unit, issuing.TransactionCreateForceCaptureParams.purchase_details.fuel.unit, and issuing.TransactionCreateUnlinkedRefundParams.purchase_details.fuel.unit

See the changelog for more details.

v25.2.0

• #1780 Update generated code
  • Add support for new resource Entitlements.ActiveEntitlementSummary
  • Add support for balances and payouts_list on AccountSession.components and AccountSessionCreateParams.components
  • Change billing.MeterEventCreateParams.timestamp to be optional
  • Remove support for config on Forwarding.Request and forwarding.RequestCreateParams. This field is no longer used by the Forwarding Request API.
  • Add support for capture_method on PaymentIntent.payment_method_options.revolut_pay, PaymentIntentConfirmParams.payment_method_options.revolut_pay, PaymentIntentCreateParams.payment_method_options.revolut_pay, and PaymentIntentUpdateParams.payment_method_options.revolut_pay
  • Add support for swish on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
  • Add support for new value entitlements.active_entitlement_summary.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v25.2.0-beta.1

• #1777 Update generated code for beta
  • Add support for retrieve method on resources Entitlements.ActiveEntitlement and Entitlements.Feature
  • Add support for fees, losses, requirement_collection, and stripe_dashboard on AccountCreateParams.controller
  • Add support for new values bh_vat, kz_bin, ng_tin, and om_vat on enums InvoiceCreatePreviewParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, and OrderUpdateParams.tax_details.tax_ids[].type
  • Add support for hosted_voucher_url on PaymentIntent.next_action.multibanco_display_details
  • Add support for toggles on Terminal.Reader.action.collect_inputs.inputs[] and terminal.ReaderCollectInputsParams.inputs[]
  • Add support for new values email, numeric, phone, and text on enum terminal.ReaderCollectInputsParams.inputs[].type
  • Add support for email, numeric, phone, and text on Terminal.Reader.action.collect_inputs.inputs[]

See the changelog for more details.

v25.1.0

• #1779 Update generated code
  • Add support for account_management and notification_banner on AccountSession.components and AccountSessionCreateParams.components
  • Add support for external_account_collection on AccountSession.components.account_onboarding.features and AccountSessionCreateParams.components.account_onboarding.features
  • Change billing.MeterEventAdjustmentCreateParams.cancel.identifier and billing.MeterEventAdjustmentCreateParams.cancel to be optional
  • Change billing.MeterEventAdjustmentCreateParams.type to be required
  • Change type of Billing.MeterEventAdjustment.cancel from BillingMeterResourceBillingMeterEventAdjustmentCancel to nullable(BillingMeterResourceBillingMeterEventAdjustmentCancel)
  • Add support for amazon_pay on Charge.payment_method_details, Checkout.Session.payment_method_options, 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, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, Refund.destination_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, SetupIntentUpdateParams.payment_method_options, and checkout.SessionCreateParams.payment_method_options
  • Add support for new value ownership on enums InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[], SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[], and checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
  • Add support for new value amazon_pay on enum checkout.SessionCreateParams.payment_method_types[]
  • Add support for new value amazon_pay on enums ConfirmationTokenCreateParams.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for new values bh_vat, kz_bin, ng_tin, and om_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for new value amazon_pay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for next_refresh_available_at on FinancialConnections.Account.ownership_refresh

See the changelog for more details.

v25.0.0

• #1776

  • This release changes the pinned API version to 2024-04-10. Please read the API Upgrade Guide and carefully review the API changes before upgrading.

  • Add a new TaxIdService for operations on /v1/tax_ids endpoints.

  ⚠️ Breaking changes

  • Rename features to marketing_features on ProductCreateParams, ProductUpdateParams, and Product
  • Rename "child" services to be prefixed with the associated parent service to allow for the same resource to be exposed at top level (e.g., /v1/tax_ids via client.taxIds()) and as a child (e.g., /v1/customers/{}/tax_ids via client.customers().taxIds()).
    • Rename CapabilityService -> AccountCapabilityService
    • Rename ExternalAccountService -> AccountExternalAccountService
    • Rename LoginLinkService -> AccountLoginLinkService
    • Rename PersonService -> AccountPersonService
    • Rename FeeRefundService -> ApplicationFeeRefundService
    • Rename CashBalanceService -> CustomerCashBalanceService
    • Rename PaymentSourceService -> CustomerPaymentSourceService
    • Rename UsageRecordService -> SubscriptionItemUsageRecordService
    • Rename UsageRecordSummaryService -> SubscriptionItemUsageRecordSummaryService
    • Rename TaxIdService -> CustomerTaxIdService.
  • Remove support for verify method on BankAccountService.
    • Please use the verify method on CustomerPaymentSourceService instead

    // BEFORE
    client.bankAccounts().verify("cus_...", "ba_...");
    
    // AFTER
    client.customers().paymentSources().verify("cus_...", "ba_...");

  • Remove support for list and create methods on treasury.FinancialAccountFeaturesService. These methods were incorrectly named.
    • Please migrate list -> retrieve and create -> update.
  • Update setPageTypeToken method on StripeCollectionInterface to be required and remove default implementation.
  • Remove deprecated setUsage method on BaseApiRequest.
  • Update usage on BaseApiRequest class to be final.
  • Remove deprecated maybeEnqueueMetrics method on RequestTelemetry.

  ⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API

  • Remove Configuration.SubscriptionPause for Billing Portal as the feature to pause subscription on the portal has been deprecated.
  • Remove the support for the below deprecated values in BalanceTransaction.Type
    • obligation_inbound
    • obligation_payout
    • obligation_payout_failure
    • obligation_reversal_outbound
  • Remove the below deprecated events from Event.Type, WebhookEndpointCreateOptions.EnabledEvent, WebhookEndpointUpdateOptions.EnabledEvent
    • invoiceitem.updated
    • order.created
    • recipient.created
    • recipient.deleted
    • recipient.updated
    • sku.created
    • sku.deleted
    • sku.updated
  • Remove support for id_bank_transfer, multibanco, netbanking, pay_by_bank, and upi on PaymentMethodConfiguration by removing the below classes
    • PaymentMethodConfiguration.IdBankTransfer
    • PaymentMethodConfiguration.Multibanco
    • PaymentMethodConfiguration.Netbanking
    • PaymentMethodConfiguration.PayByBank
    • PaymentMethodConfiguration.Upi
  • Remove the support for challenge_only in SetupIntent.PaymentMethodOptions.Card.RequestThreeDSecure
  • Remove the support for deprecated value service_tax in TaxRate.TaxType, InvoiceLinetItemUpdateParams.TaxAmount.TaxRateData.TaxType,pwebTaxRateCreateParams.TaxType, TaxRateUpdateParams.TaxType
  • Remove the support for various in Climate.Supplier.removalPathway
  • Remove the deprecated value INCLUDE_AND_REQUIRE on the enum InvoiceCreateParams.PendingInvoiceItemsBehavior
  • Remove the property RequestIncrementalAuthorization on PaymentIntentConfirmParams.PaymentMethodOptions.CardPresent, PaymentIntentCreateParams.PaymentMethodOptions.CardPresent and PaymentIntentUpdateParams.PaymentMethodOptions.CardPresent. This was shipped by mistake.
  • Remove the support for deprecated value obligation on ReportRunCreateParams.ReportingCategory
  • Remove the legacy field rendering_options on InvoiceCreateParams, InvoiceUpdateParams, and Invoice. Use rendering instead.

See the changelog for more details.

v24.24.0

• #1778 Update generated code
  • Add support for new resources Entitlements.ActiveEntitlement and Entitlements.Feature
  • Add support for list and retrieve methods on resource ActiveEntitlement
  • Add support for create, list, retrieve, and update methods on resource Feature
  • Add support for controller on AccountCreateParams
  • Add support for fees, losses, requirement_collection, and stripe_dashboard on Account.controller
  • Add support for event_name on Billing.MeterEventAdjustment and billing.MeterEventAdjustmentCreateParams
  • Add support for cancel and type on Billing.MeterEventAdjustment

See the changelog for more details.