m2pfintech
API LibraryDisputes

Create Dispute Response

Fetches the result of a previously initiated dispute creation. Pass the callbackRef from createDispute to check if the dispute was successfully registered with NPCI and the bank.

POST
/upi/v1/wrapper/transaction/createDisputeResp

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/createDisputeResp" \  -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": "751",    "callbackRef": "dispute-uuid-12345"  }'
{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "751",
  "result": {
    "disputeId": "DISP-UUID-001",
    "disputeStatus": "REGISTERED",
    "txnId": "TXN20260301123456ABCD"
  }
}

Create Dispute (Raise Complaint) POST

Raises a dispute or complaint on a UPI transaction. Disputes can be raised for failed debits, failed credits, or unauthorized transactions. There is a time window within which disputes can be raised (configurable, typically 30-90 days). Duplicate disputes for the same transaction are not allowed.

Fetch Disputes POST

Fetches the list of disputes raised by the user. Returns dispute details including status, resolution, and associated transaction information. Supports pagination via offset and pageNo.