Reconciliation API (Audit)

To guarantee total financial security and prevent “leakage” or discrepancies between the game provider, the GPAS platform, and your wallet, we implement an automated audit system.

This functionality requires the implementation of a Report API Endpoint in the Operator’s system. This allows GPAS to query the daily totals recorded in your system to verify that:

Provider Data == GPAS Data == Operator Wallet Data

Workflow & Frequency

Frequency: GPAS will query this endpoint once a day in a Batch process (e.g., at 04:00 UTC) to fetch data from the previous day. This ensures no impact on your live production performance.
Time Standard: All dates and aggregations must be processed in UTC.

Endpoint Specification

Method: GET
Authentication: Please provide the preferred method (API Key / Bearer Token) to the GPAS integration team.

Request Parameters

Parameter	Type	Description
`date_from`	Date (YYYY-MM-DD)	Start date (inclusive). UTC.
`date_to`	Date (YYYY-MM-DD)	End date (inclusive). UTC.
`provider_code`	String (Optional)	Filter by specific provider (e.g., “AGT”).

JSON Response Structure

The API must return an array of daily aggregates grouped by Game and Currency.

Example Response

{
  "status": "success",
  "data": [
    {
      "date": "2025-12-01",
      "provider_code": "AGT",
      "game_id": "agt-54",
      "game_name": "Halloween",
      "currency": "BRL",
      "total_bet": 15000.0,
      "total_bet_rollback": 0,
      "total_win": 10000.0,
      "total_win_rollback": 0,
      "total_ggr": 5000.0,
      "transaction_count_bet": 450,
      "transaction_count_win": 100,
      "transaction_count_rollback": 0
    },
    {
      "date": "2025-12-01",
      "provider_code": "AGT",
      "game_id": "agt-43",
      "game_name": "Pachinko 3",
      "currency": "BRL",
      "total_bet": 8000.0,
      "total_bet_rollback": 0,
      "total_win": 8200.0,
      "total_win_rollback": 0,
      "total_ggr": -200.0,
      "transaction_count_bet": 450,
      "transaction_count_win": 100,
      "transaction_count_rollback": 0
    }
  ]
}

Next Steps

Please review this specification with your backend team and let the GPAS integration team know if you require any clarification regarding the game_id mapping or authentication methods.