stripe 22.3.0 → 22.4.0-alpha.2

package/cjs/resources/V2/MoneyManagement/FinancialAccounts.d.ts

@@ -0,0 +1,449 @@
+import { StripeResource } from '../../../StripeResource.js';
+import { V2Amount } from './../V2Amounts.js';
+import { MetadataParam, Metadata } from '../../../shared.js';
+import { RequestOptions, V2ListPromise, Response } from '../../../lib.js';
+import { StatementResource } from './FinancialAccounts/Statements.js';
+import { Stripe } from '../../../stripe.core.js';
+export declare class FinancialAccountResource extends StripeResource {
+    private readonly stripe;
+    statements: StatementResource;
+    constructor(stripe: Stripe);
+    /**
+     * Lists FinancialAccounts in this compartment.
+     */
+    list(params?: V2.MoneyManagement.FinancialAccountListParams, options?: RequestOptions): V2ListPromise<FinancialAccount>;
+    /**
+     * Creates a new FinancialAccount.
+     * @throws Stripe.AlreadyExistsError
+     * @throws Stripe.FeatureNotEnabledError
+     */
+    create(params: V2.MoneyManagement.FinancialAccountCreateParams, options?: RequestOptions): Promise<Response<FinancialAccount>>;
+    /**
+     * Retrieves the details of an existing FinancialAccount.
+     */
+    retrieve(id: string, params?: V2.MoneyManagement.FinancialAccountRetrieveParams, options?: RequestOptions): Promise<Response<FinancialAccount>>;
+    /**
+     * Updates an existing FinancialAccount.
+     */
+    update(id: string, params?: V2.MoneyManagement.FinancialAccountUpdateParams, options?: RequestOptions): Promise<Response<FinancialAccount>>;
+    /**
+     * Closes a FinancialAccount with or without forwarding settings.
+     * @throws Stripe.NonZeroBalanceError
+     */
+    close(id: string, params?: V2.MoneyManagement.FinancialAccountCloseParams, options?: RequestOptions): Promise<Response<FinancialAccount>>;
+}
+export interface FinancialAccount {
+    /**
+     * Unique identifier for the object.
+     */
+    id: string;
+    /**
+     * String representing the object's type. Objects of the same type share the same value of the object field.
+     */
+    object: 'v2.money_management.financial_account';
+    /**
+     * If this is a `accrued_fees` FinancialAccount, this hash include details specific to `accrued_fees` FinancialAccount.
+     */
+    accrued_fees?: FinancialAccount.AccruedFees;
+    /**
+     * Multi-currency balance of this FinancialAccount, split by availability state. Each balance is represented as a hash where the key is the three-letter ISO currency code, in lowercase, and the value is the amount for that currency.
+     */
+    balance: FinancialAccount.Balance;
+    /**
+     * Open Enum. Two-letter country code that represents the country where the LegalEntity associated with the FinancialAccount is based in.
+     */
+    country: string;
+    /**
+     * Time at which the object was created.
+     */
+    created: string;
+    /**
+     * If this is a `credit` FinancialAccount, this hash includes details specific to `credit` FinancialAccounts.
+     */
+    credit?: FinancialAccount.Credit;
+    /**
+     * A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.
+     */
+    display_name?: 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;
+    /**
+     * If this is a managed FinancialAccount, `managed_by` indicates the product that created and manages this FinancialAccount. For managed FinancialAccounts,
+     * creation of money management resources can only be orchestrated by the managing product.
+     */
+    managed_by?: FinancialAccount.ManagedBy;
+    /**
+     * Metadata associated with the FinancialAccount.
+     */
+    metadata?: Metadata;
+    /**
+     * If this is a `multiprocessor_settlement` FinancialAccount, this hash includes details specific to `multiprocessor_settlement` FinancialAccounts.
+     */
+    multiprocessor_settlement?: FinancialAccount.MultiprocessorSettlement;
+    /**
+     * If this is a `other` FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in `type`.
+     */
+    other?: FinancialAccount.Other;
+    /**
+     * If this is a `payments` FinancialAccount, this hash include details specific to `payments` FinancialAccount.
+     */
+    payments?: FinancialAccount.Payments;
+    /**
+     * Closed Enum. An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.
+     */
+    status: FinancialAccount.Status;
+    /**
+     * Additional details related to the status of the FinancialAccount.
+     */
+    status_details?: FinancialAccount.StatusDetails;
+    /**
+     * If this is a `storage` FinancialAccount, this hash includes details specific to `storage` FinancialAccounts.
+     */
+    storage?: FinancialAccount.Storage;
+    /**
+     * Type of the FinancialAccount. An additional hash is included on the FinancialAccount with a name matching this value.
+     * It contains additional information specific to the FinancialAccount type.
+     */
+    type: FinancialAccount.Type;
+}
+export declare namespace FinancialAccount {
+    interface AccruedFees {
+        /**
+         * The currencies enabled for fee accrual on this FinancialAccount.
+         */
+        currencies: Array<string>;
+        /**
+         * Direction of fee accrual for this FinancialAccount.
+         */
+        direction: AccruedFees.Direction;
+    }
+    interface Balance {
+        /**
+         * Balance that can be used for money movement.
+         */
+        available: {
+            [key: string]: V2Amount;
+        };
+        /**
+         * Balance of inbound funds that will later transition to the `available` balance.
+         */
+        inbound_pending: {
+            [key: string]: V2Amount;
+        };
+        /**
+         * Balance of funds that are being used for a pending outbound money movement.
+         */
+        outbound_pending: {
+            [key: string]: V2Amount;
+        };
+    }
+    interface Credit {
+        /**
+         * Details about how this credit FinancialAccount is funded.
+         */
+        funded_by?: Credit.FundedBy;
+        /**
+         * The currencies supported by this credit FinancialAccount.
+         */
+        supported_currencies: Array<string>;
+    }
+    interface ManagedBy {
+        /**
+         * Enum describing the Stripe product that is managing this FinancialAccount.
+         */
+        type: 'multiprocessor_settlement';
+    }
+    interface MultiprocessorSettlement {
+        /**
+         * Settlement currencies enabled for this FinancialAccount.
+         */
+        settlement_currencies: Array<string>;
+    }
+    interface Other {
+        /**
+         * The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in `financial_account.type`.
+         */
+        type: string;
+    }
+    interface Payments {
+        /**
+         * The balance of the `payments` FinancialAccount is a mix of payment processing and stored value funds, and this field
+         * describes the breakdown between the two. The sum will match the balance of the FinancialAccount.
+         */
+        balance_by_funds_type?: Payments.BalanceByFundsType;
+        /**
+         * The currency that non-settlement currency payments will be converted to.
+         */
+        default_currency: string;
+        /**
+         * Settlement currencies enabled for this FinancialAccount. Payments in other currencies will be automatically converted to `default_currency`.
+         */
+        settlement_currencies: Array<string>;
+        /**
+         * Describes the available balance when it was projected.
+         */
+        starting_balance?: Payments.StartingBalance;
+    }
+    type Status = 'closed' | 'open' | 'pending';
+    interface StatusDetails {
+        /**
+         * Details related to the closed state of the FinancialAccount.
+         */
+        closed?: StatusDetails.Closed;
+    }
+    interface Storage {
+        /**
+         * The usage type for funds in this FinancialAccount. Can be used to specify that the funds are for Consumer activity.
+         */
+        funds_usage_type?: Storage.FundsUsageType;
+        /**
+         * The currencies that this FinancialAccount can hold.
+         */
+        holds_currencies: Array<string>;
+    }
+    type Type = 'accrued_fees' | 'credit' | 'multiprocessor_settlement' | 'other' | 'payments' | 'storage';
+    namespace AccruedFees {
+        type Direction = 'payable' | 'receivable';
+    }
+    namespace Credit {
+        interface FundedBy {
+            /**
+             * Details for platform-funded credit FinancialAccounts.
+             */
+            platform: FundedBy.Platform;
+            /**
+             * The type of funding source for this credit FinancialAccount.
+             */
+            type: FundedBy.Type;
+        }
+        namespace FundedBy {
+            interface Platform {
+                /**
+                 * The platform FinancialAccount used to fund this credit FinancialAccount.
+                 */
+                financial_account: string;
+            }
+            type Type = 'platform' | 'stripe';
+        }
+    }
+    namespace Payments {
+        interface BalanceByFundsType {
+            /**
+             * Payment processing funds are those that are received for goods or services and may only be used for payouts to self. These funds may be converted to stored value funds.
+             */
+            payment_processing: BalanceByFundsType.PaymentProcessing;
+            /**
+             * Stored value funds may be used for either payouts to self or payments to others.
+             */
+            stored_value: BalanceByFundsType.StoredValue;
+        }
+        interface StartingBalance {
+            /**
+             * When the balance was projected.
+             */
+            at: string;
+            /**
+             * The available balance at the time when the balance was projected.
+             */
+            available: {
+                [key: string]: V2Amount;
+            };
+        }
+        namespace BalanceByFundsType {
+            interface PaymentProcessing {
+                /**
+                 * Balance that can be used for money movement.
+                 */
+                available: {
+                    [key: string]: V2Amount;
+                };
+                /**
+                 * Balance of inbound funds that will later transition to the `available` balance.
+                 */
+                inbound_pending: {
+                    [key: string]: V2Amount;
+                };
+                /**
+                 * Balance of funds that are being used for a pending outbound money movement.
+                 */
+                outbound_pending: {
+                    [key: string]: V2Amount;
+                };
+            }
+            interface StoredValue {
+                /**
+                 * Balance that can be used for money movement.
+                 */
+                available: {
+                    [key: string]: V2Amount;
+                };
+                /**
+                 * Balance of inbound funds that will later transition to the `available` balance.
+                 */
+                inbound_pending: {
+                    [key: string]: V2Amount;
+                };
+                /**
+                 * Balance of funds that are being used for a pending outbound money movement.
+                 */
+                outbound_pending: {
+                    [key: string]: V2Amount;
+                };
+            }
+        }
+    }
+    namespace StatusDetails {
+        interface Closed {
+            /**
+             * The forwarding settings for the closed FinancialAccount.
+             */
+            forwarding_settings?: Closed.ForwardingSettings;
+            /**
+             * The reason the FinancialAccount was closed.
+             */
+            reason: Closed.Reason;
+        }
+        namespace Closed {
+            interface ForwardingSettings {
+                /**
+                 * The address to send forwarded payments to.
+                 */
+                payment_method?: string;
+                /**
+                 * The address to send forwarded payouts to.
+                 */
+                payout_method?: string;
+            }
+            type Reason = 'account_closed' | 'closed_by_platform' | 'other';
+        }
+    }
+    namespace Storage {
+        type FundsUsageType = 'business' | 'consumer';
+    }
+}
+export declare namespace V2 {
+    namespace MoneyManagement {
+        interface FinancialAccountCreateParams {
+            /**
+             * The type of FinancialAccount to create.
+             */
+            type: FinancialAccountCreateParams.Type;
+            /**
+             * A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.
+             */
+            display_name?: string;
+            /**
+             * Metadata associated with the FinancialAccount.
+             */
+            metadata?: MetadataParam;
+            /**
+             * Parameters specific to creating `storage` type FinancialAccounts.
+             */
+            storage?: FinancialAccountCreateParams.Storage;
+        }
+        namespace FinancialAccountCreateParams {
+            type Type = 'credit' | 'storage';
+            interface Storage {
+                /**
+                 * The usage type for funds in this FinancialAccount. Can be used to specify that the funds are for Consumer activity.
+                 */
+                funds_usage_type?: Storage.FundsUsageType;
+                /**
+                 * The currencies that this FinancialAccount can hold.
+                 */
+                holds_currencies: Array<string>;
+            }
+            namespace Storage {
+                type FundsUsageType = 'business' | 'consumer';
+            }
+        }
+    }
+}
+export declare namespace V2 {
+    namespace MoneyManagement {
+        interface FinancialAccountRetrieveParams {
+            /**
+             * Additional fields to include in the response.
+             */
+            include?: Array<'payments.balance_by_funds_type'>;
+        }
+    }
+}
+export declare namespace V2 {
+    namespace MoneyManagement {
+        interface FinancialAccountUpdateParams {
+            /**
+             * A descriptive name for the FinancialAccount, up to 50 characters long. This name will be used in the Stripe Dashboard and embedded components.
+             */
+            display_name?: string;
+            /**
+             * Metadata associated with the FinancialAccount.
+             */
+            metadata?: MetadataParam;
+            /**
+             * Parameters for updating storage-specific fields on the FinancialAccount.
+             */
+            storage?: FinancialAccountUpdateParams.Storage;
+        }
+        namespace FinancialAccountUpdateParams {
+            interface Storage {
+                /**
+                 * The currencies that this storage FinancialAccount can hold a balance in. Three-letter ISO currency code, in lowercase.
+                 * Adding currencies requires the corresponding holds_currencies storer capabilities to be enabled.
+                 * Removing currencies is not supported as of March 2026.
+                 */
+                holds_currencies?: Array<string>;
+            }
+        }
+    }
+}
+export declare namespace V2 {
+    namespace MoneyManagement {
+        interface FinancialAccountListParams {
+            /**
+             * Additional fields to include in the response.
+             */
+            include?: Array<'payments.balance_by_funds_type'>;
+            /**
+             * The page limit.
+             */
+            limit?: number;
+            /**
+             * Filter for FinancialAccount `status`. By default, closed FinancialAccounts are not returned.
+             */
+            statuses?: Array<FinancialAccountListParams.Status>;
+            /**
+             * Filter for FinancialAccount `type`. By default, FinancialAccounts of any `type` are returned.
+             */
+            types?: Array<FinancialAccountListParams.Type>;
+        }
+        namespace FinancialAccountListParams {
+            type Status = 'closed' | 'open' | 'pending';
+            type Type = 'accrued_fees' | 'credit' | 'multiprocessor_settlement' | 'payments' | 'storage';
+        }
+    }
+}
+export declare namespace V2 {
+    namespace MoneyManagement {
+        interface FinancialAccountCloseParams {
+            /**
+             * The addresses to forward any incoming transactions to.
+             */
+            forwarding_settings?: FinancialAccountCloseParams.ForwardingSettings;
+        }
+        namespace FinancialAccountCloseParams {
+            interface ForwardingSettings {
+                /**
+                 * The address to send forwarded payments to.
+                 */
+                payment_method?: string;
+                /**
+                 * The address to send forwarded payouts to.
+                 */
+                payout_method?: string;
+            }
+        }
+    }
+}

