v13.1.1

• #1660 Fix stripe-context header not being included in paged list requests

See the changelog for more details.

v13.2.0a2

• #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.

v13.2.0b1

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.

v13.2.0a1

• #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.

v13.1.0

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.

v13.1.0a4

• #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.

v13.1.0a3

• #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.

v13.1.0a2

• #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.

v13.1.2b1

• Contains bug fixes and improvements from v13.0.1.

See the changelog for more details.

v13.1.1a1

• Contains bug fixes and improvements from v13.0.1.

See the changelog for more details.