PIN Verification
This Service is used for card pin verification based on the card no.provided.
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: "ENQUIRY" | Mandatory | |
msg_function | String | 50 | Function name to be used Default: "REQ_CARD_PIN_VERIFICATION " | Mandatory | |
src_application | String | _ | 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 | |
instance_id | String | 10 | N/A | Optional | |
body | card_no | String | 16 | 14/16-digit card no e.g: XXXXXXXXXXXX0833 First 6 digits will be BIN for cards |
Mandatory |
pin | String | 16 | Encrypted Pin block of the pin to be set. Ex: 7B47D3321D4A5F63 |
Mandatory |
Request Json
{
"NISrvRequest": {
"request_card_pin_verification": {
"header": {
"msg_id": "5672136",
"msg_type": "ENQUIRY",
"msg_function": "REQ_CARD_PIN_VERIFICATION",
"src_application": "ALM",
"target_application": "PCMS",
"timestamp": "2020-05-21T15:13:18.853+04:00",
"tracking_id": "5672136",
"bank_id": "NI-Test",
"instance_id": null
},
"body": {
"card_no": "5285000000000X13",
"pin": "1C17228E5B957EC4"
}
}
}
}
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. “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_PIN_VERIFICATION” | 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 Date & time. 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 | |
trace | String | 100 | Optional | ||
data | String | 100 | Optional | ||
type | String | 10 | Optional | ||
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":{
"NISrvResponse": {
"response_card_pin_verification": {
"header": {
"msg_id": "5672136",
"msg_type": "ENQUIRY",
"msg_function": "REP_CARD_PIN_VERIFICATION",
"src_application": "ALM",
"target_application": "PCMS",
"timestamp": "2020-05-21T15:13:18.853+04:00",
"tracking_id": "5672136",
"bank_id": "NI-Test",
"instance_id": null
},
"exception_details": {
"application_name": "NITIB_TCC_ADP_STD_1",
"date_time": "2021-10-18T10:49:02.143+04:00",
"status": "S",
"error_code": "000",
"error_description": "Success",
"transaction_ref_id": "5672136"
}
}
}
}
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.