Fetches Historical Transactions and its Transaction Footprints
GET {{baseUrl}}/payment-cards/:payment_card_id/transaction-footprints?from_date=2018-05-07&to_date=2021-05-07&offset=50&limit=50
Allows a Service Provider to fetch historical transactions for a payment card. Note that a maximum of one year of transactions can be retrieved using this API. Also, the payment card has to be registered first using /payment-cards service.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
from_date | string | (Required) Start date for searching transaction (Format- YYYY-MM-DD). | |
to_date | string | (Required) End date for searching transaction (Format- YYYY-MM-DD). | |
offset | number | The number of items you need the start of the list to be offset from. | |
limit | number | The number of items you asked the list to be limited to. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"count":2,"offset":1,"limit":5,"total":5,"items":[{"transactionMetadata":{"id":"ee421c25-f928-4bf6-b884-3600b76b860d","traceId":"9f52386ce297173ecfeb9120aabb0805bbeeb1350ce1de640864852e800bd206","banknetReferenceNumber":"MPL0R6B2R","banknetDate":"0525","retrievalRefNumber":"MCC000100","processingCode":"00","authCode":"52717Z","dateAndTime":"2018-07-02T00:00+00:00","merchantName":"ABC Store","acquiringInstitutionCountryCode":"USA","acquiringInstitutionCode":"12312312312","amount":"25.50","currencyCode":"USD","indicator":"CL"},"transactionFootPrint":{"mcc":3997,"carbonEmissionInGrams":48.52,"carbonEmissionInOunces":1.71,"category":{"mainCategory":"Leisure \u0026 Entertainment","subCategory":"Hotels \u0026 Vacation","sector":"Hotels, Motels \u0026 Resorts","sectorCode":"604"}}},{"transactionMetadata":{"id":"fdc4626c-f51e-4ba6-9728-c79ac1d9aec8","traceId":"gf55386ce297173ecfeb9120aabb0805bbeeb1350ce1de640864852e8002343","banknetReferenceNumber":"MPL0B6B23","banknetDate":"0725","retrievalRefNumber":"MCC000480","processingCode":"01","authCode":"K3C161","dateAndTime":"2019-12-25T00:00+00:00","merchantName":"ABC Store","acquiringInstitutionCountryCode":"USA","acquiringInstitutionCode":"23423423423","amount":"30.00","currencyCode":"USD","indicator":"CL"},"transactionFootPrint":{"mcc":5962,"carbonEmissionInGrams":27.98,"carbonEmissionInOunces":0.99,"category":{"mainCategory":"Shopping","subCategory":"Department Store","sector":"Specialty Retail \u0026 Services","sectorCode":"302"}}},{"transactionMetadata":{"id":"9000010131662","traceId":"af55386ce297173ecfeb9120aabb0805bbeeb1350ce1de640864852e800bd854","banknetReferenceNumber":"MPL0R8C2A","banknetDate":"0624","retrievalRefNumber":"801220","processingCode":"00","authCode":"16","dateAndTime":"2022-01-26T00:00+00:00","merchantName":"Test Sandbox Merchant","acquiringInstitutionCountryCode":"USA","acquiringInstitutionCode":"12311878333","amount":20,"currencyCode":"GBP","indicator":"RFT"},"transactionFootprint":{"carbonEmissionInGrams":-3398.54,"carbonEmissionInOunces":-119.88,"transactionId":"9000010131662","mcc":"9311","category":{"mainCategory":"Government Services","subCategory":"Public Services","sector":"Government Services","sectorCode":"801"}}}]}