API Details - Payee Name Validation
Description - This API is used to generate Static QR Code for UPI.
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 | Data type | Mandatory/ Not Mandatory |
| beneName | Beneficiary name. Maximum Length - 100. E.g. - "Nitya" | String | Mandatory |
| beneName | Account Number to be validated. Maximum Length - 20. E.g. - "026291800001191" | String | Mandatory |
| beneName | Beneficiary bank IFSC code. Maximum Length - 11. E.g. - "SBIN0001083" | String | Mandatory |
| benePhoneNo | Mobile Number of beneficiary. Maximum Length - 10 E.g.- 7381279922 | Number | Mandatory |
| beneBankName | Beneficiary bank name E.g.- "State Bank Of India" | String | Mandatory |
| clientReferenceNo | Customer reference number. Maximum Length - 20 E.g.- "20345231230294" | String | Mandatory |
| latlong | Lat longitude of the transaction initiator. Maximum Length - 22 Eg- 22.8031731,88.7874172 | String | Mandatory |
| pincode | Pin code of the transaction initiator. Maximum Length - 6, E.g.- 751024 | Number | Mandatory |
| custName | Name of the customer. Maximum Length - 100 E.g.- "Vijay Nayak" | String | Mandatory |
| custMobNo | Mobile Number of customer. Maximum Length - 10 E.g.- 9821361027 | Number | 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 |
Mode of Pay: IMPS
Sample Request and Response
Request Body
| Parameter | 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 | String |
| 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 |
| latlong | Lat longitude of the transaction initiator Eg- 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 (eg- 09-23-2022 05:03:20) | String |
| paramA | For Future Use | String |
| paramB | For Future Use | String |
Sample Response Body
SUCCESS:
Request and Response for INPROGRESS, FAILED Scenario(1).
Request Body
INPROGRESS
FAILED 1
Request and Response for FAILED Scenario(2)
Request Body
FAILED 2
FAILED 3
FAILED 4
FAILED 5
Success Status, Status Code and Status Description
| Status | Status Code | Description |
| FAILED | -1 | Failed from Bank |
| FAILED | -2 | Failed from IServeU |
| FAILED | 2 | Failed from wallet |
| INPROGRESS | 1 | Transaction In Progress |
| SUCCESS | 0 | Transaction success |
