releases.shpreview
Stripe/stripe-python

stripe-python

$npx -y @buildinternet/releases show stripe-python
Mon
Wed
Fri
AprMayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases24Avg7/moVersionsv14.2.0a3 → v15.1.0a4
Oct 30, 2025
  • #1659 Update generated code for private-preview
    • Change delegated_checkout.RequestedSessionModifyParamsLineItemDetail.quantity to be required
    • Add support for payment_method_preview on DelegatedCheckout.RequestedSession
    • Add support for order_id on DelegatedCheckout.RequestedSession.OrderDetail
    • Add support for lead on V2.Core.Account.Configuration.CardCreator.Capability.Commercial, V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsConfigurationCardCreatorCapabilityCommercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, v2.core.AccountModifyParamsConfigurationCardCreatorCapabilityCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercial
    • Add support for global_account_holder on V2.Core.Account.Identity.Attestation.TermsOfService.CardCreator.Commercial, v2.core.AccountCreateParamsIdentityAttestationTermsOfServiceCardCreatorCommercial, and v2.core.AccountModifyParamsIdentityAttestationTermsOfServiceCardCreatorCommercial
    • Add support for new value commercial.lead.prepaid_card on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for new value commercial.lead.prepaid_card on enum EventsV2CoreAccountIncludingConfigurationCardCreatorCapabilityStatusUpdatedEvent.updated_capability

See the changelog for more details.

Oct 29, 2025
  • #1654 Update generated code for private-preview
    • Add support for report_refund method on resource PaymentRecord
    • Add support for new value verification_data_not_found on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
    • Add support for tenants on Billing.Analytics.MeterUsageRow
    • Add support for representative_declaration on Account.Company, AccountCreateParamsCompany, AccountModifyParamsCompany, and TokenCreateParamsAccountCompany
    • Add support for transfer on ApplicationFee.FeeSource
    • Add support for new value transfer on enum ApplicationFee.FeeSource.type
    • Add support for transit_balances_total on Balance
    • Add support for new value transit on enum BalanceTransaction.balance_type
    • Add support for tenant_group_by_keys on billing.analytics.MeterUsageRetrieveParamsMeter
    • Change billing.CreditGrantCreateParams.category to be optional
    • Add support for payment_method_configuration on billing_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdate and billing_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdate
    • Add support for new value solana on enums Charge.PaymentMethodDetail.Crypto.network, PaymentAttemptRecord.PaymentMethodDetail.Crypto.network, and PaymentRecord.PaymentMethodDetail.Crypto.network
    • Add support for payment_portal_url on Charge.PaymentMethodDetail.Rechnung, PaymentAttemptRecord.PaymentMethodDetail.Rechnung, and PaymentRecord.PaymentMethodDetail.Rechnung
    • Add support for twint on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOption
    • Add support for new value custom on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
    • Change CreditNote.Refund.payment_record_refund to be required
    • Change CreditNote.Refund.type to be required
    • Add support for customer_sheet, mobile_payment_element, and tax_id_element on CustomerSession.Component and CustomerSessionCreateParamsComponent
    • 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 risk_details on delegated_checkout.RequestedSessionCreateParams
    • Add support for risk_details on delegated_checkout.RequestedSessionConfirmParams
    • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
    • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
    • Add support for starting_after on PaymentAttemptRecordListParams
    • Add support for reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionKlarna, and PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionKlarna
    • Add support for allocated_funds on PaymentIntent
    • Change PaymentIntent.PaymentDetail.customer_reference to be required
    • Change PaymentIntent.PaymentDetail.order_reference to be required
    • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna
    • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLink
    • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, and Refund.DestinationDetail
    • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, and PaymentMethodConfiguration
    • Add support for custom on PaymentMethodCreateParams and PaymentMethod
    • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntent
    • Change SetupIntent.flow_directions to be optional
    • Add support for tw on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOption
    • Add support for gip on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTipping
    • Add support for last_seen_at on Terminal.Reader
    • Add support for application_fee_amount on TransferCreateParams and Transfer
    • Add support for application_fee on Transfer
    • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for high_risk_activities_description, high_risk_activities, money_services_description, operates_in_prohibited_countries, participates_in_regulated_activity, purpose_of_funds_description, purpose_of_funds, regulated_activity, source_of_funds_description, and source_of_funds on V2.Core.Account.Configuration.Storer, v2.core.AccountCreateParamsConfigurationStorer, and v2.core.AccountModifyParamsConfigurationStorer
    • Add support for crypto_wallets on V2.Core.Account.Configuration.Storer.Capability.FinancialAddress, V2.Core.Account.Configuration.Storer.Capability.OutboundPayment, V2.Core.Account.Configuration.Storer.Capability.OutboundTransfer, v2.core.AccountCreateParamsConfigurationStorerCapabilityFinancialAddress, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundPayment, v2.core.AccountCreateParamsConfigurationStorerCapabilityOutboundTransfer, v2.core.AccountModifyParamsConfigurationStorerCapabilityFinancialAddress, v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundPayment, and v2.core.AccountModifyParamsConfigurationStorerCapabilityOutboundTransfer
    • Add support for usdc on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrency
    • Add support for crypto_storer on V2.Core.Account.Identity.Attestation.TermsOfService and v2.core.AccountCreateParamsIdentityAttestationTermsOfService
    • Add support for compliance_screening_description on V2.Core.Account.Identity.BusinessDetail, v2.core.AccountCreateParamsIdentityBusinessDetail, and v2.core.AccountModifyParamsIdentityBusinessDetail
    • Add support for external_amount on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
    • Add support for error code payment_intent_rate_limit_exceeded on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, QuotePreviewInvoice.LastFinalizationError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError

