Create VPA
Creates a new VPA (UPI ID) for the user. Call checkIfVpaAvailable first to verify the VPA is available. Registers the VPA with NPCI and associates it with the users profile. The VPA consists of a username and a handle separated by @ (e.g. amit.patel@indie). The handle must be a supported handle configured by M2P for your channel. Users can have multiple VPAs up to a configured maximum.
Request Body
application/json
Device and SIM information required for UPI API authentication and tracking
Channel or institution code
Sequence number for request tracking
Desired VPA to create in username@handle format
Response Body
application/json
curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/profile/createVpa" \ -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": "802", "vpaId": "amit.patel@indie" }'{
"status": "SUCCESS",
"exception": null,
"seqNo": "802",
"callbackRef": null,
"message": "VPA created successfully",
"result": "TRUE"
}Check VPA Availability POST
Checks whether a desired VPA (UPI ID) is available for creation. Call this API before attempting to create a VPA to verify the requested UPI ID is not already in use. Validates VPA format, handle support, restricted words, and NPCI registry. Returns TRUE if available, FALSE otherwise. For 10-digit numeric VPAs, the system validates the number matches the users registered mobile number (without country code).
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.