stripe 11.15.0 → 11.16.0

package/CHANGELOG.md

@@ -1,16 +1,27 @@
 # Changelog
 
+## 11.16.0 - 2023-03-23
+* [#1730](https://github.com/stripe/stripe-node/pull/1730) Update generated code
+  * Add support for new resources `Tax.CalculationLineItem`, `Tax.Calculation`, `Tax.TransactionLineItem`, and `Tax.Transaction`
+  * Add support for `create` and `list_line_items` methods on resource `Calculation`
+  * Add support for `create_from_calculation`, `create_reversal`, `create`, `list_line_items`, and `retrieve` methods on resource `Transaction`
+  * Add support for new value `link` on enum `CheckoutSessionCreateParams.payment_method_types[]`
+  * Add support for `currency_conversion` on `Checkout.Session`
+  * Add support for new value `link` on enums `PaymentLink.payment_method_types[]`, `PaymentLinkCreateParams.payment_method_types[]`, and `PaymentLinkUpdateParams.payment_method_types[]`
+  * Add support for `automatic_payment_methods` on `SetupIntentCreateParams` and `SetupIntent`
+* [#1726](https://github.com/stripe/stripe-node/pull/1726) Add Deno entry point
+
 ## 11.15.0 - 2023-03-16
 * [#1714](https://github.com/stripe/stripe-node/pull/1714) API Updates
-  * Add support for `cashapp_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
-  * Add support for new value `cashapp` as a new `type` throughout the API.
-  * Add support for `future_requirements` and `requirements` on `BankAccount`
-  * Add support for `country` on `Charge.payment_method_details.link`
-  * Add support for new value `automatic_async` on enums `CheckoutSessionCreateParams.payment_intent_data.capture_method`, `PaymentIntent.capture_method`, `PaymentIntentConfirmParams.capture_method`, `PaymentIntentCreateParams.capture_method`, `PaymentIntentUpdateParams.capture_method`, `PaymentLink.payment_intent_data.capture_method`, and `PaymentLinkCreateParams.payment_intent_data.capture_method`
-  
-  * Add support for `preferred_locale` on `PaymentIntent.payment_method_options.affirm`, 
-  * Add support for `cashapp_handle_redirect_or_display_qr_code` on `PaymentIntent.next_action` and `SetupIntent.next_action`
-  * Add support for new value `payout.reconciliation_completed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
+  * Add support for `cashapp_payments` on `Account.capabilities`, `AccountCreateParams.capabilities`, and `AccountUpdateParams.capabilities`
+  * Add support for new value `cashapp` as a new `type` throughout the API.
+  * Add support for `future_requirements` and `requirements` on `BankAccount`
+  * Add support for `country` on `Charge.payment_method_details.link`
+  * Add support for new value `automatic_async` on enums `CheckoutSessionCreateParams.payment_intent_data.capture_method`, `PaymentIntent.capture_method`, `PaymentIntentConfirmParams.capture_method`, `PaymentIntentCreateParams.capture_method`, `PaymentIntentUpdateParams.capture_method`, `PaymentLink.payment_intent_data.capture_method`, and `PaymentLinkCreateParams.payment_intent_data.capture_method`
+
+  * Add support for `preferred_locale` on `PaymentIntent.payment_method_options.affirm`,
+  * Add support for `cashapp_handle_redirect_or_display_qr_code` on `PaymentIntent.next_action` and `SetupIntent.next_action`
+  * Add support for new value `payout.reconciliation_completed` on enums `WebhookEndpointCreateParams.enabled_events[]` and `WebhookEndpointUpdateParams.enabled_events[]`
 * [#1709](https://github.com/stripe/stripe-node/pull/1709) Add ES module package entry point
   * Add support for ES modules by defining a separate ESM entry point. This updates stripe-node to be a [dual CommonJS / ES module package](https://nodejs.org/api/packages.html#dual-commonjses-module-packages).
 * [#1704](https://github.com/stripe/stripe-node/pull/1704) Configure 2 TypeScript compile targets for ESM and CJS

package/VERSION

@@ -1 +1 @@
-11.15.0
+11.16.0

package/cjs/ResourceNamespace.js

@@ -1,7 +1,7 @@
 "use strict";
+// ResourceNamespace allows you to create nested resources, i.e. `stripe.issuing.cards`.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resourceNamespace = void 0;
-// ResourceNamespace allows you to create nested resources, i.e. `stripe.issuing.cards`.
 // It also works recursively, so you could do i.e. `stripe.billing.invoicing.pay`.
 function ResourceNamespace(stripe, resources) {
     for (const name in resources) {

package/cjs/resources/Tax/Calculations.js

@@ -0,0 +1,17 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Calculations = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Calculations = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/calculations',
+    }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/calculations/{calculation}/line_items',
+        methodType: 'list',
+    }),
+});

package/cjs/resources/Tax/Transactions.js

@@ -0,0 +1,29 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transactions = void 0;
+const StripeResource_js_1 = require("../../StripeResource.js");
+const stripeMethod = StripeResource_js_1.StripeResource.method;
+exports.Transactions = StripeResource_js_1.StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions',
+    }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/transactions/{transaction}',
+    }),
+    createFromCalculation: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions/create_from_calculation',
+    }),
+    createReversal: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions/create_reversal',
+    }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/transactions/{transaction}/line_items',
+        methodType: 'list',
+    }),
+});

