• Register

Card Update

 

Card Update service is used to make changes in card details. This service is applicable only for Credit Cards. Below are the detailed 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_CARD_UPDATE" Mandatory
src_application String 10 Source requesting channel Mandatory
target_application String 10 Target application name Ex. : "PCMS" 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 Ex: “bankID” Mandatory
body card_number String Min – 16 Max - 19 16 to 19-digit card no Mandatory
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
card branch_code String 10 Branch code e.g. “XXXX” Optional
card_number String Min – 16 Max - 19 16 to 19-digit card no Mandatory
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
custom_fields key String 32 Custom Tag Optional
value String 128 Tag value Optional

 

Request JSON

{
  "NISrvRequest": {
    "request_card_update": {
      "header": {
        "msg_id": "224001",
        "msg_type": "TRANSACTION",
        "msg_function": "REQ_CARD_UPDATE ",
        "src_application": "IVR",
        "target_application": "PCMS",
        "timestamp": "2020-07-19T13:04:30.356+04:00",
        "tracking_id": "224001",
        "bank_id": "bankID"
      },
      "body": {
        "card_number": "",
        "card": {
          "branch_code": "",
          "card_number": "",
          "custom_fields": {
            "key": "",
            "value": ""
          }
        }
      }
    }
  }
}


Resposne 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: "REP_CARD_UPDATE" Mandatory
src_application String 10 Source requesting channel Mandatory
target_application String 10 Target application name Ex. : "PCMS" 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 Ex: “bankID” Mandatory
body card_number String Min – 16 Max - 19 16 to 19-digit card no Mandatory
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
custom_fields key String 32 Custom Tag Optional
value String 128 Tag value Optional

 

 Response JSON

{
  "NISrvResponse":{
    "response_card_update":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CARD_UPDATE",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 13:04:31",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "exception_details":{
        "application_name":"",
        "date_time":"2020-07-19T12:57:49.439+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
        "transaction_ref_id":null
      },
      "body": {
          "card_number":"",
          "custom_fields": {
                 "key": "",
                 "value": ""
               }

       } 
    }
  }
}


Docs Navigation