Account management
Early withdrawal from a CD
3min
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 if you are new to account management we recommend you read the account management docid\ dtshf52ayohqs2tku09el before starting this tutorial the tutorial assumes you have a knowledge of apis and how they work for more information on sending api calls, see the api basics docid\ hjr4y6ml96zuyj6trytom the tutorial uses these api endpoints api description account management docid\ yzz6gp6w98rudtrapzpov 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 webhook description core timedeposit withdrawn shows information about the account the early withdrawal request was made to ach payment receivedearly before you begin make sure you have api basics docid\ hjr4y6ml96zuyj6trytom account number register the relevant webhook events to receive the webhook events for this tutorial both partner accounts need to banking and payments docid\ dgnysfx9f7pnesmuxnwsp 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 early withdrawal of funds from a time deposit account 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 cr 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 attributes are required a full list of attributes is found account management docid\ yzz6gp6w98rudtrapzpov 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 the amount available for withdrawal 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" } ] }