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.