InfinityPlay operator integration

Casino API + wallet callbacks. Hand this page to operators, or download the full catalog: OPERATOR_INTEGRATION.md

1. Integration model

Mode	Value	You implement
Seamless	1	GetBalance + ChangeBalance on your wallet URL
Transfer	2	Deposit / Withdraw / WithdrawAll on Casino API

Every Casino API call sends JSON: method, token (agent token), agentCode. Success is status: 0.

2. Launch a game

{
  "method": "GetGameUrl",
  "token": "AGENT_TOKEN",
  "agentCode": "AGENT001",
  "userCode": "player1",
  "vendorCode": "slot-pragmatic",
  "gameCode": "vs20olympgate",
  "currencyCode": "USD",
  "language": "en",
  "homeUrl": "https://casino.example/lobby",
  "channel": "desktop"
}

Open the returned launchUrl in the player browser / WebView. Do not call Pragmatic gameService yourself.

vendorCode	Brand
slot-pragmatic	Pragmatic Play
slot-hacksaw	Hacksaw
slot-egt	EGT
slot-egt-vip	EGT VIP

Other Casino methods

method	Purpose
CreateUser / GetUserInfo	Players
GetVendors / GetVendorGames	Lobby catalog
GetWagerInfo / ReportById / ReportByDate	Settled wagers
GetDetailUrl	Round detail UI
ApplyFreeRound / CancelFreeRound	Promo free spins
GetFreeRoundSupportMap	Which games accept promo FS
ChangeUserRtp	Session RTP band
Deposit / Withdraw / WithdrawAll	Transfer mode only

3. Wallet (seamless)

One HTTPS URL. Authenticate token. Treat txnCode as idempotent. Always return post-txn balance.

GetBalance

{
  "method": "GetBalance",
  "token": "YOUR_WALLET_TOKEN",
  "userCode": "player1",
  "vendorCode": "slot-pragmatic",
  "currencyCode": "USD"
}

ChangeBalance

txnType	Meaning
0 Debit	Bet / bonus buy cost
1 Credit	Win (including feature total at the end of free spins)
2 Cancel	Reverse a debit that could not complete

Important fields: amount (signed), wagerId, gameCode, gameRoundId, isFreeRound, isFinished.

4. Pragmatic Play

• Launch only via GetGameUrl. The client talks to the game host (playGame.do → html5Game.do → gameService).
• Bonus buy: debit buy cost immediately; credit the feature win once when free spins finish.
• Promo / Apply FreeSpin: no debit per free spin; credit once at the end of the package.
• Player closes mid-feature: the unfinished round (and pending win) is stored. Reopen the same game to resume, or the stored win is paid if the round cannot continue.
• Promo FS is only for bonus-buy titles. Call GetFreeRoundSupportMap first.

5. Apply free rounds

{
  "method": "ApplyFreeRound",
  "token": "AGENT_TOKEN",
  "agentCode": "AGENT001",
  "userCode": "player1",
  "vendorCode": "slot-pragmatic",
  "gameCode": "vs20olympgate",
  "currencyCode": "USD",
  "betAmount": 0.20,
  "spinCount": 10,
  "expireHours": 24
}

Then GetGameUrl so the player opens the native free-spin dialog. Backoffice: Launch & free rounds.

6. Casino API status codes

status	Meaning
0	Success
3	Invalid agent / token
5 / 6	Invalid / blocked user
8	Insufficient money
12	Invalid vendor
13	Invalid parameter
21	Duplicate request key
23	GetBalance failed (seamless launch)

7. Go-live checklist

• Agent: agentCode, token, ApiDomain, mode 1 or 2
• Seamless: public wallet URL, idempotent txnCode, 3s timeout
• GetVendorGames lists the titles you will launch
• One real spin: debit then credit; wager in ReportById
• Bonus buy and ApplyFreeRound: one credit at feature end, not per free spin
• Close mid-FS and reopen: feature or stored win still there

8. Backoffice pages operators use

Menu	What it is for
API → API guide	This document (and the PDF tab)
API → API test	Seamless wallet callback smoke test (admin)
Game control → Launch & free rounds	Open a title, Apply / Cancel promo FS
Game control → Game list	Enable / route games per agent
Agent → Agent treeview	Create sub-agents, token, mode, wallet URL
User → User list	Players, balances, block
Report → By wager index	Settled rounds (same data as ReportById)
Profile	Password, API domain, seamless endpoint

Seamless agents must set the wallet URL on the agent (Profile / treeview) before GetGameUrl will debit/credit.

Wallet ChangeBalance example

{
  "method": "ChangeBalance",
  "token": "YOUR_WALLET_TOKEN",
  "userCode": "player1",
  "vendorCode": "slot-pragmatic",
  "currencyCode": "USD",
  "txnType": 0,
  "txnCode": "slot-pragmatic_12345_987654_0_1710000000000",
  "wagerId": 12345,
  "gameCode": "vs20olympgate",
  "amount": -1.0,
  "isFreeRound": false,
  "isFinished": false
}

Return { "status": 0, "balance": 1249.50 }. Treat duplicate txnCode as success with the same balance.