See the changelog for more details.

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

  • #1655 Update generated code for beta
    • Add support for crypto_storer on v2.core.AccountModifyParamsIdentityAttestationTermsOfService
  • #1624 Update generated code for beta
    • Add support for modify method on resource v2.money_management.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 new value verification_data_not_found on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
    • Add support for payment_portal_url on Charge.PaymentMethodDetail.Rechnung, PaymentAttemptRecord.PaymentMethodDetail.Rechnung, and PaymentRecord.PaymentMethodDetail.Rechnung
    • Add support for tax_id_element on CustomerSession.Component and CustomerSessionCreateParamsComponent
    • Add support for starting_after on PaymentAttemptRecordListParams
    • Add support for new value solana on enums PaymentAttemptRecord.PaymentMethodDetail.Crypto.network and PaymentRecord.PaymentMethodDetail.Crypto.network
    • Add support for reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna, PaymentIntentCaptureParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentConfirmParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentCreateParamsAmountDetailLineItemPaymentMethodOptionKlarna, PaymentIntentIncrementAuthorizationParamsAmountDetailLineItemPaymentMethodOptionKlarna, and PaymentIntentModifyParamsAmountDetailLineItemPaymentMethodOptionKlarna
    • Change PaymentIntent.PaymentDetail.customer_reference to be required
    • Change PaymentIntent.PaymentDetail.order_reference to be required
    • Add support for subscription_reference on PaymentIntentAmountDetailsLineItem.PaymentMethodOption.Klarna
    • Add support for closed on V2.Core.Account and v2.core.AccountListParams
    • Add support for new value payment_method on enums V2.Core.Account.Configuration.Customer.AutomaticIndirectTax.location_source, v2.core.AccountCreateParamsConfigurationCustomerAutomaticIndirectTax.location_source, and v2.core.AccountModifyParamsConfigurationCustomerAutomaticIndirectTax.location_source
    • Add support for usd on V2.Core.Account.Configuration.Storer.Capability.HoldsCurrency, v2.core.AccountCreateParamsConfigurationStorerCapabilityHoldsCurrency, and v2.core.AccountModifyParamsConfigurationStorerCapabilityHoldsCurrency
    • Add support for new values application_custom and application_express on enums V2.Core.Account.Default.Responsibility.fees_collector, v2.core.AccountCreateParamsDefaultResponsibility.fees_collector, and v2.core.AccountModifyParamsDefaultResponsibility.fees_collector
    • Add support for representative_declaration on V2.Core.Account.Identity.Attestation, v2.core.AccountCreateParamsIdentityAttestation, and v2.core.AccountModifyParamsIdentityAttestation
    • Add support for new value holds_currencies.usd on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for verification on V2.Core.Vault.UsBankAccount
    • Add support for v1_id on EventsV2MoneyManagementTransactionCreatedEvent
    • Remove support for thin event V2BillingBillSettingUpdatedEvent with related object v2.billing.BillSetting
    • Add support for error code payment_intent_rate_limit_exceeded on QuotePreviewInvoice.LastFinalizationError
    • Add support for error codes blocked_payout_method_crypto_wallet and unsupported_payout_method_crypto_wallet on BlockedByStripeError
    • Add support for error code outbound_flow_from_closed_financial_account_unsupported on FeatureNotEnabledError
    • Add support for error code limit_payout_method_crypto_wallet on QuotaExceededError
  • #1617 Update generated code for beta
    • Add support for last_seen_at on Terminal.Reader
    • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version

See the changelog for more details.

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

  • #1656 Update generated code
    • Improve docs for PaymentIntent related endpoints
  • #1650 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 representative_declaration on Account.Company, AccountCreateParamsCompany, AccountModifyParamsCompany, and TokenCreateParamsAccountCompany
    • Change billing.CreditGrantCreateParams.category to be optional
    • Add support for payment_method_configuration on billing_portal.ConfigurationCreateParamsFeaturePaymentMethodUpdate and billing_portal.ConfigurationModifyParamsFeaturePaymentMethodUpdate
    • Add support for new value solana on enum Charge.PaymentMethodDetail.Crypto.network
    • Add support for new value mb_way on enum checkout.SessionCreateParams.excluded_payment_method_types
    • Add support for twint on Checkout.Session.PaymentMethodOption and checkout.SessionCreateParamsPaymentMethodOption
    • Add support for new value mb_way on enum checkout.SessionCreateParams.payment_method_types
    • Add support for new value custom on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
    • Add support for payment_record_refund and type on CreditNote.Refund, CreditNoteCreateParamsRefund, CreditNotePreviewLinesParamsRefund, and CreditNotePreviewParamsRefund
    • Add support for customer_sheet and mobile_payment_element on CustomerSession.Component and CustomerSessionCreateParamsComponent
    • 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 values balance_settings.updated and invoice.payment_attempt_required on enum Event.type
    • Add support for new value platform_terms_of_service on enums File.purpose and FileListParams.purpose
    • Add support for new value platform_terms_of_service on enum FileCreateParams.purpose
    • Add support for payment_record on InvoiceAttachPaymentParams, InvoicePayment.Payment, and InvoicePaymentListParamsPayment
    • Change type of InvoicePaymentListParamsPayment.type from literal('payment_intent') to enum('payment_intent'|'payment_record')
    • Add support for new value custom on enums Invoice.PaymentSetting.payment_method_types, InvoiceCreateParamsPaymentSetting.payment_method_types, InvoiceModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionCreateParamsPaymentSetting.payment_method_types, and SubscriptionModifyParamsPaymentSetting.payment_method_types
    • Add support for amount_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, and PaymentIntentModifyParams
    • Add support for payment_details on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentModifyParams, and PaymentIntent
    • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.AmountDetail
    • Add support for name_collection on PaymentLinkCreateParams, PaymentLinkModifyParams, and PaymentLink
    • Add support for new value mb_way on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkModifyParams.payment_method_types
    • Add support for crypto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, PaymentMethodConfiguration, and Refund.DestinationDetail
    • Add support for mb_way on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationModifyParams, and PaymentMethodConfiguration
    • Add support for custom on PaymentMethodCreateParams and PaymentMethod
    • Add support for excluded_payment_method_types on SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntent
    • Change SetupIntent.flow_directions to be optional
    • Add support for tw on Tax.Registration.CountryOption and tax.RegistrationCreateParamsCountryOption
    • Add support for gip on Terminal.Configuration.Tipping, terminal.ConfigurationCreateParamsTipping, and terminal.ConfigurationModifyParamsTipping
    • Add support for last_seen_at on Terminal.Reader
    • Add support for new values balance_settings.updated and invoice.payment_attempt_required on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointModifyParams.enabled_events
    • Add support for new value 2025-10-29.clover on enum WebhookEndpointCreateParams.api_version
    • Add support for gt, gte, lt, lte, and types on v2.core.EventListParams
    • Change v2.core.EventListParams.object_id 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
    • Add support for error code payment_intent_rate_limit_exceeded on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
  • #1645 Dramatically improve performance by lazily loading most imports
    • move many type imports behind an if TYPE_CHECKING block
    • lazily initialize subservices
    • add module-level __getattr__ functions to most __init__.py files

See the changelog for more details.

