Transactions API

Transaction API Reference - Operator API

Transactions API is an API which provides a list of all user's gameplay transactions, including their status and unique transaction IDs, which are crucial for processing transactions as well as troubleshooting any issues during gameplays.

Retrieves player transaction history with flexible response formats.

post

Provides two response modes based on sessionId parameter:

• With sessionId: Returns flat list of individual transactions for the session

• Without sessionId: Returns transactions grouped by gaming sessions

Features:

• Time range filtering required (startTime and endTime)

• Supports multiple transaction types: BET, WIN, DEPOSIT, WITHDRAWAL

• Pagination support (max 120 items per page)

• Integrates with BgWallet service

Required headers: X-Player-Token

Sample request (with sessionId):

{
    "startTime": "2025-10-01T00:00:00Z",
    "endTime": "2025-10-08T23:59:59Z",
    "sessionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "page": 1,
    "pageSize": 20
}

Sample request for grouped sessions (without sessionId):

{
    "startTime": "2025-10-01T00:00:00Z",
    "endTime": "2025-10-08T23:59:59Z",
    "page": 1,
    "pageSize": 10
}

Sample response for individual transactions:

[
  {
    "transactionId": "tx_123456",
    "roundId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "BET",
    "date": "2025-10-08T10:30:00Z",
    "amount": 10.50
  },
  {
    "transactionId": "tx_123457",
    "roundId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "WIN",
    "date": "2025-10-08T10:31:00Z",
    "amount": 25.75
  }
]

Sample response for grouped sessions:

{
  "playerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "sessions": [
    {
      "sessionId": "550e8400-e29b-41d4-a716-446655440000",
      "transactions": [
        {
          "transactionId": "tx_123456",
          "roundId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "type": "BET",
          "date": "2025-10-08T10:30:00Z",
          "amount": 10.50
        }
      ]
    }
  ]
}

Transaction Types:

• BET: Debit transactions for game rounds

• WIN: Credit transactions for game winnings

• DEPOSIT: Wallet funding transactions

• WITHDRAWAL: Wallet withdrawal transactions

Authorizations

Bearer

AuthorizationstringRequired

REQUIRED - JWT Authorization header using the Bearer scheme. All API endpoints require authentication, except for authentication endpoints (Connect/authentication). Example: "Authorization: Bearer {token}"

Query parameters

api-versionstringOptional

Header parameters

X-Player-TokenstringOptional

Player access token for session validation

Example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Body

application/jsontext/jsonapplication/*+json

startTimestring · date-time | nullableOptional

endTimestring · date-time | nullableOptional

sessionIdstring · uuid | nullableOptional

pageinteger · int32Optional

pageSizeinteger · int32Optional

Responses

200

Successfully retrieved transaction data. Format depends on sessionId parameter presence.

text/plainapplication/jsontext/json

Responseany

400

Invalid request parameters, missing time range, invalid date format, or pagination errors.

text/plainapplication/jsontext/json

401

Invalid or missing X-Player-Token header authentication.

text/plainapplication/jsontext/json

post

/transactions/list

HTTPcURLJavaScriptPython

POST /transactions/list HTTP/1.1
Host: operator-api.mgm.bingaodobrasil.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 150

{
  "startTime": "2026-01-01T22:31:09.017Z",
  "endTime": "2026-01-01T22:31:09.017Z",
  "sessionId": "123e4567-e89b-12d3-a456-426614174000",
  "page": 1,
  "pageSize": 1
}

application/jsontext/jsonapplication/*+json

No content