Transaction History

This service will fetch the details of transaction made on the prepaid card.

Request parameters:

Node	Child Node	Type	Max	Description	Remarks
header	msg_id	String	12	Unique Source Message ID	Mandatory
	msg_type	String	12	Request Type Default: "ENQUIRY"	Mandatory
	msg_function	String	50	unction name to be used Default: "REQ_TRANSACTION_HISTORY"	Mandatory
	src_application	String	5	Source requesting channel e.g. CDM, IRISCRM, MOBAPP	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	Mandatory
	bank_id	String	4	Source Bank Id e.g. “XXXX”	Mandatory
	instance_id	String	10	N/A	Optional
body	card_no	String		14/16-digit card no e.g: XXXXXXXXXXXX0833 First 6 digits will be BIN for PCMS cards	Mandatory
	from_date	String	8	Format - YYYYMMDD Start Range for Transaction Acquiring Date Sample: 20091218	Optional
	to_date	String	8	Format - YYYYMMDD End Range for Transaction Acquiring Date Sample: 20091218	Optional
	is_financial	String		Sample: ‘Y’- for fetching financial transactions, ‘N’ –for fetching Non-Financial Transaction and ‘A’- for fetching ALL Transactions	Optional
	is_posted	String		Sample: 0 – List both Authorize & Posted Transactions 1 – List only Posted Transaction 2 – List only Authorized Transactions	Optional
	output_type	String		Sample: 0 – Card number Transaction Only 1 – Wallet ID Transactions	Optional
	sort_order	String		01 – Ascending Order, 02 – Descending Order.	Optional
	top_n	String		Specifies the top N transactions to be returned. 0 specifies all transactions in the range. If N is greater than the number of records that lie in the range, the actual number of records will be returned. For instance, if a request is made with Top N parameter set to 5 and the actual number of results lying in the range are 3, then 3 records will be returned.	Optional
	trans_channel	String		0000 – For all channels. Xxxx – For specific channel on which records should be filtered.	Optional

Request Json

{
  "NISrvRequest":{
    "request_transaction_history":{
      "header":{
        "msg_id":"132001",
        "msg_type":"Enquiry",
        "msg_function":"REQ_TRANSACTION_HISTORY",
        "src_application":"MOBAPP",
        "target_application":"PCMS",
        "timestamp":"2021-09-03T13:55:20.488+04:00",
        "tracking_id":"132001",
        "bank_id":"XXXX"
      },
      "body":{
        "card_no":"XXXXXXXXXXXXXXXX",
        "from_date":"20200201",
        "to_date":"20200228",
        "is_financial":"A",
        "is_posted":"0",
        "output_type":null,
        "sort_order":"01",
        "top_n":"10",
        "transaction_channel":"0000"
      }
    }
  }
}

Response parameters:

Node	Child Node	Type	Max	Description	Remarks
header	msg_id		String	12	The msg_id sent in the request will be sent back in response in this field. Unique Source Message ID e.g. “adfasf123456”	Mandatory
	msg_type		String	12	Request Type	Mandatory
	msg_function		String	50	Function name to be used	Mandatory
	src_application		String	5	The src_application sent in the request will be sent back in response in this field. Source requesting channel e.g. “AWB”	Mandatory
	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 Date & time. Format “DD/MM/YYYY HH:MM:SS”	Mandatory
	tracking_id		String	15	The tracking_id sent in the request will be sent back in response in this field.	Mandatory
	bank_id		String	4	The bank_id sent in the request will be sent back in response in this field. E.g. ‘XXXX	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 Format “DD/MM/YYYY HH:MM:SS”	Mandatory
	status		String	1	Status of the request (S/F) Success- S, Failure - F	Mandatory
	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	transaction_details	Repeatable zero or more times based on the transaction history
		card_no	String		Card Number of the Customer	Optional
		expiry_date	String		Expiry Date of Card YYMM Sample: 2002	Optional
		wallet_id	String		Unique Wallet ID Assigned to Customer Sample: 45219087663452190549	Optional
		transaction_code	String		Refer to Appendix A	Optional
		source_channel_type	String		Fixed Set of Value: 0132 - CDM	Optional
		wallet_balance	String		Current Balance of Wallet Sample: +00000020000	Optional
		transaction_local_date	String		Format- YYYYMMDD Transaction Acquiring Date Sample: 20091218	Optional
		transaction_local_time	String		Format- HHMMSS Transaction Acquiring Time Sample: 163755	Optional
		posting_date	String		Format- YYYYMMDD Posting Date Sample: 20091218	Optional
		retrieval_reference_number	String		Unique number for a transaction within a day Sample: 909906000435	Optional
		transaction_amount	String		Amount of Transaction. If a transaction is Posted the Posted Amount will be shown Sample: +00000020000	Optional
		transaction_currency	String		3- digit currency Code	Optional
		transaction_narration	String		Narration for Transaction	Optional
		auth_id_response_code	String		Authorization Code of Transaction Sample: 190990	Optional
		billing_amount	String		Billing Amount of Transaction. Sample: +00012000000	Optional
		billing_currency	String		3- digit currency Code	Optional
		settlement_type	String		Type of Settlement. Debit or Credit Fixed Set of Values : D – Debit C - Credit	Optional
		merchant_name_location	String		Name and Location of Merchant in case of POS Transactions.	Optional

