RocketKOR

Issue a Bank Account

Issue a new bank account for a Customer. A new integrated Financial Account will be created for the issued bank account.

Endpoint

POST /v1/integrated-bank-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.

subtype  REQUIRED

string enum, values: CHECKING, SAVING

Financial Account subtype.

accountHolderId  REQUIRED

string (UUID)

ID of the Customer Account that owns the Financial Account.

accountHolderType  REQUIRED

string enum, value: CUSTOMER

Type of entity referenced by the accountHolderId field. Value must be CUSTOMER.

acceptanceAgreements  REQUIRED

array

Documents that the Customer must accept before a new bank account can be issued.

documentId  REQUIRED

string

Semantic document ID. Identifies the type of document that the Customer must agree to (example: kor-privacy-policy).

documentVersion  REQUIRED

string

Semantic document version. Identifies the version number of the document that the Customer must agree to.

accepted  REQUIRED

boolean

Whether the Customer accepted the agreement.

  • true  The Customer has accepted the agreement.
  • false  The Customer has rejected the agreement.

respondedAt  REQUIRED

string (date-time)

Date and time the Customer accepted or rejeced the agreement.

Returns

Returns the Bank Financial Account object. This object contains the Financial Account details, including a unique ID for the account.

SAMPLE REQUEST

				
					{
  "name": "Checking",
  "subtype": CHECKING,
  "accountHolderId": "7e86f2d3-1161-4b0f-b309-6e830575c467",
  "accountHolderType": "CUSTOMER",
  "acceptanceAgreements": [
    {
    "documentId": "kor-privacy-policy",
    "documentVersion": "version-1.2.3",
    "accepted": true,
    "respondedAt": "2023-06-14T17:40:50.053942Z"
    }
  ]
}
				
			

SAMPLE RESPONSE

				
					{
  "id": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "businessAccountId": "a1d8b427-d2b2-4711-bc10-f515366bb8d6",
  "name": "Checking",
  "category": "EXTERNAL",
  "type": "BANK",
  "subtype": "CHECKING",
  "defaultFlag": true,
  "currency": "USD",
  "maskedAccountNumber": "******6790",
  "accountHolderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "accountHolderType": "CUSTOMER",
  "state": "ACTIVE",
  "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",
  "bankAccount": {
    "bankName": "CitiBank",
    "routingNo": "321171184",
    "accountNumberTail": "4523"
    "nameOnAccount": "Mark Strong"
  }
}