Seamless Document

Table of contents

1. Callback / Void
2. List games
3. Launch game
4. History
5. Create Player
6. List Providers
7. Game Logs
8. Appendix
9. lang
10. Create free round
11. Get free round
12. Cancel free round

1. Callback / Void

You will have to implement 3 callback functions

1. Balance
2. Callback
3. Void

Agent Callback Key

You will be provided with this document. Please validate this key before continue the process.

Error Codes

Result

All result will be in the below format but data field is vary depending on each callback.

Balance Callback

We will call this callback in order to retrieve player’s balance

POST {{callback_url}}/balance

Request Params

Request Example

{
	"key": "agent_callback_key",
	"username": "player001"
}

Response Params

Response Example

{
	"ok": true,
	"data": {
		"balance": "100.00"
	}
}

Callback Rules

We will call this callback when there are some actions that need to be done. The actions will always send in batch. The batch transactions should process in order. If one of the transaction is failed, we will retry the whole requests.

• Treat the actions as transactional (All or None).
• Pay attention to the amout signs. Amount can be negative or positive.
• idemptKey is used to protect the batch to process more than once.
• transaction.providerTxId is unique per type (ie. you may receive same providerTxId for bet and result)
• transaction.providerTxId can be empty as some provider ie. SBO will not have providerTxId when settle.
• If you haven't process the idemptKey but transaction.txId exists, skip wallet operation and return previous success result for that transaction.
• Do not process providerTxId of the same type twice except some allowBetMore flag (See more in Bet section)

Scenerio Example: In case of allowBetMore is false

Scenerio Example: In case of allowBetMore is true

• Pay attention to allowNegative flag. If allowNegative is true, your wallet should be able to deduct balance below zero, otherwise return INSUFFICIENT_CREDIT error
• Batch can be multiple transactions, multiple rounds and single player for Bet, CancelBet, Tip, CancelTip
• Batch can be multiple transactions, multiple rounds and multiple players for actions Settle, VoidBet, ReSettle, Bonus
• Batch can be combination of Bet and Result (In-Out transaction) and CancelBet and CancelSettle (cancel In-Out transaction)
• if CancelBet came before bet, the CancelBet should not adjust balance, also the following bet that might come later will do nothing.

Common Actions

Bet

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as negative decimal ex. -10, you should deduct 10 from player’s balance.
• Before deduct should check for CancelBet action that might came in earlier than Bet. In this case, do not deduct the balance.
• Before checking idempotent key, if flag allowBetMore = true, should be able deducted with amount that exceed previous bet. If allowBetMore = false or amount is the same as previous bet, return idempotent success.
• If allowNegative is false, return error if balance is not enough.
• Bet will have betType params in Info Object. BetType can be normal or tournament.

Scenerio Example

Settle

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as positive decimal or it can be 0, if player lost ex. 10, you should add 10 to player’s balance.
• Settle can be sent multiple times if the round is not ended.
• Settle will have betType params in Info Object. BetType can be normal(empty) or tournament.

ReSettle

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount can be positive or negative.
• RoundId will always be sent in ReSettle action

CancelBet

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as positive decimal ex. 10, you should add 10 from player’s balance.
• If there is no previous Bet of reverseTxId, do not deduct the balance.
• Cannot cancel bet more than bet amount.
• After bet is canceled, round can be rollbacked.
• CancelBet will have betType params in Info Object. BetType can be normal(empty) or tournament.
• CancelBet can be partial, if the amount is less than the bet amount, the balance should be deducted by the amount.

Scenerio Example

CancelSettle

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as negative decimal ex. -10, you should deduct 10 from player’s balance.

Scenerio Example

Bonus

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as positive decimal.
• No RoundId will be sent for Bonus action.
• Bonus will be sent to operator when player got bonus in game which is not related to any games.

