m2pfintech
API LibraryCard Lifecycle

Fetch Transaction

Retrieves card transaction details with comprehensive filtering options. Supports filtering by kit number, entity ID, account number, date range, transaction channel, and response code. Returns paginated results with detailed transaction information including acquirer details, merchant information, amount, currency, authentication flags, and processing metadata.

POST
/kit-manager/fetchTransaction

Authorization

tenantAuth
tenant<token>

The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.

In: header

Header Parameters

tenant*string

The DCMS client or tenant name for multi-tenant isolation.

Request Body

application/json

entityId*string

Customer entity identifier. This is the only required filter.

kitNo?string

Filter by a specific kit number.

accountNumber?string

Filter by a specific account number.

startDate?string

Start date for the transaction date range filter in DD-MM-YYYY format.

endDate?string

End date for the transaction date range filter in DD-MM-YYYY format.

transactionChannel?string

Filter by transaction channel.

Value in"ATM" | "POS" | "ECOM" | "CONTACTLESS"
responseCode?string

Filter by specific transaction response code.

page?integer

Page number for pagination (zero-based).

size?integer

Number of records per page.

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/kit-manager/fetchTransaction" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{    "entityId": "5000012988",    "kitNo": "10930000801",    "accountNumber": 2021561001386,    "startDate": "12-03-2023",    "endDate": "12-12-2023",    "transactionChannel": "ATM",    "responseCode": "06",    "page": 0,    "size": 9  }'
{
  "result": {
    "currentPage": 0,
    "totalItems": 2,
    "totalPages": 1,
    "data": [
      {
        "accountNumber": 2021561001386,
        "acquiringCountryCode": "356",
        "binValue": "817704",
        "cardAcceptorNameLocation": "SARWAN SERVICE STATION LUDHIANA     PBIN",
        "cardAcceptorTerminalId": "12340098",
        "cardHolderBillingAmount": "000000010000",
        "channel": "ATM",
        "crDr": "D",
        "damount": "-100.0",
        "dateTimeTransaction": 828123529,
        "description": "Unknown Transaction Error code :: 006",
        "emvTxn": true,
        "entityId": "5000012988",
        "expiryDate": "2807",
        "international": false,
        "kitNo": "10930000801",
        "maskedPan": "8177XXXXXXXX0013",
        "mcc": "6011",
        "mti": "0100",
        "network": "RUPAY",
        "processingCode": "010000",
        "responseCode": "06",
        "rrn": "230809105139",
        "stan": "123456654434",
        "tranResponseCode": "007",
        "transactionAmount": "000000010000",
        "transactionCurrencyCode": "356",
        "transactionCurrencyCodeName": "INR",
        "transactionOrigin": "ATM",
        "transactionType": "CASH"
      }
    ]
  },
  "exception": null,
  "pagination": null
}

Fetch Card Details by Card Number V2 POST

Retrieves detailed card and account information using an encrypted card number. The card number must be encrypted using AES-GCM encryption with the shared encryption key. The algorithm uses a 16-byte random IV and 128-bit authentication tag. The encrypted value should be Base64 encoded with the IV prepended to the ciphertext. Returns full card details including account information, card preferences, toggle settings, and the last PIN change date.

Get CVV POST

Retrieves the CVV (Card Verification Value) for a card identified by its kit number. The response includes the CVV value and its expiry time in seconds. The CVV is time-limited and must be used before the expiryCvv time elapses. This is typically used for virtual card transactions where the customer needs to view the CVV.