5. Transaction Details

To extract the additional details of merchant and creditor transaction details, A REST based API is provided as below. The API requires a basic authentication process which is completed using the provided app id as user name along with password. JSON request must contain merchant id, app id, reference id, transaction amount and token. Reference Id is the TXNID field value supplied during the payment request as described in previous sections. Token is basically a hash value signed with the digital certificate of the creditor.

URL: https://{base_url}/connectipswebws/api/creditor/gettxndetail

Basic Authentication: 
 
User Id: <App Id> 
Password: <Password> 
 
Example: 
User Id: MER-550-APP-1 
Password: <Password provided in email> 
 
Hashing String Format for token: 
MERCHANTID=<MerchantId>,APPID=<AppId>,REFERENCEID=<TXNIDintheRequest>,TXNAMT=<Transacti
on Amount in paisa> 
Example: 
Request: Same as that of validatetxn.

Response:

{ 
 "status": "SUCCESS", 
 "statusDesc": "TRANSACTION SUCCESSFUL", 
 "merchantId": 980, 
 "appId": "MER-980-APP-1", 
 "referenceId": "100sadf45", 
 "txnAmt": 1000.00, 
 "token": null, 
 "debitBankCode": "2501", 
 "txnId": 12422440, 
 "batchId": 712095958, 
 "txnDate": 1670482848997, 
 "txnCrncy": null, 
 "chargeAmt": 200.00, 
 "chargeLiability": "CG", 
 "refId": "100",
 "remarks": "test remarks", 
 "particulars": "test particular", 
 "creditStatus": "000" 
} 

Payment validation response parameters:

#	Field Name	Description
1	status	Status to be considered for transaction response.
2	statusDesc	Description of the status of transaction
3	merchantId	Unique identifier to identify merchant in the system.
4	appId	Unique identification, which will be used to identify the account details of the merchant’s application.
5	referenceId	Transaction id passed by the merchant in gateway login page.
6	txnAmt	Transaction amount in paisa.
7	debitBankCode	Debit bank account’s code. (Customer’s bank account code)
8	txnId	NCHL’s transaction Id.
9	batchId	NCHL’s batch Id.
10	txnDate	Date of the transaction.
11	txnCrncy	Currency of the transaction.
12	chargeAmt	Charge amount in paisa.
13	chargeLiability	Charge Liability on: MN=Merchant, CG=Customer etc.
14	refId	Reference Id passed in the gateway login page.
15	remarks	Remarks passed in the gateway login page.
16	particulars	Particulars passed in the gateway login page.
17	creditStatus	Status of the transaction at merchant’s end. (000, 999 and DEFER=Success otherwise failed.)