Body
Beneficiary Validation / Creation
THIS PAGE IS MOVE TO THE LINK HERE
Merchant can create and validate beneficiary bank account, UPI VPA using this API.
Note
If the merchant only intends to create the beneficiary, use command “CREATE”
Juspay chooses penniless or Penny drop validation depending on banks supported (List here
) and routing logic. Please note this is available only for Juspay account based validation.
Request
Response
API Endpoints
Sandbox Link
POST
https://sandbox.juspay.in/payout/merchant/v2/benedetails
Production Link
POST
https://api.juspay.in/payout/merchant/v2/benedetails
Authorization Header
Basic Auth
*
String
Mandatory
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Headers
x-merchantid
string
Please pass merchant id provided by Juspay
Parameters
beneId
*
string
Required
For each verification to have a unique reference
customerId
*
string
Required
Merchant customerId
beneDetails
object
Json Object for bene details
details
object
name
String
name of beneficiary
Example:- *Do not pass any special characters in name
ifsc
*
String
Required
IFSC code of bene bank account. Required for ACCOUNT_IFSC
account
*
String
Required
Account number of beneficiary. Required for ACCOUNT_IFSC
vpa
*
String
Required
VPA to be verified. Required for UPI_ID type when mobile is not being passed
mobile
*
String
Required
Mobile number against which primary VPA needs to be fetched. Required for UPI_ID type when vpa is not being passed
type
*
string
Required
Type of beneficiary validation. UPI_ID/ACCOUNT_IFSC/IFSC
command
string
Action recommended to Juspay on provided beneficiary details.
‘VALIDATE’ - this command will create and validate the beneficiary
‘CREATE’ - this command will create the beneficiary at Juspay end
email
string
Email id of beneficiary
phone
string
Phone number of beneficiary
metadata
Object
Additional information to be passed
webhookDetails
Json Object
Dynamic webhook detail
url
String
URL to which callback needs to be sent
username
String
Please provide username if there is any authorization
password
String
Please provide password if there is any authorization
customHeader
String
Please provide headers that are required mandatorily
200 : Success
Response Body
status
String
Status of the validation.
Example:- VALID | INVALID | ERROR | TIMEOUT | PENDING
uniqueId
String
beneId passed by the merchant in the request
beneDetails
Object
Details of beneficiary included in the request
details
Object
Details of beneficiary included in the request
name
String
Name of beneficary passed in the request
vpa
String
account
String
ifsc
String
type
String
Type of validation performed by the merchant
Example:- UPI_ID | ACCOUNT_IFSC
nameAtBank
String
Name derived from the beneficiary bank
responseCode
String
Juspay Response Code for Validation.
Below are the possible values of responseCode in Juspay Validation Suite:
1. For Account Validation Use case:
ACCOUNT_IS_VALID, VALIDATION_IN_PROGRESS, UNABLE_TO_VALIDATE, INVALID_BANK_ACCOUNT, INVALID_IFSC, ACCOUNT_BLOCKED, ACCOUNT_CLOSED, NON_RESIDENT_EXTERNAL_ACCOUNT, ACCOUNT_DOES_NOT_EXIST, INVALID_NAME
2. For VPA Verification Use Case:
VALID_VPA, INVALID_VPA, UNABLE_TO_VALIDATE
responseMessage
String
Juspay Response Message for Validation.
Below responseMessage will be received for Account Validation:
VALIDATION_SUCCESSFULL, VALIDATION_IN_PROGRESS, UNABLE_TO_VALIDATE
Below responseMessage will be received in case of VPA Verification:
Example:- Vpa is valid |unable to validate vpa | Vpa is invalid
validationType
String
Type of Validation Performed
Example:- UPI | PennyDrop | Pennyless | UPIACCIFSC
createdAt
String
Validation transaction creation timestamp
updatedAt
String
Validaiton transaction updation timestamp
transactions
Array
Validation transaction(s) details
400 : Invalid Input data
Response Body
error
boolean
errorCode
string
E05
errorMessage
string
Duplicate BeneId.
userMessage
string
Bad request