m2pfintech
API LibraryDelegate Payments

Delegate Payment

Initiates a payment using delegate authorization. The delegate makes a payment that is debited from the delegators account. The payment amount must be within the configured per-transaction, daily, and monthly limits. UPI PIN of the delegate is required for authentication.

POST
/upi/v1/wrapper/transaction/delegate/pay

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string
seqNo*string
delegateId*string

Delegate registration ID

payee*

Payer or payee details for a transaction

amount*string

Payment amount

remarks?string

Payment remarks

credBlock*string

Encrypted UPI PIN block of the delegate

txnId*string

Unique transaction ID

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/transaction/delegate/pay" \  -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": "802",    "delegateId": "delegate-uuid-001",    "payee": {      "vpa": "shop@upi",      "name": "Local Shop"    },    "amount": "500.00",    "remarks": "Groceries",    "credBlock": "encrypted-delegate-pin-block",    "txnId": "DEL-TXN-20260301-001"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "802",
  "callbackRef": "del-pay-uuid-123",
  "result": {
    "txnId": "DEL-TXN-20260301-001",
    "status": "PENDING",
    "rrn": "603012345680"
  }
}

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.

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.