m2pfintech
API LibraryAccount Management

Validate Address Response

Fetches the result of a previously initiated address validation. Returns the validated payee name and VPA details on success. Pass the callbackRef from validateAddReq.

POST
/upi/v1/wrapper/profile/validateAddRes

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string

Channel or institution code

seqNo*string

Sequence number for request tracking

callbackRef*string

Callback reference ID received from the initiating async API call

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/profile/validateAddRes" \  -H "Content-Type: application/json" \  -d '{    "deviceInfo": {      "deviceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",      "simId": "8991101200003204510",      "deviceType": "MOB",      "os": "Android",      "telecom": "Airtel",      "geoCode": "13.0827,80.2707",      "appId": "v2.0",      "ipAddress": "192.168.1.50",      "location": "Mumbai",      "mobile": "919876501234"    },    "channelCode": "HDFC0001234",    "seqNo": "309",    "callbackRef": "validate-add-uuid-789"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "309",
  "result": {
    "payeeName": "Recipient Name",
    "payeeVpa": "recipient@upi",
    "valid": true
  }
}

Validate Address Request POST

Initiates validation of a UPI address (VPA) to verify it exists and is active on the UPI network. This is an asynchronous API - use validateAddRes with the callbackRef to get the validation result. Used to verify a payee VPA before initiating a payment.

Check Balance Request POST

Initiates a balance inquiry for a linked bank account. The encrypted UPI PIN block is required for authentication. This is an asynchronous API - use checkBalanceRes with the callbackRef to get the actual balance.