package/cjs/resources.js

@@ -2,10 +2,11 @@
 // 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.SubscriptionSchedules = exports.SubscriptionItems = exports.Subscriptions = 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.Mandates = exports.InvoiceItems = exports.Invoices = exports.FileLinks = exports.Files = 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.AccountLinks = exports.Accounts = exports.OAuth = exports.Account = void 0;
-exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = void 0;
+exports.Treasury = exports.TestHelpers = exports.Terminal = exports.Tax = exports.Sigma = exports.Reporting = exports.Radar = exports.Issuing = exports.Identity = 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");
+const Calculations_js_1 = require("./resources/Tax/Calculations.js");
 const Cardholders_js_1 = require("./resources/Issuing/Cardholders.js");
 const Cards_js_1 = require("./resources/TestHelpers/Issuing/Cards.js");
 const Cards_js_2 = require("./resources/Issuing/Cards.js");
@@ -42,7 +43,8 @@ const Sessions_js_3 = require("./resources/FinancialConnections/Sessions.js");
 const TestClocks_js_1 = require("./resources/TestHelpers/TestClocks.js");
 const TransactionEntries_js_1 = require("./resources/Treasury/TransactionEntries.js");
 const Transactions_js_1 = require("./resources/Issuing/Transactions.js");
-const Transactions_js_2 = require("./resources/Treasury/Transactions.js");
+const Transactions_js_2 = require("./resources/Tax/Transactions.js");
+const Transactions_js_3 = require("./resources/Treasury/Transactions.js");
 const ValueListItems_js_1 = require("./resources/Radar/ValueListItems.js");
 const ValueLists_js_1 = require("./resources/Radar/ValueLists.js");
 const VerificationReports_js_1 = require("./resources/Identity/VerificationReports.js");
