v12.3.0

• #1526 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource terminal.Reader
  • Add support for crypto_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapability
  • Add support for proof_of_address on Account.CreateParamsDocument and Account.ModifyParamsDocument
  • Add support for monthly_payout_days and weekly_payout_days on Account.CreateParamsSettingPayoutSchedule, Account.ModifyParamsSettingPayoutSchedule, and Account.Setting.Payout.Schedule
  • Change Account.Setting.Invoice.hosted_payment_method_save to be required
  • Add support for crypto on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodDatum, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.ModifyParamsPaymentMethodDatum
  • Change type of Charge.PaymentMethodDetail.Card.Installment.Plan.type, ConfirmationToken.CreateParamsPaymentMethodOptionCardInstallmentPlan.type, ConfirmationToken.PaymentMethodOption.Card.Installment.Plan.type, Invoice.CreateParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type, Invoice.ModifyParamsPaymentSettingPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.ConfirmParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.CreateParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.ModifyParamsPaymentMethodOptionCardInstallmentPlan.type, PaymentIntent.PaymentMethodOption.Card.Installment.AvailablePlan.type, and PaymentIntent.PaymentMethodOption.Card.Installment.Plan.type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')
  • Add support for new value buut on enums Charge.PaymentMethodDetail.Ideal.bank, ConfirmationToken.CreateParamsPaymentMethodDatumIdeal.bank, ConfirmationToken.PaymentMethodPreview.Ideal.bank, PaymentIntent.ConfirmParamsPaymentMethodDatumIdeal.bank, PaymentIntent.CreateParamsPaymentMethodDatumIdeal.bank, PaymentIntent.ModifyParamsPaymentMethodDatumIdeal.bank, PaymentMethod.CreateParamsIdeal.bank, PaymentMethod.Ideal.bank, SetupAttempt.PaymentMethodDetail.Ideal.bank, SetupIntent.ConfirmParamsPaymentMethodDatumIdeal.bank, SetupIntent.CreateParamsPaymentMethodDatumIdeal.bank, and SetupIntent.ModifyParamsPaymentMethodDatumIdeal.bank
  • Add support for new value BUUTNL2A on enums Charge.PaymentMethodDetail.Ideal.bic, ConfirmationToken.PaymentMethodPreview.Ideal.bic, PaymentMethod.Ideal.bic, and SetupAttempt.PaymentMethodDetail.Ideal.bic
  • Add support for subscriptions on PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna, PaymentIntent.CreateParamsPaymentMethodOptionKlarna, PaymentIntent.ModifyParamsPaymentMethodOptionKlarna, and checkout.Session.CreateParamsPaymentMethodOptionKlarna
  • Add support for new value crypto on enum checkout.Session.CreateParams.payment_method_types
  • Add support for billing_mode on Invoice.CreatePreviewParamsScheduleDetail, Invoice.CreatePreviewParamsSubscriptionDetail, Quote.CreateParamsSubscriptionDatum, Quote.SubscriptionDatum, Subscription.CreateParams, SubscriptionSchedule.CreateParams, SubscriptionSchedule, Subscription, and checkout.Session.CreateParamsSubscriptionDatum
  • Add support for new value crypto on enums ConfirmationToken.CreateParamsPaymentMethodDatum.type, PaymentIntent.ConfirmParamsPaymentMethodDatum.type, PaymentIntent.CreateParamsPaymentMethodDatum.type, PaymentIntent.ModifyParamsPaymentMethodDatum.type, SetupIntent.ConfirmParamsPaymentMethodDatum.type, SetupIntent.CreateParamsPaymentMethodDatum.type, and SetupIntent.ModifyParamsPaymentMethodDatum.type
  • Add support for new value crypto on enums ConfirmationToken.PaymentMethodPreview.type and PaymentMethod.type
  • Add support for new value crypto on enums Customer.ListPaymentMethodsParams.type, PaymentMethod.CreateParams.type, and PaymentMethod.ListParams.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value compliance on enum Dispute.PaymentMethodDetail.Card.case_type
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSession and identity.VerificationSession.CreateParams
  • Add support for matching on Identity.VerificationSession.Option
  • Add support for new value crypto on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, and Subscription.PaymentSetting.payment_method_types
  • Add support for klarna on Mandate.PaymentMethodDetail, SetupIntent.ConfirmParamsPaymentMethodOption, SetupIntent.CreateParamsPaymentMethodOption, SetupIntent.ModifyParamsPaymentMethodOption, and SetupIntent.PaymentMethodOption
  • Add support for on_demand on PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna, PaymentIntent.CreateParamsPaymentMethodOptionKlarna, and PaymentIntent.ModifyParamsPaymentMethodOptionKlarna
  • Change type of PaymentIntent.ConfirmParamsPaymentMethodOptionKlarna.setup_future_usage, PaymentIntent.CreateParamsPaymentMethodOptionKlarna.setup_future_usage, PaymentIntent.ModifyParamsPaymentMethodOptionKlarna.setup_future_usage, and PaymentIntent.PaymentMethodOption.Klarna.setup_future_usage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for ua on Tax.Registration.CountryOption and tax.Registration.CreateParamsCountryOption
  • Change type of terminal.Location.ModifyParams.display_name from string to emptyable(string)
  • Add support for collect_payment_method and confirm_payment_intent on Terminal.Reader.Action
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.Action.type
  • Add support for status on treasury.FinancialAccount.ListParams
  • Add support for new value terminal.reader.action_updated on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.ModifyParams.enabled_events
  • Add support for new value 2025-06-30.basil on enum WebhookEndpoint.CreateParams.api_version
  • Add support for snapshot event terminal.reader.action_updated with resource terminal.Reader
