neo.api

ปรับ RTP ค่าย _plus ผ่าน API ด้วย set-rtp และ init-session

อ่านแบบ Markdown

ค่ายที่ชื่อลงท้ายด้วย _plus คือค่ายปรับแตกที่ตั้ง RTP (Return to Player) ได้ ค่าย _plus ที่เป็นสล็อตตั้งผ่าน API ได้สองทาง คือส่ง rtp ไปกับ init-session เพื่อกำหนดเฉพาะ session นั้น หรือเรียก set-rtp เพื่อตั้งค่าค้างไว้ทั้งค่าย ส่วนค่าย _plus ที่เป็นคาสิโนสด เช่น SA_plus และ SEXY_plus ไม่มีการปรับ RTP ก่อนตั้งค่า ให้เช็ค canSetRtp และ canSetPreset ของแต่ละค่ายจาก get-sub-agent-providers

หน้าค่ายเกมในหลังบ้าน: ค่าย _plus ประเภทสล็อตตั้ง RTP ได้ทีละค่าย

ทุกเส้นในบทความนี้เป็น POST ที่ https://api.neoapihub.com และแนบ Private Key ใน header Authorization เหมือนเส้นอื่นของ Neo API ถ้ายังไม่ได้เชื่อม init-session เริ่มจาก เชื่อม Neo API แบบ Seamless ทีละขั้น

ค่าย _plus คืออะไร

  • Neo API รองรับค่ายเกมปรับแตกกว่า 30 ค่ายที่ตั้ง RTP ได้ ตั้งรวมทุกค่ายหรือแยกค่ายได้จากหน้า UI ในหลังบ้าน และตั้งละเอียดรายผู้เล่นแบบ real-time ได้ผ่าน API ค่ายกลุ่มนี้ชื่อลงท้ายด้วย _plus
  • ค่าย _plus เป็นคนละค่ายกับค่ายชื่อเดียวกันที่ไม่มี _plus เช่น PG_plus กับ PG, JILI_plus กับ JILI, NEXTSPIN_plus กับ NEXTSPIN แต่ละตัวมี providerId ของตัวเอง เวลาตั้งค่าหรือทำรายงานให้ยึด providerId ไม่ใช่ชื่อค่าย
  • ตัวอย่างชื่อที่ปรากฏในเอกสาร: PG_plus, JILI_plus, JOKER_plus, NOLIMITCITY_plus, EVOPLAY_plus, FACHAI_plus, NEXTSPIN_plus, PRAGMATIC_plus, CQ9_plus, HABANERO_plus, HACKSAW_plus, JDB_plus, KA_plus, PLAYSON_plus, SPRIBE_plus, TADA_plus, 3OAKS_plus และคาสิโนสด SA_plus, SEXY_plus รายชื่อที่บัญชีของคุณใช้ได้จริงให้ดูจาก get-games
  • ค่าย _plus ไม่ได้ทำงานแบบเดียวกันทั้งหมด บางค่ายรับ RTP เป็นตัวเลขตรงๆ บางค่ายทำงานกับ Preset (ชุดการจ่าย) แยกได้ด้วยฟิลด์ canSetPreset
  • เดือนกรกฎาคม 2026 ค่าย JILI_plus, SA_plus, NOLIMITCITY_plus, EVOPLAY_plus และ FACHAI_plus ย้ายระบบ ชื่อเหมือนเดิมแต่ providerId และ gameId เปลี่ยนทั้งหมด ถ้าเก็บ id ไว้ก่อนหน้านั้น ให้ยิง get-games แล้ว sync ใหม่ก่อนตั้ง RTP

ค่ายไหนปรับได้ ค่ายไหนไม่ได้

กลุ่ม ตัวอย่าง ปรับ RTP ตรวจจาก
สล็อตที่ลงท้าย _plus PG_plus และค่ายสล็อต _plus อื่น ได้ canSetRtp: true และ gameTypes มี slot
คาสิโนสดที่ลงท้าย _plus SA_plus, SEXY_plus ไม่มีการปรับ หลังบ้านซ่อนปุ่มตั้งค่า gameTypes ไม่มี slot
ค่ายใดก็ตามที่ canSetRtp: false ดูจาก response ของบัญชีคุณ ไม่ได้ เรียก set-rtp จะได้ PROVIDER_CANNOT_SET_RTP canSetRtp

เอกสารให้เกณฑ์ไว้ว่าการปรับ RTP ไม่มีความหมายกับเกมคาสิโนสดหรือกีฬา จึงควรแสดงปุ่มตั้ง RTP เฉพาะค่ายที่มีเกมสล็อต หน้าหลังบ้านของ Neo ก็ใช้เกณฑ์นี้ ยืนยันรายค่ายในบัญชีของคุณด้วย canSetRtp ทุกครั้ง อย่าตัดสินจากชื่อค่าย

API ที่ใช้

ใช้ 3 เส้นนี้ร่วมกันจะได้ครบเท่าหน้า "ค่ายเกม" ในหลังบ้าน Neo

  1. get-sub-agent-providers ดึงรายการค่ายพร้อมค่า RTP ปัจจุบันของแต่ละค่าย
  2. get-presets ดึงลิสต์ Preset ไว้ทำ dropdown
  3. set-rtp บันทึกค่า

1. ดูว่าค่ายไหนตั้งได้

bash
curl -X POST https://api.neoapihub.com/api/external/get-sub-agent-providers \
  -H "Authorization: $NEO_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"YOUR_AGENT_ID"}'

ตัวอย่าง response ตัดเฉพาะฟิลด์ที่เกี่ยวกับ RTP ชื่อค่ายเป็นค่าสมมติ

json
{
  "agentId": "agent-001",
  "username": "headagent",
  "providers": [
    {
      "providerId": "provider-a-uuid",
      "providerName": "PROVIDER_A_plus",
      "isActive": true,
      "canSetRtp": true,
      "canSetPreset": false,
      "gameTypes": ["slot"],
      "rtpMode": "rtp",
      "rtp": 96,
      "presetId": null
    },
    {
      "providerId": "provider-b-uuid",
      "providerName": "PROVIDER_B_plus",
      "isActive": true,
      "canSetRtp": true,
      "canSetPreset": true,
      "gameTypes": ["slot"],
      "rtpMode": "preset",
      "rtp": null,
      "presetId": "preset-uuid"
    }
  ],
  "subagents": [
    { "agentId": "subagent-uuid", "username": "subagent01", "providers": [] }
  ]
}
ฟิลด์ ความหมาย
canSetRtp ค่ายนี้ตั้ง RTP ได้หรือไม่
canSetPreset ค่ายนี้ใช้ Preset ได้หรือไม่ ถ้าเป็น false ตั้งได้แค่ตัวเลข ให้ซ่อน dropdown Preset
gameTypes ประเภทเกมของค่าย ใช้ตัดสินว่าจะแสดงปุ่มตั้ง RTP หรือไม่
rtpMode โหมดปัจจุบัน rtp (ตัวเลข) หรือ preset
rtp / presetId ค่าที่ตั้งอยู่ อันที่ไม่ได้ใช้เป็น null
subagents ลูกสายชั้นถัดไปหนึ่งชั้น แต่ละคนมีรายการค่ายของตัวเอง

2. เลือกโหมด: ตัวเลข หรือ Preset

แต่ละค่ายอยู่ได้ทีละโหมด

  • โหมดตัวเลข ส่ง rtp เป็นจำนวนเต็ม 30–99 ทศนิยมจะถูกปฏิเสธ
  • โหมด Preset ส่ง presetId ที่ได้จาก get-presets ใช้ได้เฉพาะค่ายที่ canSetPreset: true

ส่งได้ทีละอย่าง ส่งทั้งคู่หรือไม่ส่งเลยจะได้ RTP_OR_PRESET_ID_REQUIRED ส่งอันไหนมา อีกอันจะถูกล้างเป็น null ให้อัตโนมัติ สลับโหมดได้ด้วยการส่งฟิลด์ของโหมดที่ต้องการมาเลย

3. บันทึกค่าด้วย set-rtp

