v33.2.0-beta.1

This release changes the pinned API version to 2026-06-24.preview.

• #2225 Update generated code for beta
  • Add support for redaction on Card, Charge, Customer, PaymentIntent, PaymentMethod, SetupIntent, Source, Token, checkout.Session, issuing.Authorization, issuing.Card, issuing.Cardholder, issuing.Dispute, and issuing.Transaction
  • Add support for disclaimerVariant on capital.FinancingOffer and capital.FinancingSummary.details
  • Add support for active on financialconnections.Account.status_details and financialconnections.Authorization.status_details
  • Change type of financialconnections.SessionCreateParams.limits.accounts from longInteger to emptyable(longInteger)
  • Add support for pause on InvoiceCreatePreviewParams.subscription_details
  • Add support for releaseDetails on reserve.Hold
  • Add support for buyerId on sharedpayment.GrantedToken.payment_method_details.bizum and sharedpayment.GrantedToken.payment_method_details.blik
  • Add support for fingerprint on sharedpayment.GrantedToken.payment_method_details.pix
  • ⚠️ Remove support for value invoice_payment.detached from enum WebhookEndpointUpdateParams.enabledEvents
  • Add support for moneyManager on v2.core.Account.configuration, v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.configuration, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.configuration
  • ⚠️ Remove support for storer on v2.core.Account.configuration, v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.configuration, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.configuration
  • ⚠️ Remove support for maximumRps on v2.core.BatchJobCreateParams and v2.core.BatchJob
  • Add support for bic on v2.moneymanagement.FinancialAddress.credentials.us_bank_account
  • ⚠️ Remove support for swiftCode on v2.moneymanagement.FinancialAddress.credentials.us_bank_account
  • Add support for processing on v2.moneymanagement.OutboundPayment.status_details and v2.moneymanagement.OutboundTransfer.status_details
  • Add support for accountHolderName on v2.moneymanagement.ReceivedCredit.bank_transfer.us_bank_account
  • Add support for statuses on v2.moneymanagement.FinancialAccountListParams
  • ⚠️ Remove support for status on v2.moneymanagement.FinancialAccountListParams
  • Change v2.core.BatchJobCreateParams.metadata to be optional
  • Add support for new value money_manager on enums EventsV2CoreAccountLinkReturnedEvent.configurations, v2.core.AccountLinkCreateParams.use_case.account_onboarding.configurations, and v2.core.AccountLinkCreateParams.use_case.account_update.configurations
  • ⚠️ Add support for new value money_manager on enums v2.core.AccountCloseParams.appliedConfigurations and v2.core.AccountListParams.appliedConfigurations
  • ⚠️ Remove support for value storer from enums v2.core.AccountCloseParams.appliedConfigurations and v2.core.AccountListParams.appliedConfigurations
  • ⚠️ Add support for new value configuration.money_manager on enums v2.core.AccountCreateParams.include, v2.core.AccountRetrieveParams.include, and v2.core.AccountUpdateParams.include
  • ⚠️ Remove support for value configuration.storer from enums v2.core.AccountCreateParams.include, v2.core.AccountRetrieveParams.include, and v2.core.AccountUpdateParams.include
  • Add support for event notifications V2CoreAccountIncludingConfigurationMoneyManagerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationMoneyManagerUpdatedEvent with related object v2.core.Account
  • Add support for event notification V2MoneyManagementOutboundPaymentUnderReviewEvent with related object v2.moneymanagement.OutboundPayment
  • Add support for event notification V2MoneyManagementOutboundTransferUnderReviewEvent with related object v2.moneymanagement.OutboundTransfer
  • ⚠️ Remove support for event notifications V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object v2.core.Account

See the changelog for more details.

v33.2.0-alpha.1

This release changes the pinned API version to 2026-06-24.preview.

