• Register

PIN Retried Counter Reset

Pin Retries Counter Reset is used to reset the retries counter for Pin to 0, below are detailed the specifications of this API.

Request Parameters:

Download

Node Child Node Type Max Description Remarks
header msg_id String 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_PIN_RETRIES_COUNTER_RESET " 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_identifier_type String 20 CONTRACT_NUMBER or

EXID
Mandatory
card_identifier_id String 32 454545XXXXXX1234 Mandatory
card_sequence_number String 2 Sample -01,02 etc Conditional (Applicable)


Request Json
{
   "NISrvRequest":{
      "request_pin_counter_reset":{
         "header":{
            "msg_id":"kckdnjckd",
            "msg_type":"TRANSACTION",
            "msg_function":"REQ_PIN_RETRIES_COUNTER_RESET",
            "src_application":"IVR",
            "target_application":"WAY4",
            "timestamp":"2022-03-10T09:03.98+04:00",
            "tracking_id":"kckdnjckd",
            "bank_id":"TIQMO"
         },
         "body":{
            "card_identifier_id":"99985XXXXXXXX709811",
            "card_identifier_type":"EXID",
            "card_sequence_number":"",
            "card_expiry_date":""
         }
      }
   }
}

Response parameters:

Node Child Node Type Max Description Remarks
header msg_id String 12 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 Function name to be used Default: "REP_PIN_RETRIES_COUNTER_RESET " 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 Timestamp of the response Mandatory
Format “DD/MM/YYYY HH:MM:SS”
status String 1 Status of the request (S/F) Mandatory
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
Response Json
{
   "NISrvResponse":{
      "response_pin_counter_reset":{
         "header":{
            "msg_id":"1646891048",
            "msg_type":"TRANSACTION",
            "msg_function":"REP_PIN_RETRIES_COUNTER_RESET",
            "src_application":"IVR",
            "target_application":"WAY4",
            "timestamp":"2022-03-10T09:03.98+04:00",
            "tracking_id":"795",
            "bank_id":"TIQMO"
         },
         "exception_details":{
            "application_name":"NITIB_TCC_ADP_KSA",
            "date_time":"2022-03-10T08:44:08.962+03:00",
            "status":"S",
            "error_code":"000",
            "error_description":"Success",
            "transaction_ref_id":"795"
         }
      }
   }
}

Docs Navigation