- Previous: Card Create
- Up: Version 2.0
- Next: Account Update
Customer Demographic Update
Customer Demographic update service is used for updating the demographic details of customer, below are the detailed specifications of this API.
Request parameters:
Node |
Child Node |
Type |
Max |
Description |
Remarks |
|
header |
msg_id |
String |
12 |
The msg_id sent in the request will be sent back in response in this field. Unique Source Message ID e.g. “ada123456fdsf” |
Mandatory |
|
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: “REQ_CUSTOMER_DEMOGRAPHIC_UPDATE” |
Mandatory |
||
src_application |
String |
10 |
The src_application sent in the request will be sent back in response in this field. Source requesting channel e.g. “SSP” |
Mandatory |
||
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 Date & time. Format “DD/MM/YYYY HH:MM:SS” |
Mandatory |
||
tracking_id |
String
|
15 |
N/A |
Optional |
||
bank_id |
String |
4 |
The bank_id sent in the request will be sent back in response in this field. E.g. ‘ABCD |
Mandatory |
||
instance_id |
String |
10 |
N/A |
Optional |
||
body |
customer_id |
String |
20 |
CIF Id Ex:000003548435901 |
Mandatory |
|
bank_code |
String |
5 |
Bank specific code Ex:928 |
Mandatory |
||
client_number |
String |
20 |
Client number Ex: 000003548435901 |
Optional |
||
reg_number |
String |
20 |
Registration number Ex: 000003548435901 |
Optional |
||
card_name |
String |
50 |
Card Holder's Name IVAN IVANOVV |
Mandatory |
||
# personal_details# |
||||||
personal_details |
gender |
String |
20 |
Gender ex: Male |
Optional |
|
title |
String |
5 |
Title ex: Mr |
Optional |
||
first_name |
String |
20 |
First Name ex: Ivan |
Optional |
||
last_name |
String |
20 |
Last Name ex: Ivanov |
Optional |
||
middle_name |
String |
20 |
Middle Name ex: Ivich |
Optional |
||
citizenship |
String |
10 |
Optional |
|||
marital_status |
String |
10 |
Marital Status
|
Optional |
||
date_of_birth |
String |
20 |
Date of birth ex:1980-01-21 |
Optional |
||
place_of_birth |
String |
50 |
Place of birth |
Optional |
||
language |
String |
5 |
language eg: ENG |
Optional |
||
security_name |
String |
20 |
Security Name |
Optional |
||
# ADDR_TYPE: SMS |
||||||
contact_details |
home_phone |
String |
20 |
Home Phone Number |
Optional |
|
work_phone |
String |
20 |
Work Phone Number |
Optional |
||
mobile_phone |
String |
20 |
Mobile Number |
Optional |
||
|
String |
20 |
Email address |
Optional |
||
# Array of Address Entity |
||||||
addresses |
address_type |
String |
20 |
PERMANENT/RESIDENT |
Mandatory |
|
address_line_1 |
String |
20 |
Building one |
Mandatory |
||
address_line_2 |
String |
20 |
LandLord |
Optional |
||
address_line_3 |
String |
20 |
House 45 |
Optional |
||
address_line_4 |
String |
20 |
Busy Street |
Optional |
||
|
String |
20 |
emailtest@test.net |
Optional |
||
phone |
String |
20 |
Phone number |
optional |
||
city |
String |
20 |
Ex: Riyadh |
Optional |
||
country |
String |
20 |
Ex: SAU Appendix 1 |
Optional |
||
zip |
String |
20 |
ZIP code ex: 36756 |
Optional |
||
state |
String |
20 |
State ex: Riyadh |
Optional |
||
# Document Entity # |
||||||
identity_proof_document |
number |
String |
20 |
ID Number |
Optional |
|
type |
String |
20 |
passport, national_id, etc |
Optional |
||
expiry_date |
String |
10 |
YYYY-MM-DD |
Optional |
||
# Array of Document Entity# |
||||||
supplementary_documents |
number |
String |
20 |
ID Number |
Optional |
|
type |
String |
20 |
passport, national_id, etc |
Optional |
||
expiry_date |
String |
10 |
YYYY-MM-DD |
Optional |
||
# employment_details # |
||||||
employment_details |
employer_name |
String |
20 |
NewCompanyName |
Optional |
|
income |
String |
20 |
Income |
Optional |
||
occupation |
String |
20 |
Occupation |
Optional |
||
# Array of Custom Field entity |
||||||
custom_fields |
key |
String |
20 |
Please refer Appendix 4 |
Optional |
|
value |
String |
20 |
Please refer Appendix 4 |
Optional |
Request JSON
{
"NISrvResponse":{
"response_generic_customer_details":{
"header":{
"msg_id":"218001",
"msg_type":"ENQUIRY",
"msg_function":"REQ_CUSTOMER_DEMOGRAPHIC_UPDATE",
"src_application":"SSP",
"target_application":"WAY4",
"timestamp":"16/07/2020 11:04:51",
"tracking_id":"218001",
"bank_id":"SSP"
},
"body":{
"customer_id":"000003548435901",
"bank_code":"982",
"client_number":"000003548435901",
"reg_number":"000003548435901",
"card_name":"IVAN IVANOVV",
"personal_details":{
"gender":"Male",
"title":"MR",
"first_name":"IVAN",
"last_name":"IVANOVV",
"middle_name":"IVICH",
"citizenship":"AUS",
"marital_status":"M",
"date_of_birth":"1980-01-21",
"place_of_birth",
"language":"ENG",
"security_name":"IvanSecur",
},
"contact_details": {
"home_phone":,
"work_phone":,
"mobile_phone":,
"email":
},
"addresses":[
{
"address_type":"PERMANENT/RESIDENT",
"address_line_1":"Building one",
"address_line_2":"LandLord",
"address_line_3":"House 45",
"address_line_4":"Busy Street",
"email":"emailtest@test.net",
"phone": "",
"city":"Riyadh",
"country":"SAU",
"zip":"24537",
"state":"Riyadh"
}
],
"identity_proof_document": {
"number":,
"type": ,(passport, national_id, etc)
"expiry_date": #YYYY-MM-DD
},
"supplementary_documents":
"number":,
"type":, (passport, national_id, etc)
"expiry_date": #YYYY-MM-DD
],
"employment_details":{
"employer_name":"NewCompanyName",
"income":,
"occupation":
},
"custom_fields":
{
"key":,
"value":
}
]
}
}
}
}
Response parameters:
Node |
Child Node |
Type |
Max |
Description |
Remarks |
header |
msg_id |
String |
12 |
The msg_id sent in the request will be sent back in response in this field. Unique Source Message ID e.g. “adfasf123456” |
Mandatory |
msg_type |
String |
12 |
Request Type |
Mandatory |
|
msg_function |
String |
50 |
Function name to be used "REP_CUSTOMER_DEMOGRAPHIC_UPDATE" |
Mandatory |
|
src_application |
String |
10 |
The src_application sent in the request will be sent back in response in this field. Source requesting channel e.g. “SSP” |
Mandatory |
|
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 Date & time. Format “DD/MM/YYYY HH:MM:SS” |
Mandatory |
|
tracking_id |
String |
15 |
N/A |
Optional |
|
bank_id |
String |
4 |
The bank_id sent in the request will be sent back in response in this field. E.g. ‘XXXX |
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 Format “DD/MM/YYYY HH:MM:SS” |
Mandatory |
|
status |
String |
1 |
Status of the request (S/F) Success- S, Failure - F |
Mandatory |
|
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 |
Response JSON
{
"NISrvResponse":{
"response_client_update":{
"header":{
"msg_id":"226001",
"msg_type":"TRANSACTION",
"msg_function":"REP_CUSTOMER_DEMOGRAPHIC_UPDATE",
"src_application":"IVR",
"target_application":"PCMS",
"timestamp":"19/07/2020 13:46:35",
"tracking_id":"226001",
"bank_id":"bankID"
},
"exception_details":{
"application_name":"NITIB_TCC_ADP_SSP_1",
"date_time":"2020-07-19T13:46:33.329+04:00",
"status":"S",
"error_code":"000",
"error_description":"Success",
"transaction_ref_id":"1761831"
}
}
}
}
- Previous: Card Create
- Up: Version 2.0
- Next: Account 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.