API

This section is to illustrate the detail of implementing transferwallet in external partner system.

Preliminary information in order to run the API, the partner system must have prevalence of commands So that the system can run the API under conditions

*If you hold a master account, please create an agent API account under your master account and login with created agent API account before following this setting step. 1. Login

2. Click the Account menu and select the Profile menu

3. Define the following API information

3.1 You can add multiple IP addresses by press the button

3.2 You can click “API Document” button for preview Information

3.3 You can click “Save Profile” button for saving data

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/member/loginRequest

headers : content-type application/json

Request Body

Parameter	Type	Required	Description
agentUsername	String	Yes	Agent account , Account length is restricted to 36 chars at most
agentApiKey	String	Yes	System generate key ID after crate Agent
playerUsername	String	Yes	Player account , Account length is restricted to 36 chars at most
betLimit	arrayNumber	Yes	betLimit can containt maximum 6 values depends on the currency. you can see the limits in this table: Currency / Bet Limit

Example Request Body

{
  "agentUsername": "sb234567123",
  "agentApiKey": "33c0d59d-51b9-45e0-ba7f-4ca442cd8421",
  "playerUsername": "as001",
  "betLimit": [
    1001,
    1006,
    1012
  ]
}

Response Body

Parameter	Type	Description
code	Number	Result Code Reference.
msg	String	Information message.
data	Object	Object respone.
playerApiId	String
playerApiUsername	String	Player username from Pretty Gaming system.
playerUsername	String	Player username from partner system.
tkUuid	String	Can use only 1 time. limit to 24 hours from generate time.
uriDesktop	String	Game link(Desktop version)
uriMobile	String	Game link(Mobile version)

Response Code

Parameter	Description
0	success
41001	Error Request body is not an object.
61001	IP address is not allowed.
71004	missing filed 'playerUsername'.
71005	playerUsername must be between 4 and 24 characters long.
71006	username must not contain any special characters and can only contain letters a-z and numbers 0-9.
71007	invalid bet limit id.

Example Response Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "playerApiId": "5ebd1f57dc7cdc7900125a64",
    "playerApiUsername": "transferwallet@sb234567123",
    "playerUsername": "transferwallet",
    "tkUuid": "5ebd1f57dc7cdc7900125a65",
    "uriDesktop": "http://hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65",
    "uriMobile": "http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65"
  }
}

** Optional for direct/re-direct link.

You can add a value (BAC, DRA, SIC, ROU, MUL) to the parameter in the of the link (&game=) to redirect players to the specific games

Download Icon

Name	Value of parameter	Image icon
Baccarat	BAC
Dragon-Tiger	DRA
Roulette	ROU
SicBo	SIC
Multi-Table	MUL

Game direct link

Baccarat : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC

Dragon-Tiger : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=DRA

Roulette : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=ROU

SicBo : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=SIC

Multi-Table : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=MUL

Language

Remark: please use exactly code with example.

Language	Value of parameter
English	EN
Thai	TH
Chinese Mandarin	CNM
Chinese Cantonese	CNC
Korean	KOR
Vietnam	VT

English : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=EN

Thai : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=TH

Chinese Mandarin : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=CNM

Chinese Cantonese : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=CNC

Korean : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=KOR

Vietnam : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&lang=VT

Signout re-direct optional link:

Baccarat : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=BAC&url=input your link here(full link with https://)

Dragon-Tiger : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=DRA&url=input your link here(full link with https://)

Roulette : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=ROU&url=input your link here(full link with https://)

SicBo : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=SIC&url=input your link here(full link with https://)

Multi-Table : http://m.hippo168.com/?tkuuid=5ebd1f57dc7cdc7900125a65&game=MUL&url=input your link here(full link with https://)

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/getUserBalance

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
playerUsername	String	Player username from partner system.

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "playerUsername": "startTransferwalletmember"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
balance	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71017	Can request up to 30 times per minute.
911008	Player not found.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "playerApiId": "5eae90e32f7df02c92fde32d",
    "playerUsername": "startTransferwalletmember",
    "playerApiUsername": "startTransferwalletmember@startapiTransferwallet",
    "balance": 0
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/deposit

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
playerUsername	String	Player username from partner system.
balance	Number
transId	String	Optional: should be Unique key from your system. reference to 4.12 depositWithdrawHistoryByTransId

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "playerUsername": "startTransferwalletmember",
  "balance": 100,
  "transId": "5f0c27dbea3f3261f2cd3886"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
ref	String	Yes
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
addBalance	Number	Yes
afterMemberBalance	Number	Yes
afterAgentBalance	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
997	invalid input format 'balance' field.
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71017	Can request up to 30 times per minute.
911001	Insufficient balance.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "ref": "1ab5e3d6240525370dbf8ad9",
    "playerApiId": "5eae90e32f7df02c92fde32d",
    "playerUsername": "startTransferwalletmember",
    "playerApiUsername": "startTransferwalletmember@startapiTransferwallet",
    "addBalance": 100,
    "afterMemberBalance": 100,
    "afterAgentBalance": 10011800
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/withdrawal

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
playerUsername	String	Player username from partner system.
balance	Number
transId	String	Optional: should be Unique key from your system. reference to 4.12 depositWithdrawHistoryByTransId

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "playerUsername": "startTransferwalletmember",
  "balance": 100,
  "transId": "5f0c27dbea3f3261f2cd3886"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
ref	String	Yes
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
addBalance	Number	Yes
afterMemberBalance	Number	Yes
afterAgentBalance	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
997	invalid input format 'balance' field.
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71017	Can request up to 30 times per minute.
911001	Insufficient balance.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "ref": "5ee1b3d6240525370dbf8ad9",
    "playerApiId": "5eae90e32f7df02c92fde32d",
    "playerUsername": "startTransferwalletmember",
    "playerApiUsername": "startTransferwalletmember@startapiTransferwallet",
    "addBalance": 100,
    "afterMemberBalance": 10011900,
    "afterAgentBalance": 0
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/memberBetHistories

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
playerUsername	String	Player username from partner system.
startDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
page	Number

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "playerUsername": "startTransferwalletmember",
  "startDate": "2019-05-03 20:36:13",
  "endDate": "2020-05-20 20:36:13",
  "page": 1
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
startDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
result	Object	Yes
docs	Array	Yes	Array of documents.
totalDocs	Number	Yes	Total number of documents in collection that match a query.
limit	Number	Yes	Limit that was used.
totalPages	Number	Yes	Total number of pages.
page	Number	Yes	Current page number.
pagingCounter	Number	Yes	The starting sl. number of first document.
hasPrevPage	Number	Yes
hasNextPage	Number	Yes
prevPage	Number	Yes
nextPage	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
997	invalid input format 'balance' field.
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71016	Can request up to 15 times per minute.
71018	missing filed 'startDate'.
71019	missing filed 'endDate'.
71020	Invalid filed 'startDate'.
71021	Invalid filed 'endDate'.
71022	Invalid filed 'page'.
911008	Player not found.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "playerApiId": "5eae90e32f7df02c92fde32d",
    "playerUsername": "startTransferwalletmember",
    "playerApiUsername": "startTransferwalletmember@startapiTransferwallet",
    "startDate": "2019-05-03 20:36:13",
    "endDate": "2020-05-20 20:36:13",
    "result": {
      "docs": [],
      "totalDocs": 0,
      "limit": 100,
      "totalPages": 1,
      "page": 1,
      "pagingCounter": 1,
      "hasPrevPage": false,
      "hasNextPage": false,
      "prevPage": null,
      "nextPage": null
    }
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/betHistories

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
startDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
page	Number

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "startDate": "2019-05-03 20:36:13",
  "endDate": "2020-05-20 20:36:13",
  "page": 1
}

Bet Position

Parameter	Description
BACCARAT	'banker', 'player', 'tie', 'bankerPair', 'playerPair', 'big', 'small', 'bankerNatural', 'playerNatural', 'super6'
DRAGON TIGER	'dragon','tiger'
TIPS DEALER	'tips'

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
agentUserId	String	Yes
agentUsername	String	Yes	Agent account , Account length is restricted to 36 chars at most.
startDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
updateDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+0)
createDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+0)
result	Object	Yes
docs	Array	Yes	Array of documents.
totalDocs	Number	Yes	Total number of documents in collection that match a query.
limit	Number	Yes	Limit that was used.
totalPages	Number	Yes	Total number of pages.
page	Number	Yes	Current page number.
pagingCounter	Number	Yes	The starting sl. number of first document.
hasPrevPage	Number	Yes
hasNextPage	Number	Yes
prevPage	Number	Yes
nextPage	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
997	invalid input format 'balance' field.
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71016	Can request up to 15 times per minute.
71018	missing filed 'startDate'.
71019	missing filed 'endDate'.
71020	Invalid filed 'startDate'.
71021	Invalid filed 'endDate'.
71022	Invalid filed 'page'.
911008	Player not found.

Calculation Description

Parameter	Description
validAmt	validAmt = betAmt
payOutAmt	payOutAmt = (betAmt(absolute) * payOutRate) + payOutCom
winLose	winLose = payOutAmt - validAmt

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "agentUserId": "5eae908903b0b56fd5b1f429",
    "agentUsername": "startapiTransferwallet",
    "startDate": "2019-05-03 20:36:13",
    "endDate": "2020-05-20 20:36:13",
    "result": {
      "docs": [
        {
          "validAmt": 100,
          "payOutCom": 0,
          "payOutBet": 200,
          "winLose": 100,
          "payOutAmt": 200,
          "betStatus": "Win",
          "status": "SuccessfulPayment",
          "_id": "7h2hhe2ed4g85d86551h60hh",
          "memberId": "7h2080e87cgged83ge4h37g7",
          "memberUsername": "perttygaming@perttygaming",
          "currency": "THB",
          "ticketId": "1111676",
          "type": "DragonTiger",
          "gameId": 771112,
          "tableId": "DRG-1",
          "round": 38,
          "commissionRate": 0,
          "payOutRate": 2,
          "betPosition": "tiger",
          "betAmt": -100,
          "ip": "305.00.440.440",
          "updateDate": "2020-07-16T07:04:44.270Z",
          "createDate": "2020-07-16T07:04:44.270Z",
          "__v": 0,
          "result": {
            "rsBc": {
              "banker_1": null,
              "banker_2": null,
              "banker_3": null,
              "banker123": 0,
              "player_1": null,
              "player_2": null,
              "player_3": null,
              "player123": 0
            },
            "rsDr": {
              "dragon": "9H",
              "dragon_tt": 9,
              "tiger": "JS",
              "tiger_tt": 11
            },
            "rsRu": null,
            "rsSic": null,
            "winBc": [],
            "winDr": "TIGER",
            "winRu": null,
            "winSic": []
          }
        }
      ],
      "totalDocs": 0,
      "limit": 100,
      "totalPages": 1,
      "page": 1,
      "pagingCounter": 1,
      "hasPrevPage": false,
      "hasNextPage": false,
      "prevPage": null,
      "nextPage": null
    }
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/getMemberWinLoseTurnOver

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
playerUsername	String	Player username from partner system.
startDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "playerUsername": "startTransferwalletmember",
  "startDate": "2019-05-03 20:36:13",
  "endDate": "2020-05-20 20:36:13"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
startDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
endDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)
turnOver	Number	Yes

