NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4265 most downloaded on npm
Stripe API wrapper
Latest stable
23.1.0
Last release 11 days ago
11 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
15 years old
815 releases · first in 2011
Drag across the ruler to compare, or tap a release to open it.
Remove support for amount_overpaid on InvoicePayment
#2288 Update generated code for beta
This release changes the pinned API version to 2025-03-31.preview
amount_overpaid on InvoicePaymentout_of_band_payment and payment_record from enum InvoicePayment.payment.typeinterchange_fees, net_total, network_fees, and transaction_volume on Issuing.Settlementbilling_thresholds on QuotePreviewSubscriptionSchedule.default_settings, QuotePreviewSubscriptionSchedule.phases[].items[], and QuotePreviewSubscriptionSchedule.phases[]coupon on QuotePreviewSubscriptionSchedule.phases[]value on Terminal.Reader.action.collect_inputs.inputs[].selection.choices[], Terminal.Reader.action.collect_inputs.inputs[].selection, and Terminal.ReaderCollectInputsParams.inputs[].selection.choices[]Checkout.Session.permissions.update to be optionalInvoicePayment.is_default from boolean | null to booleanInvoice.amount_overpaid and QuotePreviewInvoice.amount_overpaid to be requiredPaymentAttemptRecord.payment_method_details.type and PaymentRecord.payment_method_details.type from literal('custom') to stringPaymentAttemptRecord.payment_record from string to string | nullPaymentAttemptRecord.payment_method_details.custom and PaymentRecord.payment_method_details.custom to be optionalPaymentRecordReportPaymentParams.payment_reference to be optionalPaymentRecord.latest_payment_attempt_record from string to string | nullBalanceSettingsretrieve and update methods on resource BalanceSettingscreate, del, list, retrieve, and update methods on a new ExternalAccountService class to access cards and bank accounts made available in the new path v1/external_accounts. Access this via StripeClient.externalAccountsstripe_balance_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiescustomer_account on Billing.CreditBalanceSummaryRetrieveParams, Billing.CreditBalanceSummary, Billing.CreditBalanceTransactionListParams, Billing.CreditGrantCreateParams, Billing.CreditGrantListParams, Billing.CreditGrant, BillingPortal.SessionCreateParams, BillingPortal.Session, Checkout.SessionCreateParams, Checkout.SessionListParams, Checkout.Session, ConfirmationToken.payment_method_preview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerCashBalance, CustomerPaymentMethod, CustomerSessionCreateParams, CustomerSession, CustomerTaxId.owner, CustomerTaxId, Customer, Discount, FinancialConnections.Account.account_holder, FinancialConnections.AccountListParams.account_holder, FinancialConnections.Session.account_holder, FinancialConnections.SessionCreateParams.account_holder, InvoiceCreateParams, InvoiceCreatePreviewParams, InvoiceItemCreateParams, InvoiceItemListParams, InvoiceItem, InvoiceListParams, Invoice, PaymentIntentCreateParams, PaymentIntentListParams, PaymentIntentUpdateParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethod, PromotionCodeCreateParams, PromotionCodeListParams, PromotionCode, QuoteCreateParams, QuoteListParams, QuotePreviewInvoice, QuotePreviewSubscriptionSchedule, QuoteUpdateParams, Quote, SetupAttempt, SetupIntentCreateParams, SetupIntentListParams, SetupIntentUpdateParams, SetupIntent, SubscriptionCreateParams, SubscriptionListParams, SubscriptionScheduleCreateParams, SubscriptionScheduleListParams, SubscriptionSchedule, Subscription, TaxId.owner, TaxIdCreateParams.owner, TaxIdListParams.owner, and TaxIdstripe_balance on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, 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, PaymentMethodCreateParams, PaymentMethod, PaymentRecord.payment_method_details, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataupdate_line_items and update_shipping_details on Checkout.Session.permissions and Checkout.SessionCreateParams.permissionsprovider on Checkout.Session.automatic_tax, Invoice.automatic_tax, Quote.automatic_tax, and QuotePreviewInvoice.automatic_taxtax_calculation_reference on CreditNoteLineItem, CreditNotePreviewLines, InvoiceLineItem, LineItem, PaymentLinkLineItem, QuoteComputedUpfrontLineItems, QuoteLineItem, and SessionLineItempayment_method_options on ConfirmationTokenCreateParams.testHelpersinstallments on ConfirmationToken.payment_method_options.cardcontext on Eventrelated_customer_account on Identity.VerificationSession, identity.VerificationSessionCreateParams, and identity.VerificationSessionListParamsnetwork_data on Issuing.DisputeSettlementDetailinterchange_fees_amount, net_total_amount, network_fees_amount, other_fees_amount, other_fees_count, and transaction_amount on Issuing.Settlementreported_by on PaymentAttemptRecordach_credit_transfer, ach_debit, acss_debit, affirm, afterpay_clearpay, alipay, alma, amazon_pay, au_becs_debit, bacs_debit, bancontact, blik, boleto, card_present, card, cashapp, customer_balance, eps, fpx, giropay, gopay, grabpay, id_bank_transfer, ideal, interac_present, kakao_pay, klarna, konbini, kr_card, link, mb_way, mobilepay, multibanco, naver_pay, nz_bank_account, oxxo, p24, pay_by_bank, payco, paynow, paypal, payto, pix, promptpay, qris, rechnung, revolut_pay, samsung_pay, satispay, sepa_credit_transfer, sepa_debit, shopeepay, sofort, stripe_account, swish, twint, us_bank_account, wechat_pay, wechat, and zip on PaymentAttemptRecord.payment_method_details and PaymentRecord.payment_method_detailspayout_method on PayoutCreateParams and Payoutconfirmation_secret, parent, and total_taxes on QuotePreviewInvoiceforwarding_api_retryable_upstream_error, setup_intent_mobile_wallet_unsupported, v2_account_disconnection_unsupported, and v2_account_missing_configuration on enum QuotePreviewInvoice.last_finalization_error.codeklarna, nz_bank_account, and stripe_balance on enum QuotePreviewInvoice.payment_settings.payment_method_typesid and text on Terminal.Reader.action.collect_inputs.inputs[].selection.choices[], Terminal.Reader.action.collect_inputs.inputs[].selection, and Terminal.ReaderCollectInputsParams.inputs[].selection.choices[]V2.FinancialAddressCreditSimulation, V2.FinancialAddressGeneratedMicrodeposits, V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.FinancialAddress, V2.MoneyManagement.InboundTransfer, V2.MoneyManagement.OutboundPaymentQuote, V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundSetupIntent, V2.MoneyManagement.OutboundTransfer, V2.MoneyManagement.PayoutMethod, V2.MoneyManagement.PayoutMethodsBankAccountSpec, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transactioncreate method on resource V2.MoneyManagement.OutboundPaymentQuotelist and retrieve methods on resources V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transactioncreate, list, and retrieve methods on resources V2.MoneyManagement.FinancialAddress and V2.MoneyManagement.InboundTransfercancel, create, list, and retrieve methods on resources V2.MoneyManagement.OutboundPayment and V2.MoneyManagement.OutboundTransferarchive, list, retrieve, and unarchive methods on resource V2.MoneyManagement.PayoutMethodcancel, create, list, retrieve, and update methods on resource V2.MoneyManagement.OutboundSetupIntentretrieve method on resource V2.MoneyManagement.PayoutMethodsBankAccountSpecaccount_number, fedwire_routing_number, and routing_number on enum invalid_payment_method.invalid_paramV2MoneyManagementFinancialAccountCreatedEvent with related object V2.MoneyManagement.FinancialAccountV2MoneyManagementFinancialAddressActivatedEvent and V2MoneyManagementFinancialAddressFailedEvent with related object V2.MoneyManagement.FinancialAddressV2MoneyManagementInboundTransferAvailableEvent, V2MoneyManagementInboundTransferBankDebitFailedEvent, V2MoneyManagementInboundTransferBankDebitProcessingEvent, V2MoneyManagementInboundTransferBankDebitQueuedEvent, V2MoneyManagementInboundTransferBankDebitReturnedEvent, and V2MoneyManagementInboundTransferBankDebitSucceededEvent with related object V2.MoneyManagement.InboundTransferV2MoneyManagementOutboundPaymentCanceledEvent, V2MoneyManagementOutboundPaymentCreatedEvent, V2MoneyManagementOutboundPaymentFailedEvent, V2MoneyManagementOutboundPaymentPostedEvent, and V2MoneyManagementOutboundPaymentReturnedEvent with related object V2.MoneyManagement.OutboundPaymentV2MoneyManagementOutboundTransferCanceledEvent, V2MoneyManagementOutboundTransferCreatedEvent, V2MoneyManagementOutboundTransferFailedEvent, V2MoneyManagementOutboundTransferPostedEvent, and V2MoneyManagementOutboundTransferReturnedEvent with related object V2.MoneyManagement.OutboundTransferV2MoneyManagementReceivedCreditAvailableEvent, V2MoneyManagementReceivedCreditFailedEvent, V2MoneyManagementReceivedCreditReturnedEvent, and V2MoneyManagementReceivedCreditSucceededEvent with related object V2.MoneyManagement.ReceivedCreditV2MoneyManagementReceivedDebitCanceledEvent, V2MoneyManagementReceivedDebitFailedEvent, V2MoneyManagementReceivedDebitPendingEvent, V2MoneyManagementReceivedDebitSucceededEvent, and V2MoneyManagementReceivedDebitUpdatedEvent with related object V2.MoneyManagement.ReceivedDebitAlreadyCanceledError, BlockedByStripeError, ControlledByDashboardError, FeatureNotEnabledError, FinancialAccountNotOpenError, InsufficientFundsError, InvalidPayoutMethodError, NotCancelableError, and RecipientNotNotifiableErrorSee SaaS platform payments with subscription billing using Accounts v2
V2.Core.AccountLink, V2.Core.Account, V2.Core.Person, V2.Core.Vault.GbBankAccount, V2.Core.Vault.UsBankAccountclose, create, list, retrieve, and update methods on resource V2.Core.Accountcreate method on resource V2.Core.AccountLinkacknowledge_confirmation_of_payee, archive, create, initiate_confirmation_of_payee, and retrieve methods on resource V2.Core.Vault.GbBankAccountarchive, create, retrieve, and update methods on resource V2.Core.Vault.UsBankAccountV2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationCustomerUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationMerchantUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent, V2CoreAccountIncludingConfigurationRecipientUpdatedEvent, V2CoreAccountIncludingIdentityUpdatedEvent, and V2CoreAccountIncludingRequirementsUpdatedEventV2CoreAccountLinkCompletedEvent with related object V2.Core.AccountLinkV2CoreAccountPersonCreatedEvent, V2CoreAccountPersonDeletedEvent, and V2CoreAccountPersonUpdatedEvent with related object V2.Core.PersonBilling.CreditBalanceSummaryRetrieveParams.customer, Billing.CreditBalanceTransactionListParams.customer, Billing.CreditGrantCreateParams.customer, BillingPortal.SessionCreateParams.customer, CustomerSessionCreateParams.customer, InvoiceItemCreateParams.customer, PaymentMethodAttachParams.customer, and SubscriptionCreateParams.customer to be optionalCreditNote.refunds to be requiredPaymentAttemptRecord.payment_method_details.custom and PaymentRecord.payment_method_details.custom from PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails | null to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetailsOrderCreateParams.payment.settings.payment_method_options.wechat_pay.client and OrderUpdateParams.payment.settings.payment_method_options.wechat_pay.client to be optionalYour coding agent can read these notes before it upgrades. Set up the MCP server →
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
#2279 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to 2025-03-31.basil.
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
SubscriptionItemUsageRecordSummary and SubscriptionItemUsageRecordlistUpcomingLines and retrieveUpcoming methods on resource InvoicecreateUsageRecord and listUsageRecordSummaries methods on resource SubscriptionItemsinvoice on Charge and PaymentIntentshipping_details on Checkout.Sessioncarrier, phone, and tracking_number on Checkout.Session.collected_information.shipping_details. Make name and address required instead of optional.refund on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetax_amounts on CreditNoteLineItem, CreditNote, and InvoiceLineItemamount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItemcoupon on CustomerCreateParams, CustomerUpdateParams, InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.phases[], and SubscriptionUpdateParamspromotion_code on CustomerCreateParams, CustomerUpdateParams, SubscriptionCreateParams, and SubscriptionUpdateParamsprice on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]. Use pricing` instead.billing_thresholds on InvoiceCreatePreviewParams.schedule_details.phases[].items[], InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionCreateParams, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, SubscriptionSchedule.default_settings, SubscriptionSchedule.phases[].items[], SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.default_settings, SubscriptionScheduleCreateParams.phases[].items[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.default_settings, SubscriptionScheduleUpdateParams.phases[].items[], SubscriptionScheduleUpdateParams.phases[], SubscriptionUpdateParams.items[], SubscriptionUpdateParams, and Subscriptionapplication_fee_amount, charge, paid_out_of_band, paid, payment_intent, quote, subscription, subscription_details, subscription_proration_date, tax, total_tax_amounts, and transfer_data on Invoicediscount on Invoice and Subscriptioninvoice_item, proration_details, proration, tax_rates, and type on InvoiceLineItemplan and subscription_item on InvoiceItem and InvoiceLineItemunit_amount on InvoiceItemCreateParams, InvoiceItemUpdateParams, and InvoiceItemsubscription and unit_amount_decimal on InvoiceItemnaver_pay on PaymentMethodUpdateParamsaggregate_usage on PlanCreateParams, Plan, Price.recurring, and PriceCreateParams.recurringcurrent_period_end and current_period_start on Subscriptionpage has been removed from all V2 list method params (e.g. EventService.list()); use the auto paginator or the next_page_url and previous_page_url fields instead (more info)Checkout.Session.collected_information to be requiredCheckout.Session.collected_information.shipping_details to be requiredCheckout.Session.collected_information.shipping_details.address to be requiredCheckout.Session.collected_information.shipping_details.name to be requiredPaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.client to be optionalpolitical_exposure on resources Person and Token and params Token.CreateParams from string to enum("existing" | "none")InvoicePaymentlist and retrieve methods on resource InvoicePaymentbillie_payments, nz_bank_account_becs_debit_payments, and satispay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitieshosted_payment_method_save on Account.settings.invoices and AccountUpdateParams.settings.invoicesinvoices on AccountCreateParams.settingsinformation_missing, invalid_signator, verification_failed_authorizer_authority, and verification_rejected_ownership_exemption_reason on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, AccountCapability.future_requirements.errors[].code, AccountCapability.requirements.errors[].code, AccountPerson.future_requirements.errors[].code, AccountPerson.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeforwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codestripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.typelast on enums Billing.Meter.default_aggregation.formula and Billing.MeterCreateParams.default_aggregation.formulapresentment_details on Charge, Checkout.Session, PaymentIntent, and Refundbillie and satispay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datanz_bank_account on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, Mandate.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, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataoptional_items on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLinkpermissions on Checkout.SessionCreateParams and Checkout.Sessionbillie and satispay on enum Checkout.SessionCreateParams.payment_method_typescustom on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modeshipping_options on Checkout.SessionUpdateParamsbillie, nz_bank_account, and satispay on enums ConfirmationTokenCreateParams.testHelpers.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.typebuyer_id on ConfirmationToken.payment_method_preview.naver_pay, CustomerPaymentMethod.naver_pay, and PaymentMethod.naver_paybillie, nz_bank_account, and satispay on enums ConfirmationToken.payment_method_preview.type, CustomerPaymentMethod.type, and PaymentMethod.typerefunds on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetotal_taxes on CreditNote and Invoicetaxes on CreditNoteLineItem and InvoiceLineItemcheckout_session on CustomerBalanceTransactioncheckout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.typebillie, nz_bank_account, and satispay on enums CustomerPaymentMethodListParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeinvoice.overpaid on enum Event.typeklarna and nz_bank_account on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typespricing on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]taxability_reason on InvoiceAddLinesParams.lines[].tax_amounts[], InvoiceLineItemUpdateParams.tax_amounts[], and InvoiceUpdateLinesParams.lines[].tax_amounts[]jurisdiction_level on InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data, InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, and InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_dataamount_overpaid, confirmation_secret, and payments on Invoiceparent on InvoiceItem, InvoiceLineItem, and Invoiceexpired on enums Issuing.Authorization.status and Issuing.AuthorizationListParams.statusnetwork_fallback on enum Issuing.Authorization.request_history[].reasonnaver_pay on Mandate.payment_method_details and SetupAttempt.payment_method_detailssetup_future_usage on PaymentIntent.payment_method_options.naver_pay, PaymentIntentConfirmParams.payment_method_options.naver_pay, PaymentIntentCreateParams.payment_method_options.naver_pay, and PaymentIntentUpdateParams.payment_method_options.naver_payexpired on enum PaymentIntent.cancellation_reasondefault_value on PaymentLink.custom_fields[].dropdown, PaymentLink.custom_fields[].numeric, PaymentLink.custom_fields[].text, PaymentLinkCreateParams.custom_fields[].dropdown, PaymentLinkCreateParams.custom_fields[].numeric, PaymentLinkCreateParams.custom_fields[].text, PaymentLinkUpdateParams.custom_fields[].dropdown, PaymentLinkUpdateParams.custom_fields[].numeric, and PaymentLinkUpdateParams.custom_fields[].textbillie and satispay on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_typesnz_bank_transfer on Refund.destination_detailscanceled on enum Review.closed_reasoncurrent_period_end and current_period_start on SubscriptionItemwifi on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationinvoice.overpaid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2025-03-01.dashboard and 2025-03-31.basil on enum WebhookEndpointCreateParams.api_versionThis release changes the pinned API version to 2025-03-31.basil.
#2279 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to 2025-03-31.basil.
Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
SubscriptionItemUsageRecordSummary and SubscriptionItemUsageRecordlistUpcomingLines and retrieveUpcoming methods on resource InvoicecreateUsageRecord and listUsageRecordSummaries methods on resource SubscriptionItemsinvoice on Charge and PaymentIntentshipping_details on Checkout.Sessioncarrier, phone, and tracking_number on Checkout.Session.collected_information.shipping_details. Make name and address required instead of optional.refund on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetax_amounts on CreditNoteLineItem, CreditNote, and InvoiceLineItemamount_excluding_tax and unit_amount_excluding_tax on CreditNoteLineItem and InvoiceLineItemcoupon on CustomerCreateParams, CustomerUpdateParams, InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams, SubscriptionCreateParams, SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.phases[], and SubscriptionUpdateParamspromotion_code on CustomerCreateParams, CustomerUpdateParams, SubscriptionCreateParams, and SubscriptionUpdateParamsprice on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]. Use pricing` instead.billing_thresholds on InvoiceCreatePreviewParams.schedule_details.phases[].items[], InvoiceCreatePreviewParams.schedule_details.phases[], InvoiceCreatePreviewParams.subscription_details.items[], SubscriptionCreateParams.items[], SubscriptionCreateParams, SubscriptionItemCreateParams, SubscriptionItemUpdateParams, SubscriptionItem, SubscriptionSchedule.default_settings, SubscriptionSchedule.phases[].items[], SubscriptionSchedule.phases[], SubscriptionScheduleCreateParams.default_settings, SubscriptionScheduleCreateParams.phases[].items[], SubscriptionScheduleCreateParams.phases[], SubscriptionScheduleUpdateParams.default_settings, SubscriptionScheduleUpdateParams.phases[].items[], SubscriptionScheduleUpdateParams.phases[], SubscriptionUpdateParams.items[], SubscriptionUpdateParams, and Subscriptionapplication_fee_amount, charge, paid_out_of_band, paid, payment_intent, quote, subscription, subscription_details, subscription_proration_date, tax, total_tax_amounts, and transfer_data on Invoicediscount on Invoice and Subscriptioninvoice_item, proration_details, proration, tax_rates, and type on InvoiceLineItemplan and subscription_item on InvoiceItem and InvoiceLineItemunit_amount on InvoiceItemCreateParams, InvoiceItemUpdateParams, and InvoiceItemsubscription and unit_amount_decimal on InvoiceItemnaver_pay on PaymentMethodUpdateParamsaggregate_usage on PlanCreateParams, Plan, Price.recurring, and PriceCreateParams.recurringcurrent_period_end and current_period_start on Subscriptionpage has been removed from all V2 list method params (e.g. EventService.list()); use the auto paginator or the next_page_url and previous_page_url fields instead (more info)Checkout.Session.collected_information to be requiredCheckout.Session.collected_information.shipping_details to be requiredCheckout.Session.collected_information.shipping_details.address to be requiredCheckout.Session.collected_information.shipping_details.name to be requiredPaymentIntentConfirmParams.payment_method_options.wechat_pay.client, PaymentIntentCreateParams.payment_method_options.wechat_pay.client, and PaymentIntentUpdateParams.payment_method_options.wechat_pay.client to be optionalpolitical_exposure on resources Person and Token and params Token.CreateParams from string to enum("existing" | "none")InvoicePaymentlist and retrieve methods on resource InvoicePaymentbillie_payments, nz_bank_account_becs_debit_payments, and satispay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitieshosted_payment_method_save on Account.settings.invoices and AccountUpdateParams.settings.invoicesinvoices on AccountCreateParams.settingsinformation_missing, invalid_signator, verification_failed_authorizer_authority, and verification_rejected_ownership_exemption_reason on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, AccountCapability.future_requirements.errors[].code, AccountCapability.requirements.errors[].code, AccountPerson.future_requirements.errors[].code, AccountPerson.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeforwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codestripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.typelast on enums Billing.Meter.default_aggregation.formula and Billing.MeterCreateParams.default_aggregation.formulapresentment_details on Charge, Checkout.Session, PaymentIntent, and Refundbillie and satispay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, PaymentIntentConfirmParams.payment_method_data, PaymentIntentCreateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_data, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datanz_bank_account on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, CustomerPaymentMethod, Mandate.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, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataoptional_items on Checkout.SessionCreateParams, Checkout.Session, PaymentLinkCreateParams, and PaymentLinkpermissions on Checkout.SessionCreateParams and Checkout.Sessionbillie and satispay on enum Checkout.SessionCreateParams.payment_method_typescustom on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_modeshipping_options on Checkout.SessionUpdateParamsbillie, nz_bank_account, and satispay on enums ConfirmationTokenCreateParams.testHelpers.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.typebuyer_id on ConfirmationToken.payment_method_preview.naver_pay, CustomerPaymentMethod.naver_pay, and PaymentMethod.naver_paybillie, nz_bank_account, and satispay on enums ConfirmationToken.payment_method_preview.type, CustomerPaymentMethod.type, and PaymentMethod.typerefunds on CreditNoteCreateParams, CreditNoteListPreviewLineItemsParams, CreditNotePreviewParams, and CreditNotetotal_taxes on CreditNote and Invoicetaxes on CreditNoteLineItem and InvoiceLineItemcheckout_session on CustomerBalanceTransactioncheckout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.typebillie, nz_bank_account, and satispay on enums CustomerPaymentMethodListParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeinvoice.overpaid on enum Event.typeklarna and nz_bank_account on enums Invoice.payment_settings.payment_method_types, InvoiceCreateParams.payment_settings.payment_method_types, InvoiceUpdateParams.payment_settings.payment_method_types, Subscription.payment_settings.payment_method_types, SubscriptionCreateParams.payment_settings.payment_method_types, and SubscriptionUpdateParams.payment_settings.payment_method_typespricing on InvoiceAddLinesParams.lines[], InvoiceItemCreateParams, InvoiceItemUpdateParams, InvoiceItem, InvoiceLineItemUpdateParams, InvoiceLineItem, and InvoiceUpdateLinesParams.lines[]taxability_reason on InvoiceAddLinesParams.lines[].tax_amounts[], InvoiceLineItemUpdateParams.tax_amounts[], and InvoiceUpdateLinesParams.lines[].tax_amounts[]jurisdiction_level on InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data, InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, and InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_dataamount_overpaid, confirmation_secret, and payments on Invoiceparent on InvoiceItem, InvoiceLineItem, and Invoiceexpired on enums Issuing.Authorization.status and Issuing.AuthorizationListParams.statusnetwork_fallback on enum Issuing.Authorization.request_history[].reasonnaver_pay on Mandate.payment_method_details and SetupAttempt.payment_method_detailssetup_future_usage on PaymentIntent.payment_method_options.naver_pay, PaymentIntentConfirmParams.payment_method_options.naver_pay, PaymentIntentCreateParams.payment_method_options.naver_pay, and PaymentIntentUpdateParams.payment_method_options.naver_payexpired on enum PaymentIntent.cancellation_reasondefault_value on PaymentLink.custom_fields[].dropdown, PaymentLink.custom_fields[].numeric, PaymentLink.custom_fields[].text, PaymentLinkCreateParams.custom_fields[].dropdown, PaymentLinkCreateParams.custom_fields[].numeric, PaymentLinkCreateParams.custom_fields[].text, PaymentLinkUpdateParams.custom_fields[].dropdown, PaymentLinkUpdateParams.custom_fields[].numeric, and PaymentLinkUpdateParams.custom_fields[].textbillie and satispay on enums PaymentLink.payment_method_types, PaymentLinkCreateParams.payment_method_types, and PaymentLinkUpdateParams.payment_method_typesnz_bank_transfer on Refund.destination_detailscanceled on enum Review.closed_reasoncurrent_period_end and current_period_start on SubscriptionItemwifi on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.Configurationinvoice.overpaid on enums WebhookEndpointCreateParams.enabled_events and WebhookEndpointUpdateParams.enabled_events2025-03-01.dashboard and 2025-03-31.basil on enum WebhookEndpointCreateParams.api_versionStripe.webhooks and Stripe().webhooks are no longer functions (just plain objects)
Stripe.webhooks().someMethod(), you should use Stripe.webhooks.someMethod() insteadAccountDebitSource in favor of AccountCapabilityListParams in favor of AccountListCapabilitiesParamsCapabilityRetrieveParams in favor of AccountRetrieveCapabilityParamsCapabilityUpdateParams in favor of AccountUpdateCapabilityParamsCashBalanceRetrieveParams in favor of CustomerRetrieveCashBalanceParamsCashBalanceUpdateParams in favor of CustomerUpdateCashBalanceParamsCreditNoteLineItemListParams in favor of CreditNoteListLineItemsParamsCustomerBalanceTransactionCreateParams in favor of CustomerCreateBalanceTransactionParamsCustomerBalanceTransactionListParams in favor of CustomerListBalanceTransactionsParamsCustomerBalanceTransactionRetrieveParams in favor of CustomerRetrieveBalanceTransactionParamsCustomerBalanceTransactionUpdateParams in favor of CustomerUpdateBalanceTransactionParamsCustomerCashBalanceTransactionListParams in favor of CustomerListCashBalanceTransactionsParamsCustomerCashBalanceTransactionRetrieveParams in favor of CustomerRetrieveCashBalanceTransactionParamsCustomerSourceCreateParams in favor of CustomerCreateSourceParamsCustomerSourceDeleteParams in favor of CustomerDeleteSourceParamsCustomerSourceListParams in favor of CustomerListSourcesParamsCustomerSourceRetrieveParams in favor of CustomerRetrieveSourceParamsCustomerSourceUpdateParams in favor of CustomerUpdateSourceParamsCustomerSourceVerifyParams in favor of CustomerVerifySourceParamsExternalAccountCreateParams in favor of AccountCreateExternalAccountParamsExternalAccountDeleteParams in favor of AccountDeleteExternalAccountParamsExternalAccountListParams in favor of AccountListExternalAccountsParamsExternalAccountRetrieveParams in favor of AccountRetrieveExternalAccountParamsExternalAccountUpdateParams in favor of AccountUpdateExternalAccountParamsFeeRefundCreateParams in favor of ApplicationFeeCreateRefundParamsFeeRefundListParams in favor of ApplicationFeeListRefundsParamsFeeRefundRetrieveParams in favor of ApplicationFeeRetrieveRefundParamsFeeRefundUpdateParams in favor of ApplicationFeeUpdateRefundParamsInvoiceLineItemListParams in favor of InvoiceListLineItemsParamsInvoiceLineItemUpdateParams in favor of InvoiceUpdateLineItemParamsLoginLinkCreateParams in favor of AccountCreateLoginLinkParamsPersonCreateParams in favor of AccountCreatePersonParamsPersonDeleteParams in favor of AccountDeletePersonParamsPersonListParams in favor of AccountListPersonsParamsPersonRetrieveParams in favor of AccountRetrievePersonParamsPersonUpdateParams in favor of AccountUpdatePersonParamsTransferReversalCreateParams in favor of TransferCreateReversalParamsTransferReversalListParams in favor of TransferListReversalsParamsTransferReversalRetrieveParams in favor of TransferRetrieveReversalParamsTransferReversalUpdateParams in favor of TransferUpdateReversalParamsAdd support for succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.Reader
#2271 Beta SDK updates between Open API versions 1473 and 1505
succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.ReaderAccount.risk_controls.rejected_reason from enum to enum | nullCheckout.Session.collected_information.shipping_details and Checkout.Session.collected_information to be requiredtarget_date on Order.payment.settings.payment_method_options.acss_debit, Order.payment.settings.payment_method_options.sepa_debit, OrderCreateParams.payment.settings.payment_method_options.acss_debit, OrderCreateParams.payment.settings.payment_method_options.sepa_debit, OrderUpdateParams.payment.settings.payment_method_options.acss_debit, and OrderUpdateParams.payment.settings.payment_method_options.sepa_debit#2272 Merge master
This release changes the pinned API version to 2025-02-24.acacia.
succeed_input_collection and timeout_input_collection test helper methods on resource Terminal.ReaderAccount.risk_controls.rejected_reason from enum to enum | nullCheckout.Session.collected_information.shipping_details and Checkout.Session.collected_information to be requiredtarget_date on Order.payment.settings.payment_method_options.acss_debit, Order.payment.settings.payment_method_options.sepa_debit, OrderCreateParams.payment.settings.payment_method_options.acss_debit, OrderCreateParams.payment.settings.payment_method_options.sepa_debit, OrderUpdateParams.payment.settings.payment_method_options.acss_debit, and OrderUpdateParams.payment.settings.payment_method_options.sepa_debitAdd support for prices on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and B
prices on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scopeBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type, Billing.CreditGrant.applicability_config.scope.price_type, and Billing.CreditGrantCreateParams.applicability_config.scope.price_type to be optionalpriority on Billing.CreditGrantCreateParams and Billing.CreditGranttarget_date on Checkout.Session.payment_method_options.acss_debit, Checkout.Session.payment_method_options.au_becs_debit, Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, Checkout.Session.payment_method_options.us_bank_account, Checkout.SessionCreateParams.payment_method_options.acss_debit, Checkout.SessionCreateParams.payment_method_options.au_becs_debit, Checkout.SessionCreateParams.payment_method_options.bacs_debit, Checkout.SessionCreateParams.payment_method_options.sepa_debit, Checkout.SessionCreateParams.payment_method_options.us_bank_account, PaymentIntent.payment_method_options.acss_debit, PaymentIntent.payment_method_options.au_becs_debit, PaymentIntent.payment_method_options.bacs_debit, PaymentIntent.payment_method_options.sepa_debit, PaymentIntent.payment_method_options.us_bank_account, PaymentIntentConfirmParams.payment_method_options.acss_debit, PaymentIntentConfirmParams.payment_method_options.au_becs_debit, PaymentIntentConfirmParams.payment_method_options.bacs_debit, PaymentIntentConfirmParams.payment_method_options.sepa_debit, PaymentIntentConfirmParams.payment_method_options.us_bank_account, PaymentIntentCreateParams.payment_method_options.acss_debit, PaymentIntentCreateParams.payment_method_options.au_becs_debit, PaymentIntentCreateParams.payment_method_options.bacs_debit, PaymentIntentCreateParams.payment_method_options.sepa_debit, PaymentIntentCreateParams.payment_method_options.us_bank_account, PaymentIntentUpdateParams.payment_method_options.acss_debit, PaymentIntentUpdateParams.payment_method_options.au_becs_debit, PaymentIntentUpdateParams.payment_method_options.bacs_debit, PaymentIntentUpdateParams.payment_method_options.sepa_debit, and PaymentIntentUpdateParams.payment_method_options.us_bank_accountrestrictions on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcollected_information on Checkout.SessionUpdateParams and Checkout.SessionCheckout.Session.discounts, Refund.destination_details.blik.network_decline_code, and Refund.destination_details.swish.network_decline_code to be requiredmetadata on ProductCreateParams.default_price_dataTokenCreateParams.person.political_exposure from string to enum('existing'|'none')2025-02-24.acacia on enum WebhookEndpointCreateParams.api_versionOPENAPI_VERSION into npm bundleAdd support for rejected_reason on Account.risk_controls
rejected_reason on Account.risk_controlsproduct_tax_code_selector on AccountSessionCreateParams.componentsprices on Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope, Billing.CreditGrant.applicability_config.scope, and Billing.CreditGrantCreateParams.applicability_config.scopeBilling.CreditGrant.applicability_config.scope.price_type, Checkout.Session.collected_information.business_name, Checkout.Session.collected_information.email, Checkout.Session.collected_information.phone, Checkout.Session.collected_information.shipping_details, and Checkout.Session.collected_information.tax_ids to be optionalbrand_product on Charge.payment_method_details.amazon_pay.funding.card and Charge.payment_method_details.revolut_pay.funding.cardrestrictions on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardCheckout.Session.discounts to be requiredTokenCreateParams.person.political_exposure from string to enum('existing'|'none')Add support for close method on resource Treasury.FinancialAccount
close method on resource Treasury.FinancialAccountpay_by_bank_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdirectorship_declaration and ownership_exemption_reason on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companyproof_of_ultimate_beneficial_ownership on AccountCreateParams.documents and AccountUpdateParams.documentsfinancial_account on AccountSession.components, AccountSessionCreateParams.components, and Treasury.OutboundTransfer.destination_payment_method_detailsfinancial_account_transactions, issuing_card, and issuing_cards_list on AccountSession.components and AccountSessionCreateParams.componentsadvice_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorBilling.CreditBalanceTransaction.credit.credits_application_invoice_voided, Card.regulated_status, Charge.payment_method_details.card.network_transaction_id, Charge.payment_method_details.card.regulated_status, ConfirmationToken.payment_method_preview.card.regulated_status, CreditNote.pretax_credit_amounts, Invoice.total_pretax_credit_amounts, Issuing.Authorization.merchant_data.tax_id, Issuing.Transaction.merchant_data.tax_id, and PaymentMethod.card.regulated_status to be requiredpay_by_bank on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datacountry on Charge.payment_method_details.paypal, ConfirmationToken.payment_method_preview.paypal, and PaymentMethod.paypalpay_by_bank on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeSD on enums Checkout.Session.shipping_address_collection.allowed_countries[], Checkout.SessionCreateParams.shipping_address_collection.allowed_countries[], PaymentLink.shipping_address_collection.allowed_countries[], PaymentLinkCreateParams.shipping_address_collection.allowed_countries[], and PaymentLinkUpdateParams.shipping_address_collection.allowed_countries[]discounts on Checkout.Sessionpay_by_bank on enums ConfirmationTokenCreateParams.testHelpers.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.typepay_by_bank on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typepay_by_bank on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]phone_number_collection on PaymentLinkUpdateParamsjpy on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingnickname on Treasury.FinancialAccountCreateParams, Treasury.FinancialAccountUpdateParams, and Treasury.FinancialAccountforwarding_settings on Treasury.FinancialAccountUpdateParamsis_default on Treasury.FinancialAccountdestination_payment_method_data on Treasury.OutboundTransferCreateParamsTreasury.OutboundTransfer.destination_payment_method_details.type from literal('us_bank_account') to enum('financial_account'|'us_bank_account')outbound_transfer on enums Treasury.ReceivedCredit.linked_flows.source_flow_details.type and Treasury.ReceivedCreditListParams.linked_flows.source_flow_typeoutbound_transfer on Treasury.ReceivedCredit.linked_flows.source_flow_details2025-01-27.acacia on enum WebhookEndpointCreateParams.api_versionChange Refund.destination_details.blik.network_decline_code and Refund.destination_details.swish.network_decline_code to be required
Refund.destination_details.blik.network_decline_code and Refund.destination_details.swish.network_decline_code to be requiredstripe_account on Terminal.Reader.action.collect_payment_method, Terminal.Reader.action.confirm_payment_intent, Terminal.Reader.action.process_payment_intent, and Terminal.Reader.action.refund_paymentAdd support for pay_by_bank_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
pay_by_bank_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdirectorship_declaration on AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companyproof_of_ultimate_beneficial_ownership on AccountCreateParams.documents and AccountUpdateParams.documentstax_threshold_monitoring on AccountSessionCreateParams.componentsfinancial_account_transactions, financial_account, issuing_card, and issuing_cards_list on AccountSession.componentsBilling.CreditBalanceTransaction.credit.credits_application_invoice_voided to be requiredalways_invoice on enums BillingPortal.Configuration.features.subscription_cancel.proration_behavior, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.proration_behavior, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.proration_behaviorpay_by_bank on Charge.payment_method_details, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapay_by_bank on enum Checkout.SessionCreateParams.payment_method_types[]SD on enums Checkout.Session.shipping_address_collection.allowed_countries[], Checkout.SessionCreateParams.shipping_address_collection.allowed_countries[], PaymentLink.shipping_address_collection.allowed_countries[], PaymentLinkCreateParams.shipping_address_collection.allowed_countries[], and PaymentLinkUpdateParams.shipping_address_collection.allowed_countries[]discounts on Checkout.Sessionpay_by_bank on enums ConfirmationTokenCreateParams.testHelpers.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.typepay_by_bank on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typepay_by_bank on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typepay_by_bank on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]jpy on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tipping2025-01-27.acacia on enum WebhookEndpointCreateParams.api_versionAdd support for close method on resource Treasury.FinancialAccount
close method on resource Treasury.FinancialAccountownership_exemption_reason on Account.company, AccountCreateParams.company, AccountUpdateParams.company, and TokenCreateParams.account.companydirectorship_declaration on Account.companyadvice_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErroralways_invoice from enums BillingPortal.Configuration.features.subscription_cancel.proration_behavior, BillingPortal.ConfigurationCreateParams.features.subscription_cancel.proration_behavior, and BillingPortal.ConfigurationUpdateParams.features.subscription_cancel.proration_behaviorbrand_product on Card, Source.card_present, Source.card, and Source.three_d_secureCard.regulated_status, Charge.payment_method_details.card.network_transaction_id, Charge.payment_method_details.card.regulated_status, ConfirmationToken.payment_method_preview.card.regulated_status, CreditNote.pretax_credit_amounts, Invoice.total_pretax_credit_amounts, Issuing.Authorization.merchant_data.tax_id, Issuing.Transaction.merchant_data.tax_id, and PaymentMethod.card.regulated_status to be requiredcountry on Charge.payment_method_details.paypal, ConfirmationToken.payment_method_preview.paypal, and PaymentMethod.paypalal_tin on enums Checkout.Session.collected_information.tax_ids[].type and Order.tax_details.tax_ids[].typeal_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typephone_number_collection on PaymentLinkUpdateParamsnickname on Treasury.FinancialAccountCreateParams, Treasury.FinancialAccountUpdateParams, and Treasury.FinancialAccountforwarding_settings on Treasury.FinancialAccountUpdateParamsis_default on Treasury.FinancialAccountdestination_payment_method_data on Treasury.OutboundTransferCreateParamsfinancial_account on Treasury.OutboundTransfer.destination_payment_method_detailsTreasury.OutboundTransfer.destination_payment_method_details.type from literal('us_bank_account') to enum('financial_account'|'us_bank_account')outbound_transfer on enums Treasury.ReceivedCredit.linked_flows.source_flow_details.type and Treasury.ReceivedCreditListParams.linked_flows.source_flow_typeoutbound_transfer on Treasury.ReceivedCredit.linked_flows.source_flow_detailsChange Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optional
2024-12-18.acacia.
Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optionalnetwork_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorpayout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.typecredits_application_invoice_voided on Billing.CreditBalanceTransaction.creditBilling.CreditBalanceTransaction.credit.type from literal('credits_granted') to enum('credits_application_invoice_voided'|'credits_granted')BillingPortal.Configuration.features.subscription_update.schedule_at_period_end, Issuing.Authorization.verified_by_fraud_challenge, LineItem.description, and Payout.trace_id to be requiredallow_redisplay on Card and Sourceregulated_status on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.cardfunding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_paynetwork_transaction_id on Charge.payment_method_details.cardreference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, and SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_optionsal_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin 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.typeal_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typevisa_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidencerequest_signature on enums Forwarding.Request.replacements[] and Forwarding.RequestCreateParams.replacements[]account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zenginaccount_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].speidisabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_taxtax_id on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_dataLineItem.description from string to string | nulltrial_period_days on PaymentLinkUpdateParams.subscription_dataal, am, ao, ba, bb, bs, cd, gn, kh, me, mk, mr, np, pe, sn, sr, tj, ug, uy, zm, and zw on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_options2024-12-18.acacia on enum WebhookEndpointCreateParams.api_versionChange Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optional
Account.business_profile.annual_revenue and Account.business_profile.estimated_worker_count to be optionalallow_redisplay on Card and Sourceam_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums Checkout.Session.collected_information.tax_ids[].type and Order.tax_details.tax_ids[].typenetwork_fallback on enum Issuing.Authorization.request_history[].reasonam_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typeamount_refunded on PaymentRecordaccount on Terminal.Reader.action.collect_payment_method, Terminal.Reader.action.confirm_payment_intent, Terminal.Reader.action.process_payment_intent, and Terminal.Reader.action.refund_paymentAdd support for automatic_indirect_tax on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
automatic_indirect_tax on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiespayout_minimum_balance_hold and payout_minimum_balance_release on enum BalanceTransaction.typereference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, Checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options, Order.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderCreateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderUpdateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, and SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_optionsdisabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_taxIssuing.Authorization.verified_by_fraud_challenge to be requiredtrial_period_days on PaymentLinkUpdateParams.subscription_dataAdd support for network_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, Set
network_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeErrorBillingPortal.Configuration.features.subscription_update.schedule_at_period_end and LineItem.description to be requiredfunding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_payamount_requested and partial_authorization on Charge.payment_method_details.cardmetadata on Checkout.SessionCreateParams.line_items[] and LineItemline_items on Checkout.Session.permissions.update, Checkout.SessionCreateParams.permissions.update, and Checkout.SessionUpdateParamsinvoice.overpaid on enum Event.typeadjustable_quantity and display on LineItemLineItem.description from string to string | nullrequest_partial_authorization on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.cardpayment_method_options on PaymentIntentIncrementAuthorizationParamsinvoice.overpaid on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for respond test helper method on resource Issuing.Authorization
2024-11-20.acacia.
respond test helper method on resource Issuing.Authorizationauthorizer on AccountPersonsParams.relationship and TokenCreateParams.person.relationshipAccount.future_requirements.disabled_reason and Account.requirements.disabled_reason from string to enumAccountSession.components.account_management.features.disable_stripe_user_authentication, AccountSession.components.account_onboarding.features.disable_stripe_user_authentication, AccountSession.components.balances.features.disable_stripe_user_authentication, AccountSession.components.notification_banner.features.disable_stripe_user_authentication, and AccountSession.components.payouts.features.disable_stripe_user_authentication to be requiredadaptive_pricing on Checkout.SessionCreateParams and Checkout.Sessionmandate_options on Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, Checkout.SessionCreateParams.payment_method_options.bacs_debit, and Checkout.SessionCreateParams.payment_method_options.sepa_debitrequest_extended_authorization, request_incremental_authorization, request_multicapture, and request_overcapture on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcapture_method on Checkout.SessionCreateParams.payment_method_options.kakao_pay, Checkout.SessionCreateParams.payment_method_options.kr_card, Checkout.SessionCreateParams.payment_method_options.naver_pay, Checkout.SessionCreateParams.payment_method_options.payco, and Checkout.SessionCreateParams.payment_method_options.samsung_paysubscribe on enums Checkout.Session.submit_type, Checkout.SessionCreateParams.submit_type, PaymentLink.submit_type, and PaymentLinkCreateParams.submit_typeli_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.typeli_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typefinancial_account_statement on enums File.purpose and FileListParams.purposeaccount_holder_address, account_holder_name, account_type, and bank_address on FundingInstructions.bank_transfer.financial_addresses[].aba, FundingInstructions.bank_transfer.financial_addresses[].swift, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swiftservice_tax on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typemerchant_amount and merchant_currency on Issuing.AuthorizationCreateParams.testHelpersIssuing.AuthorizationCreateParams.testHelpers.amount to be optionalfraud_challenges and verified_by_fraud_challenge on Issuing.Authorizationlink on enums PaymentIntent.payment_method_options.card.network, PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntent.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, Subscription.payment_settings.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.networksubmit_type on PaymentLinkUpdateParamstrace_id on Payoutnetwork_decline_code on Refund.destination_details.blik and Refund.destination_details.swishTreasury.InboundTransfer.origin_payment_method from string to string | null2024-11-20.acacia on enum WebhookEndpointCreateParams.api_versionStripe.V2.BillingResource, Stripe.V2.CoreResource, and Stripe.V2Resource types from the public interface as they are no longer needed. SDK usage will not be affected but any references to these types in your application will need to be removed.Add support for account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_tran
account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zenginaccount_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].speisubscribe on enum PaymentLinkUpdateParams.submit_typerespond test helper method on resource Issuing.Authorizationfraud_challenges and verified_by_fraud_challenge on Issuing.AuthorizationThis release changes the pinned API version to 2024-11-20.acacia.
respond test helper method on resource Issuing.Authorizationfraud_challenges and verified_by_fraud_challenge on Issuing.Authorizationaccount_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zenginaccount_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].speisubscribe on enum PaymentLinkUpdateParams.submit_typeAdd support for new resources Issuing.FraudLiabilityDebit, PaymentAttemptRecord, and PaymentRecord
Issuing.FraudLiabilityDebit, PaymentAttemptRecord, and PaymentRecordlist and retrieve methods on resources FraudLiabilityDebit and PaymentAttemptRecordreport_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt, report_payment, and retrieve methods on resource PaymentRecordAccount.future_requirements.disabled_reason and Account.requirements.disabled_reason from string to enummoney_movement on AccountSessionCreateParams.components.financial_account.featurescard_management, card_spend_dispute_management, cardholder_management, and spend_control_management on AccountSessionCreateParams.components.issuing_card.featuresdisable_stripe_user_authentication on AccountSessionCreateParams.components.issuing_cards_list.featuresAccountSession.components.account_management.features.disable_stripe_user_authentication, AccountSession.components.account_onboarding.features.disable_stripe_user_authentication, AccountSession.components.balances.features.disable_stripe_user_authentication, AccountSession.components.notification_banner.features.disable_stripe_user_authentication, and AccountSession.components.payouts.features.disable_stripe_user_authentication to be requiredadaptive_pricing on Checkout.SessionCreateParams and Checkout.Sessionmandate_options on Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, Checkout.SessionCreateParams.payment_method_options.bacs_debit, and Checkout.SessionCreateParams.payment_method_options.sepa_debitrequest_decremental_authorization, request_extended_authorization, request_incremental_authorization, request_multicapture, and request_overcapture on Checkout.Session.payment_method_options.card and Checkout.SessionCreateParams.payment_method_options.cardcapture_method on Checkout.SessionCreateParams.payment_method_options.kakao_pay, Checkout.SessionCreateParams.payment_method_options.kr_card, Checkout.SessionCreateParams.payment_method_options.naver_pay, Checkout.SessionCreateParams.payment_method_options.payco, and Checkout.SessionCreateParams.payment_method_options.samsung_payli_vat on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typeli_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typeinvoice.payment_attempt_required and issuing_fraud_liability_debit.created on enum Event.typeaccount_holder_address, account_holder_name, account_type, and bank_address on FundingInstructions.bank_transfer.financial_addresses[].aba, FundingInstructions.bank_transfer.financial_addresses[].swift, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swiftcustom on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]service_tax on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typepayment_record_data and payment_record on InvoiceAttachPaymentParamsout_of_band_payment on InvoiceAttachPaymentParamsamount_overpaid on Invoicemerchant_amount and merchant_currency on Issuing.AuthorizationCreateParams.testHelpersIssuing.AuthorizationCreateParams.testHelpers.amount to be optionallink on enums PaymentIntent.payment_method_options.card.network, PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntent.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, Subscription.payment_settings.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.networksubmit_type on PaymentLinkUpdateParamsTreasury.InboundTransfer.origin_payment_method from string to string | nullinvoice.payment_attempt_required and issuing_fraud_liability_debit.created on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for trigger_action method on resource PaymentIntent
trigger_action method on resource PaymentIntentid_bank_transfer_payments_bca and id_bank_transfer_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesbank_bca_onboarding on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settingssend_money on AccountSessionCreateParams.components.recipients.featurespayout_statement_descriptor_profanity from enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeid_bank_transfer on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, 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, Refund.destination_details, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_optionsDispute.enhanced_eligibility_types, Dispute.evidence.enhanced_evidence, and Dispute.evidence_details.enhanced_eligibility to be requiredgopay, qris, and shopeepay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationSee the changelog for more details.
latestapiversion was not updated to 2024-10-28.acacia in the last release.Add support for new resource V2.EventDestinations
2024-10-28.acacia.
V2.EventDestinationscreate, retrieve, update, list, del, disable, enable and ping methods on resource V2.EventDestinationssubmit_card test helper method on resource Issuing.Cardgroups on AccountCreateParams, AccountUpdateParams, and Accountalma_payments, kakao_pay_payments, kr_card_payments, naver_pay_payments, payco_payments, and samsung_pay_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesdisable_stripe_user_authentication on AccountSession.components.account_management.features, AccountSession.components.account_onboarding.features, AccountSession.components.balances.features, AccountSession.components.notification_banner.features, AccountSession.components.payouts.features, AccountSessionCreateParams.components.account_management.features, AccountSessionCreateParams.components.account_onboarding.features, AccountSessionCreateParams.components.balances.features, AccountSessionCreateParams.components.notification_banner.features, and AccountSessionCreateParams.components.payouts.featuresschedule_at_period_end on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_updateBillingPortal.ConfigurationCreateParams.business_profile and Refund.next_action.display_details to be optionalalma on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datakakao_pay and kr_card on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Mandate.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, PaymentMethodCreateParams, PaymentMethod, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datanaver_pay on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapayco and samsung_pay on Charge.payment_method_details, Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataalma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_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.typealma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums ConfirmationTokenCreateParams.testHelpers.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.typealma, kakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeauto on enum CustomerUpdateParams.tax.validate_locationby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typeenhanced_evidence on Dispute.evidence and DisputeUpdateParams.evidenceenhanced_eligibility_types on Disputeenhanced_eligibility on Dispute.evidence_detailsissuing_transaction.purchase_details_receipt_updated and refund.failed on enum Event.typemetadata on Forwarding.RequestCreateParams and Forwarding.Requestautomatically_finalizes_at on InvoiceCreateParams and InvoiceUpdateParamsjp_credit_transfer, kakao_pay, kr_card, naver_pay, and payco on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]retail_delivery_fee on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typealma on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]amazon_pay on PaymentMethodDomainRefund.next_action.display_details from RefundNextActionDisplayDetails | null to RefundNextActionDisplayDetailsflat_amount and rate_type on Tax.Calculation.tax_breakdown[].tax_rate_details and TaxRateby, cr, ec, ma, md, rs, ru, tz, and uz on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsstate_retail_delivery_fee on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.typepln on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingissuing_transaction.purchase_details_receipt_updated and refund.failed on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]2024-10-28.acacia on enum WebhookEndpointCreateParams.api_versionAdd support for alma_payments, gopay_payments, kakao_pay_payments, kr_card_payments, naver_pay_payments, payco_payments, qris_payments, samsung_pay_pa
alma_payments, gopay_payments, kakao_pay_payments, kr_card_payments, naver_pay_payments, payco_payments, qris_payments, samsung_pay_payments, shopeepay_payments, treasury_evolve, treasury_fifth_third, and treasury_goldman_sachs on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesschedule_at_period_end on BillingPortal.Configuration.features.subscription_update, BillingPortal.ConfigurationCreateParams.features.subscription_update, and BillingPortal.ConfigurationUpdateParams.features.subscription_updateBillingPortal.ConfigurationCreateParams.business_profile to be optionalalma on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datagopay, qris, and shopeepay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_dataalma, gopay, qris, and shopeepay on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typealma, gopay, qris, and shopeepay on enums ConfirmationTokenCreateParams.testHelpers.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.typealma, gopay, qris, and shopeepay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeauto on enum CustomerUpdateParams.tax.validate_locationmetadata on Forwarding.RequestCreateParamsjp_credit_transfer, kakao_pay, kr_card, naver_pay, and payco on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]expired from enums Issuing.Authorization.status and Issuing.AuthorizationListParams.statusalma, gopay, qris, and shopeepay on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]amazon_pay on PaymentMethodDomainTax.Calculation.tax_breakdown[].tax_rate_details.flat_amount, Tax.Calculation.tax_breakdown[].tax_rate_details.rate_type, TaxRate.flat_amount, and TaxRate.rate_type to be requiredexternal_reference on Tax.Form.payee and Tax.FormListParams.payeeTax.Form.payee.type and Tax.FormListParams.payee.type from literal('account') to enum('account'|'external_reference')au_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on enums Tax.Form.type and Tax.FormListParams.typeau_serr, ca_mrdp, eu_dac7, gb_mrdp, and nz_mrdp on Tax.Formpln on Terminal.Configuration.tipping, Terminal.ConfigurationCreateParams.tipping, and Terminal.ConfigurationUpdateParams.tippingbank on Treasury.FinancialAccountCreateParams.features.financial_addresses.aba, Treasury.FinancialAccountFeatures.financial_addresses.aba, Treasury.FinancialAccountUpdateFeaturesParams.financial_addresses.aba, and Treasury.FinancialAccountUpdateParams.features.financial_addresses.abafixes a bug where the object property of the MeterEvent, MeterEventAdjustment, and MeterEventSession didn't match the server.
fetchRelatedObject is added to events retrieved using stripe.v2.core.events and can be used to easily fetch the Stripe object related to a retrieved e
fetchRelatedObject is added to events retrieved using stripe.v2.core.events and can be used to easily fetch the Stripe object related to a retrieved eventAdd support for submit_card test helper method on resource Issuing.Card
submit_card test helper method on resource Issuing.Cardgroups on AccountCreateParams, AccountUpdateParams, and Accountdisable_stripe_user_authentication on AccountSession.components.account_management.features, AccountSession.components.account_onboarding.features, AccountSession.components.balances.features, AccountSession.components.notification_banner.features, AccountSession.components.payouts.features, AccountSessionCreateParams.components.account_management.features, AccountSessionCreateParams.components.account_onboarding.features, AccountSessionCreateParams.components.balances.features, AccountSessionCreateParams.components.financial_account.features, AccountSessionCreateParams.components.notification_banner.features, and AccountSessionCreateParams.components.payouts.featurescard_spend_dispute_management and spend_control_management on AccountSessionCreateParams.components.issuing_cards_list.featurespayout_statement_descriptor_profanity on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codekakao_pay and kr_card on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, Mandate.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, PaymentMethodCreateParams, PaymentMethod, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datanaver_pay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethodUpdateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datapayco and samsung_pay on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datakakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enums Checkout.Session.collected_information.tax_ids[].type, Checkout.Session.customer_details.tax_ids[].type, Invoice.customer_tax_ids[].type, Order.tax_details.tax_ids[].type, Tax.Calculation.customer_details.tax_ids[].type, Tax.Transaction.customer_details.tax_ids[].type, and TaxId.typekakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums ConfirmationTokenCreateParams.testHelpers.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.typekakao_pay, kr_card, naver_pay, payco, and samsung_pay on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typeby_tin, ma_vat, md_vat, tz_vat, uz_tin, and uz_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typerefund.failed on enum Event.typemetadata on Forwarding.Requestretail_delivery_fee on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, Tax.Calculation.tax_breakdown[].tax_rate_details.tax_type, Tax.CalculationLineItem.tax_breakdown[].tax_rate_details.tax_type, Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details.tax_type, TaxRate.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_typeexpired on enums Issuing.Authorization.status and Issuing.AuthorizationListParams.statusline_items on Order.payment.settings.payment_method_options.paypal, OrderCreateParams.payment.settings.payment_method_options.paypal, OrderUpdateParams.payment.settings.payment_method_options.paypal, PaymentIntent.payment_method_options.paypal, PaymentIntentConfirmParams.payment_method_options.paypal, PaymentIntentCreateParams.payment_method_options.paypal, and PaymentIntentUpdateParams.payment_method_options.paypalflat_amount and rate_type on Tax.Calculation.tax_breakdown[].tax_rate_details and TaxRateby, cr, ec, ma, md, rs, ru, tz, and uz on Tax.Registration.country_options and Tax.RegistrationCreateParams.country_optionsstate_retail_delivery_fee on enums Tax.Registration.country_options.us.type and Tax.RegistrationCreateParams.country_options.us.typerefund.failed on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for reporting_chart on AccountSessionCreateParams.components
reporting_chart on AccountSessionCreateParams.componentsfrom_schedule on Quote.subscription_dataallow_redisplay on Terminal.ReaderCollectPaymentMethodParams.collect_configThis release changes the pinned API version to 2024-09-30.acacia.
reporting_chart on AccountSessionCreateParams.componentsfrom_schedule on Quote.subscription_dataallow_redisplay on Terminal.ReaderCollectPaymentMethodParams.collect_configRemove the support for resource Margin that was accidentally made public in the last release
Margin that was accidentally made public in the last releaseThis release changes the pinned API version to 2024-09-30.acacia. Please read the API Changelog and carefully review the API changes before upgrading.
#2192 Support for APIs in the new API version 2024-09-30.acacia
This release changes the pinned API version to 2024-09-30.acacia. Please read the API Changelog and carefully review the API changes before upgrading.
usage_threshold_config to usage_threshold on Billing.AlertCreateParams and Billing.Alertfilter on Billing.AlertCreateParams and Billing.Alert. Use the filters on the usage_threshold insteadcustomer_consent_collected on Terminal.ReaderProcessSetupIntentParams.1 -> 22 -> 5custom_unit_amount on ProductCreateParams.default_price_dataallow_redisplay on Terminal.ReaderProcessPaymentIntentParams.process_config and Terminal.ReaderProcessSetupIntentParamsinternational_transaction on enum Treasury.ReceivedCredit.failure_code2024-09-30.acacia on enum WebhookEndpointCreateParams.api_versionBilling.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events in the v2 namespace parseThinEvent() on the Stripe class to parse thin events.Stripe class that takes a HTTP method type, url and relevant parameters to make requests to the Stripe API that are not yet supported in the SDK.BillingPortal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates and BillingPortal.ConfigurationCreateParams.features.subscription_update.products to be optionalRemove support for resource QuotePhase
QuotePhaselist_line_items and retrieve methods on resource QuotePhasesend_money and transfer_balance on AccountSessionCreateParams.components.financial_account.featuresrechnung on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]Quote.subscription_data_overrides[].end_behavior to be optionalAdd support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code
international_transaction on enum Treasury.ReceivedDebit.failure_codeverification_supportability on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codeterminal_reader_invalid_location_for_activation on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codepayer_details on Charge.payment_method_details.klarnaamazon_pay on Dispute.payment_method_detailsamazon_pay on enum Dispute.payment_method_details.typeautomatically_finalizes_at on Invoicestate_sales_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.usAdd support for new resources Issuing.DisputeSettlementDetail and Issuing.Settlement
Issuing.DisputeSettlementDetail and Issuing.Settlementlist and retrieve methods on resource DisputeSettlementDetaillist method on resource QuotePhaserechnung on enum Checkout.SessionCreateParams.payment_method_types[]issuing_dispute_settlement_detail.created, issuing_dispute_settlement_detail.updated, issuing_settlement.created, and issuing_settlement.updated on enum Event.typesettlement on Issuing.TransactionListParams and Issuing.Transactionissuing_dispute_settlement_detail.created, issuing_dispute_settlement_detail.updated, issuing_settlement.created, and issuing_settlement.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resource InvoiceRenderingTemplate
InvoiceRenderingTemplatearchive, list, retrieve, and unarchive methods on resource InvoiceRenderingTemplaterequired on Checkout.Session.tax_id_collection, Checkout.SessionCreateParams.tax_id_collection, PaymentLink.tax_id_collection, PaymentLinkCreateParams.tax_id_collection, and PaymentLinkUpdateParams.tax_id_collectiontemplate on Customer.invoice_settings.rendering_options, CustomerCreateParams.invoice_settings.rendering_options, CustomerUpdateParams.invoice_settings.rendering_options, Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.renderingtemplate_version on Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.renderingsubmitted on enum Issuing.Card.shipping.statusTestHelpers.TestClock.status_details to be requiredAdd support for new resources Billing.MeterErrorReport and Terminal.ReaderCollectedData
Billing.MeterErrorReport and Terminal.ReaderCollectedDataretrieve method on resource ReaderCollectedDatarecipients on AccountSessionCreateParams.componentsterminal_reader_collected_data_invalid on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codemb_way on enum Checkout.SessionCreateParams.payment_method_types[]business_name, email, phone, and tax_ids on Checkout.Session.collected_informationbilling.meter_error_report.triggered on enum Event.typeregulatory_reporting_file on Issuing.CreditUnderwritingRecordCorrectParams, Issuing.CreditUnderwritingRecordCreateFromProactiveReviewParams, Issuing.CreditUnderwritingRecordReportDecisionParams, and Issuing.CreditUnderwritingRecordmb_way on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]rechnung on PaymentMethodUpdateParamsbilling.meter_error_report.triggered on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for subscription_item and subscription on Billing.AlertCreateParams.filter
subscription_item and subscription on Billing.AlertCreateParams.filterTerminal.ReaderProcessSetupIntentParams.customer_consent_collected to be optionalChange AccountLinkCreateParams.collection_options.fields and LineItem.description to be optional
AccountLinkCreateParams.collection_options.fields and LineItem.description to be optionalhr_oib 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.typehr_oib on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typeissuing_regulatory_reporting on enums File.purpose and FileListParams.purposeissuing_regulatory_reporting on enum FileCreateParams.purposeIssuing.Card.shipping.address_validation to be requiredstatus_details on TestHelpers.TestClockAdd support for mb_way_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
mb_way_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesmb_way on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datamb_way on enums ConfirmationTokenCreateParams.testHelpers.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.typemb_way on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typemb_way on enums CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typeaccepted, partner_rejected, and submitted from enum Dispute.evidence_details.enhanced_eligibility.visa_compelling_evidence_3.statushr_oib on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typehr_oib on enum Order.tax_details.tax_ids[].typephases on QuoteCreateParams and QuoteUpdateParamsfrom_schedule on QuoteCreateParams.subscription_dataAdd support for capital_financing_application and capital_financing on AccountSessionCreateParams.components
capital_financing_application and capital_financing on AccountSessionCreateParams.componentspermissions on Checkout.SessionCreateParams and Checkout.Sessioncollected_information on Checkout.SessionUpdateParams and Checkout.Sessionshipping_options on Checkout.SessionUpdateParamsAdd support for authorization_code on Charge.payment_method_details.card
authorization_code on Charge.payment_method_details.cardwallet on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentMethod.card_presentmandate_options on PaymentIntent.payment_method_options.bacs_debit, PaymentIntentConfirmParams.payment_method_options.bacs_debit, PaymentIntentCreateParams.payment_method_options.bacs_debit, and PaymentIntentUpdateParams.payment_method_options.bacs_debitbacs_debit on SetupIntent.payment_method_options, SetupIntentConfirmParams.payment_method_options, SetupIntentCreateParams.payment_method_options, and SetupIntentUpdateParams.payment_method_optionschips on Treasury.OutboundPayment.tracking_details.us_domestic_wire, Treasury.OutboundPaymentUpdateParams.testHelpers.tracking_details.us_domestic_wire, Treasury.OutboundTransfer.tracking_details.us_domestic_wire, and Treasury.OutboundTransferUpdateParams.testHelpers.tracking_details.us_domestic_wireTreasury.OutboundPayment.tracking_details.us_domestic_wire.imad and Treasury.OutboundTransfer.tracking_details.us_domestic_wire.imad from string to string | nullAdd support for capital_financing_application and capital_financing on AccountSession.components
capital_financing_application and capital_financing on AccountSession.componentspayto on Checkout.Session.payment_method_options and Checkout.SessionCreateParams.payment_method_optionspayto on enum Checkout.SessionCreateParams.payment_method_types[]custom on enums Checkout.Session.ui_mode and Checkout.SessionCreateParams.ui_moderisk_correlation_id on PaymentIntent.payment_method_options.rechnung, PaymentIntentConfirmParams.payment_method_options.rechnung, PaymentIntentCreateParams.payment_method_options.rechnung, and PaymentIntentUpdateParams.payment_method_options.rechnungpayto on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]QuoteLine.cancel_subscription_schedule to be requiredAdd support for activate, archive, create, deactivate, list, and retrieve methods on resource Billing.Alert
activate, archive, create, deactivate, list, and retrieve methods on resource Billing.Alertretrieve method on resource Tax.Calculationinvalid_mandate_reference_prefix_format on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codetype on Charge.payment_method_details.card_present.offline, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present.offline, PaymentMethod.card.generated_from.payment_method_details.card_present.offline, and SetupAttempt.payment_method_details.card_present.offlineoffline on ConfirmationToken.payment_method_preview.card_present and PaymentMethod.card_presentrelated_customer on Identity.VerificationSessionCreateParams, Identity.VerificationSessionListParams, and Identity.VerificationSessionInvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.count, InvoiceCreateParams.payment_settings.payment_method_options.card.installments.plan.interval, InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.count, InvoiceUpdateParams.payment_settings.payment_method_options.card.installments.plan.interval, PaymentIntentConfirmParams.payment_method_options.card.installments.plan.count, PaymentIntentConfirmParams.payment_method_options.card.installments.plan.interval, PaymentIntentCreateParams.payment_method_options.card.installments.plan.count, PaymentIntentCreateParams.payment_method_options.card.installments.plan.interval, PaymentIntentUpdateParams.payment_method_options.card.installments.plan.count, and PaymentIntentUpdateParams.payment_method_options.card.installments.plan.interval to be optionalgirocard on enums PaymentIntent.payment_method_options.card.network, PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntent.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, Subscription.payment_settings.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.networkfinancial_addresses.aba.forwarding on enums Treasury.FinancialAccount.active_features[], Treasury.FinancialAccount.pending_features[], and Treasury.FinancialAccount.restricted_features[]Add support for attach_payment method on resource Invoice
attach_payment method on resource Invoiceapp_install and app_viewport on AccountSessionCreateParams.componentspartner_rejected_details on Dispute.evidence_details.enhanced_eligibility.visa_compelling_evidence_3lines_invalid on Quote.status_details.stale.last_reasonlines_invalid on enum Quote.status_details.stale.last_reason.typelast_price_migration_error on SubscriptionSchedule and SubscriptionAdd support for new resources Billing.AlertTriggered and Billing.Alert
Billing.AlertTriggered and Billing.Alertcharge_exceeds_transaction_limit on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeauthorization_code on Charge.payment_method_details.card. This was accidentally released last week.billing.alert.triggered on enum Event.typebilling.alert.triggered on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for new resources Billing.AlertTriggered, Billing.Alert, and Tax.Association
Billing.AlertTriggered, Billing.Alert, and Tax.Associationactivate, archive, create, deactivate, list, and retrieve methods on resource Alertfind method on resource Associationcapital on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settingsissuing.account_closed_for_not_providing_business_model_clarification, issuing.account_closed_for_not_providing_url_clarification, and issuing.account_closed_for_not_providing_use_case_clarification on enum AccountNotice.reasonasync_workflows on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentCreateParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentUpdateParams, and PaymentIntentpayto on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationdisplay_name on Treasury.FinancialAccountCreateParams, Treasury.FinancialAccountUpdateParams, and Treasury.FinancialAccountAdd support for tax_registrations and tax_settings on AccountSession.components and AccountSessionCreateParams.components
tax_registrations and tax_settings on AccountSession.components and AccountSessionCreateParams.componentsupdate method on resource Checkout.Sessiontransaction_id on Charge.payment_method_details.affirmbuyer_id on Charge.payment_method_details.blikauthorization_code on Charge.payment_method_details.cardbrand_product on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card.generated_from.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card_present, PaymentMethod.card.generated_from.payment_method_details.card_present, and PaymentMethod.card_presentnetwork_transaction_id 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, and PaymentMethod.card.generated_from.payment_method_details.card_presentcase_type on Dispute.payment_method_details.cardinvoice.overdue and invoice.will_be_due on enum Event.typetwint on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfigurationinvoice.overdue and invoice.will_be_due on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for customer on ConfirmationToken.payment_method_preview
customer on ConfirmationToken.payment_method_previewissuing_dispute.funds_rescinded on enum Event.typemultibanco on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]stripe_s700 on enums Terminal.Reader.device_type and Terminal.ReaderListParams.device_typeissuing_dispute.funds_rescinded on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Change ConfirmationToken.payment_method_options and CustomerSession.components.payment_element to be required
ConfirmationToken.payment_method_options and CustomerSession.components.payment_element to be requirednot_qualified on enum Dispute.evidence_details.enhanced_eligibility.visa_compelling_evidence_3.status⚠️ Remove support for payment_method_update on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_
payment_method_update on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.features. Users are expected to completely migrate from using payment_method_update.FinancialConnections.Institutionlist and retrieve methods on resource Institutioninstitution on Checkout.Session.payment_method_options.us_bank_account.financial_connections.filters, FinancialConnections.Session.filters, FinancialConnections.SessionCreateParams.filters, Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.filters, InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters, InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters, PaymentIntent.payment_method_options.us_bank_account.financial_connections.filters, PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.filters, PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.filters, PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.filters, SetupIntent.payment_method_options.us_bank_account.financial_connections.filters, SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.filters, SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.filters, SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.filters, Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.filters, SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filters, and SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.filterspayment_method_allow_redisplay_filters, payment_method_redisplay_limit, payment_method_redisplay, and payment_method_save_usage on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.featuresbalance on enums FinancialConnections.Account.subscriptions[], FinancialConnections.AccountSubscribeParams.features[], and FinancialConnections.AccountUnsubscribeParams.features[]Add support for add_lines, remove_lines, and update_lines methods on resource Invoice
add_lines, remove_lines, and update_lines methods on resource Invoicepayment_intent_fx_quote_invalid on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codeposted_at on Tax.TransactionCreateFromCalculationParams and Tax.TransactionRemove support for payment_method_set_as_default on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.pay
payment_method_set_as_default on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.featuresch_uid on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typech_uid on enum Order.tax_details.tax_ids[].typeThis release changes the pinned API version to 2024-06-20.
payment_method_set_as_default on CustomerSession.components.payment_element.features and CustomerSessionCreateParams.components.payment_element.featuresch_uid on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typech_uid on enum Order.tax_details.tax_ids[].typeAdd support for filters on Checkout.Session.payment_method_options.us_bank_account.financial_connections, Invoice.payment_settings.payment_method_opti
filters on Checkout.Session.payment_method_options.us_bank_account.financial_connections, Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections, InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, PaymentIntent.payment_method_options.us_bank_account.financial_connections, PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections, PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections, PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections, SetupIntent.payment_method_options.us_bank_account.financial_connections, SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections, SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections, SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections, Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections, SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections, and SubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connectionsemail_type on CreditNoteCreateParams, CreditNotePreviewLinesParams, and CreditNotePreviewParamsaccount_subcategories on FinancialConnections.Session.filters and FinancialConnections.SessionCreateParams.filtersmultibanco, twint, and zip on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]reboot_window on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.ConfigurationThis release changes the pinned API version to 2024-06-20. Please read the API Changelog and carefully review the API changes before upgrading.
This release changes the pinned API version to 2024-06-20. Please read the API Changelog and carefully review the API changes before upgrading.
PlatformTaxFeevolume_decimal to quantity_decimal on
Issuing.AuthorizationCaptureParams.testHelpers.purchase_details.fuel,Issuing.Transaction.purchase_details.fuel,Issuing.TransactionCreateForceCaptureParams.testHelpers.purchase_details.fuel, andIssuing.TransactionCreateUnlinkedRefundParams.testHelpers.purchase_details.fuelCapabilities.Requirements.disabled_reason and Capabilities.Requirements.disabled_reason are now enums with the below values
otherpaused.inactivitypending.onboardingpending.reviewplatform_disabledplatform_pausedrejected.inactivityrejected.otherrejected.unsupported_businessrequirements.fields_neededcharging_minute, imperial_gallon, kilogram, kilowatt_hour, and pound on enums Issuing.AuthorizationCaptureParams.testHelpers.purchase_details.fuel.unit, Issuing.TransactionCreateForceCaptureParams.testHelpers.purchase_details.fuel.unit, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.purchase_details.fuel.unitcard_canceled, card_expired, cardholder_blocked, insecure_authorization_method, and pin_blocked on enum Issuing.Authorization.request_history[].reasonfinalize_amount test helper method on resource Issuing.Authorizationch_uid 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.typech_uid on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typefleet on Issuing.AuthorizationCaptureParams.testHelpers.purchase_details, Issuing.AuthorizationCreateParams.testHelpers, Issuing.Authorization, Issuing.Transaction.purchase_details, Issuing.TransactionCreateForceCaptureParams.testHelpers.purchase_details, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.purchase_detailsfuel on Issuing.AuthorizationCreateParams.testHelpers and Issuing.Authorizationindustry_product_code and quantity_decimal on Issuing.AuthorizationCaptureParams.testHelpers.purchase_details.fuel, Issuing.Transaction.purchase_details.fuel, Issuing.TransactionCreateForceCaptureParams.testHelpers.purchase_details.fuel, and Issuing.TransactionCreateUnlinkedRefundParams.testHelpers.purchase_details.fuel2024-06-20 on enum WebhookEndpointCreateParams.api_version#2118 Use worker module in Bun
Add support for new value mobilepay on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdate
mobilepay on enums PaymentLink.payment_method_types[], PaymentLinkCreateParams.payment_method_types[], and PaymentLinkUpdateParams.payment_method_types[]tax_id_collection on PaymentLinkUpdateParamsPaymentIntentConfirmParams.mandate_data from Stripe.Emptyable<PaymentIntentConfirmParams.MandateData1 | PaymentIntentConfirmParams.MandateData2> to Stripe.Emptyable<PaymentIntentConfirmParams.MandateData> where the new MandateData is a union of all the properties of MandateData1 and MandateData2PaymentMethodCreateParams.card from PaymentMethodCreateParams.Card1 | PaymentMethodCreateParams.Card2 to PaymentMethodCreateParams.Card where the new Card is a union of all the properties of Card1 and Card2SetupIntentConfirmParams.mandate_data from Stripe.Emptyable<SetupIntentConfirmParams.MandateData1 | SetupIntentConfirmParams.MandateData2> to Stripe.Emptyable<SetupIntentConfirmParams.MandateData> where the new MandateData is a union of all the properties of MandateData1 and MandateData2Add support for new value de_stn on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
de_stn on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].typede_stn on enum Order.tax_details.tax_ids[].typeAdd support for multibanco_payments and twint_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
multibanco_payments and twint_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiestwint on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, PaymentMethodCreateParams, PaymentMethod, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datamultibanco on Checkout.Session.payment_method_options, Checkout.SessionCreateParams.payment_method_options, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.testHelpers.payment_method_data, 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, Refund.destination_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, and SetupIntentUpdateParams.payment_method_datamultibanco and twint on enums Checkout.SessionCreateParams.payment_method_types[], CustomerListPaymentMethodsParams.type, PaymentMethodCreateParams.type, and PaymentMethodListParams.typede_stn 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.typemultibanco and twint on enums ConfirmationTokenCreateParams.testHelpers.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.typemultibanco and twint on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.typede_stn on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, Tax.CalculationCreateParams.customer_details.tax_ids[].type, and TaxIdCreateParams.typemultibanco_display_details on PaymentIntent.next_actioninvoice_settings on SubscriptionAdd support for twint on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_me
twint on PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_options, and PaymentIntentUpdateParams.payment_method_optionsAdd support for gb_bank_transfer_payments, jp_bank_transfer_payments, mx_bank_transfer_payments, sepa_bank_transfer_payments, and us_bank_transfer_pay
gb_bank_transfer_payments, jp_bank_transfer_payments, mx_bank_transfer_payments, sepa_bank_transfer_payments, and us_bank_transfer_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilitiesswish on enums Invoice.payment_settings.payment_method_types[], InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], Subscription.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]Add support for new values en-RO and ro-RO on enums OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale and OrderUpdateP
en-RO and ro-RO on enums OrderCreateParams.payment.settings.payment_method_options.klarna.preferred_locale and OrderUpdateParams.payment.settings.payment_method_options.klarna.preferred_localeAdd support for new value verification_requires_additional_proof_of_registration on enums Account.future_requirements.errors[].code, Account.requireme
verification_requires_additional_proof_of_registration on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].codedefault_value on Checkout.Session.custom_fields[].dropdown, Checkout.Session.custom_fields[].numeric, Checkout.Session.custom_fields[].text, Checkout.SessionCreateParams.custom_fields[].dropdown, Checkout.SessionCreateParams.custom_fields[].numeric, and Checkout.SessionCreateParams.custom_fields[].textgenerated_from on ConfirmationToken.payment_method_preview.card and PaymentMethod.cardissuing_personalization_design.activated, issuing_personalization_design.deactivated, issuing_personalization_design.rejected, and issuing_personalization_design.updated on enum Event.typeIssuing.Card.personalization_design and Issuing.PhysicalBundle.features to be requireden-RO and ro-RO on enums PaymentIntentConfirmParams.payment_method_options.klarna.preferred_locale, PaymentIntentCreateParams.payment_method_options.klarna.preferred_locale, and PaymentIntentUpdateParams.payment_method_options.klarna.preferred_localeissuing_personalization_design.activated, issuing_personalization_design.deactivated, issuing_personalization_design.rejected, and issuing_personalization_design.updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]Add support for external_account_collection on AccountSession.components.balances.features, AccountSession.components.payouts.features, AccountSession
external_account_collection on AccountSession.components.balances.features, AccountSession.components.payouts.features, AccountSessionCreateParams.components.balances.features, and AccountSessionCreateParams.components.payouts.featuresterminal_reader_invalid_location_for_payment on enums Invoice.last_finalization_error.code, PaymentIntent.last_payment_error.code, SetupAttempt.setup_error.code, SetupIntent.last_setup_error.code, and StripeError.codepayment_method_remove on Checkout.Session.saved_payment_method_optionsAdd support for fee_source on ApplicationFee
fee_source on ApplicationFeenet_available on Balance.instant_available[]preferred_locales on Charge.payment_method_details.card_present, ConfirmationToken.payment_method_preview.card_present, and PaymentMethod.card_presentklarna on Dispute.payment_method_detailsklarna on enum Dispute.payment_method_details.typearchived and lookup_key on Entitlements.FeatureListParamsFinancialConnections.SessionCreateParams.filters.countries to be optionalno_valid_authorization on Issuing.Dispute.evidence, Issuing.DisputeCreateParams.evidence, and Issuing.DisputeUpdateParams.evidenceno_valid_authorization on enums Issuing.Dispute.evidence.reason, Issuing.DisputeCreateParams.evidence.reason, and Issuing.DisputeUpdateParams.evidence.reasonloss_reason on Issuing.Disputerouting 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_presentapplication_fee_amount and application_fee on Payoutstripe_s700 on Terminal.ConfigurationCreateParams, Terminal.ConfigurationUpdateParams, and Terminal.ConfigurationTreasury.OutboundPayment.tracking_details and Treasury.OutboundTransfer.tracking_details to be requiredNo new beta features. Merging changes from the main branch.
Remove support for pending_invoice_items_behavior on SubscriptionCreateParams
pending_invoice_items_behavior on SubscriptionCreateParamsupdate test helper method on resources Treasury.OutboundPayment and Treasury.OutboundTransferallow_redisplay on ConfirmationToken.payment_method_preview and PaymentMethodtreasury.outbound_payment.tracking_details_updated and treasury.outbound_transfer.tracking_details_updated on enum Event.typepreview_mode on InvoiceCreatePreviewParams, InvoiceUpcomingLinesParams, and InvoiceUpcomingParamspending_invoice_items_behavior on SubscriptionCreateParamstracking_details on Treasury.OutboundPayment and Treasury.OutboundTransfertreasury.outbound_payment.tracking_details_updated and treasury.outbound_transfer.tracking_details_updated on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]One column per quarter.