• #1534 Fix the link to releases page from readme
• #1532 Added lint ignore instruction for deprecated import
• #1524 Added import for the new deprecated services in stripe_client
• #1522 Add a new deprecated v1 services section

See the changelog for more details.

v12.3.0b2

• #1531 Pull in OffSessionPayment changes for the May release

See the changelog for more details.

v12.3.0b1

This release changes the pinned API version to 2025-05-28.preview.

• #1509 Update generated code for beta

  Breaking changes

  • Remove support for deprecated previews
    • Remove support for resources billing.MeterErrorReport, gift_cards.Card, gift_cards.Transaction, and privacy.RedactionJobRootObjects
    • Remove support for create, list, modify, retrieve, and validate methods on resource gift_cards.Card
    • Remove support for cancel, confirm, create, list, modify, and retrieve methods on resource gift_cards.Transaction
    • Remove support for provisioning on Product.CreateParams and Product
    • Remove support for snapshot event billing.meter_error_report.triggered with resource billing.MeterErrorReport
    • Remove support for error codes gift_card_balance_insufficient, gift_card_code_exists, and gift_card_inactive on QuotePreviewInvoice.LastFinalizationError and StripeError
  • Remove support for values credits_attributed_to_debits and legacy_prorations from enums Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.CreateParams.billing_mode, Subscription.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, SubscriptionSchedule.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode
  • Change type of checkout.Session.ModifyParamsLineItem.quantity from emptyable(longInteger) to longInteger
  • Change CreditNote.post_payment_amount to be required
  • Change CreditNote.pre_payment_amount to be required
  • Remove support for credits on Order.CreateParams, Order.ModifyParams, and Order
  • Remove support for amount_remaining on Order
  • Remove support for amount_credit on Order.TotalDetail
  • Change type of PaymentAttemptRecord.metadata and PaymentRecord.metadata from nullable(map(string: string)) to map(string: string)
  • Remove support for async_workflows on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.DecrementAuthorizationParams, PaymentIntent.IncrementAuthorizationParams, PaymentIntent.ModifyParams, and PaymentIntent
  • Change type of PaymentRecord.ReportPaymentAttemptCanceledParams.metadata, PaymentRecord.ReportPaymentAttemptFailedParams.metadata, PaymentRecord.ReportPaymentAttemptGuaranteedParams.metadata, PaymentRecord.ReportPaymentAttemptParams.metadata, and PaymentRecord.ReportPaymentParams.metadata from map(string: string) to emptyable(map(string: string))
  • Change type of Privacy.RedactionJob.objects from $Privacy.RedactionJobRootObjects to RedactionResourceRootObjects
  • Change type of Privacy.RedactionJob.status from string to enum
  • Change type of Privacy.RedactionJob.validation_behavior from string to enum('error'|'fix')
  • Change type of Privacy.RedactionJobValidationError.code from string to enum
  • Change type of Privacy.RedactionJobValidationError.erroring_object from map(string: string) to RedactionResourceErroringObject
  • Remove support for status_details and status on Tax.Association

  Other changes

  • Add support for migrate method on resource Subscription
  • Add support for distance, pickup_location_name, return_location_name, and vehicle_identification_number on Charge.CaptureParamsPaymentDetailCarRental, Charge.ModifyParamsPaymentDetailCarRental, PaymentIntent.CaptureParamsPaymentDetailCarRental, PaymentIntent.ConfirmParamsPaymentDetailCarRental, PaymentIntent.CreateParamsPaymentDetailCarRental, PaymentIntent.ModifyParamsPaymentDetailCarRental, and PaymentIntent.PaymentDetail.CarRental
  • Add support for driver_identification_number and driver_tax_number on Charge.CaptureParamsPaymentDetailCarRentalDriver, Charge.ModifyParamsPaymentDetailCarRentalDriver, PaymentIntent.CaptureParamsPaymentDetailCarRentalDriver, PaymentIntent.ConfirmParamsPaymentDetailCarRentalDriver, PaymentIntent.CreateParamsPaymentDetailCarRentalDriver, PaymentIntent.ModifyParamsPaymentDetailCarRentalDriver, and PaymentIntent.PaymentDetail.CarRental.Driver
  • Add support for new values classic and flexible on enums Invoice.CreatePreviewParamsScheduleDetail.billing_mode, Invoice.CreatePreviewParamsSubscriptionDetail.billing_mode, Quote.CreateParamsSubscriptionDatum.billing_mode, Quote.SubscriptionDatum.billing_mode, QuotePreviewSubscriptionSchedule.billing_mode, Subscription.CreateParams.billing_mode, Subscription.billing_mode, SubscriptionSchedule.CreateParams.billing_mode, SubscriptionSchedule.billing_mode, and checkout.Session.CreateParamsSubscriptionDatum.billing_mode
  • Add support for institution on FinancialConnections.Account
  • Add support for countries on FinancialConnections.Institution
  • 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 location and reader on PaymentAttemptRecord.PaymentMethodDetail.Affirm, PaymentAttemptRecord.PaymentMethodDetail.WechatPay, PaymentRecord.PaymentMethodDetail.Affirm, and PaymentRecord.PaymentMethodDetail.WechatPay
  • Add support for hooks on PaymentIntent.CaptureParams, PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.DecrementAuthorizationParams, PaymentIntent.IncrementAuthorizationParams, PaymentIntent.ModifyParams, and PaymentIntent
  • Add support for card_present on PaymentIntentAmountDetailsLineItem.PaymentMethodOption
  • Add support for livemode on Privacy.RedactionJob
  • Add support for billing_thresholds on QuotePreviewSubscriptionSchedule.DefaultSetting, QuotePreviewSubscriptionSchedule.Phase.Item, and QuotePreviewSubscriptionSchedule.Phase
  • Add support for billing_mode_details on Subscription
  • Add support for tax_transaction_attempts on Tax.Association
  • Add support for confirm_config on Terminal.Reader.Action.ConfirmPaymentIntent and terminal.Reader.ConfirmPaymentIntentParams
  • Add support for error code forwarding_api_upstream_error on QuotePreviewInvoice.LastFinalizationError

