Accounts
Withdraw CD funds early
3 min
in this tutorial, you'll learn how to ✅ request early withdrawal ✅ determine how much to withdraw from the account after the penalty fee is deducted this tutorial assumes you have a knowledge of apis and how they work for more information on sending api calls, see structure learn more about certificate of deposit (cd) the tutorial uses these endpoints api description withdraw funds early from a cd this endpoint requests early withdrawal from a time deposit account get /core/v1/accounts/{accountnumber} this endpoint queries a specific account for information about it the tutorial uses these webhooks true false 248false unhandled content type false unhandled content type false unhandled content type false unhandled content type before you begin make sure you have quickstart account number register relevant webhook events to receive the webhook events for this tutorial both partner accounts need to accounts, cards and payment events each specific webhook event type once you are registered, the event objects are sent to the registered urls the event object contains a list of resource identifiers used to download details on each event request time deposit early withdrawal before an account holder can actually withdraw funds from a time account that hasn't reached maturity, you have to make a request (for the account holder) to make that early withdrawal in the request you also indicate if the withdrawal will trigger a penalty fee or not cross river charges a penalty fee for early withdrawal, although in some cases it can be waived for example, cross river time deposit accounts have no provisions for partial withdrawals however, in certain circumstances, an account holder can be allowed to make an early withdrawal of the money in the account without penalty, which is similar to a partial withdrawal note that a request for early withdrawal does not remove funds from the account that is a separate call in this tutorial, you will request an early withdrawal with a penalty fee to request early withdrawal call post /v1/dda/accounts/{accountnumber}/time deposit/early withdraw for this call, some/all withdraw funds early from a cd are required set the waivepenaltyfee attribute to false ) https //sandbox crbcos com/core/v1/dda/accounts/2434508988/time deposit/early withdraw { "waivepenaltyfee" false } a successful api call returns a json response with the details of account, including the total funds to be withdrawn and the amount of penalty fee charged in our example, the total deposit amount is 1,000,000 00 the penalty fee amount is 4,109 59 { "timedeposit" { "masteraccountnumber" "2434508988", "status" "earlywithdrawal", "minfundingamount" 50000000, "maxfundingamount" 1000000000, "autoclose" true, "allowbumpup" true, "waivepenaltyfee" false, "fundingdays" 2, "graceperioddays" 2, "currentrate" 0, "maturitymonths" 12, "rates" \[ { "months" 6, "rate" 5 }, { "months" 6, "rate" 2 5 } ], "penalties" \[ { "months" 3, "feedays" 30 }, { "months" 9, "feedays" 90 } ], "fundingexpdate" "2023 01 17t00 00 00 05 00", "fundingdate" "2023 01 12t00 00 00 05 00", "startdate" "2023 01 12t00 00 00 05 00", "depositamount" 100000000, "depositcurrency" "usd", "maturitydate" "2024 01 11t00 00 00 05 00", "earlywithdrawnat" "2023 03 08t09 57 00 005123 05 00", "rolloverdate" "2024 01 16t00 00 00 05 00", "createdat" "2023 01 12t16 45 45 96 05 00", "productid" "3c4e1c34 3544 4236 93a5 af110157167c", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "lastmodifiedat" "2023 03 08t09 57 00 0208451 05 00" }, "penaltyaccountnumber" "20020020028", "penaltyfeeamount" 410959 } to see amount available call get /core/v1/accounts/{accountnumber} to see the balance that remains in the account after deducting the penalty this is the sum you will withdraw you must transfer the entire amount transfer the funds as you would any money transfer withdrawal of the funds triggers the core timedeposit withdrawn webhook event core timedeposit withdrawn webhook event { "id" "90cef2a8 f3e1 41ff 9394 afbf00f8a406", "eventname" "core timedeposit withdrawn", "status" "pending", "partnerid" "1e5d3f04 ae24 4af6 9e30 aecf012b99dd", "createdat" "2023 03 08t10 05 16 423 05 00", "resources" \[ "core/v1/dda/accounts/2434508988/time deposit" ], "details" \[ { "masteraccountnumber" "2434508988", "status" "earlywithdrawal", "depositamount" "100023362", "maturitydate" "3/14/2023", "rolloverdate" "3/19/2023", "currentrate" "0 0" } ] }