Description - Your organization will provide us a Call-back URL with the following configurations:

• The Call-back URL should be of Method Type POST
• Content-type should be of Type application/JSON.
• The Call-back URL should have the below request format. The Response also has been provided for your reference.

Headers

---

Content-Type: application/JSON

Request Body Parameters

Parameter	Parameter description with validation and examples	Data Type	Mandatory/ Not Mandatory
statusDesc	Status Description. Must not be NULL. E.g. - 'Transaction Successfull'	String	Mandatory
createdDate	Created Date. Must Not be NULL. E.g. - 2022-11-02 12:12:13	String	Mandatory
updatedDate	Date of Update. Must Not be Null. E.g. - 2022-11-02 12:12:50	String	Mandatory
productCode	Product Code. Must not be NULL. E.g. - POS	String	Mandatory
txnType	Transaction Type. Must not be NULL. E.g.-Sale@POS	String	Mandatory
txnAmount	Transaction Amount. Must not be NULL. Should be between 100 and 100000. E.g. - 2000	String	Mandatory
txnDateTime	Transaction Date and Time. It must Not be NULL. E.g - 2022-11-02 12:12:50	String	Mandatory
customeridentIfication	Customer Identification (Card Number). Must not be NULL. 16 digit card number. E.g. - xxxx-xxxx-xxxx-5604	String	Mandatory
status	Status of Transaction. Must not be NULL. E.g.- SUCCESS	String	Mandatory
rrn	rrn number. Generated from bank’s end. length = 12. Should not be NULL E.g.-230612077853	String	Mandatory
txnId	Transaction ID. It must Not be NULL. length ≤ 20 E.g. - 1037255263620431872	String	Mandatory
username	User Name. Must not be NULL. E.g.-Sagarikatest	String	Mandatory
ClientRefID	Client Reference ID. Must not be NULL. length ≤ 18 E.g. - 20720	String	Mandatory
param_b	To be used as per discretion. Must not be NULL. length ≤ 20	Alphanumeric String	Mandatory
param_c	To be used as per discretion. Must not be NULL. length ≤ 20	Alphanumeric String	Mandatory

Sample Request Body 

AEPS Balance Enquiry

{ "statusDesc": "Transaction Successfull", "createdDate": "2022-09-28 21:55:16", "updatedDate": "2022-09-28 21:55:17", "productCode": "AEPS", "txnType": "AEPS_BALANCE_ENQUIRY", "txnAmount": "0", "txnDateTime": "", "customeridentIfication": "xxxx-xxxx-3119", "status": "AUTH_SUCCESS", "rrn": "227116111956", "txnId": "1024635399164665856", "username": "1919010100002661", "ClientRefID": "123211111", "param_b": "", "param_c": "" }

 

AEPS Cash Withdrawal

{ "statusDesc": "Transaction Successfull", "createdDate": "2022-09-28 21:55:16", "updatedDate": "2022-09-28 21:55:17", "productCode": "AEPS", "txnType": "AEPS_CASH_WITHDRAWAL", "txnAmount": "100", "txnDateTime": "", "customeridentIfication": "xxxx-xxxx-3119", "status": "AUTH_SUCCESS", "rrn": "227116111956", "txnId": "1024635399164665856", "username": "1919010100002661", "ClientRefID": "1212221111", "param_b": "", "param_c": "" }

 

AEPS Mini Statement

{ "statusDesc": "Transaction Successfull", "createdDate": "2022-09-28 21:55:16", "updatedDate": "2022-09-28 21:55:17", "productCode": "AEPS", "txnType": "AEPS_MINI_STATEMENT", "txnAmount": "100", "txnDateTime": "", "customeridentIfication": "xxxx-xxxx-3119", "status": "AUTH_SUCCESS", "rrn": "227116111956", "txnId": "1024635399164665856", "username": "1919010100002661", "ClientRefID": "1212221111", "param_b": "", "param_c": "" }

Aadhar Pay

{ "statusDesc": "Transaction Successfull", "createdDate": "2022-09-28 21:55:16", "updatedDate": "2022-09-28 21:55:17", "productCode": "AADHAR", "txnType": "AADHAAR_PAY", "txnAmount": "100", "txnDateTime": "", "customeridentIfication": "xxxx-xxxx-3119", "status": "AUTH_SUCCESS", "rrn": "227116111956", "txnId": "1024635399164665856", "username": "1919010100002661", "ClientRefID": "1212221111", "param_b": "", "param_c": "" }

Response Body Parameters

Parameter	Parameter description with examples	Data Type
status	Transaction status code (0 for Success and 1 for Failure)	String
statusDesc	Corresponding message of the status (Success or Failure)	String

Sample Response Body

Success :

{ "status": 0, "statusDesc": "success" }

FAILED:

{ "status": 1, "statusDesc": "Failure" }

Status Codes

Code	Significance	Description
0	SUCCESS	Successful
1	FAILED	Unsuccessful

 

NOTE: In case of a successful response it won’t be retried any more and in case of a failed response it will retried for 2 times.