See the changelog for more details.

v12.2.0

This release changes the pinned API version to 2025-05-28.basil.

• #1517 Update generated code
  • Add support for attach_payment method on resource Invoice
  • Add support for collect_inputs method on resource terminal.Reader
  • Add support for succeed_input_collection and timeout_input_collection test helper methods on resource terminal.Reader
  • Add support for pix_payments on Account.Capability, Account.CreateParamsCapability, and Account.ModifyParamsCapability
  • Add support for disputes_list and payment_disputes on AccountSession.Component and AccountSession.CreateParamsComponent
  • Add support for refund_and_dispute_prefunding on Balance
  • Add support for balance_type on BalanceTransaction
  • Change billing.Alert.CreateParamsUsageThreshold.meter to be required
  • Add support for location and reader on Charge.PaymentMethodDetail.Affirm and Charge.PaymentMethodDetail.WechatPay
  • Add support for payment_method_remove on checkout.Session.CreateParamsSavedPaymentMethodOption
  • Add support for setup_future_usage on Checkout.Session.PaymentMethodOption.NaverPay
  • Change ConfirmationToken.PaymentMethodPreview.NaverPay.buyer_id and PaymentMethod.NaverPay.buyer_id to be required
  • Add support for post_payment_amount and pre_payment_amount on CreditNote
  • Add support for new value mixed on enum CreditNote.type
  • Add support for new value invoice_payment.paid on enum Event.type
  • Add support for sex, unparsed_place_of_birth, and unparsed_sex on Identity.VerificationReport.Document and Identity.VerificationSession.VerifiedOutput
  • Add support for billing_thresholds on Invoice.CreatePreviewParamsScheduleDetailPhaseItem, Invoice.CreatePreviewParamsScheduleDetailPhase, Invoice.CreatePreviewParamsSubscriptionDetailItem, Subscription.CreateParamsItem, Subscription.CreateParams, Subscription.ModifyParamsItem, Subscription.ModifyParams, SubscriptionItem.CreateParams, SubscriptionItem.ModifyParams, SubscriptionItem, SubscriptionSchedule.CreateParamsDefaultSetting, SubscriptionSchedule.CreateParamsPhaseItem, SubscriptionSchedule.CreateParamsPhase, SubscriptionSchedule.DefaultSetting, SubscriptionSchedule.ModifyParamsDefaultSetting, SubscriptionSchedule.ModifyParamsPhaseItem, SubscriptionSchedule.ModifyParamsPhase, SubscriptionSchedule.Phase.Item, SubscriptionSchedule.Phase, and Subscription
  • Add support for satispay on PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodOption, and PaymentIntent.PaymentMethodOption
  • Add support for capture_method on PaymentIntent.PaymentMethodOption.Billie
  • Add support for kakao_pay, kr_card, naver_pay, payco, and samsung_pay on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.ModifyParams, and PaymentMethodConfiguration
  • Add support for network_decline_code on Refund.DestinationDetail.Paypal
  • Add support for metadata on Tax.CalculationLineItem and tax.Calculation.CreateParamsLineItem
  • Add support for new value simulated_stripe_s700 on enums Terminal.Reader.device_type and terminal.Reader.ListParams.device_type
  • Add support for return_url on Terminal.Reader.Action.ProcessPaymentIntent.ProcessConfig and terminal.Reader.ProcessPaymentIntentParamsProcessConfig
  • Add support for collect_inputs on Terminal.Reader.Action
  • Add support for new value collect_inputs on enum Terminal.Reader.Action.type
  • Add support for new value invoice_payment.paid on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.ModifyParams.enabled_events
  • Add support for new value 2025-05-28.basil on enum WebhookEndpoint.CreateParams.api_version
  • Add support for snapshot event invoice_payment.paid with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Invoice.LastFinalizationError, PaymentIntent.LastPaymentError, SetupAttempt.SetupError, SetupIntent.LastSetupError, and StripeError