Oct 23, 2025
  • #1649 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 dimension_payload_keys on Billing.Meter and billing.MeterCreateParams
    • Add support for dimension_filters and dimension_group_by_keys on billing.BillingMeterListMeterEventSummaryParams
    • Add support for dimensions on Billing.MeterEventSummary
    • Add support for fulfillment_details and payment_method_data on delegated_checkout.RequestedSessionCreateParams and delegated_checkout.RequestedSessionModifyParams
    • Add support for line_item_details, metadata, payment_method, and shared_metadata on DelegatedCheckout.RequestedSession, delegated_checkout.RequestedSessionCreateParams, and delegated_checkout.RequestedSessionModifyParams
    • Add support for currency, customer, and risk_details on delegated_checkout.RequestedSessionCreateParams
    • Add support for seller_details and setup_future_usage on DelegatedCheckout.RequestedSession and delegated_checkout.RequestedSessionCreateParams
    • Add support for amount_subtotal, amount_total, created_at, expires_at, order_details, shared_payment_issued_token, status, total_details, and updated_at on DelegatedCheckout.RequestedSession
    • Add support for address, email, fulfillment_options, name, phone, and selected_fulfillment_option on DelegatedCheckout.RequestedSession.FulfillmentDetail
    • 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.payment_method_type, EventsV2CoreHealthAuthorizationRateDropResolvedEvent.Impact.payment_method_type, EventsV2CoreHealthPaymentMethodErrorFiringEvent.Impact.payment_method_type, and EventsV2CoreHealthPaymentMethodErrorResolvedEvent.Impact.payment_method_type
  • #1648 Prathmesh/merge python private preview

See the changelog for more details.

Oct 17, 2025
  • #1643 Update generated code for private-preview
    • Add support for new resources delegated_checkout.RequestedSession and identity.BlocklistEntry
    • Add support for confirm, create, expire, modify, and retrieve methods on resource delegated_checkout.RequestedSession
    • Add support for create, disable, list, and retrieve methods on resource identity.BlocklistEntry
    • Add support for blocked_by_entry on Identity.VerificationReport.Document, Identity.VerificationReport.Selfie, and identity.VerificationReportListParams

See the changelog for more details.

Oct 9, 2025
  • #1629 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.PaymentMethodDetail.Card, ConfirmationToken.PaymentMethodPreview.Card, and PaymentMethod.Card
    • Add support for benefit on PaymentIntent.PaymentDetail, PaymentIntentConfirmParamsPaymentDetail, PaymentIntentCreateParamsPaymentDetail, and PaymentIntentModifyParamsPaymentDetail
    • Add support for setup_details on SetupIntentConfirmParams, SetupIntentCreateParams, SetupIntentModifyParams, and SetupIntent
    • Add support for new value card_creator on enums V2.Core.Account.applied_configurations and v2.core.AccountCloseParams.applied_configurations
    • Add support for card_creator on V2.Core.Account.Configuration, V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.AccountCreateParamsConfiguration, v2.core.AccountCreateParamsIdentityAttestationTermsOfService, v2.core.AccountModifyParamsConfiguration, and v2.core.AccountModifyParamsIdentityAttestationTermsOfService
    • Add support for new values commercial.celtic.charge_card, commercial.celtic.spend_card, commercial.cross_river_bank.charge_card, commercial.cross_river_bank.spend_card, commercial.stripe.charge_card, and commercial.stripe.prepaid_card on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for new value card_creator on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.configuration
    • Add support for new value configuration.card_creator on enums v2.core.AccountCreateParams.include, v2.core.AccountModifyParams.include, and v2.core.AccountRetrieveParams.include
    • 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.

Oct 3, 2025
  • Contains bug fixes and improvements from v13.0.1.

See the changelog for more details.

  • Contains bug fixes and improvements from v13.0.1.

See the changelog for more details.

  • #1633 add httpx to optional deps and only ship tests in sdist

    • Add new async optional dependency. Now, pip install stripe[async] gets you everything you need to make async HTTP calls out of the box.
  • #1632 remove gpg step from publish

  • #1627 Re-add tests to our sdist

  • #1626 Make nested params classes importable

  • #1620 Remove manual promotion code test

  • #1619 Update param in deprecation docs link

See the changelog for more details.

