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.

v12.6.0a1

• #1556 Use the right API version 2025-08-27.preview
• #1552 Update generated code for private-preview
  • Add support for attach_cadence method on resource Subscription
  • Add support for currency and external_customer_id on Billing.AlertTriggered
  • Add support for custom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.Balance.AvailableBalance, Billing.CreditBalanceSummary.Balance.LedgerBalance, Billing.CreditBalanceTransaction.Credit.Amount, Billing.CreditBalanceTransaction.Debit.Amount, Billing.CreditGrant.Amount, and billing.CreditGrant.CreateParamsAmount
  • Add support for customer on billing.Alert.ListParams
  • Change type of Billing.Alert.alert_type, billing.Alert.CreateParams.alert_type, and billing.Alert.ListParams.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')
  • Add support for credit_balance_threshold on Billing.Alert and billing.Alert.CreateParams
  • Add support for billable_items on Billing.CreditGrant.ApplicabilityConfig.Scope, billing.CreditBalanceSummary.RetrieveParamsFilterApplicabilityScope, and billing.CreditGrant.CreateParamsApplicabilityConfigScope
  • Change type of Billing.CreditBalanceSummary.Balance.AvailableBalance.type, Billing.CreditBalanceSummary.Balance.LedgerBalance.type, Billing.CreditBalanceTransaction.Credit.Amount.type, Billing.CreditBalanceTransaction.Debit.Amount.type, Billing.CreditGrant.Amount.type, and billing.CreditGrant.CreateParamsAmount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')
  • Add support for license_fee_subscription_details and rate_card_subscription_details on InvoiceItem.Parent and InvoiceLineItem.Parent
  • Change type of InvoiceItem.Parent.type from literal('subscription_details') to enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')
  • Add support for license_fee_details and rate_card_rate_details on InvoiceItem.Pricing and InvoiceLineItem.Pricing
  • Change type of InvoiceItem.Pricing.type and InvoiceLineItem.Pricing.type from literal('price_details') to enum('license_fee_details'|'price_details'|'rate_card_rate_details')
  • Add support for billing_cadence on Invoice.CreatePreviewParams, Subscription.CreateParams, and Subscription
  • Add support for billing_cadence_details on Invoice.Parent and QuotePreviewInvoice.Parent
  • Add support for new value billing_cadence_details on enums Invoice.Parent.type and QuotePreviewInvoice.Parent.type
  • Add support for new values license_fee_subscription_details and rate_card_subscription_details on enum InvoiceLineItem.Parent.type
  • Add support for new resources v2.billing.BillSettingVersion, v2.billing.BillSetting, v2.billing.Cadence, v2.billing.CollectionSettingVersion, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.IntentAction, v2.billing.Intent, v2.billing.LicenseFeeSubscription, v2.billing.LicenseFeeVersion, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlanComponent, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, v2.billing.PricingPlan, v2.billing.Profile, v2.billing.RateCardRate, v2.billing.RateCardSubscription, v2.billing.RateCardVersion, v2.billing.RateCard, v2.billing.ServiceAction, v2.core.ClaimableSandbox, v2.reporting.ReportRun, v2.reporting.Report, and v2.tax.AutomaticRule
  • Add support for create, deactivate, find, modify, and retrieve methods on resource v2.tax.AutomaticRule
  • Add support for create and retrieve methods on resources v2.billing.ServiceAction and v2.reporting.ReportRun
  • Add support for retrieve method on resources v2.billing.LicenseFeeSubscription and v2.reporting.Report
  • Add support for create method on resource v2.core.ClaimableSandbox
  • Add support for cancel, create, list, modify, and retrieve methods on resources v2.billing.Cadence and v2.billing.RateCardSubscription
  • Add support for create, list, modify, and retrieve methods on resources v2.billing.BillSetting, v2.billing.CollectionSetting, v2.billing.CustomPricingUnit, v2.billing.LicenseFee, v2.billing.LicensedItem, v2.billing.MeteredItem, v2.billing.PricingPlan, v2.billing.Profile, and v2.billing.RateCard
  • Add support for list and retrieve methods on resources v2.billing.BillSettingVersion, v2.billing.CollectionSettingVersion, v2.billing.IntentAction, v2.billing.LicenseFeeVersion, v2.billing.PricingPlanSubscription, v2.billing.PricingPlanVersion, and v2.billing.RateCardVersion
  • Add support for create, delete, list, and retrieve methods on resource v2.billing.RateCardRate
  • Add support for create, delete, list, modify, and retrieve methods on resource v2.billing.PricingPlanComponent
  • Add support for cancel, commit, create, list, release_reservation, reserve, and retrieve methods on resource v2.billing.Intent
  • Add support for changes on V2.Event
  • Add support for thin events V2BillingCadenceBilledEvent, V2BillingCadenceCanceledEvent, V2BillingCadenceCreatedEvent, and V2BillingCadenceErroredEvent with related object v2.billing.Cadence
  • Add support for thin events V2BillingLicenseFeeCreatedEvent and V2BillingLicenseFeeUpdatedEvent with related object v2.billing.LicenseFee
  • Add support for thin event V2BillingLicenseFeeVersionCreatedEvent with related object v2.billing.LicenseFeeVersion
  • Add support for thin events V2BillingLicensedItemCreatedEvent and V2BillingLicensedItemUpdatedEvent with related object v2.billing.LicensedItem
  • Add support for thin events V2BillingMeteredItemCreatedEvent and V2BillingMeteredItemUpdatedEvent with related object v2.billing.MeteredItem
  • Add support for thin events V2BillingPricingPlanCreatedEvent and V2BillingPricingPlanUpdatedEvent with related object v2.billing.PricingPlan
  • Add support for thin events V2BillingPricingPlanComponentCreatedEvent and V2BillingPricingPlanComponentUpdatedEvent with related object v2.billing.PricingPlanComponent
  • Add support for thin events V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingPricingPlanSubscriptionCollectionCurrentEvent, V2BillingPricingPlanSubscriptionCollectionPastDueEvent, V2BillingPricingPlanSubscriptionCollectionPausedEvent, V2BillingPricingPlanSubscriptionCollectionUnpaidEvent, V2BillingPricingPlanSubscriptionServicingActivatedEvent, V2BillingPricingPlanSubscriptionServicingCanceledEvent, and V2BillingPricingPlanSubscriptionServicingPausedEvent with related object v2.billing.PricingPlanSubscription
  • Add support for thin event V2BillingPricingPlanVersionCreatedEvent with related object v2.billing.PricingPlanVersion
  • Add support for thin events V2BillingRateCardCreatedEvent and V2BillingRateCardUpdatedEvent with related object v2.billing.RateCard
  • Add support for thin event V2BillingRateCardRateCreatedEvent with related object v2.billing.RateCardRate
  • Add support for thin events V2BillingRateCardSubscriptionActivatedEvent, V2BillingRateCardSubscriptionCanceledEvent, V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingRateCardSubscriptionCollectionCurrentEvent, V2BillingRateCardSubscriptionCollectionPastDueEvent, V2BillingRateCardSubscriptionCollectionPausedEvent, V2BillingRateCardSubscriptionCollectionUnpaidEvent, V2BillingRateCardSubscriptionServicingActivatedEvent, V2BillingRateCardSubscriptionServicingCanceledEvent, and V2BillingRateCardSubscriptionServicingPausedEvent with related object v2.billing.RateCardSubscription
  • Add support for thin event V2BillingRateCardVersionCreatedEvent with related object v2.billing.RateCardVersion
  • Add support for thin events V2CoreHealthApiErrorFiringEvent, V2CoreHealthApiErrorResolvedEvent, V2CoreHealthApiLatencyFiringEvent, V2CoreHealthApiLatencyResolvedEvent, V2CoreHealthAuthorizationRateDropFiringEvent, V2CoreHealthAuthorizationRateDropResolvedEvent, V2CoreHealthEventGenerationFailureResolvedEvent, V2CoreHealthFraudRateIncreasedEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, V2CoreHealthPaymentMethodErrorFiringEvent, V2CoreHealthPaymentMethodErrorResolvedEvent, V2CoreHealthTrafficVolumeDropFiringEvent, V2CoreHealthTrafficVolumeDropResolvedEvent, V2CoreHealthWebhookLatencyFiringEvent, and V2CoreHealthWebhookLatencyResolvedEvent
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object v2.reporting.ReportRun
  • Add support for error type RateLimitError

