Account Transaction

This process is used to post online Payments / Payment reversals 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: "TRANSACTION"	Mandatory
	msg_function		String	50	Function name to be used Default: " REP_ACCOUNT_TRANSACTION "	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	Optional
	account_identifier_id		String	32	"account_identifier_id": "999851XXXXXXXX965685"	Mandatory
	transaction	transaction_code	String	32	Transaction code	Mandatory
		transaction_date	String	30	Date of transaction YYYY-MM-DD HH:MM:SS 2021-01-15 16:26:36	Optional
		amount	String	20	Amount	Mandatory
		currency	String	3	Currency	Mandatory
		billing_amount	String	20	Billing Amount	Optional
		billing_currency	String	3	Billing currency	Optional
		description	String	255	Transaction description	Optional
		transaction_ref_number	String	12	Transaction reference number	Mandatory
		auth_code	String	6	Auth Code	Optional
		country	String	3	Country	Optional
		city	String	200	Ciry	Optional
		external_ref_number	String	12	Reference number	Optional
		array of rules_data
		key	String	30	Key	Optional
		value	String	128	value	Optional

Request JSON

{
   "NISrvRequest":{
      "request_account_transaction":{
         "header":{
            "msg_id":"Rq_p2ptfr7",
            "msg_type":"TRANSACTION",
            "msg_function":"REQ_ACCOUNT_TRANSACTION",
            "src_application":"BNK",
            "target_application":"WAY4",
            "timestamp":"2023-03-09T12:03:01.609+04:00",
            "tracking_id":"Rq_p2ptfr7",
            "bank_id":"NIC"
         },
         "body":{
            "account_identifier_id": "99985100130368965685",
            "account_identifier_type": "CONTRACT_NUMBER",
            "transaction":{
               "transaction_code": "PAYACC",
               "transaction_date":"2021-01-15 16:26:36.112",
               "amount":"50000.00",
               "currency":"AED",
               "billing_amount":"50000.00",
               "billing_currency":"AED",
               "description":"account Payment",
               "transaction_ref_number":"787686809930",
               "auth_code":"123456",
               "country":"ARE",
               "city":"Dubai",
               "external_ref_number":"",
               "rules_data":[
                  {
                     "key":"src_app_code",
                     "value":"X"
                  },
                  {
                     "key":"ext_user_id",
                     "value":"Y"
                  }
               ]
            }
         }
      }
   }
}

Response Parameters:

Node	Child Node	Type	Length	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. “ada123456fdsf”	Mandatory
	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: “REQ_ACCOUNT_TRANSACTION ”	Mandatory
	src_application	String	10	The src_application sent in the request will be sent back in response in this field. Source requesting channel e.g. “SSP”	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.	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 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	account_identifier_type	String	20	CONTRACT_NUMBER or EXTD	Mandatory
	account_identifier_id	String	32	454545XXXXXX1234	Mandatory
	response_code	Number	3	Return code	Mandatory
	status	String	50	Posting status	Mandatory

Response JSON

{
  "NISrvResponse": {
    "response_account_transaction": {
      "header": {
        "msg_id": "Rq-ACTxn-05",
        "msg_type": "TRANSACTION",
        "msg_function": "REP_ACCOUNT_TRANSACTION",
        "src_application": "BNK",
        "target_application": "WAY4",
        "timestamp": "2023-03-09T17:53:13.959+04:00",
        "tracking_id": "Rq-ACTxn-05",
        "bank_id": "NIC"
      },
      "exception_details": {
        "application_name": "TCC-ADP",
        "date_time": "2023-03-09T17:53:13.959+04:00",
        "status": "S",
        "error_code": "000",
        "error_description": "Success"
      },
      "body": {
        "account_identifier_id": "99985100130368965685",
        "account_identifier_type": "EXID",
        "response_code": "0",
        "status": "Waiting"
      }
    }
  }

Account Transaction

0 Comments

Docs Navigation