Bank Account Verification — Protean

What does this API do?

The Bank Account Verification API (powered by Protean eGov Technologies Ltd) allows lenders to verify the authenticity of a customer's bank account using the Penny Drop method. The API initiates a small test transaction to confirm that the account exists and is active, returning the account holder name and a verification status. This enables accurate beneficiary validation, reduces transaction failures, and supports regulatory compliance.

Who can use it?

Any lender or financial institution that has been onboarded to the ULI Platform and has subscribed to the Verify Bank Account service in the Platform Developer Portal.

Prerequisites

Complete all common platform prerequisites as described in Getting Started with ULI Platform APIs.

In addition, the following is specific to this API:

• Verify Bank Account Service Subscription: Subscribe to the Verify Bank Account service in the Platform Developer Portal (separately for Sandbox and Production). Refer to Section 10 of the SOP for Lender Onboarding for subscription steps.
• UAT Penny Drop Limit: Penny drop to a particular receiver bank account will work a maximum of 3 times in the UAT/Sandbox environment.

What are the API endpoints?

HTTP method: GET

URL path follows the convention: /{serviceName}/{ver}/{lang}

What headers are required?

What is the request body?

This API uses the HTTP GET method. All inputs are passed as HTTP headers — there is no request body.

What do the response fields mean?

Sample response:

{
  "result": {
    "errcode": "E000",
    "status": "success",
    "info": "Transaction Successful"
  },
  "data": {
    "account-name": "account holder name",
    "isverified": true
  },
  "meta": {
    "txncode": "1234",
    "ver": "1.2",
    "ts": "2023-03-24T14:31:39+0530"
  }
}

What are the error codes?

For the full list of platform-wide error codes, refer to the Latest Platform Error Code document. The following are Protean-specific error codes for this service:

Who do I contact for support?

If you encounter an issue, email support@rbihub.in with the following details:

• Subject: Bank Account Verification API Error
• Platform Service Name: Bank Account Verification
• Platform Environment: Sandbox or Production
• Service Provider code: 106
• Request payload (headers) sent to the platform
• Error code and error message received
• Prerequisites status: IP Whitelisting, URL Whitelisting, Service Subscription, Token Generation
• Screenshot or log of the error (as attachment)