Pennyless Bank Account Verification

Introduction

The Pennyless Bank Account Verification (BAV) API allows instant validation of customer bank accounts through the penny less mode, without the need to transfer any actual funds. Unlike the traditional penny drop approach, this method leverages direct banking rails to verify critical details such as account number, IFSC, and account holder name. By operating in penny less mode, the API ensures faster responses, reduces operational costs, and avoids reconciliation issues while maintaining high security and reliability.

API details

Endpoint

POST https://api.signzy.app/api/v3/bankaccountverification/penniless-v1

POST https://api-preproduction.signzy.app/api/v3/bankaccountverification/penniless-v1

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
beneficiaryAccount	String	The account number of the beneficiary.	Mandatory
beneficiaryIFSC	String	The IFSC code of the beneficiary's bank.	Mandatory
beneficiaryMobile	String	The mobile number of the beneficiary.	Optional
beneficiaryName	String	The name of the beneficiary.	Optional
nameMatchScore	String	It's a threshold value for name matching. If the API's name match score exceeds this, it returns "yes," otherwise "no."	Optional
nameFuzzy	String	Indicates whether a fuzzy match is performed for a name match.	Optional

{
    "beneficiaryAccount": "<Account Number>",
    "beneficiaryIFSC": "<IFSC code>",
    "beneficiaryMobile": "",
    "beneficiaryName": "John Doe",
    "nameFuzzy": "true",
    "nameMatchScore": "0.9"
}

Code samples

curl --location 'https://api.signzy.app/api/v3/bankaccountverification/penniless-v1' \
--header 'accept: /' \
--header 'accept-language: en-US,en;q=0.8' \
--header 'Authorization: ' \
--header 'content-type: application/json' \
--header 'X-Forwarded-For: 164.52.196.75' \
--data '{
    "beneficiaryMobile": "",
    "beneficiaryAccount": "",
    "beneficiaryName": "",
    "beneficiaryIFSC": "",
    "nameMatchScore": "",
    "nameFuzzy": true
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Contains the result of the API.
result.active	String	Indicates if the bank account is active. Possible values are: yes or no.
result.reason	String	Indicates whether the transaction was successful or not. The possible values are: success, Invalid account number or IFSC provided.
result.nameMatch	String	Contains the result of name match. The possible values are: yes, no.
result.mobileMatch	String	Contains the result of mobile number match.
result.signzyReferenceId	String	Unique reference ID generated by Signzy for the transaction.
result.auditTrail	Object	Contains the Audit trail details.
result.auditTrail.nature	String	The nature of the audit trail. In this case, it is the Bank Reference Response Number (RRN).
result.auditTrail.value	String	The value of the audit trail. In this case, it is the Bank Reference Response Number (RRN) for the transaction.
result.auditTrail.timestamp	String	The timestamp for the audit trail entry.
result.nameMatchScore	String	The match score of the beneficiary's name with the name associated with the bank account in the range 0 to 1.
result.bankTransfer.response	String	The response from the bank for the transaction.
result.bankTransfer.bankRRN	String	The Bank Reference Response Number (RRN) for the transaction.
result.bankTransfer.beneName	String	The name of the beneficiary associated with the bank account.
result.bankTransfer.beneMMID	String	The Mobile Money Identifier (MMID) of the beneficiary associated with the bank account.
result.bankTransfer.beneMobile	String	Mobile number of the beneficiary.
result.bankTransfer.beneIFSC	String	IFSC code of the beneficiary's bank.

{
  "error": {
    "name": "error",
    "message": "Upstream source/Government source internal server error. Please start the process again.",
    "reason": "error",
    "type": "Conflict",
    "statusCode": 409
  }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!