@@ -174,6 +176,10 @@ exports.Reporting = (0, ResourceNamespace_js_1.resourceNamespace)('reporting', {
 exports.Sigma = (0, ResourceNamespace_js_1.resourceNamespace)('sigma', {
     ScheduledQueryRuns: ScheduledQueryRuns_js_1.ScheduledQueryRuns,
 });
+exports.Tax = (0, ResourceNamespace_js_1.resourceNamespace)('tax', {
+    Calculations: Calculations_js_1.Calculations,
+    Transactions: Transactions_js_2.Transactions,
+});
 exports.Terminal = (0, ResourceNamespace_js_1.resourceNamespace)('terminal', {
     Configurations: Configurations_js_2.Configurations,
     ConnectionTokens: ConnectionTokens_js_1.ConnectionTokens,
@@ -206,5 +212,5 @@ exports.Treasury = (0, ResourceNamespace_js_1.resourceNamespace)('treasury', {
     ReceivedCredits: ReceivedCredits_js_2.ReceivedCredits,
     ReceivedDebits: ReceivedDebits_js_2.ReceivedDebits,
     TransactionEntries: TransactionEntries_js_1.TransactionEntries,
-    Transactions: Transactions_js_2.Transactions,
+    Transactions: Transactions_js_3.Transactions,
 });

package/cjs/stripe.core.js

@@ -33,7 +33,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 = '11.15.0';
+    Stripe.PACKAGE_VERSION = '11.16.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/net/FetchHttpClient.js

@@ -1,4 +1,4 @@
-import { HttpClient, HttpClientResponse } from './HttpClient.js';
+import { HttpClient, HttpClientResponse, } from './HttpClient.js';
 /**
  * HTTP client which uses a `fetch` function to issue requests.
  *

package/esm/net/NodeHttpClient.js

@@ -1,6 +1,6 @@
 import * as http from 'http';
 import * as https from 'https';
-import { HttpClient, HttpClientResponse } from './HttpClient.js';
+import { HttpClient, HttpClientResponse, } from './HttpClient.js';
 const defaultHttpAgent = new http.Agent({ keepAlive: true });
 const defaultHttpsAgent = new https.Agent({ keepAlive: true });
 /**

package/esm/resources/Tax/Calculations.js

@@ -0,0 +1,14 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Calculations = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/calculations',
+    }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/calculations/{calculation}/line_items',
+        methodType: 'list',
+    }),
+});

package/esm/resources/Tax/Transactions.js

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec
+import { StripeResource } from '../../StripeResource.js';
+const stripeMethod = StripeResource.method;
+export const Transactions = StripeResource.extend({
+    create: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions',
+    }),
+    retrieve: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/transactions/{transaction}',
+    }),
+    createFromCalculation: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions/create_from_calculation',
+    }),
+    createReversal: stripeMethod({
+        method: 'POST',
+        fullPath: '/v1/tax/transactions/create_reversal',
+    }),
+    listLineItems: stripeMethod({
+        method: 'GET',
+        fullPath: '/v1/tax/transactions/{transaction}/line_items',
+        methodType: 'list',
+    }),
+});

package/esm/resources.js

@@ -2,6 +2,7 @@
 import { resourceNamespace } from './ResourceNamespace.js';
 import { Accounts as FinancialConnectionsAccounts } from './resources/FinancialConnections/Accounts.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 IssuingCards } from './resources/Issuing/Cards.js';
@@ -38,6 +39,7 @@ import { Sessions as FinancialConnectionsSessions } from './resources/FinancialC
 import { TestClocks as TestHelpersTestClocks } from './resources/TestHelpers/TestClocks.js';
 import { TransactionEntries as TreasuryTransactionEntries } from './resources/Treasury/TransactionEntries.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';
 import { ValueListItems as RadarValueListItems } from './resources/Radar/ValueListItems.js';
 import { ValueLists as RadarValueLists } from './resources/Radar/ValueLists.js';
@@ -124,6 +126,10 @@ export const Reporting = resourceNamespace('reporting', {
 export const Sigma = resourceNamespace('sigma', {
     ScheduledQueryRuns: SigmaScheduledQueryRuns,
 });
+export const Tax = resourceNamespace('tax', {
+    Calculations: TaxCalculations,
+    Transactions: TaxTransactions,
+});
 export const Terminal = resourceNamespace('terminal', {
     Configurations: TerminalConfigurations,
     ConnectionTokens: TerminalConnectionTokens,

package/esm/stripe.core.js

@@ -30,7 +30,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 = '11.15.0';
+    Stripe.PACKAGE_VERSION = '11.16.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": "11.15.0",
+  "version": "11.16.0",
   "description": "Stripe API wrapper",
   "keywords": [
     "stripe",
@@ -39,6 +39,7 @@
     "eslint": "^7.32.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-chai-friendly": "^0.7.2",
+    "eslint-plugin-import": "^2.27.5",
     "eslint-plugin-prettier": "^3.4.1",
     "mocha": "^8.4.0",
     "mocha-junit-reporter": "^2.1.0",
@@ -79,6 +80,10 @@
       "import": "./esm/stripe.esm.worker.js",
       "require": "./cjs/stripe.cjs.worker.js"
     },
+    "deno": {
+      "import": "./esm/stripe.esm.worker.js",
+      "require": "./cjs/stripe.cjs.worker.js"
+    },
     "worker": {
       "import": "./esm/stripe.esm.worker.js",
       "require": "./cjs/stripe.cjs.worker.js"

package/types/Checkout/Sessions.d.ts

@@ -89,6 +89,11 @@ declare module 'stripe' {
          */
         currency: string | null;
 
+        /**
+         * Currency conversion details for automatic currency conversion sessions
+         */
+        currency_conversion?: Session.CurrencyConversion | null;
+
         /**
          * Collect additional information from your customer using custom fields. Up to 2 fields are supported.
          */
@@ -355,6 +360,28 @@ declare module 'stripe' {
           type TermsOfService = 'none' | 'required';
         }
 
+        interface CurrencyConversion {
+          /**
+           * Total of all items in source currency before discounts or taxes are applied.
+           */
+          amount_subtotal: number;
+
+          /**
+           * Total of all items in source currency after discounts and taxes are applied.
+           */
+          amount_total: number;
+
+          /**
+           * Exchange rate used to convert source currency amounts to customer currency amounts
+           */
+          fx_rate: string;
+
+          /**
+           * Creation currency of the CheckoutSession before localization
+           */
+          source_currency: string;
+        }
+
         type CustomerCreation = 'always' | 'if_required';
 
         interface CustomerDetails {

package/types/Checkout/SessionsResource.d.ts

@@ -1468,6 +1468,7 @@ declare module 'stripe' {
           | 'ideal'
           | 'klarna'
           | 'konbini'
+          | 'link'
           | 'oxxo'
           | 'p24'
           | 'paynow'

package/types/Disputes.d.ts

@@ -227,7 +227,7 @@ declare module 'stripe' {
 
       interface EvidenceDetails {
         /**
-         * Date by which evidence must be submitted in order to successfully challenge dispute. Will be null if the customer's bank or credit card company doesn't allow a response for this particular dispute.
+         * Date by which evidence must be submitted in order to successfully challenge dispute. Will be 0 if the customer's bank or credit card company doesn't allow a response for this particular dispute.
          */
         due_by: number | null;
 

package/types/PaymentLinks.d.ts

@@ -401,6 +401,7 @@ declare module 'stripe' {
         | 'ideal'
         | 'klarna'
         | 'konbini'
+        | 'link'
         | 'oxxo'
         | 'p24'
         | 'paynow'

package/types/PaymentLinksResource.d.ts

@@ -457,6 +457,7 @@ declare module 'stripe' {
         | 'ideal'
         | 'klarna'
         | 'konbini'
+        | 'link'
         | 'oxxo'
         | 'p24'
         | 'paynow'
@@ -1129,6 +1130,7 @@ declare module 'stripe' {
         | 'ideal'
         | 'klarna'
         | 'konbini'
+        | 'link'
         | 'oxxo'
         | 'p24'
         | 'paynow'

package/types/SetupIntents.d.ts

@@ -49,6 +49,11 @@ declare module 'stripe' {
        */
       attach_to_self?: boolean;
 
+      /**
+       * Settings for automatic payment methods compatible with this Setup Intent
+       */
+      automatic_payment_methods: SetupIntent.AutomaticPaymentMethods | null;
+
       /**
        * Reason for cancellation of this SetupIntent, one of `abandoned`, `requested_by_customer`, or `duplicate`.
        */
@@ -154,6 +159,13 @@ declare module 'stripe' {
     }
 
     namespace SetupIntent {
+      interface AutomaticPaymentMethods {
+        /**
+         * Automatically calculates compatible payment methods
+         */
+        enabled: boolean | null;
+      }
+
       type CancellationReason =
         | 'abandoned'
         | 'duplicate'

package/types/SetupIntentsResource.d.ts

@@ -10,6 +10,11 @@ declare module 'stripe' {
        */
       attach_to_self?: boolean;
 
+      /**
+       * When enabled, this SetupIntent will accept payment methods that you have enabled in the Dashboard and are compatible with this SetupIntent's other parameters.
+       */
+      automatic_payment_methods?: SetupIntentCreateParams.AutomaticPaymentMethods;
+
       /**
        * Set to `true` to attempt to confirm this SetupIntent immediately. This parameter defaults to `false`. If the payment method attached is a card, a return_url may be provided in case additional authentication is required.
        */
@@ -92,6 +97,13 @@ declare module 'stripe' {
     }
 
     namespace SetupIntentCreateParams {
+      interface AutomaticPaymentMethods {
+        /**
+         * Whether this feature is enabled.
+         */
+        enabled: boolean;
+      }
+
       type FlowDirection = 'inbound' | 'outbound';
 
       interface MandateData {

package/types/Tax/CalculationLineItems.d.ts

@@ -0,0 +1,178 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    namespace Tax {
+      /**
+       * The CalculationLineItem object.
+       */
+      interface CalculationLineItem {
+        /**
+         * Unique identifier for the object.
+         */
+        id: string;
+
+        /**
+         * String representing the object's type. Objects of the same type share the same value.
+         */
+        object: 'tax.calculation_line_item';
+
+        /**
+         * The line item amount in integer cents. If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+         */
+        amount: number;
+
+        /**
+         * The amount of tax calculated for this line item, in integer cents.
+         */
+        amount_tax: 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;
+
+        /**
+         * A Product ID.
+         */
+        product: string | null;
+
+        /**
+         * The number of units of the item being purchased. For reversals, this is the quantity reversed.
+         */
+        quantity: number;
+
+        /**
+         * A custom identifier for this line item.
+         */
+        reference: string | null;
+
+        /**
+         * Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
+         */
+        tax_behavior: CalculationLineItem.TaxBehavior;
+
+        /**
+         * Detailed account of taxes relevant to this line item.
+         */
+        tax_breakdown: Array<CalculationLineItem.TaxBreakdown> | null;
+
+        /**
+         * The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource.
+         */
+        tax_code: string;
+      }
+
+      namespace CalculationLineItem {
+        type TaxBehavior = 'exclusive' | 'inclusive';
+
+        interface TaxBreakdown {
+          /**
+           * The amount of tax, in integer cents.
+           */
+          amount: number;
+
+          jurisdiction: TaxBreakdown.Jurisdiction;
+
+          /**
+           * Indicates whether the jurisdiction was determined by the origin (merchant's address) or destination (customer's address).
+           */
+          sourcing: TaxBreakdown.Sourcing;
+
+          /**
+           * Details regarding the rate for this tax. This field will be `null` when the tax is not imposed, for example if the product is exempt from tax.
+           */
+          tax_rate_details: TaxBreakdown.TaxRateDetails | null;
+
+          /**
+           * The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
+           */
+          taxability_reason: TaxBreakdown.TaxabilityReason;
+
+          /**
+           * The amount on which tax is calculated, in integer cents.
+           */
+          taxable_amount: number;
+        }
+
+        namespace TaxBreakdown {
+          interface Jurisdiction {
+            /**
+             * Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
+             */
+            country: string;
+
+            /**
+             * A human-readable name for the jurisdiction imposing the tax.
+             */
+            display_name: string;
+
+            /**
+             * Indicates the level of the jurisdiction imposing the tax.
+             */
+            level: Jurisdiction.Level;
+
+            /**
+             * [ISO 3166-2 subdivision code](https://en.wikipedia.org/wiki/ISO_3166-2:US), without country prefix. For example, "NY" for New York, United States.
+             */
+            state: string | null;
+          }
+
+          namespace Jurisdiction {
+            type Level = 'city' | 'country' | 'county' | 'district' | 'state';
+          }
+
+          type Sourcing = 'destination' | 'origin';
+
+          type TaxabilityReason =
+            | 'customer_exempt'
+            | 'not_collecting'
+            | 'not_subject_to_tax'
+            | 'not_supported'
+            | 'portion_product_exempt'
+            | 'portion_reduced_rated'
+            | 'portion_standard_rated'
+            | 'product_exempt'
+            | 'product_exempt_holiday'
+            | 'proportionally_rated'
+            | 'reduced_rated'
+            | 'reverse_charge'
+            | 'standard_rated'
+            | 'taxable_basis_reduced'
+            | 'zero_rated';
+
+          interface TaxRateDetails {
+            /**
+             * A localized display name for tax type, intended to be human-readable. For example, "Local Sales and Use Tax", "Value-added tax (VAT)", or "Umsatzsteuer (USt.)".
+             */
+            display_name: string;
+
+            /**
+             * The tax rate percentage as a string. For example, 8.5% is represented as "8.5".
+             */
+            percentage_decimal: string;
+
+            /**
+             * The tax type, such as `vat` or `sales_tax`.
+             */
+            tax_type: TaxRateDetails.TaxType;
+          }
+
+          namespace TaxRateDetails {
+            type TaxType =
+              | 'gst'
+              | 'hst'
+              | 'igst'
+              | 'jct'
+              | 'lease_tax'
+              | 'pst'
+              | 'qst'
+              | 'rst'
+              | 'sales_tax'
+              | 'vat';
+          }
+        }
+      }
+    }
+  }
+}