stripe 20.2.0-alpha.1 → 20.2.0-beta.1

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

@@ -23,11 +23,6 @@ declare module 'stripe' {
 
           namespace Reason {
             interface Request {
-              /**
-               * The client details that made the request.
-               */
-              client?: Request.Client;
-
               /**
                * ID of the API request that caused the event.
                */
@@ -38,62 +33,6 @@ declare module 'stripe' {
                */
               idempotency_key: string;
             }
-
-            namespace Request {
-              interface Client {
-                /**
-                 * The type of the client.
-                 */
-                type: Client.Type;
-
-                /**
-                 * API key that triggered the event.
-                 */
-                api_key?: Client.ApiKey;
-
-                /**
-                 * Dashboard user that triggered the event.
-                 */
-                dashboard_user?: Client.DashboardUser;
-
-                /**
-                 * Stripe action that triggered the event.
-                 */
-                stripe_action?: Client.StripeAction;
-              }
-
-              namespace Client {
-                interface ApiKey {
-                  /**
-                   * The ID of the API key.
-                   */
-                  id: string;
-                }
-
-                interface DashboardUser {
-                  /**
-                   * The email of the dashboard user.
-                   */
-                  email: string;
-
-                  /**
-                   * The IP address of the user.
-                   */
-                  ip_address: string;
-
-                  /**
-                   * The machine identifier of the user.
-                   */
-                  machine_identifier: string;
-                }
-
-                type StripeAction = {
-                  [key: string]: unknown;
-                };
-
-                type Type = 'api_key' | 'dashboard_user' | 'stripe_action';
-              }
-            }
           }
         }
 

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

@@ -6,12 +6,7 @@ declare module 'stripe' {
   namespace Stripe {
     namespace V2 {
       namespace Core {
-        interface EventRetrieveParams {
-          /**
-           * Additional fields to include in the response.
-           */
-          include?: Array<'reason.request.client'>;
-        }
+        interface EventRetrieveParams {}
       }
 
       namespace Core {
@@ -21,11 +16,6 @@ declare module 'stripe' {
            */
           created?: Stripe.RangeQueryParam;
 
-          /**
-           * Additional fields to include in the response.
-           */
-          include?: Array<'reason.request.client'>;
-
           /**
            * The page size.
            */

package/types/V2/Core/Vault/GbBankAccounts.d.ts

@@ -19,11 +19,6 @@ declare module 'stripe' {
              */
             object: 'v2.core.vault.gb_bank_account';
 
-            /**
-             * The alternative reference for this payout method, if it's a projected payout method.
-             */
-            alternative_reference?: GbBankAccount.AlternativeReference;
-
             /**
              * Whether this bank account object was archived. Bank account objects can be archived through
              * the /archive API, and they will not be automatically archived by Stripe. Archived bank account objects
@@ -69,22 +64,6 @@ declare module 'stripe' {
           }
 
           namespace GbBankAccount {
-            interface AlternativeReference {
-              /**
-               * The ID of the alternative resource being referenced.
-               */
-              id: string;
-
-              /**
-               * The type of the alternative reference (e.g., external_account for V1 external accounts).
-               */
-              type: AlternativeReference.Type;
-            }
-
-            namespace AlternativeReference {
-              type Type = 'external_account' | 'payment_method';
-            }
-
             type BankAccountType = 'checking' | 'savings';
 
             interface ConfirmationOfPayee {

package/types/V2/Core/Vault/UsBankAccounts.d.ts

@@ -19,11 +19,6 @@ declare module 'stripe' {
              */
             object: 'v2.core.vault.us_bank_account';
 
-            /**
-             * The alternative reference for this payout method, if it's a projected payout method.
-             */
-            alternative_reference?: UsBankAccount.AlternativeReference;
-
             /**
              * Whether this USBankAccount object was archived.
              */
@@ -76,22 +71,6 @@ declare module 'stripe' {
           }
 
           namespace UsBankAccount {
-            interface AlternativeReference {
-              /**
-               * The ID of the alternative resource being referenced.
-               */
-              id: string;
-
-              /**
-               * The type of the alternative reference (e.g., external_account for V1 external accounts).
-               */
-              type: AlternativeReference.Type;
-            }
-
-            namespace AlternativeReference {
-              type Type = 'external_account' | 'payment_method';
-            }
-
             type BankAccountType = 'checking' | 'savings';
 
             interface Verification {

package/types/V2/EventMisc.d.ts

@@ -26,6 +26,43 @@ declare module 'stripe' {
       static parse(contextStr?: string | null): StripeContext;
     }
 
+    interface UnhandledNotificationDetails {
+      isKnownEventType: boolean;
+    }
+
+    type FallbackCallback = (
+      event: V2.Core.EventNotificationBase,
+      client: Stripe,
+      details: UnhandledNotificationDetails
+    ) => Promise<void>;
+
+    class EventNotificationHandler {
+      constructor(
+        client: Stripe,
+        webhookSecret: string,
+        fallbackCallback: FallbackCallback
+      );
+
+      on<T extends Stripe.V2.Core.EventNotification['type']>(
+        eventType: T,
+        callback: (
+          eventNotification: Extract<
+            Stripe.V2.Core.EventNotification,
+            {type: T}
+          >,
+          client: Stripe
+        ) => void
+        // a very cool thing would be if the whole class was generic and `on` returned all of the event types, but omitting the one we just used.
+        // So `.on('a').on('a') would be a type error.
+        // but, the event types aren't accessible from the runtime code, so we can't (yet)
+      ): this;
+
+      handle(
+        rawBody: string | Uint8Array,
+        signature: string | Uint8Array
+      ): Promise<void>;
+    }
+
     namespace Events {
       /**
        * Represents the shape of an EventNotification that the SDK didn't know about when it was generated.

package/types/V2/MoneyManagement/FinancialAccounts.d.ts

@@ -43,12 +43,6 @@ declare module 'stripe' {
            */
           livemode: boolean;
 
-          /**
-           * If this is a managed FinancialAccount, `managed_by` indicates the product that created and manages this FinancialAccount. For managed FinancialAccounts,
-           * creation of money management resources can only be orchestrated by the managing product.
-           */
-          managed_by?: FinancialAccount.ManagedBy;
-
           /**
            * Metadata associated with the FinancialAccount.
            */
@@ -59,11 +53,6 @@ declare module 'stripe' {
            */
           other?: FinancialAccount.Other;
 
-          /**
-           * If this is a `payments` FinancialAccount, this hash include details specific to `payments` FinancialAccount.
-           */
-          payments?: FinancialAccount.Payments;
-
           /**
            * Closed Enum. An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.
            */
@@ -145,13 +134,6 @@ declare module 'stripe' {
             }
           }
 
-          interface ManagedBy {
-            /**
-             * Enum describing the Stripe product that is managing this FinancialAccount.
-             */
-            type: 'multiprocessor_settlement';
-          }
-
           interface Other {
             /**
              * The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in `financial_account.type`.
@@ -159,18 +141,6 @@ declare module 'stripe' {
             type: string;
           }
 
-          interface Payments {
-            /**
-             * The currency that non-settlement currency payments will be converted to.
-             */
-            default_currency: string;
-
-            /**
-             * Settlement currencies enabled for this FinancialAccount. Payments in other currencies will be automatically converted to `default_currency`.
-             */
-            settlement_currencies: Array<string>;
-          }
-
           type Status = 'closed' | 'open' | 'pending';
 
           interface StatusDetails {
@@ -208,7 +178,7 @@ declare module 'stripe' {
             holds_currencies: Array<string>;
           }
 
-          type Type = 'other' | 'payments' | 'storage';
+          type Type = 'other' | 'storage';
         }
       }
     }

package/types/V2/MoneyManagement/FinancialAccountsResource.d.ts

@@ -65,17 +65,10 @@ declare module 'stripe' {
            * The status of the FinancialAccount to filter by. By default, closed FinancialAccounts are not returned.
            */
           status?: FinancialAccountListParams.Status;
-
-          /**
-           * Filter for FinancialAccount `type`. By default, FinancialAccounts of any `type` are returned.
-           */
-          types?: Array<FinancialAccountListParams.Type>;
         }
 
         namespace FinancialAccountListParams {
           type Status = 'closed' | 'open' | 'pending';
-
-          type Type = 'payments' | 'storage';
         }
       }
 

package/types/V2/MoneyManagement/FinancialAddresses.d.ts

@@ -136,10 +136,7 @@ declare module 'stripe' {
               last4: string;
             }
 
-            type Type =
-              | 'gb_bank_account'
-              | 'sepa_bank_account'
-              | 'us_bank_account';
+            type Type = 'gb_bank_account' | 'us_bank_account';
 
             interface UsBankAccount {
               /**

package/types/V2/MoneyManagement/FinancialAddressesResource.d.ts

@@ -14,25 +14,10 @@ declare module 'stripe' {
            * The type of FinancialAddress details to provision.
            */
           type: FinancialAddressCreateParams.Type;
-
-          /**
-           * Optional SEPA Bank account options, used to configure the type of SEPA Bank account to create, such as the originating country.
-           */
-          sepa_bank_account?: FinancialAddressCreateParams.SepaBankAccount;
         }
 
         namespace FinancialAddressCreateParams {
-          interface SepaBankAccount {
-            /**
-             * The originating country of the SEPA Bank account.
-             */
-            country: string;
-          }
-
-          type Type =
-            | 'gb_bank_account'
-            | 'sepa_bank_account'
-            | 'us_bank_account';
+          type Type = 'gb_bank_account' | 'us_bank_account';
         }
       }
 
@@ -47,7 +32,6 @@ declare module 'stripe' {
         namespace FinancialAddressRetrieveParams {
           type Include =
             | 'credentials.gb_bank_account.account_number'
-            | 'credentials.sepa_bank_account.iban'
             | 'credentials.us_bank_account.account_number';
         }
       }
@@ -73,7 +57,6 @@ declare module 'stripe' {
         namespace FinancialAddressListParams {
           type Include =
             | 'credentials.gb_bank_account.account_number'
-            | 'credentials.sepa_bank_account.iban'
             | 'credentials.us_bank_account.account_number';
         }
       }

package/types/V2/MoneyManagement/OutboundPaymentQuotes.d.ts

@@ -78,17 +78,10 @@ declare module 'stripe' {
              * Open Enum. Method for bank account.
              */
             bank_account?: DeliveryOptions.BankAccount;
-
-            /**
-             * Open Enum. Speed of the payout.
-             */
-            speed?: DeliveryOptions.Speed;
           }
 
           namespace DeliveryOptions {
             type BankAccount = 'automatic' | 'local' | 'wire';
-
-            type Speed = 'instant' | 'next_business_day' | 'standard';
           }
 
           interface EstimatedFee {
@@ -120,7 +113,6 @@ declare module 'stripe' {
               | 'cross_border_payout_fee'
               | 'foreign_exchange_fee'
               | 'instant_payout_fee'
-              | 'real_time_payout_fee'
               | 'standard_payout_fee'
               | 'wire_payout_fee';
           }

package/types/V2/MoneyManagement/OutboundPaymentQuotesResource.d.ts

@@ -44,17 +44,10 @@ declare module 'stripe' {
              * Open Enum. Method for bank account.
              */
             bank_account?: DeliveryOptions.BankAccount;
-
-            /**
-             * Open Enum. Speed of the payout.
-             */
-            speed?: DeliveryOptions.Speed;
           }
 
           namespace DeliveryOptions {
             type BankAccount = 'automatic' | 'local' | 'wire';
-
-            type Speed = 'instant' | 'next_business_day' | 'standard';
           }
 
           interface From {

package/types/V2/MoneyManagement/OutboundPayments.d.ts

@@ -80,11 +80,6 @@ declare module 'stripe' {
            */
           recipient_notification: OutboundPayment.RecipientNotification;
 
-          /**
-           * The recipient verification id for this OutboundPayment. Only required for countries with regulatory mandates to verify recipient names before OutboundPayment creation.
-           */
-          recipient_verification?: string;
-
           /**
            * The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer). It will default to `STRIPE` if not set on the account settings.
            */
@@ -137,17 +132,10 @@ declare module 'stripe' {
              * Open Enum. Method for bank account.
              */
             bank_account?: DeliveryOptions.BankAccount;
-
-            /**
-             * Open Enum. Speed of the payout.
-             */
-            speed?: DeliveryOptions.Speed;
           }
 
           namespace DeliveryOptions {
             type BankAccount = 'automatic' | 'local' | 'wire';
-
-            type Speed = 'instant' | 'next_business_day' | 'standard';
           }
 
           interface From {

package/types/V2/MoneyManagement/OutboundPaymentsResource.d.ts

@@ -44,11 +44,6 @@ declare module 'stripe' {
            * Details about the notification settings for the OutboundPayment recipient.
            */
           recipient_notification?: OutboundPaymentCreateParams.RecipientNotification;
-
-          /**
-           * The recipient verification id for this OutboundPayment. Only required for countries with regulatory mandates to verify recipient names before OutboundPayment creation.
-           */
-          recipient_verification?: string;
         }
 
         namespace OutboundPaymentCreateParams {
@@ -69,17 +64,10 @@ declare module 'stripe' {
              * Open Enum. Method for bank account.
              */
             bank_account?: DeliveryOptions.BankAccount;
-
-            /**
-             * Open Enum. Speed of the payout.
-             */
-            speed?: DeliveryOptions.Speed;
           }
 
           namespace DeliveryOptions {
             type BankAccount = 'automatic' | 'local' | 'wire';
-
-            type Speed = 'instant' | 'next_business_day' | 'standard';
           }
 
           interface From {

package/types/V2/MoneyManagement/OutboundSetupIntentsResource.d.ts

@@ -40,11 +40,6 @@ declare module 'stripe' {
              * The type specific details of the card payout method.
              */
             card?: PayoutMethodData.Card;
-
-            /**
-             * The type specific details of the crypto wallet payout method.
-             */
-            crypto_wallet?: PayoutMethodData.CryptoWallet;
           }
 
           namespace PayoutMethodData {
@@ -101,35 +96,6 @@ declare module 'stripe' {
               number: string;
             }
 
-            interface CryptoWallet {
-              /**
-               * Crypto wallet address.
-               */
-              address: string;
-
-              /**
-               * Optional field, required if network supports memos (only "stellar" currently).
-               */
-              memo?: string;
-
-              /**
-               * Which rail we should use to make an Outbound money movement to this wallet.
-               */
-              network: CryptoWallet.Network;
-            }
-
-            namespace CryptoWallet {
-              type Network =
-                | 'arbitrum'
-                | 'avalanche_c_chain'
-                | 'base'
-                | 'ethereum'
-                | 'optimism'
-                | 'polygon'
-                | 'solana'
-                | 'stellar';
-            }
-
             type Type = 'bank_account' | 'card' | 'crypto_wallet';
           }
 

package/types/V2/MoneyManagement/OutboundTransfers.d.ts

@@ -70,11 +70,6 @@ declare module 'stripe' {
            */
           receipt_url?: string;
 
-          /**
-           * The recipient verification id for this OutboundTransfer. Only required for countries with regulatory mandates to verify recipient names before OutboundTransfer creation.
-           */
-          recipient_verification?: string;
-
           /**
            * The description that appears on the receiving end for an OutboundTransfer (for example, bank statement for external bank transfer). It will default to `STRIPE` if not set on the account settings.
            */

package/types/V2/MoneyManagement/OutboundTransfersResource.d.ts

@@ -34,11 +34,6 @@ declare module 'stripe' {
            * Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
            */
           metadata?: Stripe.MetadataParam;
-
-          /**
-           * The recipient verification id for this OutboundTransfer. Only required for countries with regulatory mandates to verify recipient names before OutboundTransfer creation.
-           */
-          recipient_verification?: string;
         }
 
         namespace OutboundTransferCreateParams {

package/types/V2/MoneyManagement/PayoutMethods.d.ts

@@ -18,11 +18,6 @@ declare module 'stripe' {
            */
           object: 'v2.money_management.payout_method';
 
-          /**
-           * The alternative reference for this payout method, if it's a projected payout method.
-           */
-          alternative_reference?: PayoutMethod.AlternativeReference;
-
           /**
            * A set of available payout speeds for this payout method.
            */
@@ -43,11 +38,6 @@ declare module 'stripe' {
            */
           created: string;
 
-          /**
-           * The PayoutMethodCryptoWallet object details.
-           */
-          crypto_wallet?: PayoutMethod.CryptoWallet;
-
           /**
            * ID of the underlying active OutboundSetupIntent object, if any.
            */
@@ -70,22 +60,6 @@ declare module 'stripe' {
         }
 
         namespace PayoutMethod {
-          interface AlternativeReference {
-            /**
-             * The ID of the alternative resource being referenced.
-             */
-            id: string;
-
-            /**
-             * The type of the alternative reference (e.g., external_account for V1 external accounts).
-             */
-            type: AlternativeReference.Type;
-          }
-
-          namespace AlternativeReference {
-            type Type = 'external_account' | 'payment_method';
-          }
-
           type AvailablePayoutSpeed = 'instant' | 'standard';
 
           interface BankAccount {
@@ -165,42 +139,6 @@ declare module 'stripe' {
             last4: string;
           }
 
-          interface CryptoWallet {
-            /**
-             * Destination wallet address.
-             */
-            address: string;
-
-            /**
-             * Whether the crypto wallet was archived. Crypto wallets can be archived through the /archive API,
-             * and they will not be automatically archived by Stripe. Archived crypto wallets cannot be used as
-             * payout method and will not appear in the payout method list.
-             */
-            archived: boolean;
-
-            /**
-             * Optional field, required if network supports memos (only "stellar" currently).
-             */
-            memo?: string;
-
-            /**
-             * Which rail is being used to make an outbound money movement to this wallet.
-             */
-            network: CryptoWallet.Network;
-          }
-
-          namespace CryptoWallet {
-            type Network =
-              | 'arbitrum'
-              | 'avalanche_c_chain'
-              | 'base'
-              | 'ethereum'
-              | 'optimism'
-              | 'polygon'
-              | 'solana'
-              | 'stellar';
-          }
-
           type Type = 'bank_account' | 'card' | 'crypto_wallet';
 
           interface UsageStatus {