Tip

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as negative decimal ex. -10, you should deduct 10 from player’s balance.
• Before deduct should check for CancelTip action that might came in earlier than Tip. In this case, do not deduct the balance.
• If allowNegative is false, return error if balance is not enough.

Scenerio Example

CancelTip

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as positive decimal ex. 10, you should add 10 from player’s balance.
• If there is no previous Tip of reverseTxId, do not deduct the balance.

Deposit

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as positive decimal.
• There is no guarantee that roundId and gameId are sent with this Action.
• No RoundId will be sent for Deposit/Withdraw action.
• Deposit/Withdraw will be sent to operator when player got bonus in game which is not related to any games.

Withdraw

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The amount will be sent as negative decimal.
• There is no guarantee that roundId and gameId are sent with this Action.
• No RoundId will be sent for Deposit/Withdraw action.
• Deposit/Withdraw will be sent to operator when player got bonus in game which is not related to any games.

Rollback

• Should validate the idempotent(transaction.providerTxId) key of this action, if the key is already processed, return success.
• The concept of Rollback is to cancel voided round back to bet state.
• If the action is rollback, the reverseTxId will refer to providerTxId of bet or settle

Scenerio Example

Asynchronous Actions

Some batch actions, we will not wait for wallet result and assume the transaction always succeeded. If agent return error (http is not 200 OK or ok is false), we will retry the actions until success using exponential backoff starting with 10 seconds and maximum 600 seconds. We will stop sending request after 7 days.

The effected actions are

• VoidBet
• Result
• ReSettle
• Bonus

These 4 actions require agent to use generated transactionId items[].transaction.txId as agent transactionId. For other actions, agent can generate the txId themselves

POST {{callback_url}}/callback

Request Params

*string - mandatory string - optional

Transaction Object

Info Object

BetTypeInfo Keys

Item Object

Batch Request

Request Example: Example basic bet

Bet Request

{
	"idemKey": "6wbt0ygjhkv",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"allowNegative": false,
			"allowBetMore": false,
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "x5ep4bqwpok",
				"gameId": "ae_00001",
				"roundId": "p3tapalghk",
				"timestamp": "2023-05-12T08:49:11.563Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		}
	]
}

Request Example: In-Out Bet + Result

Bet Request

{
	"idemKey": "la3fhts56ai",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "pg",
				"providerTxId": "33y8cru14to",
				"gameId": "pg_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		},
		{
			"username": "player001",
			"amount": "20",
			"currency": "THB",
			"action": "settle",
			"transaction": {
				"txId": "unique-112",
				"providerId": "pg",
				"providerTxId": "suo7pt600em",
				"gameId": "pg_00001",
				"roundId": "2imoj1n5byi",
				"amount": "20",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "20"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		},
		{
			"txId": "unique-112",
			"beforeBalance": "990",
			"afterBalance": "1010"
		}
	]
}

Request Example: Multiple bets with single players

Bet Request

{
	"idemKey": "stbztx1wznd",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		},
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		},
		{
			"txId": "unique-112",
			"beforeBalance": "990",
			"afterBalance": "980"
		}
	]
}

Request Example: Multiple settle multiple players

Settle Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "20",
			"currency" : "THB",
			"action": "settle",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "20",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": true,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "20"
			}
		},
		{
			"username": "player002",
			"amount": "20",
			"currency" : "THB",
			"action": "settle",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "20",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": true,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "20"
			}
		}
	]
}

Settle Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "980",
			"afterBalance": "1000"
		},
		{
			"txId": "unique-112",
			"beforeBalance": "500",
			"afterBalance": "520"
		}
	]
}

Request Example: Bet and CancelBet

Bet Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		}
	]
}

CancelBet Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "10",
			"currency" : "THB",
			"action": "cancelBet",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "44y8cru14to",
				"reverseTxId": "unique-111",
				"reverseAction": "bet",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "10"
			}
		}
	]
}

CancelBet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-112",
			"beforeBalance": "990",
			"afterBalance": "1000"
		}
	]
}