• #1511 Adds CONTRIBUTING.md

See the changelog for more details.

v12.2.0b1

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

• #1501 Update generated code for beta
  • Add support for billing_mode on Invoice.CreatePreviewParamsScheduleDetail, Invoice.CreatePreviewParamsSubscriptionDetail, InvoiceService.CreatePreviewParamsScheduleDetail, InvoiceService.CreatePreviewParamsSubscriptionDetail, Quote.SubscriptionDatum, QuotePreviewSubscriptionSchedule, SubscriptionSchedule, Subscription, checkout.Session.CreateParamsSubscriptionDatum, and checkout.SessionService.CreateParamsSubscriptionDatum
  • Add support for new value balance_settings.updated on enum Event.type
  • Add support for new value balance_settings.updated on enums WebhookEndpoint.ModifyParams.enabled_events and WebhookEndpointService.UpdateParams.enabled_events
• #1498 Update generated code for beta
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Checkout.Session.CollectedInformation.TaxId.type, Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Order.TaxDetail.TaxId.type, QuotePreviewInvoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Change Checkout.Session.AutomaticTax.provider, Invoice.AutomaticTax.provider, Quote.AutomaticTax.provider, and QuotePreviewInvoice.AutomaticTax.provider to be required
  • Add support for account_number on ConfirmationToken.PaymentMethodPreview.AcssDebit and PaymentMethod.AcssDebit
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Customer.CreateParams.type, Customer.CreateParamsTaxIdDatum.type, CustomerService.CreateParamsTaxIdDatum.type, CustomerTaxIdService.CreateParams.type, Invoice.CreatePreviewParamsCustomerDetailTaxId.type, InvoiceService.CreatePreviewParamsCustomerDetailTaxId.type, Order.CreateParamsTaxDetailTaxId.type, Order.ModifyParamsTaxDetailTaxId.type, OrderService.CreateParamsTaxDetailTaxId.type, OrderService.UpdateParamsTaxDetailTaxId.type, TaxId.CreateParams.type, TaxIdService.CreateParams.type, tax.Calculation.CreateParamsCustomerDetailTaxId.type, and tax.CalculationService.CreateParamsCustomerDetailTaxId.type
  • Change type of InvoiceLineItem.Parent.SubscriptionItemDetail.subscription from string to nullable(string)
  • Add support for billing_mode on Quote.CreateParamsSubscriptionDatum, QuoteService.CreateParamsSubscriptionDatum, Subscription.CreateParams, SubscriptionSchedule.CreateParams, SubscriptionScheduleService.CreateParams, and SubscriptionService.CreateParams
  • Add support for bf, cm, and cv on Tax.Registration.CountryOption, tax.Registration.CreateParamsCountryOption, and tax.RegistrationService.CreateParamsCountryOption
  • Add support for new value 2025-04-30.basil on enums WebhookEndpoint.CreateParams.api_version and WebhookEndpointService.CreateParams.api_version

See the changelog for more details.

v12.1.0

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

