ID
: This unique identifier is used to distinguish the account within the Connectivity service.Reference
: The account reference on the payments provider, which helps link it to the appropriate transactions.Provider
: The payment provider associated with the accountType
: This field indicates the type of the account, which can be either INTERNAL or EXTERNAL (c.f. below)CreatedAt
: This field displays the date and time of the account’s creation on the payments provider, allowing users to track the account’s history.DefaultAsset
: While optional, this field allows users to specify a default asset for the account, streamlining transactions and providing convenience.AccountName
: Also optional, this field enables users to assign a name to the account, making it easier to identify and manage.
How to fetch and see accounts list
Formance console
On the Formance Console, you can easily access the complete list of accounts by simply clicking on theAccounts
tab located on the left-hand side of the menu. This intuitive interface allows you to conveniently view all the necessary information related to each account with just a few clicks.
By clicking on the View
button situated on the right side of each account, you can delve deeper into the details of that specific account. This provides you with a comprehensive overview of the account, including essential information such as the default asset associated with it and the current balance.
With this user-friendly feature, you can effortlessly navigate through the Formance Console and gain a thorough understanding of your accounts, enabling you to make informed decisions based on the detailed information provided.


API
You can also use the API to fetch the list of accounts using FCTL.Internal Accounts
An INTERNAL account, which refers to a user’s digital e-wallet, serves as a secure storage for funds within the payments provider environment. In addition to its primary purpose, an INTERNAL account offers versatile functionality, allowing users to perform the following actions:- Transfer funds from one INTERNAL account to another INTERNAL account (Transfer)
- Withdraw funds from an INTERNAL account to an EXTERNAL account (Payout)
External Accounts
Accounts with the type ‘EXTERNAL’ represent actual bank accounts of the user and are required for the following purposes:- Facilitating the transfer of funds from an INTERNAL account to an EXTERNAL account (referred to as a “Payout”).
External Accounts creation
You can utilize Formance’s Connectivity service to effortlessly create EXTERNAL accounts on the various associated providers. These providers include beneficiaries and recipient accounts, depending on the specific providers you choose. In order to create an External Account, you can only do it via the API for the moment while waiting for the Formance Console to be updated.bank_account.json
containing: