Create an Internal Financial Account

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.

Endpoint

POST /v1/internal-financial-accounts

Authorization Header

Authorization: Bearer <access_token>

Request Body

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

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"
}