ภาพรวม
Neo API คืออะไร ?
Neo API คือ Super API ที่รวมเส้น API จากกว่า 80+ ผู้ให้บริการเกม ไว้ ทำให้คุณสามารถเชื่อมต่อค่ายเกมทั้งหมดเข้าระบบของคุณได้ด้วย API เพียงเส้นเดียว
การเชื่อมต่อ
Neo API รองรับการเชื่อมต่อ 2 ประเภท: ดูรายละเอียดการเชื่อมต่อ API
1. Seamless (Single Wallet)
ในรูปแบบ Seamless ผู้ให้บริการเกมจะไม่ถือเงินผู้เล่นไว้เอง (หรืออย่างมากมีการถือครองเพียงชั่วคราว) ทุกธุรกรรมเดิมพัน/ชนะจะมีการ callback ผ่าน API กับคุณโดยตรง ทุก callback ต้อง implement แบบ transactional และ idempotent (กันการหักเงินซ้ำ)
- UX ดีที่สุด: ผู้เล่นเห็นยอดเงินกลางเดียว ไม่มีขั้นตอนโยกเงินข้ามระบบ
- ลดปัญหาเงินค้าง/เงินสูญหาย
- ระบบของคุณต้องรองรับ API ที่ถูกเรียกถี่มาก (high QPS) และตอบกลับเร็ว
- ความผิดพลาดต้องมีการจัดการซับซ้อนกว่า (กัน duplicate และ replay)
- คุณเป็น "Source of Truth" ต้องมี audit log และ replay protection ที่ดี
- ผู้ที่มีระบบเสถียรมั่นคง
- ต้องการให้ผู้เล่นเปลี่ยนเกม/ค่ายได้ทันทีไม่ต้องโยก
- พร้อม implement idempotency key, ledger, audit ครบถ้วน
2. Transfer (Two Wallet)
ในรูปแบบ Transfer ฝั่งผู้ให้บริการเกมจะสร้าง "กระเป๋าเงินฝั่ง provider" ให้ผู้เล่นหนึ่งใบ เวลาจะเข้าไปเล่น ต้องโยกเงินไปยังมายังกระเป๋านี้ก่อน (transfer-in) และเมื่อจบ session หรือออกจากเกม ต้องโยกเงินกลับ (transfer-out) โดยระหว่างผู้เล่นกำลังเล่นเกม provider จะตัดสินใจดำเนินเกมและ settlement เอง ไม่มี callback กลับมาหาคุณทุกตาเหมือนการเชื่อมต่อแบบ seamless
- ระบบคุณรับ API load แค่ตอน transfer ไม่ต้องรองรับการถูกเรียกสูงในขณะที่ผู้เล่นกำลังเล่นเกมแบบ per-bet
- Provider รับผิดชอบการ settle bet ภายใน
- เริ่มต้นได้ง่ายกว่า seamless
- UX อาจแย่กว่า ผู้เล่นจะเห็นยอดแยก หรือเงินโยกช้า ติดค้างได้
- เงินอาจค้างอยู่หาก session ค้างหรือ error
- ผู้เริ่มต้นพัฒนาระบบ
- ระบบที่ไม่ต้องการรับโหลด API การเล่นแบบ real-time
เครดิต
Neo API ใช้ระบบเครดิตสำหรับควบคุมการใช้งาน เครดิตนับจากยอด Win/Loss (ผลรวมการชนะ/แพ้) ของผู้เล่นภายใต้การเชื่อมต่อกับยูสเซอร์ของคุณ
กรุณาติดต่อหัวสายของคุณหากต้องการเครดิตเพิ่มเติม

การตั้ง RTP
Neo API รองรับ 30+ ค่ายเกมปรับแตก ที่สามารถตั้ง RTP (Return to Player) ได้ ซึ่งช่วยให้คุณสามารถควบคุมอัตราการจ่ายเงินรางวัลได้ตามต้องการ สามารถตั้ง RTP รวมทุกค่ายหรือแยกตามค่ายได้ผ่านหน้า UI และสามารถตั้ง RTP อย่างละเอียดตามผู้เล่นแบบ real-time ได้ผ่าน API
ฝั่ง API ตั้งได้ 2 แบบ: ส่งฟิลด์ rtp ไปกับ init-session เพื่อกำหนดเฉพาะ session นั้น หรือเรียก set-rtp เพื่อตั้งค่าค้างไว้ให้ทั้งค่าย ไม่ต้องส่งซ้ำทุกครั้งที่เปิดเกม (ดูรายละเอียดในหัวข้อ 5.2 ของการเชื่อมต่อ API)

การเปิดสายต่อ
สร้างลูกสาย
คุณสามารถสร้างบัญชี Subagent (ลูกสาย) ได้ ซึ่งลูกสายของคุณสามารถจัดการลูกสายชั้นต่อไปได้เช่นกัน โดยคุณในฐานะหัวสายจะสามารถจัดการดูแลลูกสายภายใต้คุณทั้งหมดได้
ข้อมูลที่ต้องกรอกเมื่อสร้าง Subagent:
- Username: ชื่อผู้ใช้งานของ Subagent
- Password: รหัสผ่านสำหรับ Subagent
- Callback Type: เลือกประเภทการเชื่อมต่อ (Seamless หรือ Transfer)
- Callback URL: URL สำหรับรับ callback (กรณี Seamless) สามารถปล่อยว่างไว้ก่อนได้
- เครดิต: จำนวนเครดิตที่ต้องการกำหนดให้ Subagent
- Provider Rates: อัตราค่าคอมมิชชั่นสำหรับแต่ละค่ายเกม

