This API retrieves a paged list of transactions from Gameball, allowing for optional filtering. Each transaction record includes details such as type, direction, points, amount, transaction time, and balance changes, providing a comprehensive view of customer activity.
Query parameters
Direction of the transaction: + (Accumulation - points or rewards added to the customer), - (Deduction - points or rewards removed from the customer).
Represents the current status of the transaction. Possible values are: Active (The transaction is fully completed, and any points or rewards have been successfully added or redeemed), Pending (Points or rewards from the transaction are pending during the return window period), Blocked (The transaction has been flagged and blocked due to suspected fraud or other security concerns), Expired (The points or rewards earned in this transaction have expired and are no longer available for redemption or use).
Specifies the page will start after which transaction id. Defaults to 0.
Specifies the number of transactions to be returned per page. Defaults to 50, with a maximum limit of 200 transactions per page.
Unique identifier for the customer that you can reference across the customer's whole lifetime. Could be a database ID, random string, email or anything that uniquely identifies the customer. This is used to filter the transactions of the specified customer.
Response
Transactions retrieved successfully
Example response
{
"transactions": [
{
"transactionId": "txn123456",
"gameballTransactionId": "11034736",
"type": "Cancel",
"direction": "-",
"customerId": "cust_12345abc",
"points": 10,
"amount": 10,
"transactionTime": "2024-10-13T17:11:00.249",
"status": "Active",
"merchantName": "MERCH1234",
"branchName": "BRANCH123",
"reason": "trx reason",
"expiryDate": "2025-10-13T17:11:00.249",
"pointsBalanceBefore": 1164,
"pointsBalanceAfter": 1154
}
],
"count": 2,
"hasMore": true
}