This release changes the pinned API version to 2026-02-25.preview.

• #2006 Update generated code for beta
  • Add support for smart_disputes on Account.create().$params.setting, Account.settings, Account.update().$params.setting, V2.Core.Account.configuration.merchant, V2\Core\Account.create().$params.configuration.merchant, and V2\Core\Account.update().$params.configuration.merchant
  • Add support for email_customers_on_successful_payment on Account.create().$params.setting.payment, Account.settings.payments, and Account.update().$params.setting.payment
  • Add support for managed_payments on Checkout.Session, Checkout\Session.create().$params, PaymentIntent, SetupIntent, and Subscription
  • Add support for new value lk_vat on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].type
  • Add support for new value pay_by_bank on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Add support for new values bt_bank_account, cr_bank_account, do_bank_account, gt_bank_account, md_bank_account, mk_bank_account, mo_bank_account, mz_bank_account, pe_bank_account, pk_bank_account, tw_bank_account, and uz_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for purpose on V2.MoneyManagement.OutboundPayment and V2\MoneyManagement\OutboundPayment.create().$params
  • Add support for branch_number and swift_code on V2.MoneyManagement.PayoutMethod.bank_account
  • Change V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow to be optional
  • Add support for error codes storer_capability_missing and storer_capability_not_active on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

This release changes the pinned API version to 2026-02-25.preview.

• #2013 Update generated code for private-preview
  • Add support for new resource AccountSignals
  • Add support for retrieve method on resource AccountSignals
  • Add support for aggregation_period, group_by, and triggered_at on Billing.AlertTriggered
  • Add support for external_account_collection on AccountLink.create().$params.collection_option
  • Add support for funding_source on ApplicationFee
  • Change DelegatedCheckout\RequestedSession.confirm().$params.payment_method_datum.billing_detail.address.line1, DelegatedCheckout\RequestedSession.create().$params.fulfillment_detail.address.line1, DelegatedCheckout\RequestedSession.create().$params.payment_method_datum.billing_detail.address.line1, DelegatedCheckout\RequestedSession.update().$params.fulfillment_detail.address.line1, and DelegatedCheckout\RequestedSession.update().$params.payment_method_datum.billing_detail.address.line1 to be optional
  • Add support for hosted and ui_mode on FinancialConnections.Session and FinancialConnections\Session.create().$params
  • Add support for url on FinancialConnections.Session
  • Add support for billing_cycle_anchor on Subscription.create().$params.trial_setting.end_behavior and Subscription.update().$params.trial_setting.end_behavior

See the changelog for more details.

This release changes the pinned API version to 2026-02-25.clover.

• #2016 Update generated code
  • Add support for new resources Reserve.Hold, Reserve.Plan, and Reserve.Release
  • Add support for location and reader on Charge.payment_method_details.card_present, Charge.payment_method_details.interac_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.card_present, PaymentAttemptRecord.payment_method_details.interac_present, PaymentMethod.card.generated_from.payment_method_details.card_present, PaymentRecord.payment_method_details.card_present, and PaymentRecord.payment_method_details.interac_present
  • Add support for new value lk_vat on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Add support for new values reserve.hold.created, reserve.hold.updated, reserve.plan.created, reserve.plan.disabled, reserve.plan.expired, reserve.plan.updated, and reserve.release.created on enum Event.type
  • Add support for new values terminal_wifi_certificate and terminal_wifi_private_key on enum File.purpose
  • Add support for new value pay_by_bank on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for display_name and service_user_number on Mandate.payment_method_details.bacs_debit
  • Change type of PaymentAttemptRecord.payment_method_details.boleto.tax_id and PaymentRecord.payment_method_details.boleto.tax_id from string to nullable(string)
  • Change type of PaymentAttemptRecord.payment_method_details.us_bank_account.expected_debit_date and PaymentRecord.payment_method_details.us_bank_account.expected_debit_date from nullable(string) to string
  • Add support for transaction_purpose on PaymentIntent.confirm().$params.payment_method_option.us_bank_account, PaymentIntent.create().$params.payment_method_option.us_bank_account, PaymentIntent.payment_method_options.us_bank_account, and PaymentIntent.update().$params.payment_method_option.us_bank_account
  • Add support for optional_items on PaymentLink.update().$params
  • Remove support for unused card_issuer_decline on Radar.PaymentEvaluation.insights
  • Add support for payment_behavior on SubscriptionItem.delete().$params
  • Add support for lk on Tax.Registration.country_options and Tax\Registration.create().$params.country_option
  • Add support for cellular and stripe_s710 on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
  • Add support for new values simulated_stripe_s710 and stripe_s710 on enum Terminal.Reader.device_type
  • Add support for snapshot events RESERVE_HOLD_CREATED and RESERVE_HOLD_UPDATED with resource Reserve.Hold
  • Add support for snapshot events RESERVE_PLAN_CREATED, RESERVE_PLAN_DISABLED, RESERVE_PLAN_EXPIRED, and RESERVE_PLAN_UPDATED with resource Reserve.Plan
  • Add support for snapshot event RESERVE_RELEASE_CREATED with resource Reserve.Release
  • Add support for error codes storer_capability_missing and storer_capability_not_active on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError

See the changelog for more details.

• #2010 Update generated code for private-preview
  • Add support for spend_threshold on Billing.Alert and Billing\Alert.create().$params
  • ⚠️ Add support for new value spend_threshold on enum Billing.Alert.alert_type
  • Add support for invoice_item, proration_details, proration, and subscription on InvoiceLineItem.parent.schedule_details
  • Add support for custom on PaymentMethod.update().$params
  • Add support for payment_method_reference and usage on PaymentMethod.custom
  • Add support for outstanding_usage_through and unused_time_from on Subscription.pause().$params.bill_for
  • ⚠️ Remove support for outstanding_usage and unused_time on Subscription.pause().$params.bill_for
  • ⚠️ Remove support for payment_behavior on Subscription.resume().$params

See the changelog for more details.

Read more

• #2005 Update generated code for private-preview
  • Add support for new resource V2.Core.ConnectionSession
  • Add support for create and retrieve methods on resource V2.Core.ConnectionSession
  • Add support for all method on resources V2.Payments.SettlementAllocationIntentSplit and V2.Payments.SettlementAllocationIntent
  • Add support for agentic_commerce_settings on AccountSession.create().$params.component
  • Add support for terminal_hardware_orders and terminal_hardware_shop on AccountSession.components and AccountSession.create().$params.component
  • Add support for network_cost_passthrough_report on AccountSession.components
  • Add support for new values ae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enums V2.Account.configuration.recipient_data.default_outbound_destination.type and V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for cadence_data on V2.Billing.Intent and V2\Billing\Intent.create().$params
  • Add support for cancellation_details on V2.Billing.IntentAction.deactivate, V2.Billing.PricingPlanSubscription, and V2\Billing\Intent.create().$params.action.deactivate
  • Add support for contact_phone on V2.Core.Account, V2\Core\Account.create().$params, V2\Core\Account.update().$params, and V2\Core\AccountToken.create().$params
  • Add support for registration_date on V2.Core.Account.identity.business_details, V2\Core\Account.create().$params.identity.business_detail, V2\Core\Account.update().$params.identity.business_detail, and V2\Core\AccountToken.create().$params.identity.business_detail
  • Add support for new value gb_vat on enum V2.Core.Account.identity.business_details.id_numbers[].type
  • Add support for reference on V2.MoneyManagement.Adjustment
  • Add support for accrued_fees on V2.MoneyManagement.FinancialAccount
  • Add support for starting_balance on V2.MoneyManagement.FinancialAccount.payments
  • Add support for new value accrued_fees on enum V2.MoneyManagement.FinancialAccount.type
  • Add support for account_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • Add support for fingerprint on V2.MoneyManagement.PayoutMethod.card
  • Add support for card_spend on V2.MoneyManagement.ReceivedCredit and V2.MoneyManagement.ReceivedDebit
  • Add support for new value card_spend on enum V2.MoneyManagement.ReceivedCredit.type
  • Add support for new value card_spend on enum V2.MoneyManagement.ReceivedDebit.type
  • Add support for new values advance, anticipation_repayment, balance_transfer, charge_failure, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, connect_reserved_funds, contribution, dispute_reversal, financing_paydown_reversal, financing_paydown, inbound_transfer_reversal, issuing_dispute_fraud_liability_debit, issuing_dispute_provisional_credit_reversal, issuing_dispute_provisional_credit, issuing_dispute, minimum_balance_hold, network_cost, obligation, outbound_payment_reversal, outbound_transfer_reversal, partial_capture_reversal, payment_network_reserved_funds, platform_earning_refund, platform_earning, platform_fee, received_credit_reversal, received_debit_reversal, refund_failure, risk_reserved_funds, stripe_balance_payment_debit_reversal, stripe_balance_payment_debit, stripe_fee_tax, transfer_reversal, and unreconciled_customer_funds on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for application_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • Add support for new values application_fee_refund, application_fee, charge, dispute, payout, refund, reserve_hold, reserve_release, topup, transfer_reversal, and transfer on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Change V2.Payments.SettlementAllocationIntentSplit.flow to be optional
  • Change V2\Billing\RateCardRate.create().$params.metered_item to be required

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.preview.

