บันทึกการเปลี่ยนแปลง

ความเปลี่ยนแปลงของสัญญา API และเอกสาร — เรียงล่าสุดขึ้นก่อน

2026-08-02

Seamless: ถอด field `generation` ออกจาก /settle — ค่ายเกมต้นทางไม่ได้ส่ง field นี้มาให้เรา เราจึงไม่ส่งต่อเช่นกัน · รายการที่ตามหลัง /rollback ยังใช้ txn_id เดิมและยังต้อง apply เหมือนเดิม แต่ให้คุณนับจำนวน rollback ที่ได้รับเอง (ต่อ txn_id สำหรับ BY_TRANSACTION หรือต่อ round_id สำหรับ BY_ROUND) แล้วใส่ตัวนับนั้นใน idempotency key — คุณได้รับ /rollback ทุกใบเหมือนที่เราได้รับ · ดูขั้นตอนในหัวข้อ re-settle หลัง rollback หน้า Contract · ยังไม่มี SEAMLESS agent live จึงถอดออกตรง ๆ ได้

Seamless: เปลี่ยนชื่อ field ทั้งหมดบน wire จาก camelCase เป็น snake_case ให้ตรงกับ track transfer (txn_id, round_id, request_id, player_username, product_code, game_code, is_feature, bet_amount, payout_amount, single_state, ref_txn_id, skip_balance_update, is_feature_buy, play_info, balance_before, balance_after) — ครอบทั้ง request envelope, txns[] และ response ของ agent · ยังไม่มี SEAMLESS agent live (pre-prod) จึงเปลี่ยนตรง ๆ ได้ · อัปเดตครบทั้ง spec / guide / contract
Seamless: หน้า /bet เพิ่มตัวอย่าง request บิลกีฬา (WAITING → OPEN) และหน้า /settle เพิ่มตัวอย่าง single-state ให้เห็น field เคสพิเศษครบในตัวอย่าง

เพิ่ม POST /auth/change-password — สมาชิกที่ login อยู่เปลี่ยนรหัสผ่านเองได้ (ยืนยันรหัสเดิมก่อน · session เดิมใช้ต่อได้ไม่ต้อง login ใหม่) · สมาชิกที่ลืมรหัสหรือถูกล็อกจน login ไม่ได้ ให้ติดต่อ agent รีเซ็ตผ่าน backoffice (ไม่มี OTP reset)

Seamless: เพิ่มหัวข้อ flow กีฬา (บิลที่ยืนยันแล้วถูก relay มาที่ /bet ซ้ำด้วย txn_id เดิม — dedupe แล้วตอบ code 0 ห้ามหักซ้ำ) · settle ที่ส่งซ้ำหลัง rollback แนบ field ใหม่ generation (จำนวนครั้งที่ถูก rollback, แนะนำ idempotency key (txn_id, generation ?? 0) — backward compatible) · ระบุชัด: retry ครบ 3 ครั้งแล้วไม่มี re-delivery แบบ async การกู้คืนอาศัยการส่งซ้ำจากค่ายเกมต้นทางเท่านั้น
Transfer: ระบุพฤติกรรมสมาชิกใต้ agent โหมด SEAMLESS (กระเป๋าเงินอยู่ฝั่ง agent) — ฝาก/ถอนตอบ 1002 FORBIDDEN · affiliate summary ได้ enabled = false และ claim ตอบ 6103
หน้า Business codes แสดงกลุ่มร้านเพชร (6221-6223) และเปิดการ์ดรายวัน (6231-6233) ที่ตกหล่นจากหน้า — ลิงก์จากผลค้นหาไปรหัสกลุ่มนี้ใช้งานได้แล้ว

เพิ่ม 4 endpoints: ร้านเพชร (GET /diamond/shop, POST /diamond/redeem) และเปิดการ์ดรายวัน (GET /card, POST /card/flip) พร้อมรหัส 6221-6223 และ 6231-6233 ใน catalog

จัดโครงคู่มือใหม่ให้อ่านง่ายขึ้น — ยุบหน้า guide จาก 11 เหลือ 6 เรียงตาม flow การใช้งาน: ฝั่ง Transfer รวมเรื่อง auth (S2S + member token) ไว้หน้าเดียว และรวมพื้นฐาน request/response ไว้ในหน้า Conventions · ฝั่ง Seamless รวม request envelope + response + กติกาไว้ในหน้า Contract เดียว · เกลาภาษาไทยทั้งเว็บถึงระดับคำอธิบายแต่ละ field

เพิ่มระบบค้นหา (ปุ่มบน header หรือกด ⌘K/Ctrl+K) — ค้นชื่อ/path ของ endpoint, หัวข้อในคู่มือ และรหัส error (พิมพ์เลขเช่น 1019 แล้วกระโดดไปแถวนั้นได้เลย) รองรับค้นข้ามภาษา

สัญญา Seamless Wallet ยืนยันตรงกับ implementation จริงแล้ว (ไม่ใช่ draft) — ระบุชัดเพิ่ม: `/refund` และ `/adjust` แนบ ref_txn_id เชิงข้อมูล (nullable), `/void` แนบ bet_amount/payout_amount ให้ verify, retry ของ best-system = ส่งรวมสูงสุด 3 ครั้ง (นับครั้งแรกด้วย)

Rate limit บังคับใช้ตรงตามตาราง — เพดาน 600/นาที นับรวมทุก endpoint ของ key เดียวกัน (เดิมโค้ดนับแยกต่อ endpoint ซึ่งหลวมกว่าที่ระบุ) และ login นับทั้ง bucket รวมและ bucket auth · IP allowlist จับคู่ทน IP รูป v4-mapped (::ffff:x.y.z.w) และ IPv6 ต่างตัวพิมพ์แล้ว
เพดาน rate limit เป็นค่ากลางของระบบ — ปริมาณใช้งานจริงเกินเพดาน ติดต่อผู้ให้บริการ (ตัดหมายเหตุ "ปรับรายลูกค้าใน phase ถัดไป" ออก)

ชั้น S2S credential เปิดใช้งานจริง — ทุก request ที่แนบ X-Api-Key ถูก verify ด้วย S2S signature (รหัส 1018-1023 ใช้งานแล้ว) · agent เปิดช่องทางเองได้ที่หน้า bo Api Management → API Credential (toggle External Site + IP allowlist + key rotation แบบ grace window)

เปิดตัวเอกสารเวอร์ชันแรก — Transfer API ครบ 33 endpoints + Seamless Wallet API ครบ 10 endpoints + ตาราง error codes ทั้งสองชุด
เพิ่มสัญญาชั้น S2S credential (X-Api-Key + X-Signature) — จองรหัส 1018-1023