Wallet integration

Balance inquiry

GET https://{operator-domain}/player/balance

ใช้สำหรับอัปเดตยอดคงเหลือแบบเรียลไทม์ระหว่างการเล่นเกม

Headers

Name	Value
X-API-KEY	api key ที่โอเปอเรเตอร์ใส่ที่ระบบหลังบ้าน Big Poker

Query string parameter

Name	Type	Description	Required
player_id	string	user id ของระบบโอเปอเรเตอร์	Yes
currency	string	สกุลเงิน 3 หลัก ตามมาตราฐาน ISO 4217 (Ex. THB)	Yes

Response

200

HTTP Status: 200 OK
Content-Type: application/json
{
    "status": "success",
    "data": {
        "balance": 890.00,
        "currency": "THB"    
    }
}

404

Debit

POST https://{operator-domain}/game/transaction

ใช้สำหรับตัดเครดิตผู้เล่นในการเข้าเล่นเกม

Headers

Name	Value
Content-Type	application/json
X-API-KEY	api key ที่โอเปอเรเตอร์ใส่ที่ระบบหลังบ้าน Big Poker

Body

Name	Type	Description	Required
transaction_type	string	ประเภทรายการ จะมีค่าเป็น "debit"	Yes
transaction_id	string	เลขที่รายการ	Yes
transaction_code	string	รหัสประเภทรายการ จะมีค่าเป็น DDC01 = Deduct credit	Yes
player_id	string	user id ของระบบโอเปอเรเตอร์	Yes
game_key	string	รหัสประเภทเกม ตามระบบของ Big Poker Game list	Yes
room_id	string	เลขที่ห้องเกม	Yes
table_id	string	เลขที่โต๊ะ	Yes
amount	decimal	จำนวนเครดิต เป็นทศนิยม 2 ตำแหน่ง	Yes
currency	string	สกุลเงิน 3 หลัก ตามมาตราฐาน ISO 4217 (Ex. THB)	Yes
created_at	string	วันเวลาที่สร้างรายการ ตามมาตราฐาน ISO 8601 format: YYYY-MM-DDTHH:mm:ss.SSSZ	Yes

Response

201

HTTP Status: 201
Content-Type: application/json
{
    "status": "success",
    "data": {
        "balance": 300.00, // เครดิตคงเหลือ
        "currency": "THB", // สกุลเงิน
        "ref_id": "123456" // เลขรายการของโอเปอเรเตอร์
    }
}

404

Credit

POST https://{operator-domain}/game/transaction

ใช้สำหรับส่งผลการวางเดิมพันกลับไปยังโอเปอเรเตอร์หลังจากออกผล และทางโอเปอเรเตอร์สามารถเติมเครดิตให้ลูกค้าตาม amount ที่ได้รับ

Headers

Name	Value
Content-Type	application/json
X-API-KEY	api key ที่โอเปอเรเตอร์ใส่ที่ระบบหลังบ้าน Big Poker

Body

Name	Type	Description	Required
transaction_type	string	ประเภทรายการ จะมีค่าเป็น "credit"	Yes
transaction_id	string	เลขที่รายการจาก Big Poker	Yes
transaction_code	string	รหัสรายการ จะมีค่า CCW01 = Win	Yes
ref_transaction_id	string	เลขรายการ transaction_id ของ API Debit	Yes
player_id	string	user id ของระบบโอเปอเรเตอร์	Yes
game_key	string	รหัสประเภทเกม ตามระบบของ Big Poker Game list	Yes
room_id	string	เลขที่ห้อง
table_id	string	เลขที่โต๊ะ	Yes
amount	decimal	จำนวนเครดิต เป็นทศนิยม 2 ตำแหน่ง ที่ระบบจะต้องโอนให้ผู้เล่น กรณีที่ transaction_code = CCW01	Yes
currency	string	สกุลเงิน 3 หลัก ตามมาตราฐาน ISO 4217 (Ex. THB)	Yes
created_at	string	วันเวลาที่สร้างรายการ ตามมาตราฐาน ISO 8601 format: YYYY-MM-DDTHH:mm:ss.SSSZ	Yes

Response

201

