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.

v13.0.1

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

  • Make newly combined nested params classes importable, as raised in #1625
    • For example, from stripe.params.checkout import SessionCreateParamsDiscount would raise an error. Now it is valid

• #1620 Remove manual promotion code test

• #1619 Update param in deprecation docs link

See the changelog for more details.

v13.0.0

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.PaymentMethodOp...

v13.1.0b1

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.

v13.1.0a1

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, `V1SubscriptionSched...

v12.6.0a2

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

v12.5.1

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

v12.6.0b1

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.