Description - This API is used to transfer funds from customer’s account to any beneficiary(from any bank).
Headers
| Content-Type: application/JSON |
| client_id: To be shared during integration |
| client_secret: To be shared during integration |
Request Body Parameters
| Parameters | Parameter description with validations and examples | Attribute type | Mandatory/ Not Mandatory |
| beneName | Beneficiary name. Maximum Length - 100. E.g. - "Nitya" | String | Not Mandatory |
| beneAccountNo | Account Number to be validated. Maximum Length - 20. E.g. - "026291800001191" | String | Mandatory |
| beneifsc | Beneficiary bank IFSC code. Maximum Length - 11. E.g. - "SBIN0001083" | String | Mandatory |
| benePhoneNo | Mobile Number of beneficiary. Maximum Length - 10 E.g.- 7381279922 | Integer | Mandatory |
| beneBankName | Bank name of the beneficiary. E.g.- "HDFC BANK LTD" | String | Mandatory |
| clientReferenceNo | Customer reference number.Minimum Length - 12 and Maximum Length - 22.No special characters or space is allowed. E.g.- " 20345231230294" | Alphanum eric | Mandatory |
| amount | Amount to be transferred to the beneficiary E.g. - 100 | Integer | Mandatory |
| fundTransferType | Mode of payment(IMPS/NEFT), E.g.- IMPS/NEFT | String | Mandatory |
| pincode | Pin code of the transaction initiator. Maximum Length - 6, E.g.- 751024 | Integer | Mandatory |
| custName | Name of the customer. Maximum Length - 25 E.g.- "Vijay Nayak" | Alphanum eric | Mandatory |
| custMobNo | Mobile Number of customer. Maximum Length - 10 E.g.- 9821361027 | Integer | Mandatory |
| custIpAddress | Customer IP Address. E.g. - "49.249.100.78" | String | Mandatory |
| latlong | Lat longitude of the transaction initiator. Maximum Length - 22, Eg- "22.8031731,88.7874172". | String | Mandatory |
| paramA | To be used as per client’s discretion. | String | Not Mandatory |
| paramB | To be used as per client’s discretion. | String | Not Mandatory |
Response Body Parameters
| Parameters | Parameter description | Data type |
| status | This field displays the actual status of a transaction. (Possible status - SUCCESS,FAILED,INPROGRESS,REF UNDED) | String |
| subStatus | This field describes the statusCode of a transaction. Eg- success - 0, inprogress – 1, failed - -1 | String |
| statusDesc | Description of the status of the transaction | String |
| rrn | This is a unique number generated by the bank/NPCI for each transaction, the customer can inquiry the transaction using this number or referenceNo generated by Corporate | String |
| transactionId | iServeU system generated unique transaction id | Integer |
| beneName | Beneficiary name as per Bank record. | String |
| beneAccountNo | Account Number to be validated | String |
| beneifsc | Beneficiary bank IFSC code | String |
| benePhoneNo | Mobile Number of customer | String |
| beneBankName | Beneficiary bank name | String |
| clientReferenceNo | Customer Reference number shared by the customer during transaction initiation | String |
| txnAmount | Amount transferred to the beneficiary | Integer |
| txnType | Mode of payment (IMPS/NEFT) | String |
| latlong | Lat longitude of the transaction initiator E.g.- "22.8031731,88.7874172" | String |
| pincode | Pin code of the transaction initiator | String |
| custName | Name of the customer | String |
| custMobNo | Mobile no of the customer | String |
| dateTime | Date time of the transaction in mm-dd-yyyy hh:mm:ss (E.g.- 09-23-2022 05:03:20) | String |
| paramA | For Future Use | String |
| paramB | For Future Use | String |
Mode of Pay: IMPS
Request Body
Response for SUCCESS, INPROGRESS, FAILED Scenario
Success :
IN PROGRESS:
FAILED-1:
FAILED-2:
FAILED-3:
Response Codes
| Status | Status Code | Description |
| FAILED | -1 | Failed from Bank |
| FAILED | 2 | Failed from wallet |
| FAILED | -2 | Failed from IServeU |
| INPROGRESS | 1 | Transaction In Progress |
| SUCCESS | 0 | Transaction success |
|
NOTE: For different Request we need to use unique client reference id. |
