Account management
Open a deposit account
6min
cr provides a number of different types of deposit accounts, including ddas and certificates of deposit (cds or time deposit accounts) to open any kind of deposit account you must have a valid product id for the type of account you want to open, and a customer id (onboarded customer record id) for the account holder note that the account holder must have at least one address and phone number in their customer record, and their ofac status must be clear in addition, the classification of the customer must match the configured classification for the product for example, only business customers can be added to a business product in this tutorial, you'll learn how to ✅ open a customer master account if you are new to account management we recommend you read the account management docid\ dtshf52ayohqs2tku09el documentation before starting this tutorial the tutorial assumes you have a knowledge of apis and how they work refer to the api basics docid\ hjr4y6ml96zuyj6trytom for more details the tutorial uses these api endpoints api description account management docid\ yzz6gp6w98rudtrapzpov opens a deposit account for a customer the tutorial uses these webhooks webhook description core account opened a new account was opened before you begin make sure you have api basics docid\ hjr4y6ml96zuyj6trytom partner id onboard a customer docid\ njfm wjxq0eokx4pfn3b6 product id (defines the type of account being opened) important we highly recommend you include an idempotency key in your request header to provide duplicate protection in the event of a failure read more about idempotency keys idempotency docid\ jiv0q1 cymjqqger3ijmp 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 open a dda account this tutorial shows you how to create a deposit account in this scenario, you'll open an account for jana parker, a customer who you successfully onboarded closed accounts can only be re opened by the cr ops teams to re open an account please open a support ticket https //crossriver service now\ com/csm?id=cos sandbox request form\&sys id=713de878c300b5105d3eafdc7a013184\&sysparm category=df09f2623310c2906b697d934d5c7b4a to open an account call post /v1/dda/accounts for this call, some attributes are required a full list of attributes is found account management docid\ yzz6gp6w98rudtrapzpov sample request post /core/v1/dda/accounts { "customerid" "59e3bc15 bbec 4990 88e9 a9a600d3296c", "productid" "44015e68 1afb 40fc 9497 abc1014f52da", "title" "jana parker", "statementaddress" { "street1" "257 dalton groves", "city" "barton city", "state" "mi", "postalcode" "48705", "countrycode" "us" } } a successful api call returns a json response with the details of the new account sample response post /core/v1/dda/accounts { "customerid" "59e3bc15 bbec 4990 88e9 a9a600d3296c", "productid" "44015e68 1afb 40fc 9497 abc1014f52da", "title" "jana parker", "statementaddress" { "street1" "257 dalton groves", "city" "barton city", "state" "mi", "postalcode" "48705", "countrycode" "us" } } the accountnumber field provides the account number for the new account in the response example, the account is classified as personal because the user configured the product classification as personal the account classification always matches the configured product classification the account status is automatically updated to active , and is immediately available for use this triggers the core account opened event core account opened event details { "id" "259cdbca 6a89 4af8 a50e ada3010fb13f", "eventname" "core account opened", "status" "pending", "partnerid" "e6c3824a 377f 44d5 a2f6 a9a600c9b37e", "createdat" "2021 01 26t09 48 10 1011462 05 00", "resources" \[ "core/v1/dda/accounts/2235223803" ], "details" \[] }