• #1496 Update generated code
  • Add support for minority_owned_business_designation on Account.BusinessProfile, Account.CreateParamsBusinessProfile, Account.ModifyParamsBusinessProfile, AccountService.CreateParamsBusinessProfile, and AccountService.UpdateParamsBusinessProfile
  • Add support for registration_date on Account.Company, Account.CreateParamsCompany, Account.ModifyParamsCompany, AccountService.CreateParamsCompany, AccountService.UpdateParamsCompany, Token.CreateParamsAccountCompany, and TokenService.CreateParamsAccountCompany
  • Add support for us_cfpb_data on Account.CreateParams, Account.ModifyParams, AccountPersonService.CreateParams, AccountPersonService.UpdateParams, Person, Token.CreateParamsPerson, and TokenService.CreateParamsPerson
  • Add support for new value verification_legal_entity_structure_mismatch 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 new value tax_id_prohibited on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, SetupAttempt.SetupError.code, SetupIntent.LastSetupError.code, and StripeError.code
  • Add support for tax_id on Charge.BillingDetail, ConfirmationToken.CreateParamsPaymentMethodDatumBillingDetail, ConfirmationToken.PaymentMethodPreview.BillingDetail, PaymentIntent.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntent.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntent.ModifyParamsPaymentMethodDatumBillingDetail, PaymentIntentService.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntentService.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntentService.UpdateParamsPaymentMethodDatumBillingDetail, PaymentMethod.BillingDetail, PaymentMethod.CreateParamsBillingDetail, PaymentMethod.ModifyParamsBillingDetail, PaymentMethodService.CreateParamsBillingDetail, PaymentMethodService.UpdateParamsBillingDetail, SetupIntent.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntent.CreateParamsPaymentMethodDatumBillingDetail, SetupIntent.ModifyParamsPaymentMethodDatumBillingDetail, SetupIntentService.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntentService.CreateParamsPaymentMethodDatumBillingDetail, SetupIntentService.UpdateParamsPaymentMethodDatumBillingDetail, test_helpers.ConfirmationTokenService.CreateParamsPaymentMethodDatumBillingDetail, treasury.OutboundPayment.CreateParamsDestinationPaymentMethodDatumBillingDetail, and treasury.OutboundPaymentService.CreateParamsDestinationPaymentMethodDatumBillingDetail
  • Add support for wallet_options on Checkout.Session, checkout.Session.CreateParams, and checkout.SessionService.CreateParams
  • Add support for provider on Checkout.Session.AutomaticTax, Invoice.AutomaticTax, and Quote.AutomaticTax
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Checkout.Session.CustomerDetail.TaxId.type, Invoice.CustomerTaxId.type, Tax.Calculation.CustomerDetail.TaxId.type, Tax.Transaction.CustomerDetail.TaxId.type, and TaxId.type
  • Add support for payment_method_options on ConfirmationToken.CreateParams and test_helpers.ConfirmationTokenService.CreateParams
  • Add support for installments on ConfirmationToken.PaymentMethodOption.Card
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums Customer.CreateParams.type, Customer.CreateParamsTaxIdDatum.type, CustomerService.CreateParamsTaxIdDatum.type, CustomerTaxIdService.CreateParams.type, Invoice.CreatePreviewParamsCustomerDetailTaxId.type, InvoiceService.CreatePreviewParamsCustomerDetailTaxId.type, TaxId.CreateParams.type, TaxIdService.CreateParams.type, tax.Calculation.CreateParamsCustomerDetailTaxId.type, and tax.CalculationService.CreateParamsCustomerDetailTaxId.type
  • Add support for context on Event
  • Add support for new value affirm on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.ModifyParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, InvoiceService.CreateParamsPaymentSetting.payment_method_types, InvoiceService.UpdateParamsPaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.ModifyParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, SubscriptionService.CreateParamsPaymentSetting.payment_method_types, and SubscriptionService.UpdateParamsPaymentSetting.payment_method_types
  • Change type of InvoiceLineItem.Parent.SubscriptionItemDetail.subscription from string to nullable(string)
  • Add support for billie on PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.ModifyParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentIntentService.ConfirmParamsPaymentMethodOption, PaymentIntentService.CreateParamsPaymentMethodOption, and PaymentIntentService.UpdateParamsPaymentMethodOption
  • Add support for pix on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.ModifyParams, PaymentMethodConfigurationService.CreateParams, PaymentMethodConfigurationService.UpdateParams, and PaymentMethodConfiguration
  • Add support for klarna on PaymentMethodDomain
  • Add support for pending_reason on Refund
  • Change type of Tax.CalculationLineItem.reference from nullable(string) to string
  • Add support for aw, az, bd, bf, bj, cm, cv, et, in, kg, la, and ph on Tax.Registration.CountryOption, tax.Registration.CreateParamsCountryOption, and tax.RegistrationService.CreateParamsCountryOption
  • Add support for new value 2025-04-30.basil on enums WebhookEndpoint.CreateParams.api_version and WebhookEndpointService.CreateParams.api_version

See the changelog for more details.

v12.0.1

• #1499 Encode bools with lower case
  • Serializes boolean query parameter values to true/false (lower case) before sending to the Stripe API for compatibility with Stripe V2 endpoints
• #1401 Fix type hint for SearchResultObject.data
• #1493 Update readme with clarification on resource based call patterns

See the changelog for more details.