bash
# โหมดตัวเลข: ตั้ง RTP 96 ให้ค่ายหนึ่งของบัญชีตัวเอง
curl -X POST https://api.neoapihub.com/api/external/set-rtp \
  -H "Authorization: $NEO_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"YOUR_AGENT_ID","providerId":"PROVIDER_ID","rtp":96}'

# โหมด Preset: rtp จะถูกล้างให้อัตโนมัติ
curl -X POST https://api.neoapihub.com/api/external/set-rtp \
  -H "Authorization: $NEO_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"YOUR_AGENT_ID","providerId":"PROVIDER_ID","presetId":"PRESET_ID"}'

# ตั้งให้ลูกสายชั้นถัดไป
curl -X POST https://api.neoapihub.com/api/external/set-rtp \
  -H "Authorization: $NEO_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"YOUR_AGENT_ID","providerId":"PROVIDER_ID","targetAgentId":"SUBAGENT_ID","rtp":92}'
ฟิลด์ จำเป็น ความหมาย
agentId ใช่ Agent ID ของผู้เรียก (เจ้าของ Private Key)
providerId ใช่ id ของค่าย จาก get-sub-agent-providers หรือ get-games
rtp อย่างใดอย่างหนึ่ง จำนวนเต็ม 30–99 ตั้งเป็นโหมดตัวเลขและล้าง presetId
presetId อย่างใดอย่างหนึ่ง id จาก get-presets ตั้งเป็นโหมด Preset และล้าง rtp
targetAgentId ไม่ ตั้งให้ใคร ไม่ส่งคือตัวเอง ใส่ได้แค่ตัวเองหรือลูกสายชั้นถัดไป และต้องเป็นค่ายที่คุณถืออยู่

Response บอกค่าใหม่และค่าเดิม ใช้ยืนยันว่าเปลี่ยนจากอะไรเป็นอะไร

json
{
  "agentId": "agent-001",
  "username": "headagent",
  "providerId": "provider-uuid",
  "providerName": "PG_plus",
  "rtpMode": "rtp",
  "rtp": 96,
  "presetId": null,
  "previousRtp": 90,
  "previousPresetId": null
}

4. ส่ง rtp ไปกับ init-session

ส่ง rtp (30–99) ใน body ของ POST /api/external/init-session เพื่อกำหนดค่าเฉพาะ session นั้น ใช้ตั้ง RTP รายผู้เล่นได้ เพราะแต่ละ session ผูกกับ username เดียว

ลำดับการใช้ค่าตอนเปิดเกมตามเอกสาร

  1. ถ้า init-session ส่ง rtp มา ใช้ค่านั้นกับ session นั้น
  2. ถ้าไม่ส่ง ใช้ค่าที่ตั้งไว้ด้วย set-rtp
  3. ถ้ายังไม่เคยตั้ง ใช้ค่าเริ่มต้นของค่าย

ระวังจุดนี้: ตัวอย่างโค้ด init-session ในเอกสารใส่ rtp: 97 เป็นค่า default ถ้าคัดลอกไปใช้ตรงๆ ระบบของคุณจะส่ง rtp ทุกครั้ง และค่าที่ตั้งด้วย set-rtp จะไม่ถูกใช้เลย ถ้าต้องการใช้ค่าที่ตั้งค้างไว้ ให้ตัดฟิลด์ rtp ออกจาก payload

ค่ายแบบ Preset: ตัวเลขที่ส่งคือชื่อ Preset

ค่ายที่ทำงานกับ Preset (canSetPreset: true) ไม่ได้รับเลข RTP ดิบ เมื่อส่ง rtp เป็นตัวเลข ระบบจะหา Preset ที่ชื่อตรงกับเลขนั้น แล้วส่ง Preset ตัวนั้นไปให้ค่าย ถ้าไม่มี Preset ชื่อนั้น เช่นส่ง 93 ทั้งที่มีแต่ Preset ชื่อ 94 และ 96 จะได้ RTP_HAS_NO_MATCHING_PRESET พร้อมฟิลด์ availableRtp ที่บอกเลขที่ใช้ได้ เอาค่านี้ไปทำเป็นตัวเลือกในหน้าจอของคุณได้เลย

