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.
| URL: To be shared by your organization. |
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 |
| device_serial_no | Serial Number of the device used for transaction. E.g. - "6L764548" | String | Mandatory (for Auth Success) and Optional (for Auth Declined) |
| mobile_number | Mobile Number. E.g. - "9337836751" | String | Mandatory (for Auth Success) and Optional (for Auth Declined) |
| balance_amount | Balance Amount. E.g. - "1,831.30" | String | Mandatory (for Auth Success) and Optional (for Auth Declined) |
Sample Request Body
mATM Cash Withdrawal:
mATM Balance Enquiry (Auth Success):
mATM Balance Enquiry (Auth Declined):
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 :
FAILED:
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. |
