Update Bank Account Details

Request/Response & Json Schema

Overview

Update bank account chain will update an account within the ALIP system the account number updated 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.

Using Update Bank Account interface we can update both premium bank and customer level banking for the client id.

The System will also able to update 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 getting the available funds 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 provide the available funds and its details.

Business Requirements

BR ID# Business Requirements
BR1 Update Bank Account should update 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 updated will be at the cutomer level banking or policy level.
BR4 The premium and disbursement bank account can be updated at the using update bank account interface.
BR5 The Bank Account can be updated at the cutomer level banking or policy level.
BR6 A same bank account associated at the customer level and at the policy level should be updated at both the places in case its update from customer or policy level.

Impact on ALIP system

N/A

Assumptions

A same bank account associated at the customer level and at the policy level should be updated at both the places in case its update from customr or policy level.

The Bank Account can be updated will be at the cutomer level banking or policy level.

There is no valdation for account number and bank name assuming that valid details will be provided for the same.

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

The Client id and the related data to be updated should be available within the ALIP system.

Request Data Elements

Success/Error Handling

Success Success Scenario Description Message Code Message Description Message Type Additional Comments
#1 Update Banking 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 Update Banking call was NOT successful due to a technical error. 5 Internal Error Informational TXLife/TXLifeResponse/TransResult/ResultCode/@tc =5