package/cjs/resources/V2/MoneyManagement/FinancialAccounts.js

@@ -0,0 +1,50 @@
+"use strict";
+// File generated from our OpenAPI spec
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FinancialAccountResource = void 0;
+const StripeResource_js_1 = require("../../../StripeResource.js");
+const Statements_js_1 = require("./FinancialAccounts/Statements.js");
+class FinancialAccountResource extends StripeResource_js_1.StripeResource {
+    constructor(stripe) {
+        super(stripe);
+        this.stripe = stripe;
+        this.statements = new Statements_js_1.StatementResource(stripe);
+    }
+    /**
+     * Lists FinancialAccounts in this compartment.
+     */
+    list(params, options) {
+        return this._makeRequest('GET', '/v2/money_management/financial_accounts', params, options, {
+            methodType: 'list',
+        });
+    }
+    /**
+     * Creates a new FinancialAccount.
+     * @throws Stripe.AlreadyExistsError
+     * @throws Stripe.FeatureNotEnabledError
+     */
+    create(params, options) {
+        return this._makeRequest('POST', '/v2/money_management/financial_accounts', params, options);
+    }
+    /**
+     * Retrieves the details of an existing FinancialAccount.
+     */
+    retrieve(id, params, options) {
+        return this._makeRequest('GET', `/v2/money_management/financial_accounts/${encodeURIComponent(id)}`, params, options);
+    }
+    /**
+     * Updates an existing FinancialAccount.
+     */
+    update(id, params, options) {
+        return this._makeRequest('POST', `/v2/money_management/financial_accounts/${encodeURIComponent(id)}`, params, options);
+    }
+    /**
+     * Closes a FinancialAccount with or without forwarding settings.
+     * @throws Stripe.NonZeroBalanceError
+     */
+    close(id, params, options) {
+        return this._makeRequest('POST', `/v2/money_management/financial_accounts/${encodeURIComponent(id)}/close`, params, options);
+    }
+}
+exports.FinancialAccountResource = FinancialAccountResource;
+//# sourceMappingURL=FinancialAccounts.js.map