ดูการใช้งานภายใต้สายของคุณ
คุณสามารถดูการใช้งานของ Subagent ทั้งหมดได้ผ่าน Dashboard เพื่อติดตามสถิติและข้อมูลต่างๆ เช่น:
- รายชื่อ Subagent: ดูรายชื่อ Subagent ทั้งหมดที่คุณสร้างไว้
- เครดิตคงเหลือ: ดูเครดิตที่ใช้แล้วและคงเหลือของแต่ละ Subagent
- ยอดการทำธุรกรรม: ดูยอดเดิมพัน ยอดชนะ/แพ้ ของแต่ละ Subagent
- สถิติตามช่วงเวลา: ดูสถิติการใช้งานตามวันที่กำหนด
- Hierarchy Level: ดูระดับลำดับชั้นของ Subagent ในระบบ
คุณสามารถคลิกเข้าไปดูรายละเอียดของ Subagent แต่ละรายได้ เพื่อดูข้อมูลเพิ่มเติมและจัดการ Subagent ได้

การเชื่อมต่อ API
Transfer Integration
การเชื่อมต่อแบบ Transfer เป็นระบบที่มี "ผู้เล่น (User)" และ "ยอดเงิน (Balance)" เพื่อให้ลูกค้า/พาร์ทเนอร์สามารถสร้างผู้เล่น เติมเงิน ถอนเงิน เช็คยอด และดูประวัติธุรกรรมได้
หมายเหตุสำคัญ:
usernameต้องเป็นค่า unique ต่อ agent (ห้ามซ้ำ)amount/initialBalanceเป็นตัวเลข และ ต้องไม่ติดลบ- เวลาในระบบใช้รูปแบบ ISO 8601 เช่น 2026-01-04T08:34:02.060Z
Authentication
ในทุกการสื่อสารระหว่าง Agent และ Neo API ในทุก request จะต้องมีการแนบ Private Key มาใน Header ใน field Authorization เพื่อใช้ยืนยันตัวตน
เข้าไปที่หน้า บัญชีของฉัน เพื่อดูและคัดลอก Private Key ของคุณ

