m2pfintech
API LibraryInternational Upi

International UPI Payment

Initiates an international UPI payment for cross-border transactions. Requires international UPI to be enabled for the tenant. Amount is converted at the applicable exchange rate. Subject to LRS (Liberalised Remittance Scheme) limits and FETERS reporting requirements.

POST
/upi/v1/wrapper/transaction/international/pay

Request Body

application/json

deviceInfo*

Device and SIM information required for UPI API authentication and tracking

channelCode*string
seqNo*string
payer*

Payer or payee details for a transaction

payee*

Payer or payee details for a transaction

amount*string

Payment amount in INR

foreignAmount?string

Payment amount in foreign currency

foreignCurrency?string

ISO 4217 currency code of the foreign currency

credBlock*string

Encrypted UPI PIN block

txnId*string

Unique transaction ID

Response Body

application/json

curl -X POST "https://sandbox-upi-api.m2pfintech.com/upi/v1/wrapper/transaction/international/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": "881",    "payer": {      "vpa": "amit.patel@indie",      "accountId": "acc-uuid-001"    },    "payee": {      "vpa": "intl-merchant@global",      "name": "International Merchant"    },    "amount": "3100.00",    "foreignAmount": "50.00",    "foreignCurrency": "SGD",    "credBlock": "encrypted-upi-pin-block",    "txnId": "INTL-TXN-20260301-001"  }'

{
  "status": "SUCCESS",
  "exception": null,
  "seqNo": "881",
  "callbackRef": "intl-pay-uuid-123",
  "result": {
    "txnId": "INTL-TXN-20260301-001",
    "status": "PENDING",
    "rrn": "603012345690"
  }
}

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.

Validate International QR POST

Validates an international QR code for cross-border UPI payments. Parses the QR code to extract merchant details, currency, and conversion rates. International UPI must be enabled for the tenant and the users profile. Supports G20 and other international payment corridors.