get https://api.juspay.in/payout/merchant/v1/benedetails//
Merchant can check status of account validation which are in pending status
The response for this API includes a JSON block for Validation Details and a block for Beneficiary Details: (click to open tables)
| Parameter | Type | Description |
|---|---|---|
| validateResp:wwwwwwww {param1, param2,.,object} | Object | Object containing validation and account status details |
Parameters for validateResp object:(Validation Response parameters -- click to open)
| Field | Type | Description |
|---|---|---|
| subCode | String | HTTP status code of response Example: "200" |
| status | String | "SUCCESS" unless otherwise indicated:Status codes and meaningSUCCESS This means that the validation request has been successfully executed. PENDING This would mean that the validation request has been queued with JusPay or with the downstream system. FAILURE We were unable to process the validation request successfully. You have to try again with a new uniqueId.MANUAL_REVIEW This would mean that the validation request was sent an ambigious response from the payment gateway and the merchant has to manually reconcile it with the payment gateway to get the proper response. Also, any validation requests which are in pending for more than 10 days are sent for manual review. |
| message | String | Message (if any) regarding the result. Example: "VPA verification successful" |
| accountStatusCode | String | Status code for account. Required for ACCOUNT_IFSC type response. Example: "ACCOUNT_IS_VALID" |
| accountStatus | String | Status of account. Required for ACCOUNT_IFSC type response. Example: "VALID" |
| data:wwwwwwwwwwwnt {param1, param2, ...} | Object Strings | Information on beneficiary's account. (See table below for parameters) |
Parameters for
data object: UPI_ID response:
| Parameter | Type | Description |
|---|---|---|
| nameAtBankwwiw | String | Name used for beneficiary at bank |
| accountExists | String | "YES" or "NO" |
ACCOUNT_IFSC response:
| utr | String | |
| refId | String | Reference ID used for bank |
| nameAtBank | String | Name used for beneficiary at bank |
| micr | String | |
| city | String | City location of bank |
| branch | String | Branch location of bank |
| bankName | String | Name of bank |
| amountDeposited | String | Total amount deposited |
| uniqueId | String | Each verification is assigned a unique reference |
| statuswwiwww | String | "VALID" or "INVALID" |
| remark | String | For example: "VPA verification successful" |
| nameAtBank | String | Name used for beneficiary at bank |
| fulfillmentMethod | String | Method used for fulfillment - for instance: “CFGEN_UPI” or ”CASHFREE_IMPS” |
| beneDetails:wwwwwwwww {param, object} | Object | JSON object for beneficiary details |
Parameters for beneDetails object:(Beneficiary Details parameters -- click to open)
| Parameter | Type | Description |
|---|---|---|
| typewwwwwwwwwwwww | String | Type of beneficiary validation. UPI_ID/ACCOUNT_IFSC/IFSC UPI_ID is for VPA validation, and ACCOUNT_IFSC or IFSC is for account validation. |
| details: {param1, param2,...} | Object Strings | JSON object for name/account details of beneficiary |
Parameters for
details object: | Parameter | Type | Description |
|---|---|---|
| namewwwwwwwwwwwi | String | name of beneficiary |
| vpa | String | VPA to be verified. Required for UPI_ID type response. |
| ifsc | String | IFSC code of beneficiary's bank account. Required for ACCOUNT_IFSC type response. |
| account | String | Account number of beneficiary. Required for ACCOUNT_IFSC type response. |
⭣
The request for this API consists of two Path parameters: customerId and beneId, and a Header: your_api_key.