Issue a new bank account for a Customer. A new integrated Financial Account will be created for the issued bank account.
POST /v1/integrated-bank-accounts
Authorization: Bearer <access_token>
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.
respondedAt REQUIRED
string (date-time)
Date and time the Customer accepted or rejeced the agreement.
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"
}
}
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.