m2pfintech
API LibraryDelegate Payments

Register Delegate

Registers a delegate for UPI delegate payments. A delegator (account holder) authorizes a delegate (another user) to make payments on their behalf within configured limits. The delegate can then initiate payments that are debited from the delegators account. Both parties must consent to the delegation.

POST
/upi/v1/wrapper/transaction/delegate/register

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string
seqNo*string
delegatorVpa*string

VPA of the account holder (delegator) who authorizes payments

delegateVpa*string

VPA of the delegate who will make payments

perTxnLimit?string

Maximum amount per transaction for the delegate

dailyLimit?string

Maximum total amount per day for the delegate

monthlyLimit?string

Maximum total amount per month for the delegate

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/transaction/delegate/register" \  -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": "800",    "delegatorVpa": "parent@indie",    "delegateVpa": "child@indie",    "perTxnLimit": "2000.00",    "dailyLimit": "5000.00",    "monthlyLimit": "20000.00"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "800",
  "message": "Delegate registered successfully",
  "result": {
    "delegateId": "delegate-uuid-001",
    "delegatorVpa": "parent@indie",
    "delegateVpa": "child@indie",
    "status": "ACTIVE"
  }
}

Deregister Delegate POST

Deregisters a delegate from delegate payments. Either the delegator or the delegate can initiate deregistration. Once deregistered, the delegate can no longer make payments on behalf of the delegator.

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.