HTTP Status: 201
Content-Type: application/json
{
    "status": "success",
    "data": {
        "balance": 325.00, // เครดิตคงเหลือ
        "currency": "THB", // สกุลเงิน
        "ref_id": "345678" // เลขรายการของโอเปอเรเตอร์
    }
}

404

Cancel

POST https://{operator-domain}/game/transaction

ใช้สำหรับให้ทาง Big Poker ส่งยกเลิกรายการวางเดิมพัน ตามกรณีนี้ 1. Big Poker เรียก API debit แล้วโอเปอเรเตอร์ ตอบ timeout

Headers

Name	Value
Content-Type	application/json
X-API-KEY	api key ที่โอเปอเรเตอร์ใส่ที่ระบบหลังบ้าน Big Poker

Body

Name	Type	Description	Required
transaction_type	string	ประเภทรายการ จะมีค่าเป็น "cancel"	Yes
transaction_id	string	เลขที่รายการ	Yes
transaction_code	string	รหัสประเภทรายการ จะมีค่าเป็น CRF01 = refund	Yes
ref_transaction_id	string	เลขรายการ transaction_id ของ API Debit	Yes
player_id	string	user id ของระบบโอเปอเรเตอร์	Yes
game_key	string	รหัสประเภทเกม ตามระบบของ Big Poker Game list	Yes
room_id	string	เลขที่ห้องเกม	Yes
table_id	string	เลขที่โต๊ะ	Yes
amount	decimal	จำนวนเครดิต เป็นทศนิยม 2 ตำแหน่ง	Yes
currency	string	สกุลเงิน 3 หลัก ตามมาตราฐาน ISO 4217 (Ex. THB)	Yes
created_at	string	วันเวลาที่สร้างรายการ ตามมาตราฐาน ISO 8601 format: YYYY-MM-DDTHH:mm:ss.SSSZ	Yes

Response

201

HTTP Status: 201
Content-Type: application/json
{
    "status": "success",
    "data": {
        "balance": 890.00, // เครดิตคงเหลือ
        "currency": "THB", // สกุลเงิน
        "ref_id": "567890" // เลขรายการของโอเปอเรเตอร์
    }
}

404

Game result

POST https://{operator-domain}/game/result

ใช้สำหรับรับผลลัพธ์ของเกมในแต่ละตา

Headers

Name	Value
Content-Type	application/json
X-API-KEY	api key ที่โอเปอเรเตอร์ใส่ที่ระบบหลังบ้าน Big Poker

Body

Name	Type	Description	Required
transaction_id	string	เลขที่รายการ	Yes
game_key	string	รหัสประเภทเกม ตามระบบของ Big Poker Game list	Yes
player_result	string	win = ผู้เล่นชนะเดิมพัน loss = ผู้เล่นแพ้เดิมพัน	Yes
player_id	string	user id ของระบบโอเปอเรเตอร์	Yes
room_id	string	เลขที่ห้องเกม	Yes
table_id	string	เลขที่โต๊ะ	Yes
round_id	string	เลขที่ของเกมที่วางเดิมพัน	Yes
amount	decimal	จำนวนเครดิต เป็นทศนิยม 2 ตำแหน่ง	Yes
currency	string	สกุลเงิน 3 หลัก ตามมาตราฐาน ISO 4217 (Ex. THB)	Yes
created_at	string	วันเวลาที่สร้างรายการ ตามมาตราฐาน ISO 8601 format: YYYY-MM-DDTHH:mm:ss.SSSZ	Yes
result	object	ผลการเล่นเกมตานั้นๆ	Yes
community_card	array	ไพ่กองกลาง	Yes
players	array	ผู้เล่นในเกมตานั้นๆ	Yes
bets	object	การวางเดิมพัน	Yes
preflop	array	การเดิมพันรอบ preflop	Yes
flop	array	การเดิมพันรอบ flop	No
turn	array	การเดิมพันรอบ turn	No
river	array	การเดิมพันรอบ river	No

ตัวอย่าง Request