ส่วนค่ายแบบตัวเลข (canSetPreset: false) รับเลข 30–99 ได้ทุกค่าโดยไม่ต้องมี Preset

ถ้าได้ PROVIDER_OPERATOR_NOT_CONFIGURED แปลว่าค่ายแบบ Preset ของสายนี้ยังตั้งเป็นตัวเลขไม่ได้ ให้ใช้ presetId แทน หรือติดต่อ Neo Support ทาง https://t.me/neosuperapi

สร้าง Preset จาก RTP เป้าหมาย

สำหรับค่ายแบบ Preset เรียก ensure-model-preset พร้อม RTP ที่ต้องการ (ทศนิยมได้ 2 ตำแหน่ง) ระบบจะคืน Preset หนึ่งตัวสำหรับค่านั้น เรียกซ้ำด้วยค่าเดิมได้ id เดิม แล้วนำ id ไปใช้เป็น presetId กับ set-rtp หรือ init-session

bash
curl -X POST https://api.neoapihub.com/api/external/ensure-model-preset \
  -H "Authorization: $NEO_PRIVATE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agentId":"YOUR_AGENT_ID","model":"mixture","targetRtp":95.5,"volatility":"medium"}'

ตัวอย่าง response (ตัดบางฟิลด์ออก)

json
{
  "id": "PRESET_ID",
  "rtpNormal": 0.955,
  "model": { "model": "mixture", "targetRtp": 95.5, "volatility": "medium" }
}

model: "mixture" คือ RTP ที่กำหนดพร้อมความผันผวน low, medium หรือ high เอกสารมีโมเดลอื่นและการส่ง model ไปกับ init-session โดยตรง ดูที่ /docs/seamless ข้อควรระวังคือห้ามส่ง model คู่กับ presetId, payoffSetting หรือ pool จะได้ MODEL_LAUNCH_CONFLICT

Error ของ set-rtp

Error HTTP สาเหตุ
RTP_OR_PRESET_ID_REQUIRED 400 ไม่ได้ส่ง rtp และ presetId เลย หรือส่งมาทั้งคู่
RTP_MUST_BE_BETWEEN_30_AND_99 400 rtp ไม่ใช่จำนวนเต็มในช่วง 30–99
RTP_HAS_NO_MATCHING_PRESET 400 ค่ายแบบ Preset ไม่มี Preset ชื่อตรงกับเลขที่ส่ง ดู availableRtp
PROVIDER_OPERATOR_NOT_CONFIGURED 400 ค่ายแบบ Preset ของสายนี้ตั้งเป็นตัวเลขไม่ได้ ใช้ Preset แทน
PROVIDER_CANNOT_SET_RTP 400 ค่ายนี้ canSetRtp: false
PROVIDER_CANNOT_SET_PRESET 400 ค่ายนี้ canSetPreset: false ตั้งได้แค่ตัวเลข
INVALID_PRIVATE_KEY 401 Private Key ไม่ตรงกับ agentId
AGENT_DO_NOT_HAVE_PERMISSION 403 targetAgentId ไม่ใช่ตัวเองหรือลูกสายชั้นถัดไป หรือคุณไม่ได้ถือค่ายนี้
AGENT_PROVIDER_NOT_FOUND 404 สายที่ระบุไม่มีค่ายนี้เปิดอยู่
PRESET_NOT_FOUND 404 presetId ไม่อยู่ในลิสต์ Preset ของคุณ

ทำหน้าตั้ง RTP ในระบบของคุณเอง

  • แสดงปุ่มตั้ง RTP เฉพาะค่ายที่ canSetRtp: true และ gameTypes มี slot
  • ซ่อน dropdown Preset เมื่อ canSetPreset: false
  • ค่ายแบบ Preset ให้เลือกจากลิสต์ Preset หรือจาก availableRtp แทนช่องพิมพ์ตัวเลขอิสระ
  • ตรวจว่าเป็นจำนวนเต็ม 30–99 ก่อนส่ง set-rtp
  • ตั้งให้ได้แค่ตัวเองหรือลูกสายชั้นถัดไป ลูกสายชั้นที่ลึกกว่านั้นให้หัวสายโดยตรงของเขาเป็นคนตั้ง
  • หลังบันทึก แสดง previousRtp / previousPresetId คู่กับค่าใหม่ ให้ผู้ใช้เห็นว่าเปลี่ยนอะไรไป

