m2pfintech
API LibraryTransaction

Fetch Transaction by RRN

Looks up a specific transaction using its Retrieval Reference Number (RRN). The RRN is assigned by the card network and is commonly used in dispute resolution and reconciliation.

When to Use

  • Cross-reference transactions with card network records
  • Dispute resolution — look up transaction by RRN
  • Bank reconciliation matching
GET
/v1/transactions/status/rrn/{id}

Authorization

bearerAuth tenantId
AuthorizationBearer <token>

JWT Bearer token from the Authentication API

In: header

X-TENANT-ID<token>

Your unique tenant identifier assigned during onboarding

In: header

Path Parameters

id*string

Retrieval Reference Number (RRN)

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Response Body

application/json

application/json

application/json

curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/transactions/status/rrn/337786787811" \  -H "X-TENANT-ID: ACME_CORP"
{
  "result": {
    "amount": "-500.00",
    "preBalance": "8500.00",
    "postBalance": "8000.00",
    "transactionType": "POS",
    "txnOrigin": "POS",
    "transactionStatus": "SUCCESS",
    "transactionAmount": "500.00",
    "time": "2019-08-24T14:15:22Z",
    "description": "string",
    "merchantName": "Flipkart Online",
    "merchantLocation": "Bangalore IN",
    "merchantId": "FLIP001",
    "mcc": "5411",
    "externalTransactionId": "string",
    "retrievalReferenceNo": "337786787811",
    "authCode": "string",
    "kitNo": "string",
    "transactionCurrencyCode": "356",
    "transactionCurrencyCodeName": "INR",
    "baseCurrencyCode": "string",
    "baseCurrencyCodeName": "string",
    "baseConvertedAmount": "string",
    "exchangeRate": 0.1,
    "markupRate": 0.1,
    "markupServiceTax": 0.1,
    "networkType": "string",
    "crDr": "C",
    "responseCode": "string",
    "forexWallet": {
      "walletName": "USD",
      "walletType": "USD",
      "walletCurrencyCodeName": "USD"
    }
  },
  "pagination": {
    "list": true,
    "pageSize": 0,
    "pageNo": 0,
    "totalPages": 0,
    "totalElements": 0
  }
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unable to convert http message",
  "message": "error.http.400"
}

{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Customer does not exist",
  "status": 409,
  "detail": "Customer does not exists for id",
  "message": "error.business",
  "businessCode": "PPCUST_002"
}

Fetch Transaction by External ID GET

Looks up a specific transaction using its external transaction ID. This is the unique identifier assigned to the transaction when it was created. ### When to Use - Check the status of a specific transaction - Validate that a credit/debit was processed - Retrieve transaction details for a webhook callback reference

Fetch Failed Transactions POST

Retrieves all failed transactions for a cardholder. Useful for troubleshooting, reconciliation, and displaying declined transaction history. ### Common Failure Reasons - Insufficient balance - Currency conversion deviation - Transaction limit exceeded - Card blocked or locked - Downstream processor error