Create an Internal Financial Account

Create a new internal Financial Account for a Customer. 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.

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.

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",
  "accountHolderId": "91365a4a-c040-4c37-bb8a-50f46edde48b",
  "accountHolderType": "CUSTOMER"
}

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",
  "verificationStatus": "PENDING",
  "verificationMethod": "PRENOTE",
  "createdBy": {
    "id": "59dff46b-03d3-449b-89bf-b8010770864f",
    "type": "employee"
  },
  "createdAt": "2024-09-20T22:09:31.947Z",
  "updatedBy": {
    "id": "59dff46b-03d3-449b-89bf-b8010770864f",
    "type": "employee"
  },
  "updatedAt": "2024-10-20T22:09:31.947Z"
}