• Register

Transaction Details

This process is used for fetching transactions which are “posted” to cardholder account. This service is applicable only for Credit Cards. Below are the detailed specifications of this API

Download

Request Parameters:

Node Child Node Data Type Length 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_GET_CARD_TRANSACTIONS " 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_number String Min – 16 Max - 19 16/19-digit card no Mandatory 
transaction_type String 16 authorized, time_based/posted, statemented Mandatory 
date_from String 10 Format DD/MM/YYYY. Maximum interval is 90days. Maxim from date is 12 months from the current date. Conditional for posted.
date_to String 10 Format DD/MM/YYYY. Maximum interval is 90days Conditional for posted
statement_period String 4 Format YYMM (Maximum statement is 12 months from the current date) Conditional Mandatory for statemented
no_of_transactions_requested String 2 Maximum number of transactions to be fetched in a request. Value should be between 1 and 99 default is 50  Optional
requested_page_no String 4 Page number of the current request, could be from 1 to 99. Optional
Request Json
{
  "NISrvRequest":{
    "request_get_card_transactions":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REQ_CARD_TRANSACTION",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T13:04:30.356+04:00",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "body":{
        "card_number":"XXXXXXXXXXXXXX",
		"transaction_type": "",
		"date_from": "",
		"date_to": "",
		"statement_period": ""
      }
    }
  }
}

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_GET_CARD_TRANSACTIONS” 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
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.  Mandatory
instance_id String 10 N/A Optional
Exception_details application_name String 20 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 card_number String Min – 16 16/19-digit card no Mandatory
Max - 19 e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards
transaction_type String 16 authorized, time_based/posted, statemented Mandatory 
date_from String 10 Format YYYY-MM-DD Conditional for posted.
date_to String 10 Format YYYY-MM-DD Conditional for posted
statement_period String 4 Format YYMM Conditional Mandatory for statemented
no_of_transactions_returned String 3 Number of transactions
Mandatory
no_of_transactions_requested String 2 Maximum number of transactions to be fetched in a request. Value should be between 1 and 99 default is 50 Optional
requested_page_no String 2 Page number of the current request, could be from 1 to 99 Optional
total_no_of_pages String 2 Total number of requests Optional
transactions card_number String Min – 16
Max – 19		 14/16-digit card no
e.g: XXXXXXXXXXXX0833
First 6 digits will be BIN for cards		 Mandatory
trans_date Date Format  DD/MM/YYYY Transaction date Mandatory
post_date Date Format  DD/MM/YYYY Posting date Mandatory
debit_credit_flag String 1 Type of direction Mandatory
response_code Number 3 Return code Mandatory
description String 255 Transaction description Mandatory
transaction_ref_number String 12 Transaction reference number Mandatory
currency String 3 Currency Mandatory
amount String 20 Amount Mandatory
source_currency String 3 Trans currency Mandatory
source_amount String 20 Trans amount Mandatory
auth_code String 32 Authorization code Optional
merchant_id String 32 Merchant ID number Optional
merchant_category_code String 4 SIC  Optional
merchant_name String 64 Merchant Name Optional
merchant_address String 64 Merchant Address Optional
merchant_city String 64 Merchant City Optional
merchant_country String 64 Merchant Country Optional
transaction_code String 32 Transaction code Optional
Response JSON
{
  "NISrvResponse":{
    "response_get_card_transactions":{
      "header":{
        "msg_id":"224001",
        "msg_type":"TRANSACTION",
        "msg_function":"REP_CARD_TRANSACTION",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"19/07/2020 13:04:31",
        "tracking_id":"224001",
        "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_number": "",
		"transaction_type": "",
		"date_from": "",
		"date_to": "",
		"statement_period": "",
		"no_of_transactions_returned": "",
		"transactions": {
			"card_number": "",
			"trans_date": "",
			"post_date": "",
			"debit_credit_flag": "",
			"response_code": "",
			"description": "",
			"transaction_ref_number": "",
			"currency": "",
			"amount": "",
			"source_currency": "",
			"source_amount": "",
			"auth_code": "",
			"merchant_id": "",
			"merchant_category_code": "",
			"merchant_name": "",
			"merchant_address": "",
			"merchant_city": "",
			"merchant_country": "",
			"transaction_code": ""
		}
	  }
    }
  }
}

version 4 as of 2 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation