Hey! These docs are for version 3.2, which is no longer officially supported. Click here for the latest version, 1.0!

IFSC Validation

Merchant can validate beneficiary bank account, VPA using this API

The response for this API includes a JSON block for Validation Details and a block for Beneficiary Details:     (click to open tables)
ParameterTypeDescription
validateResp:wwwwiww
 {param1, param2,.,object}
ObjectObject containing validation details
  Parameters for validateResp object:
(Validation Response parameters  --   click to open)
FieldTypeDescription
subCodeStringHTTP status code of response
Example: "200"
statusString"SUCCESS" unless otherwise indicated:
  Status codes and meaning
SUCCESS
    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.
messageStringMessage (if any) regarding the result.
Example: "VPA verification successful"
data:wwwwwwwwwwwnn
   {param1, param2, ...}
Object
Strings
Information on beneficiary's account.
(See table below for parameters)
 Parameters for data object:
upiStringMode of payment to a beneficiary (push to VPA)
swiftCodeString
stateString
rtgsString
neftStringMode of payment to a beneficiary (payment rail)
nbinInteger
micrInteger
impsStringMode of payment to a beneficiary (payment rail)
ifscSubcodeStringSubcode for IFSC
ifscStringIFSC code of beneficiary's bank account.
ftString
cityStringCity location of bank
categoryString
cardStringType of card
branchStringBranch location of bank
bankStringName of bank
addressStringAddress of bank
beneIdStringUnique reference ID for the verification request
statuswwiwwwString"VALID" or "INVALID"
remarkStringFor example: "VPA verification successful"
fulfillmentMethodStringMethod used for fulfillment - for instance: “CFGEN_UPI” or ”CASHFREE_IMPS”
beneDetails:wwwwwwwww
   {param, object}
ObjectJSON object for beneficiary details
  Parameters for beneDetails object:
(Beneficiary Details parameters  --   click to open)
ParameterTypeDescription
typewwwwwwwwwwwwwStringType of beneficiary validation.
UPI_ID/ACCOUNT_IFSC/IFSC
"IFSC" in this instance
details:
   {param1, param2,...}
Object
Strings
JSON object for name/account details of beneficiary
 Parameters for details object:
ParameterTypeDescription
ifsc wwwwwwwwwwwiStringIFSC code of beneficiary's bank account. Always sent in IFSC type response.
Request Parameter Details     (click to open table)
- includes object for Beneficiary Details
ParameterTypeDescription
beneId*StringUnique reference ID for the verification request
preferredGatewaywwwwStringPreferred gateway through which beneficiary validation is required to happen
beneDetails:
   {param, object}
*ObjectJSON object for beneficiary details
    Parameters for beneDetails object:
ParameterTypeDescription
typewwwwwwwwwww*StringType of beneficiary validation.
UPI_ID/ACCOUNT_IFSC/IFSC
"IFSC" in this instance
details:
   {param1, param2,...}
*ObjectJSON object for IFSC details of beneficiary
 Parameters for details object:
ParameterTypeDescription
namewwwwwwwwwStringname of beneficiary
vpa*StringVPA to be verified. Only required for UPI_ID type validation.
ifsc*StringIFSC code of beneficiary's bank account that has to be verified. Always required for IFSC verification
account*StringAccount number of beneficiary. Only required for ACCOUNT_IFSC type validation.
* = Required
* = Conditionally required depending on type
Language
Authentication
Basic
base64
:
Click Try It! to start a request and see the response here!