See the changelog for more details.

v12.5.0

• #1554 Add section on private preview SDKs in readme
• #1544 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.Component and AccountSession.CreateParamsComponent
  • Add support for name on BillingPortal.Configuration, billing_portal.Configuration.CreateParams, and billing_portal.Configuration.ModifyParams
  • Add support for installments on Charge.PaymentMethodDetail.Alma
  • Add support for transaction_id on Charge.PaymentMethodDetail.Alma, Charge.PaymentMethodDetail.AmazonPay, Charge.PaymentMethodDetail.Billie, Charge.PaymentMethodDetail.KakaoPay, Charge.PaymentMethodDetail.KrCard, Charge.PaymentMethodDetail.NaverPay, Charge.PaymentMethodDetail.Payco, Charge.PaymentMethodDetail.RevolutPay, Charge.PaymentMethodDetail.SamsungPay, and Charge.PaymentMethodDetail.Satispay
  • Add support for location and reader on Charge.PaymentMethodDetail.Paynow
  • Add support for amount_includes_iof on Checkout.Session.PaymentMethodOption.Pix, PaymentIntent.ConfirmParamsPaymentMethodOptionPix, PaymentIntent.CreateParamsPaymentMethodOptionPix, PaymentIntent.ModifyParamsPaymentMethodOptionPix, PaymentIntent.PaymentMethodOption.Pix, and checkout.Session.CreateParamsPaymentMethodOptionPix
  • Add support for new values block and resolution on enum Dispute.PaymentMethodDetail.Card.case_type
  • Add support for new value terminal_android_apk on enums File.ListParams.purpose and File.purpose
  • Add support for new value terminal_android_apk on enum File.CreateParams.purpose
  • Add support for metadata and period on Invoice.CreatePreviewParamsScheduleDetailPhaseAddInvoiceItem, Subscription.CreateParamsAddInvoiceItem, Subscription.ModifyParamsAddInvoiceItem, SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem, SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem, and SubscriptionSchedule.Phase.AddInvoiceItem
  • Add support for exp_month and exp_year on issuing.Card.CreateParams
  • Add support for excluded_payment_method_types on PaymentIntent.CreateParams and PaymentIntent
  • Add support for payout_method on Payout.CreateParams and Payout
  • Add support for mxn on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTipping
  • Add support for card on terminal.Reader.PresentPaymentMethodParams
  • Add support for new value card on enum terminal.Reader.PresentPaymentMethodParams.type
  • Add support for new value 2025-08-27.basil on enum WebhookEndpoint.CreateParams.api_version
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
• #1553 Import available http libraries more efficiently
• #1549 Introduce V1 namespaces in StripeClient
  • All the top level non-namespaced services under StripeClient services(eg. customers, products) are copied under the new V1 namespace. These top level non-namespaced services will be marked as deprecated in the next major release and will be removed in a future release. Eg.

  client = StripeClient("sk_test...")
  
  # Accessing V1 Stripe services on a StripeClient should be through the V1 namespace
  - client.customers.list()
  + client.v1.customers.list()

  Refer to the migration guide for help upgrading.