Oct 1, 2025

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

  • #1587 Update generated code for private-preview
    • Add support for new resource v2.money_management.RecipientVerification
    • Add support for acknowledge, create, recipient_verifications, and retrieve methods on resource v2.money_management.RecipientVerification
    • Add support for modify method on resources v2.billing.PricingPlanSubscription and v2.billing.ServiceAction
    • Add support for crypto_wallets on V2.Account.Configuration.RecipientDatum.Feature, V2.Core.Account.Configuration.Recipient.Capability, v2.Account.CreateParamsConfigurationRecipientDatumFeature, v2.Account.ModifyParamsConfigurationRecipientDatumFeature, v2.core.Account.CreateParamsConfigurationRecipientCapability, and v2.core.Account.ModifyParamsConfigurationRecipientCapability
    • Add support for new value crypto on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
    • Add support for new value crypto_wallet on enum V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type
    • Add support for new value crypto_wallets on enum V2.Account.Configuration.SupportableFeature.recipient_data
    • Add support for new value crypto_wallets on enum V2.Account.Requirement.Impact.required_for_features
    • Add support for lookup_key on V2.Billing.Cadence, v2.billing.Cadence.CreateParams, and v2.billing.Cadence.ModifyParams
    • Add support for settings_data on V2.Billing.Cadence
    • Change type of V2.Billing.Cadence.Payer.billing_profile from nullable(string) to string
    • Add support for v1_event_id on V2.Core.Event
    • Add support for recipient_verification on V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundTransfer, v2.money_management.OutboundPayment.CreateParams, and v2.money_management.OutboundTransfer.CreateParams
    • Add support for crypto_wallet on V2.MoneyManagement.PayoutMethod and v2.money_management.OutboundSetupIntent.CreateParamsPayoutMethodDatum
    • Add support for custom_pricing_unit_details on V2.Billing.RateCardRate.CustomPricingUnitAmount, V2.Billing.ServiceAction.CreditGrant.Amount.CustomPricingUnit, and V2.Billing.ServiceAction.CreditGrantPerTenant.Amount.CustomPricingUnit
    • Add support for origin_type on V2.MoneyManagement.ReceivedDebit.BankTransfer
    • Add support for new value sepa_credit_transfer on enum v2.FinancialAddressCreditSimulation.CreditParams.network
    • Add support for new value credentials.sepa_bank_account.iban on enums v2.money_management.FinancialAddress.ListParams.include and v2.money_management.FinancialAddress.RetrieveParams.include
    • Add support for sepa_bank_account on v2.money_management.FinancialAddress.CreateParams
    • Remove support for price on v2.billing.RateCardRate.CreateParams
    • Add support for lookup_keys on v2.billing.Cadence.ListParams
    • Change type of v2.billing.Cadence.CancelParams.include, v2.billing.Cadence.CreateParams.include, v2.billing.Cadence.ListParams.include, v2.billing.Cadence.ModifyParams.include, and v2.billing.Cadence.RetrieveParams.include from literal('invoice_discount_rules') to enum('invoice_discount_rules'|'settings_data')
    • Remove support for customer and type on v2.billing.Cadence.CreateParamsPayer
    • Change v2.billing.Cadence.CreateParamsPayer.billing_profile to be required
    • Add support for new value crypto_wallets on enum EventsAccountConfigurationRecipientDataFeatureStatusUpdatedEvent.feature_name
    • Add support for new value crypto_wallets_v2 on enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability
    • Remove support for alert_id 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, V1TestHelpersTestClockDeletedEvent, V1TestHelpersTestClockInternalFailureEvent, V1TestHelpersTestClockReadyEvent, V1TopupCanceledEvent, V1TopupCreatedEvent, V1TopupFailedEvent, V1TopupReversedEvent, V1TopupSucceededEvent, V1TransferCreatedEvent, V1TransferReversedEvent, V1TransferUpdatedEvent, V2CoreHealthIssuingAuthorizationRequestErrorsFiringEvent, and V2CoreHealthIssuingAuthorizationRequestErrorsResolvedEvent
    • Add support for thin event V2CoreClaimableSandboxCreatedEvent with related object v2.core.ClaimableSandbox
    • Add support for thin events V2MoneyManagementRecipientVerificationCreatedEvent and V2MoneyManagementRecipientVerificationUpdatedEvent with related object v2.money_management.RecipientVerification
    • Add support for error code account_rate_limit_exceeded on RateLimitError

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 13.0.0 which contains breaking changes. Please review the changelog for 13.0.0 if upgrading from older SDK versions.

  • #1597 Update generated code for beta
    • Add support for attach_cadence method on resource Subscription
    • Add support for billing_cadence on Invoice.CreatePreviewParams, Subscription.CreateParams, Subscription.ModifyParams, and Subscription
    • Add support for billing_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parent
    • Add support for new value billing_cadence_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.type
  • #1584 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, modify, and retrieve 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, modify, and retrieve methods on resource v2.billing.Cadence
    • Add support for new value crypto_wallet on enum V2.Core.Account.Configuration.Recipient.DefaultOutboundDestination.type
    • Add support for profile on V2.Core.Account.Default, v2.core.Account.CreateParamsDefault, and v2.core.Account.ModifyParamsDefault
    • Add support for i_p on V2.Core.Account.Identity.Attestation.DirectorshipDeclaration, V2.Core.Account.Identity.Attestation.OwnershipDeclaration, V2.Core.Account.Identity.Attestation.TermsOfService.Account, V2.Core.Account.Identity.Attestation.TermsOfService.Storer, V2.Core.Account.Identity.Individual.AdditionalTermsOfService.Account, V2.Core.Person.AdditionalTermsOfService.Account, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceStorer, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceStorer, v2.core.Person.CreateParamsAdditionalTermsOfServiceAccount, and v2.core.Person.ModifyParamsAdditionalTermsOfServiceAccount
    • Remove support for ip on V2.Core.Account.Identity.Attestation.DirectorshipDeclaration, V2.Core.Account.Identity.Attestation.OwnershipDeclaration, V2.Core.Account.Identity.Attestation.TermsOfService.Account, V2.Core.Account.Identity.Attestation.TermsOfService.Storer, V2.Core.Account.Identity.Individual.AdditionalTermsOfService.Account, V2.Core.Person.AdditionalTermsOfService.Account, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.CreateParamsIdentityAttestationTermsOfServiceStorer, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceAccount, v2.core.Account.ModifyParamsIdentityAttestationTermsOfServiceStorer, v2.core.Person.CreateParamsAdditionalTermsOfServiceAccount, and v2.core.Person.ModifyParamsAdditionalTermsOfServiceAccount
    • Remove support for doing_business_as, product_description, and url on V2.Core.Account.Identity.BusinessDetail, v2.core.Account.CreateParamsIdentityBusinessDetail, and v2.core.Account.ModifyParamsIdentityBusinessDetail
    • Add support for settlement_currency on V2.MoneyManagement.FinancialAddress
    • Add support for sepa_bank_account on V2.MoneyManagement.FinancialAddress.Credential and V2.MoneyManagement.ReceivedCredit.BankTransfer
    • Add support for new value sepa_bank_account on enum V2.MoneyManagement.FinancialAddress.Credential.type
    • Add support for amount_details and payments_orchestration on V2.Payments.OffSessionPayment and v2.payments.OffSessionPayment.CreateParams
    • Add support for new value authorization_expired on enum V2.Payments.OffSessionPayment.failure_reason
    • Add support for retry_policy on V2.Payments.OffSessionPayment.RetryDetail and v2.payments.OffSessionPayment.CreateParamsRetryDetail
    • Add support for new values heuristic and scheduled on enums V2.Payments.OffSessionPayment.RetryDetail.retry_strategy and v2.payments.OffSessionPayment.CreateParamsRetryDetail.retry_strategy
    • Change type of V2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_duration from literal('five_minutes') to enum('five_minutes'|'none')
    • Change type of V2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_expires_at from DateTime to nullable(DateTime)
    • Add support for new value none on enum V2.MoneyManagement.OutboundPaymentQuote.FxQuote.lock_status
    • Add support for new value crypto_wallet on enums V2.MoneyManagement.PayoutMethod.type, v2.money_management.OutboundSetupIntent.CreateParamsPayoutMethodDatum.type, and v2.money_management.OutboundSetupIntent.ModifyParamsPayoutMethodDatum.type
    • Add support for origin_type on V2.MoneyManagement.ReceivedCredit.BankTransfer
    • Remove support for payment_method_type on V2.MoneyManagement.ReceivedCredit.BankTransfer
    • Add support for mandate_data and payment_method_options on v2.payments.OffSessionPayment.CreateParams
    • Add support for type on v2.money_management.FinancialAddress.CreateParams
    • Remove support for currency on v2.money_management.FinancialAddress.CreateParams
    • Add support for new values financial_addressses.crypto_wallets, holds_currencies.usdc, outbound_payments.crypto_wallets, and outbound_transfers.crypto_wallets on enum EventsV2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent.updated_capability
    • Add support for thin event V2BillingBillSettingUpdatedEvent with related object v2.billing.BillSetting
    • Add support for error type RateLimitError
    • Add support for error code invalid_payout_method_crypto_wallet on InvalidPayoutMethodError
  • #1555 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 minimum_balance_by_currency on BalanceSettings.ModifyParamsPaymentPayout and BalanceSettings.Payment.Payout
    • Remove support for values saturday and sunday from enums BalanceSettings.ModifyParamsPaymentPayoutSchedule.weekly_payout_days and BalanceSettings.Payment.Payout.Schedule.weekly_payout_days
    • Change type of BalanceSettings.ModifyParamsPaymentSettlementTiming.delay_days_override from longInteger to emptyable(longInteger)
    • Change BalanceSettings.ModifyParams.payments to be optional
    • Add support for delay_days_override on BalanceSettings.Payment.SettlementTiming
    • Add support for automatic_tax and invoice_creation on checkout.Session.ModifyParams
    • Add support for unit_label on checkout.Session.ModifyParamsLineItemPriceDatumProductDatum
    • Add support for invoice_settings on checkout.Session.ModifyParamsSubscriptionDatum
    • Change Checkout.Session.CollectedInformation.business_name to be required
    • Add support for intended_submission_method on Dispute.ModifyParams and Dispute
    • Change type of Dispute.SmartDispute.recommended_evidence from string to array(string)
    • Add support for pix on Invoice.CreateParamsPaymentSettingPaymentMethodOption, Invoice.ModifyParamsPaymentSettingPaymentMethodOption, Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.CreateParamsPaymentSettingPaymentMethodOption, Subscription.ModifyParamsPaymentSettingPaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOption
    • Add support for new value pix on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_types
    • Add support for billing_schedules on Invoice.CreatePreviewParamsSubscriptionDetail, Subscription.CreateParams, Subscription.ModifyParams, and Subscription
    • Add support for paypay on PaymentAttemptRecord.PaymentMethodDetail and PaymentRecord.PaymentMethodDetail
    • Add support for wallet on PaymentAttemptRecord.PaymentMethodDetail.Card and PaymentRecord.PaymentMethodDetail.Card
    • Change type of PaymentAttemptRecord.ProcessorDetail.Custom.payment_reference and PaymentRecord.ProcessorDetail.Custom.payment_reference from string to nullable(string)
    • Add support for flexible on QuotePreviewSubscriptionSchedule.BillingMode
    • Add support for billed_until on SubscriptionItem
    • Add support for error codes financial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

