Hybrid Bank Account Verification

Introduction

Introducing the Hybrid Bank Account Verification API – a cutting-edge solution revolutionizing the verification process for financial institutions and businesses alike. With seamless integration, this API simplifies the verification of bank account details by accepting inputs of account number and IFSC code, and effortlessly routes transactions across different networks.

Designed for over 80 banks supporting penniless transactions, the API ensures zero loss by efficiently routing transactions without dropping a single penny. By leveraging advanced routing algorithms, it swiftly identifies the optimal network for each transaction, guaranteeing precision and reliability in every verification.

For banks that necessitate penny drop transactions, the API conducts penny drops to retrieve comprehensive account details securely and accurately. This meticulous approach ensures thorough verification while maintaining utmost security and compliance standards.

Beyond basic verification, the Hybrid Bank Account Verification API provides comprehensive insights, including the bank account holder's name and the current status of the bank account. This invaluable feature empowers businesses with the information needed to make informed decisions swiftly and confidently.

Whether it's for regulatory compliance, customer onboarding, or transaction processing, the Hybrid Bank Account Verification API sets a new standard in efficiency, accuracy, and reliability, streamlining operations and enhancing trust in every transaction.

API details

Endpoint

POST https://api.signzy.app/api/v3/bankaccountverification/bankaccountverifications

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

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. The threshold value for the fuzzy match is 0.7	Optional
fetchAccountNumber	boolean	to be passed true if account number is needed in the output response	Optional

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

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/bankaccountverification/bankaccountverifications' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Token>' \
--data '{
    "beneficiaryAccount": "<Account Number>",
    "beneficiaryIFSC": "<IFSC code>",
    "beneficiaryMobile": "",
    "beneficiaryName": "John Doe",
    "nameFuzzy": "true",
    "nameMatchScore": "0.9"
}'

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.

// When API key is not passed
{
    "message": "No API key found in request"
}

// when wrong API Key is passed
{
    "message": "Invalid authentication credentials"
}

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!