Get Transactions
Get a list of all transactions
GET https://kernelserver.{env}.haloplus.io/transactions
Path Parameters
| Name | Type | Description |
|---|---|---|
| env* | String | The backend environment [dev, qa, prod] |
Query Parameters
| Name | Type | Description |
|---|---|---|
| ?integrator=:id* | String | If you are an integrator, your integrator id is required. Returns all transactions belonging to an integrator. |
| ?merchant=:id* | String | If you a merchant, your merchant id is required. Returns all transactions belonging to an merchant. |
| ?user=:id* | String | If you want transactions limited to a user, add the user id. Returns all transactions belonging to the user. |
| ?startDate=YYYY-MM-DD | String | Filters transactions to those created on or after this date. |
| ?endDate=YYYY-MM-DD | String | Filters transactions to those created on or before this date. |
| ?limit=:number | Number | Maximum number of results to return. |
| ?offset=:number | Number | Number of records to skip for pagination. |
| ?minAmount=:number | Number | Filters transactions with amounts greater than or equal to this value. |
| ?maxAmount=:number | Number | Filters transactions with amounts less than or equal to this value. |
| ?merchantReference=:string | String | Filters transactions by the provided merchant reference. |
| ?transactionDisposition=:value | Number | Filters by transaction disposition status. Accepted values:
|
Headers
| Name | Type | Description |
|---|---|---|
| x-api-key* | String | The API Key retrieved from the Merchant Portal |
- 200: OK Status
- 400: Bad Request
[
{
"id": "1d87e52a-ed08-4b5a-96c6-3f6942a1dc17",
"passthroughUserId": null,
"merchantTransactionReference": "17a42d8a-2717-45b6-95f7-7f4957e36c16",
"dataRecord": "nwIGAAAAAQAAnwMGAAAAAAAAnyYIvmPeBfQYE4mCAhmAUApDT00wMiB2MSAwXzQBAZ82AgACnwcC/8CfCQIAAp8nAYCfNAMfAwKEB6AAAAAEMGCfHggwMkE0NjQ4M58QEgEQoAAPBAAAAAAAAAAAAAAA/58zAwAICJ8aAgcQnzUBIZUFAAAAgAFfKgIHEJoDIwYGnAEAnzcEAczRLA==",
"details": [
{
"tags": [
{
"tag": "9F1A",
"value": "0710"
},
{
"tag": "8C",
"value": "9F02069F03069F1A0295055F2A029A039C019F37049F35019F45029F4C089F34039F21039F7C14"
},
{
"tag": "8E",
"value": "000000000000000042031F03"
},
{
"tag": "8F",
"value": "F1"
},
{
"tag": "9F10",
"value": "0110A0000F040000000000000000000000FF"
},
{
"tag": "90",
"value": "39C18446D3EA015A4624C1C9E173D71FF2A515A50CD74E1D0DB840FE1679EF29911F9B47A273F74D711A0E5832B1D0663006F31274B056C2EC93BB5E1A7BCD4F79D947475D8644D37CFD475565BC58EDD19B6454682F6B8E70A80FF752F8C7F664747149B9A13CCF82BCBD74A3CAA176FE3F4BC1D5E08E7FEEDF2DEA063FD43FABEE5269722B24A5EAD869F46A9C3F8C92DE40EFCCC53BCCF0C03CDF7A2BDB98B5E348D7743944E9A894273DAD31FA4A"
},
{
"tag": "9F0E",
"value": "0000000000"
},
{
"tag": "FF8106",
"value": "9F42020840DF8115060000000000FFDF810E0100DF810F01009F6E200056010239390102030405060708090A0B0C0D0E0F101112131415161718191A"
},
{
"tag": "9F0F",
"value": "0000000000"
},
{
"tag": "94",
"value": "08010100100101011801010020010200"
},
{
"tag": "9F0D",
"value": "0000000000"
},
{
"tag": "95",
"value": "0000008001"
},
{
"tag": "9A",
"value": "230606"
},
{
"tag": "9F27",
"value": "80"
},
{
"tag": "9C",
"value": "00"
},
{
"tag": "9F26",
"value": "BE63DE05F4181389"
},
{
"tag": "9F21",
"value": "140406"
},
{
"tag": "9F1D",
"value": "4C00800000000000"
},
{
"tag": "DF8307",
"value": "00"
},
{
"tag": "9F1E",
"value": "3032413436343833"
},
{
"tag": "DF9E08",
"value": "80"
},
{
"tag": "9F39",
"value": "07"
},
{
"tag": "DF9E09",
"value": "57126799998900000074324D49122010123456785A0A6799998900000074324F5F24034912315F25031601015F280208405F3401018C279F02069F03069F1A0295055F2A029A039C019F37049F35019F45029F4C089F34039F21039F7C148D0C910A8A0295059F37049F4C088E0C000000000000000042031F039F0702FFC09F080200029F0D0500000000009F0E0500000000009F0F0500000000009F420208409F4A01821980"
},
{
"tag": "9F36",
"value": "0002"
},
{
"tag": "9F37",
"value": "01CCD12C"
},
{
"tag": "DF9E07",
"value": "999999999999"
},
{
"tag": "DF9E00",
"value": "80"
},
{
"tag": "DF9E01",
"value": "80"
},
{
"tag": "9F34",
"value": "1F0302"
},
{
"tag": "9F35",
"value": "21"
},
{
"tag": "9F32",
"value": "03"
},
{
"tag": "9F33",
"value": "000808"
},
{
"tag": "DF8136",
"value": "012C"
},
{
"tag": "9F4A",
"value": "82"
},
{
"tag": "DF8137",
"value": "32"
},
{
"tag": "9F4B",
"value": "3F47C7E108DE3DFB6A2D06B7267D562545333B3180C556E234AE3BC41365BF9BC3468C2E2812D364537FC9CBCFB65835EBEC8C66DD9105789CF5BF914C16CE821BF887032721AB35C223FBCA562DF3A72987E0E42F11F2B1565563A25F14D0AF"
},
{
"tag": "DF8134",
"value": "0012"
},
{
"tag": "DF8135",
"value": "0018"
},
{
"tag": "DF8132",
"value": "0014"
},
{
"tag": "DF8133",
"value": "0032"
},
{
"tag": "DF8130",
"value": "0D"
},
{
"tag": "9F4C",
"value": "BC0413ECA936A8F4"
},
{
"tag": "DF8131",
"value": "000001000001200000080000080020000004000004002000000100000100200000020000020020000000000000000700"
},
{
"tag": "9F47",
"value": "03"
},
{
"tag": "9F48",
"value": "0000000000000006600000000000000000000000000000000055"
},
{
"tag": "EF8105",
"value": "01"
},
{
"tag": "EF8104",
"value": "00"
},
{
"tag": "EF8103",
"value": "01"
},
{
"tag": "EF8102",
"value": "01"
},
{
"tag": "9F42",
"value": "0840"
},
{
"tag": "9F40",
"value": "6000C03001"
},
{
"tag": "DF812D",
"value": "000013"
},
{
"tag": "9F46",
"value": "39C3FC17136E58987D046155C4A50A6E6DD5ACEFDF19D2B3CA84F063043A960C36B8F5609303AADE7D973BD7D5C057087F74B65C18DDE826362FC20C754EE3D2274D11CB94E245AB5C7A259F57C3D63FDAA381670F591FB1A7F3B22195CFB4421633A30DF6E7901AC6309B3F64A6EA97"
},
{
"tag": "DF8129",
"value": "30F0F000B0F0FF00"
},
{
"tag": "DF8127",
"value": "01F4"
},
{
"tag": "DF8125",
"value": "999999999999"
},
{
"tag": "DF8126",
"value": "000000050000"
},
{
"tag": "DF8123",
"value": "000000000000"
},
{
"tag": "DF8124",
"value": "999999999999"
},
{
"tag": "DF8121",
"value": "0000800000"
},
{
"tag": "DF8122",
"value": "840000000C"
},
{
"tag": "DF8120",
"value": "840000000C"
},
{
"tag": "DF811F",
"value": "08"
},
{
"tag": "DF811B",
"value": "B0"
},
{
"tag": "4F",
"value": "A0000000043060"
},
{
"tag": "DF811A",
"value": "9F6A04"
},
{
"tag": "50",
"value": "434F4D30322076312030"
},
{
"tag": "DF8118",
"value": "40"
},
{
"tag": "DF8119",
"value": "08"
},
{
"tag": "DF8116",
"value": "1B000000000000000000000000000000000000000000"
},
{
"tag": "DF8117",
"value": "00"
},
{
"tag": "DF8114",
"value": "90"
},
{
"tag": "DF8115",
"value": "0000000000FF"
},
{
"tag": "9F6E",
"value": "0056010239390102030405060708090A0B0C0D0E0F101112131415161718191A"
},
{
"tag": "5F25",
"value": "160101"
},
{
"tag": "DF810E",
"value": "00"
},
{
"tag": "5F28",
"value": "0840"
},
{
"tag": "DF810F",
"value": "00"
},
{
"tag": "DF810C",
"value": "02"
},
{
"tag": "DF8107",
"value": "0000000100000000000000000710000000800107102306060001CCD12C21000000000000000000001F03021404060000000000000000000000000000000000000000"
},
{
"tag": "9F7E",
"value": "01"
},
{
"tag": "5F34",
"value": "01"
},
{
"tag": "5F2A",
"value": "0710"
},
{
"tag": "9F06",
"value": "A0000000043060"
},
{
"tag": "9F03",
"value": "000000000000"
},
{
"tag": "9F09",
"value": "0002"
},
{
"tag": "9F07",
"value": "FFC0"
},
{
"tag": "9F08",
"value": "0002"
},
{
"tag": "9F02",
"value": "000000010000"
},
{
"tag": "82",
"value": "1980"
},
{
"tag": "84",
"value": "A0000000043060"
},
{
"tag": "87",
"value": "03"
}
],
"maskedPAN": "679999*********4324",
"encryptedV2": {
"keyVersion": "ERqqMJM4mCAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"fingerprint": "",
"encryptedCardData": "OVq8nqoXs4MQ+A+dSTzlnyxwDMc7t7mEs8tMJwspHZqCORQAOB3Gx9+RfM33tZqKiJQezpFC4+CvyC7TWF0UvQtEdN9IpPAFXfuETCQUyJcC/L8nY2oeCN/015Yqw6su2mpgW1JWfklcFiqx1vbYoF1R39BG2CrAV9XFozmm4fKzQ1M+FD7xsuwXgRO/4qaSFTkWg8Dg8DsqeRawfyaGRnR5mUOa4JWjbeBhZ9Bid5BNptLlwfXEilsnM0Qn1VYy/LwbvewJ4bZuQeJSbmaB52C8INnrswK65anS7fIZqkNQoCZ7CIjJ1FsF4ob30p8XippufuvI6ZmyvnsNsS5suA=="
},
"paymentProviderId": 100
}
],
"latitude": "-25.6921586",
"longitude": "28.0414386",
"deviceinstallationId": "F38BD0EA331F9CAAEEDF2C88BC41EED6",
"transactionstatusId": 10,
"transactionDispositionId": 0,
"amount": "100",
"currency": "ZAR",
"responseCode": 0,
"transactionTypeId": 1,
"originalTransactionId": null,
"acquirerId": 36,
"userId": "216c55a5-0ae4-46ec-a217-3c865f58c401",
"transactionFeesConfigId": null,
"transactionFee": null,
"authorisationCode": "00",
"createdAt": "2023-06-06T12:04:14.247Z",
"updatedAt": "2023-06-06T12:04:17.141Z",
"receiptData": {
"effectiveDate": "160101",
"expiryDate": null,
"authorizationCode": "00",
"tid": "F38BD0EA331F9CAAEEDF2C88BC41EED6",
"transactionReference": "1d87e52a-ed08-4b5a-96c6-3f6942a1dc17",
"merchantName": "Fletcherville",
"formattedMerchantAddress": "",
"transactionType": "Tap",
"approvalText": "Approved",
"aid": "A0000000043060",
"amount": "ZAR 100.00",
"currency": "ZAR",
"applicationLabel": "COM02 v1 0",
"applicationPreferredName": null,
"association": "Maestro Debit",
"isoResponseCode": "0",
"cryptogram": "BE63DE05F4181389",
"cryptogramType": "ARQC",
"tvr": "0000008001",
"date": "2023/06/06",
"time": "12:04",
"maskedPan": "679999*********4324"
}
},
...
]
{
"httpStatusCode": 400,
"errorCode": 104,
"message": "E104: You do not have permission to access this integrator"
}