• Register

Financial Posting

This service is used for fetching the Summary of all instalment plans for specified card.

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: "TRANSACTION" Mandatory
msg_function String 50 Function name to be used Default:  "REQ_FINANCIAL_POSTING" Mandatory
src_application String 10 Source requesting channel e.g. “IB” or "IVR" etc. Might change. Mandatory
target_application String 10 Target application name Ex. : "WAY4" or "DCMS" or "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 e.g. “XXXX” Mandatory
instance_id String 10 N/A Optional
body card_identifier_id String 16 or 19 digits card or account number 454545XXXXXX1234 Mandatory 
card_identifier_type String 32 CONTRACT_NUMBER  or EXID Mandatory
transaction_type String 32 Transaction Type Mandatory
posting_scope String 1 A' or 'C' (A for Account , C for Card) Optional
currency String 3 Currency Mandatory
amount String 18 Amount Mandatory
description String 255 Transaction description Optional
transaction_ref_number String 12 Transaction reference number Mandatory
transaction_date String 10 (Format  DD/MM/YYYY) Transaction date Optional

 

  Request JSON

{
  "NISrvRequest":{
    "request_financial_posting":{
      "header":{
        "msg_id":"236021",
        "msg_type":"ENQUIRY",
        "msg_function":"REQ_FINANCIAL_POSTING",
        "src_application":"IVR",
        "target_application":"WAY4",
        "timestamp":"2022-11-16T10:49:02.366+04:00",
        "tracking_id":"236021",
        "bank_id":"bankID"
      },
      "body":{
        "card_identifier_id":"454545XXXXXX1234",
        "card_identifier_type":"CONTRACT_NUMBER/EXID",
		"transaction_type":"MC-MF-STMT_FEE",
		"posting_scope": "C",
		"currency":"AED",
		"amount":"900",
		"description":"Manual Fee",
		"transaction_ref_number":"220518144629",
		"transaction_date":"2022-01-15 16:26:36"
		}
    }
  }
}

 

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.
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 Function name to be used Default:  "REP_FINANCIAL_POSTING" 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. “IB” or "IVR" etc
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 card_identifier_id String 16 or 19 digits card or account number 454545XXXXXX1234 Mandatory
card_identifier_type String 32 CONTRACT_NUMBER  or EXID Mandatory
response_code String 4 Response code Optional
status String 1 Status of the request (S/F)
Success- S,  Failure - F
Optional
transaction_ref_number String 20 Transaction reference number Optional

 

 Response JSON

{
  "NISrvResponse":{
    "response_FINANCIAL_POSTING":{
       "header":{
        "msg_id":"236021",
        "msg_type":"ENQUIRY",
        "msg_function":"REP_GET_PLAN_LIST",
        "src_application":"IVR",
        "target_application":"WAY4",
        "timestamp":"2022-11-16T11:06:36.588+04:00",
        "tracking_id":"236021",
        "bank_id":"bankID",
        "instance_id":"236021"
      },
      "exception_details":{
        "application_name":"TCC_ADP",
        "date_time":"2022-11-16T10:33:47.934+04:00",
        "status":"S",
        "error_code":"000",
        "error_description":"Success",
      },
      "body":{
        "card_identifier_id":"454545XXXXXX1234",
        "card_identifier_type":"CONTRACT_NUMBER/EXID",
		"transaction_type":"MC-MF-STMT_FEE",
		"response_code": "000",
		"status":"S",
		"transaction_ref_number":"220518144629",
	  }
	}
  }
}

Docs Navigation