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

ค่าย _plus ไหนปรับ RTP ได้ ไหนไม่ได้ เช็คด้วย canSetRtp และ canSetPreset แล้วตั้งด้วย set-rtp หรือส่ง rtp กับ init-session พร้อมตัวอย่าง request และ error

ค่ายที่ชื่อลงท้ายด้วย `_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`

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

## ค่าย _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](/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](/blog/integrate-with-ai)

## 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

---
Source: https://neoapihub.com/blog/plus-provider-rtp-api
