Bet

ใช้งานได้

POST{base}/api/bet

เมื่อผู้เล่นเล่นหรือวางเดิมพันบนหน้าเกม ระบบจะส่งคำขอมาที่ Callback URL ของระบบคุณ (ที่ตั้งค่าไว้ใน Backoffice) — คุณต้องตรวจสอบยอดเงินคงเหลือของผู้เล่น หากมีเพียงพอ ให้หักยอดของสมาชิกแล้วส่งการตอบกลับสำเร็จมาที่ระบบของเรา เพื่อดำเนินการเล่นเกมต่อ

ประมวล txns[] ทั้งชุดใน DB transaction เดียว (atomic) — ถ้าตัวใดพัง ให้ roll back ทั้งชุด แล้วตอบ error โดย balance_before == balance_after

ถ้าได้รับ txn_id เดิมซ้ำ ห้าม apply ซ้ำ ให้ตอบ balance ปัจจุบันพร้อม code 0 หรือตอบ 20002 · ข้อยกเว้นเดียวคือรายการที่ตามหลัง /rollback ของรอบนั้น ซึ่งเป็นผลที่ถูกแก้แล้วและต้อง apply (ดูหัวข้อ re-settle หลัง rollback ในหน้า Contract)

amount = 0 เกิดขึ้นจริง (feature spin, feature buy, tip หรือ stake ที่ค่ายระบุไม่ได้) ห้าม reject ให้ประมวลเป็นรายการยอด 0 แล้วตอบ code 0 โดยไม่ขยับ balance

ตอบ HTTP 200 เสมอแม้เป็น business error

Headers

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
X-Api-Key	string	ใช่	API key ที่ best-system ออกให้ (ตรวจว่าตรงกับของคุณ)
X-Signature	string	ใช่	hex(HMAC-SHA256(secret, raw body)) — verify จาก raw bytes ห้าม re-serialize · ไม่ตรง → ตอบ code 30002

Request bodyapplication/json

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
request_id	string	ใช่	id ของ request นี้
player_username	string	ใช่	username ผู้เล่นในระบบของคุณ
currency	string	ใช่	สกุลเงินของผู้เล่น ตาม ISO 4217 เช่น THB
product_code	string	—	รหัสค่ายเกม (เช่น PGSOFT)
timestamp	number	ใช่	เวลาที่ส่ง (unix ms)
txns	object[]	ใช่	รายการเดิมพันที่ต้องหักเงิน — amount ของแต่ละ txn คือยอด stake ที่ต้อง debit
└ txn_id	string	ใช่	Transaction ID · หากยิงซ้ำห้าม apply ซ้ำ (ตอบ balance ปัจจุบันด้วย code 0) · กีฬา: บิลที่ยืนยันแล้ว (OPEN) ถูก relay ซ้ำด้วย txn_id เดิม พร้อม status="OPEN" + skip_balance_update=true — ตอบ code 0 + balance ปัจจุบัน ห้ามหักซ้ำ (ดูหัวข้อ sportsbook ในหน้า Contract)
└ round_id	string	ใช่	รหัสรอบเกม
└ amount	number	ใช่	จำนวนเงินเดิมพัน
└ game_code	string	—	รหัสเกม
└ is_feature	boolean	—	free/feature spin (default false) อาจมากับ amount=0 (ประมวลเป็น bet ยอด 0: ตอบ code 0 ไม่หักเงิน)
└ status	string	—	สถานะบิลจากค่ายเกม เป็น OPEN ปกติ · WAITING เฉพาะบิลกีฬาก่อนค่ายยืนยัน แล้วส่งซ้ำด้วย txn_id เดิมเป็น OPEN พร้อม skip_balance_updateOPEN \| WAITING \| SETTLED \| REFUND \| REJECT \| ROLLBACK \| VOID \| TIPS
└ play_info	string	—	ข้อมูลของเกมที่เดิมพัน — เช่น LIVE_CASINO จะมี player/banker, SLOT จะเป็นชื่อเกม
└ bet_amount	number	—	ยอดเดิมพันตามที่ค่ายส่งมา ค่าเดียวกับ amount ของ callback นี้
└ skip_balance_update	boolean	—	หากมีค่าเป็น true ให้ข้ามการหักเงินจากสมาชิก — โดยปกติเกิดในเกมประเภท SPORT ตอนผู้ให้บริการพิจารณาการวางเดิมพันของผู้เล่น (default: false)
└ is_feature_buy	boolean	—	ค่าที่บอกว่าสมาชิกได้ซื้อ feature spin หรือไม่ (default: false)

