stripe 17.2.1 → 17.3.0

package/types/Terminal/ConfigurationsResource.d.ts

@@ -135,6 +135,11 @@ declare module 'stripe' {
            */
           nzd?: Tipping.Nzd;
 
+          /**
+           * Tipping configuration for PLN
+           */
+          pln?: Tipping.Pln;
+
           /**
            * Tipping configuration for SEK
            */
@@ -339,6 +344,23 @@ declare module 'stripe' {
             smart_tip_threshold?: number;
           }
 
+          interface Pln {
+            /**
+             * Fixed amounts displayed when collecting a tip
+             */
+            fixed_amounts?: Array<number>;
+
+            /**
+             * Percentages displayed when collecting a tip
+             */
+            percentages?: Array<number>;
+
+            /**
+             * Below this amount, fixed amounts will be displayed; above it, percentages will be displayed
+             */
+            smart_tip_threshold?: number;
+          }
+
           interface Sek {
             /**
              * Fixed amounts displayed when collecting a tip
@@ -544,6 +566,11 @@ declare module 'stripe' {
            */
           nzd?: Tipping.Nzd;
 
+          /**
+           * Tipping configuration for PLN
+           */
+          pln?: Tipping.Pln;
+
           /**
            * Tipping configuration for SEK
            */
@@ -748,6 +775,23 @@ declare module 'stripe' {
             smart_tip_threshold?: number;
           }
 
+          interface Pln {
+            /**
+             * Fixed amounts displayed when collecting a tip
+             */
+            fixed_amounts?: Array<number>;
+
+            /**
+             * Percentages displayed when collecting a tip
+             */
+            percentages?: Array<number>;
+
+            /**
+             * Below this amount, fixed amounts will be displayed; above it, percentages will be displayed
+             */
+            smart_tip_threshold?: number;
+          }
+
           interface Sek {
             /**
              * Fixed amounts displayed when collecting a tip

package/types/TestHelpers/ConfirmationTokensResource.d.ts

@@ -64,6 +64,11 @@ declare module 'stripe' {
            */
           allow_redisplay?: PaymentMethodData.AllowRedisplay;
 
+          /**
+           * If this is a Alma PaymentMethod, this hash contains details about the Alma payment method.
+           */
+          alma?: PaymentMethodData.Alma;
+
           /**
            * If this is a AmazonPay PaymentMethod, this hash contains details about the AmazonPay payment method.
            */
@@ -139,6 +144,11 @@ declare module 'stripe' {
            */
           interac_present?: PaymentMethodData.InteracPresent;
 
+          /**
+           * If this is a `kakao_pay` PaymentMethod, this hash contains details about the Kakao Pay payment method.
+           */
+          kakao_pay?: PaymentMethodData.KakaoPay;
+
           /**
            * If this is a `klarna` PaymentMethod, this hash contains details about the Klarna payment method.
            */
@@ -149,6 +159,11 @@ declare module 'stripe' {
            */
           konbini?: PaymentMethodData.Konbini;
 
+          /**
+           * If this is a `kr_card` PaymentMethod, this hash contains details about the Korean Card payment method.
+           */
+          kr_card?: PaymentMethodData.KrCard;
+
           /**
            * If this is an `Link` PaymentMethod, this hash contains details about the Link payment method.
            */
@@ -169,6 +184,11 @@ declare module 'stripe' {
            */
           multibanco?: PaymentMethodData.Multibanco;
 
+          /**
+           * If this is a `naver_pay` PaymentMethod, this hash contains details about the Naver Pay payment method.
+           */
+          naver_pay?: PaymentMethodData.NaverPay;
+
           /**
            * If this is an `oxxo` PaymentMethod, this hash contains details about the OXXO payment method.
            */
@@ -179,6 +199,11 @@ declare module 'stripe' {
            */
           p24?: PaymentMethodData.P24;
 
+          /**
+           * If this is a `payco` PaymentMethod, this hash contains details about the PAYCO payment method.
+           */
+          payco?: PaymentMethodData.Payco;
+
           /**
            * If this is a `paynow` PaymentMethod, this hash contains details about the PayNow payment method.
            */
@@ -209,6 +234,11 @@ declare module 'stripe' {
            */
           revolut_pay?: PaymentMethodData.RevolutPay;
 
+          /**
+           * If this is a `samsung_pay` PaymentMethod, this hash contains details about the SamsungPay payment method.
+           */
+          samsung_pay?: PaymentMethodData.SamsungPay;
+
           /**
            * If this is a `sepa_debit` PaymentMethod, this hash contains details about the SEPA debit bank account.
            */
@@ -276,6 +306,8 @@ declare module 'stripe' {
 
           type AllowRedisplay = 'always' | 'limited' | 'unspecified';
 
+          interface Alma {}
+
           interface AmazonPay {}
 
           interface AuBecsDebit {
@@ -424,7 +456,7 @@ declare module 'stripe' {
 
           interface Ideal {
             /**
-             * The customer's bank.
+             * The customer's bank. Only use this parameter for existing customers. Don't use it for new customers.
              */
             bank?: Ideal.Bank;
           }
@@ -451,6 +483,8 @@ declare module 'stripe' {
 
           interface InteracPresent {}
 
+          interface KakaoPay {}
+
           interface Klarna {
             /**
              * Customer's date of birth
@@ -479,12 +513,25 @@ declare module 'stripe' {
 
           interface Konbini {}
 
+          interface KrCard {}
+
           interface Link {}
 
           interface Mobilepay {}
 
           interface Multibanco {}
 
+          interface NaverPay {
+            /**
+             * Whether to use Naver Pay points or a card to fund this transaction. If not provided, this defaults to `card`.
+             */
+            funding?: NaverPay.Funding;
+          }
+
+          namespace NaverPay {
+            type Funding = 'card' | 'points';
+          }
+
           interface Oxxo {}
 
           interface P24 {
@@ -524,6 +571,8 @@ declare module 'stripe' {
               | 'volkswagen_bank';
           }
 
+          interface Payco {}
+
           interface Paynow {}
 
           interface Paypal {}
@@ -541,6 +590,8 @@ declare module 'stripe' {
 
           interface RevolutPay {}
 
+          interface SamsungPay {}
+
           interface SepaDebit {
             /**
              * IBAN of the bank account.
@@ -568,6 +619,7 @@ declare module 'stripe' {
             | 'affirm'
             | 'afterpay_clearpay'
             | 'alipay'
+            | 'alma'
             | 'amazon_pay'
             | 'au_becs_debit'
             | 'bacs_debit'
@@ -581,18 +633,23 @@ declare module 'stripe' {
             | 'giropay'
             | 'grabpay'
             | 'ideal'
+            | 'kakao_pay'
             | 'klarna'
             | 'konbini'
+            | 'kr_card'
             | 'link'
             | 'mobilepay'
             | 'multibanco'
+            | 'naver_pay'
             | 'oxxo'
             | 'p24'
+            | 'payco'
             | 'paynow'
             | 'paypal'
             | 'pix'
             | 'promptpay'
             | 'revolut_pay'
+            | 'samsung_pay'
             | 'sepa_debit'
             | 'sofort'
             | 'swish'

package/types/TestHelpers/Issuing/CardsResource.d.ts

@@ -39,6 +39,15 @@ declare module 'stripe' {
         }
       }
 
+      namespace Issuing {
+        interface CardSubmitCardParams {
+          /**
+           * Specifies which fields in the response should be expanded.
+           */
+          expand?: Array<string>;
+        }
+      }
+
       namespace Issuing {
         class CardsResource {
           /**
@@ -92,6 +101,19 @@ declare module 'stripe' {
             id: string,
             options?: RequestOptions
           ): Promise<Stripe.Response<Stripe.Issuing.Card>>;
+
+          /**
+           * Updates the shipping status of the specified Issuing Card object to submitted. This method requires Stripe Version ‘2024-09-30.acacia' or later.
+           */
+          submitCard(
+            id: string,
+            params?: CardSubmitCardParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Issuing.Card>>;
+          submitCard(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.Issuing.Card>>;
         }
       }
     }

package/types/TokensResource.d.ts

@@ -288,7 +288,7 @@ declare module 'stripe' {
           full_name_aliases?: Stripe.Emptyable<Array<string>>;
 
           /**
-           * The individual's gender (International regulations require either "male" or "female").
+           * The individual's gender
            */
           gender?: string;
 
@@ -890,7 +890,7 @@ declare module 'stripe' {
     class TokensResource {
       /**
        * Creates a single-use token that represents a bank account's details.
-       * You can use this token with any API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
+       * You can use this token with any v1 API method in place of a bank account dictionary. You can only use this token once. To do so, attach it to a [connected account](https://stripe.com/docs/api#accounts) where [controller.requirement_collection](https://stripe.com/api/accounts/object#account_object-controller-requirement_collection) is application, which includes Custom accounts.
        */
       create(
         params?: TokenCreateParams,

package/types/Treasury/FinancialAccounts.d.ts

@@ -75,7 +75,7 @@ declare module 'stripe' {
         restricted_features?: Array<FinancialAccount.RestrictedFeature>;
 
         /**
-         * The enum specifying what state the account is in.
+         * Status of this FinancialAccount.
          */
         status: FinancialAccount.Status;
 

package/types/UsageRecordSummaries.d.ts

@@ -3,7 +3,7 @@
 declare module 'stripe' {
   namespace Stripe {
     /**
-     * The UsageRecordSummary object.
+     * A usage record summary represents an aggregated view of how much usage was accrued for a subscription item within a subscription billing period.
      */
     interface UsageRecordSummary {
       /**

package/types/V2/Core/EventDestinationsResource.d.ts

@@ -0,0 +1,281 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace V2 {
+      namespace Core {
+        interface EventDestinationCreateParams {
+          /**
+           * The list of events to enable for this endpoint.
+           */
+          enabled_events: Array<string>;
+
+          /**
+           * Payload type of events being subscribed to.
+           */
+          event_payload: EventDestinationCreateParams.EventPayload;
+
+          /**
+           * Event destination name.
+           */
+          name: string;
+
+          /**
+           * Event destination type.
+           */
+          type: EventDestinationCreateParams.Type;
+
+          /**
+           * Amazon EventBridge configuration.
+           */
+          amazon_eventbridge?: EventDestinationCreateParams.AmazonEventbridge;
+
+          /**
+           * An optional description of what the event destination is used for.
+           */
+          description?: string;
+
+          /**
+           * Where events should be routed from.
+           */
+          events_from?: Array<EventDestinationCreateParams.EventsFrom>;
+
+          /**
+           * Additional fields to include in the response.
+           */
+          include?: Array<EventDestinationCreateParams.Include>;
+
+          /**
+           * Metadata.
+           */
+          metadata?: Stripe.MetadataParam;
+
+          /**
+           * If using the snapshot event payload, the API version events are rendered as.
+           */
+          snapshot_api_version?: string;
+
+          /**
+           * Webhook endpoint configuration.
+           */
+          webhook_endpoint?: EventDestinationCreateParams.WebhookEndpoint;
+        }
+
+        namespace EventDestinationCreateParams {
+          interface AmazonEventbridge {
+            /**
+             * The AWS account ID.
+             */
+            aws_account_id: string;
+
+            /**
+             * The region of the AWS event source.
+             */
+            aws_region: string;
+          }
+
+          type EventPayload = 'snapshot' | 'thin';
+
+          type EventsFrom = 'other_accounts' | 'self';
+
+          type Include =
+            | 'webhook_endpoint.signing_secret'
+            | 'webhook_endpoint.url';
+
+          type Type = 'amazon_eventbridge' | 'webhook_endpoint';
+
+          interface WebhookEndpoint {
+            /**
+             * The URL of the webhook endpoint.
+             */
+            url: string;
+          }
+        }
+      }
+
+      namespace Core {
+        interface EventDestinationRetrieveParams {
+          /**
+           * Additional fields to include in the response.
+           */
+          include?: Array<'webhook_endpoint.url'>;
+        }
+      }
+
+      namespace Core {
+        interface EventDestinationUpdateParams {
+          /**
+           * An optional description of what the event destination is used for.
+           */
+          description?: string;
+
+          /**
+           * The list of events to enable for this endpoint.
+           */
+          enabled_events?: Array<string>;
+
+          /**
+           * Additional fields to include in the response. Currently supports `webhook_endpoint.url`.
+           */
+          include?: Array<'webhook_endpoint.url'>;
+
+          /**
+           * Metadata.
+           */
+          metadata?: Stripe.MetadataParam;
+
+          /**
+           * Event destination name.
+           */
+          name?: string;
+
+          /**
+           * Webhook endpoint configuration.
+           */
+          webhook_endpoint?: EventDestinationUpdateParams.WebhookEndpoint;
+        }
+
+        namespace EventDestinationUpdateParams {
+          interface WebhookEndpoint {
+            /**
+             * The URL of the webhook endpoint.
+             */
+            url: string;
+          }
+        }
+      }
+
+      namespace Core {
+        interface EventDestinationListParams {
+          /**
+           * Additional fields to include in the response. Currently supports `webhook_endpoint.url`.
+           */
+          include?: Array<'webhook_endpoint.url'>;
+
+          /**
+           * The page size.
+           */
+          limit?: number;
+
+          /**
+           * The requested page.
+           */
+          page?: string;
+        }
+      }
+
+      namespace Core {
+        interface EventDestinationDeleteParams {}
+      }
+
+      namespace Core {
+        interface EventDestinationDisableParams {}
+      }
+
+      namespace Core {
+        interface EventDestinationEnableParams {}
+      }
+
+      namespace Core {
+        interface EventDestinationPingParams {}
+      }
+
+      namespace Core {
+        class EventDestinationsResource {
+          /**
+           * Create a new event destination.
+           */
+          create(
+            params: EventDestinationCreateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Retrieves the details of an event destination.
+           */
+          retrieve(
+            id: string,
+            params?: EventDestinationRetrieveParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+          retrieve(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Update the details of an event destination.
+           */
+          update(
+            id: string,
+            params?: EventDestinationUpdateParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Lists all event destinations.
+           */
+          list(
+            params?: EventDestinationListParams,
+            options?: RequestOptions
+          ): ApiListPromise<Stripe.V2.EventDestination>;
+          list(
+            options?: RequestOptions
+          ): ApiListPromise<Stripe.V2.EventDestination>;
+
+          /**
+           * Delete an event destination.
+           */
+          del(
+            id: string,
+            params?: EventDestinationDeleteParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+          del(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Disable an event destination.
+           */
+          disable(
+            id: string,
+            params?: EventDestinationDisableParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+          disable(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Enable an event destination.
+           */
+          enable(
+            id: string,
+            params?: EventDestinationEnableParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+          enable(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.EventDestination>>;
+
+          /**
+           * Send a `ping` event to an event destination.
+           */
+          ping(
+            id: string,
+            params?: EventDestinationPingParams,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Event>>;
+          ping(
+            id: string,
+            options?: RequestOptions
+          ): Promise<Stripe.Response<Stripe.V2.Event>>;
+        }
+      }
+    }
+  }
+}

package/types/V2/Core/EventsResource.d.ts

@@ -22,7 +22,7 @@ declare module 'stripe' {
           limit?: number;
 
           /**
-           * The requested page number.
+           * The requested page.
            */
           page?: string;
         }

package/types/V2/CoreResource.d.ts

@@ -4,6 +4,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace V2 {
       class CoreResource {
+        eventDestinations: Stripe.V2.Core.EventDestinationsResource;
         events: Stripe.V2.Core.EventsResource;
       }
     }