m2pfintech
API LibraryBalance And History

Check Balance Request

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.

POST
/upi/v1/wrapper/transaction/checkBalanceReq

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string
seqNo*string
accountId*string

Account to check balance for

credBlock*string

Encrypted UPI PIN block for authentication

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/transaction/checkBalanceReq" \  -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": "600",    "accountId": "acc-uuid-001",    "credBlock": "encrypted-upi-pin-block"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "600",
  "callbackRef": "bal-check-uuid-12345",
  "result": null
}

Validate Address Response POST

Fetches the result of a previously initiated address validation. Returns the validated payee name and VPA details on success. Pass the callbackRef from validateAddReq.

Check Balance Response POST

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