See the changelog for more details.

v12.5.0b2

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

See the changelog for more details.

v12.5.0b1

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

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

See the changelog for more details.

v12.4.0

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

• #1541 Update generated code
  • Add support for instant_payouts_promotion on AccountSession.Component and AccountSession.CreateParamsComponent
  • Add support for adjustable_quantity on BillingPortal.Configuration.Feature.SubscriptionUpdate.Product, billing_portal.Configuration.CreateParamsFeatureSubscriptionUpdateProduct, and billing_portal.Configuration.ModifyParamsFeatureSubscriptionUpdateProduct
  • Remove support for value disabled from enum Capability.status
  • Add support for transaction_id on Charge.PaymentMethodDetail.Cashapp
  • Add support for origin_context on Checkout.Session and checkout.Session.CreateParams
  • Add support for template on Checkout.Session.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.CreateParamsInvoiceCreationInvoiceDatumRenderingOption, PaymentLink.InvoiceCreation.InvoiceDatum.RenderingOption, PaymentLink.ModifyParamsInvoiceCreationInvoiceDatumRenderingOption, and checkout.Session.CreateParamsInvoiceCreationInvoiceDatumRenderingOption
  • Add support for setup_future_usage on Checkout.Session.PaymentMethodOption.Pix and checkout.Session.CreateParamsPaymentMethodOptionPix
  • Add support for new value nz_bank_account on enum checkout.Session.CreateParams.payment_method_types
  • Change Identity.VerificationSession.RelatedPerson.account to be required
  • Change Identity.VerificationSession.RelatedPerson.person to be required
  • Add support for duration on Invoice.CreatePreviewParamsScheduleDetailPhase, SubscriptionSchedule.CreateParamsPhase, and SubscriptionSchedule.ModifyParamsPhase
  • Change type of Invoice.CreatePreviewParamsSubscriptionDetail.cancel_at, Subscription.CreateParams.cancel_at, and Subscription.ModifyParams.cancel_at from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Add support for price_data on PaymentLink.CreateParamsLineItem
  • Change PaymentLink.CreateParamsLineItem.price to be optional
  • Add support for new value America/Coyhaique on enum reporting.ReportRun.CreateParamsParameter.timezone
  • Add support for standard on Tax.Registration.CountryOption.Ae, Tax.Registration.CountryOption.Au, Tax.Registration.CountryOption.Ch, Tax.Registration.CountryOption.Gb, Tax.Registration.CountryOption.Jp, Tax.Registration.CountryOption.No, Tax.Registration.CountryOption.Nz, Tax.Registration.CountryOption.Sg, tax.Registration.CreateParamsCountryOptionAe, tax.Registration.CreateParamsCountryOptionAl, tax.Registration.CreateParamsCountryOptionAo, tax.Registration.CreateParamsCountryOptionAu, tax.Registration.CreateParamsCountryOptionAw, tax.Registration.CreateParamsCountryOptionB, tax.Registration.CreateParamsCountryOptionBa, tax.Registration.CreateParamsCountryOptionBb, tax.Registration.CreateParamsCountryOptionBd, tax.Registration.CreateParamsCountryOptionBf, tax.Registration.CreateParamsCountryOptionBh, tax.Registration.CreateParamsCountryOptionCd, tax.Registration.CreateParamsCountryOptionCh, tax.Registration.CreateParamsCountryOptionEt, tax.Registration.CreateParamsCountryOptionGb, tax.Registration.CreateParamsCountryOptionGn, tax.Registration.CreateParamsCountryOptionIs, tax.Registration.CreateParamsCountryOptionJp, tax.Registration.CreateParamsCountryOptionMe, tax.Registration.CreateParamsCountryOptionMk, tax.Registration.CreateParamsCountryOptionMr, tax.Registration.CreateParamsCountryOptionNo, tax.Registration.CreateParamsCountryOptionNz, tax.Registration.CreateParamsCountryOptionOm, tax.Registration.CreateParamsCountryOptionR, tax.Registration.CreateParamsCountryOptionSg, tax.Registration.CreateParamsCountryOptionSr, tax.Registration.CreateParamsCountryOptionUy, tax.Registration.CreateParamsCountryOptionZa, and tax.Registration.CreateParamsCountryOptionZw
  • Add support for new value inbound_goods on enums Tax.Registration.CountryOption.At.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Be.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Bg.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cy.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Cz.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.De.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Dk.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.E.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ee.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fi.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Fr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Gr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hr.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Hu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ie.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.It.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lu.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Lv.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Mt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Nl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pl.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Pt.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Ro.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Se.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Si.Standard.place_of_supply_scheme, Tax.Registration.CountryOption.Sk.Standard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionAtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionBgStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCyStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionCzStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionDkStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionEeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFiStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionFrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionGrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHrStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionHuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionIeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionItStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLuStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionLvStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionMtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionNlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPlStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionPtStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionRoStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSeStandard.place_of_supply_scheme, tax.Registration.CreateParamsCountryOptionSiStandard.place_of_supply_scheme, and tax.Registration.CreateParamsCountryOptionSkStandard.place_of_supply_scheme
  • Add support for aed, bgn, huf, and ron on Terminal.Configuration.Tipping, terminal.Configuration.CreateParamsTipping, and terminal.Configuration.ModifyParamsTipping
  • Add support for new value 2025-07-30.basil on enum WebhookEndpoint.CreateParams.api_version
