Get transaction history for a card
Retrieve paginated transaction history for a specific card identified by kit number. Supports filtering by date range and transaction type.
Results are paginated with a default page size of 20 and maximum of 100 records per page. Page numbering starts at 0.
Each transaction record includes the transaction ID, external reference, type, amount, currency, balance after transaction, status, narration, and timestamp.
Authorization
BearerAuth TenantHeader JWT Bearer token obtained from the /auth/login endpoint
In: header
Tenant identifier provided by M2P (e.g. ENBDTABBY)
In: header
Path Parameters
Kit number of the card to fetch transaction history for
Query Parameters
Page number for pagination (zero-based, default is 0)
00 <= valueNumber of results per page (default 20, maximum 100)
201 <= value <= 100Start date filter in YYYY-MM-DD format. Returns transactions from this date onwards.
dateEnd date filter in YYYY-MM-DD format. Returns transactions up to this date.
dateFilter by transaction type. If not provided, all types are returned.
"CREDIT" | "DEBIT" | "REVERSAL"Response Body
application/json
curl -X GET "https://api.m2p.com/Yappay/transaction-manager/getTransaction/KIT20260306001234?fromDate=2026-01-01&toDate=2026-03-31"{
"status": "success",
"data": {
"transactions": [
{
"transactionId": "TXN20260306001234",
"externalTransactionId": "ACME-TXN-001",
"type": "CREDIT",
"amount": 5000,
"currency": "INR",
"balanceAfter": 20000,
"status": "COMPLETED",
"narration": "Salary credit",
"date": "2026-03-06T10:30:00Z"
},
{
"transactionId": "TXN20260306005678",
"externalTransactionId": "ACME-TXN-002",
"type": "DEBIT",
"amount": 2500,
"currency": "INR",
"balanceAfter": 17500,
"status": "COMPLETED",
"narration": "Purchase at Amazon",
"date": "2026-03-06T11:00:00Z"
}
],
"pagination": {
"currentPage": 0,
"totalPages": 5,
"totalElements": 98,
"pageSize": 20
}
}
}Get wallet balance for a customer or entity GET
Retrieve balance information for a specified customer, corporate entity, or tenant. This is a GET API where the entity ID is passed as a path parameter (no request body). Returns an array of balance entries, one per product associated with the entity. Each entry contains the available balance and the lien (held) balance. Balance represents funds available for transactions. Lien balance represents funds that are temporarily held due to pending transactions, disputes, or other holds. The actual spendable amount is the balance minus the lien balance.
Reverse a previous transaction POST
Reverse a previously completed transaction. Supports both full and partial reversals. For a full reversal, omit the amount field or set it equal to the original transaction amount. For a partial reversal, provide the partial amount (must be less than the original). The partial reversal amount must not exceed the original transaction amount. The originalTransactionId identifies which transaction to reverse. A transaction can only be reversed once for full reversals. Multiple partial reversals are allowed as long as the total does not exceed the original amount.