Verify Account / Penny Test

This api will return the account holder name against the bank details provided

Production

https://payout.payumoney.com//payout/payment/verifyAccount

Testing

https://test.payumoney.com//payout/payment/verifyAccount

Request Header Params

Key	Description	Data type	Mandatory	possible Values
Authorization	Access token generated earlier.	String	Yes	Bearer {access_token}
payoutMerchantId	This is the merchant id provided while on-boarding	String	Yes
content-type	Request content type	String	Yes	application/x-www-form-urlencoded

payountMerchantId is different from payumoney merchant id, please check payouts dashboard or call customer support if you don’t know your payoutsMerchantID

Request Params

Key	Description	Data type	Mandatory	possible Values
accountNumber	Account Number	String	Yes
ifscCode	Ifsc Code	String	Yes
merchantRefId	Unique identifier from merchant to identify the status	String	Yes	It can be any auto incremental value
amount	Amount to be transfer for penny	Double	No	Default value randomly between 1 Rs. to 1.10 Rs. Max possible amount is 10 Rs.
validateIfsc	to validate IFSC or not	Boolean	No	true/false
beneName	beneficiary name	String	Only when nameMatching is true	alpha-numeric string
nameMatching	to check name matching	Boolean	No	true/false
purpose	purpose	String	Yes	alpha-numeric string

Example

Sample Request :

curl --location --request POST 'https://test.payumoney.com/payout/payment/verifyAccount' \
--header 'Authorization: Bearer c9d6fbde1b730e4d3d6c4e68002974097bb7fbc173e83aa68dd43064e502ed16' \
--header 'payoutMerchantId: 1111594' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cache-Control: no-cache' \
--data-urlencode 'accountNumber=51234567890' \
--data-urlencode 'ifscCode=HDFC0001098' \
--data-urlencode 'merchantRefId=987668124234235' \
--data-urlencode 'validateIfsc=true' \
--data-urlencode 'beneName=Ankush Pokarana' \
--data-urlencode 'nameMatching=true' \
--data-urlencode 'purpose=Test'

Response :

Success

{
    "status": 0,
    "msg": null,
    "code": null,
    "data": {
        "accountExists": "YES",
        "beneficiaryName": "Ankush Pokarana",
        "nameMatch": 59.45121951219513,
        "status": "Success",
        "error": ""
    }
}

Failure

{
    "status": 0,
    "msg": null,
    "code": null,
    "data": {
        "accountExists": "No",
        "beneficiaryName": "",
        "status": "Success", 
        "error": "Invalid Benificiary MMID/Mobile Number"
    }
}