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:

 Request JSON

{
  "NISrvRequest":{
    "request_account_update":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_ACCOUNT_UPDATE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T13:04:30.356+04:00",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "body":{
        "account_number":"999841XX298XX733",
        "card_type":"Debit",
        "account": {
            "customer_id":"",
            "branch_code":"321",
            "account_type":"CURRENT",
            "account_number":"",
            "custom_fields": {
               "key": "",
               "value": ""
             }
        }
      }
    }
  }
}

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	Custom Tag	Optional
		value	String	128	Tag value	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
      }
    }
  }
}