package/cjs/resources/V2/MoneyManagement/FinancialAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinancialAccounts.js","sourceRoot":"","sources":["../../../../src/resources/V2/MoneyManagement/FinancialAccounts.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAEvC,kEAA0D;AAI1D,qEAAoE;AAEpE,MAAa,wBAAyB,SAAQ,kCAAc;IAG1D,YAA6B,MAAc;QACzC,KAAK,CAAC,MAAM,CAAC,CAAC;QADa,WAAM,GAAN,MAAM,CAAQ;QAEzC,IAAI,CAAC,UAAU,GAAG,IAAI,iCAAiB,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IACD;;OAEG;IACH,IAAI,CACF,MAAsD,EACtD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,yCAAyC,EACzC,MAAM,EACN,OAAO,EACP;YACE,UAAU,EAAE,MAAM;SACnB,CACK,CAAC;IACX,CAAC;IACD;;;;OAIG;IACH,MAAM,CACJ,MAAuD,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,yCAAyC,EACzC,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,QAAQ,CACN,EAAU,EACV,MAA0D,EAC1D,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,KAAK,EACL,2CAA2C,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACnE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;OAEG;IACH,MAAM,CACJ,EAAU,EACV,MAAwD,EACxD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,2CAA2C,kBAAkB,CAAC,EAAE,CAAC,EAAE,EACnE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;IACD;;;OAGG;IACH,KAAK,CACH,EAAU,EACV,MAAuD,EACvD,OAAwB;QAExB,OAAO,IAAI,CAAC,YAAY,CACtB,MAAM,EACN,2CAA2C,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EACzE,MAAM,EACN,OAAO,CACD,CAAC;IACX,CAAC;CACF;AAtFD,4DAsFC"}

package/cjs/resources/V2/MoneyManagement/FinancialAddressDebitSimulations.d.ts

@@ -0,0 +1,14 @@
+export interface FinancialAddressDebitSimulation {
+    /**
+     * String representing the object's type. Objects of the same type share the same value of the object field.
+     */
+    object: 'v2.money_management.financial_address_debit_simulation';
+    /**
+     * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+     */
+    livemode: boolean;
+    /**
+     * The status of the request, signifying whether a simulated debit was initiated.
+     */
+    status: string;
+}

package/cjs/resources/V2/MoneyManagement/FinancialAddressDebitSimulations.js

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

package/cjs/resources/V2/MoneyManagement/FinancialAddressDebitSimulations.js.map

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