Early funds withdrawal

Relevant webhooks

For this endpoint be sure you have registered for this webhook:

Core.TimeDeposit.Withdrawn

API reference

Requests to withdraw the funds from a time deposit (CD) account before the account reaches maturity. Depending on the setting of the waivePenaltyFee attribute, the penalty fee is either waived or not. If the penalty fee for early withdrawal is waived, it is as if the account owner performs a partial withdrawal of funds.

Actual withdrawal of the funds requires a transaction call, which will in turn trigger the Core.TimeDeposit.Withdrawn webhook event.

Endpoint: /core/v1/dda/accounts/{accountNumber}/time-deposit/early-withdraw

POST

https://sandbox.crbcos.com/core/v1/dda/accounts/{accountNumber}/time-deposit/early-withdraw

Path Parameters

accountNumberstringrequired
Description
Account number of the time deposit account

Body Parameters

waivePenaltyFeebooleanrequired
Description
If true, a request for early withdrawal will be processed without a penalty fee. Otherwise, false.

Response

masterAccountNumberstring
Description
The account number of the time deposit account
statusstring
Description
Status of the account: - Funding - Active - Matured - EarlyWithdrawal - Inactive
minFundingAmountinteger
Description
Minimum dollar amount allowed for the time deposit. If the deposit amount is less than this value the deposit will be rejected.
maxFundingAmountinteger
Description
Maximum dollar amount allowed for the time deposit. If the deposit amount is more than this value the deposit will be rejected.
autoCloseboolean
Description
True if the time deposit account automatically closes if not sufficiently funded by the funding expiration date. Otherwise, false.
allowBumpUpboolean
Description
True if the Interest Rates Period tier(s) are enabled, where applicable. Otherwise, false.
waivePenaltyFeeboolean
Description
If true, a request for early withdrawal will be processed without a penalty fee. Otherwise, false.
fundingDaysinteger
Description
Number of days the time deposit will remain active once opened but not yet funded
gracePeriodDaysinteger
Description
Number of days the customer has to withdraw the time deposit once it reaches maturity. If no action is taken during this time then the time deposit will automatically renew for the same term at the rate currently being offered for the term.
currentRatenumber
Description
The current rate of interest being earned by the account
maturityMonthsinteger
Description
Number of months until the time deposit reaches maturity
ratesobject
Description
Interest rate details
- monthsinteger
  Description
  Defines the number of months the given rate is valid
- ratenumber
  Description
  Interest rate of the CD
penaltiesobject
Description
Details of the penalty your customer pays for early withdrawal
- monthsinteger
  Description
  Early withdrawal within this number of months results in a penalty. Cross River works with you to configure this number for the CD product.
- feeDaysinteger
  Description
  How many days of simple interest to assess
fundingExpDatestring
Description
Based on the product configuration, the date by which the account must be funded. if it isn't funded, it's deactivated. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
fundingDatestring
Description
Date account is funded. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
startDatestring
Description
Date the account starts accruing interest. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
depositAmountinteger
Description
Amount deposited to fund the account
depositCurrencystring
Description
Currency used for the deposit
maturityDatestring
Description
Calendar date when the account can be withdrawn. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
earlyWithdrawnAtstring
Description
Date of early withdrawal. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
rolloverDatestring
Description
Date the time deposit account rolls over (and withdrawal without penalty no longer possible). In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
createdAtstring
Description
Account created. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]
productIdstring
Description
ID in GUID format of your specific product type on which the account is based. Provided by Cross River. In this case, your configured time deposit product.
partnerIdstring
Description
Your unique ID in the Cross River system. This ID is in GUID format.
lastModifiedAtstring
Description
Internal Cross River value. Date and time the database entry was last modified. In this case, the date and time are in this format: yyyy-mm-ddThh:mm:ss[.mmm]

curl

curl --location 'https://sandbox.crbcos.com/core/v1/dda/accounts/190432130358/time-deposit/early-withdraw' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "waivePenaltyFee": true
}'

nodejs

var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'POST',
  'hostname': 'sandbox.crbcos.com',
  'path': '/core/v1/dda/accounts/190432130358/time-deposit/early-withdraw',
  'headers': {
    'Authorization': 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

var postData = JSON.stringify({
  "waivePenaltyFee": true
});

req.write(postData);

req.end();

python

import http.client
import json

conn = http.client.HTTPSConnection("sandbox.crbcos.com")
payload = json.dumps({
  "waivePenaltyFee": True
})
headers = {
  'Authorization': 'Bearer <token>',
  'Content-Type': 'application/json'
}
conn.request("POST", "/core/v1/dda/accounts/190432130358/time-deposit/early-withdraw", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://sandbox.crbcos.com/core/v1/dda/accounts/190432130358/time-deposit/early-withdraw")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer <token>"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "waivePenaltyFee": true
})

response = https.request(request)
puts response.read_body

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://sandbox.crbcos.com/core/v1/dda/accounts/190432130358/time-deposit/early-withdraw"
  method := "POST"

  payload := strings.NewReader(`{
  "waivePenaltyFee": true
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

200

{
    "timeDeposit": {
        "masterAccountNumber": "190432130358",
        "status": "EarlyWithdrawal",
        "minFundingAmount": 50000,
        "maxFundingAmount": 5000000,
        "autoClose": false,
        "allowBumpUp": false,
        "waivePenaltyFee": true,
        "fundingDays": 3,
        "gracePeriodDays": 6,
        "currentRate": 0.0,
        "maturityMonths": 12,
        "rates": [
            {
                "months": 3,
                "rate": 4.00000
            },
            {
                "months": 3,
                "rate": 6.00000
            },
            {
                "months": 3,
                "rate": 8.00000
            },
            {
                "months": 3,
                "rate": 10.00000
            }
        ],
        "penalties": [
            {
                "months": 6,
                "feeDays": 3
            },
            {
                "months": 6,
                "feeDays": 3
            }
        ],
        "fundingExpDate": "2025-07-03T00:00:00-04:00",
        "fundingDate": "2025-07-01T00:00:00-04:00",
        "startDate": "2025-07-01T00:00:00-04:00",
        "depositAmount": 1000000,
        "depositCurrency": "usd",
        "maturityDate": "2026-06-30T00:00:00-04:00",
        "earlyWithdrawnAt": "2025-07-02T03:21:07.3293384-04:00",
        "rolloverDate": "2026-07-03T00:00:00-04:00",
        "createdAt": "2025-06-30T03:57:49.4-04:00",
        "productId": "be8300b4-1206-4cf9-8800-b30100b7a867",
        "partnerId": "cd9c12f4-7691-424a-b38b-af5b0134c611",
        "lastModifiedAt": "2025-07-02T03:21:07.3293384-04:00"
    },
    "penaltyAccountNumber": "00000098764",
    "penaltyFeeAmount": 329
}