DCE

DCS APIDCS Seamless wallet API document

Version Date Description
1.01 2022-06-30 DCS API document created
1.01 2022-07-17 Adjustment: 2.8 FreeSpin Campaign Player Setup 4.1 DCS API Response Code 4.5 Wager_type
1.02 2022-08-08 Adjustment: 2.1 Login Game, brand_uid String(32) => String(20)
1.10 2022-08-15 Add Special Remarks in: 3.2 Wager 3.3 CancelWager 3.4 AppendWager 3.5 EndWager 3.6 FreeSpinResult Adjustment: 4.1 DCS API Response Code
1.11 2022-08-30 Add Special Remarks in: 3.3 CancelWager Response code
1.12 2022-09-19 Add providers in 4.6 Provider code nlc – Nolimit City png – Play’n Go hs – Hacksaw
1.13 2022-09-29 Adjustment: 3.Brand API endpoints implementation, Response code String(7) => Int
1.14 2022-10-13 Add VES, SSP in 4.2 Currency code List Add providers in 4.6 Provider code: aux - Avatarux
1.15 2022-10-31 Add 5042 to Special Remarks in 3.5 EndWager Change “campaign” description in 4.5 wager_type
1.16 2022-11-09 Add cancelEndWager, promopayout in 4.5 Wager_type Add wager_type property in 3.3 cancelWager, Add bet_type property in 3.2 Wager
Add tip, game_result property in 2.3 Response Add providers in 4.6 Provider code evo - Evo Play gam - Solid/Gamomat ghg - Solid/Golden Hero psn - Solid/Push ezugi - Ezugi swf - Solid/WinFast ft -FunTa Add 3.8 promoPayout Method Adjustment: 2.3 Report Request restriction
1.17 2022-11-29
  1. Delete 2.6 Get Jackpot Information Method 1.1 previous version function no. 2.7 function no. change to 2.6 1.2 previous version function no. 2.8 function no. change to 2.7 1.3 previous version function no. 2.9 function no. change to 2.8
  2. Add currency property in 3.3 cancelWager
