Initiate SIM Binding
Initiates the SIM binding process to link a users mobile SIM with their device for UPI authentication. This is Step 1 of the sequential SIM binding flow. After receiving a successful response, the client app must send an SMS with the returned data payload to the VMN number specified in result.to. SIM binding is required on first-time registration, device change, or app reinstallation. VMN (Virtual Mobile Number) must be pre-configured by M2P based on VMNs provided by the client during onboarding.
Request Body
application/json
Device and SIM information required for UPI API authentication and tracking
Channel or institution code
Sequence number for request tracking
Response Body
application/json
curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/util/simBindReq" \ -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": "100" }'{
"status": "SUCCESS",
"exception": null,
"seqNo": "100",
"callbackRef": "b3d72fa1-8c4e-49a7-a1d0-62e8f94cb712",
"message": null,
"pagination": null,
"result": {
"data": "YjNkNzJmYTEtOGM0ZS00OWE3LWExZDAtNjJlOGY5NGNiNzEy",
"to": "9213456780"
}
}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.
Check Transaction Status Request POST
Initiates a transaction status check with NPCI. This is an asynchronous API - use checkTxnRes with the callbackRef to get the actual transaction status. Transaction status can be checked only for transactions within the last 90 days.