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

Type of bank 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.

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 rejected the agreement.

Returns

Returns the Integrated 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": "2024-06-14T17:40:50.053942Z"
    }
  ]
}

SAMPLE RESPONSE

				
					{
  "id": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "parentId": "e5f1eb7e-95b5-49c8-80ab-734f988970bc",
  "businessAccountId": "a1d8b427-d2b2-4711-bc10-f515366bb8d6",
  "name": "Checking",
  "category": "INTEGRATED",
  "type": "BANK",
  "subtype": "CHECKING",
  "defaultFlag": true,
  "currency": "USD",
  "accountHolderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "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",
  "bankAccount": {
    "bankName": "Citibank",
    "routingNo": "321171184",
    "accountNumber": "123456784523",
    "accountNumberTail": "4523",
    "nameOnAccount": "Mark Strong"
  }
}