Validate Address Format
Validates the format of a VPA or UPI address. Checks if the address follows the correct format rules including character restrictions, length constraints, and handle validity. Use this for client-side validation before making API calls.
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/validateFormatReq" \ -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": "920", "vpaId": "amit.patel@indie" }'{
"status": "SUCCESS",
"exception": null,
"seqNo": "920",
"message": "Format is valid",
"result": "TRUE"
}Request Mobile Registration POST
Initiates mobile number registration with the UPI platform via NPCI. This is the formal registration of the mobile number on UPI rails. Used during initial onboarding after SIM binding is complete. The registration is processed through NPCI and upon success, the user is registered on the UPI network.
Check SIM Binding Status POST
Checks the status of a SIM binding request initiated via simBindReq. This API must only be called after a successful simBindReq call and after the client app has sent the SMS with the encoded data to the VMN. Pass the callbackRef from the simBindReq response. If error UPI_149 is returned (awaiting SMS provider callback), retry up to 5 times with a 3-second interval between attempts. On success, returns the user profile - for new users a fresh profile is created, for existing users (device change or app reinstall) the existing profile is returned.