m2pfintech
API LibraryTransactions

Fetch Offline Transactions

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
POST
/v1/transactions/fetch/offline

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

pageNo?integer

Page number (0-indexed)

Default0

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

entityId*string

Required. Cardholder's entity identifier

Length1 <= length
mobile?

Filter by mobile number (optional)

kit?string

Filter by card kit number (optional)

fromDate?string

Start date (inclusive). Format: dd-mm-yyyy

toDate?string

End date (inclusive). Format: dd-mm-yyyy

accountId?string

Filter by specific wallet/account ID (optional)

success?boolean

Set to true to return only successful transactions

isOffline?boolean

Set to true to include offline transactions

isDataMart?boolean

Note: serialized as isDataMart in JSON due to boolean getter naming convention.

filters?

Optional list of additional filter criteria

transactionTypes?array<string>

Optional list of transaction type strings to filter on

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/transactions/fetch/offline" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "entityId": "476843769320000001160925",    "fromDate": "2026-01-01",    "toDate": "2026-05-19"  }'
{
  "result": {},
  "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"
}

Forex Transfer Check (Preview) POST

Previews a forex wallet-to-wallet transfer **without executing it**. Returns the exchange rate, converted amount, fees, and markup that would apply. ### When to Use - Show the customer a transfer preview before confirmation - Calculate the exchange rate and fees for display - Validate that the transfer is possible (sufficient balance, valid wallets) ### Note The rates returned are indicative and may change slightly when the actual transfer is executed, as forex rates fluctuate in real-time.

Fetch Transaction Status GET

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