m2pfintech
API LibraryCredentials And Pin

Set Credentials Request (UPI PIN)

Initiates the UPI PIN set or change operation. The encrypted PIN block (prepared by the Common Library SDK using OTP and card details) is sent to NPCI via the bank for PIN setup. This is an asynchronous API - use setCredentialsResp with the callbackRef to get the result. Supports SET (new PIN), CHANGE (update existing), and RESET operations.

POST
/upi/v1/wrapper/profile/setCredentialsReq

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string
seqNo*string
accountId*string

Account for PIN operation

credBlock*string

Encrypted PIN block generated by Common Library SDK using OTP and card details

credType*string

Credential type

Value in"PIN"
credSubType*string

Operation sub-type for credentials

Value in"SET" | "CHANGE" | "RESET"

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/profile/setCredentialsReq" \  -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": "402",    "accountId": "acc-uuid-001",    "credBlock": "encrypted-pin-block-from-common-library",    "credType": "PIN",    "credSubType": "SET"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "402",
  "callbackRef": "set-cred-uuid-67890",
  "message": null,
  "result": null
}

Response Activation POST

Fetches the result of a previously initiated activation request. Pass the callbackRef from reqActivation to check activation status.

Set Credentials Response (UPI PIN Result) POST

Fetches the result of a previously initiated credential set request. Pass the callbackRef from setCredentialsReq to check if the UPI PIN was successfully set, changed, or reset.