• #1537 Fix timeout type hint in RequestsClient

See the changelog for more details.

v12.4.0b2

• #1536 Pull in V2 FinancialAccount changes for June release
  • Add support for close and create methods on resource v2.money_management.FinancialAccount
  • Add support for new value storer on enums V2.Core.Account.applied_configurations and v2.core.Account.CloseParams.applied_configurations
  • Add support for storer on V2.Core.Account.Configuration, v2.core.Account.CreateParamsConfiguration, and v2.core.Account.ModifyParamsConfiguration
  • Add support for new values financial_addresses.bank_accounts, holds_currencies.gbp, inbound_transfers.financial_accounts, outbound_payments.bank_accounts, outbound_payments.cards, outbound_payments.financial_accounts, outbound_transfers.bank_accounts, and outbound_transfers.financial_accounts on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.capability
  • Add support for new value storer on enum V2.Core.Account.Requirement.Entry.Impact.RestrictsCapability.configuration
  • Add support for status_details on V2.MoneyManagement.FinancialAccount
  • Add support for status on v2.money_management.FinancialAccount.ListParams
  • Add support for new value configuration.storer on enums v2.core.Account.CreateParams.include, v2.core.Account.ModifyParams.include, and v2.core.Account.RetrieveParams.include
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object v2.core.Account
  • Add support for error types AlreadyExistsError and NonZeroBalanceError