Sep 30, 2025

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

  • #1604 Fixed InvoiceLineItem method definition

    • ⚠️ InvoiceLineItem.modify and InvoiceLineItem.modify_async now require invoice and line_item_id as method parameters.
      • Removed InvoiceLineItem.ModifyParam class. Use a typing.dict to type hint instead.
  • #1538 ⚠️ 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 fetch_event() method to retrieve its corresponding event. For events with related objects, there's a fetch_related_object() method that performs the API call and casts the response to the correct type.
    • ⚠️ Rename function StripeClient.parse_thin_event to StripeClient.parse_event_notification 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 related_object property and a fetch_related_object() function. They also have a fetch_() method to retrieve their corresponding stripe.events.*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)
  • #1602 Move V2.Event API resources to V2.Core.Events

    • ⚠️ Move stripe.v2._event and stripe.v2._event_destination to stripe.v2.core._event and stripe.v2.core._event_destination respectively. They now correctly match their API path
  • #1589 Add StripeContext object

    • Add the StripeContext class. Previously, one could only pass a string for stripe_context. You can now use the new class as well.
    • ⚠️ Change EventNotification (formerly known as ThinEvent)'s context property from string to StripeContext
  • #1565 ⚠️ 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.
    • ⚠️ Deeply nested param hashes with no properties no longer have classes generated for them. Instead, they're typed as Dict[str, Any]. Because there were no params, it's unlikely you were using these classes.
  • #1569 Renamed Urllib2Client to UrllibClient

    • ⚠️ Rename http_client.Urllib2Client to http_client.UrllibClient as Python urllib2 was renamed to urllib in Python 3.
  • #1606 ⚠️ drop support for Python 3.6 & clarify version policy

    • Read our new language version support policy
      • ⚠️ In this release, we drop support for Python 3.6
      • Support for Python 3.7 is deprecated and will be removed in the next scheduled major release (March 2026)
  • #1596 ⚠️ Unify resource and service method parameters into one class

    • ⚠️ Resource and service request parameter types have been moved to the top-level and are shared, prepended with their related resource/service
      • For example, _stripe._account.Account.CreateParams and _stripe._account_service.CreateParams have moved to _stripe.params._account_create_params.AccountCreateParams
      • This change only affects users who explicitly refer to params types. No migration is necessary for users otherwise
  • #1572 migrate from setup.py to pyproject.toml

    • ⚠️ The package has swapped from setup.py to pyproject.toml. As a result, we're dropping support for pip < 10.0.0 (released April 2018).
    • Additionally, we're no longer shipping tests or examples in our sdist now, which should offer a small size reduction for the package if installed without the wheel (approx. 2.5MB unzipped)
  • #1570 Don't use mutable default arguments

    • Service methods now correctly set None as the default function argument instead of {}
  • ⚠️ 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.

    client = 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.

  • #1603 ⚠️ Remove deprecated compatibility exports

    • ⚠️ Removed deprecated module shims. They've long been available in the stripe module directly; now that's the only place to import them. Specifically, we removed:
      • stripe.stripe_response
      • stripe.stripe_object
      • stripe.error_object
      • stripe.error
      • stripe.http_client
      • stripe.util
      • stripe.oauth
      • stripe.webhook
      • stripe.multipart_data_generator
      • stripe.request_metrics
      • stripe.api_resources.abstract
      • stripe.api_resources

    To update your code, follow this pattern:

    -from stripe.<MODULE> import SomeClass
    +from stripe import SomeClass
    
    -stripe.<MODULE>.SomeClass
    +stripe.SomeClass
    
    • ⚠️ Removed the FileUpload alias

    To update your code:

    -from stripe import FileUpload
    -from stripe.api_resources import FileUpload
    +from stripe import File
    
    • ⚠️ Removed the io import from stripe._util. If you had code relying on stripe.util.io, you'll need to import the io package directly yourself.
    • added UrllibClient to stripe to make creating your own HTTP client easier.
  • #1567, #1593, #1607, #1605 Update generated code based on incoming API changes in the 2025-09-30.clover API version.

    • ⚠️ Remove support for balance_report and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponent
    • ⚠️ Remove support for values saturday and sunday from enums Account.CreateParamsSettingPayoutSchedule.weekly_payout_days, Account.ModifyParamsSettingPayoutSchedule.weekly_payout_days, and Account.Setting.Payout.Schedule.weekly_payout_days
    • ⚠️ Remove support for iterations on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhase
    • ⚠️ Remove support for link and pay_by_bank on PaymentMethod.ModifyParams
    • ⚠️ Remove support for coupon on Discount, PromotionCode.CreateParams, and PromotionCode. Use Discount.source.coupon, PromotionCode.CreateParams.promotion.coupon, and PromotionCode.promotion.coupon instead.
    • Add support for new value prevented on enum Dispute.status
    • Change Invoice.id to be required.
    • Add support for new resource BalanceSettings
    • Add support for modify and retrieve methods on resource BalanceSettings
    • Add support for new values external_request and unsupported_business_type on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, BankAccount.Requirement.Error.code, Capability.FutureRequirement.Error.code, Capability.Requirement.Error.code, Person.FutureRequirement.Error.code, and Person.Requirement.Error.code
    • Add support for source on Discount
    • Add support for mb_way_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapability
    • Add support for trial_update_behavior on BillingPortal.Configuration.Feature.SubscriptionUpdate, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdate, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdate
    • Add support for mb_way on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodDatum, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.ModifyParamsPaymentMethodDatum
    • Add support for branding_settings and name_collection on Checkout.Session and checkout.Session.CreateParams
    • Add support for excluded_payment_method_types on Checkout.Session, PaymentIntent.ConfirmParams, PaymentIntent.ModifyParams, and checkout.Session.CreateParams
    • Add support for unit_label on Invoice.AddLinesParamsLinePriceDatumProductDatum, Invoice.UpdateLinesParamsLinePriceDatumProductDatum, InvoiceLineItem.ModifyParamsPriceDatumProductDatum, PaymentLink.CreateParamsLineItemPriceDatumProductDatum, and checkout.Session.CreateParamsLineItemPriceDatumProductDatum
    • Add support for alma, billie, and satispay on Checkout.Session.PaymentMethodOption and checkout.Session.CreateParamsPaymentMethodOption
    • Add support for demo_pay on checkout.Session.CreateParamsPaymentMethodOption
    • Add support for capture_method on Checkout.Session.PaymentMethodOption.Affirm, Checkout.Session.PaymentMethodOption.AfterpayClearpay, Checkout.Session.PaymentMethodOption.AmazonPay, Checkout.Session.PaymentMethodOption.Card, Checkout.Session.PaymentMethodOption.Cashapp, Checkout.Session.PaymentMethodOption.Klarna, Checkout.Session.PaymentMethodOption.Link, Checkout.Session.PaymentMethodOption.Mobilepay, Checkout.Session.PaymentMethodOption.RevolutPay, checkout.Session.CreateParamsPaymentMethodOptionAffirm, checkout.Session.CreateParamsPaymentMethodOptionAfterpayClearpay, checkout.Session.CreateParamsPaymentMethodOptionAmazonPay, checkout.Session.CreateParamsPaymentMethodOptionCard, checkout.Session.CreateParamsPaymentMethodOptionCashapp, checkout.Session.CreateParamsPaymentMethodOptionKlarna, checkout.Session.CreateParamsPaymentMethodOptionLink, checkout.Session.CreateParamsPaymentMethodOptionMobilepay, and checkout.Session.CreateParamsPaymentMethodOptionRevolutPay
    • Add support for flexible on Invoice.CreatePreviewParamsScheduleDetailBillingMode, Invoice.CreatePreviewParamsSubscriptionDetailBillingMode, Quote.CreateParamsSubscriptionDatumBillingMode, Quote.SubscriptionDatum.BillingMode, Subscription.BillingMode, Subscription.CreateParamsBillingMode, Subscription.MigrateParamsBillingMode, SubscriptionSchedule.BillingMode, SubscriptionSchedule.CreateParamsBillingMode, and checkout.Session.CreateParamsSubscriptionDatumBillingMode
    • Add support for business_name and individual_name on Checkout.Session.CollectedInformation, Checkout.Session.CustomerDetail, Customer.CreateParams, Customer.ModifyParams, and Customer
    • Add support for new values mb_way on enums ConfirmationToken.CreateParamsPaymentMethodDatum.type, PaymentIntent.ConfirmParamsPaymentMethodDatum.type, PaymentIntent.CreateParamsPaymentMethodDatum.type, PaymentIntent.ModifyParamsPaymentMethodDatum.type, SetupIntent.ConfirmParamsPaymentMethodDatum.type, SetupIntent.CreateParamsPaymentMethodDatum.type, and SetupIntent.ModifyParamsPaymentMethodDatum.type
    • Add support for new values mb_way on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
    • Add support for new values mb_way on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.type
    • Add support for chargeback_loss_reason_code on Dispute.PaymentMethodDetail.Klarna
    • Add support for net_amount and proration_details on InvoiceItem
    • Add support for fraud_disputability_likelihood and risk_assessment on issuing.Authorization.CreateParams
    • Add support for second_line on Issuing.Card
    • Add support for new values mb_way on enums PaymentIntent.CreateParams.excluded_payment_method_types and PaymentIntent.excluded_payment_method_types
    • Add support for fr_meal_voucher_conecs on PaymentMethodConfiguration.CreateParams and PaymentMethodConfiguration.ModifyParams
    • Add support for promotion on PromotionCode.CreateParams and PromotionCode
    • Add support for new values acknowledged and payment_never_settled on enum Review.closed_reason
    • Add support for provider on Tax.Settings.Default
    • Add support for bbpos_wisepad3 on Terminal.Configuration, terminal.Configuration.CreateParams, and terminal.Configuration.ModifyParams
    • Add support for address_kana, address_kanji, display_name_kana, display_name_kanji, and phone on Terminal.Location, terminal.Location.CreateParams, and terminal.Location.ModifyParams
    • Change terminal.Location.CreateParams.address to be optional
    • Change terminal.Location.CreateParams.display_name to be optional
    • Add support for new value 2025-09-30.clover on enum WebhookEndpoint.CreateParams.api_version
    • Add support for error codes financial_connections_account_pending_account_numbers and financial_connections_account_unavailable_account_numbers on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError

See the changelog for more details.

Sep 17, 2025
  • #1571 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.

Sep 5, 2025
  • #1563 fix: Paginate backwards if starting_after == None
    • Addresses an issue where List iteration would be forwards when starting_after was set to None but backwards if it was not set at all. Now, it will paginate backwards in both cases.

See the changelog for more details.

Aug 27, 2025
  • #1556 Use the right API version 2025-08-27.preview
  • #1552 Update generated code for private-preview
    • Add support for attach_cadence method on resource Subscription
    • Add support for currency and external_customer_id on Billing.AlertTriggered
    • Add support for custom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.Balance.AvailableBalance, Billing.CreditBalanceSummary.Balance.LedgerBalance, Billing.CreditBalanceTransaction.Credit.Amount, Billing.CreditBalanceTransaction.Debit.Amount, Billing.CreditGrant.Amount, and billing.CreditGrant.CreateParamsAmount
    • Add support for customer on billing.Alert.ListParams
    • Change type of Billing.Alert.alert_type, billing.Alert.CreateParams.alert_type, and billing.Alert.ListParams.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')
    • Add support for credit_balance_threshold on Billing.Alert and billing.Alert.CreateParams
    • Add support for billable_items on Billing.CreditGrant.ApplicabilityConfig.Scope, billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope, and billing.CreditGrant.CreateParamsApplicabilityConfigScope
    • Change type of Billing.CreditBalanceSummary.Balance.AvailableBalance.type, Billing.CreditBalanceSummary.Balance.LedgerBalance.type, Billing.CreditBalanceTransaction.Credit.Amount.type, Billing.CreditBalanceTransaction.Debit.Amount.type, Billing.CreditGrant.Amount.type, and billing.CreditGrant.CreateParamsAmount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')
    • Add support for license_fee_subscription_details and rate_card_subscription_details 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 license_fee_details and rate_card_rate_details 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 billing_cadence on Invoice.CreatePreviewParams, Subscription.CreateParams, and Subscription
    • Add support for billing_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parent
    • Add support for new value billing_cadence_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.type
    • Add support for new values license_fee_subscription_details and rate_card_subscription_details on enum InvoiceLineItem.Parent.type
    • 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, modify, and retrieve 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 resource v2.core.ClaimableSandbox
    • Add support for cancel, create, list, modify, and retrieve methods on resources v2.billing.Cadence and v2.billing.RateCardSubscription
    • Add support for create, list, modify, and retrieve 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, modify, and retrieve 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 RateLimitError

