GOLDEN F TECHNICAL TEAM

API Document

Transfer Mode

p. 1
 Contents

Contents 2
1. Revision History 3
Overview 6
How to Integration Game 6
URL Scheme 6
Integration API 7
Interface Format and Description 7
API List 8
Workflow 9
API instructions 10
Create player account 10
Game Demo 12
Launch Game 14
Query wallet balance 16
Deposit 18
Withdrawal 20
Get transfer record of a single player 22
Get bet records (New) 26
Get SBO bet records details (New) 30
Get transfer records (New) 37
Error code correspondence table 41
Vendors code correspondence table 43
Currency code correspondence table 45
Language code correspondence table 47
Wallet code correspondence table 48
Game code correspondence table 50

p. 2
1. Revision History

Version Date Update by Notes

V1.01 2017-10-09 GOLDEN F Developer Team First Draft

Added PG games, Added enquiry wallet

balance function, Revise error url naming in
V1.05 2017-12-24 GOLDEN F Developer Team api document, Added game code comparison
table, Revised the parameters in api which
passed in by operator

Added PG games, Added game demos,

Renew 5.6 remarks, Added traceId two-way
V1.10 2018-02-12 GOLDEN F Developer Team
verification transaction number in deposit and
withdraw

V1.12 2018-03-23 GOLDEN F Developer Team Added PG games

Removed and added PG games, Stoped use

V1.13 2018-04-09 GOLDEN F Developer Team game_Id and always use game_code as the
main code

Add PG games, Add error code, Available for

V1.14 2018-05-22 GOLDEN F Developer Team
chinese language in the backend

Add PG games, Optimize the port architecture

V2.00 2018-06-21 GOLDEN F Developer Team to subdivide bets and payouts into more than
two records

Add PG games, Add transfer record, Adjust

error code, Available for the url after leaving
the game (Need to apply to modify), Add
V2.01 2018-07-16 GOLDEN F Developer Team
nickname field when starting the game,
Limiting the number of records for a single
acquisition of Record

Add PG games, Add traceId query mode in

transfer record, Add ‘back to the trans_type’ in
V2.02 2018-08-20 GOLDEN F Developer Team
bet record, Add parent_bet_id to indicate the
parent note number in bet record

Add PG games, ‘Win Win Won’ changed to

V2.03 2018-09-03 GOLDEN F Developer Team
become ‘Win Win Won2’

Add PG games, Add KY games, Add CQ9

games, Add specify wallet, AG live video and
V2.04 2018-11-15 GOLDEN F Developer Team
LB-KENO lottery and CQ9 fish game are
starting internal test

Add PG games, Newly launched AG live video

and LB-KENO lottery and CQ9 fish game go
live, Add ‘timestamp_digit’ which specified
V2.05 2018-12-01 GOLDEN F Developer Team
return timestamp format in get bet record API,
and expected to be fully changed to 13-digit
timestamp in March 2019

Get record API changed to 13-digit timestamp,

PG games added more languages and
V2.06 2019-03-20 GOLDEN F Developer Team
currency, New GOLDEN F card game, AG fish
game, XJ Xiaojin Sports

p. 3
 V2.07 2019-05-28 GOLDEN F Developer Team Add sports wallet and SBO sport games

Update the error code rule and content, when

V2.08 2019-07-25 GOLDEN F Developer Team transfer record’s response is empty set, it’s
belongs to error message.

Update the supplement No.2 in 5.7 & 5.9:

You can use the last_record_time
V2.09 2019-09-26 GOLDEN F Developer Team
directly as a row_version to get
subsequent data at next call.

V2.10 2019-11-22 GOLDEN F Developer Team Add MGPLUS wallet and Slot/Video games

V2.11 2019-11-25 GOLDEN F Developer Team Add sport wallet - TFG esports

V2.12 2019-11-28 GOLDEN F Developer Team Updated Currency and Language tables

Added to get bet records details in chapter

V2.13 2019-12-19 GOLDEN F Developer Team
5.7.1 ( Only for SBO sports ）

1.Updated support currency for SBO

only be used with correspond IP
V2.14 2020-01-08 GOLDEN F Developer Team region.
2.PG、LB - KENO、KY could provide
trial ( DEMO ) mode

Because SBO Bet records only use for

V2.15 2020-01-20 GOLDEN F Developer Team assisting when vendor betting, DO NOT use
for bet records.
Because AG Bet records only use for
V2.16 2020-02-14 GOLDEN F Developer Team assisting when vendor betting, DO NOT use
for bet records.
Updated currency code correspondence
V2.17 2020-02-25 GOLDEN F Developer Team
table ( Added Support device PC/H5 )
Added eBET live video, Updated currency
V2.18 2020-02-26 GOLDEN F Developer Team
basic unit is 1 for IDR、KRW、VND

1. Remove gf_cq9_fish balance and combine

V2.19 2020-02-26 GOLDEN F Developer Team to gf_main_balance
2. Added GMFX cards game

1. Currency IDR and VND is 1 : 1000

2. Updated 5.5. You have to divided by 1000
when player depositing balance.
V2.20 2020-03-31 GOLDEN F Developer Team 3. Updated 5.6. You have to multiple 1000
when player withdrawing balance.
4. Updated Currency and Language tables（
Ch.7 and Ch.8 )

1. Updated wallet code

2.Added trans_type cancelPayoff and
V2.21 2020-05-08 GOLDEN F Developer Team CancelStake
3.Removed 5.7.1 Parameter language

1.Added Vendor XJ sport

V2.22 2020-06-02 GOLDEN F Developer Team
2.Removed 5.7.2

p. 4
 1. Added Vendors:
(1). YB Yabo card game
V2.23 2020-08-20 GOLDEN F Developer Team (2). YB Yabo keno
(3). BVS Betradar sports
2. Renamed GFLC as GDQ card game

