Add Bank Account Details

Request/Response & Json Schema

Overview

Add bank account chain will add an account within the ALIP system the account number added must have a valid ABA number of the bank. In case if the ABA number added is invalid there will be validation error message saying “Invalid ABA number” provided be displayed.

If the account number is successfully added within the system a success response will be returned, Also in case of any processing failure an error response will be returned.

The System will also able to add Card details at the PaymentSource Level.

Technical Requirements

TR ID# Technical Requirements
TR1 ACORDv2.36 shall be used to communicate.
TR2 ACORD Tx 502 “Holding Product Inquiry Transaction tc=502” is being used for Adding a bank account and its details
TR3 Interface must always return an error code and desc in the event of a processing failure in addition to HTTP response code.
TR4 For a success, the response will be a success message and the requested bank account will be deleted.

Business Requirements

BR ID# Business Requirements
BR1 Add Bank Account should add the Bank Account and its details within the ALIP system.
BR2 The Bank Account should have a valid ABA number else ABA number validation should provide an error message for invalid ABA number
BR3 The Bank Account added will be added at the cutomer level banking.

Impact on ALIP system

N/A

Assumptions

The Bank account added should have a valid ABA number.

The Bank account added will be added at customer level and not at the policy level banking.

The client id passed belongs to an individual type client present within the ALIP system. There is no support for company or trust type clients.

Dependencies

N/A

Request Parameters Description Mandatory Allowed values

Request Data Elements

Success/Error Handling

Success Success Scenario Description Message Code Message Description Message Type Additional Comments
#1 The get available transaction for contract call was successful with details being returned in the output 1 Success Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =1

Error Error Scenario Description Message Code Message Description Message Type Additional Comments
#2 The get available transaction for contract call was NOT successful due to a technical error or contract not found. 5 Internal Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5