• Register

Account Transaction Details

This process is used for fetching transactions which are authorized, time_based/posted or statemented to account. Below are the detailed specifications of this API

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_ACCOUNT_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 account_identifier_type String 20 CONTRACT_NUMBER/RBS_NUMBER Mandatory 
account_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 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
return_mcc_group Boolean True/False To retrun MCC group Optional
Request Json
{
  "NISrvRequest":{
    "request_get_account_transactions":{
      "header":{
        "msg_id":"224001",
        "msg_type":"ENQUIRY",
        "msg_function":"REQ_GET_ACCOUNT_TRANSACTIONS",
        "src_application":"IVR",
        "target_application":"PCMS",
        "timestamp":"2020-07-19T13:04:30.356+04:00",
        "tracking_id":"224001",
        "bank_id":"bankID"
      },
      "body":{
        "account_identifier_id":"99999999999999999999",
        "account_identifier_type":"CONTRACT_NUMBER/RBS_NUMBER",
	"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_ACCOUNT_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 account_identifier_type String 20 CONTRACT_NUMBER or EXID Mandatory
account_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
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

account_identifier_type

 String 20 CONTRACT_NUMBER/RBS_NUMBER Mandatory
account_identifier_id String 32 454545XXXXXX1234 Mandatory
masked_pan String 16 Plan 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
external_ref_number String 12 External Reference Number 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_account_transactions": {
      "header": {
        "msg_id": "224001",
        "msg_type": "ENQUIRY",
        "msg_function": "REP_GET_ACCOUNT_TRANSACTIONS",
        "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": {
        "account_identifier_id": "454545XXXXXX1234",
        "account_identifier_type": "CONTRACT_NUMBER/RBS_NUMBER",
        "transaction_type": "",
        "date_from": "",
        "date_to": "",
        "statement_period": "",
        "no_of_transactions_returned": "",
        "transactions": [
          {
            "card_identifier_id": "454545XXXXXX1234",
            "card_identifier_type": "CONTRACT_NUMBER/RBS_NUMBER",
            "masked_pan": "",
            "trans_date": "",
            "post_date": "",
            "debit_credit_flag": "",
            "response_code": "",
            "description": "",
            "transaction_ref_number": "",
            "currency": "",
            "amount": "",
            "source_currency": "",
            "source_amount": "",
            "auth_code": "",
            "external_ref_number": "",
            "merchant_id": "",
            "merchant_category_code": "",
            "merchant_name": "",
            "merchant_address": "",
            "merchant_city": "",
            "merchant_country": "",
            "transaction_code": ""
          }
        ]
      }
    }
  }
}

version 8 as of 2 years ago by sumit ojha

0 Comments

Please sign in to post a comment.

Docs Navigation