Overview

Account Transaction Events operate at the Account Transaction level rather than the API level (see Atomic Operation Events for details).

These events are triggered by each Account Transaction generated in AIR. A single API call may trigger several Account Transactions and one event is generated for each action taken. E.g. A POS Connect Settle, might trigger Account CREATE and REDEEM transactions for open/targeted offers, CREDIT events for Points and Continuity Accounts and STAMP events for a Stamp Card. Each account transaction created will trigger an event.

The data in these events relates only to the Transaction from which it is triggered.

Payload Structure

These events use a data structure as defined below:

{
    "dataObjectName": "ACCOUNT_TRANSACTION",
    "eventType": "CREATE",
    "eventTime": "2025-05-29T18:08:32+00:00",
    "accountTransactionId": "456700000",
    "parentAccountTransactionId": "",
    "accountId": "270350000",
    "campaignId": "1738000",
    "tokenId": "67800001",
    "token": "8110100278152075023150110200101102001004660032401000000000000000005",
    "event": "CREATE",
    "walletId": "1237890123",
    "value": 600,
    "source": "MANUAL",
    "balanceBefore": {
        "available": 0,
        "refundable": 0
    },
    "balanceAfter": {
        "available": 0,
        "refundable": 0
    },
    "location": {
        "unitId": 90002,
        "incomingIdentifier": "1234",
        "outgoingIdentifier": "1234"
    },
    "transactionDetails": {
        "reference": "550a740ab4661bf9",
        "merchant_store_id": "1234",
        "merchant_store_parent_id": "fabulousretailer"
    },
    "parentUnitId": 90001,
    "dateCreated": "2025-05-29T18:08:34+00:00"
}

{
    "dataObjectName": "ACCOUNT_TRANSACTION",
    "eventType": "CREATE",
    "eventTime": "2025-05-29T18:09:31+00:00",
    "accountTransactionId": "456700001",
    "parentAccountTransactionId": "",
    "accountId": "270350000",
    "campaignId": "1738000",
    "tokenId": "67800001",
    "token": "8110100278152075023150110200101102001004660032401000000000000000005",
    "event": "REDEEM",
    "walletId": "1237890123",
    "value": 600,
    "source": "MANUAL",
    "balanceBefore": {
        "available": 0,
        "refundable": 0
    },
    "balanceAfter": {
        "available": 0,
        "refundable": 0
    },
    "location": {
        "unitId": 90002,
        "incomingIdentifier": "1234",
        "outgoingIdentifier": "1234"
    },
    "transactionDetails": {
        "merchant_store_id": "1234",
        "merchant_store_parent_id": "fabulousretailer",
        "matchingRewardProducts": "4900000116",
        "matchingQualificationProducts": "4900005541",
        "transactionDateTime": "2025-05-29T18:09:25+00:00",
    },
    "parentUnitId": 90001,
    "dateCreated": "2025-05-29T18:09:34+00:00"
}