• Register

Lookup Card Identifier

Lookup Card Identifier service is used for retrieving the Card number for the given Token Number and vice versa.Below are the detailed specifications of this API.

Download

Request Parameters:

Node Child Node Type   Max Description Remarks
header msg_id String 12 Unique Source Message ID Mandatory
msg_type String 12 Request Type Mandatory
Default: "ENQUIRY"
msg_function String 50 Function name to be used Mandatory
Default: " REQ_LOOKUP_CARD_IDENTIFIER"
src_application String 10 Source requesting channel Mandatory
Ex: IVR
target_application  String 10 Target application name Mandatory
Ex. : CMS
timestamp String 30 Timestamp of the request Mandatory
Format  “DD/MM/YYYY HH:MM:SS”
tracking_id String 15 N/A Optional
bank_id String 4 Source Bank Id Ex: bankID Mandatory
instance_id String 10 N/A Optional
body card_identifier_id String 32 454545XXXXXX1234 Mandatory
card_identifier_type String 20 CONTRACT_NUMBER  or EXID Mandatory
public_key String 500 X.509 Certificate encapsulating a Public Key to be used to encrypt the CardNo Optional

Request Json

{
    "NISrvRequest": {
        "request_lookup_card_identifier": {
            "header": {
                "msg_id": "236001",
                "msg_type": "ENQUIRY",
                "msg_function": " REQ_LOOKUP_CARD_IDENTIFIER",
                "src_application": "IVR",
                "target_application": "CMS",
                "timestamp": "2020-07-20T10:49:02.366+04:00",
                "tracking_id": "236001",
                "bank_id": "bankID"
            },
            "body": {
                "card_identifier_id": "454545XXXXXX1234",
                "card_identifier_type": "CONTRACT_NUMBER/EXID",
                "public_key":"XXXXXXXXXXXXXXXXXX77jgjjk2310"
      }
    }
  }
}

Response parameters:

Node Child Node Type  Max Description Remarks
header msg_id     The msg_id sent in the request will be sent back in response in this field. Mandatory
String 12 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_LOOKUP_CARD_IDENTIFIER” Mandatory
src_application     The src_application sent in the request will be sent back in response in this field. Mandatory
String 10
tracking_id     N/A Optional
String 15
bank_id   4 The bank_id sent in the request will be sent back in response in this field. Mandatory
String
instance_id String 10 N/A Optional
exception_details application_name String 20 Application Name Mandatory
date_time   30 Timestamp of the response Mandatory
String Format “DD/MM/YYYY HH:MM:SS”
status   1 Status of the request (S/F) Mandatory
String 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 card_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory
card_identifier_id String 32 454545XXXXXX1234 Mandatory
Response Json
{
  "NISrvResponse":{
    "response_lookup_card_identifier":{
      "header":{
        "msg_id":"223001",
        "msg_type":"ENQUIRY",
        "msg_function":"REP_LOOKUP_CARD_IDENTIFIER",
        "src_application":"IVR",
        "target_application":"CMS",
        "timestamp":"2020-07-20T10:49:02.366+04:00",
        "tracking_id":"236001",
        "bank_id":"bankID"
      },
      "exception_details":{
        "application_name":"NITIB_TCC_ADP_SSP_1",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      },
      "body": {
                "card_identifier_id": "454545XXXXXX1234",
                "card_identifier_type": "CONTRACT_NUMBER/EXID",
      }
    }
  }
}

p> 

version 10 as of 3 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation