stripe 22.2.0 → 22.3.0-beta.1

package/cjs/resources/Treasury/FinancialAccounts.d.ts

@@ -1,6 +1,6 @@
 import { StripeResource } from '../../StripeResource.js';
 import { FinancialAccountFeatures } from './FinancialAccountFeatures.js';
-import { MetadataParam, Emptyable, PaginationParams, RangeQueryParam, Metadata } from '../../shared.js';
+import { Emptyable, MetadataParam, PaginationParams, RangeQueryParam, Metadata } from '../../shared.js';
 import { RequestOptions, ApiListPromise, Response } from '../../lib.js';
 export declare class FinancialAccountResource extends StripeResource {
     /**
@@ -57,6 +57,10 @@ export interface FinancialAccount {
      * Time at which the object was created. Measured in seconds since the Unix epoch.
      */
     created: number;
+    /**
+     * The display name for the FinancialAccount. Use this field to customize the names of the FinancialAccounts for your connected accounts. Unlike the `nickname` field, `display_name` is not internal metadata and will be exposed to connected accounts.
+     */
+    display_name?: string | null;
     /**
      * Encodes whether a FinancialAccount has access to a particular Feature, with a `status` enum and associated `status_details`.
      * Stripe or the platform can control Features via the requested field.
@@ -205,6 +209,10 @@ export declare namespace Treasury {
          * The currencies the FinancialAccount can hold a balance in.
          */
         supported_currencies: Array<string>;
+        /**
+         * The display name for the FinancialAccount. Use this field to customize the names of the FinancialAccounts for your connected accounts. Unlike the `nickname` field, `display_name` is not internal metadata and will be exposed to connected accounts.
+         */
+        display_name?: Emptyable<string>;
         /**
          * Specifies which fields in the response should be expanded.
          */
@@ -320,11 +328,18 @@ export declare namespace Treasury {
             }
             namespace FinancialAddresses {
                 interface Aba {
+                    /**
+                     * Requested bank partner
+                     */
+                    bank?: Aba.Bank;
                     /**
                      * Whether the FinancialAccount should have the Feature.
                      */
                     requested: boolean;
                 }
+                namespace Aba {
+                    type Bank = 'evolve' | 'fifth_third' | 'goldman_sachs';
+                }
             }
             namespace InboundTransfers {
                 interface Ach {
@@ -379,6 +394,10 @@ export declare namespace Treasury {
 }
 export declare namespace Treasury {
     interface FinancialAccountUpdateParams {
+        /**
+         * The display name for the FinancialAccount. Use this field to customize the names of the FinancialAccounts for your connected accounts. Unlike the `nickname` field, `display_name` is not internal metadata and will be exposed to connected accounts.
+         */
+        display_name?: Emptyable<string>;
         /**
          * Specifies which fields in the response should be expanded.
          */
@@ -512,11 +531,18 @@ export declare namespace Treasury {
             }
             namespace FinancialAddresses {
                 interface Aba {
+                    /**
+                     * Requested bank partner
+                     */
+                    bank?: Aba.Bank;
                     /**
                      * Whether the FinancialAccount should have the Feature.
                      */
                     requested: boolean;
                 }
+                namespace Aba {
+                    type Bank = 'evolve' | 'fifth_third' | 'goldman_sachs';
+                }
             }
             namespace InboundTransfers {
                 interface Ach {
@@ -710,11 +736,18 @@ export declare namespace Treasury {
         }
         namespace FinancialAddresses {
             interface Aba {
+                /**
+                 * Requested bank partner
+                 */
+                bank?: Aba.Bank;
                 /**
                  * Whether the FinancialAccount should have the Feature.
                  */
                 requested: boolean;
             }
+            namespace Aba {
+                type Bank = 'evolve' | 'fifth_third' | 'goldman_sachs';
+            }
         }
         namespace InboundTransfers {
             interface Ach {

package/cjs/resources/Treasury/OutboundPayments.d.ts

@@ -86,6 +86,10 @@ export interface OutboundPayment {
      * Set of [key-value pairs](https://docs.stripe.com/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: Metadata;
+    /**
+     * The purpose of the OutboundPayment, if applicable.
+     */
+    purpose?: 'payroll' | null;
     /**
      * Details about a returned OutboundPayment. Only set when the status is `returned`.
      */
@@ -303,6 +307,10 @@ export declare namespace Treasury {
          * Set of [key-value pairs](https://docs.stripe.com/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?: MetadataParam;
+        /**
+         * The purpose of the OutboundPayment, if applicable. This list is not exhaustive, do not specify this parameter if your purpose does not match any that are provided.
+         */
+        purpose?: 'payroll';
         /**
          * The description that appears on the receiving end for this OutboundPayment (for example, bank statement for external bank transfer). Maximum 10 characters for `ach` payments, 140 characters for `us_domestic_wire` payments, or 500 characters for `stripe` network transfers. Can only include -#.$&*, spaces, and alphanumeric characters. The default value is "payment".
          */

package/cjs/resources/Treasury/OutboundTransfers.d.ts

@@ -75,6 +75,10 @@ export interface OutboundTransfer {
      * Set of [key-value pairs](https://docs.stripe.com/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: Metadata;
+    /**
+     * Details about the network used for the OutboundTransfer.
+     */
+    network_details?: Treasury.OutboundTransfer.NetworkDetails | null;
     /**
      * Details about a returned OutboundTransfer. Only set when the status is `returned`.
      */
@@ -108,6 +112,16 @@ export declare namespace Treasury {
             type: DestinationPaymentMethodDetails.Type;
             us_bank_account?: DestinationPaymentMethodDetails.UsBankAccount;
         }
+        interface NetworkDetails {
+            /**
+             * Details about an ACH transaction.
+             */
+            ach?: NetworkDetails.Ach | null;
+            /**
+             * The type of flow that originated the OutboundTransfer.
+             */
+            type: 'ach';
+        }
         interface ReturnedDetails {
             /**
              * Reason for the return.
@@ -208,6 +222,14 @@ export declare namespace Treasury {
                 type Network = 'ach' | 'us_domestic_wire';
             }
         }
+        namespace NetworkDetails {
+            interface Ach {
+                /**
+                 * ACH Addenda record
+                 */
+                addenda: string | null;
+            }
+        }
         namespace ReturnedDetails {
             type Code = 'account_closed' | 'account_frozen' | 'bank_account_restricted' | 'bank_ownership_changed' | 'declined' | 'incorrect_account_holder_name' | 'invalid_account_number' | 'invalid_currency' | 'no_account' | 'other';
         }
@@ -274,6 +296,10 @@ export declare namespace Treasury {
          * Set of [key-value pairs](https://docs.stripe.com/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?: MetadataParam;
+        /**
+         * Details about the network used for the OutboundTransfer.
+         */
+        network_details?: OutboundTransferCreateParams.NetworkDetails;
         /**
          * Statement descriptor to be shown on the receiving end of an OutboundTransfer. Maximum 10 characters for `ach` transfers or 140 characters for `us_domestic_wire` transfers. The default value is "transfer". Can only include -#.$&*, spaces, and alphanumeric characters.
          */
@@ -296,6 +322,16 @@ export declare namespace Treasury {
              */
             us_bank_account?: Emptyable<DestinationPaymentMethodOptions.UsBankAccount>;
         }
+        interface NetworkDetails {
+            /**
+             * Optional fields for `ach`.
+             */
+            ach?: NetworkDetails.Ach;
+            /**
+             * The type of flow that originated the OutboundTransfer.
+             */
+            type: 'ach';
+        }
         namespace DestinationPaymentMethodOptions {
             interface UsBankAccount {
                 /**
@@ -307,6 +343,14 @@ export declare namespace Treasury {
                 type Network = 'ach' | 'us_domestic_wire';
             }
         }
+        namespace NetworkDetails {
+            interface Ach {
+                /**
+                 * Addenda record data associated with this OutboundTransfer.
+                 */
+                addenda?: string;
+            }
+        }
     }
 }
 export declare namespace Treasury {

package/cjs/resources/Treasury/ReceivedCredits.d.ts

@@ -63,6 +63,10 @@ export interface ReceivedCredit {
      * The rails used to send the funds.
      */
     network: Treasury.ReceivedCredit.Network;
+    /**
+     * Details specific to the money movement rails.
+     */
+    network_details?: Treasury.ReceivedCredit.NetworkDetails | null;
     /**
      * Details describing when a ReceivedCredit may be reversed.
      */
@@ -123,6 +127,16 @@ export declare namespace Treasury {
             source_flow_type: string | null;
         }
         type Network = 'ach' | 'card' | 'stripe' | 'us_domestic_wire';
+        interface NetworkDetails {
+            /**
+             * Details about an ACH transaction.
+             */
+            ach?: NetworkDetails.Ach | null;
+            /**
+             * The type of flow that originated the ReceivedCredit.
+             */
+            type: 'ach';
+        }
         interface ReversalDetails {
             /**
              * Time before which a ReceivedCredit can be reversed.
@@ -214,6 +228,14 @@ export declare namespace Treasury {
                 type Type = 'credit_reversal' | 'other' | 'outbound_payment' | 'outbound_transfer' | 'payout';
             }
         }
+        namespace NetworkDetails {
+            interface Ach {
+                /**
+                 * ACH Addenda record
+                 */
+                addenda: string | null;
+            }
+        }
         namespace ReversalDetails {
             type RestrictedReason = 'already_reversed' | 'deadline_passed' | 'network_restricted' | 'other' | 'source_flow_restricted';
         }

package/cjs/resources/Treasury/ReceivedDebits.d.ts

@@ -59,6 +59,10 @@ export interface ReceivedDebit {
      * The network used for the ReceivedDebit.
      */
     network: Treasury.ReceivedDebit.Network;
+    /**
+     * Details specific to the money movement rails.
+     */
+    network_details?: Treasury.ReceivedDebit.NetworkDetails | null;
     /**
      * Details describing when a ReceivedDebit might be reversed.
      */
@@ -113,12 +117,26 @@ export declare namespace Treasury {
              * Set if the ReceivedDebit was created due to a [Payout](https://api.stripe.com#payouts) object.
              */
             payout: string | null;
+            /**
+             * The ReceivedCredit that Capital withheld from
+             */
+            received_credit_capital_withholding?: string | null;
             /**
              * Set if the ReceivedDebit was created due to a [Topup](https://api.stripe.com#topups) object.
              */
             topup: string | null;
         }
         type Network = 'ach' | 'card' | 'stripe';
+        interface NetworkDetails {
+            /**
+             * Details about an ACH transaction.
+             */
+            ach?: NetworkDetails.Ach | null;
+            /**
+             * The type of flow that originated the ReceivedDebit.
+             */
+            type: 'ach';
+        }
         interface ReversalDetails {
             /**
              * Time before which a ReceivedDebit can be reversed.
@@ -168,6 +186,14 @@ export declare namespace Treasury {
                 routing_number: string | null;
             }
         }
+        namespace NetworkDetails {
+            interface Ach {
+                /**
+                 * ACH Addenda record
+                 */
+                addenda: string | null;
+            }
+        }
         namespace ReversalDetails {
             type RestrictedReason = 'already_reversed' | 'deadline_passed' | 'network_restricted' | 'other' | 'source_flow_restricted';
         }

package/cjs/resources/V2/Billing/BillSettingVersions.d.ts

@@ -0,0 +1,75 @@
+export interface BillSettingVersion {
+    /**
+     * The ID of the BillSettingVersion object.
+     */
+    id: string;
+    /**
+     * String representing the object's type. Objects of the same type share the same value of the object field.
+     */
+    object: 'v2.billing.bill_setting_version';
+    /**
+     * Settings related to calculating a bill.
+     */
+    calculation?: V2.Billing.BillSettingVersion.Calculation;
+    /**
+     * Timestamp of when the object was created.
+     */
+    created: string;
+    /**
+     * Settings related to invoice behavior.
+     */
+    invoice?: V2.Billing.BillSettingVersion.Invoice;
+    /**
+     * The ID of the invoice rendering template to be used when generating invoices.
+     */
+    invoice_rendering_template?: string;
+    /**
+     * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+     */
+    livemode: boolean;
+}
+export declare namespace V2 {
+    namespace Billing {
+        namespace BillSettingVersion {
+            interface Calculation {
+                /**
+                 * Settings for calculating tax.
+                 */
+                tax?: Calculation.Tax;
+            }
+            interface Invoice {
+                /**
+                 * The amount of time until the invoice is overdue for payment.
+                 */
+                time_until_due?: Invoice.TimeUntilDue;
+            }
+            namespace Calculation {
+                interface Tax {
+                    /**
+                     * Determines if tax is calculated automatically based on a PTC or manually based on rules defined by the business. Defaults to "manual".
+                     */
+                    type: Tax.Type;
+                }
+                namespace Tax {
+                    type Type = 'automatic' | 'manual';
+                }
+            }
+            namespace Invoice {
+                interface TimeUntilDue {
+                    /**
+                     * The interval unit for the time until due.
+                     */
+                    interval: TimeUntilDue.Interval;
+                    /**
+                     * The number of interval units. For example, if interval=day and interval_count=30,
+                     * the invoice is due in 30 days.
+                     */
+                    interval_count: number;
+                }
+                namespace TimeUntilDue {
+                    type Interval = 'day' | 'month' | 'week' | 'year';
+                }
+            }
+        }
+    }
+}

package/cjs/resources/V2/Billing/BillSettingVersions.js

@@ -0,0 +1,4 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BillSettingVersions.js.map

package/cjs/resources/V2/Billing/BillSettingVersions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BillSettingVersions.js","sourceRoot":"","sources":["../../../../src/resources/V2/Billing/BillSettingVersions.ts"],"names":[],"mappings":";AAAA,uCAAuC"}

package/cjs/resources/V2/Billing/BillSettings/Versions.d.ts

@@ -0,0 +1,33 @@
+import { StripeResource } from '../../../../StripeResource.js';
+import { BillSettingVersion } from './../../../V2/Billing/BillSettingVersions.js';
+import { RequestOptions, V2ListPromise, Response } from '../../../../lib.js';
+export declare class VersionResource extends StripeResource {
+    /**
+     * List all BillSettingVersions by BillSetting ID.
+     */
+    list(id: string, params?: V2.Billing.BillSettings.VersionListParams, options?: RequestOptions): V2ListPromise<BillSettingVersion>;
+    /**
+     * Retrieve a BillSettingVersion by ID.
+     */
+    retrieve(billSettingId: string, id: string, params?: V2.Billing.BillSettings.VersionRetrieveParams, options?: RequestOptions): Promise<Response<BillSettingVersion>>;
+}
+export declare namespace V2 {
+    namespace Billing {
+        namespace BillSettings {
+            interface VersionRetrieveParams {
+            }
+        }
+    }
+}
+export declare namespace V2 {
+    namespace Billing {
+        namespace BillSettings {
+            interface VersionListParams {
+                /**
+                 * Optionally set the maximum number of results per page. Defaults to 20.
+                 */
+                limit?: number;
+            }
+        }
+    }
+}

package/cjs/resources/V2/Billing/BillSettings/Versions.js

@@ -0,0 +1,23 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionResource = void 0;
+const StripeResource_js_1 = require("../../../../StripeResource.js");
+class VersionResource extends StripeResource_js_1.StripeResource {
+    /**
+     * List all BillSettingVersions by BillSetting ID.
+     */
+    list(id, params, options) {
+        return this._makeRequest('GET', `/v2/billing/bill_settings/${id}/versions`, params, options, {
+            methodType: 'list',
+        });
+    }
+    /**
+     * Retrieve a BillSettingVersion by ID.
+     */
+    retrieve(billSettingId, id, params, options) {
+        return this._makeRequest('GET', `/v2/billing/bill_settings/${billSettingId}/versions/${id}`, params, options);
+    }
+}
+exports.VersionResource = VersionResource;
+//# sourceMappingURL=Versions.js.map

package/cjs/resources/V2/Billing/BillSettings/Versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Versions.js","sourceRoot":"","sources":["../../../../../src/resources/V2/Billing/BillSettings/Versions.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAEvC,qEAA6D;AAI7D,MAAa,eAAgB,SAAQ,kCAAc;IACjD;;OAEG;IACH,IAAI,CACF,EAAU,EACV,MAAkD,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,6BAA6B,EAAE,WAAW,EAC1C,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,MAAM;SACnB,CACK,CAAC;IACX,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,aAAqB,EACrB,EAAU,EACV,MAAsD,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,6BAA6B,aAAa,aAAa,EAAE,EAAE,EAC3D,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF;AAnCD,0CAmCC"}