Your platform's API

Your platform's API#

These are the endpoints AIC calls on your platform to query and move player balances. Your API must expose them at the base URL you registered for each environment (see Onboarding and credentials).

Common rules#

• All calls are POST with a JSON body to {your base URL}<operation> (in this manual, {{API_URL_CLIENTE}}).
• Successful responses must return HTTP 200 in this format. Both fields are required:

{
  "data": 2287.3,
  "status": {
    "code": "0",
    "message": "Success",
    "datetime": "2026-10-20T21:07:03.930Z"
  }
}

• data is numeric: the player's balance after the operation.
• status is required, with code: "0". If it is missing, AIC rejects the response even if the balance is valid.
• Amounts are expressed in your project's currency.
• Error handling is described in Responses and errors.

Operations overview#

Check Balance#

Returns the player's balance.

curl -X POST "{{API_URL_CLIENTE}}check-balance" \
  -H "Content-Type: application/json" \
  -d '{
    "playerName": "casinoPlayer123",
    "token_room": "playerSessionToken"
  }'

{
  "data": 2287.3,
  "status": {
    "code": "0",
    "message": "Success",
    "datetime": "2026-10-20T21:07:03.930Z"
  }
}

Body parameters

Add Bet#

Debits the amount from the player's balance. In Seamless it is a bet or a reversal that takes balance from the player; in Transfer, it is the transfer of the balance to the game when the session opens.

curl -X POST "{{API_URL_CLIENTE}}add-bet" \
  -H "Content-Type: application/json" \
  -d '{
    "playerName": "casinoPlayer123",
    "gameId": "clmgj4mer000fawnho0gyt7ma",
    "amount": 100,
    "idTransaction": "idTransaction",
    "token_room": "playerSessionToken",
    "movementId": "3f2a9c4e-7b1d-5e8a-9c2f-1a6b4d8e0f73"
  }'

{
  "data": 2187.3,
  "status": {
    "code": "0",
    "message": "Success",
    "datetime": "2026-10-20T21:07:03.930Z"
  }
}

Body parameters

Response

data: the player's new balance after the debit. If the balance is not enough, respond with the insufficient-balance error.

Add Win#

Credits the amount to the player's balance. It is used for wins, for bet cancellations or refunds and, in Transfer, to return the balance when the session closes.

curl -X POST "{{API_URL_CLIENTE}}add-win" \
  -H "Content-Type: application/json" \
  -d '{
    "playerName": "casinoPlayer123",
    "gameId": "clmgj4mer000fawnho0gyt7ma",
    "amount": 150,
    "idTransaction": "idTransaction",
    "token_room": "playerSessionToken",
    "movementId": "3f2a9c4e-7b1d-5e8a-9c2f-1a6b4d8e0f73"
  }'

{
  "data": 2337.3,
  "status": {
    "code": "0",
    "message": "Success",
    "datetime": "2026-10-20T21:07:03.930Z"
  }
}

Body parameters

Response

data: the player's new balance after the credit.

Update Totals Games#

When a Transfer session closes, AIC reports the session totals for your records. It does not move balance: the balance has already returned through add-win.

curl -X POST "{{API_URL_CLIENTE}}update-totals-games" \
  -H "Content-Type: application/json" \
  -d '{
    "gameId": "clmgj4mer000fawnho0gyt7ma",
    "totalBet": 500,
    "totalWin": 420,
    "playerName": "casinoPlayer123",
    "averageBet": 10
  }'

Body parameters

Rollback#

Some suppliers reverse a round with this call. Apply new balance = balance − amountWin + amountBet and respond with the new balance in data.

curl -X POST "{{API_URL_CLIENTE}}rollback" \
  -H "Content-Type: application/json" \
  -d '{
    "playerName": "casinoPlayer123",
    "gameId": "clmgj4mer000fawnho0gyt7ma",
    "amountBet": 100,
    "amountWin": 0,
    "movementId": "8c1e5d27-4a9b-5f3c-b6d0-2e7f9a1c4b58"
  }'

{
  "data": 2287.3,
  "status": {
    "code": "0",
    "message": "Success",
    "datetime": "2026-10-20T21:07:03.930Z"
  }
}

Body parameters