m2pfintech
API LibraryTransactions

Fetch Transaction Status

Fetches the current status of a transaction by RRN, transaction ID, or UPI account number. isReversal is mandatory.

GET
/v1/transactions/fetch-status

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

Query Parameters

rrn?string

Retrieval Reference Number

txnId?string

Transaction ID

transactionType?string

Transaction type

isReversal*string

Required. Whether to check for reversal transactions

upiAccountNumber?string

UPI account number

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Response Body

application/json

application/json

curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/transactions/fetch-status?isReversal=string" \  -H "X-TENANT-ID: ACME_CORP"
{
  "result": {
    "status": "string",
    "rrn": "string",
    "externalTxnId": "string",
    "description": "string"
  },
  "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"
}

Fetch Offline Transactions POST

Retrieves offline transactions for a cardholder. Offline transactions are those processed in offline mode (e.g., POS terminals without real-time connectivity). ### Use Cases - Reconciliation of offline POS transactions - Identifying delayed settlement transactions - Monitoring offline transaction patterns

Check Wallet Balance POST

Retrieves the current available balance for a specific wallet. For multi-currency cards (e.g., forex cards), you can check the balance of each currency wallet individually. ### Response Details The balance response includes: - **Available Balance**: The amount currently available for transactions - **Wallet Currency**: The currency of the wallet (INR, USD, EUR, etc.) - **Wallet Status**: Current status of the wallet ### When to Use - **Pre-Transaction Check**: Verify sufficient balance before initiating a debit/transfer - **Balance Display**: Show real-time balance in your app/portal - **Reconciliation**: Compare balances for accounting and reconciliation purposes