stripe 16.8.0 → 16.9.0-beta.1

package/esm/resources/OAuth.js

@@ -1,6 +1,6 @@
 'use strict';
 import { StripeResource } from '../StripeResource.js';
-import { stringifyRequestData } from '../utils.js';
+import { queryStringifyRequestData } from '../utils.js';
 const stripeMethod = StripeResource.method;
 const oAuthHost = 'connect.stripe.com';
 export const OAuth = StripeResource.extend({
@@ -22,7 +22,7 @@ export const OAuth = StripeResource.extend({
         if (!params.scope) {
             params.scope = 'read_write';
         }
-        return `https://${oAuthHost}/${path}?${stringifyRequestData(params)}`;
+        return `https://${oAuthHost}/${path}?${queryStringifyRequestData(params)}`;
     },
     token: stripeMethod({
         method: 'POST',

package/esm/resources/Orders.js

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Orders = StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/orders' }),
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v1/orders/{id}' }),
+    update: stripeMethod({ method: 'POST', fullPath: '/v1/orders/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/orders',
+        methodType: 'list',
+    }),
+    cancel: stripeMethod({ method: 'POST', fullPath: '/v1/orders/{id}/cancel' }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/orders/{id}/line_items',
+        methodType: 'list',
+    }),
+    reopen: stripeMethod({ method: 'POST', fullPath: '/v1/orders/{id}/reopen' }),
+    submit: stripeMethod({ method: 'POST', fullPath: '/v1/orders/{id}/submit' }),
+});

package/esm/resources/PaymentIntents.js

@@ -32,6 +32,10 @@ export const PaymentIntents = StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/payment_intents/{intent}/confirm',
     }),
+    decrementAuthorization: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/payment_intents/{intent}/decrement_authorization',
+    }),
     incrementAuthorization: stripeMethod({
         method: 'POST',
         fullPath: '/v1/payment_intents/{intent}/increment_authorization',

package/esm/resources/QuotePhases.js

@@ -0,0 +1,19 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const QuotePhases = StripeResource.extend({
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quote_phases/{quote_phase}',
+    }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quote_phases',
+        methodType: 'list',
+    }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quote_phases/{quote_phase}/line_items',
+        methodType: 'list',
+    }),
+});

package/esm/resources/Quotes.js

@@ -16,6 +16,11 @@ export const Quotes = StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/quotes/{quote}/finalize',
     }),
+    listPreviewInvoiceLines: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quotes/{quote}/preview_invoices/{preview_invoice}/lines',
+        methodType: 'list',
+    }),
     listComputedUpfrontLineItems: stripeMethod({
         method: 'GET',
         fullPath: '/v1/quotes/{quote}/computed_upfront_line_items',
@@ -26,10 +31,37 @@ export const Quotes = StripeResource.extend({
         fullPath: '/v1/quotes/{quote}/line_items',
         methodType: 'list',
     }),
+    listLines: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quotes/{quote}/lines',
+        methodType: 'list',
+    }),
+    listPreviewInvoices: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quotes/{quote}/preview_invoices',
+        methodType: 'list',
+    }),
+    listPreviewSubscriptionSchedules: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/quotes/{quote}/preview_subscription_schedules',
+        methodType: 'list',
+    }),
+    markDraft: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/quotes/{quote}/mark_draft',
+    }),
+    markStale: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/quotes/{quote}/mark_stale',
+    }),
     pdf: stripeMethod({
         method: 'GET',
         fullPath: '/v1/quotes/{quote}/pdf',
         host: 'files.stripe.com',
         streaming: true,
     }),
+    reestimate: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/quotes/{quote}/reestimate',
+    }),
 });

package/esm/resources/SubscriptionSchedules.js

@@ -19,6 +19,10 @@ export const SubscriptionSchedules = StripeResource.extend({
         fullPath: '/v1/subscription_schedules',
         methodType: 'list',
     }),
+    amend: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/subscription_schedules/{schedule}/amend',
+    }),
     cancel: stripeMethod({
         method: 'POST',
         fullPath: '/v1/subscription_schedules/{schedule}/cancel',

package/esm/resources/Tax/Associations.js

@@ -0,0 +1,6 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Associations = StripeResource.extend({
+    find: stripeMethod({ method: 'GET', fullPath: '/v1/tax/associations/find' }),
+});

package/esm/resources/Tax/Forms.js

@@ -0,0 +1,17 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Forms = StripeResource.extend({
+    retrieve: stripeMethod({ method: 'GET', fullPath: '/v1/tax/forms/{id}' }),
+    list: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/forms',
+        methodType: 'list',
+    }),
+    pdf: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/forms/{id}/pdf',
+        host: 'files.stripe.com',
+        streaming: true,
+    }),
+});

