stripe 17.6.0 → 17.7.0

package/CHANGELOG.md

@@ -1,4 +1,19 @@
 # Changelog
+## 17.7.0 - 2025-02-24
+* [#2256](https://github.com/stripe/stripe-node/pull/2256) Update generated code
+  * Add support for `prices` on `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope`, `Billing.CreditGrant.applicability_config.scope`, and `Billing.CreditGrantCreateParams.applicability_config.scope`
+  * Change `Billing.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type`, `Billing.CreditGrant.applicability_config.scope.price_type`, and `Billing.CreditGrantCreateParams.applicability_config.scope.price_type` to be optional
+  * Add support for `priority` on `Billing.CreditGrantCreateParams` and `Billing.CreditGrant`
+  * Add support for `target_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_account`
+  * Add support for `restrictions` on `Checkout.Session.payment_method_options.card` and `Checkout.SessionCreateParams.payment_method_options.card`
+  * Add support for `collected_information` on `Checkout.SessionUpdateParams` and `Checkout.Session`
+  * Change `Checkout.Session.discounts`, `Refund.destination_details.blik.network_decline_code`, and `Refund.destination_details.swish.network_decline_code` to be required
+  * Add support for `metadata` on `ProductCreateParams.default_price_data`
+  * Change type of `TokenCreateParams.person.political_exposure` from `string` to `enum('existing'|'none')`
+  * Add support for new value `2025-02-24.acacia` on enum `WebhookEndpointCreateParams.api_version`
+* [#2259](https://github.com/stripe/stripe-node/pull/2259) Add Next.js App Router webhook example that leverages Route Handlers
+* [#2257](https://github.com/stripe/stripe-node/pull/2257) Include `OPENAPI_VERSION` into npm bundle
+
 ## 17.6.0 - 2025-01-27
 * [#2250](https://github.com/stripe/stripe-node/pull/2250) Update generated code
   * Add support for `close` method on resource `Treasury.FinancialAccount`

package/OPENAPI_VERSION

@@ -0,0 +1 @@
+v1505

package/VERSION

@@ -1 +1 @@
-17.6.0
+17.7.0

package/cjs/apiVersion.js

@@ -2,4 +2,4 @@
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiVersion = void 0;
-exports.ApiVersion = '2025-01-27.acacia';
+exports.ApiVersion = '2025-02-24.acacia';

package/cjs/stripe.core.js

@@ -36,7 +36,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender_js_1.RequestSender(stripe, StripeResource_js_1.StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '17.6.0';
+    Stripe.PACKAGE_VERSION = '17.7.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, (0, utils_js_1.determineProcessUserAgentProperties)());
     Stripe.StripeResource = StripeResource_js_1.StripeResource;
     Stripe.resources = resources;

package/esm/apiVersion.js

@@ -1,2 +1,2 @@
 // File generated from our OpenAPI spec
-export const ApiVersion = '2025-01-27.acacia';
+export const ApiVersion = '2025-02-24.acacia';

package/esm/stripe.core.js

@@ -33,7 +33,7 @@ const ALLOWED_CONFIG_PROPERTIES = [
 ];
 const defaultRequestSenderFactory = (stripe) => new RequestSender(stripe, StripeResource.MAX_BUFFERED_REQUEST_METRICS);
 export function createStripe(platformFunctions, requestSender = defaultRequestSenderFactory) {
-    Stripe.PACKAGE_VERSION = '17.6.0';
+    Stripe.PACKAGE_VERSION = '17.7.0';
     Stripe.USER_AGENT = Object.assign({ bindings_version: Stripe.PACKAGE_VERSION, lang: 'node', publisher: 'stripe', uname: null, typescript: false }, determineProcessUserAgentProperties());
     Stripe.StripeResource = StripeResource;
     Stripe.resources = resources;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "17.6.0",
+  "version": "17.7.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/Balance.d.ts

@@ -67,17 +67,17 @@ declare module 'stripe' {
       namespace Available {
         interface SourceTypes {
           /**
-           * Amount for bank account.
+           * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
            */
           bank_account?: number;
 
           /**
-           * Amount for card.
+           * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
            */
           card?: number;
 
           /**
-           * Amount for FPX.
+           * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
            */
           fpx?: number;
         }
@@ -100,17 +100,17 @@ declare module 'stripe' {
       namespace ConnectReserved {
         interface SourceTypes {
           /**
-           * Amount for bank account.
+           * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
            */
           bank_account?: number;
 
           /**
-           * Amount for card.
+           * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
            */
           card?: number;
 
           /**
-           * Amount for FPX.
+           * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
            */
           fpx?: number;
         }
@@ -153,17 +153,17 @@ declare module 'stripe' {
         namespace NetAvailable {
           interface SourceTypes {
             /**
-             * Amount for bank account.
+             * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
              */
             bank_account?: number;
 
             /**
-             * Amount for card.
+             * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
              */
             card?: number;
 
             /**
-             * Amount for FPX.
+             * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
              */
             fpx?: number;
           }
@@ -171,17 +171,17 @@ declare module 'stripe' {
 
         interface SourceTypes {
           /**
-           * Amount for bank account.
+           * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
            */
           bank_account?: number;
 
           /**
-           * Amount for card.
+           * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
            */
           card?: number;
 
           /**
-           * Amount for FPX.
+           * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
            */
           fpx?: number;
         }
@@ -212,17 +212,17 @@ declare module 'stripe' {
         namespace Available {
           interface SourceTypes {
             /**
-             * Amount for bank account.
+             * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
              */
             bank_account?: number;
 
             /**
-             * Amount for card.
+             * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
              */
             card?: number;
 
             /**
-             * Amount for FPX.
+             * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
              */
             fpx?: number;
           }
@@ -246,17 +246,17 @@ declare module 'stripe' {
       namespace Pending {
         interface SourceTypes {
           /**
-           * Amount for bank account.
+           * Amount coming from [legacy US ACH payments](https://docs.stripe.com/ach-deprecated).
            */
           bank_account?: number;
 
           /**
-           * Amount for card.
+           * Amount coming from most payment methods, including cards as well as [non-legacy bank debits](https://docs.stripe.com/payments/bank-debits).
            */
           card?: number;
 
           /**
-           * Amount for FPX.
+           * Amount coming from [FPX](https://docs.stripe.com/payments/fpx), a Malaysian payment method.
            */
           fpx?: number;
         }

package/types/Billing/CreditBalanceSummaryResource.d.ts

@@ -43,7 +43,21 @@ declare module 'stripe' {
             /**
              * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
+
+            /**
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             */
+            prices?: Array<ApplicabilityScope.Price>;
+          }
+
+          namespace ApplicabilityScope {
+            interface Price {
+              /**
+               * The price ID this credit grant should apply to.
+               */
+              id: string;
+            }
           }
 
           type Type = 'applicability_scope' | 'credit_grant';

package/types/Billing/CreditGrants.d.ts

@@ -63,6 +63,11 @@ declare module 'stripe' {
          */
         name: string | null;
 
+        /**
+         * The priority for applying this credit grant. The highest priority is 0 and the lowest is 100.
+         */
+        priority?: number | null;
+
         /**
          * ID of the test clock this credit grant belongs to.
          */
@@ -115,7 +120,21 @@ declare module 'stripe' {
             /**
              * The price type that credit grants can apply to. We currently only support the `metered` price type. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
+
+            /**
+             * The prices that credit grants can apply to. We currently only support `metered` prices. This refers to prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
+             */
+            prices?: Array<Scope.Price>;
+          }
+
+          namespace Scope {
+            interface Price {
+              /**
+               * Unique identifier for the object.
+               */
+              id: string | null;
+            }
           }
         }
 

package/types/Billing/CreditGrantsResource.d.ts

@@ -10,7 +10,7 @@ declare module 'stripe' {
         amount: CreditGrantCreateParams.Amount;
 
         /**
-         * Configuration specifying what this credit grant applies to.
+         * Configuration specifying what this credit grant applies to. We currently only support `metered` prices that have a [Billing Meter](https://docs.stripe.com/api/billing/meter) attached to them.
          */
         applicability_config: CreditGrantCreateParams.ApplicabilityConfig;
 
@@ -48,6 +48,11 @@ declare module 'stripe' {
          * A descriptive name shown in the Dashboard.
          */
         name?: string;
+
+        /**
+         * The desired priority for applying this credit grant. If not specified, it will be set to the default value of 50. The highest priority is 0 and the lowest is 100.
+         */
+        priority?: number;
       }
 
       namespace CreditGrantCreateParams {
@@ -89,7 +94,21 @@ declare module 'stripe' {
             /**
              * The price type that credit grants can apply to. We currently only support the `metered` price type.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
+
+            /**
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             */
+            prices?: Array<Scope.Price>;
+          }
+
+          namespace Scope {
+            interface Price {
+              /**
+               * The price ID this credit grant should apply to.
+               */
+              id: string;
+            }
           }
         }
 

package/types/Billing/MeterEventSummaries.d.ts

@@ -6,6 +6,8 @@ declare module 'stripe' {
       /**
        * A billing meter event summary represents an aggregated view of a customer's billing meter events within a specified timeframe. It indicates how much
        * usage was accrued by a customer for that period.
+       *
+       * Note: Meters events are aggregated asynchronously so the meter event summaries provide an eventually consistent view of the reported usage.
        */
       interface MeterEventSummary {
         /**

package/types/Charges.d.ts

@@ -483,7 +483,7 @@ declare module 'stripe' {
         twint?: PaymentMethodDetails.Twint;
 
         /**
-         * The type of transaction-specific details of the payment method used in the payment, one of `ach_credit_transfer`, `ach_debit`, `acss_debit`, `alipay`, `au_becs_debit`, `bancontact`, `card`, `card_present`, `eps`, `giropay`, `ideal`, `klarna`, `multibanco`, `p24`, `sepa_debit`, `sofort`, `stripe_account`, or `wechat`.
+         * The type of transaction-specific details of the payment method used in the payment. See [PaymentMethod.type](https://stripe.com/docs/api/payment_methods/object#payment_method_object-type) for the full list of possible types.
          * An additional hash is included on `payment_method_details` with a name matching this value.
          * It contains information specific to the payment method.
          */
@@ -889,7 +889,7 @@ declare module 'stripe' {
           network_token?: Card.NetworkToken | null;
 
           /**
-           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent the date (MM/DD). This field will be available for successful Visa, Mastercard, or American Express transactions and always null for other card brands.
+           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
            */
           network_transaction_id: string | null;
 
@@ -1274,7 +1274,7 @@ declare module 'stripe' {
           network: string | null;
 
           /**
-           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent the date (MM/DD). This field will be available for successful Visa, Mastercard, or American Express transactions and always null for other card brands.
+           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
            */
           network_transaction_id: string | null;
 
@@ -1671,7 +1671,7 @@ declare module 'stripe' {
           network: string | null;
 
           /**
-           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. The first three digits of the Trace ID is the Financial Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent the date (MM/DD). This field will be available for successful Visa, Mastercard, or American Express transactions and always null for other card brands.
+           * This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
            */
           network_transaction_id: string | null;
 

package/types/Checkout/Sessions.d.ts

@@ -79,6 +79,11 @@ declare module 'stripe' {
          */
         client_secret: string | null;
 
+        /**
+         * Information about the customer collected within the Checkout Session.
+         */
+        collected_information?: Session.CollectedInformation | null;
+
         /**
          * Results of `consent_collection` for this session.
          */
@@ -142,7 +147,7 @@ declare module 'stripe' {
         /**
          * List of coupons and promotion codes attached to the Checkout Session.
          */
-        discounts?: Array<Session.Discount> | null;
+        discounts: Array<Session.Discount> | null;
 
         /**
          * The timestamp at which the Checkout Session will expire.
@@ -390,6 +395,39 @@ declare module 'stripe' {
 
         type BillingAddressCollection = 'auto' | 'required';
 
+        interface CollectedInformation {
+          /**
+           * Shipping information for this Checkout Session.
+           */
+          shipping_details?: CollectedInformation.ShippingDetails | null;
+        }
+
+        namespace CollectedInformation {
+          interface ShippingDetails {
+            address?: Stripe.Address;
+
+            /**
+             * The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
+             */
+            carrier?: string | null;
+
+            /**
+             * Recipient name.
+             */
+            name?: string;
+
+            /**
+             * Recipient phone (including extension).
+             */
+            phone?: string | null;
+
+            /**
+             * The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
+             */
+            tracking_number?: string | null;
+          }
+        }
+
         interface Consent {
           /**
            * If `opt_in`, the customer consents to receiving promotional communications
@@ -1045,6 +1083,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: AcssDebit.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Bank account verification method.
              */
@@ -1161,6 +1204,11 @@ declare module 'stripe' {
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: 'none';
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           interface BacsDebit {
@@ -1176,6 +1224,11 @@ declare module 'stripe' {
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: BacsDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace BacsDebit {
@@ -1252,6 +1305,8 @@ declare module 'stripe' {
              */
             request_three_d_secure: Card.RequestThreeDSecure;
 
+            restrictions?: Card.Restrictions;
+
             /**
              * Indicates that you intend to make future payments with this PaymentIntent's payment method.
              *
@@ -1292,6 +1347,21 @@ declare module 'stripe' {
 
             type RequestThreeDSecure = 'any' | 'automatic' | 'challenge';
 
+            interface Restrictions {
+              /**
+               * Specify the card brands to block in the Checkout Session. If a customer enters or selects a card belonging to a blocked brand, they can't complete the Session.
+               */
+              brands_blocked?: Array<Restrictions.BrandsBlocked>;
+            }
+
+            namespace Restrictions {
+              type BrandsBlocked =
+                | 'american_express'
+                | 'discover_global_network'
+                | 'mastercard'
+                | 'visa';
+            }
+
             type SetupFutureUsage = 'none' | 'off_session' | 'on_session';
           }
 
@@ -1698,6 +1768,11 @@ declare module 'stripe' {
              * When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](https://stripe.com/strong-customer-authentication).
              */
             setup_future_usage?: SepaDebit.SetupFutureUsage;
+
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
           }
 
           namespace SepaDebit {
@@ -1745,6 +1820,11 @@ declare module 'stripe' {
              */
             setup_future_usage?: UsBankAccount.SetupFutureUsage;
 
+            /**
+             * Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
+             */
+            target_date?: string;
+
             /**
              * Bank account verification method.
              */
@@ -2121,9 +2201,9 @@ declare module 'stripe' {
             amount: number;
 
             /**
-             * Tax rates can be applied to [invoices](https://stripe.com/docs/billing/invoices/tax-rates), [subscriptions](https://stripe.com/docs/billing/subscriptions/taxes) and [Checkout Sessions](https://stripe.com/docs/payments/checkout/set-up-a-subscription#tax-rates) to collect tax.
+             * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
              *
-             * Related guide: [Tax rates](https://stripe.com/docs/billing/taxes/tax-rates)
+             * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
              */
             rate: Stripe.TaxRate;
 
@@ -2269,9 +2349,9 @@ declare module 'stripe' {
               amount: number;
 
               /**
-               * Tax rates can be applied to [invoices](https://stripe.com/docs/billing/invoices/tax-rates), [subscriptions](https://stripe.com/docs/billing/subscriptions/taxes) and [Checkout Sessions](https://stripe.com/docs/payments/checkout/set-up-a-subscription#tax-rates) to collect tax.
+               * Tax rates can be applied to [invoices](https://stripe.com/invoicing/taxes/tax-rates), [subscriptions](https://stripe.com/billing/taxes/tax-rates) and [Checkout Sessions](https://stripe.com/payments/checkout/use-manual-tax-rates) to collect tax.
                *
-               * Related guide: [Tax rates](https://stripe.com/docs/billing/taxes/tax-rates)
+               * Related guide: [Tax rates](https://stripe.com/billing/taxes/tax-rates)
                */
               rate: Stripe.TaxRate;