• #2238 Update generated code for private-preview
  • Add support for new resources v2.billing.ContractPricingLineQuantityChange, v2.core.health.AlertHistoryEntry, v2.core.health.Alert, v2.moneymanagement.FinancialAddressDebitSimulation, and v2.moneymanagement.PayoutIntent
  • ⚠️ Remove support for resource v2.billing.ContractLicensePricingQuantityChange
  • Add support for report_offer_acceptance method on resource issuing.CreditUnderwritingRecord
  • Add support for provisional_credit test helper method on resource issuing.Dispute
  • Add support for report_early_fraud_warning method on resource PaymentAttemptRecord
  • Add support for search method on resource PaymentRecord
  • Add support for debit method on resource v2.moneymanagement.FinancialAddressDebitSimulation
  • Add support for cancel, create, list, retrieve, and update methods on resource v2.moneymanagement.PayoutIntent
  • Add support for list and retrieve methods on resource v2.core.health.Alert
  • Add support for delete method on resource v2.billing.Contract
  • ⚠️ Remove support for performanceLocationDetails on tax.TransactionLineItem
  • Add support for financialAccountsTransactions, financialAccounts, and recipientsList on AccountSession.components and AccountSessionCreateParams.components
  • Add support for location and reader on Charge.payment_method_details.gift_card, GiftCardOperation, PaymentAttemptRecord.payment_method_details.gift_card, and PaymentRecord.payment_method_details.gift_card
  • Add support for subscription on checkout.SessionCreateParams.items[]
  • Add support for items on checkout.Session
  • Add support for brand on checkout.Session.current_attempt.payment_method_details.card
  • Add support for networkData on issuing.AuthorizationCaptureParams and issuing.TransactionCreateForceCaptureParams
  • Add support for enrichedMerchantData on issuing.Authorization
  • Add support for availableBalance and currentBalance on issuing.Authorization.balance_response
  • ⚠️ Remove support for amount on issuing.Authorization.balance_response
  • Add support for decisionDeadlineUpdatedAt on issuing.CreditUnderwritingRecord
  • Add support for acquirerReferenceNumber on issuing.Transaction.network_data
  • Change PaymentAttemptRecordReportRefundParams.outcome and PaymentRecordReportRefundParams.outcome to be optional
  • Add support for tip on PaymentIntentCaptureParams.amount_details, PaymentIntentConfirmParams.amount_details, PaymentIntentCreateParams.amount_details, PaymentIntentDecrementAuthorizationParams.amount_details, PaymentIntentIncrementAuthorizationParams.amount_details, and PaymentIntentUpdateParams.amount_details
  • ⚠️ Remove support for values billing.alert.recovered and payment_intent.expired from enums WebhookEndpointCreateParams.enabledEvents and WebhookEndpointUpdateParams.enabledEvents
  • Add support for billingCycleAnchor on v2.billing.ContractCreateParams and v2.billing.Contract
  • ⚠️ Remove support for contractLineDetails, contractValueDetails, and licenseQuantities on v2.billing.Contract
  • Add support for billSettingsDetails on v2.billing.Contract.billing_settings and v2.billing.ContractCreateParams.billing_settings
  • Add support for billingProfileDetails and collectionSettingsDetails on v2.billing.Contract.billing_settings
  • ⚠️ Remove support for contractBillingDetails on v2.billing.Contract.billing_settings and v2.billing.ContractCreateParams.billing_settings
  • ⚠️ Change type of v2.billing.Contract.oneTimeFees from array(an object) to an object
  • ⚠️ Change type of v2.billing.Contract.pricingLines from array(an object) to an object
  • ⚠️ Change type of v2.billing.Contract.pricingOverrides from array(an object) to an object
  • Add support for mode on v2.commerce.ProductCatalogImport
  • Add support for moneyManager on v2.core.Account.configuration, v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.configuration, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, v2.core.AccountUpdateParams.configuration, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for storer on v2.core.Account.configuration, v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.configuration, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, v2.core.AccountUpdateParams.configuration, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for sunbitPayments on v2.core.Account.configuration.merchant.capabilities, v2.core.AccountCreateParams.configuration.merchant.capabilities, and v2.core.AccountUpdateParams.configuration.merchant.capabilities
  • Add support for ach, becs, eft, fedwire, fps, npp, rtp, sepaCredit, sepaInstant, and swift on v2.core.Account.configuration.recipient.capabilities.bank_accounts, v2.core.AccountCreateParams.configuration.recipient.capabilities.bank_accounts, and v2.core.AccountUpdateParams.configuration.recipient.capabilities.bank_accounts
  • Add support for consumerMoneyManager on v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for cryptoMoneyManager on v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for consumerStorer on v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for cryptoStorer on v2.core.Account.identity.attestations.terms_of_service, v2.core.AccountCreateParams.identity.attestations.terms_of_service, v2.core.AccountTokenCreateParams.identity.attestations.terms_of_service, and v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for maximumRps on v2.core.BatchJobCreateParams and v2.core.BatchJob
  • Add support for bic on v2.moneymanagement.FinancialAddress.credentials.us_bank_account
  • ⚠️ Remove support for swiftCode on v2.moneymanagement.FinancialAddress.credentials.us_bank_account
  • Add support for attachment on v2.moneymanagement.OutboundPayment.delivery_options.paper_check and v2.moneymanagement.OutboundPaymentCreateParams.delivery_options.paper_check
  • Add support for processing on v2.moneymanagement.OutboundPayment.status_details and v2.moneymanagement.OutboundTransfer.status_details
  • Add support for payoutMethodOptions on v2.moneymanagement.OutboundPayment.to, v2.moneymanagement.OutboundPaymentCreateParams.to, v2.moneymanagement.OutboundTransfer.to, and v2.moneymanagement.OutboundTransferCreateParams.to
  • Add support for accountHolderName on v2.moneymanagement.ReceivedCredit.bank_transfer.us_bank_account
  • Add support for returned on v2.moneymanagement.ReceivedDebit.status_details
  • Add support for returnedAt on v2.moneymanagement.ReceivedDebit.status_transitions
  • Add support for payoutIntent on v2.moneymanagement.OutboundPaymentCreateParams
  • Add support for statuses on v2.moneymanagement.FinancialAccountListParams
  • ⚠️ Remove support for status on v2.moneymanagement.FinancialAccountListParams
  • Change v2.core.BatchJobCreateParams.metadata to be optional
  • Add support for new value money_manager on enums EventsV2CoreAccountLinkReturnedEvent.configurations, v2.core.AccountLinkCreateParams.use_case.account_onboarding.configurations, and v2.core.AccountLinkCreateParams.use_case.account_update.configurations
  • ⚠️ Add support for new value money_manager on enums v2.core.AccountCloseParams.appliedConfigurations and v2.core.AccountListParams.appliedConfigurations
  • ⚠️ Remove support for value storer from enums v2.core.AccountCloseParams.appliedConfigurations and v2.core.AccountListParams.appliedConfigurations
  • ⚠️ Add support for new value configuration.money_manager on enums v2.core.AccountCreateParams.include, v2.core.AccountRetrieveParams.include, and v2.core.AccountUpdateParams.include
  • ⚠️ Remove support for value configuration.storer from enums v2.core.AccountCreateParams.include, v2.core.AccountRetrieveParams.include, and v2.core.AccountUpdateParams.include
  • Add support for include on v2.billing.ContractListParams
  • ⚠️ Remove support for contractLines on v2.billing.ContractCreateParams
  • ⚠️ Remove support for licenseQuantityActions on v2.billing.ContractCreateParams and v2.billing.ContractUpdateParams
  • ⚠️ Add support for billingProfileDetails and collectionSettingsDetails on v2.billing.ContractCreateParams.billing_settings
  • ⚠️ Add support for new value billing_settings on enums v2.billing.ContractActivateParams.include, v2.billing.ContractCancelParams.include, v2.billing.ContractCreateParams.include, v2.billing.ContractRetrieveParams.include, and v2.billing.ContractUpdateParams.include
  • ⚠️ Remove support for values contract_line_details and license_quantities from enums v2.billing.ContractActivateParams.include, v2.billing.ContractCancelParams.include, `v2.billing....

v33.1.0

This release changes the pinned API version to 2026-06-24.dahlia.

• #2240 Update generated code
  • Add support for releaseDetails on reserve.Hold
  • Add support for buyerId on Charge.payment_method_details.bizum, ConfirmationToken.payment_method_preview.bizum, ConfirmationToken.payment_method_preview.blik, PaymentAttemptRecord.payment_method_details.bizum, PaymentMethod.bizum, PaymentMethod.blik, and PaymentRecord.payment_method_details.bizum
  • Add support for transactionLinkId on Charge.payment_method_details.card
  • Add support for fingerprint on Charge.payment_method_details.pix, ConfirmationToken.payment_method_preview.pix, PaymentMethod.pix, and SetupAttempt.payment_method_details.pix
  • Add support for sunbit on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_options, checkout.Session.payment_method_options, and checkout.SessionCreateParams.payment_method_options
  • Add support for billingCycleAnchorConfig on checkout.SessionCreateParams.subscription_data
  • Add support for wechatPay on checkout.Session.payment_method_options
  • Add support for mastercardCompliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidence
  • Add support for statusDetails on financialconnections.Account
  • Add support for new value satispay on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • ⚠️ Remove support for storedCredentialUsage on PaymentAttemptRecord.payment_method_details.card and PaymentRecord.payment_method_details.card
  • Add support for setupFutureUsage on PaymentIntent.payment_method_options.satispay, PaymentIntentConfirmParams.payment_method_options.satispay, PaymentIntentCreateParams.payment_method_options.satispay, and PaymentIntentUpdateParams.payment_method_options.satispay
  • Change PaymentRecordReportRefundParams.refunded to be optional
  • Add support for satispay on SetupAttempt.payment_method_details
  • Add support for customFields, description, and footer on Subscription.invoice_settings, SubscriptionCreateParams.invoice_settings, and SubscriptionUpdateParams.invoice_settings
  • Add support for paymentMethodOptions and paymentMethod on TopupCreateParams
  • Add support for new value 2026-06-24.dahlia on enum WebhookEndpointCreateParams.apiVersion
  • Add support for mode on v2.commerce.ProductCatalogImport
  • Add support for sunbitPayments on v2.core.Account.configuration.merchant.capabilities, v2.core.AccountCreateParams.configuration.merchant.capabilities, and v2.core.AccountUpdateParams.configuration.merchant.capabilities
  • Add support for cryptoMoneyManager and moneyManager on v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • ⚠️ Remove support for cryptoStorer and storer on v2.core.AccountUpdateParams.identity.attestations.terms_of_service
  • Add support for new value promotion on enum v2.commerce.ProductCatalogImportCreateParams.feedType
  • Add support for new value sunbit_payments on enum EventsV2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent.updatedCapability

See the changelog for more details.

v33.1.0-alpha.2

• #2235 Update generated code for private-preview
  • Add support for retrieve method on resource radar.CustomerEvaluation
  • Add support for disableStripeUserAuthentication on AccountSession.components.bills.features
  • Add support for tamara on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, and sharedpayment.GrantedToken.payment_method_details
  • Add support for status on Charge.payment_method_details.card.account_funding
  • ⚠️ Remove support for processedTransactionType on Charge.payment_method_details.card.account_funding
  • Add support for items on checkout.SessionCreateParams
  • ⚠️ Remove support for brand on checkout.Session.current_attempt.payment_method_details.card
  • Add support for new value tamara on enums ConfirmationTokenCreateParams.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • ⚠️ Remove support for first6 on ConfirmationToken.payment_method_preview.gift_card, PaymentMethod.gift_card, and sharedpayment.GrantedToken.payment_method_details.gift_card
  • Add support for new value tamara on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for fingerprint on GiftCard
  • Add support for blik on Mandate.payment_method_details
  • Add support for buyerId on Order.payment.settings.payment_method_options.wechat_pay, OrderCreateParams.payment.settings.payment_method_options.wechat_pay, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay, PaymentIntent.payment_method_options.wechat_pay, PaymentIntentConfirmParams.payment_method_options.wechat_pay, PaymentIntentCreateParams.payment_method_options.wechat_pay, and PaymentIntentUpdateParams.payment_method_options.wechat_pay
  • Add support for new value mini_program on enums OrderCreateParams.payment.settings.payment_method_options.wechat_pay.client, OrderUpdateParams.payment.settings.payment_method_options.wechat_pay.client, PaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.client
  • Add support for paymentMethodDetails on PaymentAttemptRecordReportGuaranteedParams and PaymentRecordReportPaymentAttemptGuaranteedParams
  • Add support for failed and refundGroup on PaymentAttemptRecordReportRefundParams and PaymentRecordReportRefundParams
  • Change type of PaymentAttemptRecordReportRefundParams.outcome and PaymentRecordReportRefundParams.outcome from literal('refunded') to enum('failed'|'refunded')
  • Add support for new value tamara on enums PaymentIntentConfirmParams.allowedPaymentMethodTypes, PaymentIntentCreateParams.allowedPaymentMethodTypes, and PaymentIntentUpdateParams.allowedPaymentMethodTypes
  • Add support for new value tamara on enums PaymentIntentConfirmParams.excludedPaymentMethodTypes, PaymentIntentCreateParams.excludedPaymentMethodTypes, PaymentIntentUpdateParams.excludedPaymentMethodTypes, SetupIntentCreateParams.excludedPaymentMethodTypes, and SetupIntentUpdateParams.excludedPaymentMethodTypes
  • Add support for beneficiaryDetails on PaymentIntent.payment_details.money_services, PaymentIntentConfirmParams.payment_details.money_services, PaymentIntentCreateParams.payment_details.money_services, and PaymentIntentUpdateParams.payment_details.money_services
  • ⚠️ Remove support for beneficiaryAccount and beneficiaryDetails on PaymentIntent.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • ⚠️ Remove support for senderAccount on PaymentIntentConfirmParams.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_details.money_services.account_funding
  • Add support for givenName and surname on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_details
  • ⚠️ Remove support for name on PaymentIntent.payment_details.money_services.account_funding.sender_details, PaymentIntentConfirmParams.payment_details.money_services.account_funding.sender_details, PaymentIntentCreateParams.payment_details.money_services.account_funding.sender_details, and PaymentIntentUpdateParams.payment_details.money_services.account_funding.sender_details
  • Change type of PaymentIntentConfirmParams.payment_method_options.card.captureMethod, PaymentIntentCreateParams.payment_method_options.card.captureMethod, and PaymentIntentUpdateParams.payment_method_options.card.captureMethod from literal('manual') to enum('automatic_delayed'|'manual')
  • ⚠️ Remove support for wallet on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for new value automatic_delayed on enums PaymentIntentConfirmParams.payment_method_options.card_present.captureMethod, PaymentIntentCreateParams.payment_method_options.card_present.captureMethod, and PaymentIntentUpdateParams.payment_method_options.card_present.captureMethod
  • Add support for transactionVerificationOptions on PaymentIntent.payment_method_options.crypto, PaymentIntentConfirmParams.payment_method_options.crypto, PaymentIntentCreateParams.payment_method_options.crypto, and PaymentIntentUpdateParams.payment_method_options.crypto
  • Add support for new values ethereum and polygon on enums PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options.networks, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options.networks, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_options.networks
  • Add support for new values ethereum and polygon on enum PaymentIntentSimulateCryptoDepositParams.network
  • Change type of PaymentIntentSimulateCryptoDepositParams.tokenCurrency from literal('usdc') to enum('usdc'|'usdg'|'usdp')
  • Add support for forcedCapture on PaymentIntent.advanced_feature_details
  • Add support for wechatPayHandleAppRedirect on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for ethereum and polygon on PaymentIntent.next_action.crypto_display_details.deposit_addresses
  • ⚠️ Change type of PaymentIntent.next_action.crypto_display_details.deposit_addresses.base.supported_tokens[].tokenCurrency, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana.supported_tokens[].tokenCurrency, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempo.supported_tokens[].tokenCurrency from literal('usdc') to enum('usdc'|'usdg'|'usdp')
  • Add support for beneficiaryAccount on PaymentIntent.payment_details.money_services
  • ⚠️ Change type of PaymentIntent.payment_method_options.card.captureMethod from literal('manual') to enum('automatic_delayed'|'manual')
  • Change type of PaymentLocationUpdateParams.business_registration.siret from string to emptyable(string)
  • Add support for card on PaymentRecordReportPaymentAttemptParams.payment_method_details and PaymentRecordReportPaymentParams.payment_method_details
  • Change type of PaymentRecordReportPaymentAttemptParams.payment_method_details.type and PaymentRecordReportPaymentParams.payment_method_details.type from literal('custom') to enum('card'|'custom')
  • Add support for managedPayments on Product
  • Add support for paymentAttemptRecord on RefundCreateParams and RefundListParams
  • Add support for paymentRecord on RefundListParams
  • Add support for protections on v2.core.Account.configuration.card_creator.capabilities.commercial.celtic.charge_card, v2.core.Account.configuration.card_creator.capabilities.commercial.celtic.spend_card, v2.core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.charge_card, v2.core.Account.configuration.card_creator.capabilities.commercial.cross_river_bank.prepaid_card, `v2.core.Account.configuration.car...

