- Previous: Customer Demographic Update
- Up: Version 2.0
- Next: Card Update
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.
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
}
}
}
}
- Previous: Customer Demographic Update
- Up: Version 2.0
- Next: Card Update
Docs Navigation
- API Security
- Falcon Services
- Card Services
- BETA
- Version 1.0
- Card Balance Enquiry
- Card Activation
- Card Set Pin
- Card Change PIN
- Card PIN Verification
- Card Status Update
- Card Limit Update
- Card Details
- Customer Details
- List Of Cards
- Customer Demographic Update
- Card Used Limits
- Card Statement Summary
- Card Transaction
- Utility Payments
- Account Create
- Account Update
- Account Closure
- Card Create
- Card Update
- Card Replacement
- Client Create
- Client Update
- Transaction Details
- PIN Retries Counter Reset
- Digital Status Chnage
- Get CVV2 Service
- Card Link Delink
- Card Insurance Products
- Card Change Insurance Product Status
- Card Direct Debit
- Update Card Direct Debit
- Card Balance Conversion Enquiry
- Card Balance Conversion
- Card Transaction Eligibility
- Card Transaction EPP Conversion
- Card Replacement Embossing
- Card NMON Transactions
- Retail Banking Transactions
- Appendix 1
- Appendix 2
- Appendix 3
- Appendix 4
- HTTP Codes
- Error Codes
- Version 2.0
- Lookup Card Identifier
- List Of Cards
- Card Activation
- Card Set PIN
- Card Change PIN
- Card Status Update
- Client Create
- Account Create
- Card Create
- Customer Demographic Update
- Account Update
- Card Update
- Card Replacement
- Customer Details
- Card Details
- Client Update
- Card Balance Enquiry
- Card Transaction
- Card Limit Update
- Card PIN Verification
- PIN Retried Counter Reset
- Get CVV2 Service
- Card Verification
- Card Transaction Details
- Get Encryption Certificate
- Get Dictionaries MCC
- Get Account Balance
- Card Insurance Product
- Card Insurance Product Update
- Card Direct Debit Update
- Card Direct Debit
- P2P Transfer
- Account Transaction
- Account Status Change
- Card Statement Summary
- Account Transaction Details
- Card Contact Details
- List of Accounts
- Account Hierarchy
- Notification Service
- Appendix 1
- Appendix 2
- Appendix 3
- Appendix 4
- HTTP Codes
- Error Codes
- Buy Now Pay Later
- Card Limits
- Insurance Services
- Webhook Services
- Switch Services
- Card Control Services
- Merchant Digital Onboarding
- Notification Service
- SMS Security Services
- Terms and Condition
0 Comments
Please sign in to post a comment.