Accounts

Subledgers

4min

Cross River COS offers the APIs to create subledgers instantly and on-demand. A subledger can be linked to any existing deposit account, also known as the master account.

In subledger API endpoints, subledgers are referred to as subaccounts , For example, POST /core/v1/dda/subaccounts creates a new subledger.

This table presents the subledger management APIs we describe in detail.

Action

API Call

Description

POST /core/v1/dda/subaccounts



Creates a new subledger

GET /core/v1/dda/subaccounts/{accountNumber}

Returns information on a specific subledger account

Create a subledger

Creates a subledger for the specified Master Account.

POST
Request
Response
Body Parameters
masterAccountNumber
required
String
Master account to open the subledger under
title
required
String
The account title. 255 character limit.
customerId
optional
String
The unique ID assigned to a customer when the customer record is created (POST /core/v1/cm/customers). You need this ID to take action for a specific customer. For example, when opening an account or adding an address to a customer record. The ID is in GUID format.
beneficiary
optional
Object
Beneficiary profile for this subledger
clientIdentifier
optional
String
Use this attribute to add your own unique identifying string to a payment call or COS record. This attribute is useful for idempotency purposes.


Get information on a specific subledger

Returns information on a specific subledger account

GET
Request
Response
Path Params
accountNumber
required
String
Sub account number to retrieve


Associated webhook events

Event Name

Description

Core.SubAccount.Opened

Subledger (subaccount) was opened

Core.SubAccount.Status.Changed

Status of a subledger (subaccount) changed

Core.SubAccount.Closed

Subledger (subaccount) was closed

Core.SubAccount.Title.Changed

Title of subledger (subaccount) changed



🤔
Have a question?
Our super-smart AI, knowledgeable support team and an awesome community will get you an answer in a flash.
To ask a question or participate in discussions, you'll need to authenticate first.



Updated 30 Sep 2024
Doc contributor
Doc contributor
Did this page help you?