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/mobileToAccount

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

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
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!