• Register

Card Transaction Details

This process is used for fetching transactions which are authorized, time_based/posted or statemented 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 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_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory 
card_identifier_id String 32 454545XXXXXX1234
 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 MMYY(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
return_mcc_group Boolean True/False To retrun MCC group Optional
Request Json
{
  "NISrvRequest":{
    "request_get_card_transactions":{
      "header":{
        "msg_id":"224001",
        "msg_type":"ENQUIRY",
        "msg_function":"REQ_GET_CARD_TRANSACTIONS",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T13:04:30.356+04:00",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "body":{
        "card_identifier_id":"454545XXXXXX1234",
        "card_identifier_type":"CONTRACT_NUMBER/EXID",
	"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_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory
card_identifier_id String 32 454545XXXXXX1234 Mandatory
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_identifier_type

 String 20 CONTRACT_NUMBER or EXID Mandatory
card_identifier_id String 32 454545XXXXXX1234 Mandatory
masked_pan String 16 PAN in masked form Mandatory
trans_date Date 10

Transaction date

Format  DD/MM/YYYY

 Mandatory
post_date Date 10

Posting date

Format  DD/MM/YYYY

 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_category_group String 20 Category Group 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
trans_id String 20 Transaction Id Optional
balance_type String 20 RETAIL 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_identifier_id":"454545XXXXXX1234",
                 "card_identifier_type":"CONTRACT_NUMBER/EXID",
		"transaction_type": "",
		"date_from": "",
		"date_to": "",
		"statement_period": "",
		"no_of_transactions_returned": "",
		"transactions": {
                 "card_identifier_id":"454545XXXXXX1234",
                 "card_identifier_type":"CONTRACT_NUMBER/EXID",
                        "masked_pan": "",
			"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 30 as of 1 year ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation