Class StartSessionRequest
Required Fields
| Name | Description | Required | Example |
|---|---|---|---|
| rtn | Institution's Routing Number | Y | rtn=123456789 |
| user fI number | Number that the FI uses to identify the EU. This is the equivalent of the Account Holder Number for mobile, it is the unique identifier for the user. Ideally, you would use the same value that would be used for Mobile. (The advantage of using same value is that we have the ability to do shared limits and shared history between Mobile and My Deposit/Merchant if the same value is used.) | Y | user_fi_number=44325 |
| ANUM | This is the account number that the FI uses to identify the account | Y | ANUM1=111222 ANUM2=333444 |
| ADSC | The account description/name (ex: “Personal Checking”) | Y | ADSC1=Primary Checking A DSC2=Primary Savings |
| ATYP | A code that identifies the type of account. Supported values:
| Y | ATYP1=1 ATYP2=0 |
Account Information
The following fields are available for each of the EU's accounts. If there is more than one account, the field names for each account will have a sequential number appended. Account formatting can be found AccountFormat
ADSC1=xxx
ATYP1=xxx
ADSC2=yyy
ATYP2=yyy...
Member Account Dropdown Display Information
The account description cannot be longer than 50 characters. The account number cannot be longer than 22 characters. The description will appear in the dropdown as – “Description” “SubAccount”.
The order in which accounts will appear to the member are by:
- Account Type [Checking, Savings, Loan]
- Description (sorted alphabetically)
- SubAccount Number (sorted numerically)..
- Description (sorted alphabetically)
Sample - Display to the Member
Checking Account 55555555555555
Commercial Checking 11111111111111
Christmas Club 33333333333333
Savings 0 22222222222222
Savings GLD 66666666666666
Loan 2 44444444444444
Joint Account Holder Account Information
The following fields are available for each of the EU's accounts. If there is more than one account holder, the field names for each joint account holder will have a sequential number appended. For example:
- AJOINT1=xxx~yyy
- AJOINT2=xxx~yyy
- AJOINT3=bbb~ccc~ddd
Each account can have multiple Joint Account Holders, which would be separated in the request by a tilde, "~" or "%7E". Only the "~" will return both joint account holders within EZAdmin for review. For example:
AJOINT=John+Smith~Joan+Smith
AJOINT=John+Smith%7EJoan+Smith
For example, AJOINT1=JOHN+H+DOE%7EFRED+BLACK%7EJANE+DOE
Recommended Fields
| NAME | DESCRIPTION | REQUIRED | EXAMPLE |
|---|---|---|---|
| name | The account holder’s name End-user’s full name. May use any configuration. FirstName+LastName is the default. Note: To be used for comparing to the payee name on the check and is also displayed in EZAdmin for proofing. | N | name=TEST+USER |
| AJOINT | The joint account holder name(s). May use any configuration. FirstName+LastName is the default. Note: To be used for comparing to the payee name on the check and is also displayed in EZAdmin for proofing. Only the ~ tilde returns both names in the check deposit log. | N | AJOINT=John+Smith~Joan+ Smith or AJOINT=John+Smith%7EJoan+Smith |
| Used to send email notifications. Note: The My Deposit UI has a field where the user can manually enter their email address, but including email within the SSO would automatically populate this field for the user and would allow them to send the email to a second address if wanted. | N | Email=test@ensenta.com |
Additional Fields
| NAME | DESCRIPTION | EXAMPLE |
|---|---|---|
| Attributes | Name Value pair used to define user segments (controls things such as limits that should be applied and different risk factors). One or more name value pairs separated by a tilda. Work with Ensenta to setup up any new Name:Value pairs. | Attributes= Group:Silver Attributes= Fee:Yes~ AcctGroup:2 |
| Username | End user’s login username. For bRDC Note: Ensure the Username parameter is capitalized. | Auser1 |
| phone | EU phone | 5555555555 |
| city | EU city | SAN+FRANCISCO |
| street | EU street address | 180+California |
| street2 | EU street address 2 | Suite+180 |
| state | EU 2-digit state code | CA |
| zip | EU postal code | 94102 |
| Now | Current time/date (PST) – any time / date format can be supported | 02%2f20%2f2009+14%3a00%3a13 |
| Gmt | Current time/date (GMT) – any time / date format can be supported | 02%2f20%2f2009+22%3a00%3a14 |
| institution_name | Name of financial institution | ACME+CU |
| time_zone | Time zone of financial institution | PST |
| language | Language that end-user has chosen for internet banking (default = en) | en |
| account_number | For future enhancements to display (user friendly) account number. Can be same value as ANUM. | 123456789 |
| type_name | FI Account type name. | Commercial+Checking |
| MICR | Financial Institution MICR number for the account | 22123456789 |
| ASTAT | Current Status of the account
When the value for an account is passed as "0" (or blank) AND the account's ATYP is configured to be allowed on the Ensenta configuration, the account will be made available to the end-user to select in the UI. NOTE: If the Financial Institution is using Shared Branching to post transactions, account eligibility has the additional condition that the account sent in the SSO has a matching ANUM and ATYP as provided back in the Shared Branching Member Inquiry that Ensenta performs. If the value for an account is passed as "1", the account will not be made available to theend-user to select in the UI. Previous versions of this document included additional values; any other value sent not mentioned above will behave the same as passing "1". | 0 |