m2pfintech
API LibraryBalance And History

Check Balance Response

Fetches the result of a previously initiated balance check. Pass the callbackRef from checkBalanceReq. Returns the available balance in the bank account.

POST
/upi/v1/wrapper/transaction/checkBalanceRes

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string

Channel or institution code

seqNo*string

Sequence number for request tracking

callbackRef*string

Callback reference ID received from the initiating async API call

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/transaction/checkBalanceRes" \  -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": "601",    "callbackRef": "bal-check-uuid-12345"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "601",
  "result": {
    "balance": "25000.50",
    "currency": "INR",
    "accountId": "acc-uuid-001",
    "maskedAccountNumber": "XXXX5678"
  }
}

Check Balance Request POST

Initiates a balance inquiry for a linked bank account. The encrypted UPI PIN block is required for authentication. This is an asynchronous API - use checkBalanceRes with the callbackRef to get the actual balance.

Fetch Recent Transactions POST

Fetches the most recent UPI transactions for the user profile. Returns a list of transactions ordered by date descending. Supports pagination via offset and pageNo query parameters. Default page size is 5, maximum is 100.