• #1988 Update generated code for beta
  • Add support for new resource FinancialConnections.Authorization
  • Add support for retrieve method on resource FinancialConnections.Authorization
  • Add support for detach_payment method on resource Invoice
  • Remove support for cancel, list_line_items, and reopen methods on resource Order
  • Remove support for attach_cadence method on resource Subscription
  • Add support for additional_files and site on Account.create().$params.setting.paypay_payment, Account.settings.paypay_payments, and Account.update().$params.setting.paypay_payment
  • Remove support for capital on Account.settings
  • Change type of Charge.payment_method_details.stripe_balance.source_type, ConfirmationToken.payment_method_preview.stripe_balance.source_type, PaymentAttemptRecord.payment_method_details.stripe_balance.source_type, PaymentMethod.stripe_balance.source_type, and PaymentRecord.payment_method_details.stripe_balance.source_type from enum('bank_account'|'card'|'fpx') to nullable(enum('bank_account'|'card'|'fpx'))
  • Add support for new value pl_nip on enums Checkout.Session.collected_information.tax_ids[].type, Order.tax_details.tax_ids[].type, and QuotePreviewInvoice.customer_tax_ids[].type
  • Add support for new value capital.financing_summary.line_of_credit_update on enum Event.type
  • Add support for authorization and status_details on FinancialConnections.Account
  • Add support for relink_options on FinancialConnections.Session and FinancialConnections\Session.create().$params
  • Change FinancialConnections\Session.create().$params.account_holder to be optional
  • Add support for relink_result on FinancialConnections.Session
  • Remove support for billing_cadence on Invoice.create_preview().$params, Subscription.create().$params, Subscription.update().$params, and Subscription
  • Remove support for billing_cadence_details on Invoice.parent and QuotePreviewInvoice.parent
  • Remove support for value billing_cadence_details from enums Invoice.parent.type and QuotePreviewInvoice.parent.type
  • Add support for car_rental_data, flight_data, and lodging_data on PaymentIntent.payment_details
  • Change QuotePreviewInvoice.payment_settings.payment_method_options.payto to be required
  • Add support for new values ae_bank_account, ag_bank_account, bh_bank_account, gm_bank_account, hk_bank_account, kh_bank_account, lc_bank_account, mc_bank_account, mg_bank_account, my_bank_account, qa_bank_account, rw_bank_account, th_bank_account, tt_bank_account, and vn_bank_account on enum V2.Core.Account.configuration.recipient.default_outbound_destination.type
  • Add support for alternative_reference on V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccount, and V2.MoneyManagement.PayoutMethod
  • Add support for account_holder_address and account_holder_name on V2.MoneyManagement.FinancialAddress.credentials.us_bank_account
  • Add support for fingerprint on V2.MoneyManagement.PayoutMethod.card
  • Add support for snapshot event INVOICE_PAYMENT_DETACHED with resource InvoicePayment
  • Add support for error code request_blocked on QuotePreviewInvoice.last_finalization_error
• #1981 Add EventNotificationHandler example

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.preview.