1.2 2022-12-27 Brand API endpoints implementation: Adjust 3.2 Wager, 3.3 CancelWager, 3.4 AppendWager, 3.5EndWager, 3.6FreeSpinResult, adding "is_endround" property
1.21 2023-02-03
  1. Adjust 8.3 PromoPayout Sign rule
  • Adjust 3.2 Wager Special Remarks
    • 1.22 2023-04-30 4.1 DCS API Response Code add 5019, 5020 4.6 Provider Code Edit ft To funta Adjustment: 2.1 Login game -> token description Add game_result property in 3.5 Endwager request Add Special remarks in 3.8 promoPayout Adjustment: amount, balance Type Decimal(16,2) into Decimal(16,6)
    1.23 2023-06-06 Adjustment: 2.4 Game Replay description 4.1 DCS API Response Code add 5021, 5023, 5024
    1.24 2023-07-14 Adjustment: 4.1 DCS API Response Code 5009, 5013 description Add providers in 4.6 Provider code mj - 7Mojos fm - Fantasma ps - Peter & Sons
    1.25 2023-10-16 Add providers in 4.6 Provider code sb - Sprike plb - Parlay bay 2.3 Report add "is_endround" parameter in response
    1.26 2024-01-10 Remove currency: uBTC, UBC Add provider in 4.6 Provider Code: ev1-Evolution btg - Big Time Gaming ne - NetEnt rt - Red Tiger dcace - DCACE tg/ptgo - Turbo Games wz - Wazdan Add content property in 2.5 Get Game List response Add freespin_id, freespin_description in 3.6 FreeSpinResult request
    1.27 2024-04-22 Add provider in 4.6 Provider Code: tk - Thunderkick
    1.30 2024-5-29 Add provider in 4.6 Provider Code: lm - Lucky Monaco yt - Yolted
    1.31 2024-7-31 Add provider in 4.6 Provider Code: sa - SA gaming ss - Smartsoft bg -Bgaming
    1.32 2024-08-28
    1. Add provider in 4.6 Provider Code: nm - Novomatic op - Octoplay bp - BluePrint
    2. 3.8 PromoPayout Special Remarks adjustment
    1.33 2024-10-30
    1. Add provider in 4.6 Provider Code: hsp - Hacksaw Gaming ROW hs1 - Hacksaw Gaming Latam
  • 4.1 DCS API Response Code add 5025
  • 4.6 Provider description revision: Wazdan => Voltent (Wazdan)
    • 1.34 2025-2-25
    1. Add provider in 3.6 Provider Code: 1.1 tq - Tequity 1.2 raw - RAW
    2. Remove provider in 3.6 Provider Code: 2.1 ghg - Golden Hero
    1.35 2025-03-18 The following method adds an attribute parameter transaction_time VARCHAR(20). 3.2 Wager 3.3 CancelWager 3.4 AppendWager 3.5 EndWager 3.6 FreeSpinResult 3.8 PromoPayout
    1.36 2025-03-28 Adjust the following method attribute parameter transaction_time description 3.2 Wager 3.3 CancelWager 3.4 AppendWager 3.5 EndWager 3.6 FreeSpinResult 3.8 PromoPayout

    Table of content

    1. API information and path. 8

    2. DCS endpoint. 82.1 Login Game. 9Request. 9Response. 102.2 Try Game. 10Request. 10Response. 102.3 Report. 11Request restriction. 11Request. 11Response. 11Response information. 122.4 Game Replay. 13Request. 13Response. 13Response information. 132.5 Get Game List. 15Request. 15Response. 152.6 FreeSpin Campaign Setup. 16Request. 16Response. 16Response information. 162.7 FreeSpin Campaign Player Setup. 17Request. 17Response. 172.8 FreeSpin Campaign Query. 18Request. 18Response. 18Response information. 193. Brand API endpoints implementation. 203.1 Login Authentication. 21Request. 21

    Response 21

    3.2 Wager 23

    Request 23 Response 24 Special Remarks 24

    3.3 CancelWager 25

    Request 25 Response 25 Special Remarks 26

    3.4 AppendWager 27

    Request 27 Response 27 Special Remarks 28

    3.5 EndWager 29

    Request 29 Response 29 Special Remarks 30

    3.6 FreeSpinResult 31

    Request 31 Response 32 Special Remarks 32

    3.7 GetBalance 33

    Request 33 Response 33

    3.8 PromoPayout 34

    Request 34 Response 35

    1. Appendix 36

    2. Appendix 364.1 DCS API Response Code 364.2 Currency code List 384.3 Language code list 424.4 Country_code 444.5 Wager_type 444.6 Provider List 45

    DCS API Description

    1. API information and path

    Name Description
    api_url API URL, DC provides to the Operator
    getBetData_url Get bet detail URL, DC provides to the Operator
    api_key Key used for endpoint validation, DC provides to the Operator
    brand_id Brand ID, DC provides to the Operator
    brandApi_url Brand api url, DC provides to the Operator

    2. DCS endpoint

    Request parameter “sign” is MD5 encrypted containing request info parameters + api_key. When operator calls endpoint, the request info parameters will be different and required. api_key is provided by DC. Additionally, please refer to Appendix 3. for parameters including currency, country, and language.

    Endpoint request method and content type :

    Method Content Type
    POST application/json

    Endpoint request common parameters :

    Name Required Type Description
    brand_id Yes string(7) Brand ID
    sign Yes String(32) MD5 encryption and transform into CAPITAL Encrypted detail will describe in each endpoint Do not put “+” sign when concatenating messages

    Endpoint response common parameters :

    Name Required Type Description
    code Yes Int Refer to DCS API Response code, check Appendix 4.1
    msg Yes String(50) Messages

    2.1 Login Game

    Login Game method allows players to log into the games. Operator receives launch url with game_url for the game.

    Request

    EndPoint : {api_url}/dcs/loginGame

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) Sign = MD5(brand_id+brand_uid+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    token Yes String(32) Operator provides token for player to launch the games, DC api will request token verification to operator wallet api (Please check login endpoint 3.1), recommend using GUID (or any other unique identifier) to renew token when player launches different game to avoid duplicate.
    game_id Yes Int DC Game ID
    currency Yes String(4) Player currency code, check Appendix 4.2
    language Yes String(7) Language showed in the game, check Appendix 4.3
    channel Yes String(6) ‘pc’ or ‘mobile’
    country_code Yes String(2) Player country code, check Appendix 3.4
    return_url No String(50) Use for home button or redirection URL (Only provided in part of games)
    full_screen No Boolean Full screen game display (Only provided in part of games)

    Response

    code Response
    1000 {"code": 1000, "data": {"game_url":"http://xxxxxxxxxxx"}, "msg": "Success."}

    2.2 Try Game

    This method allows players to launch the games in demo mode (without real money)

    Request

    EndPoint : {api_url}/dcs/tryGame

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+game_id+api_key)
    game_id Yes Int DC Game ID
    currency Yes String(4) Player currency code, check Appendix 4.2
    language Yes String(7) Language showed in the game, check Appendix 4.3
    channel Yes String(6) 'pc' or 'mobile'
    return_url No String(50) Use for home button or redirection URL (Only provided in pa of games)
    full_screen No Boolean Full screen game display (Only provided in part of games)

    Response

    code Response
    1000 {"code": 1000, "data": {"game_url":"http://xxxxxxxxxxx"}, "msg": "Success."}

    2.3 Report

    Request restriction

    The interval between start_time and end_time must be within 24 hours. The data provided is within 6 months. The frequency is 3 sec per request.

    The api also supports the paging function. Operator passes the page parameter to 1 in the first request of the same time interval. Each page can provide up to 5000 pieces of data. The total number of pages can be calculated from the total_count parameter in the response information. The calculation method is as follows: page.total_count/5000 unconditional carry to the integer. Reports are generated in UTC time zone.

    Request

    EndPoint : {getBetData_url}/dcs/getBetData

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+start_time+end_time+api_key)
    page Yes Int Page index
    start_time Yes String(19) Starting time format (yyyy-MM-dd HH:mm:ss)
    end_time Yes String(19) Ending time format (yyyy-MM-dd HH:mm:ss)
    currency Yes String(4) Player currency code, check Appendix 4.2
    provider Yes String(20) Game provider code, check Appendix 4.6
    brand_uid No String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success.",
    "data": [ { "brand_uid": "TestUser", "currency": "CNY", "wager_type": "endWager", "amount": 10000.12, "before_amount": 806585.06, "after_amount": 816585.18, "game_id": "7382", "game_name": "Lucky Neko", "round_id": "1905291058028500001", "wager_id": "1905291058028500001", "jackpot_contribution": 0.0, "jackpot_win": 0.0, "description": "", "create_time": "2019-05-29 10:58:24", "game_result": "{…}" "tip": 0.0, "is_endround": false }], "page":{ "current_page": 1, "total_count": 1 } }

    Response information

    wager_type : Check Appendix 4.5 page.current_page : Current page index page.total_count : Total page count (5k results per page)

    Special Remarks

    When the Provider is SA Gaming and the game is Pok Deng, Player 1 to Player 5 will withhold 2 times of the bet amount.

    2.4 Game Replay

    The method returns player bet record replay for a specific round. The request restriction is 3 seconds per brand.

    Request

    EndPoint : {api_url}/dcs/getReplay

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+round_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    provider Yes String(20) Game provider code, check Appendix 4.6
    round_id Yes String(64) Game round ID

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "record": "http://{{xxxxxxxx}}/replay/{roundid}", "record_type": "URL", }

    Response information

    There are three types of data.record_type, Text : data.record output text format for game result

    DCACEDCS Seamless wallet API documentURL : data.record output URL format, operator needs to check the bet record via certain URLHtml : data.record output in HTML format for game result

    2.5 Get Game List

    Request

    EndPoint : {api_url}/dcs/getGameList

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+api_key)
    provider No String(20) Game provider code, check Appendix 4.6

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success", "data": [ { "provider": "yg", "game_id": 7316, "game_name": "Vikings go Wild", "game_name_cn": "狂野北欧海盗", "release_date": "2015-07-31", "rtp": "96.30%", "game_icon": "https://XXXX?e=tln7KM", "content_type": "Standard", "game_type": "SLOT", "content": "Yggdrasil" }]

    2.6 FreeSpin Campaign Setup

    This method allows to create FreeSpin Campaign

    Request

    EndPoint : {api_url}/dcs/createFreeSpin

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) Sign = MD5(brand_id+end_time+api_key)
    game_id Yes Int DC Game ID for assigning freespin
    currency Yes String(4) FreeSpin currency, check Appendix 4.2
    end_time Yes String(19) Campaign end time, UTC time zone, format: yyyy-MM-dd HH:mm:ss
    description No String(100) FreeSpin campaign description

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "freespin_id": 10001, "usable_amounts": [0.5, 2.0, 5.5] }

    Response information

    data.usable_amounts: Only provider ‘yg, hs, png, nlc, evo’ responds a list of usable amounts.

    2.7 FreeSpin Campaign Player Setup

    This method allows operators to bind the FreeSpin Campaign to specific players.

    Request

    EndPoint : {api_url}/dcs/addFreeSpin

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) Sign = MD5(brand_id+freespin_id+api_key)
    freespin_id Yes Long freespin_id from the response of 2.7 createFreeSpin
    round_count Yes Int FreeSpin rounds
    amount Yes Decimal(16,6) Bet amount per FreeSpin If the provider is yg, please put one of the values in usable_amounts. No restriction for other provider, but please make sure the amount is in bet limit.
    brand_uids Yes List<String(20)> Assign campaign to a list of brand_uid (Only support english characters and numbers, case insensitive) E.g.: "brand_uids": ["DemoUser01","DemoUser02"]

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "result": "Success." }
    }
    }

    2.8 FreeSpin Campaign Query

    Operator can use the api to query details of existing FreeSpin Campaign.

    Request

    EndPoint : {api_url}/dcs/queryFreeSpin

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) Sign = MD5(brand_id+game_id+api_key)
    game_id Yes Int DC Game ID for FreeSpin assigned
    currency Yes String(4) FreeSpin currency, check Appendix 4.2

    Response

    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "freespin_id": 10001, "end_time": "2022-08-30 00:00:00", "provider": "yg", "game_id": 7316, "currency": "CNY", "status": 0, "round_count": 10, "amount": 2.65, "brand_uids": [ "DemoUser01", "DemoUser02" ], "create_time": "2022-07-01 14:50:00" }
    }

    Response information

    data.status corresponding status info: 0: Built: 1: Players assigned: 2: Campaign activated

    3. Brand API endpoints implementation

    Operator must implement all API endpoints. Corresponding requests and the response parameters are described in detail.

    DC requests operator brand API endpoints in POST method. The sign parameter is MD5 encrypted, operator must affirm the parameters are not tampered.

    Method Content Type
    POST application/json

    Endpoint request common parameters :

    Name Required Type Description
    brand_id Yes string(7) Brand ID
    sign Yes String(32) MD5 encryption and transform into CAPITAL Encrypted detail will describe in each endpoint Do not put “+” sign when concatenating messages

    Endpoint response common parameters :

    Name Required Type Description
    code Yes Int Refer to DCS API Response code, check Appendix 4.1
    msg Yes String(50) Messages

    3.1 Login Authentication

    Operator is obligated to implement login endpoint in order to run gameplay. Token validation is required from providers so operator should respond the corresponding information to the login request.

    Request

    EndPoint : {brandApi_url}/login

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+token+api_key)
    token Yes String(32) Token is created by operator, only allowed the combination of English letters and numbers
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 { "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "USD", "balance": 25.55 } }

    3.2 Wager

    Operator is obliged to implement wager endpoint in order to run gameplay. If there is same wager request (identified by round_id and wager_id), or the wager has been cancelled, operator should not execute but return success response with player current balance. Noted that multiple wager_id may happen in same round_id in case the game has several buy- ins.

    Request

    EndPoint : {brandApi_url}/wager

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+wager_id+api_key)
    token Yes String(32) Token is created by operator, only allowed the combination of English letters and numbers
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive
    currency Yes String(4) Player currency code, check Appendix 4.2
    amount Yes Decimal(16,6) Bet amount
    jackpot_contribution Yes Decimal(16,6) A portion of player bet amount add to Jackpot feed
    game_id Yes Int DC game ID
    game_name Yes String(50) DC Game Name
    round_id Yes String(64) Unique bet round identifier
    wager_id Yes String(64) Unique transaction identifier within a bet round
    provider Yes String(20) Game provider code, check Appendix 4.6
    bet_type Yes Int 1=Normal; 2=Tip
    is_endround Yes Boolean false= Unfinished, true= Round Finish
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate wager (identify by round_id and wager_id).2. Return code: 5003 with data.brand_uid, data_currency, data.balance if player has insufficient balance3. When the Provider is SA Gaming and the game is Pok Deng, Player 1 to Player 5 will withhold 2 times of the bet amount.

    3.3 CancelWager

    Operator is obliged to implement cancelWager endpoint in order to run gameplay. If the operator has cancelled the wager (identical round_id and wager_id), operator should not execute the same request but return current balance in the response.

    Request

    EndPoint : {brandApi_url}/cancelWager

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+wager_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    round_id Yes String(64) Unique bet round identifier
    wager_id Yes String(64) Unique transaction identifier within a bet round
    provider Yes String(20) Game provider code, check Appendix 4.6
    wager_type Yes Int 1=cancelWager, 2=cancelEndWager
    is_endround Yes Boolean false= Unfinished, true= Round Finish
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate cancelWager (identify by round_id and wager_id).
    2. Return code: 5042 with data.brand_uid, data_currency, and data.balance if operator does not have the wager_id to be cancelled.
    3. When the wager_type is 1, the wager_round should be cancelled, i.e., return/increase the amount to the player wallet. When wager_type is 2, the endWager_round should be cancelled, i.e., deduct/reduce the amount to the player’s wallet.

    3.4 AppendWager

    Operator is obliged to implement AppendWager endpoint in order to run gameplay. This method is used for the result of jackpot game. Operator must payout the bonus unless same appendWager (identical round_id and wager_id) has executed.

    Request

    EndPoint : {brandApi_url}/appendWager

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+wager_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    amount Yes Decimal(16,6) Player jackpot winning amount
    game_id Yes Int DC game ID
    game_name Yes String(50) DC Game Name
    round_id Yes String(64) Unique bet round identifier
    wager_id Yes String(64) Unique transaction identifier within a bet round
    provider Yes String(20) Game provider code, check Appendix 4.6
    description Yes String(100) Description of appendWager
    is_endround Yes Boolean false= Unfinished, true= Round Finish
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "USD", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate appendWager (identify by round_id and wager_id).

    3.5 EndWager

    Operator is obliged to implement EndWager endpoint in order to run gameplay. This method is used to payout the winning amount for a normal round. If operator has executed the same endWager (identical round_id and wager_id), the current player info will be returned in response.

    Request

    EndPoint : {brandApi_url}/endWager

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+wager_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    amount Yes Decimal(16,6) Player winning amount in normal round
    round_id Yes String(64) Unique bet round identifier
    wager_id Yes String(64) Unique transaction identifier within a bet round
    provider Yes String(20) Game provider code, check Appendix 4.6
    is_endround Yes Boolean false= Unfinished, true= Round Finish
    game_result No String(4000) Only Ezugi has game result, the other provider will be null
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate endWager (identify by round_id and wager_id).2. Return code:5042 with data.brand_uid, data_currency, and data.balance if operator does not have the round_id to finish the round.

    3.6 FreeSpinResult

    Operator is obliged to implement FreeSpinResult endpoint in order to run gameplay. The total winning amount during the campaign will be aggregated in one request.

    Request

    EndPoint : {brandApi_url}/freeSpinResult

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+wager_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    amount Yes Decimal(16,6) Player winning amount in campaign
    game_id Yes Int DC game ID
    game_name Yes String(50) DC Game Name
    round_id Yes String(64) Unique bet round identifier
    wager_id Yes String(64) Unique transaction identifier within a bet round
    provider Yes String(20) Game provider code, check Appendix 4.6
    is_endround Yes Boolean false= Unfinished, true= Round Finish
    freespin_id No Long freespin_id from the response of 2.7 createFreeSpin
    freespin_description No String(100) FreeSpin campaign description
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes Int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate freeSpinResult (identify by round_id and wager_id).

    3.7 GetBalance

    Operator is obliged to implement getBalance endpoint in order to run gameplay. Response will be player current balance.

    Request

    EndPoint : {brandApi_url}/getBalance

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+token+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    token Yes String(32) Token created by operator, only allowed the combination of English letters and numbers

    Response

    Name Required Type Description
    code Yes int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    3.8 PromoPayout

    This api will be sending promotional bonuses, adding the amount directly to the player wallet

    Request

    EndPoint : {brandApi_url}/promoPayout

    Name Required Type Description
    brand_id Yes String(7) Brand ID
    sign Yes String(32) sign = MD5(brand_id+promotion_id+trans_id+api_key)
    brand_uid Yes String(20) Unique User ID from operator (Only support english characters and numbers, case insensitive)
    currency Yes String(4) Player currency code, check Appendix 4.2
    amount Yes Decimal(16,6) Promo bonus
    promotion_id Yes String(36) Promotion id
    trans_id Yes String(128) Trans id
    provider Yes String(16) Game provider code, check Appendix 4.6
    transaction_time Yes String(20) The format is: yyyy-MM-ddTHH:mm:ssZ

    Response

    Name Required Type Description
    code Yes int DCS API Response Code, check Appendix 4.1
    msg Yes String(50) If the request info is valid, please respond with message "Success".
    data.brand_uid Yes String(20) Unique User ID from operator
    data_currency Yes String(4) Player currency code, check Appendix 4.2
    data.balance Yes Decimal(16,6) Player current balance
    code Response
    1000 {
    "code": 1000, "msg": "Success.", "data": { "brand_uid": "testUser", "currency": "IDR", "balance": 25.55 }

    Special Remarks

    1. Return code: 5043 with data.brand_uid, data_currency, data.balance if operator receives duplicate promoPayout (identify by promotion_id and trans_id).

    4. Appendix

    4.1 DCS API Response Code

    Code Remark Description
    1000 Success. Success
    1001 System error. System error
    1002 Unknown. Unknown error
    5000 Sign error. Verification code error
    5001 Request param error. Request parameter error
    5002 Currency not support. Currency not supported
    5003 Balance insufficient. Insufficient balance
    5005 Brand not exist. Brand does not exist
    5008 Country Code error. Country code error
    5009 Player not exist. Player's account or token does not exist
    5010 Player blocked. Player blocked
    5012 Game id not exist. Game id does not exist
    5013 Not logged in. Session authentication failed, token does not match with player
    5014 Incorrect time format. Invalid time format
    5015 Incorrect provider. Invalid provider
    5016 Incorrect amount. Invalid amount
    5017 Api insufficient permission. Api has insufficient permission
    5018 Incorrect brand uid. Incorrect brand_uid
    5040 Request rate limit, once request per 3 seconds. Request limit reached, once every 3 seconds.
    5041 Request date range limit, once request time period can only be within 24 hours. request time can only be within 6 months. Request segment limit, each request segment must not exceed 24 hours, in addition, the information can be inquire only within 6 months period.
    5042 Bet record not exist. Bet record does not exist.
    5043 Bet record duplicate. Bet record is duplicated/identical.
    5070 Free spin ID not exist. Free spin ID does not exist.
    5071 Incorrect round count. Invalid spin count
    5072 The free spin already cancelled. This free spin has been cancelled.
    5073 The free spin already locked. This free spin has been locked, unable to alter.
    5074 The provider does not support free spin. This provider does not support assigning freespin to players.
    5075 The free spin set up error. The free spin setup has an error.
    5019 Provider is maintaining Provider is under maintenance
    5020 Brand locked Brand locked
    5021 No support try game Try game is not supported
    5023 No support get replay Replay is not supported
    5024 Token cannot be used Token cannot be used
    5025 Unsupported method Unsupported method

    4.2 Currency code List

    Please refer to ISO 4217 currency codes, different provider supports different currencies.

    Code Remark Description
    AED United Arab Emirates Dirham UAE Dirham
    AFN Afghan Afghani Afghan Afghani
    ALL Albanian Lek Albanian Lek
    AMD Armenian Dram Armenian Dram
    ANG Netherlands Antillean Guilder Netherlands Antillean Guilder
    AOA Angolan Kwanza Angolan Kwanza
    ARS Argentine Peso Argentine Peso
    AUD Australian Dollar Australian Dollar
    AZN Azerbaijan Manat Azerbaijan Manat
    BAM Bosnia and Herzegovina convertible mark Bosnia and Herzegovina convertible Mark
    BDT Bangladeshi Taka Bangladeshi Taka
    BGN Bulgarian Lev Bulgarian Lev
    BHD Bahrain Dinar Bahrain Dinar
    BND Brunei Dollar Brunei Dollar
    BOB Bolivian Boliviano Bolivian Boliviano
    BRL Brazilian Real Brazilian Real
    BWP Botswanan Pula Botswanan Pula
    BYN Belarusian Ruble Belarusian Ruble
    BZD Belize Dollar Belize Dollar
    CAD Canadian Dollar Canadian Dollar
    CDF Congolese Franc Congolese Franc
    CHF Swiss Franc Swiss Franc
    CLP Chilean Peso Chilean Peso
    CNY Chinese Yuan Chinese Yuan
    COP Colombian Peso Colombian Peso
    CRC Costa Rican Colón Costa Rican Colón
    CUP Cuban Peso Cuban Peso
    CZK Czech Koruna Czech Koruna
    DKK Danish Krone Danish Krone
    DOP Dominican Peso Dominican Peso
    DZD Algerian Dinar Algerian Dinar
    EGP Egyptian Pound Egyptian Pound
    ETB Ethiopian Birr Ethiopian Birr
    EUR Euro Euro
    GBP Pound Sterling Pound Sterling
    GEL Georgian Lari Georgian Lari
    GHS Ghanaian Cedi Ghanaian Cedi
    GMD Gambian Dalasi Gambian Dalasi
    GNF Guinean Franc Guinean Franc
    GTQ Guatemalan Quetzal Guatemalan Quetzal
    HKD Hong Kong Dollar Hong Kong Dollar
    HNL Honduran Lempira Honduran Lempira
    HRK Croatian Kuna Croatian Kuna
    HTG Haitian Gourde Haitian Gourde
    HUF Hungarian Forint Hungarian Forint
    IDR Indonesian Rupiah Indonesian Rupiah
    IDX Thousand Indonesian Rupiah Indonesian Rupiah/1000
    ILS Israeli New Shekel Israeli New Shekel
    INR Indian Rupee Indian Rupee
    IQD Iraqi Dinar Iraqi Dinar
    IRR Iranian rial Iranian rial
    ISK Icelandic Krona Icelandic Krona
    JMD Jamaican Dollar Jamaican Dollar
    JOD Jordanian Dinar Jordanian Dinar
    JPY Japanese Yen Japanese Yen
    KES Kenyan Shilling Kenyan Shilling
    KGS Kyrgyzani Som Kyrgyzstani Som
    KHR Cambodian Riel Cambodian Riel
    KRW South Korean Won South Korean Won
    KWD Kuwaiti Dinar Kuwaiti Dinar
    KZT Kazakhstani Tenge Kazakhstani Tenge
    LAK Lao Kip Lao Kip
    LBP Lebanese Pound Lebanese Pound
    LKR Sri Lankan Rupee Sri Lankan Rupee
    LRD Liberian dollar Liberian Dollar
    LSL Basotho Loti Basotho Lotu
    LVL Latvia Lat Latvia Lat
    MAD Moroccan Dirham Moroccan Dirham
    MDL Moldovan Leu Moldovan Leu
    MGA Ariary Ariary
    MKD Macedonian Denar Macedonian Denar
    MMK Myanmar Kyat Myanmar Kyat
    MNT Mongolian Tugrik Mongolian Tugrik
    MOP Macau Pataca Macau Pataca
    MUR Mauritian Rupee Mauritian Rupee
    MVR Maldivian Rufiyaa Maldivian Rufiyaa
    MWK Malawian kwacha Malawian Kwacha
    MXN Mexican Peso Mexican Peso
    MYR Malaysian Ringgit Malaysian Ringgit
    MZN Mozambican Metical Mozambican Metical
    NAD Namibian Dollar Namibian Dollar
    NGN Nigerian Naira Nigerian Naira
    NIO Nicaraguan Córdoba Nicaraguan Córdoba
    NOK NOK Norwegian Krone
    NPR Nepalese Rupee Nepalese Rupee
    NZD New Zealand Dollar New Zealand Dollar
    OMR Omani Rial Omani Rial
    PAB Panamanian Balboa Panamanian Balboa
    PEN Peruvian Nuevo Sol Peruvian Nuevo Sol
    PHP Philippine Peso Philippine Peso
    PKR Pakistan Rupee Pakistan Rupee
    PLN Polish Zloty Polish Zloty
    PYG Paraguayan Guarani Paraguayan Guarani
    QAR Qatari Rial Qatari Rial
    RON Romanian Dram Romanian Dram
    RSD Serbian Dinar Serbian Dinar
    RUB Russian Ruble Russian Ruble
    RWF Rwandan franc Rwandan Franc
    SAR Saudi Riyal Saudi Riyal
    SCR Seychellois Rupee Seychellois Rupee
    SDG Sudanese Pound Sudanese Pound
    SEK Swedish Krona Swedish Krona
    SGD Singapore Dollar Singapore Dollar
    SRD Surinamese Dollar Surinamese Dollar
    SZL Swazi Lilangeni Swazi Lilangeni
    TGC TGC point TGC point
    THB Thai Baht Thai Baht
    TJS Tajikistani Somoni Tajikistani Somoni
    TMT Turkmenistani Mahat Turkmenistani Mahat
    TND Tunisian Dinar Tunisian Dinar
    TRY Turkish Libra Turkish Libra
    TTD Trinidad and Tobago Dollar Trinidad and Tobago Dollar
    TWD New Taiwan Dollar New Taiwan Dollar
    TZS Tanzanian Shilling Tanzanian Shilling
    UAH Ukrainian Hryvnia Ukrainian Hryvnia
    USD United States Dollar United States Dollar
    UYU Uruguayan Peso Uruguayan Peso

    DCE

    DCS Seamless wallet API document

    UZS Uzbekistani Som Uzbekistani Som
    VND Vietnamese Dong Vietnamese Dong
    VNX Thousand Vietnamese Dong Vietnamese Dong/1000
    XAF Central African CFA Franc Central African CFA Franc
    XCD East Caribbean Dollar East Caribbean Dollar
    XOF CFA Franc BCEAO CFA Franc BCEAO
    YER Yemeni Rial Yemeni Rial
    ZAR South African Rand South African Rand
    ZM Zambian Kwacha Zambian Kwacha
    ZWL Zimbabwean Dollar Zimbabwean Dollar
    BTP BT Points BT Points
    USDT Tether Tether(USDT)
    VES Bolivar Soberano Bolivar Soberano
    SSP South Sudanese Pound South Sudanese Pound

    4.3 Language code list

    Code Remark Description
    zh_hans Simplified Chinese Simplified Chinese
    zh_hant Traditional Chinese Traditional Chinese
    ko Korean Korean
    kr Korean Korean
    en English English
    th Thai Thai
    vi Vietnamese Vietnamese
    id Indonesian Indonesian
    ja Japanese Japanese
    bg Bulgarian Bulgarian
    cz Czech Czech
    de German German
    el Greek Greek
    tr Turkish Turkish
    es Spanish Spanish
    fi Finnish Finnish
    fr French French
    hu Hungarian Hungarian
    it Italian Italian
    nl Dutch Dutch
    no Norwegian Norwegian
    pl Polish Polish
    pt Portuguese Portuguese
    pt-BR Brazilian-Portuguese Brazilian-Portuguese
    ro Romanian Romanian
    ru Russian Russian
    sk Slovak Slovak
    sv Swedish Swedish
    da Danish Danish
    ka Georgian Georgian
    lv Latvian Latvian
    uk Ukrainian Ukrainian
    et Estonian Estonian

    4.4 Country_code

    Please refer to ISO 3166- 1 Alpha 2 country coder, below are some examples

    Code Remark Description
    CN China China
    HK Hong Kong Hong Kong
    TW Taiwan Taiwan
    KR South Korea South Korea
    JP Japan Japan
    TH Thailand Thailand
    PH Philippines Philippines
    ID Indonesia Indonesia
    IN India India
    VN Vietnam Vietnam
    MY Malaysia Malaysia
    SG Singapore Singapore

    4.5 Wager_type

    Code Description
    wager Bet
    endWager Finish bet
    cancelWager Cancel bet, due to internal error (bet amount refund to player)
    appendWagerResult Appears in jackpot and prizedrop
    campaign Free Spin Bet record (Only appears in Backoffice)
    campaignpayout Player's profit from prepaid free spin campaign
    cancelEndWager Cancellation of payout due to internal error (deducting the amount paid to the player from the player's wallet balance)
    promopayout send promotional bonuses, adding the amount directly to the player wallet

    4.6 Provider List

    Code Description
    dcace DCACE
    yg Yggdrasil
    relax Relax gaming
    nlc Nolimit City
    png Play'n Go
    hs Hackswag Gaming
    aux Avatar UX
    evo Evoplay
    gam Gamcomat
    psh Push Gaming
    ezugi Ezugi
    swf Win Fast
    funta FunTa Gaming
    stm Slotmill
    mj 7Mojos
    fm Fantasma
    ps Peter &amp; Sons
    sb Spirbe
    plb Parlay bay
    evl Evolution
    btg Big Time Gaming
    ne NetEnt
    rt Red Tiger
    tg Turbo Games
    tgo Turbo Games (non-Asian market)
    wz Voltent (Wazdan)
    tk Thunderkick
    lm Lucky Monaco
    yt Yolted
    sa SA Gaming
    ss Smartsoft
    bg Bgaming
    nm Novomatic
    op Octoplay
    bp BluePrint
    hso Hacksaw Gaming ROW
    hsl Hacksaw Gaming Latam
    tq Tequity
    raw RAW