v12.1.0b3

• #1495 Update generated code for beta
  • Add support for new resources FxQuote and PaymentIntentAmountDetailsLineItem
  • Add support for create, list, and retrieve methods on resource FxQuote
  • Remove support for attach_payment_intent method on resource Invoice
  • Add support for registration_date on Account.Company, Account.CreateParamsCompany, Account.UpdateParamsCompany, and Token.CreateParamsAccountCompany
  • Add support for customer_reference and order_reference on Charge.CaptureParamsPaymentDetail, Charge.UpdateParamsPaymentDetail, PaymentIntent.CaptureParamsPaymentDetail, PaymentIntent.ConfirmParamsPaymentDetail, PaymentIntent.CreateParamsPaymentDetail, PaymentIntent.PaymentDetail, and PaymentIntent.UpdateParamsPaymentDetail
  • Add support for tax_id on Charge.BillingDetail, ConfirmationToken.CreateParamsPaymentMethodDatumBillingDetail, ConfirmationToken.PaymentMethodPreview.BillingDetail, PaymentIntent.ConfirmParamsPaymentMethodDatumBillingDetail, PaymentIntent.CreateParamsPaymentMethodDatumBillingDetail, PaymentIntent.UpdateParamsPaymentMethodDatumBillingDetail, PaymentMethod.BillingDetail, PaymentMethod.CreateParamsBillingDetail, PaymentMethod.UpdateParamsBillingDetail, SetupIntent.ConfirmParamsPaymentMethodDatumBillingDetail, SetupIntent.CreateParamsPaymentMethodDatumBillingDetail, SetupIntent.UpdateParamsPaymentMethodDatumBillingDetail, and treasury.OutboundPayment.CreateParamsDestinationPaymentMethodDatumBillingDetail
  • Add support for price_data on checkout.Session.UpdateParamsLineItem
  • Change type of checkout.Session.UpdateParamsLineItem.quantity from longInteger to emptyable(longInteger)
  • Add support for script on Coupon.CreateParams and Coupon
  • Add support for type on Coupon
  • Add support for new value fx_quote.expired on enum Event.type
  • Add support for new value affirm on enums Invoice.CreateParamsPaymentSetting.payment_method_types, Invoice.PaymentSetting.payment_method_types, Invoice.UpdateParamsPaymentSetting.payment_method_types, QuotePreviewInvoice.PaymentSetting.payment_method_types, Subscription.CreateParamsPaymentSetting.payment_method_types, Subscription.PaymentSetting.payment_method_types, and Subscription.UpdateParamsPaymentSetting.payment_method_types
  • Add support for fx_quote on PaymentIntent.ConfirmParams, PaymentIntent.CreateParams, PaymentIntent.UpdateParams, PaymentIntent, Transfer.CreateParams, and Transfer
  • Add support for discount_amount, line_items, shipping, and tax on PaymentIntent.AmountDetail
  • Add support for pix on PaymentMethodConfiguration.CreateParams, PaymentMethodConfiguration.UpdateParams, and PaymentMethodConfiguration
  • Add support for us_cfpb_data on Person and Token.CreateParamsPerson
  • Add support for pending_reason on Refund
  • Add support for aw, az, bd, bj, et, kg, la, and ph on TaxRegistration.CountryOption and tax.Registration.CreateParamsCountryOption
  • Add support for new value fx_quote.expired on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.UpdateParams.enabled_events
  • Add support for snapshot event fx_quote.expired with resource FxQuote

See the changelog for more details.

v12.1.0b2

• #1489 Update generated code for beta

  Breaking changes

  • Change type of V2MoneyManagementReceivedDebit.status_transitions from an object to nullable(an object)
  • Remove support for values bank_accounts.local_uk, bank_accounts.wire_uk, cards_uk, and crypto_wallets_v2 from enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capability

  Additions

  • Add support for new resources Privacy.RedactionJobRootObjects, Privacy.RedactionJobValidationError, and Privacy.RedactionJob
  • Add support for cancel, create, list, modify, retrieve, run, and validate methods on resource RedactionJob
  • Add support for list and retrieve methods on resource RedactionJobValidationError
  • Add support for minority_owned_business_designation on Account.BusinessProfile, Account.CreateParamsBusinessProfile, and Account.UpdateParamsBusinessProfile
  • Add support for new value verification_legal_entity_structure_mismatch on enums Account.FutureRequirement.Error.code, Account.Requirement.Error.code, AccountCapability.FutureRequirement.Error.code, AccountCapability.Requirement.Error.code, AccountPerson.FutureRequirement.Error.code, AccountPerson.Requirement.Error.code, BankAccount.FutureRequirement.Error.code, and BankAccount.Requirement.Error.code
  • Add support for export_tax_transactions and payment_disputes on AccountSession.CreateParamsComponent
  • Add support for new value tax_id_prohibited on enums Invoice.LastFinalizationError.code, PaymentIntent.LastPaymentError.code, QuotePreviewInvoice.LastFinalizationError.code, SetupAttempt.SetupError.code, SetupIntent.LastSetupError.code, and StripeError.code
  • Add support for new value fixed_term_loan on enum CapitalFinancingOffer.type
  • Add support for wallet_options on CheckoutSession and checkout.Session.CreateParams
  • Add support for new values privacy.redaction_job.canceled, privacy.redaction_job.created, privacy.redaction_job.ready, privacy.redaction_job.succeeded, and privacy.redaction_job.validation_error on enum Event.type
  • Add support for klarna on PaymentMethodDomain
  • Change type of TaxCalculationLineItem.reference from nullable(string) to string
  • Add support for in on TaxRegistration.CountryOption and tax.Registration.CreateParamsCountryOption
  • Add support for new values privacy.redaction_job.canceled, privacy.redaction_job.created, privacy.redaction_job.ready, privacy.redaction_job.succeeded, and privacy.redaction_job.validation_error on enums WebhookEndpoint.CreateParams.enabled_events and WebhookEndpoint.UpdateParams.enabled_events

