Update generated code for beta

CHANGELOG.md

@@ -1,5 +1,20 @@
 # 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.7.0-beta.1 - 2025-02-07
 * [#2254](https://github.com/stripe/stripe-node/pull/2254) Update generated code for beta
   * Add support for `rejected_reason` on `Account.risk_controls`

OPENAPI_VERSION

@@ -1 +1 @@
-v1472
+v1517

examples/webhook-signing/nextjs/app/api/webhooks/route.ts

@@ -0,0 +1,69 @@
+import {Stripe} from 'stripe';
+import {NextResponse} from 'next/server';
+import {headers} from 'next/headers';
+
+const stripe = new Stripe(process.env.STRIPE_SECRET_KEY as string);
+
+export async function POST(req: Request) {
+  let event: Stripe.Event;
+
+  try {
+    const stripeSignature = (await headers()).get('stripe-signature');
+
+    event = stripe.webhooks.constructEvent(
+      await req.text(),
+      stripeSignature as string,
+      process.env.STRIPE_WEBHOOK_SECRET as string
+    );
+  } catch (err) {
+    const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+    // On error, log and return the error message.
+    if (err! instanceof Error) console.log(err);
+    console.log(`❌ Error message: ${errorMessage}`);
+    return NextResponse.json(
+      {message: `Webhook Error: ${errorMessage}`},
+      {status: 400}
+    );
+  }
+
+  // Successfully constructed event.
+  console.log('✅ Success:', event.id);
+
+  const permittedEvents: string[] = [
+    'checkout.session.completed',
+    'payment_intent.succeeded',
+    'payment_intent.payment_failed',
+  ];
+
+  if (permittedEvents.includes(event.type)) {
+    let data;
+
+    try {
+      switch (event.type) {
+        case 'checkout.session.completed':
+          data = event.data.object as Stripe.Checkout.Session;
+          console.log(`💰 CheckoutSession status: ${data.payment_status}`);
+          break;
+        case 'payment_intent.payment_failed':
+          data = event.data.object as Stripe.PaymentIntent;
+          console.log(`❌ Payment failed: ${data.last_payment_error?.message}`);
+          break;
+        case 'payment_intent.succeeded':
+          data = event.data.object as Stripe.PaymentIntent;
+          console.log(`💰 PaymentIntent status: ${data.status}`);
+          break;
+        default:
+          throw new Error(`Unhandled event: ${event.type}`);
+      }
+    } catch (error) {
+      console.log(error);
+      return NextResponse.json(
+        {message: 'Webhook handler failed'},
+        {status: 500}
+      );
+    }
+  }
+
+  // Return a response to acknowledge receipt of the event.
+  return NextResponse.json({message: 'Received'}, {status: 200});
+}

src/apiVersion.ts

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec
 
-export const ApiVersion = '2025-01-27.acacia';
+export const ApiVersion = '2025-03-31.basil';

src/resources/TestHelpers/Terminal/Readers.ts

@@ -8,4 +8,14 @@ export const Readers = StripeResource.extend({
     fullPath:
       '/v1/test_helpers/terminal/readers/{reader}/present_payment_method',
   }),
+  succeedInputCollection: stripeMethod({
+    method: 'POST',
+    fullPath:
+      '/v1/test_helpers/terminal/readers/{reader}/succeed_input_collection',
+  }),
+  timeoutInputCollection: stripeMethod({
+    method: 'POST',
+    fullPath:
+      '/v1/test_helpers/terminal/readers/{reader}/timeout_input_collection',
+  }),
 });

types/Accounts.d.ts

@@ -1436,7 +1436,7 @@ declare module 'stripe' {
         /**
          * Represents the rejected reason of the account. Empty if account is not rejected, or rejected by Stripe. Please see [this page for more details](https://stripe.com/docs/connect/)
          */
-        rejected_reason?: RiskControls.RejectedReason;
+        rejected_reason?: RiskControls.RejectedReason | null;
       }
 
       namespace RiskControls {

types/AccountsResource.d.ts

@@ -4157,7 +4157,7 @@ declare module 'stripe' {
       /**
        * Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
        */
-      political_exposure?: AccountCreatePersonParams.PoliticalExposure;
+      political_exposure?: string;
 
       /**
        * The person's registered address.
@@ -4264,8 +4264,6 @@ declare module 'stripe' {
         }
       }
 
-      type PoliticalExposure = 'existing' | 'none';
-
       interface Relationship {
         /**
          * Whether the person is the authorizer of the account's representative.
@@ -4699,7 +4697,7 @@ declare module 'stripe' {
       /**
        * Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
        */
-      political_exposure?: AccountUpdatePersonParams.PoliticalExposure;
+      political_exposure?: string;
 
       /**
        * The person's registered address.
@@ -4806,8 +4804,6 @@ declare module 'stripe' {
         }
       }
 
-      type PoliticalExposure = 'existing' | 'none';
-
       interface Relationship {
         /**
          * Whether the person is the authorizer of the account's representative.

types/BankAccounts.d.ts

@@ -23,7 +23,7 @@ declare module 'stripe' {
       object: 'bank_account';
 
       /**
-       * The ID of the account that the bank account is associated with.
+       * The account this bank account belongs to. Only applicable on Accounts (not customers or recipients) This property is only available when returned as an [External Account](https://stripe.com/api/external_account_bank_accounts/object) where [controller.is_controller](https://stripe.com/api/accounts/object#account_object-controller-is_controller) is `true`.
        */
       account?: string | Stripe.Account | null;
 

types/Billing/CreditBalanceSummaryResource.d.ts

@@ -41,12 +41,12 @@ declare module 'stripe' {
         namespace Filter {
           interface ApplicabilityScope {
             /**
-             * The price type that credit grants can apply to. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
 
             /**
-             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
              */
             prices?: Array<ApplicabilityScope.Price>;
           }

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.
          */
@@ -113,12 +118,12 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * 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.
+             * 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. Cannot be used in combination with `prices`.
              */
             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.
+             * 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. Cannot be used in combination with `price_type`.
              */
             prices?: Array<Scope.Price>;
           }

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 {
@@ -87,12 +92,12 @@ declare module 'stripe' {
         namespace ApplicabilityConfig {
           interface Scope {
             /**
-             * The price type that credit grants can apply to. We currently only support the `metered` price type.
+             * The price type that credit grants can apply to. We currently only support the `metered` price type. Cannot be used in combination with `prices`.
              */
-            price_type: 'metered';
+            price_type?: 'metered';
 
             /**
-             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices.
+             * A list of prices that the credit grant can apply to. We currently only support the `metered` prices. Cannot be used in combination with `price_type`.
              */
             prices?: Array<Scope.Price>;
           }

types/Cards.d.ts

@@ -20,9 +20,6 @@ declare module 'stripe' {
        */
       object: 'card';
 
-      /**
-       * The account this card belongs to. This attribute will not be in the card object if the card belongs to a customer or recipient instead. This property is only available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
-       */
       account?: string | Stripe.Account | null;
 
       /**
@@ -91,7 +88,7 @@ declare module 'stripe' {
       country: string | null;
 
       /**
-       * Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available for accounts where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
+       * Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase. Must be a [supported currency](https://docs.stripe.com/currencies). Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available when returned as an [External Account](https://stripe.com/api/external_account_cards/object) where [controller.is_controller](https://stripe.com/api/accounts/object#account_object-controller-is_controller) is `true`.
        */
       currency?: string | null;
 

types/Charges.d.ts

@@ -497,7 +497,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.
          */