เคลมคอมมิชชั่น

ใช้งานได้

POST/api/v1/affiliate/claim

โอนยอดคอมมิชชั่นสะสมทั้งหมดเข้ากระเป๋าเงินของสมาชิกทันที (atomic) — ไม่ต้องส่ง body

ยอดที่เคลมเข้ากระเป๋าจะปรากฏในประวัติธุรกรรมเป็นรายการชนิด AFFILIATE

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

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
amount	string	—	ยอดคอมมิชชั่นที่โอนเข้ากระเป๋าครั้งนี้ (THB, string)
balance	string	—	ยอดคงเหลือกระเป๋าหลังโอนเข้า (THB, string)

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "amount": "245.75",
    "balance": "421.25"
  },
  "request_uuid": "f1d8b3c6-7e42-4a09-95bd-2c8e6f0a3d71"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
6101	AFFILIATE_NOTHING_TO_CLAIM	400	ไม่มียอดค่าคอมมิชชั่นให้เคลมยอดคอมมิชชั่นค้างเคลมเป็น 0
6102	AFFILIATE_BELOW_MIN_CLAIM	400	ยอดสะสมต่ำกว่าขั้นต่ำสำหรับการเคลมยอดสะสมยังไม่ถึงขั้นต่ำที่ agent กำหนดไว้
6103	AFFILIATE_NOT_ENABLED	400	ระบบแนะนำเพื่อนยังไม่เปิดใช้งานagent ปิดระบบแนะนำเพื่อนอยู่ หรือสมาชิกอยู่ใต้ agent โหมด SEAMLESS (ทั้งสองเคส enabled = false ในหน้า summary)
9002	SERVICE_UNAVAILABLE	503	บริการไม่พร้อมใช้งานระบบชำระเงินไม่พร้อมใช้งานชั่วคราว — ยอดสะสมยังอยู่ครบ ลองใหม่ภายหลัง
1001	UNAUTHORIZED	401	ไม่ได้รับอนุญาต
1007	TOKEN_INVALID	401	โทเค็นไม่ถูกต้อง