Issue a Bank Account

Issue a new bank account for a Customer.

Endpoint

POST /v1/integrated-bank-accounts

Authorization Header

Authorization: Bearer <access_token>

Request Body

name REQUIRED

string, max length: 100, min length: 1

Name for the Financial Account. This is an informal name used for the account in RocketKOR.

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, max length: 3, min length: 3

default: 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 can be a Customer.

accountHolderType REQUIRED

string enum, values: CUSTOMER

Type of entity referenced by the accountHolderId field.

subtype REQUIRED

string enum, values: CHECKING, SAVING

Financial Account subtype. BANK accounts can have a subtype of CHECKING or SAVING.

Returns

Returns the Financial Account details, including a unique ID for the account. For details, see the Bank Financial Account object.

SAMPLE REQUEST

				
					{
  "name": "Checking",
  "defaultFlag": true,
  "currency": "USD",
  "subtype": CHECKING,
  "accountHolderId": "7e86f2d3-1161-4b0f-b309-6e830575c467",
  "accountHolderType": "CUSTOMER"
}

SAMPLE RESPONSE

				
					{
  "id": "8th32z87-3845-9810-v7gu-1f827g98swk3",
  "parentId": "",
  "businessAccountId": "a1d8b427-d2b2-4711-bc10-f515366bb8d6",
  "category": "INTEGRATED",
  "type": "BANK",
  "subtype": "CHECKING",
  "name": "Checking",
  "defaultFlag": true,
  "currency": "USD",
  "maskedAccountNumber": "******4523",
  "accountHolderId": "7e86f2d3-1161-4b0f-b309-6e830575c467",
  "accountHolderType": "CUSTOMER",
  "state": "ACTIVE",
  "createdAt": "2022-06-02T19:03:00.964Z",
  "updatedAt": "2022-06-02T19:03:00.964Z",
  "bankAccount": {
    "bankName": "CitiBank",
    "routingNo": "321171184",
    "accountNumber": "89674523",
    "accountNumberTail": "4523",
    "nameOnAccount": "Mark Strong",
    "businessName": "GLOBAL"
  }
}