ถ้าให้ AI ช่วยเขียนหน้านี้ ส่งเอกสาร https://neoapihub.com/docs/seamless.md ให้ AI อ่านก่อน วิธีทำอยู่ใน ใช้ AI ช่วยเชื่อม Neo API

FAQ

ตั้ง RTP รายผู้เล่นได้ไหม

ได้ ส่ง rtp ไปกับ init-session ของผู้เล่นคนนั้น ตามเอกสาร ค่าที่ส่งตอนเปิดเกมจะใช้กับ session นั้นแทนค่าที่ตั้งไว้ด้วย set-rtp ส่วนค่าที่ต้องใช้กับผู้เล่นทุกคนของค่ายนั้น ให้ตั้งครั้งเดียวด้วย set-rtp

ส่ง RTP เป็นทศนิยมได้ไหม

set-rtp รับเฉพาะจำนวนเต็ม 30–99 ทศนิยมจะได้ RTP_MUST_BE_BETWEEN_30_AND_99 ถ้าต้องการค่าทศนิยมกับค่ายแบบ Preset ให้ใช้ ensure-model-preset ซึ่งรับทศนิยมได้ 2 ตำแหน่ง แล้วตั้งด้วย presetId

ตั้ง RTP ให้หลานสายได้ไหม

ไม่ได้ targetAgentId ใส่ได้แค่ตัวเองหรือลูกสายชั้นถัดไป ใส่หลานสายจะได้ AGENT_DO_NOT_HAVE_PERMISSION (403)

ตั้ง set-rtp แล้ว แต่เกมยังใช้ค่าเดิม

เช็คก่อนว่าระบบของคุณส่ง rtp ไปกับ init-session ทุกครั้งหรือไม่ ถ้าส่ง ค่านั้นจะชนะ จากนั้นเรียก get-sub-agent-providers ดู rtpMode, rtp และ presetId ของค่ายนั้น ถ้ายังไม่ตรง ส่ง request และ response ที่ลบ Private Key ออกแล้ว พร้อมชื่อค่าย gameId และเวลาที่เปิดเกม ไปที่ Neo Support ทาง https://t.me/neosuperapi

บทความอื่น

เชื่อม Neo API แบบ Seamless ทีละขั้น พร้อม checklist go-live

ขั้นตอนเชื่อม Neo API แบบ Seamless ตั้งแต่ Private Key, Callback URL, /check-balance, /update-balance, get-games, init-session ถึง checklist ก่อนเปิดจริง

Seamless กับ Transfer ต่างกันยังไง เลือกแบบไหนกับ Neo API

เทียบการเชื่อม Neo API แบบ Seamless (Single Wallet) กับ Transfer (Two Wallet) ว่าใครถือกระเป๋าเงิน ต้องสร้างอะไรบ้าง ใช้ endpoint ไหน ข้อดีข้อเสีย และวิธีเลือก

ใช้ AI ช่วยเชื่อม Neo API กับ Claude Code, Cursor, ChatGPT

วิธีให้ AI เขียนโค้ดเชื่อม Neo API ให้ถูกตั้งแต่รอบแรก ส่งเอกสาร Markdown, prompt พร้อมใช้, จุดที่ต้องตรวจในโค้ด callback และการเก็บ Private Key ให้พ้นแชท

Callback โดน Cloudflare บล็อก 403 ทุกค่ายเล่นไม่ได้ แก้ยังไง

init-session สำเร็จแต่ทุกค่ายเดิมพันไม่ได้ ให้เช็ค Cloudflare หรือ WAF หน้า Callback URL ก่อน วิธียืนยันอาการ ตั้ง Skip rule หรือแยก subdomain และทดสอบซ้ำ