Fetch Transaction by External ID
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
Authorization
bearerAuth tenantId JWT Bearer token from the Authentication API
In: header
Your unique tenant identifier assigned during onboarding
In: header
Path Parameters
External Transaction ID
Header Parameters
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/fcf9497aeb7943d7abb8b48696e129f8" \ -H "X-TENANT-ID: ACME_CORP"{
"result": {
"amount": "500.00",
"preBalance": "8500.00",
"postBalance": "8000.00",
"transactionType": "POS",
"txnOrigin": "POS",
"transactionStatus": "SUCCESS",
"time": "2025-04-15T10:30:00.000Z",
"merchantName": "Flipkart Online",
"externalTransactionId": "fcf9497aeb7943d7abb8b48696e129f8",
"retrievalReferenceNo": "337786787811",
"crDr": "D"
},
"pagination": null
}{
"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"
}Email Statement to Cardholder POST
Generates a PDF transaction statement for the specified date range and sends it to the cardholder's registered email address. The email is sent asynchronously — the API returns a success response immediately, and the email is delivered within a few minutes. ### How It Works 1. Provide the cardholder's entity ID (and optionally mobile/kit number for additional validation) 2. Specify the date range for the statement (`fromDate` to `toDate`) 3. The system generates a formatted PDF with all transactions in the period 4. The PDF is emailed to the cardholder's registered email address ### Key Business Rules - The cardholder must have a registered email address on file - Maximum date range: 1 year (365 days) - The statement includes all transaction types: loads, purchases, refunds, fees, etc. - If no transactions exist in the date range, a statement with zero transactions is sent - Email delivery is asynchronous — use webhooks or polling to confirm delivery if needed
Fetch Transaction by RRN GET
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