• #2002 Update generated code for private-preview
  • Add support for new resources FrMealVouchersOnboarding, Reserve.Hold, Reserve.Plan, and Reserve.Release
  • Add support for all, create, retrieve, and update methods on resource FrMealVouchersOnboarding
  • Add support for all and retrieve methods on resources Reserve.Hold and Reserve.Release
  • Add support for retrieve method on resource Reserve.Plan
  • Add support for pause method on resource Subscription
  • Add support for service_period_details on Discount
  • Add support for agentic_commerce_settings on AccountSession.components
  • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
  • Add support for service_period on Coupon.create().$params and Coupon
  • Add support for new value service_period on enum Coupon.duration
  • Change type of InvoiceItem.pricing.price_details.price and InvoiceLineItem.pricing.price_details.price from string to expandable($Price)
  • Add support for settings on Invoice.create_preview().$params.discount, Invoice.create_preview().$params.schedule_detail.amendment.discount_action.add, Invoice.create_preview().$params.schedule_detail.amendment.discount_action.set, Invoice.create_preview().$params.schedule_detail.amendment.item_action.add.discount, Invoice.create_preview().$params.schedule_detail.amendment.item_action.set.discount, Invoice.create_preview().$params.schedule_detail.phase.discount, Invoice.create_preview().$params.schedule_detail.phase.item.discount, Invoice.create_preview().$params.subscription_detail.item.discount, Quote.create().$params.line.action.add_discount, Quote.create().$params.line.action.add_item.discount, Quote.create().$params.line.action.set_discount, Quote.create().$params.line.action.set_item.discount, Quote.update().$params.line.action.add_discount, Quote.update().$params.line.action.add_item.discount, Quote.update().$params.line.action.set_discount, Quote.update().$params.line.action.set_item.discount, Subscription.create().$params.discount, Subscription.create().$params.item.discount, Subscription.update().$params.discount, Subscription.update().$params.item.discount, SubscriptionItem.create().$params.discount, SubscriptionItem.update().$params.discount, SubscriptionSchedule.amend().$params.amendment.discount_action.add, SubscriptionSchedule.amend().$params.amendment.discount_action.set, SubscriptionSchedule.amend().$params.amendment.item_action.add.discount, SubscriptionSchedule.amend().$params.amendment.item_action.set.discount, SubscriptionSchedule.create().$params.phase.discount, SubscriptionSchedule.create().$params.phase.item.discount, SubscriptionSchedule.update().$params.phase.discount, and SubscriptionSchedule.update().$params.phase.item.discount
  • Add support for subtotal on InvoiceLineItem
  • Add support for billing_cadence on Subscription.all().$params

See the changelog for more details.

This release changes the pinned API version to 2026-01-28.clover.

• #2001 Update generated code
  • Add support for new resource Radar.PaymentEvaluation
  • Add support for create method on resource Radar.PaymentEvaluation
  • Add support for adjustable_quantity on LineItem
  • Add support for new value risk_reserved on enum BalanceTransaction.balance_type
  • Add support for new values reserve_hold and reserve_release on enum BalanceTransaction.type
  • Add support for new values 2.3.0 and 2.3.1 on enums Charge.payment_method_details.card.three_d_secure.version and SetupAttempt.payment_method_details.card.three_d_secure.version
  • Add support for new value adyen on enums Charge.payment_method_details.ideal.bank, ConfirmationToken.payment_method_preview.ideal.bank, PaymentAttemptRecord.payment_method_details.ideal.bank, PaymentMethod.ideal.bank, PaymentRecord.payment_method_details.ideal.bank, and SetupAttempt.payment_method_details.ideal.bank
  • Add support for new value ADYBNL2A on enums Charge.payment_method_details.ideal.bic, ConfirmationToken.payment_method_preview.ideal.bic, PaymentAttemptRecord.payment_method_details.ideal.bic, PaymentMethod.ideal.bic, PaymentRecord.payment_method_details.ideal.bic, and SetupAttempt.payment_method_details.ideal.bic
  • Add support for new value pl_nip on enums Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.type
  • Change Invoice.payment_settings.payment_method_options.payto and Subscription.payment_settings.payment_method_options.payto to be required
  • Add support for enforce_arithmetic_validation on PaymentIntent.capture().$params.amount_detail, PaymentIntent.confirm().$params.amount_detail, PaymentIntent.create().$params.amount_detail, PaymentIntent.increment_authorization().$params.amount_detail, and PaymentIntent.update().$params.amount_detail
  • Add support for error on PaymentIntent.amount_details
  • Remove support for bgn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
  • Add support for topup on Treasury.ReceivedDebit.linked_flows
  • Add support for contact_phone on V2.Core.Account, V2\Core\Account.create().$params, V2\Core\Account.update().$params, and V2\Core\AccountToken.create().$params
  • Add support for registration_date on V2.Core.Account.identity.business_details, V2\Core\Account.create().$params.identity.business_detail, V2\Core\Account.update().$params.identity.business_detail, and V2\Core\AccountToken.create().$params.identity.business_detail
  • Add support for new value gb_vat on enum V2.Core.Account.identity.business_details.id_numbers[].type
  • Add support for error code request_blocked on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #2000 Add guidance for undocumented API parameters

See the changelog for more details.

• #1998 Update generated code for private-preview
  • Remove support for pause method on resource Subscription
  • Change type of Quote.subscription_data.phase_effective_at and Quote.subscription_data_overrides[].phase_effective_at from enum('billing_period_start'|'phase_start') to nullable(enum('billing_period_start'|'phase_start'))

See the changelog for more details.