Request Example: CancelSettle

Bet Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		}
	]
}

Settle Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "20",
			"currency" : "THB",
			"action": "settle",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "20",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": true,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "20"
			}
		}
	]
}

Settle Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-112",
			"beforeBalance": "990",
			"afterBalance": "1010"
		}
	]
}

CancelSettle Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-20",
			"currency" : "THB",
			"action": "cancelSettle",
			"transaction": {
				"txId": "unique-113",
				"providerId": "ae",
				"providerTxId": "44y8cru14to",
				"reverseTxId": "unique-112",
				"reverseAction": "settle",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-20",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-20"
			}
		}
	]
}

CancelSettle Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-113",
			"beforeBalance": "1010",
			"afterBalance": "990"
		}
	]
}

Request Example: Rollback

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-111",
			"beforeBalance": "1000",
			"afterBalance": "990"
		}
	]
}

CancelBet Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "10",
			"currency" : "THB",
			"action": "cancelBet",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "44y8cru14to",
				"reverseTxId": "unique-111",
				"reverseAction": "bet",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "10"
			}
		}
	]
}

CancelSettle Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-112",
			"beforeBalance": "990",
			"afterBalance": "110"
		}
	]
}

Rollback Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "rollback",
			"transaction": {
				"txId": "unique-113",
				"providerId": "ae",
				"providerTxId": "55y8cru14to",
				"reverseTxId": "unique-112",
				"reverseAction": "cancelBet",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

CancelSettle Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-113",
			"beforeBalance": "1010",
			"afterBalance": "990"
		}
	]
}

Request Example: Allow Bet More

Bet Request

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "bet",
			"transaction": {
				"txId": "unique-111",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "175e5f9f40ee135f7368ad4c0968dc6b",
			"beforeBalance": "1000",
			"afterBalance": "990"
		}
	]
}

Bet Request (Allow Bet More 5 more bet)

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-5",
			"currency" : "THB",
			"action": "bet",
			"allowBetMore": true,
			"transaction": {
				"txId": "unique-211",
				"providerId": "ae",
				"providerTxId": "33y8cru14to",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-5",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-5"
			}
		}
	]
}

Bet Response

{
	"ok": true,
	"result": [
		{
			"txId": "unique-211",
			"beforeBalance": "990",
			"afterBalance": "985"
		}
	]
}

CancelBet Request (All)

{
	"idemKey": "xv8ejhloqy",
	"key": "agent key",
	"items": [
		{
			"username": "player001",
			"amount": "-10",
			"currency" : "THB",
			"action": "cancelBet",
			"transaction": {
				"txId": "unique-112",
				"providerId": "ae",
				"providerTxId": "44y8cru14to",
				"reverseTxId": "unique-111",
				"reverseAction": "bet",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-10",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-10"
			}
		},
		{
			"username": "player001",
			"amount": "-5",
			"currency" : "THB",
			"action": "cancelBet",
			"transaction": {
				"txId": "unique-212",
				"providerId": "ae",
				"providerTxId": "44y8cru14to",
				"reverseTxId": "unique-211",
				"reverseAction": "bet",
				"gameId": "ae_00001",
				"roundId": "2imoj1n5byi",
				"amount": "-5",
				"timestamp": "2023-05-12T08:49:10.072Z"
			},
			"info": {
				"roundClosed": false,
				"freeSpin": false,
				"buyFeature": false,
				"freeRound": false,
				"freeRoundCode": "",
				"jackpot": false,
				"realAmount": "-5"
			}
		}
	]
}

Response Params

The result consist of array of result with the same length array as batch

[].txId string Transaction ID of fund transfer that can be used to reference with your system. Return same txId for reference. [].beforeBalance string (decimal format) Balance before fund transfer [].afterBalance string (decimal format) Balance after fund transfer

Response Example

