stripe 13.3.0 → 13.4.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 13.4.0 - 2023-08-31
+* [#1884](https://github.com/stripe/stripe-node/pull/1884) Update generated code
+  * Add support for new resource `AccountSession`
+  * Add support for `create` method on resource `AccountSession`
+  * Add support for new values `obligation_inbound`, `obligation_outbound`, `obligation_payout_failure`, `obligation_payout`, `obligation_reversal_inbound`, and `obligation_reversal_outbound` on enum `BalanceTransaction.type`
+  * Change type of `Event.type` from `string` to `enum`
+  * Add support for `application` on `PaymentLink`
+  * Add support for new value `obligation` on enum `Reporting.ReportRunCreateParams.parameters.reporting_category`
+
 ## 13.3.0 - 2023-08-24
 * [#1879](https://github.com/stripe/stripe-node/pull/1879) Update generated code
   * Add support for `retention` on `BillingPortal.Session.flow.subscription_cancel` and `BillingPortal.SessionCreateParams.flow_data.subscription_cancel`

package/README.md

@@ -118,6 +118,12 @@ const paymentIntent: Stripe.PaymentIntent = await stripe.paymentIntents.retrieve
 const customerEmail: string = (paymentIntent.customer as Stripe.Customer).email;
 ```
 
+#### Typescript and the stripe-node versioning policy
+
+The Typescript types in stripe-node always reflect the latest shape of the Stripe API. When the Stripe API changes in a [backwards-incompatible way](https://stripe.com/docs/upgrades#what-changes-does-stripe-consider-to-be-backwards-compatible), there is a new Stripe API version, and we release a new major version of stripe-node. Sometimes, though, the Stripe API changes in a way that weakens the guarantees provided by the Typescript types, but that cannot result in any backwards incompatibility at runtime. For example, we might add a new enum value on a response, along with a new parameter to a request. Adding a new value to a response enum weakens the Typescript type. However, if the new enum value is only returned when the new parameter is provided, this cannot break any existing usages and so would not be considered a breaking API change. In stripe-node, we do NOT consider such changes to be breaking under our current versioning policy. This means that you might see new type errors from Typescript as you upgrade minor versions of stripe-node, that you can resolve by adding additional type guards.
+
+Please feel welcome to share your thoughts about the versioning policy in a Github issue. For now, we judge it to be better than the two alternatives: outdated, inaccurate types, or vastly more frequent major releases, which would distract from any future breaking changes with potentially more disruptive runtime implications.
+
 ### Using Promises
 
 Every method returns a chainable promise which can be used instead of a regular

package/VERSION

@@ -1 +1 @@
-13.3.0
+13.4.0

package/cjs/resources/AccountSessions.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountSessions = void 0;
+const StripeResource_js_1 = require("../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.AccountSessions = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/account_sessions' }),
+});

package/cjs/resources.js

@@ -1,8 +1,8 @@
 "use strict";
 // File generated from our OpenAPI spec
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FinancialConnections = exports.Checkout = exports.BillingPortal = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = exports.Tokens = exports.TaxRates = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = exports.SetupAttempts = exports.Reviews = exports.Refunds = exports.Quotes = exports.PromotionCodes = exports.Products = exports.Prices = exports.Plans = exports.Payouts = exports.PaymentMethods = exports.PaymentLinks = exports.PaymentIntents = exports.OAuth = exports.Mandates = exports.Invoices = exports.InvoiceItems = exports.Files = exports.FileLinks = exports.ExchangeRates = exports.Events = exports.EphemeralKeys = exports.Disputes = exports.Customers = exports.CreditNotes = exports.Coupons = exports.CountrySpecs = exports.Charges = exports.BalanceTransactions = exports.Balance = exports.ApplicationFees = exports.ApplePayDomains = exports.Accounts = exports.AccountLinks = exports.Account = void 0;
-exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = void 0;
+exports.Checkout = exports.BillingPortal = exports.Apps = exports.WebhookEndpoints = exports.Transfers = exports.Topups = exports.Tokens = exports.TaxRates = exports.TaxCodes = exports.Subscriptions = exports.SubscriptionSchedules = exports.SubscriptionItems = exports.Sources = exports.ShippingRates = exports.SetupIntents = exports.SetupAttempts = exports.Reviews = exports.Refunds = exports.Quotes = exports.PromotionCodes = exports.Products = exports.Prices = exports.Plans = exports.Payouts = exports.PaymentMethods = exports.PaymentLinks = exports.PaymentIntents = exports.OAuth = exports.Mandates = exports.Invoices = exports.InvoiceItems = exports.Files = exports.FileLinks = exports.ExchangeRates = exports.Events = exports.EphemeralKeys = exports.Disputes = exports.Customers = exports.CreditNotes = exports.Coupons = exports.CountrySpecs = exports.Charges = exports.BalanceTransactions = exports.Balance = exports.ApplicationFees = exports.ApplePayDomains = exports.Accounts = exports.AccountSessions = exports.AccountLinks = exports.Account = void 0;
+exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = exports.FinancialConnections = void 0;
 const ResourceNamespace_js_1 = require("./ResourceNamespace.js");
 const Accounts_js_1 = require("./resources/FinancialConnections/Accounts.js");
 const Authorizations_js_1 = require("./resources/Issuing/Authorizations.js");
@@ -54,6 +54,8 @@ var Accounts_js_2 = require("./resources/Accounts.js");
 Object.defineProperty(exports, "Account", { enumerable: true, get: function () { return Accounts_js_2.Accounts; } });
 var AccountLinks_js_1 = require("./resources/AccountLinks.js");
 Object.defineProperty(exports, "AccountLinks", { enumerable: true, get: function () { return AccountLinks_js_1.AccountLinks; } });
+var AccountSessions_js_1 = require("./resources/AccountSessions.js");
+Object.defineProperty(exports, "AccountSessions", { enumerable: true, get: function () { return AccountSessions_js_1.AccountSessions; } });
 var Accounts_js_3 = require("./resources/Accounts.js");
 Object.defineProperty(exports, "Accounts", { enumerable: true, get: function () { return Accounts_js_3.Accounts; } });
 var ApplePayDomains_js_1 = require("./resources/ApplePayDomains.js");

package/cjs/stripe.core.js

@@ -34,7 +34,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 = '13.3.0';
+    Stripe.PACKAGE_VERSION = '13.4.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/resources/AccountSessions.js

@@ -0,0 +1,6 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const AccountSessions = StripeResource.extend({
+    create: stripeMethod({ method: 'POST', fullPath: '/v1/account_sessions' }),
+});

package/esm/resources.js

@@ -48,6 +48,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 { AccountSessions } from './resources/AccountSessions.js';
 export { Accounts } from './resources/Accounts.js';
 export { ApplePayDomains } from './resources/ApplePayDomains.js';
 export { ApplicationFees } from './resources/ApplicationFees.js';

package/esm/stripe.core.js

@@ -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 = '13.3.0';
+    Stripe.PACKAGE_VERSION = '13.4.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": "13.3.0",
+  "version": "13.4.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",

package/types/AccountSessions.d.ts

@@ -0,0 +1,62 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    /**
+     * An AccountSession allows a Connect platform to grant access to a connected account in Connect embedded components.
+     *
+     * We recommend that you create an AccountSession each time you need to display an embedded component
+     * to your user. Do not save AccountSessions to your database as they expire relatively
+     * quickly, and cannot be used more than once.
+     *
+     * Related guide: [Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components)
+     */
+    interface AccountSession {
+      /**
+       * String representing the object's type. Objects of the same type share the same value.
+       */
+      object: 'account_session';
+
+      /**
+       * The ID of the account the AccountSession was created for
+       */
+      account: string;
+
+      /**
+       * The client secret of this AccountSession. Used on the client to set up secure access to the given `account`.
+       *
+       * The client secret can be used to provide access to `account` from your frontend. It should not be stored, logged, or exposed to anyone other than the connected account. Make sure that you have TLS enabled on any page that includes the client secret.
+       *
+       * Refer to our docs to [setup Connect embedded components](https://stripe.com/docs/connect/get-started-connect-embedded-components) and learn about how `client_secret` should be handled.
+       */
+      client_secret: string;
+
+      components: AccountSession.Components;
+
+      /**
+       * The timestamp at which this AccountSession will expire.
+       */
+      expires_at: number;
+
+      /**
+       * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+       */
+      livemode: boolean;
+    }
+
+    namespace AccountSession {
+      interface Components {
+        account_onboarding: Components.AccountOnboarding;
+      }
+
+      namespace Components {
+        interface AccountOnboarding {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+        }
+      }
+    }
+  }
+}

package/types/AccountSessionsResource.d.ts

@@ -0,0 +1,50 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    interface AccountSessionCreateParams {
+      /**
+       * The identifier of the account to create an Account Session for.
+       */
+      account: string;
+
+      /**
+       * Each key of the dictionary represents an embedded component, and each embedded component maps to its configuration (e.g. whether it has been enabled or not).
+       */
+      components: AccountSessionCreateParams.Components;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    namespace AccountSessionCreateParams {
+      interface Components {
+        /**
+         * Configuration for the account onboarding embedded component.
+         */
+        account_onboarding?: Components.AccountOnboarding;
+      }
+
+      namespace Components {
+        interface AccountOnboarding {
+          /**
+           * Whether the embedded component is enabled.
+           */
+          enabled: boolean;
+        }
+      }
+    }
+
+    class AccountSessionsResource {
+      /**
+       * Creates a AccountSession object that includes a single-use token that the platform can use on their front-end to grant client-side API access.
+       */
+      create(
+        params: AccountSessionCreateParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.AccountSession>>;
+    }
+  }
+}

package/types/AccountsResource.d.ts

@@ -2936,7 +2936,9 @@ declare module 'stripe' {
       expand?: Array<string>;
 
       /**
-       * Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.
+       * To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.
+       *
+       * If a capability isn't permanent, you can remove it from the account by passing false. Most capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.
        */
       requested?: boolean;
     }
@@ -3565,7 +3567,7 @@ declare module 'stripe' {
       ): Promise<Stripe.Response<Stripe.Person>>;
 
       /**
-       * Updates an existing Account Capability.
+       * Updates an existing Account Capability. Request or remove a capability by updating its requested parameter.
        */
       updateCapability(
         accountId: string,

package/types/BalanceTransactions.d.ts

@@ -98,7 +98,7 @@ declare module 'stripe' {
       status: string;
 
       /**
-       * Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `payment`, `payment_failure_refund`, `payment_refund`, `payment_reversal`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. [Learn more](https://stripe.com/docs/reports/balance-transaction-types) about balance transaction types and what they represent. If you are looking to classify transactions for accounting purposes, you might want to consider `reporting_category` instead.
+       * Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_inbound`, `obligation_outbound`, `obligation_reversal_inbound`, `obligation_reversal_outbound`, `obligation_payout`, `obligation_payout_failure`, `payment`, `payment_failure_refund`, `payment_refund`, `payment_reversal`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`. [Learn more](https://stripe.com/docs/reports/balance-transaction-types) about balance transaction types and what they represent. If you are looking to classify transactions for accounting purposes, you might want to consider `reporting_category` instead.
        */
       type: BalanceTransaction.Type;
     }
@@ -145,6 +145,12 @@ declare module 'stripe' {
         | 'issuing_authorization_release'
         | 'issuing_dispute'
         | 'issuing_transaction'
+        | 'obligation_inbound'
+        | 'obligation_outbound'
+        | 'obligation_payout'
+        | 'obligation_payout_failure'
+        | 'obligation_reversal_inbound'
+        | 'obligation_reversal_outbound'
         | 'payment'
         | 'payment_failure_refund'
         | 'payment_refund'

package/types/BalanceTransactionsResource.d.ts

@@ -33,7 +33,7 @@ declare module 'stripe' {
       source?: string;
 
       /**
-       * Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `payment`, `payment_failure_refund`, `payment_refund`, `payment_reversal`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.
+       * Only returns transactions of the given type. One of: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `connect_collection_transfer`, `contribution`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_inbound`, `obligation_outbound`, `obligation_reversal_inbound`, `obligation_reversal_outbound`, `obligation_payout`, `obligation_payout_failure`, `payment`, `payment_failure_refund`, `payment_refund`, `payment_reversal`, `payout`, `payout_cancel`, `payout_failure`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `stripe_fee`, `stripe_fx_fee`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, or `transfer_refund`.
        */
       type?: string;
     }

package/types/BankAccounts.d.ts

@@ -82,7 +82,7 @@ declare module 'stripe' {
       fingerprint: string | null;
 
       /**
-       * Information about upcoming new requirements for the bank account, including what information needs to be collected.
+       * Information about the [upcoming new requirements for the bank account](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when.
        */
       future_requirements?: BankAccount.FutureRequirements | null;
 

package/types/Checkout/Sessions.d.ts

@@ -103,7 +103,7 @@ declare module 'stripe' {
 
         /**
          * The ID of the customer for this Session.
-         * For Checkout Sessions in `payment` or `subscription` mode, Checkout
+         * For Checkout Sessions in `subscription` mode or Checkout Sessions with `customer_creation` set as `always` in `payment` mode, Checkout
          * will create a new customer object based on information provided
          * during the payment flow unless an existing customer was provided when
          * the Session was created.

package/types/Checkout/SessionsResource.d.ts

@@ -73,7 +73,7 @@ declare module 'stripe' {
          * If the Customer already has a valid [email](https://stripe.com/docs/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout.
          * If the Customer does not have a valid `email`, Checkout will set the email entered during the session on the Customer.
          *
-         * If blank for Checkout Sessions in `payment` or `subscription` mode, Checkout will create a new Customer object based on information provided during the payment flow.
+         * If blank for Checkout Sessions in `subscription` mode or with `customer_creation` set as `always` in `payment` mode, Checkout will create a new Customer object based on information provided during the payment flow.
          *
          * You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
          */
@@ -1233,7 +1233,7 @@ declare module 'stripe' {
               >;
 
               /**
-               * The list of bank transfer types that this PaymentIntent is allowed to use for funding. Permitted values include: `us_bank_account`, `eu_bank_account`, `id_bank_account`, `gb_bank_account`, `jp_bank_account`, `mx_bank_account`, `eu_bank_transfer`, `gb_bank_transfer`, `id_bank_transfer`, `jp_bank_transfer`, `mx_bank_transfer`, or `us_bank_transfer`.
+               * The list of bank transfer types that this PaymentIntent is allowed to use for funding.
                */
               type: BankTransfer.Type;
             }

package/types/Events.d.ts

@@ -79,7 +79,7 @@ declare module 'stripe' {
       /**
        * Description of the event (e.g., `invoice.created` or `charge.refunded`).
        */
-      type: string;
+      type: Event.Type;
     }
 
     namespace Event {
@@ -112,6 +112,203 @@ declare module 'stripe' {
          */
         idempotency_key: string | null;
       }
+
+      type Type =
+        | 'account.application.authorized'
+        | 'account.application.deauthorized'
+        | 'account.external_account.created'
+        | 'account.external_account.deleted'
+        | 'account.external_account.updated'
+        | 'account.updated'
+        | 'application_fee.created'
+        | 'application_fee.refund.updated'
+        | 'application_fee.refunded'
+        | 'balance.available'
+        | 'billing_portal.configuration.created'
+        | 'billing_portal.configuration.updated'
+        | 'billing_portal.session.created'
+        | 'capability.updated'
+        | 'cash_balance.funds_available'
+        | 'charge.captured'
+        | 'charge.dispute.closed'
+        | 'charge.dispute.created'
+        | 'charge.dispute.funds_reinstated'
+        | 'charge.dispute.funds_withdrawn'
+        | 'charge.dispute.updated'
+        | 'charge.expired'
+        | 'charge.failed'
+        | 'charge.pending'
+        | 'charge.refund.updated'
+        | 'charge.refunded'
+        | 'charge.succeeded'
+        | 'charge.updated'
+        | 'checkout.session.async_payment_failed'
+        | 'checkout.session.async_payment_succeeded'
+        | 'checkout.session.completed'
+        | 'checkout.session.expired'
+        | 'coupon.created'
+        | 'coupon.deleted'
+        | 'coupon.updated'
+        | 'credit_note.created'
+        | 'credit_note.updated'
+        | 'credit_note.voided'
+        | 'customer.created'
+        | 'customer.deleted'
+        | 'customer.discount.created'
+        | 'customer.discount.deleted'
+        | 'customer.discount.updated'
+        | 'customer.source.created'
+        | 'customer.source.deleted'
+        | 'customer.source.expiring'
+        | 'customer.source.updated'
+        | 'customer.subscription.created'
+        | 'customer.subscription.deleted'
+        | 'customer.subscription.paused'
+        | 'customer.subscription.pending_update_applied'
+        | 'customer.subscription.pending_update_expired'
+        | 'customer.subscription.resumed'
+        | 'customer.subscription.trial_will_end'
+        | 'customer.subscription.updated'
+        | 'customer.tax_id.created'
+        | 'customer.tax_id.deleted'
+        | 'customer.tax_id.updated'
+        | 'customer.updated'
+        | 'customer_cash_balance_transaction.created'
+        | 'file.created'
+        | 'financial_connections.account.created'
+        | 'financial_connections.account.deactivated'
+        | 'financial_connections.account.disconnected'
+        | 'financial_connections.account.reactivated'
+        | 'financial_connections.account.refreshed_balance'
+        | 'identity.verification_session.canceled'
+        | 'identity.verification_session.created'
+        | 'identity.verification_session.processing'
+        | 'identity.verification_session.redacted'
+        | 'identity.verification_session.requires_input'
+        | 'identity.verification_session.verified'
+        | 'invoice.created'
+        | 'invoice.deleted'
+        | 'invoice.finalization_failed'
+        | 'invoice.finalized'
+        | 'invoice.marked_uncollectible'
+        | 'invoice.paid'
+        | 'invoice.payment_action_required'
+        | 'invoice.payment_failed'
+        | 'invoice.payment_succeeded'
+        | 'invoice.sent'
+        | 'invoice.upcoming'
+        | 'invoice.updated'
+        | 'invoice.voided'
+        | 'invoiceitem.created'
+        | 'invoiceitem.deleted'
+        | 'invoiceitem.updated'
+        | 'issuing_authorization.created'
+        | 'issuing_authorization.request'
+        | 'issuing_authorization.updated'
+        | 'issuing_card.created'
+        | 'issuing_card.updated'
+        | 'issuing_cardholder.created'
+        | 'issuing_cardholder.updated'
+        | 'issuing_dispute.closed'
+        | 'issuing_dispute.created'
+        | 'issuing_dispute.funds_reinstated'
+        | 'issuing_dispute.submitted'
+        | 'issuing_dispute.updated'
+        | 'issuing_transaction.created'
+        | 'issuing_transaction.updated'
+        | 'mandate.updated'
+        | 'order.created'
+        | 'payment_intent.amount_capturable_updated'
+        | 'payment_intent.canceled'
+        | 'payment_intent.created'
+        | 'payment_intent.partially_funded'
+        | 'payment_intent.payment_failed'
+        | 'payment_intent.processing'
+        | 'payment_intent.requires_action'
+        | 'payment_intent.succeeded'
+        | 'payment_link.created'
+        | 'payment_link.updated'
+        | 'payment_method.attached'
+        | 'payment_method.automatically_updated'
+        | 'payment_method.detached'
+        | 'payment_method.updated'
+        | 'payout.canceled'
+        | 'payout.created'
+        | 'payout.failed'
+        | 'payout.paid'
+        | 'payout.reconciliation_completed'
+        | 'payout.updated'
+        | 'person.created'
+        | 'person.deleted'
+        | 'person.updated'
+        | 'plan.created'
+        | 'plan.deleted'
+        | 'plan.updated'
+        | 'price.created'
+        | 'price.deleted'
+        | 'price.updated'
+        | 'product.created'
+        | 'product.deleted'
+        | 'product.updated'
+        | 'promotion_code.created'
+        | 'promotion_code.updated'
+        | 'quote.accepted'
+        | 'quote.canceled'
+        | 'quote.created'
+        | 'quote.finalized'
+        | 'radar.early_fraud_warning.created'
+        | 'radar.early_fraud_warning.updated'
+        | 'recipient.created'
+        | 'recipient.deleted'
+        | 'recipient.updated'
+        | 'refund.created'
+        | 'refund.updated'
+        | 'reporting.report_run.failed'
+        | 'reporting.report_run.succeeded'
+        | 'reporting.report_type.updated'
+        | 'review.closed'
+        | 'review.opened'
+        | 'setup_intent.canceled'
+        | 'setup_intent.created'
+        | 'setup_intent.requires_action'
+        | 'setup_intent.setup_failed'
+        | 'setup_intent.succeeded'
+        | 'sigma.scheduled_query_run.created'
+        | 'sku.created'
+        | 'sku.deleted'
+        | 'sku.updated'
+        | 'source.canceled'
+        | 'source.chargeable'
+        | 'source.failed'
+        | 'source.mandate_notification'
+        | 'source.refund_attributes_required'
+        | 'source.transaction.created'
+        | 'source.transaction.updated'
+        | 'subscription_schedule.aborted'
+        | 'subscription_schedule.canceled'
+        | 'subscription_schedule.completed'
+        | 'subscription_schedule.created'
+        | 'subscription_schedule.expiring'
+        | 'subscription_schedule.released'
+        | 'subscription_schedule.updated'
+        | 'tax.settings.updated'
+        | 'tax_rate.created'
+        | 'tax_rate.updated'
+        | 'terminal.reader.action_failed'
+        | 'terminal.reader.action_succeeded'
+        | 'test_helpers.test_clock.advancing'
+        | 'test_helpers.test_clock.created'
+        | 'test_helpers.test_clock.deleted'
+        | 'test_helpers.test_clock.internal_failure'
+        | 'test_helpers.test_clock.ready'
+        | 'topup.canceled'
+        | 'topup.created'
+        | 'topup.failed'
+        | 'topup.reversed'
+        | 'topup.succeeded'
+        | 'transfer.created'
+        | 'transfer.reversed'
+        | 'transfer.updated';
     }
   }
 }

package/types/Invoices.d.ts

@@ -116,7 +116,15 @@ declare module 'stripe' {
       automatic_tax: Invoice.AutomaticTax;
 
       /**
-       * Indicates the reason why the invoice was created. `subscription_cycle` indicates an invoice created by a subscription advancing into a new period. `subscription_create` indicates an invoice created due to creating a subscription. `subscription_update` indicates an invoice created due to updating a subscription. `subscription` is set for all old invoices to indicate either a change to a subscription or a period advancement. `manual` is set for all invoices unrelated to a subscription (for example: created via the invoice editor). The `upcoming` value is reserved for simulated invoices per the upcoming invoice endpoint. `subscription_threshold` indicates an invoice created due to a billing threshold being reached.
+       * Indicates the reason why the invoice was created.
+       *
+       * * `manual`: Unrelated to a subscription, for example, created via the invoice editor.
+       * * `subscription`: No longer in use. Applies to subscriptions from before May 2018 where no distinction was made between updates, cycles, and thresholds.
+       * * `subscription_create`: A new subscription was created.
+       * * `subscription_cycle`: A subscription advanced into a new period.
+       * * `subscription_threshold`: A subscription reached a billing threshold.
+       * * `subscription_update`: A subscription was updated.
+       * * `upcoming`: Reserved for simulated invoices, per the upcoming invoice endpoint.
        */
       billing_reason: Invoice.BillingReason | null;
 

package/types/PaymentLinks.d.ts

@@ -32,6 +32,15 @@ declare module 'stripe' {
        */
       allow_promotion_codes: boolean;
 
+      /**
+       * The ID of the Connect application that created the Payment Link.
+       */
+      application:
+        | string
+        | Stripe.Application
+        | Stripe.DeletedApplication
+        | null;
+
       /**
        * The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account.
        */

package/types/Persons.d.ts

@@ -73,7 +73,7 @@ declare module 'stripe' {
       full_name_aliases?: Array<string>;
 
       /**
-       * Information about the upcoming new requirements for this person, including what information needs to be collected, and by when.
+       * Information about the [upcoming new requirements for this person](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when.
        */
       future_requirements?: Person.FutureRequirements | null;
 

package/types/Reporting/ReportRunsResource.d.ts

@@ -85,6 +85,7 @@ declare module 'stripe' {
             | 'issuing_dispute'
             | 'issuing_transaction'
             | 'network_cost'
+            | 'obligation'
             | 'other_adjustment'
             | 'partial_capture_reversal'
             | 'payout'

package/types/TokensResource.d.ts

@@ -13,6 +13,9 @@ declare module 'stripe' {
        */
       bank_account?: string | TokenCreateParams.BankAccount;
 
+      /**
+       * The card this token will represent. If you also pass in a customer, the card must be the ID of a card belonging to the customer. Otherwise, if you do not pass in a customer, this is a dictionary containing a user's credit card details, with the options described below.
+       */
       card?: TokenCreateParams.Card | string;
 
       /**
@@ -453,28 +456,64 @@ declare module 'stripe' {
       }
 
       interface Card {
+        /**
+         * City / District / Suburb / Town / Village.
+         */
         address_city?: string;
 
+        /**
+         * Billing address country, if provided.
+         */
         address_country?: string;
 
+        /**
+         * Address line 1 (Street address / PO Box / Company name).
+         */
         address_line1?: string;
 
+        /**
+         * Address line 2 (Apartment / Suite / Unit / Building).
+         */
         address_line2?: string;
 
+        /**
+         * State / County / Province / Region.
+         */
         address_state?: string;
 
+        /**
+         * ZIP or postal code.
+         */
         address_zip?: string;
 
+        /**
+         * Required in order to add the card to an account; in all other cases, this parameter is not used. When added to an account, the card (which must be a debit card) can be used as a transfer destination for funds in this currency.
+         */
         currency?: string;
 
+        /**
+         * Card security code. Highly recommended to always include this value.
+         */
         cvc?: string;
 
+        /**
+         * Two-digit number representing the card's expiration month.
+         */
         exp_month: string;
 
+        /**
+         * Two- or four-digit number representing the card's expiration year.
+         */
         exp_year: string;
 
+        /**
+         * Cardholder's full name.
+         */
         name?: string;
 
+        /**
+         * The card number, as a string without any separators.
+         */
         number: string;
       }
 

package/types/index.d.ts

@@ -8,6 +8,7 @@
 ///<reference path='./UpcomingInvoices.d.ts' />
 // Imports: The beginning of the section generated from our OpenAPI spec
 ///<reference path='./AccountLinksResource.d.ts' />
+///<reference path='./AccountSessionsResource.d.ts' />
 ///<reference path='./AccountsResource.d.ts' />
 ///<reference path='./ApplePayDomainsResource.d.ts' />
 ///<reference path='./ApplicationFeesResource.d.ts' />
@@ -98,6 +99,7 @@
 ///<reference path='./Treasury/TransactionsResource.d.ts' />
 ///<reference path='./WebhookEndpointsResource.d.ts' />
 ///<reference path='./AccountLinks.d.ts' />
+///<reference path='./AccountSessions.d.ts' />
 ///<reference path='./Accounts.d.ts' />
 ///<reference path='./ApplePayDomains.d.ts' />
 ///<reference path='./ApplicationFees.d.ts' />
@@ -223,6 +225,7 @@ declare module 'stripe' {
 
     // Fields: The beginning of the section generated from our OpenAPI spec
     accountLinks: Stripe.AccountLinksResource;
+    accountSessions: Stripe.AccountSessionsResource;
     accounts: Stripe.AccountsResource;
     applePayDomains: Stripe.ApplePayDomainsResource;
     applicationFees: Stripe.ApplicationFeesResource;