Create a new internal Financial Account for a Customer. The internal Financial Account will use the same currency as the parent Business Financial Account.
Internal Financial Accounts are issued and managed by RocketKOR.
POST /v1/internal-financial-accounts
Authorization: Bearer <access_token>
name REQUIRED
string, min length: 1, max length: 100
Name for the Financial Account. This is an informal name used for the account in RocketKOR.
parentId REQUIRED
string (UUID)
ID of the Parent Financial Account. The internal Financial Account will use the same currency as this account.
defaultFlag
boolean, default: false
Whether this is the default Financial Account for transactions. If set to true, defaultFlag will be set to false for the previous default Financial Account.
currency
string, min length: 3, max length: 3, default value: USD
Currency of the Financial Account. Must be an ISO 4217 alpha 3-character currency code. RocketKOR supports USD and CAD currencies.
accountHolderId REQUIRED
string (UUID)
ID of the entity that owns the Financial Account. The account holder must be a Customer Account.
accountHolderType REQUIRED
string enum, value: CUSTOMER
Type of entity referenced by the accountHolderId field. Value must be CUSTOMER.
subtype
string enum, values: CHECKING, SAVING
Financial Account subtype.
Returns the Internal Financial Account object. This object contains the Financial Account details, including a unique ID for the account.
SAMPLE REQUEST
{
"name": "ABC Internal Account",
"parentId": "4563ee45-446e-4c6e-83d8-2d5767614a5",
"defaultFlag": false,
"currency": "USD",
"accountHolderId": "91365a4a-c040-4c37-bb8a-50f46edde48b",
"accountHolderType": "CUSTOMER",
"subtype": "CHECKING"
}
SAMPLE RESPONSE
{
"id": "6a46f27a-7bbc-4ba8-9e73-45c74139fd81",
"parentId": "4563ee45-446e-4c6e-83d8-2d5767614a5",
"businessAccountId": "2af56dc3-63ff-4e86-ba5b-bf6d184a103c",
"name": "ABC Internal Account",
"category": "INTERNAL",
"type": "BANK",
"subtype": "CHECKING",
"defaultFlag": "false",
"currency": "USD",
"accountHolderId": "91365a4a-c040-4c37-bb8a-50f46edde48b",
"accountHolderType": "CUSTOMER",
"state": "ACTIVE",
"maskedAccountNumber": "******6790",
"createdBy": {
"id": "59dff46b-03d3-449b-89bf-b8010770864f",
"type": "employee"
},
"createdAt": "2021-09-20T22:09:31.947Z",
"updatedBy": {
"id": "59dff46b-03d3-449b-89bf-b8010770864f",
"type": "employee"
},
"updatedAt": "2021-10-20T22:09:31.947Z"
}
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.