{
	"ok": true,
	"result": [
		{
			"txId": "175e5f9f40ee135f7368ad4c0968dc6b",
			"beforeBalance": "1070",
			"afterBalance": "1060"
		},
		{
			"txId": "175e5f9f40ee2c57d0986e53090b13e5",
			"beforeBalance": "1060",
			"afterBalance": "1080"
		}
	]
}

Void Callback

Void callback is called when system wants to revert the previous operation of the specific Idempty. Normally void is called when system didn't get any response from operator or request timeout.

Void Request

API

All apis are made in POST and Content-Type is application/json with Authorization header.

Error Codes

Header

Result

All result will be in the below format but data field is vary depending on each callback.

2. Games List

To get games list

POST {{api_url}}/games

Request Params

Request Example

{
	"query": "Fire Joker"
}

Response Params

Game Item

Category Item

Response Example

{
	"ok": true,
	"result": {
		"items": [
			{
				"id": "png_00072",
				"name": "Fire Joker",
				"logoUrl": "",
				"category": {
					"id": "slot",
					 "label": "Slot"
				}
			},
			{
				"id": "png_00073",
				"name": "Fire Joker Freeze",
				"logoUrl": "",
				"category": {
					"id": "slot",
					"label": "Slot"
				}
			}
		]
	}
}

3. Launch Game

To launch game

POST {{api_url}}/launchGame

Request Params

Note: currency that player will be charged with, might not be the same with currency that player is playing with

Request Example

{
	"username": "player0001",
	"isMobile": false,
	"gameId": "pg_00001",
	"lang": "th",
	"currency": "THB"
}

Response Params

Response Example

{
	"ok": true,
	"result": {
		"type": "url",
		"url": "https://m.pg-redirect.net/60/index.html?ot=1234&ops=1234&btt=1"
	}
}

4. History

To get player history

POST {{api_url}}/history

Request Params

Request Example

{
	"username": "player0001",
	"gameId": "",
	"roundId": "",
	"from": null,
	"to": null,
	"paginate": {
		"page": 1,
		"perPage": 2
	}
}

Response Params

Provider Item

Game Item

UserInGame Item

TxType Item

Amount Item

Ratio between provider and system currency. Mostly provider and system currency is 1:1 ratio. Sometimes provider currency is different with system currency, so we need to convert it to system currency. Ex. Provider currency is KIDR, system currency is IDR, so we need to convert KIDR to IDR with 1:1000 ratio.

History Item

CurrencyGroup Item is map<string, History[]> where key is currency, values is list of History items

Response Example

{
    "ok": true,
    "result": {
        "currencyGroup": {
            "EUR": {
                "items": [
                    {
                        "id": "17ed71c33d5d684bd10b18d816c83099",
                        "provider": {
                            "id": "pg",
                            "name": "Pocket Games Soft"
                        },
                        "userInGame": {
                            "userInGame": "2sjcc5qal9bq21ud-IDR",
                            "playerId": "2sjcc5qal9bq21ud",
                            "agentId": 9,
                            "agentPrefix": "2sjcc",
                            "currency": "IDR",
                            "username": "player0001"
                        },
                        "game": {
                            "gameId": "pg_00001",
                            "name": "Leprechaun Riches",
                            "category": "slot"
                        },
                        "roundId": "1825882618634307073",
                        "walletTxId": "17ed71c2e8151189ec73baeab9d19a65",
                        "providerTxId": "1825882618634307073-1825882618634307073-106-0",
                        "txType": {
                            "id": 2,
                            "label": "Settle",
                            "flag": ""
                        },
                        "amount": {
                            "providerCurrency": "IDR",
                            "playerCurrency": "IDR",
                            "amount": {
                                "providerAmount": "0",
                                "playerAmount": "0"
                            }
                        },
                        "walletBeforeBalance": "5011680",
                        "walletAfterBalance": "5011680",
                        "receivedAt": "2024-08-20T13:08:34.280062Z"
                    },
					{
                        "id": "17ed71c33d5d50bdf5f7fafed4683bf7",
                        "provider": {
                            "id": "pg",
                            "name": "Pocket Games Soft"
                        },
                        "userInGame": {
                            "userInGame": "2sjcc5qal9bq21ud-IDR",
                            "playerId": "2sjcc5qal9bq21ud",
                            "agentId": 9,
                            "agentPrefix": "2sjcc",
                            "currency": "IDR",
                            "username": "player0001"
                        },
                        "game": {
                            "gameId": "pg_00001",
                            "name": "Leprechaun Riches",
                            "category": "slot"
                        },
                        "roundId": "1825882618634307073",
                        "walletTxId": "17ed71c2e815058b453e6564348caf09",
                        "providerTxId": "1825882618634307073-1825882618634307073-106-0",
                        "txType": {
                            "id": 1,
                            "label": "Bet",
                            "flag": ""
                        },
                        "amount": {
                            "providerCurrency": "IDR",
                            "playerCurrency": "IDR",
                            "amount": {
                                "providerAmount": "-1.6",
                                "playerAmount": "-1600"
                            }
                        },
                        "walletBeforeBalance": "5011680",
                        "walletAfterBalance": "5010080",
                        "receivedAt": "2024-08-20T13:08:34.280062Z"
                    }
				]
			}
		},
		"paginate": {
			"page": 1,
			"perPage": 20,
			"next": true
		}
	}
}

