Mobile To Account Details API
Introduction
Customers rarely remember or share full bank account details during digital transactions — most only provide their mobile number. This leads to delayed refunds, failed payouts, onboarding drop-offs, and compliance gaps.
The Mobile to Account Number API solves this by instantly mapping a mobile number to the customer’s verified account number, IFSC, account holder name, and UPI VPA, enabling secure, error-free transactions.
Real-life Scenarios
- Refunds: Process instant refunds without asking for account details.
- Onboarding: Eliminate drop-offs by auto-fetching account info from mobile numbers.
- Payouts: Credit gig workers, gamers, or borrowers directly using just their mobile number.
- Compliance: Verify account ownership against mobile numbers for AML/KYC checks.
By turning a mobile number into a reliable gateway for financial details, this API removes friction, reduces errors, and speeds up digital transactions.
API details
Endpoint
POST https://api.signzy.app/api/v3/bankaccountverification/mobileToAccountPOST https://api-preproduction.signzy.app/api/v3/bankaccountverification/mobileToAccountRequest 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 |
|---|---|---|---|
mobileNumber | String | The mobile number of the user | Mandatory |
{
"mobileNumber": ""
}Code samples
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.signzy.app/api/v3/bankaccountverification/mobileToAccount"
method := "POST"
payload := strings.NewReader(`{
"mobileNumber": ""
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Authorization", "")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}Response body parameters
Parameter | Data Type | Description |
|---|---|---|
result | Object | Contains the result of the API. |
result.status | String | The status of the transaction |
result.signzyRefId | String | signzyRefId for the transaction |
result.rrn | String | rrn of the transaction |
result.accountNumber | String | account number fetched |
result.ifsc | String | ifsc fetched |
result.nameAtBank | String | name at bank |
result.vpa | String | vpa |
result.paymentModeCode | String | payment mode identifier |
result.amountDeposited | String | amount deposited |
# Successful (Active)
{
"result": {
"status": "SUC****",
"signzyRefId": "H25090919011362051190*****",
"rrn": "5252009*****",
"accountNumber": "0000002010737*****",
"ifsc": "SBIN00*****",
"nameAtBank": "AK*****",
"vpa": "9*********@*****",
"paymentModeCode": "UPIMO*****",
"amountDeposited": "0.*****"
}
}
# Succesful (Inactive)
{
"result": {
"status": "FAILURE",
"message": "Failure",
"signzyRefId": "E25090919534774040*******"
}
}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!