1. Added TFG esports、FastBet sports

V2.24 2020-10-14 Golden F Developer Team 2.Added transtype
3.Removed nickname

Added vendors:
V2.25 2020-11-06 Golden F Developer Team 1. YB Live
2. WM Live

1.Added vendors:
(1).King’s Poker
V2.26 2020-12-11 Golden F Developer Team (2).KA gaming

2.Added Vendor code list

Added Vendors:
1.KK Keno
V2.27 2021-01-07 Golden F Developer Team 2.ICG Gaming
3.OB Gaming
4.OB eSports

V2.28 2021-02-02 Golden F Developer Team Added 5.11 Get bet records

V2.29 2021-02-18 Golden F Developer Team Added vendor: JOKER Gaming

V2.30 2021-02-25 Golden F Developer Team Added 5.12 Get SBO bet record’s detail

V2.31 2021-03-08 Golden F Developer Team Added 5.13 Get transfer records

Added currency ARS

V2.32 2021-03-11 Golden F Developer Team
Fixed API supplement

Removed 5.7,5.7.1,5.8,5.9
Fixed 5.10,5.11,5.12 ‘s page_size to 5000
V2.33 2021-04-09 Golden F Developer Team
Fixed URL domain
Updated 4.2 API List

Added HKD
V2.34 2021-04-15 GoldenF Developer Team
Added GPSI

V2.35 2021-5-25 GoldenF Developer Team Add 5.9, 5.10, 5.12 supplement

V2.36 2021-08-02 GoldenF Developer Team Added PTTW、account length adjustment

V2.37 2021-08-27 GoldenF Developer Team Removed vendor: BTI

Add TRY
V2.38 2021-11-05 GoldenF Developer Team
Add language TR

v2.39 2021-11-15 GoldenF Developer Team Add SABA Sport

ICG Gaming is officially called AT Gaming

v2.40 2021-11-18 GoldenF Developer Team
(ASTRO TECH)

p. 5
 v2.41 2021-12-29 GoldenF Developer Team Add currency PHP

v.2.42 2022-01-20 GoldenF Developer Team Adjust 5.4 and 5.10 request frequency limit

v2.43 2022-01-20 GoldenF Developer Team Remove 5.4 and 5.10 request frequency limit

p. 6
2. Overview
This document details the integration of the transfer mode. The transfer mode means that the
player needs to transfer money from the central wallet of the operator system to the wallet of
GOLDEN F game system to play the game. The player needs to transfer the profit to the wallet
of the operator system wallet to withdraw the money.

3. How to Integration Game

GOLDEN F supports URL Scheme login authorization, and used the token parameter to authorize
login.

3.1. URL Scheme

After receiving the POST parameter “token” from operator, GOLDEN F will verified the IP is in
the operator whitelist, if IP is verified then API will return game_url.

❖ Operator’s server call for the GOLDEN F API is required to apply for an IP whitelist.
❖ API supports a variety of game products, but additional applications are required.

· Supplement
1. Restricted Area : US/TW

p. 7
4. Integration API

4.1. Interface Format and Description

All interfaces communicate through the HTTPS protocol, request parameters in the

form of Form, and JSON format to return the results.

(Default is HTTP , The HTTPS protocol API needs to be applied.)

The result is a fixed-format JSON. It has two keys: data and error. The key ‘error’ is the response
message of the API error. The key ‘error’ is JSON object contains two keys: code and message.
‘code’ is error code, ‘message’ is error description. If key ‘error’ value is null, the API will return the
data content normally. The key ‘data’ is output according to the specific function of the API. The
specific content is described in the API instructions.

● Return example of normal results：

{
"data": [{
"name": "test_member",
"transfer_amount": 1000,
"transaction_reference_id": 108,
"expired_time": 1512129600000
}],
"error": null
}

● Return results contain examples of errors：

{
"data": null,
"error": {
"code": "10.01",
"message": "Parameter body error."
}
}

· Supplement
1. The timestamp returned or submitted is always (UTC+0)

p. 8
4.2. API List

Guide to the use of all API

URL & HTTP Method Function Description

Create a player account to the game
Create player system. (usually an account is
POST API URL/Player/Create
account automatically created when the player
first enters the game)

POST API URL/Demo Try out the game

POST API URL/Launch Start the game

Query wallet Query the wallet balance of the

POST API URL/GetPlayerBalance
balance specified player

Deposit for a specified player's cash

POST API URL/TransferIn Player deposit
wallet.

Withdrawals for a specified player's

POST API URL/TransferOut Player withdrawal
cash wallet.

Get a single Get the transfer record of the specified

POST Record
player's transfer player through the player account, start
URL/Transaction/Record/Player/Get
record time, and end time.

Get all bet Get a bet record for all players through
POST Record URL/v3/Bet/Record/Get records(new) the betlog create time.

Get bet records Get a bet records details for SBO

POST Record URL/v3/SBO/Detail details for SBO through the betlog create time.

p. 9
4.3. Workflow

p. 10
5. API instructions
5.1. Create player account

Create a player account to the game system. (The account is usually created automatically when the
player first start the game)

· URL & HTTP Method

POST URL/Player/Create

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

player_name string Player account (Supplement 4)

currency string Currency. (Supplement 1)