Response Json

{
  "NISrvResponse":{
    "response_transaction_history":{
      "header":{
        "msg_id":"132001",
        "msg_type":"ENQUIRY",
        "msg_function":"REP_TRANSACTION_HISTORY",
        "src_application":"MOBAPP",
        "target_application":"PCMS",
        "timestamp":"2021-09-03T13:55:26.448+04:00",
        "tracking_id":"132001",
        "bank_id":"XXXX"
      },
      "exception_details":{
        "application_name":"NITIB_TCC_BRK_XXX",
        "date_time":"2021-09-03T13:55:26.448+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success"
      },
      "body":{
        "transaction_details":[
          {
            "card_no":"XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"+00000020000",
            "transaction_local_date":"20200507",
            "transaction_local_time":"055727",
            "posting_date":"20200225",
            "retrieval_reference_number":"000000002300",
            "transaction_amount":"+00000020000",
            "transaction_currency":"USD",
            "transaction_narration":"Withdrawal CPLUS",
            "auth_id_response_code":"642029",
            "billing_amount":"+00000020000",
            "billing_currency":"USD",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          },
          {
            "card_no":" XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"+00000020000",
            "transaction_local_date":"20200507",
            "transaction_local_time":"055727",
            "posting_date":null,
            "retrieval_reference_number":"000000002300",
            "transaction_amount":"+00000020000",
            "transaction_currency":"USD",
            "transaction_narration":"Cash Deposit Fee on BRN",
            "auth_id_response_code":"642029",
            "billing_amount":"+00000020000",
            "billing_currency":"USD",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          },
          {
            "card_no":" XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"948.00",
            "transaction_local_date":"20200507",
            "transaction_local_time":"055758",
            "posting_date":null,
            "retrieval_reference_number":"000000002302",
            "transaction_amount":"10.00",
            "transaction_currency":"936",
            "transaction_narration":"Withdrawal CPLUS",
            "auth_id_response_code":"642030",
            "billing_amount":"+00000020000",
            "billing_currency":"USD",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          },
          {
            "card_no":" XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"+00000020000",
            "transaction_local_date":"20200507",
            "transaction_local_time":"055758",
            "posting_date":null,
            "retrieval_reference_number":"000000002302",
            "transaction_amount":"+00000020000",
            "transaction_currency":"USD",
            "transaction_narration":"Cash Deposit Fee on BRN",
            "auth_id_response_code":"642030",
            "billing_amount":"10.00",
            "billing_currency":"936",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          },
          {
            "card_no":" XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"+00000020000",
            "transaction_local_date":"20200510",
            "transaction_local_time":"013632",
            "posting_date":null,
            "retrieval_reference_number":"000000002303",
            "transaction_amount":"+00000020000",
            "transaction_currency":"USD",
            "transaction_narration":"Withdrawal CPLUS",
            "auth_id_response_code":"642048",
            "billing_amount":"10.00",
            "billing_currency":"936",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          },
          {
            "card_no":" XXXXXXXXXXXXXXXX",
            "expiry_date":"2504",
            "wallet_id":"45936000004",
            "transaction_code":"010",
            "source_channel_type":"0001",
            "wallet_balance":"+00000020000",
            "transaction_local_date":"20200510",
            "transaction_local_time":"013632",
            "posting_date":null,
            "retrieval_reference_number":"000000002303",
            "transaction_amount":"+00000020000",
            "transaction_currency":"USD",
            "transaction_narration":"Cash Deposit Fee on BRN",
            "auth_id_response_code":"642048",
            "billing_amount":"10.00",
            "billing_currency":"936",
            "settlement_type":"D",
            "merchant_name_location":"102504820000000               Koforidua                     000288Goil stat,Opp Vodaphone                                     Koforidua                     00120200317MSCC      ZENG                         2330000000000000"
          }
        ]
      }
    }
  }
}

Transaction History

0 Comments

Docs Navigation