หมายเหตุ:
- Private Key จะใช้ในการยืนยันตัวตนเมื่อส่ง request ไปยัง Neo API
- โปรดเก็บ Private Key ไว้เป็นความลับและไม่ควรเปิดเผยให้ผู้อื่นทราบ
- หาก Private Key ถูกเปิดเผย กรุณา Reset Private Key ทันทีเพื่อความปลอดภัย
Authentication Errors:
Missing Authorization Header / Invalid Private Key
1{
2 "error": "UNAUTHORIZED",
3 "message": "INVALID_PRIVATE_KEY"
4}1. สร้างผู้ใช้ (Create User)
สร้างผู้เล่นใหม่ในระบบ พร้อมกำหนดยอดเริ่มต้นได้ (optional)
Request:
1POST /api/external-transfer/create-user
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string",
7 "initialBalance": 0
8}คำอธิบาย Request Body:
username(required): ชื่อผู้เล่นinitialBalance(optional): ยอดเงินตั้งต้น (ถ้าไม่ส่งมาให้ถือว่า 0)
Response:
1{
2 "id": "string",
3 "username": "string",
4 "agentId": "string",
5 "balance": 0,
6 "createdAt": "2026-01-04T08:34:02.060Z"
7}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/create-user \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "initialBalance": 0
7 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/create-user \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "initialBalance": 0
7 }'2. เติมเงิน (Transfer In)
เติมเงินให้ผู้เล่น (เพิ่มยอดเงิน)
หมายเหตุ:
เดิมผู้เล่นมีเงินในระบบ 100 บาท หากต้องการเพิ่มอีก 50 บาท สามารถส่งค่า 50 มา ระบบจะเพิ่มยอดจากเดิม 100 เป็น 150 บาท
Request:
1POST /api/external-transfer/transfer-in
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string",
7 "amount": 0
8}คำอธิบาย Request Body:
username(required): ชื่อผู้เล่นamount(required): จำนวนเงินที่ต้องการเติม (ต้องมากกว่า 0)
Response:
1{
2 "id": "string",
3 "agentId": "string",
4 "agentUserId": "string",
5 "transferAmount": 0,
6 "transferType": "IN",
7 "balanceBefore": 0,
8 "balanceAfter": 0,
9 "createdAt": "2026-01-04T08:34:27.438Z"
10}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/transfer-in \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/transfer-in \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'3. ถอนเงิน (Transfer Out)
ถอน/โยกเงินออกจากผู้เล่น (ลดยอดเงิน)
หมายเหตุ:
เดิมผู้เล่นมีเงินในระบบ 100 บาท หากต้องการโยกเงินออก 50 บาท สามารถส่งค่า 50 มา ระบบจะลดยอดจากเดิม 100 เหลือ 50 บาท
Request:
1POST /api/external-transfer/transfer-out
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string",
7 "amount": 0
8}คำอธิบาย Request Body:
username(required): ชื่อผู้เล่นamount(required): จำนวนเงินที่ต้องการถอน (ต้องมากกว่า 0)
Response:
1{
2 "id": "string",
3 "agentId": "string",
4 "agentUserId": "string",
5 "transferAmount": 0,
6 "transferType": "OUT",
7 "balanceBefore": 0,
8 "balanceAfter": 0,
9 "createdAt": "2026-01-04T08:34:27.438Z"
10}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/transfer-out \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/transfer-out \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'4. เช็คยอดเงิน (Get Balance)
ดึงยอดเงินปัจจุบันของผู้เล่น
Request:
1POST /api/external-transfer/get-balance
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string"
7}Response:
1{
2 "username": "string",
3 "balance": 0
4}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/get-balance \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string"
6 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/get-balance \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string"
6 }'5. ตั้งยอดเงิน (Set Balance)
ตั้งยอดเงินของผู้เล่นเป็นค่าที่ต้องการโดยตรง (แทนการใช้ transfer-in/out) เหมาะสำหรับการ sync ยอดเงินให้ตรงกับระบบภายนอก
หมายเหตุ:
เดิมผู้เล่นมีเงินในระบบ 100 บาท หากต้องการตั้งยอดเงินในระบบเป็น 150 บาท สามารถส่งค่า 150 มา ระบบจะตั้งยอดเงินผู้เล่นเป็น 150 บาท
Request:
1POST /api/external-transfer/set-balance
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string",
7 "amount": 0
8}คำอธิบาย Request Body:
username(required): ชื่อผู้เล่นamount(required): ยอดเงิน "สุดท้าย" ที่ต้องการให้เป็น
Response:
1{
2 "id": "string",
3 "agentId": "string",
4 "agentUserId": "string",
5 "transferAmount": 0,
6 "transferType": "IN",
7 "balanceBefore": 0,
8 "balanceAfter": 0,
9 "createdAt": "2026-01-04T08:34:27.438Z"
10}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/set-balance \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/set-balance \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "amount": 0
7 }'6. ดึงประวัติธุรกรรม (Get Transfer History)
ดึงประวัติธุรกรรมเติม/ถอน/ปรับยอด ของผู้เล่นแบบแบ่งหน้า (pagination)
Request:
1POST /api/external-transfer/get-transfer-history
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "username": "string",
7 "startDate": "2026-01-04T08:36:37.138Z",
8 "endDate": "2026-01-04T08:36:37.138Z",
9 "page": 1,
10 "limit": 20
11}คำอธิบาย Request Body:
username(required): ชื่อผู้เล่นstartDate(required): เวลาเริ่มต้น (ISO 8601)endDate(required): เวลาสิ้นสุด (ISO 8601)page(required): หน้าเริ่มที่ 1limit(required): จำนวนรายการต่อหน้า
Response:
1{
2 "transactions": [
3 {
4 "id": "string",
5 "agentId": "string",
6 "agentUserId": "string",
7 "transferAmount": 0,
8 "transferType": "IN",
9 "balanceBefore": 0,
10 "balanceAfter": 0,
11 "createdAt": "2026-01-04T08:36:37.138Z"
12 }
13 ],
14 "total": 0,
15 "page": 0,
16 "limit": 0
17}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external-transfer/get-transfer-history \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "startDate": "2026-01-04T08:36:37.138Z",
7 "endDate": "2026-01-04T08:36:37.138Z",
8 "page": 1,
9 "limit": 20
10 }'1curl -X POST https://api.neoapihub.com/api/external-transfer/get-transfer-history \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "username": "string",
6 "startDate": "2026-01-04T08:36:37.138Z",
7 "endDate": "2026-01-04T08:36:37.138Z",
8 "page": 1,
9 "limit": 20
10 }'7. การดึงรายการเกม
เป็น Endpoint ที่ Agent จะยิงไปยัง Neo API เพื่อขอรายชื่อเกมทั้งหมดหรือตาม provider ที่ระบุเพื่อนำ gameId ไปใช้ต่อในการสร้าง Session ให้กับผู้เล่น
📢 ประกาศ (ก.ค. 2026): ค่าย Plus อัปเดต providerId / gameId ใหม่
- ค่าย JILI_plus, SA_plus, NOLIMITCITY_plus, EVOPLAY_plus และ FACHAI_plus ย้ายขึ้นระบบใหม่ — ชื่อค่ายเหมือนเดิม แต่ providerId และ gameId เปลี่ยนใหม่ทั้งหมด พร้อมค่ายใหม่ SEXY_plus
- กรุณายิง get-games เพื่อ sync รายการเกมรอบใหม่ แล้วอัปเดต gameId / providerId ที่บันทึกไว้ในระบบของคุณ
- gameId ชุดเดิมยังเปิดเกมได้ชั่วคราวในช่วงเปลี่ยนผ่านเท่านั้น และจะถูกปิดการใช้งานในลำดับถัดไป — แนะนำให้ sync ใหม่ทันที
Request:
1POST /api/external/get-games
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "agentId": "string",
7 "providerList": ["string"] // optional
8}คำอธิบาย Request Body:
agentId: ID ของ AgentproviderList: รายชื่อ Provider ID ที่ต้องการ (optional, ถ้าไม่ระบุจะได้ทั้งหมด)
Response:
1{
2 "providers": [
3 {
4 "provider": {
5 "id": "string",
6 "name": "string",
7 "isRedirect": true,
8 "logoUrl": "string" // optional
9 },
10 "games": [
11 {
12 "id": "string",
13 "name": "string",
14 "code": "string",
15 "imageUrl": "string",
16 "type": "slot" | "casino" | "table" | "fishing" | "lottery" | "virtual" | "sports",
17 "tag": "string", // optional
18 "order": 0, // optional
19 "isRecommend": true,
20 "isNew": false,
21 "providerId": "string",
22 "mappedGameCode": "string" // optional
23 }
24 ]
25 }
26 ]
27}ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external/get-games \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "agentId": "string",
6 "providerList": ["string"]
7 }'8. การสร้าง Session
เป็น Endpoint ที่ Agent จะยิงไปยัง Neo API เพื่อขอ URL สำหรับ redirect เริ่มเกมให้กับผู้เล่น
หมายเหตุ:
- สำหรับ Agent ที่มีหลายเว็บไซต์แนะนำให้ใช้ username ตามด้วยชื่อเว็บไซต์เพื่อป้องกันชื่อ username ซ้ำ
- ต้องแนบ Private Key มาใน Authorization ใน Header
Request:
1POST /api/external/init-session
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "gameId": "string",
7 "username": "string",
8 "hrefBackUrl": "string",
9 "agentId": "string",
10 "language": "en" | "cn" | "jp" | "th" | "vn" | "kr",
11 "isDesktop": true, // optional, default: true
12 "rtp": number, // optional, 30-99 (default: 97)
13 "clientIp": "string", // required for PG games
14}คำอธิบาย Request Body:
gameId: ID ของเกมที่ต้องการเล่นusername: ชื่อผู้ใช้งานhrefBackUrl: URL สำหรับกลับเมื่อออกจากเกมagentId: ID ของ Agentlanguage: ภาษาที่ต้องการ (en, cn, jp, th, vn, kr) default: thisDesktop: ระบุว่าเป็น Desktop หรือไม่ (optional, default: true)rtp: ระบุค่า RTP ของเกม (optional, 30-99, default: 97)clientIp: IP ของผู้เล่น (จำเป็นสำหรับค่าย PG — ถ้าไม่ส่ง init-session จะตอบ 400 และเปิดเกมไม่ได้ ส่วนค่ายอื่นไม่ใช้ค่านี้)
Response:
1{
2 "url": "string", // optional
3 "html": "string", // optional
4 "type": "url" | "html" | "redirect"
5}คำอธิบาย Response Body:
url: URL สำหรับเปิดเกม (optional, จะมีเมื่อ type = "url" หรือ "redirect")html: HTML code สำหรับเปิดเกม (optional, จะมีเมื่อ type = "html")type: ประเภทของ response ("url", "html" หรือ "redirect")
ตัวอย่างโค้ด:
1curl -X POST https://api.neoapihub.com/api/external/init-session \
2 -H "Authorization: YOUR_PRIVATE_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "gameId": "string",
6 "username": "string",
7 "hrefBackUrl": "string",
8 "agentId": "string",
9 "language": "th",
10 "isDesktop": true,
11 "rtp": 97,
12 "clientIp": "203.0.113.42"
13 }'การจัดการ Response:
- เมื่อยิง request
/api/external/init-sessionมา จะได้ response กลับไปโดยเราจะต้องดูจากtypeก่อนว่าเป็นurlหรือhtml - ถ้าเป็น URL (type = "url") หรือ REDIRECT (type = "redirect") ให้ใช้
urlที่ได้รับมาเพื่อเปิดหน้าเข้าเล่นเกมให้กับผู้เล่นใน Tab ใหม่ (โดยเฉพาะ type = "redirect" เช่น HuayDragon ที่ไม่รองรับ iframe — ต้องเปิดใน Tab ใหม่เท่านั้น ห้ามฝังใน iframe) - ถ้าเป็น HTML (type = "html") ต้องเขียนให้เว็บปรับ HTML จาก
htmlเพื่อเปิดให้ผู้เล่น
9. การเช็คเครดิตของ Subagent
เป็น Endpoint สำหรับตรวจสอบภาพรวมเครดิตของหัวสาย และดูรายละเอียดเครดิตของ Subagent ภายใต้สายทั้งหมดในครั้งเดียว เหมาะสำหรับใช้ทำหน้า Dashboard หรือหน้า Monitoring เครดิต
Request:
1POST /api/external/get-sub-agent-quota-summary
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "agentId": "string"
7}คำอธิบาย Request Body:
agentId(required): Agent ID ของหัวสายที่ต้องการตรวจสอบเครดิต
Response:
1{
2 "winningQuota": 100000,
3 "winningQuotaUsed": 25000,
4 "subagents": [
5 {
6 "username": "subagent01",
7 "winningQuota": 30000,
8 "winningQuotaUsed": 5000
9 }
10 ]
11}คำอธิบาย Response:
winningQuota: เครดิตทั้งหมดของหัวสายwinningQuotaUsed: เครดิตที่ใช้งานไปแล้วของหัวสายsubagents: รายการเครดิตของ Subagent ภายใต้สาย
10. ดูประวัติแทงหวยของผู้เล่น
เป็น Endpoint สำหรับดึงประวัติการแทงหวยของผู้เล่นรายคน โดยรองรับ Pagination และการกรองสถานะรายการ เพื่อใช้ทำหน้าประวัติย้อนหลังของผู้เล่น
Request:
1POST /api/external/get-poy-group-history-by-user
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "agentId": "string",
7 "userId": "string",
8 "poyGroupStatusList": ["WIN", "LOSE"], // optional
9 "skip": 0, // optional (default: 0)
10 "take": 10 // optional (default: 10)
11}คำอธิบาย Request Body:
agentId(required): Agent ID ของสายที่เป็นเจ้าของผู้เล่นuserId(required): Username ของผู้เล่นฝั่ง AgentpoyGroupStatusList(optional): กรองตามสถานะ เช่น WIN, LOSE, SETTLED, PENDING, FAILED, CANCELLED, REFUNDskip(optional): จำนวนรายการที่ข้ามtake(optional): จำนวนรายการที่ต้องการต่อหน้า
ความหมายของสถานะ (PoyGroupStatus):
PENDING: รับบิลแล้ว รอประมวลผลSETTLED: จ่ายเงินสำเร็จFAILED: จ่ายเงินไม่สำเร็จWIN: ปิดรอบแล้วผลเป็นชนะLOSE: ปิดรอบแล้วผลเป็นแพ้CANCELLED: รายการถูกยกเลิกREFUND: ยกเลิกสำเร็จและคืนเงินสำเร็จ (callback cancel สำเร็จ)
Response:
1{ "total": 120, "take": 10, "skip": 0, "data": [ { "id": "string", "roundStartDate": "2026-03-12T08:00:00.000Z", "roundEndDate": "2026-03-12T09:00:00.000Z", "gameName": "หวยไทยรัฐบาล", "gameCode": "THAI_GOV", "totalAmount": 1000, "totalPayoff": 1500, "userId": "player123", "status": "WIN", "createdAt": "2026-03-12T08:10:00.000Z", "updatedAt": "2026-03-12T09:05:00.000Z", "poys": [ { "id": "string", "userId": "player123", "multiple": 1, "poyType": "THREE_UP", "poyNumber": "123", "amount": 100, "payoff": 900, "rate": 9, "status": "SUCCESS", "createdAt": "2026-03-12T08:11:00.000Z", "updatedAt": "2026-03-12T09:05:00.000Z", "subPoys": [ { "id": "string", "poyType": "TWO_UP", "poyNumber": "12", "amount": 50, "payoff": 0, "multiplier": 1, "status": "FAILED", "createdAt": "2026-03-12T08:11:00.000Z", "updatedAt": "2026-03-12T09:05:00.000Z" } ] } ] } ] }คำอธิบาย Response:
ระดับ root ( GetPoyGroupHistoryByUserResponse )
data: รายการชุดบิล (PoyGroupHistoryItem[]) ของ user ตาม filter และ paginationtotal: จำนวนชุดบิลทั้งหมดที่ตรงเงื่อนไข (ก่อน skip/take)skip: จำนวนที่ข้าม (offset ของ pagination)take: จำนวนที่ขอต่อหน้า (limit ของ pagination)
ระดับชุดบิล ( PoyGroupHistoryItem )
id: รหัสธุรกรรมของชุดบิล (ใช้สำหรับอ้างอิง/ยืนยันกับ operator)roundStartDate: วันเวลาเริ่มรอบroundEndDate: วันเวลาปิดรอบgameName: ชื่อเกม (บางประเภทอาจต่อท้ายด้วย " ชุด")gameCode: รหัสเกมtotalAmount: ยอดรวมที่ user เดิมพันในชุดบิลนี้totalPayoff: ยอดรวมที่จ่าย/คืนให้ user ในชุดบิลนี้userId: รหัส user ที่เดิมพันstatus: สถานะชุดบิล (เช่นPENDING,SETTLED,WIN,LOSE,FAILED,CANCELLED,REFUND)createdAt: วันเวลาที่สร้างชุดบิลupdatedAt: วันเวลาที่อัปเดตล่าสุดpoys: รายการบิลย่อย (PoyHistoryItem[]) ในชุดบิลนี้
ระดับบิล ( PoyHistoryItem )
id: รหัสบิลย่อยuserId: รหัส usermultiple: ตัวคูณ (จำนวนเท่าของเงินเดิมพันต่อชุด)poyType: ประเภทเลข/รูปแบบ (เช่น TWO_UP, THREE_DOWN, SET_FOUR)poyNumber: เลขที่แทง (string)amount: เงินเดิมพันของบิลนี้payoff: เงินที่จ่าย/คืนของบิลนี้rate: อัตราที่ใช้คำนวณstatus: สถานะบิลย่อยcreatedAt: วันเวลาที่สร้างบิลupdatedAt: วันเวลาที่อัปเดตล่าสุดsubPoys: บิลย่อยระดับล่าง (มีในบางกรณี เช่น เกมแบบชุด)
ระดับ subPoy ( SubPoyHistoryItem )
id: รหัส SubPoypoyType: ประเภทเลขของชุดย่อยpoyNumber: เลขที่แทงของชุดย่อยamount: จำนวนเงินที่อ้างถึงของชุดย่อยpayoff: เงินที่จ่ายของชุดย่อยmultiplier: ตัวคูณรางวัลของชุดย่อยstatus: สถานะของชุดย่อยcreatedAt: วันเวลาที่สร้างupdatedAt: วันเวลาที่อัปเดตล่าสุด
data) + pagination ( total , skip, take) และในแต่ละชุดบิลจะมี poys โดยบางประเภทจะมี subPoys อีกชั้น11. ดึงประวัติธุรกรรมรายผู้เล่น
เป็น Endpoint สำหรับดึงประวัติธุรกรรมเกม (เดิมพัน / เคลียร์ผล / ยกเลิก) ของผู้เล่นในสายของคุณ รองรับการกรองตามชื่อผู้เล่นและช่วงเวลา พร้อม Pagination เหมาะสำหรับทำหน้าประวัติย้อนหลังหรือตรวจสอบยอดเดิมพัน / ยอดได้เสียของผู้เล่น
Request:
1POST /api/external/get-transaction-by-username
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "agentId": "string",
7 "username": "player123", // optional
8 "startDate": "2026-06-01T00:00:00.000Z", // optional
9 "endDate": "2026-06-19T23:59:59.999Z", // optional
10 "skip": 0, // optional (default: 0)
11 "take": 10 // optional (default: 10)
12}คำอธิบาย Request Body:
agentId(required): Agent ID ของคุณ (เจ้าของ private key)username(optional): ชื่อผู้เล่นฝั่ง Agent — ถ้าไม่ส่ง จะดึงรายการของทุกผู้เล่นในสายของคุณstartDate(optional): เวลาเริ่มต้น (ISO 8601)endDate(optional): เวลาสิ้นสุด (ISO 8601)skip(optional): จำนวนรายการที่ข้าม (default: 0)take(optional): จำนวนรายการที่ต้องการต่อหน้า (default: 10)
Response:
1{
2 "total": 2,
3 "take": 10,
4 "skip": 0,
5 "data": [
6 {
7 "id": "string",
8 "providerTransactionId": "string",
9 "usernamePlayer": "player123",
10 "betAmount": 100,
11 "settleAmount": 0,
12 "turnOver": 100,
13 "transferIn": 0,
14 "transferOut": 100,
15 "gameType": "SLOT",
16 "status": "SUCCESS",
17 "gameId": "string",
18 "agentId": "string",
19 "createdAt": "2026-06-19T08:10:00.000Z",
20 "updatedAt": "2026-06-19T08:10:05.000Z",
21 "isBuyFeature": true,
22 "isFreeSpin": false,
23 "game": {
24 "id": "string",
25 "name": "Fortune Gems",
26 "code": "JILI_FG",
27 "providerId": "string",
28 "providerName": "JILI_plus"
29 }
30 }
31 ]
32}คำอธิบาย Response:
dataรายการธุรกรรมของผู้เล่นตาม filter และ paginationtotalจำนวนรายการในหน้านี้skip/take: ค่า pagination ที่ส่งมา (offset / limit)betAmountยอดเดิมพันsettleAmountยอดที่จ่ายคืน (ผลได้เสีย)turnOverยอด Turnover ของรายการisBuyFeature: เป็นtrueเมื่อรายการนั้นผู้เล่นกดซื้อฟีเจอร์ (Buy Feature)isFreeSpin: เป็นtrueเมื่อรายการนั้นเป็นการหมุนที่ผู้เล่นไม่ได้จ่ายเงินเพิ่ม — ครอบคลุมทั้ง Free Spin ในเกม, Re-spin และรอบที่ต่อเนื่องมาจากการเดิมพันครั้งก่อน ซึ่งเป็นเหตุผลที่รายการเหล่านี้มักมีbetAmountเป็น 0 แต่มียอดจ่ายออก- ทั้งสองฟิลด์เป็น null เมื่อค่ายนั้นไม่ได้ส่งข้อมูลนี้มาให้ — ซึ่งไม่ได้แปลว่าผู้เล่นไม่ได้ซื้อฟีเจอร์หรือไม่ใช่ free spin แต่แปลว่าค่ายนั้นไม่ได้บอกเรามา จึงไม่ควรนับ
nullเป็นfalseตอนทำรายงาน · ดูรายชื่อค่ายที่ส่งและไม่ส่งได้ที่ตารางด้านล่าง status: สถานะรายการ (PENDING,SUCCESS,FAILED)game: ข้อมูลเกม เช่นname,code,providerName(ชื่อค่ายเกม)
isBuyFeature กับ isFreeSpin ต่างกันยังไง
isBuyFeature = รอบนี้มาจากฟีเจอร์ที่ผู้เล่นจ่ายเงินก้อนซื้อเข้ามาเลย ไม่ได้รอหมุนให้ติดเอง ราคาซื้อมักอยู่ราว 100 เท่าของเงินเดิมพันปกติ รอบที่จ่ายเงินซื้อจึงมี betAmount สูงผิดปกติเมื่อเทียบกับรอบอื่นของผู้เล่นคนเดียวกัน
isFreeSpin = รอบที่ผู้เล่นไม่ได้จ่ายเงินเพิ่ม เป็นผลต่อเนื่องมาจากรอบก่อนหน้า ครอบคลุมทั้ง Free Spin ในเกม, Re-spin และรอบที่ต่อเนื่องกัน รอบแบบนี้จึงมักมี betAmount เป็น 0 แต่มียอดจ่ายออก
ทั้งสองอย่างมักมาคู่กัน — ผู้เล่นซื้อฟีเจอร์หนึ่งรอบ (isBuyFeature) แล้วได้รอบฟรีตามมาอีกหลายรอบ (isFreeSpin) เวลาคิด turnover หรือยอดเดิมพันจริง ให้ระวังอย่านับรอบฟรีเป็นเงินที่ผู้เล่นจ่ายเพิ่ม
บางค่าย (เช่น PG และ AMB) ติด isBuyFeature ให้รอบฟรีที่ตามมาจากการซื้อด้วย รอบพวกนั้นจึงเป็น true ทั้งสองฟิลด์และมี betAmount เป็น 0 — ถ้าจะนับจำนวนครั้งที่ผู้เล่นซื้อฟีเจอร์ ให้นับเฉพาะรอบที่ isBuyFeature เป็น true แต่ isFreeSpin ไม่ใช่ true ไม่งั้นตัวเลขของ PG จะสูงเกินจริงราว 20 เท่า
⚠️ null ไม่ได้แปลว่า "ไม่ได้ซื้อ" หรือ "ไม่ใช่ free spin"
- null แปลว่าค่ายนั้นไม่ได้ส่งข้อมูลนี้มาให้เรา — เราจึงไม่รู้ว่ารอบนั้นผู้เล่นซื้อฟีเจอร์หรือเป็น free spin หรือเปล่า มีแต่ false เท่านั้นที่แปลว่าค่ายบอกมาว่า "ไม่ใช่"
- ใน callback เราส่ง field มาให้เฉพาะตอนเป็น true — ถ้าไม่มี field มา ให้ดูตารางด้านล่าง: ค่ายที่เป็น ✅ แปลว่าไม่ใช่ ส่วนค่ายที่เป็น ⚠️ หรือ ❌ แปลว่าไม่รู้
- อย่านับ null เป็น false ตอนทำรายงาน ไม่งั้นตัวเลขจะออกมาว่าแทบไม่มีใครซื้อฟีเจอร์เลย ซึ่งไม่ตรงกับความจริง
ค่ายไหนมี isBuyFeature / isFreeSpin บ้าง
| ค่าย | isBuyFeature | isFreeSpin |
|---|---|---|
| PG_plus, JILI_plus, JOKER_plus, NOLIMITCITY_plus, EVOPLAY_plus, FACHAI_plus | ✅ | ✅ |
| NEXTSPIN_plusค่ายใหม่ (ต.ค. 2026) ยังรอยืนยันจากรายการจริง | ⚠️ | ⚠️ |
| PG | ✅ | ✅ |
| AMB | ✅ | ✅ |
| 759GAMING, AFB1188_SLOT, AMBGAMING | ✅ | ✅ |
| JILI | ✅ | ❌ |
| PP | ✅ | ❌ |
| OCTOPLAYส่งมาเฉพาะรอบที่ซื้อฟีเจอร์ | ⚠️ | ❌ |
| CLOTPLAYส่งมาประมาณครึ่งหนึ่งของรายการ | ⚠️ | ❌ |
| BOOMING, YGR, I8 | ❌ | ✅ |
| JOKERส่งมาเฉพาะรอบที่ได้โบนัส | ❌ | ⚠️ |
| NEXTSPINส่งมาเฉพาะรอบที่เป็น free spin | ❌ | ⚠️ |
| BIGPOT, HOTDOG, FUNKYส่งมาประมาณครึ่งหนึ่งของรายการ | ❌ | ⚠️ |
| SA_plus, SEXY_plusคาสิโนสด ไม่มีฟีเจอร์นี้อยู่แล้ว | false เสมอ | false เสมอ |
✅ ส่งมาทุกรายการ · ⚠️ ส่งมาบางรายการ ถ้าไม่มีให้ถือว่าไม่รู้ ไม่ใช่ false · ❌ ไม่ส่ง เป็น null เสมอ
ค่ายอื่นทั้งหมดไม่มีทั้งสองอย่าง — เป็น null เสมอ
- ค่าย _plus ตัวอื่นทั้งหมดที่ไม่อยู่ในตาราง เช่น PRAGMATIC_plus, CQ9_plus, HABANERO_plus, HACKSAW_plus, JDB_plus, KA_plus, PLAYSON_plus, SPRIBE_plus, TADA_plus, 3OAKS_plus — กลุ่มนี้วิ่งอยู่คนละระบบกับ _plus ในตาราง แม้ชื่อจะลงท้ายด้วย _plus เหมือนกัน
- PNG, HAB, RLX, NE, RTG, WAZ, YGG, PRG, NLC, EVP และ FCG
- ค่ายสล็อตอื่น เช่น ROYAL, LIVE22, SLOTXO, RICH88, PRETTY, SPADE, KINGMAKER
- คาสิโนสด กีฬา และหวย (SA, SEXY, DG, WM, SBO, BTI, UFAPLUS, HIPPO, HUAYDRAGON, LEKTHONG) — ไม่มีคอนเซปต์ free spin / buy feature ตั้งแต่ต้น
ชื่อค่ายซ้ำกันได้ — JILI_plus กับ JILI, PG_plus กับ PG, NOLIMITCITY_plus กับ NLC, EVOPLAY_plus กับ EVP, NEXTSPIN_plus กับ NEXTSPIN เป็นคนละค่ายคนละระบบ และรองรับฟิลด์นี้ไม่เหมือนกัน เวลาทำรายงานให้ยึด providerId ไม่ใช่ชื่อค่าย
12. ดึงลิงก์ประวัติรายตา
เป็น Endpoint สำหรับขอลิงก์หน้าประวัติของการเดิมพัน "หนึ่งตา" เพื่อให้เปิดดูย้อนหลังได้ว่า ตานั้นเกิดอะไรขึ้น เช่น หน้า replay ของสล็อต ผลไพ่ของคาสิโนสด หรือสลิปการแทงของกีฬา — ส่ง id ของรายการที่ได้จากข้อ 11 เข้ามา ระบบจะคืนลิงก์ที่เปิดดูได้ทันที เหมาะสำหรับทำปุ่ม "ดูผลย้อนหลัง" ในหน้าประวัติของผู้เล่น หรือใช้ตรวจสอบเมื่อผู้เล่นทักมาสอบถาม ดูย้อนหลังได้ภายใน 7 วันนับจากเวลาที่เดิมพัน เกินจากนั้นค่ายไม่เก็บข้อมูลไว้ให้แล้ว
Request:
1POST /api/external/get-bet-detail-url
2Content-Type: application/json
3Authorization: YOUR_PRIVATE_KEY
4
5{
6 "agentId": "string",
7 "transactionId": "string", // optional
8 "providerTransactionId": "string", // optional
9 "lang": "th" // optional (default: en)
10}คำอธิบาย Request Body:
agentId(required): Agent ID ของคุณ (เจ้าของ private key)transactionId(optional): id ของรายการฝั่งเรา — คือค่าidที่ได้จากข้อ 11providerTransactionId(optional): id ของรายการฝั่งค่ายเกม — คือค่าproviderTransactionIdที่ได้จากข้อ 11 (id เดียวกับที่เห็นในหลังบ้านของค่าย)lang(optional): ภาษาของหน้าประวัติ รองรับthและen(default:en) — ค่ายที่ไม่รองรับการเลือกภาษาจะใช้ค่าตั้งต้นของค่ายเอง
transactionId หรือ providerTransactionId อย่างน้อยหนึ่งตัว (ถ้าส่งมาทั้งคู่ ระบบจะใช้ transactionId ก่อน)Response:
1{
2 "provider": "BTI",
3 "type": "url",
4 "url": "https://api.neoapihub.com/api/external/bet-detail-view?t=eyJhbGciOi...",
5 "expiresInSeconds": 900
6}คำอธิบาย Response:
providerค่ายเกมที่รายการนี้เกิดขึ้นtype: ปัจจุบันเป็นurlเสมอ ไม่ว่าปลายทางจะเป็นหน้าของค่ายเองหรือหน้าที่เราเตรียมไว้ให้ — ฝั่งคุณเปิดลิงก์ได้เลยโดยไม่ต้องแยกเคสurlลิงก์หน้าประวัติของตานั้น เปิดได้โดยไม่ต้องแนบ header ใด ๆ ส่งต่อให้ผู้เล่นเปิดดูได้ทันที — ส่วนใหญ่เป็นหน้าของค่ายเอง (อยู่บนโดเมนของค่าย) ค่ายที่ไม่มีหน้าให้ เราจะประกอบหน้าสรุปขึ้นมา แล้วคืนเป็นลิงก์บนโดเมนของเราแทนexpiresInSecondsอายุของลิงก์เป็นวินาที — มีมาเฉพาะลิงก์ที่เราประกอบหน้าให้เอง คือ900(15 นาที) ส่วนลิงก์ที่เป็นหน้าของค่ายจะไม่มีฟิลด์นี้ ให้ยึดตามกติกาของค่ายนั้น — ทั้งสองแบบขอลิงก์ใหม่ด้วย id เดิมได้ตลอด ไม่ต้องเก็บลิงก์เก่าไว้ใช้ซ้ำ
Error ที่อาจได้รับ:
BET_DETAIL_ID_REQUIRED(400): ไม่ได้ส่ง id มาสักตัวTRANSACTION_NOT_FOUND(404): ไม่พบรายการนี้BET_DETAIL_TOO_OLD(410): รายการเก่าเกินกว่าที่ค่ายเก็บไว้ (ตอบretentionDaysและroundAgeDaysมาด้วย)BET_DETAIL_NOT_SUPPORTED(400): ค่ายนี้ไม่มีหน้าประวัติรายตาให้ (ตอบreasonเป็นคำชี้แจงของค่ายมาด้วย)BET_DETAIL_UNAVAILABLE(503): ค่ายตอบไม่ได้ในขณะนั้น ลองใหม่อีกครั้งได้
ข้อจำกัดที่ควรทราบ:
- ย้อนหลังได้ 7 วัน — เป็นระยะเวลาที่เรารองรับตามค่ายที่เก็บข้อมูลสั้นที่สุด รายการที่เก่ากว่านั้นจะได้
BET_DETAIL_TOO_OLD(บางค่ายเก็บนานกว่านี้ แต่ไม่ควรออกแบบระบบโดยพึ่งพา) - ลิงก์มีอายุจำกัด ตามค่า
expiresInSeconds— ควรขอลิงก์ตอนที่ผู้เล่นกดดู ไม่ควรขอล่วงหน้าแล้วเก็บไว้ - ตาที่ยังไม่เคลียร์ผล จะได้หน้าสรุปที่มีสถานะ
IN_PLAYพร้อมยอดเดิมพันแทนหน้าประวัติเต็ม เพราะรายงานฝั่งค่ายจะเขียนเมื่อจบรอบ — เรียกใหม่อีกครั้งหลังรายการ settle - ค่ายส่วนใหญ่จำกัดความถี่ในการเรียก ไม่ควรยิงรัวเพื่อดึงหลายตาพร้อมกัน ให้เรียกตามที่ผู้เล่นกดดูจริง
- ลิงก์เปิดได้โดยไม่ต้องยืนยันตัวตน — ส่งให้ผู้เล่นเจ้าของรายการได้ แต่ไม่ควรนำไปวางในที่สาธารณะ เพราะเปิดดูตาของผู้เล่นคนนั้นได้จนกว่าจะหมดอายุ
รูปแบบ Error
INVALID_PRIVATE_KEY: แนบ private key ไม่ถูกต้องUSERNAME_ALREADY_EXISTS: username ซ้ำตอน create-userUSERNAME_NOT_FOUND: ไม่พบผู้เล่น จาก username ที่ส่งมาINSUFFICIENT_BALANCE: ถอนเงินเกินยอด
API เพิ่มเติม
Coming Soon