See the changelog for more details.

v12.4.0b1

• #1520 Update generated code for beta
  • Change type of Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, Subscription.CreateParams.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode from enum('classic'|'flexible') to billing_mode
  • Add support for submission_method on Dispute.EvidenceDetail
  • Add support for on_demand and subscriptions on Order.CreateParamsPaymentSettingPaymentMethodOptionKlarna and Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarna
  • Change type of Order.CreateParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, Order.ModifyParamsPaymentSettingPaymentMethodOptionKlarna.setup_future_usage, and Order.Payment.Setting.PaymentMethodOption.Klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for crypto on PaymentAttemptRecord.PaymentMethodDetail and PaymentRecord.PaymentMethodDetail
  • Add support for new value buut on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bank and PaymentRecord.PaymentMethodDetail.Ideal.bank
  • Add support for new value BUUTNL2A on enums PaymentAttemptRecord.PaymentMethodDetail.Ideal.bic and PaymentRecord.PaymentMethodDetail.Ideal.bic
  • Change type of PaymentIntent.ConfirmParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionGopay.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionGopay.setup_future_usage, and PaymentIntent.PaymentMethodOption.Gopay.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Change Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode to be required
  • Add support for new value crypto on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
  • Change type of QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingMode
  • Change type of Subscription.MigrateParams.billing_mode from literal('flexible') to billing_mode_migrate
  • Remove support for billing_mode_details on Subscription
  • Add support for new value xx on enums V2.Core.Account.Configuration.Customer.AutomaticIndirectTax.Location.country, V2.Core.Account.Configuration.Customer.Shipping.Address.country, V2.Core.Account.Configuration.Merchant.Support.Address.country, V2.Core.Account.Identity.BusinessDetail.Address.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kana.country, V2.Core.Account.Identity.BusinessDetail.ScriptAddress.Kanji.country, V2.Core.Account.Identity.Individual.AdditionalAddress.country, V2.Core.Account.Identity.Individual.Address.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kana.country, V2.Core.Account.Identity.Individual.ScriptAddress.Kanji.country, V2.Core.Account.Identity.country, V2.Core.Person.AdditionalAddress.country, V2.Core.Person.Address.country, V2.Core.Person.ScriptAddress.Kana.country, V2.Core.Person.ScriptAddress.Kanji.country, V2.MoneyManagement.FinancialAccount.country, v2.core.Account.CreateParamsConfigurationCustomerShippingAddress.country, v2.core.Account.CreateParamsConfigurationMerchantSupportAddress.country, v2.core.Account.CreateParamsIdentity.country, v2.core.Account.CreateParamsIdentityBusinessDetailAddress.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.CreateParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.CreateParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.CreateParamsIdentityIndividualAddress.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.CreateParamsIdentityIndividualScriptAddressKanji.country, v2.core.Account.ModifyParamsConfigurationCustomerShippingAddress.country, v2.core.Account.ModifyParamsConfigurationMerchantSupportAddress.country, v2.core.Account.ModifyParamsIdentity.country, v2.core.Account.ModifyParamsIdentityBusinessDetailAddress.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityBusinessDetailScriptAddressKanji.country, v2.core.Account.ModifyParamsIdentityIndividualAdditionalAddress.country, v2.core.Account.ModifyParamsIdentityIndividualAddress.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKana.country, v2.core.Account.ModifyParamsIdentityIndividualScriptAddressKanji.country, v2.core.Person.CreateParamsAdditionalAddress.country, v2.core.Person.CreateParamsAddress.country, v2.core.Person.CreateParamsScriptAddressKana.country, v2.core.Person.CreateParamsScriptAddressKanji.country, v2.core.Person.ModifyParamsAdditionalAddress.country, v2.core.Person.ModifyParamsAddress.country, v2.core.Person.ModifyParamsScriptAddressKana.country, and v2.core.Person.ModifyParamsScriptAddressKanji.country
  • Add support for new value unsupported_entity_type on enums V2.Core.Account.Configuration.Customer.Capability.AutomaticIndirectTax.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AchDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AcssDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AffirmPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AfterpayClearpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AlmaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AmazonPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.AuBecsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BacsDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BancontactPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BlikPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.BoletoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CartesBancairesPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.CashappPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.EpsPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.FpxPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GbBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.GrabpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.IdealPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JcbPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.JpBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KakaoPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KlarnaPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KonbiniPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.KrCardPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.LinkPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MobilepayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MultibancoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.MxBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.NaverPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.OxxoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.P24Payment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PayByBankPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaycoPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PaynowPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.PromptpayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.RevolutPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SamsungPayPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SepaDebitPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.StripeBalance.Payout.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.SwishPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.TwintPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.UsBankTransferPayment.StatusDetail.code, V2.Core.Account.Configuration.Merchant.Capability.ZipPayment.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Local.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.BankAccount.Wire.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.Card.StatusDetail.code, V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.Payout.StatusDetail.code, and V2.Core.Account.Configuration.Recipient.Capability.StripeBalance.StripeTransfer.StatusDetail.code
  • Add support for proof_of_address on `V2.Core.Account.Identity.BusinessDetail.Doc...