Card Transactions
Transaction queries.
View Card Transactions
GET /v1/api/cards/view-card-transactions
This is to view transactions
Parameters
| Field | Mandatory | Parameter Type | Data Type | Description |
|---|---|---|---|---|
| api-key | Yes | Header | String | The client’s API key |
| secret | Yes | Header | String | The client's secret key for the environment to which the request is being made |
| pageNumber | Yes | Path | Number | The page of results to retrieve |
| pageSize | Yes | Path | Number | The number of items that should be returned per page |
| searchParams | Yes | Path | Object | An object containing specific search criteria to filter the transactions. For example, it can include an AccountId1 to filter transactions related to a particular account. |
Sample Request
curl --location '{BASE_URL}/v1/api/cards/view-card-transactions' \ --header 'secret: {SECRET_KEY}' \ --header 'api-key: {API_KEY}' \ --body '{
"pageNumber": 0,
"pageSize": 0,
"searchParams": {
"accountNumber" : "1100043621"
"RetrievalReferenceNumber" : "000009307467",
"CardAcceptorTerminalId" : "11050011",
TransactionStatusCode : "00",
Channel : "WEB"
}
}'
Sample Response (200 - OK)
{
"totalCount": 4,
"status": true,
"message": "Operation successful",
"statusCode": "00",
"data": [
{
"transactionId": "5fe8d074-5dfe-4c2f-a83c-dc791c007dce",
"rrn": "000009298241",
"responseMessage": "Approved or completed successfully",
"transactionStatusCode": "Successful",
"totalAmount": "0",
"cardHolderPan": "5061360304397654327",
"channel": null,
"terminalId": "11050011",
"location": "ABULE MFB ATM LAGOS NG",
"creationDate": "2025-04-09T09:47:11.370365Z"
},
{
"transactionId": "b2b5466a-d0c2-4f47-8b5d-01313f931d94",
"rrn": "000009298241",
"responseMessage": "Approved or completed successfully",
"transactionStatusCode": "Successful",
"totalAmount": "12150",
"cardHolderPan": "5061360304397654327",
"channel": null,
"terminalId": "11050011",
"location": "ABULE MFB ATM LAGOS NG",
"creationDate": "2025-04-09T09:47:11.370365Z"
},
{
"transactionId": "6188a3ec-5e6d-40d0-bcb0-392387ff0457",
"rrn": "000009298241",
"responseMessage": "Approved or completed successfully",
"transactionStatusCode": "Successful",
"totalAmount": "0",
"cardHolderPan": "5061360304397654327",
"channel": null,
"terminalId": "11050011",
"location": "ABULE MFB ATM LAGOS NG",
"creationDate": "2025-04-09T08:15:58.107193Z"
},
{
"transactionId": "fbb57cb0-c235-4ef4-b35d-33be5c917407",
"rrn": "000009298240",
"responseMessage": "Approved or completed successfully",
"transactionStatusCode": "Successful",
"totalAmount": "12150",
"cardHolderPan": "5061360304397654327",
"channel": null,
"terminalId": "11050011",
"location": "ABULE MFB ATM LAGOS NG",
"creationDate": "2025-04-09T08:15:58.107193Z"
}
]
}
Sample Response (404 - Not Found)
{
"totalCount": 0,
"status": false,
"message": "No record found",
"statusCode": "25",
"data": null
}
Sample Response (500 - Internal Server Error)
{
"status": false,
"message": "An error occurred while processing this request. Kindly refer to the StatusCode.",
"statusCode": "06",
"data": null
}
View Single Card Transaction
GET /v1/api/cards/view-single-card-transaction/{transactionId}
Parameters
| Field | Mandatory | Parameter Type | Data Type | Description |
|---|---|---|---|---|
| api-key | Yes | Header | String | The client’s API key |
| secret | Yes | Header | String | The client's secret key for the environment to which the request is being made |
| transactionId | Yes | Path | String | The unique identifier for the card transaction you wish to retrieve. |
Sample Request
curl --location '{BASE_URL}/v1/api/cards/view-single-card-transaction/{transactionId}' \ --header 'secret: {SECRET_KEY}' \ --header 'api-key: {API_KEY}'
Sample Response (200 - OK)
{
"status": true,
"message": "Operation successful",
"statusCode": "00",
"data": {
"id": "9b87118e-9e1b-417f-be71-6b50e802b51c",
"creationDate": "07/28/2025 12:02:19",
"cardholderPan": "506136******9110",
"processingCode": "502020",
"transactionAmount": "000000010000",
"transmissionDatetime": "07281202",
"systemTraceAuditNumber": "048629",
"localTransactionTime": "120219",
"localTransactionDate": "0728",
"expirationDate": "8270",
"settlementDate": "0729",
"merchantCategoryCode": "6011",
"posEntryMode": "051",
"cardSequenceNumber": "002",
"posConditionCode": "00",
"posPinCaptureCode": "12",
"transactionFeeAmount": "D00001075",
"processingFeeAmount": "D00001075",
"acquiringInstitutionId": "50613602068",
"track2Data": "***********************",
"retrievalReferenceNumber": "000009298240",
"authorizationIdResponse": "953192",
"responseCode": "00",
"serviceRestrictionCode": "101",
"cardAcceptorTerminalId": "11050014",
"cardAcceptorIdCode": "11050011",
"cardAcceptorLocation": "ABULE MFB ATM LAGOS NG",
"channel": "ATM",
"totalAmount": 12150,
"transactionCurrencyCode": "566",
"additionalAmounts1": "2001566C0000003402862002566C000000195669",
"additionalAmounts2": "",
"echoData": "0009298240",
"settlementInstitutionId": "0009298240",
"accountId1": "1410132160",
"accountId2": "1187821831",
"posDataCode": "511201213344002",
"networkData1": "0009298240",
"networkData2": "9JAPAYSRC 9JAPAYSNK 0486290486299JAPAYTG",
"networkData3": "",
"additionalTransactionData": "",
"cardIssuerReferenceData": "ABU",
"extendedPosData": "JSL",
"responseMessage": "Approved or completed successfully",
"instrumentNumber": "0000001559 ",
"referenceNumber": "51f724d7-b410-489b-bbf5-d70b0f2cc051",
"transactionMessage": "0728120259318022",
"transactionStatusCode": "00",
"isDeleted": false
}
}
Sample Response (400 - Bad Request)
{
"status": false,
"message": "Validation error - message",
"statusCode": "09",
"data": null
}
Sample Response (404 - Not Found)
{
"status": false,
"message": "No record found",
"statusCode": "25",
"data": null
}
Sample Response (500 - Internal Server Error)
{
"status": false,
"message": "An error occurred while processing this request. Kindly refer to the StatusCode.",
"statusCode": "06",
"data": null
}