stripe · xavdid · Sep 14, 2026 · Sep 11, 2026 · Sep 11, 2026 · Sep 11, 2026
@@ -10,14 +10,6 @@ List out the key changes made in this PR, e.g.
 ### See Also
 <!-- Include any links or additional information that help explain this change. -->
 
-## Changelog
-<!-- Heads up! This section should include entries for any user-facing changes.
-Either fill it out or remove it if there are no entries to report.
+## Configuration
 
-List changes that affect end users, e.g.
-- Fixes crash when calling `foo.bar()` with null argument
-- Adds support for new `baz` parameter on `PaymentIntent` creation
-
-List breaking changes first with a ⚠️ prefix, e.g.
-- ⚠️ Removes deprecated `legacy_method` function
--->
+- [ ] `skip-changefile`: This PR is not a user-facing change, so there's no changefile.
@@ -0,0 +1,21 @@
+name: Changelog
+
+on:
+  pull_request:
+    # opened, synchronize and reopened are the defaults; `edited` is what makes this
+    # re-run when someone toggles an opt-out box in the description
+    types: [opened, synchronize, reopened, edited]
+
+permissions: {}
+
+jobs:
+  changefile:
+    runs-on: ubuntu-24.04
+    permissions:
+      contents: read # check out the repo so `hark validate` can read .hark/
+      pull-requests: read # list the files this pull request adds
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: stripe/hark/actions/checks@master
@@ -6,3 +6,4 @@ rules:
     config:
       policies:
         "stripe/openapi/*": ref-pin
+        "stripe/hark/*": ref-pin
@@ -0,0 +1,51 @@
+---
+title: Update generated code for private-preview
+pr_url: https://github.com/stripe/stripe-python/pull/1552
+is_stripe_api_change: true
+released_in_version: 12.6.0a1
+---
+
+* 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`
@@ -0,0 +1,5 @@
+---
+title: Use the right API version 2025-08-27.preview
+pr_url: https://github.com/stripe/stripe-python/pull/1556
+released_in_version: 12.6.0a1
+---
@@ -0,0 +1,19 @@
+---
+title: generate private-preview SDK w/ mid Sept changes
+pr_url: https://github.com/stripe/stripe-python/pull/1571
+is_stripe_api_change: true
+released_in_version: 12.6.0a2
+---
+
+* Add support for `retrieve` method on resource `v2.core.ClaimableSandbox`
+* Add support for `month_of_year` on `V2.Billing.Cadence.BillingCycle.Month` and `v2.billing.Cadence.CreateParamsBillingCycleMonth`
+* 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.IntentAction.Deactivate.EffectiveAt.type` and `v2.billing.Intent.CreateParamsActionDeactivateEffectiveAt.type`
+* Add support for `will_activate_at` and `will_cancel_at` on `V2.Billing.PricingPlanSubscription.ServicingStatusTransition` and `V2.Billing.RateCardSubscription.ServicingStatusTransition`
+* Add support for `category` and `priority` on `V2.Billing.ServiceAction.CreditGrantPerTenant`, `V2.Billing.ServiceAction.CreditGrant`, `v2.billing.ServiceAction.CreateParamsCreditGrantPerTenant`, and `v2.billing.ServiceAction.CreateParamsCreditGrant`
+* Change `v2.billing.LicenseFee.ModifyParams.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`