Set Primary VPA
Sets the specified VPA as the primary VPA for the user. The primary VPA is the default UPI ID used for transactions. Only one VPA can be primary at a time. If the VPA is already set as primary, returns UPI_116.
Request Body
application/json
Device and SIM information required for UPI API authentication and tracking
Channel or institution code
Sequence number for request tracking
VPA (UPI ID) in username@handle format. Username can be alphanumeric with dots and underscores. Handle must be a supported handle configured by M2P.
Response Body
application/json
curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/profile/setAsPrimaryVpa" \ -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": "804", "vpaId": "amit.patel@indie" }'{
"status": "SUCCESS",
"exception": null,
"seqNo": "804",
"message": "VPA set as primary",
"result": "TRUE"
}Manage VPA (Enable, Disable, Delete) POST
Performs actions on an existing VPA. Supported actions are ENABLE (activate a disabled VPA), DISABLE (temporarily deactivate a VPA), and DELETE (permanently remove a VPA). Primary VPA cannot be deleted or disabled - change the primary VPA first. Deleting a VPA with active collect requests or mandates requires resolving them first.
Validate VPA for Deregistration POST
Validates whether a VPA can be deregistered (deleted). Checks for active collect requests, active mandates, and UPI number linkage that would prevent deletion. Use this before calling the VPA delete action to get a clear pre-check.