Obtain a List of Failed Transactions in the System

By utilizing this API method, Agents can retrieve information about failed transactions based on their permissions and specified search criteria.

The maximum number of items in the returned list is 20,000. However, if a limit is not specified in the search criteria, the list will be limited to 10,000 entries.

Transaction event types with a txnEventType of TOURNAMENT, PROMOTION, ACHIEVEMENT, or STORE will be returned for a period of up to seven days from their creation. If these transactions are not resolved within this time frame, they will be marked as permanently failed and removed from the queue. Transactions with other event types will remain in the queue.

Unauthorized Agents will receive a 401 error when accessing this API method.

GET /agents/{agentCode}/failedTransactions

Response Example

Code: 200

JSON

[ 
  {
    "betId": "AEBAAAQA4C5CMAAAAAAAAKX4ATSQYAAAAA",
    "actionType": "credit",
    "playerId": "player1",
    "amount": 50.21,
    "currency": "CNY",
    "txnId": "AQIAAgB2HSYAAAAAAAEAA",
    "txnEventType": "GAME",
    "contentCode": "SMG_breakAway",
    "metaData": {
      "isFreeGame": true,
      "progressive": {
        "type": "jackpot"
      }
    },
    "completed": true,
    "channel": "SLOTS"
  }
]

Response Data

Parameter	Description
`betId`	The bet ID for this particular transaction.
`actionType`	Indication to the Agent of the type of action that needs to be performed; either a rollback or credit.
`playerId`	System ID of the player.
`amount`	Amount to be adjusted from the player’s account.
`currency`	The ISO 4217 currency code of this transaction.
`txnId`	The unique MG+ transaction ID.
`txnEventType`	Additional details regarding the transaction.
`contentCode`	The MG+ content code which shows which event (ie. game, tournament) this transaction belongs to. In the case of a rollback, this will be the txnId of the original request.
`metaData`	Optional and extra information for this transaction that does not fit in the other fields.
`completed`	This flag indicates whether or not this is the final transaction for this gaming round. When this value is `true`: the Agent can treat it as if it were the conclusion of a game round the `txnId` value in the request is the same as the `betId` value
`channel`	The MG+ channel of the game.