Financial Accounts
Stripe Treasury provides users with a container for money called a FinancialAccount that is separate from their Payments balance. FinancialAccounts serve as the source and destination of Treasury’s money movement APIs.
The FinancialAccount object
Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- active_
featuresarray of enums The array of paths to active Features in the Features hash.
- balanceobject
The single multi-currency balance of the FinancialAccount. Positive values represent money that belongs to the user while negative values represent funds the user owes. Currently, FinancialAccounts can only carry balances in USD.
- countrystring
Two-letter country code (ISO 3166-1 alpha-2).
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- featuresnullable objectExpandable
The features and their statuses for this FinancialAccount.
- financial_
addressesarray of objects The set of credentials that resolve to a FinancialAccount.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadatanullable object
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- pending_
featuresarray of enums The array of paths to pending Features in the Features hash.
- platform_
restrictionsnullable object The set of functionalities that the platform can restrict on the FinancialAccount.
- restricted_
featuresarray of enums The array of paths to restricted Features in the Features hash.
- statusenum
The enum specifying what state the account is in.
- status_
detailsobject Details related to the status of this FinancialAccount.
- supported_
currenciesarray of enums The currencies the FinancialAccount can hold a balance in. Three-letter ISO currency code, in lowercase.
Create a FinancialAccount
Creates a new FinancialAccount. For now, each connected account can only have one FinancialAccount.
Parameters
- supported_
currenciesarray of stringsRequired The currencies the FinancialAccount can hold a balance in.
- featuresobject
Encodes whether a FinancialAccount has access to a particular feature. Stripe or the platform can control features via the requested field.
- metadataobject
Set of key-value pairs 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
. - platform_
restrictionsobject The set of functionalities that the platform can restrict on the FinancialAccount.
Returns
Returns a FinancialAccount object.
Update a FinancialAccount
Updates the details of a FinancialAccount.
Parameters
- featuresobject
Encodes whether a FinancialAccount has access to a particular feature, with a status enum and associated
status_details
. Stripe or the platform may control features via the requested field. - metadataobject
Set of key-value pairs 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
. - platform_
restrictionsobject The set of functionalities that the platform can restrict on the FinancialAccount.
Returns
Returns a FinancialAccount object.
Retrieve a FinancialAccount
Retrieves the details of a FinancialAccount.
Parameters
No parameters.
Returns
Return a FinancialAccount object.