See the changelog for more details.

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

  • #1542 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.Account.ModifyParamsConfigurationCustomer, v2.core.Account.ModifyParamsConfigurationMerchant, v2.core.Account.ModifyParamsConfigurationRecipient, and v2.core.Account.ModifyParamsConfigurationStorer
    • 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.Account.Identity.BusinessDetail.IdNumber.type, v2.core.Account.CreateParamsIdentityBusinessDetailIdNumber.type, and v2.core.Account.ModifyParamsIdentityBusinessDetailIdNumber.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.Account.Identity.Individual.IdNumber.type, V2.Core.Person.IdNumber.type, v2.core.Account.CreateParamsIdentityIndividualIdNumber.type, v2.core.Account.ModifyParamsIdentityIndividualIdNumber.type, v2.core.Person.CreateParamsIdNumber.type, and v2.core.Person.ModifyParamsIdNumber.type
    • Change type of Billing.AlertTriggered.value from longInteger to decimal_string
    • Add support for display_name on V2.MoneyManagement.FinancialAccount and v2.money_management.FinancialAccount.CreateParams
    • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.TransactionDetail.category
    • Add support for currency_conversion on V2.MoneyManagement.Transaction.Flow and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow
    • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.Flow.type and V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.type
    • Add support for payments on BalanceSettings.ModifyParams and BalanceSettings
    • Remove support for debit_negative_balances, payouts, and settlement_timing on BalanceSettings.ModifyParams and BalanceSettings
    • Add support for mandate on Charge.PaymentMethodDetail.Pix, PaymentAttemptRecord.PaymentMethodDetail.Pix, and PaymentRecord.PaymentMethodDetail.Pix
    • Add support for coupon_data on checkout.Session.CreateParamsDiscount
    • Add support for mandate_options on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.ConfirmParamsPaymentMethodOptionPix, PaymentIntent.CreateParamsPaymentMethodOptionPix, PaymentIntent.ModifyParamsPaymentMethodOptionPix, PaymentIntent.PaymentMethodOption.Pix, and checkout.Session.CreateParamsPaymentMethodOptionPix
    • Change type of Checkout.Session.PaymentMethodOption.Pix.setup_future_usage, PaymentIntent.ConfirmParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionPix.setup_future_usage, PaymentIntent.PaymentMethodOption.Pix.setup_future_usage, and checkout.Session.CreateParamsPaymentMethodOptionPix.setup_future_usage from literal('none') to enum('none'|'off_session')
    • Add support for amount on Mandate.MultiUse, PaymentAttemptRecord, and PaymentRecord
    • Add support for currency on Mandate.MultiUse
    • Add support for pix on Mandate.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.ConfirmParamsPaymentMethodOption, SetupIntent.CreateParamsPaymentMethodOption, SetupIntent.ModifyParamsPaymentMethodOption, and SetupIntent.PaymentMethodOption
    • Add support for limit on PaymentAttemptRecord.ListParams
    • Add support for amount_authorized, amount_refunded, and application on PaymentAttemptRecord and PaymentRecord
    • Add support for processor_details on PaymentAttemptRecord, PaymentRecord.ReportPaymentParams, and PaymentRecord
    • Remove support for payment_reference on PaymentAttemptRecord, PaymentRecord.ReportPaymentParams, and PaymentRecord
    • Add support for installments on PaymentAttemptRecord.PaymentMethodDetail.Alma and PaymentRecord.PaymentMethodDetail.Alma
    • Add support for transaction_id on PaymentAttemptRecord.PaymentMethodDetail.Alma, PaymentAttemptRecord.PaymentMethodDetail.AmazonPay, PaymentAttemptRecord.PaymentMethodDetail.Billie, PaymentAttemptRecord.PaymentMethodDetail.KakaoPay, PaymentAttemptRecord.PaymentMethodDetail.KrCard, PaymentAttemptRecord.PaymentMethodDetail.NaverPay, PaymentAttemptRecord.PaymentMethodDetail.Payco, PaymentAttemptRecord.PaymentMethodDetail.RevolutPay, PaymentAttemptRecord.PaymentMethodDetail.SamsungPay, PaymentAttemptRecord.PaymentMethodDetail.Satispay, PaymentRecord.PaymentMethodDetail.Alma, PaymentRecord.PaymentMethodDetail.AmazonPay, PaymentRecord.PaymentMethodDetail.Billie, PaymentRecord.PaymentMethodDetail.KakaoPay, PaymentRecord.PaymentMethodDetail.KrCard, PaymentRecord.PaymentMethodDetail.NaverPay, PaymentRecord.PaymentMethodDetail.Payco, PaymentRecord.PaymentMethodDetail.RevolutPay, PaymentRecord.PaymentMethodDetail.SamsungPay, and PaymentRecord.PaymentMethodDetail.Satispay
    • Add support for location and reader on PaymentAttemptRecord.PaymentMethodDetail.Paynow and PaymentRecord.PaymentMethodDetail.Paynow
    • Add support for latest_active_mandate on PaymentMethod
    • Change Payout.payout_method to be required
    • Add support for metadata and period on QuotePreviewSubscriptionSchedule.Phase.AddInvoiceItem
    • Add support for pix_display_qr_code on SetupIntent.NextAction
    • Add support for reader_security on Terminal.Configuration, terminal.Configuration.CreateParams, and terminal.Configuration.ModifyParams
    • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

  • #1554 Add section on private preview SDKs in readme
  • #1544 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
    • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponent
    • Add support for name on BillingPortal.Configuration, billing_portal.Configuration.CreateParams, and billing_portal.Configuration.ModifyParams
    • Add support for installments on Charge.PaymentMethodDetail.Alma
    • Add support for transaction_id on Charge.PaymentMethodDetail.Alma, Charge.PaymentMethodDetail.AmazonPay, Charge.PaymentMethodDetail.Billie, Charge.PaymentMethodDetail.KakaoPay, Charge.PaymentMethodDetail.KrCard, Charge.PaymentMethodDetail.NaverPay, Charge.PaymentMethodDetail.Payco, Charge.PaymentMethodDetail.RevolutPay, Charge.PaymentMethodDetail.SamsungPay, and Charge.PaymentMethodDetail.Satispay
    • Add support for location and reader on Charge.PaymentMethodDetail.Paynow
    • Add support for amount_includes_iof on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.ConfirmParamsPaymentMethodOptionPix, PaymentIntent.CreateParamsPaymentMethodOptionPix, PaymentIntent.ModifyParamsPaymentMethodOptionPix, PaymentIntent.PaymentMethodOption.Pix, and checkout.Session.CreateParamsPaymentMethodOptionPix
    • Add support for new values block and resolution on enum Dispute.PaymentMethodDetail.Card.case_type
    • Add support for new value terminal_android_apk on enums File.ListParams.purpose and File.purpose
    • Add support for new value terminal_android_apk on enum File.CreateParams.purpose
    • Add support for metadata and period on Invoice.CreatePreviewParamsScheduleDetailPhaseAddInvoiceItem, Subscription.CreateParamsAddInvoiceItem, Subscription.ModifyParamsAddInvoiceItem, SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem, SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem, and SubscriptionSchedule.Phase.AddInvoiceItem
    • Add support for exp_month and exp_year on issuing.Card.CreateParams
    • Add support for excluded_payment_method_types on PaymentIntent.CreateParams and PaymentIntent
    • Add support for payout_method on Payout.CreateParams and Payout
    • Add support for mxn on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTipping
    • Add support for card on terminal.Reader.PresentPaymentMethodParams
    • Add support for new value card on enum terminal.Reader.PresentPaymentMethodParams.type
    • Add support for new value 2025-08-27.basil on enum WebhookEndpoint.CreateParams.api_version
    • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
  • #1553 Import available http libraries more efficiently
  • #1549 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.
    client = 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.