{
	"ok": false,
	"error": {
		"code": "PLAYER_NOT_FOUND",
		"message": "player not found"
	}
}

5. Create Player

To create player with unique username, username must not contain special characters

POST {{api_url}}/createPlayer

Request Params

Request Example

{
	"username": "player0001"
}

Response Example

{
	"ok": true,
	"result": {}
}

{
	"ok": false,
	"error": {
		"code": "PLAYER_USERNAME_UNAVAILABLE",
		"message": "username unavailable"
	}
}

6. List Providers

To get list of providers

POST {{api_url}}/providers

Request Example

{}

Response Params

{
    "ok": true,
    "result": {
        "items": [
            {
                "id": "pg",
                "name": "Pocket Games Soft",
                "logoUrl": "https://cdn.zgaggregator.com/17e2088b03ac99bf23be7e656d88926d",
                "active": true,
                "online": true,
                "categories": [
                    {
                        "id": "slot",
                        "label": "Slot"
                    }
                ]
            },
            {
                "id": "pp",
                "name": "Pragmatic Play",
                "logoUrl": "https://cdn.zgaggregator.com/17e208872f9db8d10e959de030b465a1",
                "active": true,
                "online": true,
                "categories": [
                    {
                        "id": "slot",
                        "label": "Slot"
                    }
                ]
            }
        ]
    }
}

7. Game Logs

To get game logs

POST {{api_url}}/gameLogs

Request Params

Send historyId or gameId + username + roundId

Request Example

{
	"historyId": "1"
}

or

{
	"gameId": "habanero_00001",
	"username": "player0001",
	"roundId": "wwsnprklgu"
}

Response Params

Some data might be empty, it depends on provider

Result Item

Transaction Item

Hands Item

Pocket Item

Response Example

