• Register

Account Update

 

Account Update service is used to update account details. This service is applicable only for Credit Cards. Below are the detailed specifications of this API.

Download

Request Parameters:

Node Child Node   Type Length Description Remarks
header msg_id A/N 12 Unique Source Message ID Mandatory
msg_type String 12 Request Type Default: "TRANSACTION" Mandatory
msg_function String 50 Function name to be used Default: "REQ_ACCOUNT_UPDATE " Mandatory
src_application String 10 Source requesting channel Ex: IVR. Mandatory
target_application String 10 Target application name Ex. : "PCMS" Mandatory
timestamp String 30 Timestamp of the request Format  “DD/MM/YYYY HH:MM:SS” Mandatory
tracking_id String 15 Transaction Tracking Id Optional
bank_id String 4 Source Bank Id Ex: bankID Mandatory
body account_number String 64 Account contract Mandatory 
card_type String 7

Values are restricted

PREPAID

CREDIT

DEBIT

Mandatory 
  account customer_id String 20 CIF ID (This can not be update) Mandatory
branch_code String 10 Branch Code ex: "XXXX" Mandatory
account_number String 64 Account contract (This can not be updated) Mandatory
account_type String 10 Account type Eg: SAVING, CURRENT Conditional (mandatory for Debit Card)
custom_fields key String 32 Please Refer Appendix 4 Please Refer Appendix 4
value String 128 Please Refer Appendix 4 Please Refer Appendix 4

 Request JSON

{
  "NISrvRequest": {"xmlns": "http://www.ni.com/NISrvRequest.xsd",
    "request_account_update": {      
      "header": {
        "msg_id": "20211208140",
        "msg_type": "TRANSACTION",
        "msg_function": "REQ_ACCOUNT_UPDATE",
        "src_application": "SSP",
        "target_application": "WAY4",
        "timestamp": "2021-12-08 14:07:19.699+0400",
        "tracking_id": "20211208140719",
        "bank_id": "TIQMO"
      },
      "body": {
        "account_number":"0003XXXXXXXXXXXX093",
        "card_type":"PREPAID",
        "account":
	            {
	               "customer_id":"100000015",
	               "branch_code": "360",
	               "account_type": "",
	               "account_number": "0003XXXXXXXXXXXX093",
			     "custom_fields":
			            [
			                {
				               "key": "contract_idt_scheme",
				               "value": "CONTRACT_NUMBER"
				            },
				            {
				               "key": "src_app_code",
				               "value": "TIB"
				            },
				            {
				               "key": "src_app_name",
				               "value": "TIB"
				            },
				            {
				               "key": "ext_user_id",
				               "value": "NI"
				            },
				            {
				               "key": "CN-RBS_NUMBER",
				               "value": "190"
				            }
			            ]			
	            }
      }
    }
  }
}

Response Parameters:

Node Child Node Type Length Description Remarks
header msg_id String 12 The msg_id sent in the request will be sent back in response in this field. Mandatory
Unique Source Message ID e.g. “ada123456fdsf”
msg_type String 12 msg_type sent in the request will be sent back in response in this field. Mandatory
msg_function String 50 Default: “REP_ACCOUNT_UPDATE” Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field. Mandatory
Source requesting channel 
target_application  String 10 The target_application sent in the request will be sent back in response in this field. Mandatory
timestamp String 30 Timestamp of the response Mandatory
Date & time. Format  “DD/MM/YYYY HH:MM:SS”
tracking_id String 15 The tracking_id sent in the request will be sent back in response in this field. Optional
bank_id String 4 The bank_id sent in the request will be sent back in response in this field.  Mandatory
instance_id String 10 N/A Optional
Exception_details application_name String 20 Application Name Mandatory
date_time String 30 Timestamp of the response Mandatory
Format “DD/MM/YYYY HH:MM:SS”
status String 1 Status of the request (S/F) Mandatory
Success- S,  Failure - F
error_code String 4 EAI Internal Error Code (Check error codes section for the complete list of error codes and error code descriptions) Mandatory
error_description String 100 Error Description (Check error codes section for the complete list of error codes and error code descriptions) Mandatory
transaction_ref_id String 20 The tracking_id sent in the request will be sent back in response in this field. Optional
Body account_number String 64 Account contract Mandatory
custom_fields key String 32 Please Refer Appendix 4 Optional
value String 128 Please Refer Appendix 4
Optional

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Response JSON

{
  "NISrvResponse":{
    "response_account_update":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_ACCOUNT_UPDATE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 13:04:31",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "exception_details":{
        "application_name":"",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      }
    }
  }
}

Docs Navigation