v33.1.0-alpha.1

This release changes the pinned API version to 2026-06-10.preview.

• #2233 Update generated code for private-preview
  • Add support for new resources GiftCardOperation, GiftCard, and TaxFund
  • Add support for retrieve method on resource GiftCardOperation
  • Add support for activate, cashout, check_balance, create, reload, retrieve, and void_operation methods on resource GiftCard
  • Add support for list and retrieve methods on resource TaxFund
  • Add support for update_crypto_refund_address method on resource PaymentIntent
  • Add support for performanceLocationDetails on tax.CalculationCreateParams.line_items[], tax.CalculationLineItem, and tax.TransactionLineItem
  • ⚠️ Remove support for moneyServices on ChargeCaptureParams.payment_details, ChargeUpdateParams.payment_details, and PaymentIntentCaptureParams.payment_details
  • Add support for frMealVoucher on Charge.payment_method_details.card.benefits
  • Add support for multicapture on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentRecord.payment_method_details.card_present
  • Add support for pix on checkout.Session.current_attempt.payment_method_details
  • Add support for provisionalCredit on issuing.DisputeUpdateParams and issuing.Dispute
  • Add support for reason on PaymentAttemptRecordReportCanceledParams and PaymentRecordReportPaymentAttemptCanceledParams
  • Add support for fiservValuelink, givex, and svs on PaymentAttemptRecord.processor_details and PaymentRecord.processor_details
  • ⚠️ Change type of PaymentAttemptRecord.processor_details.type and PaymentRecord.processor_details.type from literal('custom') to enum('custom'|'fiserv_valuelink'|'givex'|'svs')
  • Add support for captureBy and captureDelay on PaymentIntent.payment_method_options.card_present, PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card, PaymentIntentUpdateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card
  • ⚠️ Remove support for liquidAsset on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for requestMulticapture on PaymentIntent.payment_method_options.card_present, PaymentIntentConfirmParams.payment_method_options.card_present, PaymentIntentCreateParams.payment_method_options.card_present, and PaymentIntentUpdateParams.payment_method_options.card_present
  • Add support for new value transaction_verification on enums PaymentIntentConfirmParams.payment_method_options.crypto.mode, PaymentIntentCreateParams.payment_method_options.crypto.mode, and PaymentIntentUpdateParams.payment_method_options.crypto.mode
  • Add support for ignoreApplicationFee, ignoreTransferData, and requestPartialAuthorization on PaymentIntentConfirmParams.payment_method_options.gift_card, PaymentIntentCreateParams.payment_method_options.gift_card, and PaymentIntentUpdateParams.payment_method_options.gift_card
  • Change PaymentIntentConfirmParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentCreateParams.payment_details.benefit.fr_meal_voucher.siret, PaymentIntentUpdateParams.payment_details.benefit.fr_meal_voucher.siret, SetupIntentConfirmParams.setup_details.benefit.fr_meal_voucher.siret, SetupIntentCreateParams.setup_details.benefit.fr_meal_voucher.siret, and SetupIntentUpdateParams.setup_details.benefit.fr_meal_voucher.siret to be optional
  • Add support for latestPaymentAttemptRecord and paymentRecord on PaymentIntent
  • ⚠️ Remove support for reauthorization and reauthorizeBefore on PaymentIntent.advanced_feature_details
  • Add support for refundAddress on PaymentIntent.next_action.crypto_display_details.deposit_addresses.base, PaymentIntent.next_action.crypto_display_details.deposit_addresses.solana, and PaymentIntent.next_action.crypto_display_details.deposit_addresses.tempo
  • Add support for location on PaymentIntent.payment_details and SetupIntent.setup_details
  • Add support for data on radar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details, radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details, and radar.CustomerEvaluationCreateParams.evaluation_context[].client_details
  • Change radar.AccountEvaluationCreateParams.login_initiated.client_device_metadata_details.radarSession, radar.AccountEvaluationCreateParams.registration_initiated.client_device_metadata_details.radarSession, and radar.CustomerEvaluationCreateParams.evaluation_context[].client_details.radarSession to be optional
  • ⚠️ Change type of v2.core.FeeBatch.adjustments.taxAdjustment from amount to an object
  • ⚠️ Change type of v2.core.FeeBatch.amount, v2.core.FeeBatch.collection_records[].amount, v2.core.FeeBatch.collection_records[].tax.amount, v2.core.FeeBatch.tax.amount, v2.core.FeeEntry.amount, and v2.core.FeeEntry.tax.amount from amount to an object
  • Add support for taxFund on v2.moneymanagement.Transaction.flow and v2.moneymanagement.TransactionEntry.transaction_details.flow
  • Add support for new value promotion on enum v2.commerce.ProductCatalogImportCreateParams.feedType