Aug 8, 2025
  • #1545 Bring back invoice payments APIs that were missing in the public preview SDKs
    • Add support for new resource InvoicePayment
    • Add support for list and retrieve methods on resource InvoicePayment

See the changelog for more details.

Jul 30, 2025

This release changes the pinned API version to 2025-07-30.preview.

  • #1535 Update generated code for beta
    • Add support for new resources billing.MeterUsageRow, billing.MeterUsage, and terminal.OnboardingLink
    • Add support for retrieve method on resource billing.MeterUsage
    • Add support for create method on resource terminal.OnboardingLink
    • Add support for monthly_payout_days and weekly_payout_days on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Schedule
    • Remove support for monthly_anchor and weekly_anchor on BalanceSettings.ModifyParamsPayoutSchedule and BalanceSettings.Payout.Schedule
    • Add support for delay_days_override on BalanceSettings.ModifyParamsSettlementTiming
    • Remove support for delay_days on BalanceSettings.ModifyParamsSettlementTiming
    • Add support for update_discounts on checkout.Session.CreateParamsPermission
    • Add support for discounts and subscription_data on checkout.Session.ModifyParams
    • Add support for smart_disputes on Dispute
    • Add support for upi on Invoice.CreateParamsPaymentSettingPaymentMethodOption, Invoice.ModifyParamsPaymentSettingPaymentMethodOption, Invoice.PaymentSetting.PaymentMethodOption, QuotePreviewInvoice.PaymentSetting.PaymentMethodOption, Subscription.CreateParamsPaymentSettingPaymentMethodOption, Subscription.ModifyParamsPaymentSettingPaymentMethodOption, and Subscription.PaymentSetting.PaymentMethodOption
    • Add support for new value upi on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_types
    • Add support for transaction_id on PaymentAttemptRecord.PaymentMethodDetail.Cashapp and PaymentRecord.PaymentMethodDetail.Cashapp
    • Add support for amount_details on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.IncrementAuthorizationParams, and PaymentIntent.ModifyParams
    • Add support for payment_details on PaymentIntent.IncrementAuthorizationParams
    • Add support for storer on V2.Core.Account.Identity.Attestation.TermsOfService, v2.core.Account.CreateParamsIdentityAttestationTermsOfService, and v2.core.Account.ModifyParamsIdentityAttestationTermsOfService
    • Add support for collection_options on V2.Core.AccountLink.UseCase.AccountOnboarding, V2.Core.AccountLink.UseCase.AccountUpdate, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdate
    • Change type of V2.Core.AccountLink.UseCase.AccountOnboarding.configurations, V2.Core.AccountLink.UseCase.AccountUpdate.configurations, v2.core.AccountLink.CreateParamsUseCaseAccountOnboarding.configurations, and v2.core.AccountLink.CreateParamsUseCaseAccountUpdate.configurations from literal('recipient') to enum('customer'|'merchant'|'recipient'|'storer')
    • Add support for bank_account_type on V2.MoneyManagement.PayoutMethod.BankAccount
    • Add support for thin event V2CoreAccountLinkReturnedEvent
    • Add support for thin event V2MoneyManagementPayoutMethodUpdatedEvent with related object v2.money_management.PayoutMethod
    • Remove support for thin event V2CoreAccountLinkCompletedEvent
    • Remove support for thin event V2OffSessionPaymentRequiresCaptureEvent with related object v2.payments.OffSessionPayment

See the changelog for more details.

Latest
v15.1.0a4
Tracking Since
Sep 21, 2023
Last fetched Apr 19, 2026