{
    "transaction_id": "result-2148",
    "game_key": "NLH",
    "player_result": "win",
    "player_id": "1001",
    "room_id": "1",
    "table_id": "1",
    "round_id": "556",
    "amount": 53000.00,
    "currency": "THB",
    "created_at": "2025-02-19T03:52:18.715060182Z",
    "result": {
        "community_card": ["2D","4S","5C","6H","7S"],
        "players": [
            {
                "id": "1001",
                "display_name": "A",
                "position": "btn",
                "card": ["8D","KH"],
                "hand_rank": "straight",
                "round": "river",
                "status": "win",
                "win_amount": 53000.00,
                "bet_amount": 22000.00,
                "currency": "THB",
                "operator_id": 1234,
                "hand_rank_card": ["8D","4S","5C","6H","7S"]
            },
            {
                "id": "1002",
                "display_name": "B",
                "position": "sb",
                "card": ["1D","QH"],
                "hand_rank": "high_card",
                "round": "preflop",
                "status": "fold",
                "win_amount": 0.00,
                "bet_amount": 1000.00,
                "currency": "THB",
                "operator_id": 1234,
                "hand_rank_card": ["1D","QH","5C","6H","7S"]
            },
            {
                "id": "1003",
                "display_name": "C",
                "position": "bb",
                "card": ["1H","0H"],
                "hand_rank": "high_card",
                "round": "turn",
                "status": "fold",
                "win_amount": 0.00,
                "bet_amount": 6000.00,
                "currency": "THB",
                "operator_id": 5544,
                "hand_rank_card": ["1H","0H","5C","6H","7S"]
            },
            {
                "id": "1004",
                "display_name": "D",
                "position": "utg",
                "card": ["KD","2H"],
                "hand_rank": "one_pair",
                "round": "flop",
                "status": "fold",
                "win_amount": 0.00,
                "bet_amount": 2000.00,
                "currency": "THB",
                "operator_id": 2022,
                "hand_rank_card": ["2D","4S","5C","6H","7S"]
            },
            {
                "id": "1005",
                "display_name": "E",
                "position": "co",
                "card": ["JD","JH"],
                "hand_rank": "one_pair",
                "round": "river",
                "status": "loss",
                "win_amount": 0.00,
                "bet_amount": 22000.00,
                "currency": "THB",
                "operator_id": 1234,
                "hand_rank_card": ["JD","JH","5C","6H","7S"]
            }
        ],
        "bets": {
            "preflop": [
                {
                    "player_id": 1002,
                    "display_name": "B",
                    "action": "sb",
                    "amount": 1000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1003,
                    "display_name": "C",
                    "action": "bb",
                    "amount": 2000.00,
                    "operator_id": 5544
                },
                {
                    "player_id": 1004,
                    "display_name": "D",
                    "action": "call",
                    "amount": 2000.00,
                    "operator_id": 2022
                },
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "call",
                    "amount": 2000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1001,
                    "display_name": "A",
                    "action": "call",
                    "amount": 2000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1002,
                    "display_name": "B",
                    "action": "fold",
                    "amount": 0.00,
                    "operator_id": 1234
                }
            ],
            "flop": [
                {
                    "player_id": 1003,
                    "display_name": "C",
                    "action": "bet",
                    "amount": 4000.00,
                    "operator_id": 5544
                },
                {
                    "player_id": 1004,
                    "display_name": "D",
                    "action": "fold",
                    "amount": 0.00,
                    "operator_id": 2022
                },
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "call",
                    "amount": 4000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1001,
                    "display_name": "A",
                    "action": "call",
                    "amount": 4000.00,
                    "operator_id": 1234
                }
            ],
            "turn": [
                {
                    "player_id": 1003,
                    "display_name": "C",
                    "action": "check",
                    "amount": 0.00,
                    "operator_id": 5544
                },
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "bet",
                    "amount": 4000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1001,
                    "display_name": "A",
                    "action": "raise",
                    "amount": 6000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1003,
                    "display_name": "C",
                    "action": "fold",
                    "amount": 0.00,
                    "operator_id": 5544
                },
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "call",
                    "amount": 6000.00,
                    "operator_id": 1234
                }
            ],
            "river": [
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "check",
                    "amount": 0.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1001,
                    "display_name": "A",
                    "action": "allin",
                    "amount": 10000.00,
                    "operator_id": 1234
                },
                {
                    "player_id": 1005,
                    "display_name": "E",
                    "action": "call",
                    "amount": 10000.00,
                    "operator_id": 1234
                }
            ]
        }
    }
}

Response

200

HTTP Status: 200 OK
Content-Type: application/json
{
    "status": "success"
}

404