- Previous: Account Transaction
- Up: Version 2.0
- Next: Card Statement Summary
Account Status Change
Account status update API will be used to update the block code on account level for a given account identifier.
Request Parameters:
Node | Child Node | Type | Max | 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_CARD_STATUS_CHANGE " | Mandatory | ||
src_application | String | 10 | Source requesting channel e.g. “SSP”. Might change. | Mandatory | ||
target_application | String | 10 | Target application name Ex. : "WAY4" | 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 e.g. “XXXX” | Mandatory | ||
body | account_identifier_id | String | 32 | Eg: "account_identifier_id": "999851XXXXXX965685" |
Mandatory | |
account_identifier_type | String | 20 | CONTRACT_NUMBER | Mandatory | ||
status | type | String | 32 |
BCC-ACC1-%FI_CODE% BCC-ACC2-%FI_CODE% |
Mandatory | |
value | String | 32 | Refer to status_values |
Mandatory | ||
custom_fields[] array of {"key":"key here", "value:"value here"} |
key | String | 32 | Refer to Appendix 4 |
Optional | |
Value | String | 128 | Refer to Appendix 4 | Optional |
Request JSON
{
"NISrvRequest": {
"request_account_status_change": {
"header": {
"msg_id": "1692103705",
"msg_type": "TRANSACTION",
"msg_function": "REQ_ACCOUNT_STATUS_CHANGE",
"src_application": "BNK",
"target_application": "WAY4",
"timestamp": "2023-03-03T17:01:21.609+04:00",
"tracking_id": "13221413256",
"bank_id": "NIC"
},
"body": {
"account_identifier_type": "CONTRACT_NUMBER",
"account_identifier_id": "0003621110000000183",
"status": {
"type": "BCC-ACC2-362",
"value": "C"
},
"custom_fields": [
{
"key": "bc_channel",
"value": "TIB1"
}
]
}
}
}
}
Response Parameters:
Node | Child Node | Data | 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: “REP_CARD_STATUS_CHANGE” | 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 | 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. E.g. ‘ABCD | Mandatory | ||
instance_id | String | 10 | N/A | Optional | ||
Exception_details | application_name | String | 20 | Tibco 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_account_status_change": {
"header": {
"msg_id": "1692103705",
"msg_type": "TRANSACTION",
"msg_function": "REP_ACCOUNT_STATUS_CHANGE",
"src_application": "BNK",
"target_application": "WAY4",
"timestamp": "2023-08-15T15:48:25.477+03:00",
"tracking_id": "13221413256",
"bank_id": "NIC"
},
"exception_details": {
"application_name": "TCC-ADP",
"date_time": "2023-08-15T15:48:25.477+03:00",
"status": "S",
"error_code": "000",
"error_description": "Success",
"transaction_ref_id": "13221413256"
}
}
}
}
- Previous: Account Transaction
- Up: Version 2.0
- Next: Card Statement Summary
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.