package/esm/resources/Terminal/Readers.js

@@ -24,6 +24,18 @@ export const Readers = StripeResource.extend({
         method: 'POST',
         fullPath: '/v1/terminal/readers/{reader}/cancel_action',
     }),
+    collectInputs: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/terminal/readers/{reader}/collect_inputs',
+    }),
+    collectPaymentMethod: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/terminal/readers/{reader}/collect_payment_method',
+    }),
+    confirmPaymentIntent: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/terminal/readers/{reader}/confirm_payment_intent',
+    }),
     processPaymentIntent: stripeMethod({
         method: 'POST',
         fullPath: '/v1/terminal/readers/{reader}/process_payment_intent',

package/esm/resources.js

@@ -3,25 +3,33 @@ import { resourceNamespace } from './ResourceNamespace.js';
 import { Accounts as FinancialConnectionsAccounts } from './resources/FinancialConnections/Accounts.js';
 import { ActiveEntitlements as EntitlementsActiveEntitlements } from './resources/Entitlements/ActiveEntitlements.js';
 import { Alerts as BillingAlerts } from './resources/Billing/Alerts.js';
+import { Associations as TaxAssociations } from './resources/Tax/Associations.js';
 import { Authorizations as TestHelpersIssuingAuthorizations } from './resources/TestHelpers/Issuing/Authorizations.js';
 import { Authorizations as IssuingAuthorizations } from './resources/Issuing/Authorizations.js';
 import { Calculations as TaxCalculations } from './resources/Tax/Calculations.js';
 import { Cardholders as IssuingCardholders } from './resources/Issuing/Cardholders.js';
 import { Cards as TestHelpersIssuingCards } from './resources/TestHelpers/Issuing/Cards.js';
+import { Cards as GiftCardsCards } from './resources/GiftCards/Cards.js';
 import { Cards as IssuingCards } from './resources/Issuing/Cards.js';
 import { Configurations as BillingPortalConfigurations } from './resources/BillingPortal/Configurations.js';
 import { Configurations as TerminalConfigurations } from './resources/Terminal/Configurations.js';
 import { ConfirmationTokens as TestHelpersConfirmationTokens } from './resources/TestHelpers/ConfirmationTokens.js';
 import { ConnectionTokens as TerminalConnectionTokens } from './resources/Terminal/ConnectionTokens.js';
 import { CreditReversals as TreasuryCreditReversals } from './resources/Treasury/CreditReversals.js';
+import { CreditUnderwritingRecords as IssuingCreditUnderwritingRecords } from './resources/Issuing/CreditUnderwritingRecords.js';
 import { Customers as TestHelpersCustomers } from './resources/TestHelpers/Customers.js';
 import { DebitReversals as TreasuryDebitReversals } from './resources/Treasury/DebitReversals.js';
 import { Disputes as IssuingDisputes } from './resources/Issuing/Disputes.js';
 import { EarlyFraudWarnings as RadarEarlyFraudWarnings } from './resources/Radar/EarlyFraudWarnings.js';
 import { Features as EntitlementsFeatures } from './resources/Entitlements/Features.js';
 import { FinancialAccounts as TreasuryFinancialAccounts } from './resources/Treasury/FinancialAccounts.js';
+import { FinancingOffers as CapitalFinancingOffers } from './resources/Capital/FinancingOffers.js';
+import { FinancingSummary as CapitalFinancingSummary } from './resources/Capital/FinancingSummary.js';
+import { FinancingTransactions as CapitalFinancingTransactions } from './resources/Capital/FinancingTransactions.js';
+import { Forms as TaxForms } from './resources/Tax/Forms.js';
 import { InboundTransfers as TestHelpersTreasuryInboundTransfers } from './resources/TestHelpers/Treasury/InboundTransfers.js';
 import { InboundTransfers as TreasuryInboundTransfers } from './resources/Treasury/InboundTransfers.js';
+import { Institutions as FinancialConnectionsInstitutions } from './resources/FinancialConnections/Institutions.js';
 import { Locations as TerminalLocations } from './resources/Terminal/Locations.js';
 import { MeterEventAdjustments as BillingMeterEventAdjustments } from './resources/Billing/MeterEventAdjustments.js';
 import { MeterEvents as BillingMeterEvents } from './resources/Billing/MeterEvents.js';
@@ -58,6 +66,7 @@ import { Tokens as IssuingTokens } from './resources/Issuing/Tokens.js';
 import { TransactionEntries as TreasuryTransactionEntries } from './resources/Treasury/TransactionEntries.js';
 import { Transactions as TestHelpersIssuingTransactions } from './resources/TestHelpers/Issuing/Transactions.js';
 import { Transactions as FinancialConnectionsTransactions } from './resources/FinancialConnections/Transactions.js';
+import { Transactions as GiftCardsTransactions } from './resources/GiftCards/Transactions.js';
 import { Transactions as IssuingTransactions } from './resources/Issuing/Transactions.js';
 import { Transactions as TaxTransactions } from './resources/Tax/Transactions.js';
 import { Transactions as TreasuryTransactions } from './resources/Treasury/Transactions.js';
@@ -67,6 +76,7 @@ import { VerificationReports as IdentityVerificationReports } from './resources/
 import { VerificationSessions as IdentityVerificationSessions } from './resources/Identity/VerificationSessions.js';
 export { Accounts as Account } from './resources/Accounts.js';
 export { AccountLinks } from './resources/AccountLinks.js';
+export { AccountNotices } from './resources/AccountNotices.js';
 export { AccountSessions } from './resources/AccountSessions.js';
 export { Accounts } from './resources/Accounts.js';
 export { ApplePayDomains } from './resources/ApplePayDomains.js';
@@ -89,7 +99,9 @@ export { Files } from './resources/Files.js';
 export { InvoiceItems } from './resources/InvoiceItems.js';
 export { Invoices } from './resources/Invoices.js';
 export { Mandates } from './resources/Mandates.js';
+export { Margins } from './resources/Margins.js';
 export { OAuth } from './resources/OAuth.js';
+export { Orders } from './resources/Orders.js';
 export { PaymentIntents } from './resources/PaymentIntents.js';
 export { PaymentLinks } from './resources/PaymentLinks.js';
 export { PaymentMethodConfigurations } from './resources/PaymentMethodConfigurations.js';
@@ -100,6 +112,7 @@ export { Plans } from './resources/Plans.js';
 export { Prices } from './resources/Prices.js';
 export { Products } from './resources/Products.js';
 export { PromotionCodes } from './resources/PromotionCodes.js';
+export { QuotePhases } from './resources/QuotePhases.js';
 export { Quotes } from './resources/Quotes.js';
 export { Refunds } from './resources/Refunds.js';
 export { Reviews } from './resources/Reviews.js';
@@ -128,6 +141,11 @@ export const BillingPortal = resourceNamespace('billingPortal', {
     Configurations: BillingPortalConfigurations,
     Sessions: BillingPortalSessions,
 });
+export const Capital = resourceNamespace('capital', {
+    FinancingOffers: CapitalFinancingOffers,
+    FinancingSummary: CapitalFinancingSummary,
+    FinancingTransactions: CapitalFinancingTransactions,
+});
 export const Checkout = resourceNamespace('checkout', {
     Sessions: CheckoutSessions,
 });
@@ -142,12 +160,17 @@ export const Entitlements = resourceNamespace('entitlements', {
 });
 export const FinancialConnections = resourceNamespace('financialConnections', {
     Accounts: FinancialConnectionsAccounts,
+    Institutions: FinancialConnectionsInstitutions,
     Sessions: FinancialConnectionsSessions,
     Transactions: FinancialConnectionsTransactions,
 });
 export const Forwarding = resourceNamespace('forwarding', {
     Requests: ForwardingRequests,
 });
+export const GiftCards = resourceNamespace('giftCards', {
+    Cards: GiftCardsCards,
+    Transactions: GiftCardsTransactions,
+});
 export const Identity = resourceNamespace('identity', {
     VerificationReports: IdentityVerificationReports,
     VerificationSessions: IdentityVerificationSessions,
@@ -156,6 +179,7 @@ export const Issuing = resourceNamespace('issuing', {
     Authorizations: IssuingAuthorizations,
     Cardholders: IssuingCardholders,
     Cards: IssuingCards,
+    CreditUnderwritingRecords: IssuingCreditUnderwritingRecords,
     Disputes: IssuingDisputes,
     PersonalizationDesigns: IssuingPersonalizationDesigns,
     PhysicalBundles: IssuingPhysicalBundles,
@@ -175,7 +199,9 @@ export const Sigma = resourceNamespace('sigma', {
     ScheduledQueryRuns: SigmaScheduledQueryRuns,
 });
 export const Tax = resourceNamespace('tax', {
+    Associations: TaxAssociations,
     Calculations: TaxCalculations,
+    Forms: TaxForms,
     Registrations: TaxRegistrations,
     Settings: TaxSettings,
     Transactions: TaxTransactions,

package/esm/stripe.core.js

@@ -2,7 +2,7 @@ import * as _Error from './Error.js';
 import { RequestSender } from './RequestSender.js';
 import { StripeResource } from './StripeResource.js';
 import { createWebhooks } from './Webhooks.js';
-import * as apiVersion from './apiVersion.js';
+import { ApiVersion } from './apiVersion.js';
 import { CryptoProvider } from './crypto/CryptoProvider.js';
 import { HttpClient, HttpClientResponse } from './net/HttpClient.js';
 import * as resources from './resources.js';
@@ -10,7 +10,7 @@ import { determineProcessUserAgentProperties, pascalToCamelCase, validateInteger
 const DEFAULT_HOST = 'api.stripe.com';
 const DEFAULT_PORT = '443';
 const DEFAULT_BASE_PATH = '/v1/';
-const DEFAULT_API_VERSION = apiVersion.ApiVersion;
+const DEFAULT_API_VERSION = ApiVersion;
 const DEFAULT_TIMEOUT = 80000;
 const MAX_NETWORK_RETRY_DELAY_SEC = 2;
 const INITIAL_NETWORK_RETRY_DELAY_SEC = 0.5;
@@ -31,7 +31,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 = '16.8.0';
+    Stripe.PACKAGE_VERSION = '16.9.0-beta.1';
     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;
@@ -147,6 +147,9 @@ export function createStripe(platformFunctions, requestSender = defaultRequestSe
         _enableTelemetry: null,
         _requestSender: null,
         _platformFunctions: null,
+        rawRequest(method, path, params, options) {
+            return this._requestSender._rawRequest(method, path, params, options);
+        },
         /**
          * @private
          */

package/esm/utils.js

@@ -7,6 +7,8 @@ const OPTIONS_KEYS = [
     'maxNetworkRetries',
     'timeout',
     'host',
+    'apiMode',
+    'additionalHeaders',
 ];
 export function isOptionsHash(o) {
     return (o &&
@@ -17,7 +19,7 @@ export function isOptionsHash(o) {
  * Stringifies an Object, accommodating nested objects
  * (forming the conventional key 'parent[child]=value')
  */
-export function stringifyRequestData(data) {
+export function queryStringifyRequestData(data) {
     return (qs
         .stringify(data, {
         serializeDate: (d) => Math.floor(d.getTime() / 1000).toString(),
@@ -124,6 +126,15 @@ export function getOptionsFromArgs(args) {
             if (params.host) {
                 opts.host = params.host;
             }
+            if (params.apiMode) {
+                if (params.apiMode !== 'standard' && params.apiMode !== 'preview') {
+                    throw new Error(`Invalid apiMode: ${params.apiMode}. Must be one of 'standard' or 'preview'`);
+                }
+                opts.apiMode = params.apiMode;
+            }
+            if (params.additionalHeaders) {
+                opts.headers = params.additionalHeaders;
+            }
         }
     }
     return opts;
@@ -285,3 +296,18 @@ export function concat(arrays) {
     });
     return merged;
 }
+/**
+ * Replaces Date objects with Unix timestamps
+ */
+function dateTimeReplacer(key, value) {
+    if (this[key] instanceof Date) {
+        return Math.floor(this[key].getTime() / 1000).toString();
+    }
+    return value;
+}
+/**
+ * JSON stringifies an Object, replacing Date objects with Unix timestamps
+ */
+export function jsonStringifyRequestData(data) {
+    return JSON.stringify(data, dateTimeReplacer);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripe",
-  "version": "16.8.0",
+  "version": "16.9.0-beta.1",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountLinksResource.d.ts

@@ -60,7 +60,11 @@ declare module 'stripe' {
         type FutureRequirements = 'include' | 'omit';
       }
 
-      type Type = 'account_onboarding' | 'account_update';
+      type Type =
+        | 'account_onboarding'
+        | 'account_update'
+        | 'capital_financing_offer'
+        | 'capital_financing_reporting';
     }
 
     class AccountLinksResource {

package/types/AccountNotices.d.ts

@@ -0,0 +1,113 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    /**
+     * A notice to a Connected account. Notice can be sent by Stripe on your behalf or you can opt to send the notices yourself.
+     *
+     * See the [guide to send notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) to your connected accounts.
+     */
+    interface AccountNotice {
+      /**
+       * Unique identifier for the object.
+       */
+      id: string;
+
+      /**
+       * String representing the object's type. Objects of the same type share the same value.
+       */
+      object: 'account_notice';
+
+      /**
+       * Time at which the object was created. Measured in seconds since the Unix epoch.
+       */
+      created: number;
+
+      /**
+       * When present, the deadline for sending the notice to meet the relevant regulations.
+       */
+      deadline: number | null;
+
+      /**
+       * Information about the email when sent.
+       */
+      email: AccountNotice.Email | null;
+
+      /**
+       * Information about objects related to the notice.
+       */
+      linked_objects: AccountNotice.LinkedObjects | null;
+
+      /**
+       * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+       */
+      livemode: boolean;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+       */
+      metadata: Stripe.Metadata | null;
+
+      /**
+       * Reason the notice is being sent. The reason determines what copy the notice must contain. See the [regulated customer notices](https://stripe.com/docs/issuing/compliance-us/issuing-regulated-customer-notices) guide. All reasons might not apply to your integration, and Stripe might add new reasons in the future, so we recommend an internal warning when you receive an unknown reason.
+       */
+      reason: AccountNotice.Reason;
+
+      /**
+       * Date when the notice was sent. When absent, you must send the notice, update the content of the email and date when it was sent.
+       */
+      sent_at: number | null;
+    }
+
+    namespace AccountNotice {
+      interface Email {
+        /**
+         * Content of the email in plain text. The copy must match exactly the language that Stripe Compliance has approved for use.
+         */
+        plain_text: string;
+
+        /**
+         * Email address of the recipient.
+         */
+        recipient: string;
+
+        /**
+         * Subject of the email.
+         */
+        subject: string;
+      }
+
+      interface LinkedObjects {
+        /**
+         * Associated [Capability](https://stripe.com/docs/api/capabilities)
+         */
+        capability: string | null;
+
+        /**
+         * Associated [Credit Underwriting Record](https://stripe.com/docs/api/issuing/credit_underwriting_record)
+         */
+        issuing_credit_underwriting_record?: string | null;
+
+        /**
+         * Associated [Issuing Dispute](https://stripe.com/docs/api/issuing/disputes)
+         */
+        issuing_dispute: string | null;
+      }
+
+      type Reason =
+        | 'issuing.account_closed_for_inactivity'
+        | 'issuing.account_closed_for_not_providing_business_model_clarification'
+        | 'issuing.account_closed_for_not_providing_url_clarification'
+        | 'issuing.account_closed_for_not_providing_use_case_clarification'
+        | 'issuing.account_closed_for_terms_of_service_violation'
+        | 'issuing.application_rejected_for_failure_to_verify'
+        | 'issuing.credit_application_rejected'
+        | 'issuing.credit_increase_application_rejected'
+        | 'issuing.credit_limit_decreased'
+        | 'issuing.credit_line_closed'
+        | 'issuing.dispute_lost'
+        | 'issuing.dispute_submitted'
+        | 'issuing.dispute_won';
+    }
+  }
+}

package/types/AccountNoticesResource.d.ts

@@ -0,0 +1,98 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    interface AccountNoticeRetrieveParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    interface AccountNoticeUpdateParams {
+      /**
+       * Information about the email you sent.
+       */
+      email: AccountNoticeUpdateParams.Email;
+
+      /**
+       * Date when you sent the notice.
+       */
+      sent_at: number;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       */
+      metadata?: Stripe.MetadataParam;
+    }
+
+    namespace AccountNoticeUpdateParams {
+      interface Email {
+        /**
+         * Content of the email in plain text. The copy must match exactly the language that Stripe Compliance has approved for use.
+         */
+        plain_text: string;
+
+        /**
+         * Email address of the recipient.
+         */
+        recipient: string;
+
+        /**
+         * Subject of the email.
+         */
+        subject: string;
+      }
+    }
+
+    interface AccountNoticeListParams extends PaginationParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * Set to false to only return unsent AccountNotices.
+       */
+      sent?: boolean;
+    }
+
+    class AccountNoticesResource {
+      /**
+       * Retrieves an AccountNotice object.
+       */
+      retrieve(
+        id: string,
+        params?: AccountNoticeRetrieveParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.AccountNotice>>;
+      retrieve(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.AccountNotice>>;
+
+      /**
+       * Updates an AccountNotice object.
+       */
+      update(
+        id: string,
+        params: AccountNoticeUpdateParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.AccountNotice>>;
+
+      /**
+       * Retrieves a list of AccountNotice objects. The objects are sorted in descending order by creation date, with the most-recently-created object appearing first.
+       */
+      list(
+        params?: AccountNoticeListParams,
+        options?: RequestOptions
+      ): ApiListPromise<Stripe.AccountNotice>;
+      list(options?: RequestOptions): ApiListPromise<Stripe.AccountNotice>;
+    }
+  }
+}