Service Response Code

Parameter	Description
0	SUCCESS
997	invalid input format 'balance' field.
71001	missing filed 'agentUsername'.
71002	missing filed 'agentApiKey'.
71003	Invalid agentUsername or apiKey.
71004	missing filed 'playerUsername'.
71015	Can request up to 5 times per minute.
71018	missing filed 'startDate'.
71019	missing filed 'endDate'.
71020	Invalid filed 'startDate'.
71021	Invalid filed 'endDate'.
911008	Player not found.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "playerApiId": "5eae90e32f7df02c92fde32d",
    "playerUsername": "startTransferwalletmember",
    "playerApiUsername": "startTransferwalletmember@startapiTransferwallet",
    "startDate": "2019-05-03 20:36:13",
    "endDate": "2020-05-20 20:36:13",
    "turnOver": 0
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/depositWithdrawHistory

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
ref	String	Deposit/Withdraw transaction reference.

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "ref": "5f0c27dbea3f3261f2cd3886"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
ref	String	Yes	Deposit/Withdraw transaction reference.
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
transferAmount	Number	Yes
type	String	Yes
transferDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "ref": "5f0c27dbea3f3261f2cd3886",
    "playerApiId": "5f0c231d5aeecb61ec2f3867",
    "playerUsername": "startapiTransferwallet",
    "playerApiUsername": "b2uthb01@startapiTransferwallet",
    "transferAmount": 1,
    "type": "DEPOSIT",
    "transferDate": "2020-07-13 16:22:35"
  }
}

Method : Post

Url : https://api-dev.prettygaming.asia/apiRoute/api/depositWithdrawHistoryByTransId

headers : content-type application/json

Request Body

Parameter	Type	Description
agentUsername	String	Agent account , Account length is restricted to 36 chars at most.
agentApiKey	String	System generate key ID after crate Agent
transId	String	transId Unique from your system type Deposit / Withdrawal

Example Request Body

{
  "agentUsername": "startapiTransferwallet",
  "agentApiKey": "ae6330a9-6c2f-1bd3-3122-47ddad703de9",
  "transId": "5f0c27dbea3f3261f2cd3886"
}

Response Body

Parameter	Type	Required	Description
code	Number	Yes	Result Code Reference.
msg	String	Yes	Information message.
data	Object	Yes	Object respone.
transId	String	Yes	transId Unique from your system type Deposit / Withdrawal
playerApiId	String	Yes
playerUsername	String	Yes	Player username from partner system.
playerApiUsername	String	Yes	Player username from Pretty Gaming system.
transferAmount	Number	Yes
type	String	Yes
transferDate	Date	Yes	Date type “yyyy-MM-dd HH:mm:ss” (GMT+7)

Service Response Code

Parameter	Description
0	SUCCESS
71023	TransId not found.

Example Service Respond Code

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {
    "transId": "5f0c27dbea3f3261f2cd3886",
    "playerApiId": "5f0c231d5aeecb61ec2f3867",
    "playerUsername": "startapiTransferwallet",
    "playerApiUsername": "b2uthb01@startapiTransferwallet",
    "transferAmount": 1,
    "type": "DEPOSIT",
    "transferDate": "2020-07-13 16:22:35"
  }
}

4. Transferwallet Api