{
    "ok": true,
    "result": {
        "providerId": "pg",
        "gameType": "Slot",
        "gameName": "Leprechaun Riches",
        "roundId": "1825882618634307073",
        "result": {
            "logType": "iframe",
            "url": "https://public.pg-staging.com//history/redirect.html?trace_id=17ef3c5a35ff0afb09d65788c2084318&psid=1825882618634307073&sid=1825882618634307073-1825882618634307073-106-0&lang=en&type=operator&t=6269A17A-B45C-4C07-844E-0ABFF3310A6D",
            "gameName": "",
            "gameResult": ""
        },
        "transactions": [
            {
                "id": "1825882618634307073-1825882618634307073-106-0",
                "type": "Bet",
                "providerAmount": "-1.6",
                "providerCurrency": "IDR",
                "walletCurrency": "IDR",
                "beforeBalance": "5011680",
                "afterBalance": "5010080",
                "createdAt": "2024-08-20T13:08:34.280062Z",
                "agentProviderKeyRevisionID": "17ec24536a56fe9e38a6d83fe0745151"
            },
            {
                "id": "1825882618634307073-1825882618634307073-106-0",
                "type": "Settle",
                "providerAmount": "0",
                "providerCurrency": "IDR",
                "walletCurrency": "IDR",
                "beforeBalance": "5011680",
                "afterBalance": "5011680",
                "createdAt": "2024-08-20T13:08:34.280062Z",
                "agentProviderKeyRevisionID": "17ec24536a56fe9e38a6d83fe0745151"
            }
        ]
    }
}

8. Appendix

9. Lang

SA Game

BetType for Baccarat

BetType for Dragon Tiger

BetType for Sic Bo

BetType for Roulette

BetType for Pok Deng

BetType for Andar Bahar

10. Create free round

To create free rounds for a player for a specific game

POST {{api_url}}/freeRound

Request Params

Request Example

{
    "currency": "IDR",
    "bonusCode": "freeRound0001",
    "username": "player0001",
    "gameId": "pg_00001",
    "from": "2024-08-20T13:08:34.280062Z",
    "to": "2024-08-20T13:08:34.280062Z",
    "rounds": 10,
    "betAmount": "1.6"
}

Response Params

Response Example

{
    "ok": true,
    "result": {
        "userInGame": "aaaaa51239bq21ss-IDR",
		"freeGameId: "test01",
		"freeGameCode": "freeRound0001"
    }
}

11. Get free round

To get free rounds detail for a player from the provider

POST {{api_url}}/getFreeRound

Request Params

Request Example

{
    "currency": "IDR",
    "username": "player0001",
    "gameId": "pg_00001",
    "from": "2024-08-20T13:08:34.280062Z",
    "to": "2024-08-20T13:08:34.280062Z"
}

Response Params

PP Response Object

Array of object

PP Response Example

{
    "ok": true,
    "result": {
        "ppResult": [
            {
                "currency": "EUR",
                "gameIDList": "vs20mparty",
                "rounds": 1,
                "roundsPlayed": 0,
                "bonusCode": "1c1698c9-f043-45c2-89ce-53fb70be24df",
                "expirationDate": "2024-12-25 17:00"
            },
            {
                "currency": "EUR",
                "gameIDList": "vs20mparty",
                "rounds": 1,
                "roundsPlayed": 0,
                "bonusCode": "ce61c477-e216-473f-866e-1675d09f53b1",
                "expirationDate": "2024-12-25 17:00"
            }
        ],
        "pgResult": null
    }
}

PG Response Object

PG Response Example

{
    "ok": true,
    "result": {
        "pgResult": {
            "totalCount": 0,
            "totalPage": 0,
            "result": [
                {
                    "freeGameId": 263545,
                    "freeGameName": "",
                    "playerName": "2sjcc5qal9bq21ud-VND",
                    "currencyCode": "VND",
                    "totalFreeGame": 1,
                    "coinSize": 0.5,
                    "multiplier": 10,
                    "payout": 0,
                    "remainCount": 0,
                    "conversionType": "Cash",
                    "transactionId": "",
                    "isEvent": false,
                    "gameIds": null,
                    "totalGame": 0,
                    "status": 4,
                    "createdTime": 1734010955000,
                    "updatedTime": 1734011141782
                }
            ]
        }
    }
}

12. Cancel free round

To cancel free rounds for a player from the provider

POST {{api_url}}/cancelFreeRound

Request Params

Request Example

{
    "currency": "IDR",
    "username": "player0001",
    "gameId": "pg_00001",
    "freeRoundId": "test01",
	"freeRoundCode": "freeRound0001"
}