โปรโมชั่นที่สมาชิกรับอยู่

ใช้งานได้

GET/api/v1/promotions/active-claim

โปรโมชั่นที่สมาชิกรับอยู่และยังทำเทิร์นไม่ครบ (มีสถานะ PENDING)

สมาชิกมีโบนัสค้างได้ทีละ 1 ก้อน และระหว่างรับโปรอยู่ ถ้ายังทำเทิร์นไม่ถึงการถอนจะถูกปฏิเสธ (2009) และรับโปรอื่นได้ (6006)

Headers

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
Authorization	string	ใช่	ใช้ — แนบ Bearer <access_token> ของสมาชิก
X-Api-Key	string	ใช่	API key ของ agent (ak_…) จากหน้า bo
X-Timestamp	string	ใช่	เวลา sign เป็น unix milliseconds (คลาดเคลื่อนได้ ±300 วินาที)
X-Nonce	string	ใช่	ค่าไม่ซ้ำต่อ request (UUIDv4) กัน replay
X-Signature	string	ใช่	hex(HMAC-SHA256(secret, canonical)) — ดูหน้า Authentication
X-Player-IP	string	—	IP จริงของผู้เล่น (IPv4/IPv6) — แนะนำให้ส่ง (ใช้ใน login history)
X-Player-UA	string	—	User-Agent ของผู้เล่น (optional — ลง login history)
X-Request-Id	string	—	correlation id ของฝั่งคุณ — ระบบ echo กลับใน request_uuid (แนะนำให้ส่ง)
x-lang	string	—	th (default) หรือ en — ภาษาของ message

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
claim_id	string	—	id ของรายการรับโบนัส
promotion_name	string	—	ชื่อโปรโมชั่น ณ ตอนรับ (snapshot)
promotion_type	string	—	ชนิดโปรโมชั่นของโบนัสก้อนนี้NEW_REGISTER \| FIRST_DEPOSIT \| CASHBACK \| FREE_CREDIT \| DAILY_LOGIN \| GOLDEN_MINUTE \| REFER_A_FRIEND \| COUPON_CODE
bonus_thb	string	—	ยอดโบนัสที่ได้รับ (THB)
wager_required_thb	string \| null	—	ยอดเทิร์นที่ต้องทำครบก่อนถอน — null = โบนัสนี้ไม่มีเงื่อนไขเทิร์น
wager_completed_thb	string	—	ยอดเทิร์นที่ทำไปแล้ว (อัปเดตตามรอบประมวลผล ไม่ใช่เรียลไทม์)
withdraw_cap_thb	string \| null	—	เพดานถอนสูงสุดของโบนัสนี้ — null = ไม่จำกัด
granted_at	string (ISO 8601)	—	เวลาที่ได้รับโบนัส
expires_at	string (ISO 8601) \| null	—	เส้นตายทำเทิร์น — เลยเวลานี้โบนัสถูกริบ; null = ไม่มีวันหมดอายุ

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "claim_id": "9d4c1f2a-6b8e-4d05-93a7-c51e0f8b2d46",
    "promotion_name": "เครดิตฟรี 50 บาท",
    "promotion_type": "FREE_CREDIT",
    "bonus_thb": "50.00",
    "wager_required_thb": "250.00",
    "wager_completed_thb": "120.00",
    "withdraw_cap_thb": "500.00",
    "granted_at": "2026-07-05T04:12:30.000Z",
    "expires_at": "2026-07-06T04:12:30.000Z"
  },
  "request_uuid": "b2e9a7d4-3c60-4f18-95ab-7d1c4e8f0a52"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
1001	UNAUTHORIZED	401	ไม่ได้รับอนุญาต
1007	TOKEN_INVALID	401	โทเค็นไม่ถูกต้อง