Check SIM Binding Status
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.
Request Body
application/json
Device and SIM information required for UPI API authentication and tracking
Channel or institution code
Sequence number for request tracking
Callback reference from simBindReq response
Response Body
application/json
curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/util/checkSimBindStatus" \ -H "Content-Type: application/json" \ -d '{ "deviceInfo": { "deviceId": "x9y8z7w6-v5u4-3210-mnop-qr9876543210", "simId": "8991101200007891234", "deviceType": "MOB", "os": "ios", "telecom": "Vi", "geoCode": "19.0760,72.8777", "appId": "v3.1", "ipAddress": "10.0.0.25", "location": "Bangalore", "mobile": "918765432109" }, "channelCode": "ICIC0005678", "seqNo": "200", "callbackRef": "b3d72fa1-8c4e-49a7-a1d0-62e8f94cb712" }'{
"status": "SUCCESS",
"exception": null,
"seqNo": "200",
"callbackRef": null,
"message": "Sim binding success",
"pagination": null,
"result": {
"id": "c82e4f19-7b3a-4d6e-9f01-ab3456789def",
"mobile": "918765432109",
"channelCode": "ICIC0005678",
"profileStatus": null,
"name": null,
"emailId": null,
"upiNo": [],
"accounts": [],
"merchantInfo": null,
"vpas": [],
"created": null,
"firstTxnDate": null,
"firstTransactionDone": false,
"type": "PERSON",
"ipCode": "ISB",
"pushKey": null,
"cifId": null,
"orgId": null,
"key": null,
"g20": null,
"enableSignedQr": null,
"creditDisabled": null,
"delegateDetails": null,
"deviceId": "x9y8z7w6-v5u4-3210-mnop-qr9876543210",
"ifsc": "ICIC0005678",
"bankName": "ICICI"
}
}Validate Address Format POST
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.
Initiate SIM Binding POST
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.