See the changelog for more details.

v33.0.0

This release doesn't change the pinned API version; it still uses 2026-05-27.dahlia.

We're doing an out-of-band-major to update a field type that changed. If you're not using tax_details, this is a no-op release when compared with the last one. If you are using tax_details its type has changed slightly and you'll have to update your code when upgrading.

• #2234 ⚠️ Make tax_rate.tax_details expandable
• #2230 Add "source" field to user-agent header

See the changelog for more details.

v32.3.0-alpha.2

• #2231 Update generated code for private-preview
  • Add support for new resources delegatedcheckout.OrderEvent, delegatedcheckout.Order, v2.billing.ContractLicensePricingQuantityChange, v2.billing.Contract, and v2.signals.AccountSignal
  • Add support for retrieve method on resource delegatedcheckout.Order
  • Add support for list_orders method on resource delegatedcheckout.RequestedSession
  • Add support for list and retrieve methods on resource v2.signals.AccountSignal
  • Add support for activate, cancel, create, list, retrieve, and update methods on resource v2.billing.Contract
  • Add support for birthAddress on AccountCreateParams.individual, AccountUpdateParams.individual, PersonCreateParams, PersonUpdateParams, Person, TokenCreateParams.account.individual, and TokenCreateParams.person
  • Change type of ChargeCaptureParams.payment_details.money_services.transactionType, ChargeUpdateParams.payment_details.money_services.transactionType, PaymentIntentCaptureParams.payment_details.money_services.transactionType, PaymentIntentConfirmParams.payment_details.money_services.transactionType, PaymentIntentCreateParams.payment_details.money_services.transactionType, and PaymentIntentUpdateParams.payment_details.money_services.transactionType from literal('account_funding') to enum('account_funding'|'debt_repayment')
  • Add support for provisioningDecision and tokenType on issuing.Authorization.token_details and issuing.Token
  • Add support for tokenDecisionRecommendation on issuing.Authorization.token_details.network_data.visa and issuing.Token.network_data.visa
  • Add support for language on issuing.Token.network_data.device
  • Add support for digitalAssetCategory on PaymentIntentConfirmParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentConfirmParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card.payment_details.money_services.account_funding, PaymentIntentCreateParams.payment_method_options.card_present.payment_details.money_services.account_funding, PaymentIntentUpdateParams.payment_method_options.card.payment_details.money_services.account_funding, and PaymentIntentUpdateParams.payment_method_options.card_present.payment_details.money_services.account_funding
  • Add support for staticAddress on PaymentIntent.payment_method_options.crypto.deposit_options, PaymentIntentConfirmParams.payment_method_options.crypto.deposit_options, PaymentIntentCreateParams.payment_method_options.crypto.deposit_options, and PaymentIntentUpdateParams.payment_method_options.crypto.deposit_options
  • Add support for paymentReference on PaymentIntentCreateParams.payments_orchestration
  • ⚠️ Remove support for paymentDetails on PaymentIntentCreateParams.payments_orchestration
  • ⚠️ Change type of PaymentIntent.payment_details.money_services.transactionType from literal('account_funding') to enum('account_funding'|'debt_repayment')
  • Add support for endingBefore, limit, and startingAfter on PaymentLocationListParams
  • ⚠️ Change radar.IssuingAuthorizationEvaluationCreateParams.card_details.last4 to be required
  • Add support for schema on v2.data.reporting.QueryRun.result.file and v2.reporting.ReportRun.result.file
  • Add support for include on v2.data.reporting.QueryRunRetrieveParams and v2.reporting.ReportRunRetrieveParams
  • Add support for requirementsCollector on v2.core.AccountCreateParams.defaults.responsibilities and v2.core.AccountUpdateParams.defaults.responsibilities
  • Add support for event notification V2SignalsAccountSignalMerchantDelinquencyReadyEvent with related object v2.signals.AccountSignal
  • ⚠️ Renames v2.PaymentService to v2.PaymentsService to more closely match our API naming

