• Register

Digital Status Chnage

Digital Status Change service is used to chnage the status of Digital card of a customer. This service is applicable for Credit and Debit Cards. Below are detailed the specifications of this API.

Download

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_DIGITAL_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 card_number String Min – 16 Max - 19 14/16-digit card no Mandatory 
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
Indicator String 2 Status value Mandatory
card_sequence_number String 2 Sample -01,02 etc Conditional (Applicable for C+ only)
Request Json
{
  "NISrvRequest":{
    "request_digital_status_change":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_DIGITAL_STATUS_CHANGE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T12:59:21.609+04:00",
        "tracking_id":"223001",
        "bank_id":"bankID"
      },
      "body":{
        "card_number":"999841XX18869X2X",
        "Indicator":"01",
        "card_sequence_number":"02"
      }
    }
  }
}

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. 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 Function name to be used Default:  "REP_DIGITAL_STATUS_CHANGE" Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field. 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 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 Format “DD/MM/YYYY HH:MM:SS” Mandatory
status String 1 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_digital_status_change":{
      "header":{
        "msg_id":"223001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_DIGITAL_STATUS_CHANGE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 12:59:23",
        "tracking_id":"223001",
        "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
      }
    }
  }
}

Docs Navigation