From 8707817c9a2887ac6dfcf62ee1506467c54e9624 Mon Sep 17 00:00:00 2001 From: jar Date: Wed, 16 Sep 2026 16:24:44 +0000 Subject: [PATCH 1/8] Add changelog for positional-only path params Committed-By-Agent: goose Orbit-Session-Id: b43474a2-c3e8-416d-8a32-5bb00c84fef0 --- ...jar_make-service-path-params-positional-only.change.md | 8 ++++++++ 1 file changed, 8 insertions(+) create mode 100644 .hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md diff --git a/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md new file mode 100644 index 000000000..ddeb0fd6e --- /dev/null +++ b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md @@ -0,0 +1,8 @@ +--- +title: Make path parameters positional-only in all service methods +semver_level: major +jira_tickets_closed: +- DEVSDK-3212 +--- + +Path parameters must now be passed positionally. Passing them by keyword is no longer supported. From 674352c3462c71e378c3489c0c3b5f8572bf381a Mon Sep 17 00:00:00 2001 From: jar Date: Wed, 16 Sep 2026 16:25:22 +0000 Subject: [PATCH 2/8] Link changelog to stripe-python PR Committed-By-Agent: goose Orbit-Session-Id: b43474a2-c3e8-416d-8a32-5bb00c84fef0 --- ...-09-16_jar_make-service-path-params-positional-only.change.md | 1 + 1 file changed, 1 insertion(+) diff --git a/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md index ddeb0fd6e..98bc279d4 100644 --- a/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md +++ b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md @@ -1,5 +1,6 @@ --- title: Make path parameters positional-only in all service methods +pr_url: https://github.com/stripe/stripe-python/pull/1910 semver_level: major jira_tickets_closed: - DEVSDK-3212 From aab83dc2585c5e4037bb6f94feadcee39a4c8530 Mon Sep 17 00:00:00 2001 From: jar Date: Wed, 16 Sep 2026 16:46:24 +0000 Subject: [PATCH 3/8] Add v16 positional-only path params migration guide Committed-By-Agent: goose Orbit-Session-Id: b43474a2-c3e8-416d-8a32-5bb00c84fef0 --- .hark/migration-guides/16.0.0.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 .hark/migration-guides/16.0.0.md diff --git a/.hark/migration-guides/16.0.0.md b/.hark/migration-guides/16.0.0.md new file mode 100644 index 000000000..a4516d13a --- /dev/null +++ b/.hark/migration-guides/16.0.0.md @@ -0,0 +1,18 @@ +# Migration guide for v16 +## Positional-only path parameters in service methods + +Path parameters in all service methods must now be passed positionally instead of by keyword. This prevents parameter names derived from the API specification from becoming part of the public interface. + +For example, a customer ID that was previously accepted as a keyword argument: + +```python +customer = client.v1.customers.retrieve(customer="cus_123") +``` + +must now be passed positionally: + +```python +customer = client.v1.customers.retrieve("cus_123") +``` + +Update calls to service methods, including async service methods, to pass path parameters before any request parameters or options. Resource methods are unaffected by this change. From c2d50603b649de44d6c6c12205d7936c51216a08 Mon Sep 17 00:00:00 2001 From: Jesse Rosalia Date: Wed, 16 Sep 2026 09:57:48 -0700 Subject: [PATCH 4/8] renamed change files that end in _2 to comply with new hark name allowable characters --- ...> 2025-12-04_stripe-openapi_update-generated-code-2.change.md} | 0 ...> 2026-03-25_stripe-openapi_update-generated-code-2.change.md} | 0 ...> 2026-04-15_stripe-openapi_update-generated-code-2.change.md} | 0 3 files changed, 0 insertions(+), 0 deletions(-) rename .hark/changes/{2025-12-04_stripe-openapi_update-generated-code_2.change.md => 2025-12-04_stripe-openapi_update-generated-code-2.change.md} (100%) rename .hark/changes/{2026-03-25_stripe-openapi_update-generated-code_2.change.md => 2026-03-25_stripe-openapi_update-generated-code-2.change.md} (100%) rename .hark/changes/{2026-04-15_stripe-openapi_update-generated-code_2.change.md => 2026-04-15_stripe-openapi_update-generated-code-2.change.md} (100%) diff --git a/.hark/changes/2025-12-04_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md similarity index 100% rename from .hark/changes/2025-12-04_stripe-openapi_update-generated-code_2.change.md rename to .hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md diff --git a/.hark/changes/2026-03-25_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md similarity index 100% rename from .hark/changes/2026-03-25_stripe-openapi_update-generated-code_2.change.md rename to .hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md diff --git a/.hark/changes/2026-04-15_stripe-openapi_update-generated-code_2.change.md b/.hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md similarity index 100% rename from .hark/changes/2026-04-15_stripe-openapi_update-generated-code_2.change.md rename to .hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md From a1c4dcd6a176673fad2875829b8d2b8d8968212b Mon Sep 17 00:00:00 2001 From: Jesse Rosalia Date: Wed, 16 Sep 2026 10:15:15 -0700 Subject: [PATCH 5/8] removed migration guide and removed jira ticket from change file --- ...rvice-path-params-positional-only.change.md | 4 +--- .hark/migration-guides/16.0.0.md | 18 ------------------ 2 files changed, 1 insertion(+), 21 deletions(-) delete mode 100644 .hark/migration-guides/16.0.0.md diff --git a/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md index 98bc279d4..1b290b1cb 100644 --- a/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md +++ b/.hark/changes/2026-09-16_jar_make-service-path-params-positional-only.change.md @@ -2,8 +2,6 @@ title: Make path parameters positional-only in all service methods pr_url: https://github.com/stripe/stripe-python/pull/1910 semver_level: major -jira_tickets_closed: -- DEVSDK-3212 --- -Path parameters must now be passed positionally. Passing them by keyword is no longer supported. +Path parameters must now be passed positionally to service methods. Passing them by keyword is no longer supported. Resource methods are unaffected by this change. diff --git a/.hark/migration-guides/16.0.0.md b/.hark/migration-guides/16.0.0.md deleted file mode 100644 index a4516d13a..000000000 --- a/.hark/migration-guides/16.0.0.md +++ /dev/null @@ -1,18 +0,0 @@ -# Migration guide for v16 -## Positional-only path parameters in service methods - -Path parameters in all service methods must now be passed positionally instead of by keyword. This prevents parameter names derived from the API specification from becoming part of the public interface. - -For example, a customer ID that was previously accepted as a keyword argument: - -```python -customer = client.v1.customers.retrieve(customer="cus_123") -``` - -must now be passed positionally: - -```python -customer = client.v1.customers.retrieve("cus_123") -``` - -Update calls to service methods, including async service methods, to pass path parameters before any request parameters or options. Resource methods are unaffected by this change. From fa652ce464f0e4346c6e5de9db927cfac660d491 Mon Sep 17 00:00:00 2001 From: jar-stripe Date: Wed, 16 Sep 2026 14:05:35 -0700 Subject: [PATCH 6/8] Delete .hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md --- ...tripe-openapi_update-generated-code-2.change.md | 14 -------------- 1 file changed, 14 deletions(-) delete mode 100644 .hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md diff --git a/.hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md b/.hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md deleted file mode 100644 index c0eb2e971..000000000 --- a/.hark/changes/2025-12-04_stripe-openapi_update-generated-code-2.change.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Update generated code for private-preview -pr_url: https://github.com/stripe/stripe-python/pull/1686 -is_stripe_api_change: true -released_in_version: 14.1.0a4 ---- - -* Add support for `check_scanning` on `AccountSession.Component` -* Add support for `client` on `V2.Core.Event.Reason.Request` -* Add support for `stripe_balance_payment` on `V2.MoneyManagement.ReceivedCredit` and `V2.MoneyManagement.ReceivedDebit` -* Add support for new value `stripe_balance_payment` on enum `V2.MoneyManagement.ReceivedCredit.type` -* Add support for `balance_transfer` on `V2.MoneyManagement.ReceivedDebit` -* Add support for new values `balance_transfer` and `stripe_balance_payment` on enum `V2.MoneyManagement.ReceivedDebit.type` -* Add support for `include` on `v2.core.EventListParams` and `v2.core.EventRetrieveParams` From 01a24b91740a51055d45dbbbb100c3a3936c59a5 Mon Sep 17 00:00:00 2001 From: jar-stripe Date: Wed, 16 Sep 2026 14:05:50 -0700 Subject: [PATCH 7/8] Delete .hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md --- ...-openapi_update-generated-code-2.change.md | 42 ------------------- 1 file changed, 42 deletions(-) delete mode 100644 .hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md diff --git a/.hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md b/.hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md deleted file mode 100644 index 05285a1e5..000000000 --- a/.hark/changes/2026-03-25_stripe-openapi_update-generated-code-2.change.md +++ /dev/null @@ -1,42 +0,0 @@ ---- -title: Update generated code for private-preview -pr_url: https://github.com/stripe/stripe-python/pull/1763 -semver_level: major -is_stripe_api_change: true -released_in_version: 15.1.0a1 ---- - -* Add support for new resource `v2.core.AccountEvaluation` -* ⚠️ Remove support for resources `v2.billing.LicenseFeeSubscription` and `v2.billing.PricingPlanSubscriptionComponents` -* Add support for `create` method on resource `v2.core.AccountEvaluation` -* ⚠️ Remove support for `retrieve` method on resources `v2.billing.LicenseFeeSubscription` and `v2.billing.PricingPlanSubscriptionComponents` -* Add support for `modify_rates` method on resource `v2.billing.RateCard` -* Add support for `remove_discounts` method on resource `v2.billing.PricingPlanSubscription` -* ⚠️ Add support for new value `eg_bank_account` on enum `V2.Account.Configuration.RecipientDatum.DefaultOutboundDestination.type` -* Add support for `invoice_resources` on `V2.Billing.Intent` -* Add support for `amount_due` and `customer_balance_applied` on `V2.Billing.Intent.AmountDetail` -* Add support for `expires_at` on `V2.Billing.Intent.StatusTransition` -* Add support for `discount` on `V2.Billing.IntentAction.Apply` and `v2.billing.IntentCreateParamsActionApply` -* Add support for `timestamp` on `V2.Billing.IntentAction.Apply.EffectiveAt` and `v2.billing.IntentCreateParamsActionApplyEffectiveAt` -* ⚠️ Add support for new values `current_billing_period_start` and `timestamp` on enums `V2.Billing.IntentAction.Apply.EffectiveAt.type` and `v2.billing.IntentCreateParamsActionApplyEffectiveAt.type` -* ⚠️ Add support for new value `discount` on enums `V2.Billing.IntentAction.Apply.type` and `v2.billing.IntentCreateParamsActionApply.type` -* ⚠️ Change type of `V2.Billing.IntentAction.Deactivate.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type`, `V2.Billing.IntentAction.Modify.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type`, `V2.Billing.IntentAction.Subscribe.PricingPlanSubscriptionDetail.Override.PartialPeriodBehavior.type`, `v2.billing.IntentCreateParamsActionDeactivatePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type`, `v2.billing.IntentCreateParamsActionModifyPricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type`, and `v2.billing.IntentCreateParamsActionSubscribePricingPlanSubscriptionDetailOverridePartialPeriodBehavior.type` from `literal('license_fee')` to `enum('license_fee'|'recurring_credit_grant')` -* Add support for `service_cycle` on `V2.Billing.LicenseFee` and `V2.Billing.RateCard` -* ⚠️ Remove support for `latest_version` on `V2.Billing.LicenseFee`, `V2.Billing.PricingPlan`, and `V2.Billing.RateCard` -* ⚠️ Remove support for `service_interval_count` and `service_interval` on `V2.Billing.LicenseFee` and `V2.Billing.RateCard` -* ⚠️ Change type of `V2.Billing.LicenseFee.TransformQuantity.divide_by`, `V2.Billing.LicenseFeeVersion.TransformQuantity.divide_by`, `V2.Billing.RateCardRate.TransformQuantity.divide_by`, `v2.billing.LicenseFeeCreateParamsTransformQuantity.divide_by`, `v2.billing.LicenseFeeModifyParamsTransformQuantity.divide_by`, and `v2.billing.RateCardRateCreateParamsTransformQuantity.divide_by` from `longInteger` to `int64_string` -* Add support for `discount_details` and `pricing_plan_component_details` on `V2.Billing.PricingPlanSubscription` -* ⚠️ Add support for new value `crypto_wallets` on enums `V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability` and `V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability` -* ⚠️ Remove support for value `crypto` from enums `V2.Core.Account.FutureRequirement.Entry.Impact.RestrictsCapability.capability` and `V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability` -* Add support for `balance_by_funds_type` on `V2.MoneyManagement.FinancialAccount.Payment` -* ⚠️ Add support for new value `next_day_payout_fee` on enum `V2.MoneyManagement.OutboundPaymentQuote.EstimatedFee.type` -* Add support for `treasury_transaction_entry` on `V2.MoneyManagement.TransactionEntry` -* Add support for `treasury_credit_reversal`, `treasury_debit_reversal`, `treasury_inbound_transfer`, `treasury_issuing_authorization`, `treasury_outbound_payment`, `treasury_outbound_transfer`, `treasury_received_credit`, and `treasury_received_debit` on `V2.MoneyManagement.Transaction.Flow` and `V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow` -* ⚠️ Add support for new values `treasury_credit_reversal`, `treasury_debit_reversal`, `treasury_inbound_transfer`, `treasury_issuing_authorization`, `treasury_other`, `treasury_outbound_payment`, `treasury_outbound_transfer`, `treasury_received_credit`, and `treasury_received_debit` on enums `V2.MoneyManagement.Transaction.Flow.type` and `V2.MoneyManagement.TransactionEntry.TransactionDetail.Flow.type` -* Add support for `treasury_transaction` on `V2.MoneyManagement.Transaction` -* ⚠️ Add support for new value `no_valid_payment_method` on enum `V2.Payments.OffSessionPayment.failure_reason` -* Add support for `metadata` on `V2.Payments.SettlementAllocationIntentSplit` -* ⚠️ Change type of `V2.Reporting.ReportRun.Result.File.size` from `longInteger` to `int64_string` -* Add support for `statement_descriptor` on `v2.money_management.OutboundPaymentCreateParams` and `v2.money_management.OutboundTransferCreateParams` -* Add support for `include` on `v2.billing.IntentCreateParams`, `v2.billing.IntentReserveParams`, `v2.billing.PricingPlanSubscriptionListParams`, `v2.billing.PricingPlanSubscriptionRetrieveParams`, `v2.money_management.FinancialAccountListParams`, and `v2.money_management.FinancialAccountRetrieveParams` -* Add support for event notifications `V1AccountSignalsIncludingDelinquencyCreatedEvent`, `V2CoreAccountSignalsFraudulentWebsiteReadyEvent`, and `V2SignalsAccountSignalFraudulentMerchantReadyEvent` From 3cdc147347795f58718325136f3ebc9b01da6236 Mon Sep 17 00:00:00 2001 From: jar-stripe Date: Wed, 16 Sep 2026 14:06:05 -0700 Subject: [PATCH 8/8] Delete .hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md --- ...-openapi_update-generated-code-2.change.md | 32 ------------------- 1 file changed, 32 deletions(-) delete mode 100644 .hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md diff --git a/.hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md b/.hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md deleted file mode 100644 index 9f0298bb5..000000000 --- a/.hark/changes/2026-04-15_stripe-openapi_update-generated-code-2.change.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Update generated code for private-preview -pr_url: https://github.com/stripe/stripe-python/pull/1791 -semver_level: major -is_stripe_api_change: true -released_in_version: 15.1.0a4 ---- - -* Add support for new resources `v2.core.WorkflowRun` and `v2.core.Workflow` -* Add support for `report_authorized` method on resource `PaymentAttemptRecord` -* Add support for `list` and `retrieve` methods on resource `v2.core.WorkflowRun` -* Add support for `invoke`, `list`, and `retrieve` methods on resource `v2.core.Workflow` -* Add support for `next_action` and `status` on `SharedPayment.IssuedToken` -* ⚠️ Remove support for `network_id` on `SharedPayment.IssuedToken.SellerDetail` -* Add support for `bills` on `AccountSession.Component` -* Add support for `settlement_currencies` on `BalanceSettings.Payment` and `BalanceSettingsModifyParamsPayment` -* Add support for `default_settlement_currency` on `BalanceSettings.Payment` -* Add support for `account_funding` on `Charge.PaymentMethodDetail.Card` -* Add support for `automatic_surcharge` on `Checkout.Session`, `PaymentLinkCreateParams`, `PaymentLink`, and `checkout.SessionCreateParams` -* Add support for `bizum` on `Checkout.Session.PaymentMethodOption` and `checkout.SessionCreateParamsPaymentMethodOption` -* Add support for `surcharge_cost` on `Checkout.Session` -* Add support for `amount_surcharge` on `Checkout.Session.TotalDetail` -* Add support for `shared_payment_granted_token` on `ConfirmationTokenCreateParamsPaymentMethodDatum`, `PaymentIntentConfirmParamsPaymentMethodDatum`, `PaymentIntentCreateParamsPaymentMethodDatum`, `PaymentIntentModifyParamsPaymentMethodDatum`, `SetupIntentConfirmParamsPaymentMethodDatum`, `SetupIntentCreateParamsPaymentMethodDatum`, and `SetupIntentModifyParamsPaymentMethodDatum` -* Add support for new value `email` on enums `identity.VerificationReportListParams.type`, `identity.VerificationSessionCreateParams.type`, and `identity.VerificationSessionModifyParams.type` -* Add support for `details` on `Identity.VerificationReport.Email` -* ⚠️ Add support for new value `email` on enums `Identity.VerificationReport.type` and `Identity.VerificationSession.type` -* Add support for `confirm` on `identity.VerificationSessionCreateParams` and `identity.VerificationSessionModifyParams` -* Add support for `subscription` on `InvoiceItem.Parent.ScheduleDetail` -* ⚠️ Remove support for `shared_payment_granted_token` on `PaymentIntentConfirmParams` and `PaymentIntentCreateParams` -* Add support for `money_services` on `PaymentIntent.PaymentDetail` -* ⚠️ Remove support for `external_reference` on `Plan` -* Change `SharedPayment.GrantedToken.PaymentMethodDetail.billing_details` to be required