See the changelog for more details.

v32.3.0-beta.1

This release changes the pinned API version to 2026-05-27.private.

• #2212 Update generated code for beta
  • Add support for pause method on resource Subscription
  • Add support for retrieve method on resource v2.iam.ActivityLog
  • ⚠️ Change type of productcatalog.TrialOffer.end_behavior.transition.price from string to expandable($Price)
  • Add support for amountPaidOffStripe on QuotePreviewInvoice
  • Add support for discountable on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]
  • Add support for bizum and scalapay on sharedpayment.GrantedToken.payment_method_details
  • Add support for paymentBehavior on SubscriptionResumeParams
  • Add support for statusDetails on Subscription
  • ⚠️ Change type of v2.moneymanagement.ReceivedCredit.bank_transfer.gb_bank_account.network from literal('fps') to enum('chaps'|'fps')
  • Add support for new value chaps on enum v2.FinancialAddressCreditSimulationCreditParams.network

See the changelog for more details.

v32.3.0-alpha.1

This release changes the pinned API version to 2026-05-27.private.

• #2221 Update generated code for private-preview
  • Change type of billing.AlertCreateParams.spend_threshold.groupBy from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')
  • ⚠️ Change type of billing.Alert.spend_threshold.groupBy from literal('pricing_plan_subscription') to enum('billing_cadence'|'pricing_plan_subscription')
  • Add support for wechatPay on Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, QuotePreviewInvoice.payment_settings.payment_method_options, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for giftCard on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_options
  • Add support for paymentDetails on PaymentIntentCreateParams.payments_orchestration
  • Add support for enabled on PaymentIntent.payment_details.benefit.fr_meal_voucher and SetupIntent.setup_details.benefit.fr_meal_voucher
  • ⚠️ Remove support for loginFailed, registrationFailed, registrationSuccess, and type on radar.CustomerEvaluationUpdateParams
  • ⚠️ Remove support for latestVersion on v2.billing.LicenseFee, v2.billing.PricingPlan, and v2.billing.RateCard
  • ⚠️ Remove support for serviceIntervalCount and serviceInterval on v2.billing.LicenseFee and v2.billing.RateCard
  • Add support for debitAgreement on v2.moneymanagement.ReceivedCredit.stripe_balance_payment
  • Add support for new value chaps on enum v2.FinancialAddressCreditSimulationCreditParams.network
  • Add support for canonicalPath on EventsV2CoreHealthTrafficVolumeDropFiringEvent.impact and EventsV2CoreHealthTrafficVolumeDropResolvedEvent.impact
  • Add support for snapshot event payment_intent.expired with resource PaymentIntent
  • Add support for event notifications V2CoreHealthElementsErrorFiringEvent, V2CoreHealthElementsErrorResolvedEvent, V2CoreHealthInvoiceCountDroppedFiringEvent, and V2CoreHealthInvoiceCountDroppedResolvedEvent