· Return
{

"data": {

"msg": "player created"

"action_result": "Success

},

"error": null

· Possible error
· 1034 - Invalid Request
· 1204 - Invalid operator
· 9400 - System Is Under Maintenance
· 9401 - Incorrect player_name length
· 9412 - Not Allowed Currency
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

p. 11
· Supplement
1. The currency cannot be modified. Please refer to ‘Currency code correspondence table’ for
the code. If it is not filled, the default is CNY.
2. Players need to create an account before entering the game for the first time or before the
first transfer, but please do not need to create an account every time.
3. If the returned result ‘msg’ is ‘player created’, which means creating an account, and ‘player
duplicated‘ means duplicate account.
4. String rules: [case English], [number], [minus - ], [underline _ ], [point . ] can be used, the
number of words is recommended within 20 words, more than the number of words needs
special processing. Uppercase and lowercase can not consider the same and can not repeat.

p. 12
5.2. Game Demo

· URL & HTTP Method

POST URL/Demo

· Parameter
Parameter name Parameter type Description

secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

game_code string Game code

language string Game language (optional) (Supplement 1)

· Return
{
"data": {
"game_url": "string",
},
"error": {
"code": "string",
"message": "string"
}
}

· Possible error
· 3001 - Value cannot be null.
· 3004 - Player doesn't exist
· 3007 - This game doesn't exist
· 9400 - System Is Under Maintenance
· 9430 - this game has been BLOCKED by operator
· 9431 - This game doesn't exist
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

p. 13
· Supplement
1. Language please refer to ‘Language code correspondence table’ for the code. If it is not filled, the
default is simplified Chinese.
2. PG、LB - KENO、KY、eBET could provide trial ( DEMO ) mode, others could not.

p. 14
5.3. Launch Game

· URL & HTTP Method

POST URL/Launch

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

game_code string Game code

player_name string Player account

language string Game language (optional) (Supplement 1)

limit string limit (optional) MGPLUS Live、SBO only.

· Return
{
"data": {
"game_url": "string",
},
"error": {
"code": "string",
"message": "string"
}
}

p. 15
· Possible error
· 1035 - Operation Failed.
· 3001 - Value cannot be null.
· 1305 - Invalid player - Player is exist
· 3004 - Player doesn't exist
· 3007 - This game doesn't exist
· 3202 - No enough cash balance to bet.
· 9400 - System Is Under Maintenance
· 9430 - this game has been BLOCKED by operator
· 9432 - Platform need to be activated
· 9470 - Api service suspended
· 9471 - Transfer out service suspended
· 9472 - Transfer in service suspended
· 9473 - Payout bet service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

· Supplement
1. Language please refer to ‘Language code correspondence table’ for the code. If it is not filled, the
default is simplified Chinese.

p. 16
5.4. Query wallet balance

Query the wallet balance of the specified player.

· URL&HTTP Method
POST URL/GetPlayerBalance

· Parameter

Parameter name Parameter type Description

secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

player_name string Player account

Specify wallet code (optional)(Applicable to API after

version 2.04 )
wallet_code string ● Default: gf_main_balance
Please check”Wallet code correspondence table”

· Return
{
"data": {
"player_name": "string",
"currency": "string",
"balance": "double",
"wallet_code": "string"
},
"error": {
"code": "string",
"message": "string"
}
}

p. 17
· Possible error
· 3001 - Value cannot be null.
· 3004 - Player doesn't exist
· 9400 - System Is Under Maintenance
· 9423 - Operation Failed - Incorrect Wallet
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9492 - Operation Failed - IP Not Accessible

· Supplement
1. If the value of wallet_code is not given, the main wallet default is ‘gf_main_balance’.

p. 18
5.5. Deposit

Deposit an amount to the specified player’s cash wallet.

We strongly suggest you can refer to chapter "5.9 Get transfer record of a single player" after
deposit or withdrawal, which can make sure the transaction is valid or not in order to avoid losing the
amount.

IDR and VND is 1 : 1000，You have to divide by 1000 when depositing balance.

URL & HTTP Method

POST URL/TransferIn

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

player_name string Player account

amount double Transfer in amount

The docking platform provides transaction numbers.

traceId string
(optional) (used to track unique values)

Specify wallet code (optional) (Applicable to API after

version 2.04 )
wallet_code string
● Default: gf_main_balance
Please check”Wallet code correspondence table”

· Return
{
"data": {
"player_name": "string",
"currency": "string",
"balance": "double",
"balance_main": "double",
"traceId": "string",
"wallet_code": "string"
},
"error": {
"code": "string",
"message": "string"
}

p. 19
· Return parameter

Parameter name Parameter type Description

player_name string Player name

currency string Currency

balance double Post-trade account balance

balance_main double Post-trade account balance

traceId string Trace Id

wallet_code string Wallet code

· Possible error
· 1034 - Invalid request.
· 3004 - Player doesn't exist
· 9400 - System Is Under Maintenance
· 9413 - Player account suspended.
· 9421 - Operation Failed - Incorrect Amount
· 9423 - Operation Failed - Incorrect Wallet
· 9425 - Transfer Failed - Operating too frequently
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9491 - Operating too frequently
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

· Supplement
1. To ensure smooth communication between the two parties, please carry out high security risk
control protection on the client side, and does block abnormal frequent entry/exit and
unreasonable continuous taps.
2. If the value of wallet_code is not given, the main wallet default is ‘gf_main_balance’.
3. IDR and VND is 1 : 1000，You have to divided by 1000 when depositing balance .

p. 20
5.6. Withdrawal

Withdraw an amount to the specified player’s cash wallet.

We strongly suggest you can refer to chapter "5.9 Get transfer record of a single player" after
deposit or withdrawal, which can make sure the transaction is valid or not in order to avoid losing
amount.

IDR and VND is 1 : 1000，You have to multiple 1000 when withdrawing balance.

· URL & HTTP Method

POST URL/TransferOut

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

player_name string Player account

amount double Transfer in amount

The API provides transaction number.(optional)

traceId string
(used to track unique values)

Specify wallet code (optional)

(Applicable to API after version 2.04 )
wallet_code string
● Default: gf_main_balance
Please check”Wallet code correspondence table”

· Return
{
"data": {
"player_name": "string",
"currency": "string",
"balance": "double",
"balance_main": "double",
"traceId": "string",
"wallet_code": "string"
},
"error": {
"code": "string",
"message": "string"
}

p. 21
· Return parameter

Parameter name Parameter type Description

player_name string Player name

currency string Currency

balance double Post-trade account balance

balance_main double Post-trade account balance

traceId string Trace id

wallet_code string Wallet code

· Possible error
· 1034 - Invalid request.
· 3004 - Player doesn't exist
· 3013 - Out of the balance amount to transfer out.
· 9400 - System Is Under Maintenance
· 9413 - Player account suspended.
· 9421 - Operation Failed - Incorrect Amount
· 9423 - Operation Failed - Incorrect Wallet
· 9425 - Transfer Failed - Operating too frequently
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9471 - Transfer out service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9491 - Operating too frequently
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

· Supplement
1. To ensure smooth communication between the two parties, please carry out high security risk
control protection on the client side, and does block abnormal frequent entry/exit and unreasonable
continuous taps.
2. If the value of wallet_code is not given, the main wallet default is ‘gf_main_balance’.
3. IDR and VND is 1 : 1000，You have to multiple 1000 when withdrawing balance.

p. 22
5.9. Get transfer record of a single player

Get the transfer record of a single player through the player account, start time, and end time.

· URL & HTTP Method

POST URL/Transaction/Record/Player/Get

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

player_name string Player name

traceId string Transaction number (optional) (Supplement 1)

start_time long integer Start time, 13-digit timestamp format

end_time long integer End time, 13-digit timestamp format

Specify wallet code (optional)

wallet_code string ● Deault: show all
Please check” Wallet code correspondence table”

Specify return timestamp format (optional)

● Default: 13
timestamp_digit integer
● 10 = 10-digit timestamp format
● 13 = 13-digit timestamp format

p. 23
 · Return
{

"data": {

"action_result": "Success",

"translogs": [

"player_name": "string",

"amount": "double",

"currency": "string",

"balance": "double",

"before_balance": "double",

"type": "string",

"created_at": "timestamp",

"traceId": "string",

"wallet_code": "string"

},

"player_name": "string",

"amount": "double",

"currency":"string",

"balance": "double",

"before_balance": "double",

"type": "string",

"created_at": "timestamp",

"traceId": "string",

"wallet_code": "string"

],

"last_record_time": "timestamp",

"count": "int"

},

"error": null

p. 24
· Return parameter

Parameter name Parameter type Description

player_name string Player name

amount double Amount of the transaction

currency string Currency

balance double Post-trade account balance

before_balance double Pre-trade account balance

transferIn
transferOut
Stake Stack
Payoff Payoff
cancelStake cancel this stake
cancelPayoff cancel payoff
payoutBet Make up stake/payoff/bad debt
(Supplement 4)
type string
entergame Enter specify or withholding wallet
(Supplement 7)
exitgame Leave specify or withholding wallet
(Supplement 7)
gameTransferIn Enter specify or withholding wallet
(Supplement 7) ）
gameTransferOut Leave specify or withholding wallet
(Supplement 7)

created_at integer Date of establishment (Supplement 3)

Transaction ID and transaction identification parameters

traceId string The length of the traceId is not fixed and cannot exceed
255 characters.

last_record_time integer Timestamp of the last record

count integer Return the number of records

wallet_code string Wallet code

· Possible error
· 3001 - Value cannot be null.
· 9400 - System Is Under Maintenance
· 9402 - Data not exists
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameter
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

p. 25
· Supplement
1. Start time and end time are ignored when querying with traceId.
2. ‘payoutBet’ is mainly used to make up payout or stake or bad debts... and other categories or
special purposes.
3. When the “post-trade balance” is rounded, only the second decimal place is retained, and the
subsequent decimal places are unconditionally rounded off (such as 0.01), and the system will
reset the account balance to zero.
4. Timestamp (UTC +0) format. The precision is increased to milliseconds, totally 13 digits. The
‘timestamp_digit’ can be changed to 10-digit format. If you need to convert to date format
output, please refer to the demo below.

date(‘Y-m-d H:i:s’,1530686183995/1000); //Output: 2018-07-04 06:36:23

5. If row_version has multiple identical timestamps, the system will skip count and return the same
timestamp record once to ensure data integrity. ex: Submit 100 records count and if the last
record’s timestamps is the same as the other 2 records outside the 100 records. The API
returns will return 102 records.
6. If the value of wallet_code is not given, the main wallet default is show all.
7. Some products will transfer the wallet's money into the game when entering the game, and will
transfer the balance when leaving or ending the game; such as KY Kaiyuan game, CQ9 table
games, AG fish game, XJ Xiaojin sports, GOLDEN F card game...etc.
8. Some products' transfer records only can get ‘stake’, such as WM Live. If you need ‘payoff’ records,
please use 5.10 to get all records.
9. Start time to End time can not be longer than 5 minutes.

p. 26
5.10. Get bet records (New)

● URL & HTTP Method

POST URL/v3/Bet/Record/Get

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

Specify product code

vendor_code string Please check” Vendors code correspondence table”

start_time timestamp Start time, 13-digit timestamp format (supplement 1)

End time, 13-digit timestamp format

end_time timestamp
(supplement 1) (supplement 2)

page integer Page

page_size integer records for one page （supplement 3)

p. 27
 ● Return
{

"data" : {

"action_result": "Success",

"betlogs" : [

"player_name" : "string",

"parent_bet_id" : "string",

"bet_id" : "string",

"trans_type" : "string",

"game_code" : "string",

"currency" : "string",

"bet_amount" : "double",

"win_amount" : "double",

"vendor_code" : "string",

"wallet_code" : "string",

"created_at" : "timestamp",

"traceId" : "string"

],

"total" : "integer",

"start_time" : "timestamp",

"end_time" : "timestamp",

"page" : "integer",

"page_count" : "integer"

},

"error" : {

"code" : "string",

"message" : "string"

p. 28
· Return parameter

Parameter name Parameter type Description

player_name string Player name

parent_bet_id string Parent bet id

bet_id string Bet id

Stake
Payoff
trans_type string
cancelStake
cancelPayoff

game_code string Game code

currency string Currency

bet_amount double Bet amount

win_amount double Payout or refund amount

vendor_code string Please check” Vendors code correspondence table”

wallet_code string Please check” Wallet code correspondence table”

trans_type: Stake (stake time)

trans_type: Payoff (settlement time)
created_at timestamp
trans_type: cancelStake (settlement time)
trans_type: cancelPayoff (cancel time)

Transaction ID and transaction identification parameters

traceId string The length of the traceId is not fixed and cannot exceed
255 characters.

total integer all records

start_time timestamp Start time, 13-digit timestamp format

end_time timestamp End time, 13-digit timestamp format

page integer Page

page_count integer total pages

code string Please check”Error code correspondence table”

message string Please check”Error code correspondence table”

p. 29
· Supplement
1. Start time to End time can not be longer than 5 minutes.
2. end_time should be 30 seconds earlier than current time.
ex:
If the time is 2021/03/09 18:00:00 (UTC+8)
timestamp: 1615284000000 (UTC+0)
1615284000000 - 30000 (30 seconds) = 1615283970000，
Therefore, the end_time should be = 1615283970000 (or earlier than it.)
3. The range of page_size is 1000 to 5000.
4. The setting of star_time and end_time is based on bet_time. Please change your
start_time and end_time if you don’t get any bet records .(bet records：3 - 5 mintues after
staking. )
5. The bet record only kept for 2 months.
6. Get all record:
Please use parent_bet_id to get all records, using trace_id as unique to filter repeated stake
records.
Different players’ accounts have the same parent_bet_id is normal behavior , players might be
playing in the same round. Besides this situation, the same player account can have repeated
bet_id, according to the game mechanics, the status will change.

p. 30
5.11. Get SBO bet records details (New)

NOTICE: Because Bet records only use for assisting when vendor betting

＊＊＊ DO NOT USE FOR BET RECORDS ＊＊＊

Golden F would not guarantee any results if you insist on using for bet records.

· URL & HTTP Method

POST URL/v3/SBO/Detail

· Parameter

Parameter name Parameter type Description

secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

start_time timestamp Start time, 13-digit timestamp format (supplement 1)

End time, 13-digit timestamp format

end_time timestamp
(supplement 1) (supplement 2)

page integer Page

page_size integer records for one page （supplement 3)

p. 31
· Return
{
"data": {
"action_result": "Success",
"betlogs": [
{
"subBet": [
{
"betOption": "string",
"marketType": "string",
"hdp": "double",
"odds": "double",
"league": "string",
"match": "string",
"status": "string",
"winlostDate": "DateTime(UTC-4)",
"liveScore": "string",
"htScore": "string",
"ftScore": "string",
"customeizedBetType": "string",
"isHalfWonLose": boolean,
"isLive": boolean
}
],
“bet_id”: "string",
“player_name": "string",
"sportType": "string",
"orderTime": "DateTime(UTC-4)",
"winlostDate": "DateTime(UTC-4)",
"modifyDate": "DateTime(UTC-4)",
"odds": "double",
"oddsStyle": "string",
"stake": "double",
"actualStake": "double",
"currency": "string",
"status": "string",
"winlose": "double",

p. 32
 "turnover": "double",
"isHalfWonLose": boolean,
"isLive": boolean,
"MaxWinWithoutActualStake": "double",
"Ip": "string",
“modify_at": timestamp
}
],
"total" : "integer",

"start_time" : "timestamp",

"end_time" : "timestamp",

"page" : "integer",

"page_count" : "integer"

},
"error": {
"code": "string",
"message": "string"
}
}

p. 33
· Return parameter

Parameter name Parameter type Description

betOption String Option that player selected in this bet

marketType String MarketType of the bet

hdp Double Hdp of the bet

odds Double Odds of the bet

league String Name of league of the match

match String Name of match

Bet's status

cancelled
If an event is cancelled for any reason prior to its
commencement, all bets placed for that event will be void and
will be returned at odds of 1.00.
draw
Event ends in a draw result.
lose
Bet is lost and the loss amount is deducted from your account.
refund
Refunded bets are those which in case to case basis are
returned.
running
Live bet has been accepted and winner will be determined at
the conclusion of the event.
void
Void bets can occur in a number of situations, where bets will
status String not count, based on the applicable rule. When your bet is
declared void, your original stake will be returned.
waiting
Live bet is being processed but has yet to be accepted.
waiting rejected
Player place bet on a live odds and trader reject the bet due to
many possible reasons, e.g. ball around the gate, corner is
given, free kick...etc.s
won
Bet is won and payout will be credited into your account.
done
When your sub bets of MixParlay being refund, it will show
'Done'.
half won
When bet is half Won, the half amount will refund. The rest will
be won, and the payout be credited into your account.
half lose
When bet is half Lose, the half amount will refund, and the rest
will be lose and deducted from your account.

WinLostDate of the bet (The format is Date please ignored the

winLostDate DateTime
time part "00:00:00")

p. 34
 If the match is a live match, this field will record the score at the
livescore String
moment when player placed bet

htScore String Half time score of the match

ftScore String Full time score of the match

customeizedBetTyp Name of Bet Group which player placed bet on. Eg. Total
String
e Corner,...

isHalfWonLose Boolean Is the status Half Won or Half Lose

isLive Boolean Is the bet placed on a live match

bet_id String Reference number of the bet.

player_name String player name who placed the bet

sportType String Sport type of the bet

orderTime DateTime Time of bet being placed

WinLostDate of the bet (The format is Date please ignored the

winlostDate DateTime
time part "00:00:00")

modifyDate DateTime The bet modify time(GMT-4)

odds Double The odds of current bet

OddsStyle of the odds

M = Malay odds
oddsStyle String
E = Euro odds
H = HongKong odds
I = Indonesia odds

stake Double The stake of the player

actualStake Double The actualStake of the player

currency String Player’s currency.

status String Bet's status

Player winlose of the bet. The return amount included actual

winlose Double
stake of player placed

turnover Double Player's turnover of this bet

isHalfWonLose Boolean Is the status Half Won or Half Lose

isLive Boolean Is the bet placed on a live match

When the bet is not settled yet it will be the max Winlost without
MaxWinWithoutAct
Double ActualStake , and it will be null when bet is been settle .It will be
ualStake
the Estimated max winlost without Actual Stake

Ip String

modify_date Timestamp bet modify time

p. 35
p. 36
· Supplement
1. Start time to End time can not be longer than 15 minutes.
2. end_time should be 30 seconds earlier than current time.
ex:
If the time is 2021/03/09 18:00:00 (UTC+8)
timestamp: 1615284000000 (UTC+0)
1615284000000 - 30000 (30 seconds) = 1615283970000，
therefore, the end_time should be = 1615283970000 (or earlier than it.)
3. The range of page_size is 1000 to 5000.
4. The setting of star_time and end_time is based on bet_time. Please change your
start_time and end_time if you don’t get any bet records .(bet records：3 - 5 mintues after
staking. )
5. The bet record only kept for 2 months.

p. 37
5.12. Get transfer records (New)

Get all the player's wallet transfer records with the last updated tag.

· URL & HTTP Method

POST URL/v3/Transaction/Get

· Parameter
Parameter name Parameter type Description
secret_key string Provided by GOLDEN F

operator_token string Provided by GOLDEN F

start_time timestamp Start time, 13-digit timestamp format (supplement 1)

End time, 13-digit timestamp format

end_time timestamp
(supplement 1) (supplement 2)

page integer Page

page_size integer records for one page （supplement 3)

p. 38
 ● Return
{

"data": {

"action_result": "Success",

"betlogs": [

"player_name": "string",

"currency": "string",

"before_balance": "double",

"amount": "double",

"balance": "double",

"type": "string",

"traceId": "string",

"created_at": "timestamp"

],

"total": "integer",

"start_time": "timestamp",

"end_time": "timestamp",

"page": "integer",

"page_count": "integer"

},

"error": {

"code": "string",

"message": "string"

p. 39
· Return parameter

Parameter name Parameter type Description

player_name string Player name

currency string Currency

before_balance double Pre-trade account balance

amount double Amount of the transaction

balance double Post-trade account balance

transferIn
transferOut
Stake Stack
Payoff Payoff
cancelStake cancel this stake
cancelPayoff cancel payoff
payoutBet Make up stake/payoff/bad debt
(Supplement 5)
type string
entergame Enter specify or withholding wallet
(Supplement 6)
exitgame Leave specify or withholding wallet
(Supplement 6)
gameTransferIn Enter specify or withholding wallet
(Supplement 6)
gameTransferOut Leave specify or withholding wallet
(Supplement 6)

Transaction ID and transaction identification parameters

traceId string The length of the traceId is not fixed and cannot exceed
255 characters.

created_at integer Date of establishment

total integer all records

start_time timestamp Start time, 13-digit timestamp format

end_time timestamp End time, 13-digit timestamp format

page integer Page

page_count integer total pages

code string Please check”Error code correspondence table”

message string Please check”Error code correspondence table”

p. 40
· Possible error
· 3001 - Value cannot be null.
· 9400 - System Is Under Maintenance
· 9402 - Data not exists
· 9430 - this game has been BLOCKED by operator
· 9470 - Api service suspended
· 9474 - Operation Failed
· 9475 - invalid parameters
· 9492 - Operation Failed - IP Not Accessible
· 9493 - Operation Failed - Illegal Characters

· Supplement
1. Start time to End time can not be longer than 5 minutes.
2. end_time should be 30 seconds earlier than current time.
ex:
If the time is 2021/03/09 18:00:00 (UTC+8)
timestamp: 1615284000000 (UTC+0)
1615284000000 - 30000 (30 seconds) = 1615283970000，
therefore, the end_time should be = 1615283970000 (or earlier than it.)
3. The range of page_size is 1000 to 5000.
4. The setting of star_time and end_time is based on bet_time. Please change your
start_time and end_time if you don’t get any bet records .(bet records：3 - 5 mintues after
staking. )
5. The bet record only kept for 2 months.
6. ‘payoutBet’ is mainly used to make up payout or stake or bad debts... and other categories or
special purposes.
7. Some products will transfer the wallet's money into the game when entering the game, and will
transfer the balance when leaving or ending the game; such as KY Kaiyuan card game, CQ9 table
games, AG fish game, XJ Xiaojin sports, GOLDEN F card game...etc.
8. Some products' transfer records only can get ‘stake’, such as WM Live. If you need ‘payoff’ records,
please use 5.10 to get all records.

p. 41
 6. Error code correspondence table
Code Description Description(cn)

1034 Invalid request. 请求无效

1035 Operation Failed 操作失败

1200 Internal server error. 内部伺服器错误

1204 Invalid operator 运算无效

3001 Value cannot be null. 数值不可为空值

3004 Player doesn’t exist 玩家不存在

3005 Player wallet doesn’t exist 玩家钱包不存在

3006 Player wallet already exists. 玩家钱包已存在

3009 Free game doesn’t exist 免费游戏不存在

3013 Out of the balance amount to transfer out. 余额不足, 无法转出

3014 Free games cannot be cancelled. 免费游戏无法被取消

3019 No enough free game 免费游戏不足

3021 No bet exists 没有任何赌注存在

3022 Bet already payout 赌注已支付完成

3030 Free game expired 免费游戏已过期

3031 Free game already converted 免费游戏已兑换

3032 Bet already existed 赌注已存在

3033 Bet failed 赌注失败

3034 Payout failed 支付失败

3035 Invalid multiplier 倍数不存在

3036 Not enough balance to convert. 余额不足, 无法兑换

3202 Not enough cash balance to bet. 现金余额不足, 无法进行下注

9400 System Is Under Maintenance 系统维护中

9411 Invalid Player - Player is exist 玩家已存在

9412 Not Allowed Currency 不允许的货币

9421 Operation Failed - Incorrect Amount 操作失败 - 金额有误

9422 Operation Failed - Traceid Duplicated 操作失败 - Traceid重复

9423 Operation Failed - Incorrect Wallet 操作失败 - 钱包有误

9431 This Game Doesn’t Exist 游戏不存在

9470 API Service Suspended 接口服务暂停使用

p. 42
 9471 Transfer Out Service Suspended 转出服务暂停使用

9472 Transfer In Service Suspended 转入服务暂停使用

9473 Stake Service Suspended 下注服务暂停使用

9474 Operation Failed - Verification Error 接口验证错误

9475 invalid parameters POST参数错误

9481 Product Is Under Maintenance 产品维护中

9487 Product Is Decommissioning 产品终止营运

9491 Operating Too Frequently 操作过于频繁

9492 Operation Failed - IP Not Accessible 操作失败 - 禁止IP访问

9493 Operation Failed - Illegal Characters 操作失败 - 禁止非法字符

p. 43
 7. Vendors code correspondence table

Product Name vendor_code

PG Gaming PG

LB-KENO LBKENO

AG Live AG

eBET Live EBET

AG Fish AGFISH

AG Gaming AGSLOT

KY card game KY

CQ9 Gaming CQ9

SBO sport SBO

GMFX card game GMFX

IA eSport IA

MGPLUS Live/Gaming MGPLUS

Gioco Plus GPS

Gioco Plus seamless GPSSL

GDQ card gmae GDQ

XJ sport XJ

OB KENO YBKENO

OB card game YBCARD

BVS sport BVS

TFG eSport TFG

WM Live WMLIVE

OB Live YBLIVE

KA Gaming KA

King’s Poker KP

AT Gaming ICG

OB Gaming OBSLOT

OB eSport OBESPORT

p. 44
 JOKER Gaming JOKER

GPS Slot 1 GPSI

SABA Sport SABASPORT

p. 45
 8. Currency code correspondence table
Currency
Currency Base Unit Support Product
code
PG、CQ9、KY、AG、LBKENO、XJ、AGSLOT、SBO、IA、
GMFX、GDQ、MGPLUS、TFG、EBET、GPS、YBKENO、
CNY RMB 1:1 YBCARD、BVS、YBLIVE、WMLIVE、GPSSL、KA、ICG、
OBSLOT、OBESPORT、JOKER、OBSPORTS、GPSI、
OBFISH、SABASPORT

PG、CQ9、KY、AG、LBKENO、XJ、AGSLOT、SBO、IA、
USD US Dollar 1:1 GMFX、TFG、EBET、GPS、BVS、GPSSL、KA、ICG、
JOKER、OBSPORTS、GPSI

IDR PG、CQ9、KY、AG、AGSLOT、SBO、IA、GMFX、TFG、
Indonesian rupee 1:1000
EBET、GPS、BVS、GPSSL、ICG、JOKER、GPSI

PG、CQ9、KY、AG、LBKENO、AGSLOT、SBO、IA、GMFX
THB Baht 1:1 、TFG、EBET、GPS、BVS、GPSSL、KP、KA、ICG、JOKER
、GPSI

VND PG、AG、LBKENO、AGSLOT、SBO、IA、TFG、EBET、GPS
Vietnamese dong 1:1000
、BVS、GPSSL、KP、ICG、OBSPORTS、GPSI

MYR Malaysian Ringgit AG、AGSLOT、SBO、IA、TFG、EBET、GPS、BVS、GPSSL

1:1
、KA、ICG、JOKER、GPSI

KRW PG、AG、AGSLOT、SBO、IA、TFG、GPS、BVS、GPSSL、
South Korean Won 1:1
KA、ICG、JOKER、GPSI

EUR Euro PG、AG、AGSLOT、eBET、GPS、BETRADAR、WMLIVE、

1:1
KA、ICG、JOKER、OBSPORTS、GPSI

JPY PG、AG、AGSLOT、SBO、IA、GPS、BVS、GPSSL、KA、
Japanese Yen 1:1
ICG、GPSI
MXN Peso mexicano 1:1 PG、GPS、BVS、GBSSL、EBET、GPSI、KA、ICG

PEN Nuevo Sol 1:1 PG、GPS、BVS、KA、EBET、ICG、GPSI

IA、GPS、GPSSL、KA、ICG、JOKER、OBESPORTS、GPSI
SGD Singapore Dollar 1:1
、WMLIVE、BVS、TFG

COP Peso Colombiano 1:1 GPS、BVS、GPSSL、KA、ICG、GPSI

ARS Argentine Peso 1:1 PG、KA、BVS、GPS、GPSSL

Myanma Ky PG、SBO、GPS、GPSSL、JOKER、GPSI、KA、ICG、
MMK 1:1
at WMLIVE、EBET、IA、BVS

HKD Hong Kong Dollar 1:1 SBO、WMLIVE、KA、IA、TFG、BVS、GPS、GPSSL

TRY Turkish Lira 1:1 PG

PHP Piso 1:1 ICG、GPSI、KA

p. 46
· Supplement
1. At present, only one currency is allowed on the same line. If you want different currencies, you
need to apply for another route (different token & key).
2. Support currency for SBO only be used with correspond IP region （ex: IDR only used with IP in
Indonesia ）
3. Support currency for JOKER only be used with corresponding IP regions. For details please
contact the service.
4. CNY are supported for all CQ9 games, others are different according to each game. For details
please contact the service.

p. 47
 9. Language code correspondence table

Language code Language Support Product ( PC and H5 )

LBKENO、AG、AGFISh、AGSLOT、eBET、KY、GPS、SBO、IA、TFG、
en-US English PG、MGPLUS、XJ、BETRADAR、WMLIVE、KP、KA、ICG、GPSI、
GPSSL、SABASPORT

LBKENO、AG、AGFISh、AGSLOT、eBET、KY、GDQ、GMFX、GPS、
Chinese SBO、IA、TFG、PG、CQ9、MGPLUS、XJ、OBKENO、OBCARD、
zh-CN BETRADAR、OBLIVE、WMLIVE、KP、KA、ICG、OBSLOT、GPSI、
Simplified
GPSSL、SABASPORT

AG、AGFISH、AGSLOT、eBET、SBO、IA、TFG、XJ、BETRADAR、
ID Indonesian WMLIVE、KP、ICG、GPSI、SABASPORT

AG、AGFISH、AGSLOT、eBET、SBO、IA、TFG、XJ、BETRADAR、
TH Thai WMLIVE、KP、KA、ICG、GPSI、SABASPORT

AG、AGFISH、AGSLOT、eBET、SBO、IA、TFG、XJ、BETRADAR、
VI Vietnamese WMLIVE、KP、ICG、GPSI
LBKENO（Only PC）

JA Japanese AG、AGFISH、AG SLOT、eBET、SBO、IA、TFG、XJ、WMLIVE

AG、AGFISH、AGSLOT、eBET、SBO、IA、TFG、XJ、BETRADAR、
KO Korean WMLIVE

ES Spanish eBET、GPS、SBO、TFG、BETRADAR、WMLIVE、GPSSL

MY Malaysia SBO、KP

TR Turkish PG

· Supplement
1. If the game does not support the language, it will automatically switch to the default English or
Chinese.
2. PG、CQ9、BVS and MGPLUS are supported to all games with zh-CN, others are different
according to each game. For details please contact the service.
3. LBKENO with VI only supports PCs.
4. JOKER is different according to each game. For details please contact the service.

p. 48
 10. Wallet code correspondence table
vendor_code wallet_code Product name Remark
PG gf_main_balance PG slot game Single API, shared wallet (default wallet)
LBKENO gf_main_balance LB-KENO lottery Single API, shared wallet (default wallet)
AG gf_main_balance AG live video Single API, shared wallet (default wallet)
eBET gf_main_balance eBET live video Single API, shared wallet (default wallet)

AGFISH gf_ag_fish AG fish game Single API, specify wallet (Applicable to API
after version 2.04 )

AGSLOT gf_main_balance AG slot game Single API, shared wallet (default wallet)

KY gf_ky_card Single API, specify wallet (Applicable to API

KY Kaiyuan game
after version 2.04 )

CQ9 gf_main_balance CQ9 slot game Single API, shared wallet (default wallet)

SBO gf_sport_wallet Single API, specify wallet (Applicable to API

SBO sport
after version 2.04 )

GMFX gf_gmfx_card Single API, specify wallet (Applicable to API

GMFX card game
after version 2.04 )

IA gf_ia_esport Single API, specify wallet (Applicable to API

IA sports
after version 2.04 )

MGPLUS gf_mgplus_wallet MGPLUS Single API, specify wallet (Applicable to API

Video/Slot game after version 2.04 )

GDQ gf_gdq_card Single API, specify wallet (Applicable to API

GDQ card game
after version 2.04 )

GPS gf_gps_wallet Single API, specify wallet (Applicable to API

Gioco Plus
after version 2.04 )

YBKENO gf_ybkeno_wallet OB keno Single API, specify wallet (Applicable to API

after version 2.04 )

YBCARD gf_ybcard_card OB card game Single API, specify wallet (Applicable to API
after version 2.04 )

BVS gf_bvs_sports Betradar sports Single API, specify wallet (Applicable to API
after version 2.04 )

TFG gf_tfg_esport TFG esports Single API, specify wallet (Applicable to API
after version 2.04 )

WMLIVE gf_wmlive_wallet WM Live Single API, specify wallet (Applicable to API

after version 2.04 )

YBLIVE gf_yblive_wallet OB Live Single API, specify wallet (Applicable to API

after version 2.04 )

p. 49
 KA gf_ka_wallet KA gaming Single API, specify wallet (Applicable to API
after version 2.04 )

KP gf_kp_card King’s Poker Single API, specify wallet (Applicable to API

after version 2.04 )

ICG gf_icg_wallet AT Gaming Single API, specify wallet (Applicable to API

after version 2.04 )

OBSLOT gf_obslot_wallet OB Gaming Single API, specify wallet (Applicable to API

after version 2.04 )

OBESPORT gf_obesport_wallet OB esports Single API, specify wallet (Applicable to API

after version 2.04 )

JOKER gf_joker_wallet JOKER Gaming Single API, specify wallet (Applicable to API
after version 2.04 )

GPSI gf_gpsi_wallet GPS Slot 1 Single API, specify wallet (Applicable to API
after version 2.04 )
Gioco Plus Single API, specify wallet (Applicable to API
GPSSL gf_gpssl_wallet
Seamless after version 2.04 )

PTTW gf_pttw_wallet PT (Playtech) Single API, specify wallet (Applicable to API

after version 2.04 )

SABASPORT gf_sabasport_wallet SABA Sport Single API, specify wallet (Applicable to API
after version 2.04 )

p. 50
 11. Game code correspondence table

Please refer to the latest GOLDEN F Game List

p. 51