ตัวอย่าง request

// สล็อตปกติ — status "OPEN" (ไม่มี WAITING / ไม่มี skip)
{
  "request_id": "2f6d9c81-4b3e-4a5d-9c0e-7a1b2c3d4e5f",
  "player_username": "foobar",
  "currency": "THB",
  "product_code": "PGSOFT",
  "timestamp": 1783236600000,
  "txns": [
    {
      "txn_id": "T-001",
      "round_id": "R-1",
      "amount": 200,
      "game_code": "10300",
      "is_feature": false,
      "status": "OPEN",
      "play_info": "Rise of Dragon"
    }
  ]
}

// กีฬา (1/2) — วางบิล status "WAITING" (หัก stake ตามปกติ)
{
  "request_id": "3f7a1c92-8b2e-4d5a-9e0f-1a2b3c4d5e6f",
  "player_username": "foobar",
  "currency": "THB",
  "product_code": "SABA",
  "timestamp": 1783236600100,
  "txns": [
    {
      "txn_id": "S-88001",
      "round_id": "SB-1",
      "amount": 100,
      "game_code": "SBO-FOOTBALL",
      "status": "WAITING",
      "play_info": "Man Utd vs Chelsea"
    }
  ]
}

// กีฬา (2/2) — ค่ายยืนยันบิล: relay /bet ซ้ำด้วย txn_id เดิม + status "OPEN" + skip_balance_update
// ห้ามหักซ้ำ → dedupe ต่อ txn_id แล้วตอบ code 0 + balance ปัจจุบัน
{
  "request_id": "4a8b2d03-9c3f-4e6b-8f10-2b3c4d5e6f70",
  "player_username": "foobar",
  "currency": "THB",
  "product_code": "SABA",
  "timestamp": 1783236600600,
  "txns": [
    {
      "txn_id": "S-88001",
      "round_id": "SB-1",
      "amount": 100,
      "game_code": "SBO-FOOTBALL",
      "status": "OPEN",
      "skip_balance_update": true
    }
  ]
}

Expected Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
code	number	ใช่	0 = สำเร็จ · อื่นๆ ดูหน้า Seamless codes
request_id	string	ใช่	echo จาก request
username	string	ใช่	echo player_username (กันสลับคน)
currency	string	ใช่	echo จาก request
balance_before	number	ใช่	ยอดก่อนประมวล txns[] ทั้งชุด
balance_after	number	ใช่	ยอดหลังประมวลทั้งชุด
timestamp	number	ใช่	เวลาที่คุณประมวลผล (unix ms)

ตัวอย่าง response

{
  "code": 0,
  "request_id": "2f6d9c81-4b3e-4a5d-9c0e-7a1b2c3d4e5f",
  "username": "foobar",
  "currency": "THB",
  "balance_before": 1000,
  "balance_after": 800,
  "timestamp": 1783236600090
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
10001	SEAMLESS_USER_NOT_FOUND	200	ไม่พบผู้เล่นในระบบของ agent
10002	SEAMLESS_INSUFFICIENT_BALANCE	200	ยอดเงินไม่พอสำหรับรายการหักเงิน (debit)
20002	SEAMLESS_DUPLICATE_TXN	200	รายการซ้ำ (txn_id เคยประมวลแล้ว)
30002	SEAMLESS_INVALID_SIGNATURE	401	X-Signature ไม่ถูกต้อง
40003	SEAMLESS_FORBIDDEN	200	ปฏิเสธการเข้าถึง (api-key/IP)
50001	SEAMLESS_INTERNAL_ERROR	200	ข้อผิดพลาดภายในระบบของ agent