See the changelog for more details.

v32.2.0

This release changes the pinned API version to 2026-05-27.dahlia.

• #2220 Update generated code
  • Add support for new resource v2.commerce.ProductCatalogImport
  • Add support for create and retrieve methods on resource v2.commerce.ProductCatalogImport
  • Add support for bizumPayments and scalapayPayments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for automaticTransferRulesByCurrency on BalanceSettings.payments.payouts and BalanceSettingsUpdateParams.payments.payouts
  • Add support for startOfDay on BalanceSettings.payments.settlement_timing and BalanceSettingsUpdateParams.payments.settlement_timing
  • Add support for description on ChargeCreateParams.transfer_data, PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • Add support for bizum on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_data, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_data, SetupIntentCreateParams.payment_method_options, SetupIntentUpdateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_options
  • Add support for scalapay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, PaymentAttemptRecord.payment_method_details, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, checkout.Session.payment_method_options, and checkout.SessionCreateParams.payment_method_options
  • Add support for mandate on Charge.payment_method_details.twint, PaymentAttemptRecord.payment_method_details.twint, and PaymentRecord.payment_method_details.twint
  • Add support for new values bizum and scalapay on enums PaymentIntentConfirmParams.excludedPaymentMethodTypes, PaymentIntentCreateParams.excludedPaymentMethodTypes, PaymentIntentUpdateParams.excludedPaymentMethodTypes, SetupIntentCreateParams.excludedPaymentMethodTypes, SetupIntentUpdateParams.excludedPaymentMethodTypes, and checkout.SessionCreateParams.excludedPaymentMethodTypes
  • Change type of PaymentIntentConfirmParams.payment_method_options.twint.setupFutureUsage, PaymentIntentCreateParams.payment_method_options.twint.setupFutureUsage, PaymentIntentUpdateParams.payment_method_options.twint.setupFutureUsage, and checkout.SessionCreateParams.payment_method_options.twint.setupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enum checkout.SessionCreateParams.paymentMethodTypes
  • ⚠️ Change type of PaymentIntent.payment_method_options.twint.setupFutureUsage and checkout.Session.payment_method_options.twint.setupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for new values bizum and scalapay on enums ConfirmationTokenCreateParams.payment_method_data.type, PaymentIntentConfirmParams.payment_method_data.type, PaymentIntentCreateParams.payment_method_data.type, PaymentIntentUpdateParams.payment_method_data.type, SetupIntentConfirmParams.payment_method_data.type, SetupIntentCreateParams.payment_method_data.type, and SetupIntentUpdateParams.payment_method_data.type
  • Add support for new values bizum and scalapay on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.type
  • Add support for creditedItems on InvoiceItem.proration_details
  • Add support for new value twint on enums InvoiceCreateParams.payment_settings.paymentMethodTypes, InvoiceUpdateParams.payment_settings.paymentMethodTypes, SubscriptionCreateParams.payment_settings.paymentMethodTypes, and SubscriptionUpdateParams.payment_settings.paymentMethodTypes
  • Add support for discountable on InvoiceCreatePreviewParams.schedule_details.phases[].add_invoice_items[], SubscriptionCreateParams.add_invoice_items[], SubscriptionSchedule.phases[].add_invoice_items[], SubscriptionScheduleCreateParams.phases[].add_invoice_items[], SubscriptionScheduleUpdateParams.phases[].add_invoice_items[], and SubscriptionUpdateParams.add_invoice_items[]
  • Add support for billingSchedules on InvoiceCreatePreviewParams.subscription_details, SubscriptionCreateParams, SubscriptionUpdateParams, and Subscription
  • Add support for new value max_billed_until on enums InvoiceCreatePreviewParams.subscription_details.cancelAt, SubscriptionCreateParams.cancelAt, and SubscriptionUpdateParams.cancelAt
  • Add support for amountPaidOffStripe on Invoice
  • Add support for twint on Mandate.payment_method_details and SetupAttempt.payment_method_details
  • Add support for metadata on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, PaymentIntentUpdateParams.transfer_data, and Subscription.pending_update
  • Add support for paymentData on PaymentIntent.transfer_data, PaymentIntentCreateParams.transfer_data, and PaymentIntentUpdateParams.transfer_data
  • Add support for blikAuthorize on PaymentIntent.next_action and SetupIntent.next_action
  • Add support for paymentMethodOptions on PaymentLinkCreateParams, PaymentLinkUpdateParams, and PaymentLink
  • Add support for new value bizum on enums PaymentLinkCreateParams.paymentMethodTypes and PaymentLinkUpdateParams.paymentMethodTypes
  • Add support for active on PaymentMethodConfigurationListParams
  • Add support for billedUntil on SubscriptionItem
  • Add support for discount and discounts on Subscription.pending_update
  • Add support for verifoneM425, verifoneP630, verifoneUx700, and verifoneV660p on terminal.ConfigurationCreateParams, terminal.ConfigurationUpdateParams, and terminal.Configuration
  • Add support for new values simulated_verifone_m425, simulated_verifone_p630, simulated_verifone_ux700, simulated_verifone_v660p, verifone_m425, verifone_p630, verifone_ux700, and verifone_v660p on enum terminal.ReaderListParams.deviceType
  • Add support for apiError and printContent on terminal.Reader.action
  • Add support for customer on testhelpers.TestClockCreateParams
  • Add support for new value 2026-05-27.dahlia on enum WebhookEndpointCreateParams.apiVersion
  • Add support for signer on v2.core.Account.identity.business_details.documents.proof_of_registration, v2.core.Account.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, v2.core.AccountCreateParams.identity.business_details.documents.proof_of_registration, v2.core.AccountCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, v2.core.AccountTokenCreateParams.identity.business_details.documents.proof_of_registration, v2.core.AccountTokenCreateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership, v2.core.AccountUpdateParams.identity.business_details.documents.proof_of_registration, and v2.core.AccountUpdateParams.identity.business_details.documents.proof_of_ultimate_beneficial_ownership
  • Add support for azureEventGrid on v2.core.EventDestinationCreateParams and v2.core.EventDestination
  • Add support for new value azure_event_grid on enum v2.core.EventDestinationCreateParams.type
  • Add support for new value meter_event_value_too_many_digits on enums EventsV1BillingMeterErrorReportTriggeredEvent.reason.error_types[].code and EventsV1BillingMeterNoMeterFoundEvent.reason.error_types[].code
  • Add support for event notifications V2CommerceProductCatalogImportsFailedEvent, V2CommerceProductCatalogImportsProcessingEvent, V2CommerceProductCatalogImportsSucceededEvent, and V2CommerceProductCatalogImportsSucceededWithErrorsEvent with related object v2.commerce.ProductCatalogImport
• #2219 Emit warning when stripe-notify header is present in response
• #2218 Add better example for accessing non-documented properties in a list response

See the changelog for more details.