• #1490 Handle external account

  • Changes external_account field in external_account_service.create from string to a union type.

See the changelog for more details.

v12.1.0b1

• #1455, #1477, #1482 Update generated code for beta

This release changes the pinned API version to 2025-03-31.preview

Breaking changes:

• Remove support for AmountOverpaid on InvoicePayment
• Remove support for values out_of_band_payment and payment_record from enum InvoicePayment.Payment.type
• Remove support for RateCardSubscriptionDetails on InvoiceItemParent
• Remove support for ApplicationFeeAmount, PaidOutOfBand, and Paid on QuotePreviewInvoice
• Remove support for billing_thresholds on QuotePreviewSubscriptionSchedule.DefaultSetting, QuotePreviewSubscriptionSchedule.Phase.Item, and QuotePreviewSubscriptionSchedule.Phase
• Remove support for coupon on QuotePreviewSubscriptionSchedule.Phase
• Change type of QuotePreviewInvoice.Parent.SubscriptionDetail.subscription from string to expandable($Subscription)
• Change CheckoutSession.Permission.update to be optional
• Change type of PaymentAttemptRecord.PaymentMethodDetail.type and PaymentRecord.PaymentMethodDetail.type from literal('custom') to string
• Change type of PaymentAttemptRecord.payment_record from string to nullable(string)
• Change PaymentAttemptRecord.PaymentMethodDetail.custom and PaymentRecord.PaymentMethodDetail.custom to be optional
• Change type of PaymentRecord.latest_payment_attempt_record from string to nullable(string)
• Change type of Order.CreateParamsPaymentSettingPaymentMethodOptionWechatPay.client and Order.UpdateParamsPaymentSettingPaymentMethodOptionWechatPay.client to be optional

Additions

