• Register

Card Direct Debit

Card Insurance Product service is used by bank to fetch direct debit details of particular Account., below are the detailed specifications of this API.

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: "ENQUIRY" Mandatory
msg_function String 50 Function name to be used Default: "REQ_CARD_DIRECT_DEBIT" Mandatory
src_application String 10 Source requesting channel Ex: IVR. 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_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory 
card_identifier_id
String 32 454545XXXXXX1234 Mandatory 
Request Json
{
  "NISrvRequest":{
    "request_card_direct_debit":{
      "header":{
        "msg_id":"1030909084",
        "msg_type":"ENQUIRY",
        "msg_function":"REQ_CARD_DIRECT_DEBIT",
        "src_application":"IVR",
        "target_application":"WAY4",
        "timestamp":"2020-07-20T10:49:02.366+04:00",
        "tracking_id":"236001",
        "bank_id":"AJMN"
      },
      "body":{
        "card_identifier_id": "52901612XXXXXXXX",
        "card_identifier_type": "CONTRACT_NUMBER"
      }
    }
  }
}

Response Parameters:

Node Child Node Data 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
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_CARD_DIRECT_DEBIT” Mandatory
src_application String 10 The src_application sent in the request will be sent back in response in this field. Mandatory
Source requesting channel e.g. “SSP”
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 Mandatory
Date & time. Format  “DD/MM/YYYY HH:MM:SS”
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
body dd_day String 2 Direct debit day Mandatory
dd_number String 17 Direct debit number Mandatory
dd_percentage String 3 Direct debit percentage Mandatory
dd_enrolment String 32 Direct debit enrolment flag
Possible values: Y,N,F
Mandatory
dd_member String 10 Direct debit member id Mandatory


Json Response

{
    "NISrvResponse": {
        "response_card_direct_debit": {
            "header": {
                "msg_id": "1030909084",
                "msg_type": "ENQUIRY",
                "msg_function": "REP_CARD_DIRECT_DEBIT",
                "src_application": "IVR",
                "target_application": "WAY4",
                "timestamp": "2023-02-27T16:50:26.587+04:00",
                "tracking_id": "236001",
                "bank_id": "AJMN"
            },
            "exception_details": {
                "application_name": "TCC-ADP",
                "date_time": "2023-02-27T16:50:26.587+04:00",
                "status": "F",
                "error_code": "78",
                "error_description": "Record Not Found"
            }
        }
}


Docs Navigation