|
1 | 1 | # Changelog
|
2 | 2 |
|
| 3 | +## 17.0.0 - 2024-10-01 |
| 4 | +* [#2192](https://github.com/stripe/stripe-node/pull/2192) Support for APIs in the new API version 2024-09-30.acacia |
| 5 | + |
| 6 | + This release changes the pinned API version to `2024-09-30.acacia`. Please read the [API Upgrade Guide](https://stripe.com/docs/upgrades#2024-09-30.acacia) and carefully review the API changes before upgrading. |
| 7 | + |
| 8 | + ### ⚠️ Breaking changes due to changes in the Stripe API |
| 9 | + - Rename `usage_threshold_config` to `usage_threshold` on `Billing.AlertCreateParams` and `Billing.Alert` |
| 10 | + - Remove support for `filter` on `Billing.AlertCreateParams` and `Billing.Alert`. Use the filters on the `usage_threshold` instead |
| 11 | + - Remove support for `customer_consent_collected` on `Terminal.ReaderProcessSetupIntentParams`. |
| 12 | + |
| 13 | + ### ⚠️ Other Breaking changes in the SDK |
| 14 | + - Adjusted default values around reties for HTTP requests. You can use the old defaults by setting them explicitly. New values are: |
| 15 | + - max retries: `1` -> `2` |
| 16 | + - max timeout (seconds): `2` -> `5` |
| 17 | + |
| 18 | + |
| 19 | + ### Additions |
| 20 | + * Add support for `custom_unit_amount` on `ProductCreateParams.default_price_data` |
| 21 | + * Add support for `allow_redisplay` on `Terminal.ReaderProcessPaymentIntentParams.process_config` and `Terminal.ReaderProcessSetupIntentParams` |
| 22 | + * Add support for new value `international_transaction` on enum `Treasury.ReceivedCredit.failure_code` |
| 23 | + * Add support for new value `2024-09-30.acacia` on enum `WebhookEndpointCreateParams.api_version` |
| 24 | + * 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 ](https://docs.corp.stripe.com/api-v2-overview) |
| 25 | + * Add method `parseThinEvent()` on the `Stripe` class to parse [thin events](https://docs.corp.stripe.com/event-destinations#events-overview). |
| 26 | + * Add method [rawRequest()](https://github.com/stripe/stripe-node/tree/master?tab=readme-ov-file#custom-requests) 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. |
| 27 | + |
| 28 | + ### Changes |
| 29 | + * Change `BillingPortal.ConfigurationCreateParams.features.subscription_update.default_allowed_updates` and `BillingPortal.ConfigurationCreateParams.features.subscription_update.products` to be optional |
| 30 | +* [#2195](https://github.com/stripe/stripe-node/pull/2195) Remove parseSnapshotEvent |
| 31 | +* [#2188](https://github.com/stripe/stripe-node/pull/2188) Revert "Add raw_request (#2185)" |
| 32 | +* [#2185](https://github.com/stripe/stripe-node/pull/2185) Add raw_request |
| 33 | + Adds the ability to make raw requests to the Stripe API, by providing an HTTP method and url. |
| 34 | + |
| 35 | + Example: |
| 36 | + ```node |
| 37 | + import Stripe from 'stripe'; |
| 38 | + const stripe = new Stripe('sk_test_...'); |
| 39 | + |
| 40 | + const response = await stripe.rawRequest( |
| 41 | + 'POST', |
| 42 | + '/v1/beta_endpoint', |
| 43 | + { param: 123 }, |
| 44 | + { apiVersion: '2022-11-15; feature_beta=v3' } |
| 45 | + ); |
| 46 | + |
| 47 | + ``` |
| 48 | + |
3 | 49 | ## 16.12.0 - 2024-09-18
|
4 | 50 | * [#2177](https://github.com/stripe/stripe-node/pull/2177) Update generated code
|
5 | 51 | * Add support for new value `international_transaction` on enum `Treasury.ReceivedDebit.failure_code`
|
|
0 commit comments