• Add support for payment_method_options on ConfirmationToken.CreateParams
• Add support for installments on ConfirmationToken.PaymentMethodOption.Card
• Add support for billie on PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, and PaymentIntent.UpdateParamsPaymentMethodOption
• Add support for update_line_items on CheckoutSession.Permission and checkout.Session.CreateParamsPermission
• Add support for new resources BalanceSettings
• Add support for modify and retrieve methods on resource BalanceSettings
• Add support for create, delete, list, modify, and retrieve methods on a new ExternalAccountService to access cards and bank accounts made available in the new path v1/external_accounts
• Add support for stripe_balance_payments on Account.Capability, Account.CreateParamsCapability, and Account.UpdateParamsCapability
• Add support for new values stripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.type
• Add support for customer_account on BillingCreditBalanceSummary, BillingCreditGrant, BillingPortalSession, CheckoutSession, ConfirmationToken.PaymentMethodPreview, CreditNote.ListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerCashBalance, CustomerPaymentMethod, CustomerSession.CreateParams, CustomerSession, CustomerTaxId.Owner, CustomerTaxId, Customer, Discount, FinancialConnectionsAccount.AccountHolder, FinancialConnectionsSession.AccountHolder, Invoice.CreateParams, Invoice.CreatePreviewParams, Invoice.ListParams, InvoiceItem.CreateParams, InvoiceItem.ListParams, InvoiceItem, Invoice, PaymentIntent.CreateParams, PaymentIntent.ListParams, PaymentIntent.UpdateParams, PaymentIntent, PaymentMethod.AttachParams, PaymentMethod, PromotionCode.CreateParams, PromotionCode.ListParams, PromotionCode, Quote.CreateParams, Quote.ListParams, Quote.UpdateParams, QuotePreviewInvoice, QuotePreviewSubscriptionSchedule, Quote, SetupAttempt, SetupIntent.CreateParams, SetupIntent.ListParams, SetupIntent.UpdateParams, SetupIntent, Subscription.CreateParams, Subscription.ListParams, SubscriptionSchedule.CreateParams, SubscriptionSchedule.ListParams, SubscriptionSchedule, Subscription, TaxId.CreateParamsOwner, TaxId.ListParamsOwner, TaxId.Owner, TaxId, billing.CreditBalanceSummary.RetrieveParams, billing.CreditBalanceTransaction.ListParams, billing.CreditGrant.CreateParams, billing.CreditGrant.ListParams, billingportal.Session.CreateParams, checkout.Session.CreateParams, checkout.Session.ListParams, financialconnections.Account.ListParamsAccountHolder, and financialconnections.Session.CreateParamsAccountHolder
• Add support for stripe_balance on Charge.PaymentMethodDetail, ConfirmationToken.CreateParamsPaymentMethodDatum, ConfirmationToken.PaymentMethodPreview, CustomerPaymentMethod, PaymentAttemptRecord.PaymentMethodDetail, PaymentIntent.ConfirmParamsPaymentMethodDatum, PaymentIntent.ConfirmParamsPaymentMethodOption, PaymentIntent.CreateParamsPaymentMethodDatum, PaymentIntent.CreateParamsPaymentMethodOption, PaymentIntent.PaymentMethodOption, PaymentIntent.UpdateParamsPaymentMethodDatum, PaymentIntent.UpdateParamsPaymentMethodOption, PaymentMethod.CreateParams, PaymentMethod, PaymentRecord.PaymentMethodDetail, SetupAttempt.PaymentMethodDetail, SetupIntent.ConfirmParamsPaymentMethodDatum, SetupIntent.CreateParamsPaymentMethodDatum, and SetupIntent.UpdateParamsPaymentMethodDatum
• Add support for update_shipping_details on CheckoutSession.Permission and checkout.Session.CreateParamsPermission
• Add support for provider on CheckoutSession.AutomaticTax, Invoice.AutomaticTax, Quote.AutomaticTax, and QuotePreviewInvoice.AutomaticTax
• Add support for tax_calculation_reference on CreditNoteLineItem, CreditNotePreviewLines, InvoiceLineItem, LineItem, PaymentLinkLineItem, QuoteComputedUpfrontLineItems, QuoteLineItem, and SessionLineItem
• Add support for context on Event
• Add support for related_customer_account on IdentityVerificationSession, identity.VerificationSession.CreateParams, and identity.VerificationSession.ListParams
• Add support for payout_method on Payout.CreateParams and Payout
• Add support for confirmation_secret, parent, and total_taxes on QuotePreviewInvoice
• Add support for new values forwarding_api_retryable_upstream_error, setup_intent_mobile_wallet_unsupported, v2_account_disconnection_unsupported, and v2_account_missing_configuration on enum QuotePreviewInvoice.LastFinalizationError.code
• Add support for new values klarna, nz_bank_account, and stripe_balance on enum QuotePreviewInvoice.PaymentSetting.payment_method_types
• Add support for id and text on TerminalReader.Action.CollectInput.Input.Selection.Choice, TerminalReader.Action.CollectInput.Input.Selection, and terminal.Reader.CollectInputsParamsInputSelectionChoice
• Add support for network_data on IssuingDisputeSettlementDetail
• Add support for interchange_fees_amount, net_total_amount, network_fees_amount, other_fees_amount, other_fees_count, and transaction_amount on IssuingSettlement
• Add support for reported_by on PaymentAttemptRecord

Changes

• Change CustomerSession.CreateParams.customer, InvoiceItem.CreateParams.customer, PaymentMethod.AttachParams.customer, Subscription.CreateParams.customer, billing.CreditBalanceSummary.RetrieveParams.customer, billing.CreditBalanceTransaction.ListParams.customer, billing.CreditGrant.CreateParams.customer, and billingportal.Session.CreateParams.customer to be optional

• Change type of Invoice.Parent.SubscriptionDetail.PauseCollection.behavior and QuotePreviewInvoice.Parent.SubscriptionDetail.PauseCollection.behavior from string to enum('keep_as_draft'|'mark_uncollectible'|'void')

• Change CreditNote.refunds to be required

• Change Invoice.amount_overpaid and QuotePreviewInvoice.amount_overpaid to be required

• Change type of InvoicePayment.is_default from nullable(boolean) to boolean

• Change type of PaymentAttemptRecord.PaymentMethodDetail.custom and PaymentRecord.PaymentMethodDetail.custom from nullable(PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails) to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails

• Change PaymentRecord.ReportPaymentParams.payment_reference to be optional

• #1476 Update add_beta_version logic

  • ⚠️ stripe.add_beta_versionwill use the highest version number used for a beta feature instead of raising anException` on a conflict as it had done previously.

See the changelog for more details.