stripe - npm Package Versions

#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 Upgrade Guide and carefully review the API changes before upgrading.

⚠️ Breaking changes due to changes in the Stripe API

• Rename usage_threshold_config to usage_threshold on Billing.AlertCreateParams and Billing.Alert
• Remove support for filter on Billing.AlertCreateParams and Billing.Alert. Use the filters on the usage_threshold instead
• Remove support for customer_consent_collected on Terminal.ReaderProcessSetupIntentParams.

⚠️ Other Breaking changes in the SDK

• Adjusted default values around reties for HTTP requests. You can use the old defaults by setting them explicitly. New values are:
  • max retries: 1 -> 2
  • max timeout (seconds): 2 -> 5

Additions

• Add support for custom_unit_amount on ProductCreateParams.default_price_data
• Add support for allow_redisplay on Terminal.ReaderProcessPaymentIntentParams.process_config and Terminal.ReaderProcessSetupIntentParams
• Add support for new value international_transaction on enum Treasury.ReceivedCredit.failure_code
• Add support for new value 2024-09-30.acacia on enum WebhookEndpointCreateParams.api_version
• Add support for new Usage Billing APIs Billing.MeterEvent, Billing.MeterEventAdjustments, Billing.MeterEventSession, Billing.MeterEventStream and the new Events API Core.Events in the v2 namespace
• Add method parseThinEvent() on the Stripe class to parse thin events.
• Add method rawRequest() on the 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.

Changes

• Change BillingPortal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates and BillingPortal.ConfigurationCreateParams.features.subscription_update.products to be optional

• Add support for new value international_transaction on enum Treasury.ReceivedDebit.failure_code

• Add support for new value verification_supportability on enums Account.future_requirements.errors[].code, Account.requirements.errors[].code, BankAccount.future_requirements.errors[].code, and BankAccount.requirements.errors[].code
• Add support for new value terminal_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.code
• Add support for payer_details on Charge.payment_method_details.klarna
• Add support for amazon_pay on Dispute.payment_method_details
• Add support for new value amazon_pay on enum Dispute.payment_method_details.type
• Add support for automatically_finalizes_at on Invoice
• Add support for state_sales_tax on Tax.Registration.country_options.us and Tax.RegistrationCreateParams.country_options.us

• Add support for new resource InvoiceRenderingTemplate
• Add support for archive, list, retrieve, and unarchive methods on resource InvoiceRenderingTemplate
• Add support for required on Checkout.Session.tax_id_collection, Checkout.SessionCreateParams.tax_id_collection, PaymentLink.tax_id_collection, PaymentLinkCreateParams.tax_id_collection, and PaymentLinkUpdateParams.tax_id_collection
• Add support for template on Customer.invoice_settings.rendering_options, CustomerCreateParams.invoice_settings.rendering_options, CustomerUpdateParams.invoice_settings.rendering_options, Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.rendering
• Add support for template_version on Invoice.rendering, InvoiceCreateParams.rendering, and InvoiceUpdateParams.rendering
• Add support for new value submitted on enum Issuing.Card.shipping.status
• Change TestHelpers.TestClock.status_details to be required

• Add support for subscription_item and subscription on Billing.AlertCreateParams.filter
• Change Terminal.ReaderProcessSetupIntentParams.customer_consent_collected to be optional

• Change AccountLinkCreateParams.collection_options.fields and LineItem.description to be optional
• Add support for new value hr_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.type
• Add support for new value hr_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.type
• Add support for new value issuing_regulatory_reporting on enums File.purpose and FileListParams.purpose
• Add support for new value issuing_regulatory_reporting on enum FileCreateParams.purpose
• Change Issuing.Card.shipping.address_validation to be required
• Add support for status_details on TestHelpers.TestClock