{
  "info": {
    "_postman_id": "beec0c0b-e5c5-5723-98be-6a919bdae106",
    "name": "HuayEngine — Provider API",
    "description": "Postman collection ครบทุก endpoint ของพาร์ทเนอร์ HuayEngine (transfer + seamless)\n\n**เริ่มใช้**\n1. Import collection นี้และ environment (`HuayEngine-Staging` / `HuayEngine-Production` · ใน repo มี `HuayEngine-Local` สำหรับทีมพัฒนา)\n2. เลือก environment แล้วใส่ `api_key` และ `hmac_secret` (Current value)\n3. รันโฟลเดอร์ตามลำดับ 0 → 4 · โฟลเดอร์ 5 และ 7 ใช้ทดสอบ endpoint callback / webhook ของคุณเอง · โฟลเดอร์ 6 ปิดรับ/ยกเลิกงวด (ต้องตั้ง `target_round_id` เอง — **ห้ามรันทั้ง collection ด้วย Runner**)\n\n**การเซ็น:** pre-request script ของ collection ใส่ `X-Api-Key`, `X-Request-Id` (UUID ใหม่ทุกครั้ง) และ `X-Signature (Provider API HMAC v2)` ให้ทุก request และสร้าง `{{idempotency_key}}` ใหม่ทุกครั้งที่กด Send · จะ retry ธุรกรรมเดิมให้ใช้ key เดิม (`X-Request-Id` ใหม่ทุกครั้งอยู่แล้ว)\n\n**ค่าที่ script เก็บให้ (collection variables):** `lottery_type_id`, `round_id`, `member_id`, `ticket_id`, `launch_url`, `session_token`, `bet_idempotency_key` · ค่าที่ตั้งเอง: `target_round_id` (โฟลเดอร์ 6)\n\n★ คำขอในโฟลเดอร์ 2–3 เปลี่ยนเงินจริงบน environment ที่เลือก · โฟลเดอร์ 6 เปลี่ยนสถานะงวดจริง และ `void` คืนเงินทุกบิลในงวด\n\nคู่มือ: หน้า Docs ใน Studio (สเปก API + คู่มือทำเว็บหวยของตัวเอง) · ฉบับเต็มใน repo HuayEngine: `docs/20_PROVIDER_INTEGRATION.md`, `docs/22_PARTNER_INTEGRATION_GUIDE.md`\n\nExternal-member Play staging trials use the separate HuayEngine-External-Play-Sandbox collection with Admin JWT and an approved existing member. Public provider session/launch remains backend-only for external_member.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// ── เซ็น HMAC ให้ทุก request อัตโนมัติ ─────────────────────────────────────────────",
          "// X-Signature (Provider API HMAC v2)",
          "// ใช้กับขาเข้า /api/v1/provider/* และตัวอย่าง callback /seamless/lotto/* (สูตรเดียวกัน คีย์คู่เดียวกัน)",
          "// ดู docs/20_PROVIDER_INTEGRATION.md หัวข้อ \"การยืนยันตัวตน (HMAC)\"",
          "",
          "// Idempotency-Key ใหม่ทุกครั้งที่กด Send — จะ retry ธุรกรรมเดิมหลัง timeout ให้ copy ค่าเดิม",
          "// จาก Console ไปใส่ใน header ตรง ๆ แทน {{idempotency_key}} (ห้ามใช้ key ใหม่ ไม่งั้นอาจตัดเงินซ้ำ)",
          "pm.variables.set('idempotency_key', pm.variables.replaceIn('{{$guid}}'));",
          "// reference ของตัวอย่าง callback (โฟลเดอร์ 5) — ใช้ค่าเดียวกันทั้งใน body และ Idempotency-Key",
          "pm.variables.set('cb_ref', 'cb-' + Date.now());",
          "",
          "const path = pm.request.url.getPath();",
          "if (path.startsWith('/api/v1/provider/') || path.includes('/seamless/lotto/')) {",
          "  const apiKey = pm.variables.get('api_key');",
          "  const secret = pm.variables.get('hmac_secret');",
          "  if (!apiKey || !secret) {",
          "    throw new Error('ยังไม่ได้ใส่ api_key / hmac_secret ใน environment');",
          "  }",
          "  const requestId = pm.variables.replaceIn('{{$guid}}');",
          "",
          "  // ★ เซ็น bytes ชุดเดียวกับที่ส่ง: แทนค่าตัวแปรใน body เอง (รวม {{$timestamp}}) แล้วเขียนกลับ",
          "  //   ไม่งั้นตัวแปรสุ่มจะถูกแทนค่าอีกรอบตอนส่ง ทำให้ลายเซ็นไม่ตรง",
          "  let raw = '';",
          "  if (pm.request.method !== 'GET' && pm.request.body && pm.request.body.mode === 'raw') {",
          "    raw = pm.variables.replaceIn(pm.request.body.raw || '');",
          "    pm.request.body.update({ mode: 'raw', raw: raw, options: { raw: { language: 'json' } } });",
          "  }",
          "",
          "  const isProvider = path.startsWith('/api/v1/provider/');",
          "  const timestamp = new Date().toISOString();",
          "  const resolved = pm.variables.replaceIn(pm.request.url.toString());",
          "  const target = resolved.replace(/^https?:\\/\\/[^/]+/, '');",
          "  const idem = pm.variables.replaceIn(pm.request.headers.get('Idempotency-Key') || '');",
          "  const fields = [pm.request.method, target, timestamp, requestId, idem].map(value => JSON.stringify(value));",
          "  const message = isProvider ? ['huayengine-provider-v2', ...fields, CryptoJS.SHA256(raw).toString(CryptoJS.enc.Hex)].join('\\n') : requestId + '.' + raw;",
          "  const signature = CryptoJS.HmacSHA256(message, secret).toString(CryptoJS.enc.Hex);",
          "  if (isProvider) pm.request.headers.upsert({ key: 'X-Timestamp', value: timestamp });",
          "  pm.request.headers.upsert({ key: 'X-Api-Key', value: apiKey });",
          "  pm.request.headers.upsert({ key: 'X-Request-Id', value: requestId });",
          "  pm.request.headers.upsert({ key: 'X-Signature', value: signature });",
          "}"
        ]
      }
    },
    {
      "listen": "test",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// ทุก response เป็น envelope { data, error, request_id } — แสดง request_id ไว้แจ้งทีมเวลามีปัญหา",
          "try {",
          "  const env = pm.response.json();",
          "  if (env && env.error) {",
          "    console.warn(`${pm.response.code} ${env.error.code}: ${env.error.message} (request_id ${env.request_id})`);",
          "  }",
          "} catch (e) { /* ไม่ใช่ JSON */ }"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "lottery_type_id",
      "value": "",
      "type": "string",
      "description": "จาก GET /games (script เก็บให้)"
    },
    {
      "key": "round_id",
      "value": "",
      "type": "string",
      "description": "จาก GET /rounds (script เก็บงวดแรกที่ open)"
    },
    {
      "key": "member_id",
      "value": "",
      "type": "string",
      "description": "จาก POST /members หรือ session/launch"
    },
    {
      "key": "ticket_id",
      "value": "",
      "type": "string",
      "description": "จาก POST /bet/place"
    },
    {
      "key": "launch_url",
      "value": "",
      "type": "string",
      "description": "จาก session/launch — เปิดภายใน 120 วินาที"
    },
    {
      "key": "session_token",
      "value": "",
      "type": "string",
      "description": "จาก session/launch"
    },
    {
      "key": "target_round_id",
      "value": "",
      "type": "string",
      "description": "งวดที่จะปิดรับ/ยกเลิก (โฟลเดอร์ 6) — ตั้งเอง ไม่ถูกเติมอัตโนมัติ เพราะ round_id ที่ script เก็บคืองวด open แรก ซึ่งอาจเป็นงวดจริงที่ยังขายอยู่"
    },
    {
      "key": "void_idempotency_key",
      "value": "",
      "type": "string",
      "description": "Idempotency-Key ของ void (script โฟลเดอร์ 6 สร้างให้ และคงเดิมต่อ 1 งวด — Send ซ้ำบนงวดเดิม = retry ด้วยคีย์เดิม)"
    },
    {
      "key": "void_idempotency_round",
      "value": "",
      "type": "string",
      "description": "งวดที่ void_idempotency_key ผูกอยู่ (script จัดการให้ ไม่ต้องแก้)"
    },
    {
      "key": "attempt_idempotency_key",
      "value": ""
    },
    {
      "key": "bet_idempotency_key",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "0. ตรวจการเชื่อมต่อ",
      "description": "เริ่มที่นี่ ถ้าได้ 200 = `api_key`, `hmac_secret` และ IP ถูกต้องแล้ว\n\n| ผล | ความหมาย |\n|---|---|\n| 401 `invalid_api_key` | คีย์ผิดหรือถูกปิด |\n| 401 `invalid_signature` | `hmac_secret` ไม่ตรงกับคีย์ |\n| 403 `ip_not_allowed` | IP ไม่อยู่ใน whitelist ของคีย์ |",
      "item": [
        {
          "name": "ตลาดหวยที่เปิด (GET /games)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/games",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "games"
              ]
            },
            "description": "ตลาดหวยที่คีย์นี้เห็น — **GET เซ็นด้วย body ว่าง** (script จัดการให้)\n\nscript เก็บ `lottery_type_id` ของตลาดแรกไว้ให้"
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = (Array.isArray(d) ? d : (d.items || []))[0]?.id; if (v !== undefined && v !== null) { pm.collectionVariables.set('lottery_type_id', String(v)); console.log('lottery_type_id =', v); } }"
                ]
              }
            }
          ]
        }
      ]
    },
    {
      "name": "1. ข้อมูลหวย (อ่านอย่างเดียว)",
      "description": "ไม่ต้องใช้ `Idempotency-Key` · อัตราจ่ายถูก freeze ลง snapshot ตอนสร้างงวด ใช้ betconfig ของงวดเป็นความจริงเสมอ",
      "item": [
        {
          "name": "งวดตัวแทนต่อตลาด — lobby (GET /rounds)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds"
              ]
            },
            "description": "1 งวดต่อตลาด (งวดที่เปิดและใกล้ปิดที่สุด) ใช้ทำหน้า lobby\n\nscript เก็บ `round_id` ของงวดแรกที่ `status=open`"
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = ((Array.isArray(d) ? d : (d.items || [])).find(r => r.status === 'open') || {}).id; if (v !== undefined && v !== null) { pm.collectionVariables.set('round_id', String(v)); console.log('round_id =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "งวดของตลาดเดียว (GET /rounds?lottery_type_id=)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds?lottery_type_id={{lottery_type_id}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds"
              ],
              "query": [
                {
                  "key": "lottery_type_id",
                  "value": "{{lottery_type_id}}"
                }
              ]
            },
            "description": "งวดของตลาดนั้น สูงสุด 300 งวด ตลาดที่ไม่ได้เปิดให้คีย์ได้ `403 lottery_not_allowed`"
          },
          "response": []
        },
        {
          "name": "อัตราจ่ายและเพดานของงวด (GET /rounds/{id}/betconfig)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds/{{round_id}}/betconfig",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds",
                "{{round_id}}",
                "betconfig"
              ]
            },
            "description": "ประเภทเลข อัตราจ่าย `rate {num,den}` เพดาน และ `accepts_bets`\n\n★ `max_stake = 0` แปลว่า **ไม่จำกัด** ไม่ใช่แทงได้ 0 บาท"
          },
          "response": []
        },
        {
          "name": "ผลรางวัล (GET /results)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/results?lottery_id=th_gov&limit=20",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "results"
              ],
              "query": [
                {
                  "key": "lottery_id",
                  "value": "th_gov"
                },
                {
                  "key": "limit",
                  "value": "20"
                }
              ]
            },
            "description": "ผลที่ publish แล้ว ทุกพารามิเตอร์ไม่บังคับ `lottery_id` = `code` ของตลาด `limit` สูงสุด 500\n\n`numbers` เป็น map ที่คีย์ขึ้นกับตลาด อย่าฮาร์ดโค้ด"
          },
          "response": []
        },
        {
          "name": "สถานะผลของงวด (GET /results/status)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/results/status?round_id={{round_id}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "results",
                "status"
              ],
              "query": [
                {
                  "key": "round_id",
                  "value": "{{round_id}}"
                }
              ]
            },
            "description": "`{ round_id, published, top3, top2, bottom2 }`"
          },
          "response": []
        },
        {
          "name": "commit-reveal ยี่กี (GET /rounds/{id}/yeekee-commitment)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds/{{round_id}}/yeekee-commitment",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds",
                "{{round_id}}",
                "yeekee-commitment"
              ]
            },
            "description": "งวดยี่กีเท่านั้น: `seed_hash` ก่อนออกผล และ `seed` หลังออกผล ใช้ตรวจความโปร่งใส · งวดที่ไม่ใช่ยี่กีได้ `404 not_found`"
          },
          "response": []
        }
      ]
    },
    {
      "name": "2. สมาชิกและกระเป๋า (transfer)",
      "description": "สำหรับคีย์ `wallet_mode=transfer` · คีย์ seamless `external_member` ใช้ได้แค่ `members` (แบบ external_member) และ `wallet/balance` (ถามยอดผ่าน callback) · คีย์ seamless `legacy_agent` ข้ามโฟลเดอร์นี้\n\n★ `/wallet/*` รับ **`member_id` (ตัวเลข) เท่านั้น** — เรียก `POST /members` ก่อนเสมอ",
      "item": [
        {
          "name": "สร้าง/ดึงสมาชิก (POST /members)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/members",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "members"
              ]
            },
            "description": "ยิงซ้ำได้ `member_id` เดิม (`201` สร้างใหม่ / `200` มีอยู่แล้ว) ไม่ต้องใช้ Idempotency-Key\n\n`member_code` เทียบแบบไม่สนตัวพิมพ์เล็ก/ใหญ่\n\nscript เก็บ `member_id` ไว้ให้",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.member_id; if (v !== undefined && v !== null) { pm.collectionVariables.set('member_id', String(v)); console.log('member_id =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "สร้าง/ดึงสมาชิก (seamless external_member) — POST /members",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/members",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "members"
              ]
            },
            "description": "คีย์ seamless แบบ `external_member` (เว็บที่ถือกระเป๋าเองแบบ HuayAdmin) ต้องส่ง `wallet_owner_id` + `wallet_tenant_id` ให้ตรงกับค่าบนคีย์ ไม่ตรงได้ `403 binding_mismatch`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"wallet_owner_id\": {{wallet_owner_id}},\n  \"wallet_tenant_id\": {{wallet_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d && d.member_id) { pm.collectionVariables.set('member_id', String(d.member_id)); console.log('member_id =', d.member_id); }"
                ]
              }
            }
          ]
        },
        {
          "name": "ยอดกระเป๋า (POST /wallet/balance)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/wallet/balance",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "wallet",
                "balance"
              ]
            },
            "description": "transfer: `{ member_id }` → `{ member_id, balance_satang, balance, currency }`\n\nseamless `external_member`: ส่ง `{ member_code, wallet_owner_id, wallet_tenant_id }` แทน — engine ยิง callback `getbalance` ไปถามเซิร์ฟเวอร์ของคุณแล้วตอบ `{ member_id, member_code, balance_satang, currency }`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": {{member_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "ฝากเงิน ฿100 (POST /wallet/deposit)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/wallet/deposit",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "wallet",
                "deposit"
              ]
            },
            "description": "จำนวนเป็น **สตางค์** (10000 = ฿100) · Idempotency-Key บังคับ\n\ntimeout = ไม่รู้ผล → ส่งซ้ำด้วย key และ body เดิม",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": {{member_id}},\n  \"amount_satang\": 10000,\n  \"reference\": \"DEP-{{$timestamp}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "ถอนเงิน ฿50 (POST /wallet/withdraw)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/wallet/withdraw",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "wallet",
                "withdraw"
              ]
            },
            "description": "ยอดไม่พอได้ `422 payment_failed`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": {{member_id}},\n  \"amount_satang\": 5000,\n  \"reference\": \"WD-{{$timestamp}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "3. แทงและยกเลิก",
      "description": "โพยหนึ่งใบ = ตั๋วหนึ่งใบ วางแบบ atomic ทั้งใบ · ★ ส่งคำขอเหล่านี้ = **แทงจริง** บน environment ที่เลือก\n\nคีย์ seamless ที่วางเองโดยไม่มี session ใช้คำขอ \"แทง (seamless)\" ที่ส่งตัวตนสายเอเย่นต์ใน body",
      "item": [
        {
          "name": "แทง (transfer) — POST /bet/place",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/place",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "place"
              ]
            },
            "description": "เลขเป็น **สตริง** เสมอ เงินเป็นสตางค์ · หลายรายการได้แต่ห้าม `(bet_type_code, number)` ซ้ำ\n\n`201` = ตั๋ว `accepted` (ไม่มี items — ดึงจาก GET /bet/{id}) · script เก็บ `ticket_id`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"round_id\": {{round_id}},\n  \"reference\": \"ORDER-{{$timestamp}}\",\n  \"items\": [\n    { \"bet_type_code\": \"2_bottom\", \"number\": \"59\", \"stake_satang\": 1000 }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// เก็บ Idempotency-Key ของ bet/place ไว้ — engine ใช้ค่านี้เป็น reference ของ callback bet และ ticket_ref ของ rollback คืนเดิมพัน",
                  "pm.collectionVariables.set('bet_idempotency_key', pm.variables.get('idempotency_key'));"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.id; if (v !== undefined && v !== null) { pm.collectionVariables.set('ticket_id', String(v)); console.log('ticket_id =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "แทง (seamless ไม่มี session) — POST /bet/place",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/place",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "place"
              ]
            },
            "description": "คีย์ seamless ต้องส่ง `agent_owner_id`, `agent_tenant_id`, `agent_node_path` + `member_code` ขาดได้ `422 seamless_identity_missing`\n\nengine ยิง callback `bet` ไปตัดเงินที่ฝั่งคุณก่อนรับตั๋ว",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"round_id\": {{round_id}},\n  \"reference\": \"ORDER-{{$timestamp}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}},\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"items\": [\n    { \"bet_type_code\": \"2_bottom\", \"number\": \"59\", \"stake_satang\": 1000 }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// เก็บ Idempotency-Key ของ bet/place ไว้ — engine ใช้ค่านี้เป็น reference ของ callback bet และ ticket_ref ของ rollback คืนเดิมพัน",
                  "pm.collectionVariables.set('bet_idempotency_key', pm.variables.get('idempotency_key'));"
                ]
              }
            },
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.id; if (v !== undefined && v !== null) { pm.collectionVariables.set('ticket_id', String(v)); console.log('ticket_id =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "แทง (seamless external_member) — POST /bet/place",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/place",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "place"
              ]
            },
            "description": "คีย์ `external_member` (แบบ HuayAdmin) ส่ง `wallet_owner_id`, `wallet_tenant_id`, `currency` · engine ยิง callback `bet` ไปตัดเงินที่ฝั่งคุณก่อนรับตั๋ว\n\nได้ `503 placement_pending` หรือ timeout = **ยังไม่รู้ผล** ให้ส่งคำขอ \"ตรวจผลการวางบิล\" ถัดไป (script เก็บ key ของคำขอนี้ไว้ให้แล้ว)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"round_id\": {{round_id}},\n  \"reference\": \"ORDER-{{$timestamp}}\",\n  \"currency\": \"THB\",\n  \"wallet_owner_id\": {{wallet_owner_id}},\n  \"wallet_tenant_id\": {{wallet_tenant_id}},\n  \"items\": [\n    { \"bet_type_code\": \"2_bottom\", \"number\": \"59\", \"stake_satang\": 1000 }\n  ]\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.id; if (v !== undefined && v !== null) { pm.collectionVariables.set('ticket_id', String(v)); console.log('ticket_id =', v); } }"
                ]
              }
            },
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// เก็บ Idempotency-Key ของคำขอนี้ไว้ใช้กับ /bet/attempt เมื่อผลไม่ชัด (timeout / 503 placement_pending)",
                  "pm.collectionVariables.set('attempt_idempotency_key', pm.variables.get('idempotency_key'));",
                  "// เก็บ Idempotency-Key ของ bet/place ไว้ — engine ใช้ค่านี้เป็น reference ของ callback bet และ ticket_ref ของ rollback คืนเดิมพัน",
                  "pm.collectionVariables.set('bet_idempotency_key', pm.variables.get('idempotency_key'));"
                ]
              }
            }
          ]
        },
        {
          "name": "ตรวจผลการวางบิล (seamless external_member) — POST /bet/attempt",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/attempt",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "attempt"
              ]
            },
            "description": "ใช้เมื่อ `bet/place` ผลไม่ชัด: `accepted` = ใช้ตั๋วที่ได้ · `404 attempt_not_found` = ส่ง `bet/place` ซ้ำด้วย **key เดิม** · สถานะอื่น = ยังไม่รู้ผล รอแล้วถามใหม่\n\nคีย์ที่ไม่ใช่ `external_member` ได้ `403 forbidden`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_id\": {{member_id}},\n  \"idempotency_key\": \"{{attempt_idempotency_key}}\",\n  \"wallet_owner_id\": {{wallet_owner_id}},\n  \"wallet_tenant_id\": {{wallet_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "ตั๋ว 1 ใบ + รายการ (GET /bet/{ticket_id})",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/{{ticket_id}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "{{ticket_id}}"
              ]
            },
            "description": "`{ ticket, items }` · อัตราจริงอยู่ที่ `items[].rate_num/rate_den` · ยอดจ่ายที่ `items[].payout`\n\nบิลจบเมื่อไม่มีรายการไหนยัง `pending`"
          },
          "response": []
        },
        {
          "name": "รายการของหลายตั๋ว (GET /bets/detail)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bets/detail?ids={{ticket_id}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bets",
                "detail"
              ],
              "query": [
                {
                  "key": "ids",
                  "value": "{{ticket_id}}"
                }
              ]
            },
            "description": "สูงสุด 200 ใบต่อครั้ง (เกินจะถูกตัดเงียบ) · คืน items อย่างเดียว ไม่มีสถานะตั๋ว"
          },
          "response": []
        },
        {
          "name": "ประวัติตั๋วของสมาชิก (GET /bet/history)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/history?member_id={{member_id}}",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "history"
              ],
              "query": [
                {
                  "key": "member_id",
                  "value": "{{member_id}}"
                }
              ]
            },
            "description": "ตั๋วล่าสุด 100 ใบ กรองด้วย `member_id` เท่านั้น"
          },
          "response": []
        },
        {
          "name": "ยกเลิกตั๋ว (POST /bet/cancel)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/bet/cancel",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "bet",
                "cancel"
              ]
            },
            "description": "ยกเลิกได้เฉพาะตั๋ว `accepted` ที่งวดยังรับแทงอยู่ หลังปิดรับได้ `422 round_closed` · `cancel_failed` = เหตุอื่น\n\nคำตอบ `{ ticket_id, status, cancellation_action, refund_status, refund_reference }`\n\n- transfer: engine คืนเงินเข้ากระเป๋าเอง\n- seamless `external_member`: engine ยิง callback `rollback` (reference `rollback:void:{tenant}:{ticket}`) มาคืนเงินที่ฝั่งคุณ — ยืนยันจาก receipt ของ callback ไม่ใช่จากคำตอบนี้\n- seamless `legacy_agent`: engine **ไม่คืน** ฝั่งที่สั่งยกเลิกต้องคืนเงินในระบบตัวเอง\n\nIdempotency-Key ผูกกับ body: key เดิมกับ `ticket_id` อื่นได้ `409 idempotency_conflict`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"ticket_id\": {{ticket_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "4. ลิงก์เข้าเล่น (หน้า play)",
      "description": "สร้างลิงก์ตอนผู้เล่นกด \"เล่น\" แล้ว redirect ทันที — `launch_url` ใช้ได้ **ครั้งเดียวภายใน 120 วินาที** · ไม่รองรับ iframe · session ในหน้า play อยู่ได้ 2 ชั่วโมง",
      "item": [
        {
          "name": "ขอลิงก์ (transfer) — POST /session/launch",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/session/launch",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "session",
                "launch"
              ]
            },
            "description": "ยังไม่มีสมาชิก engine สร้างให้ · ได้ `member_id` + `launch_url`\n\nscript เก็บ `launch_url` ไว้ — เปิดในเบราว์เซอร์ภายใน 120 วินาที",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"return_url\": \"{{return_url}}\",\n  \"lang\": \"{{lang}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.launch_url; if (v !== undefined && v !== null) { pm.collectionVariables.set('launch_url', String(v)); console.log('launch_url =', v); } }",
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.member_id; if (v !== undefined && v !== null) { pm.collectionVariables.set('member_id', String(v)); console.log('member_id =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "ขอลิงก์ (seamless) — POST /session/launch",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/session/launch",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "session",
                "launch"
              ]
            },
            "description": "คีย์ seamless ต้องส่ง `agent_*` ครบสามตัว + `member_code`\n\n| ส่งมา | ผล |\n|---|---|\n| ไม่มี `agent_*` | session token แบบเดิม ไม่มีลิงก์ |\n| ไม่ครบ | `422 seamless_identity_missing` |\n| engine ยังไม่เปิดท่อ | `503 seamless_not_wired` |\n| ครบ | `201` + `launch_url` |",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"member_code\": \"{{member_code}}\",\n  \"return_url\": \"{{return_url}}\",\n  \"lang\": \"{{lang}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}},\n  \"agent_node_path\": \"{{agent_node_path}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "test",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.launch_url; if (v !== undefined && v !== null) { pm.collectionVariables.set('launch_url', String(v)); console.log('launch_url =', v); } }",
                  "const d = pm.response.json().data;",
                  "if (pm.response.code < 300 && d) { const v = d.session_token; if (v !== undefined && v !== null) { pm.collectionVariables.set('session_token', String(v)); console.log('session_token =', v); } }"
                ]
              }
            }
          ]
        },
        {
          "name": "ตรวจ session (POST /session/validate)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/session/validate",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "session",
                "validate"
              ]
            },
            "description": "`{ valid, member_ref, expires_at }` หมดอายุได้ `401 session_invalid`",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"session_token\": \"{{session_token}}\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "5. ตัวอย่าง callback seamless (engine → คุณ)",
      "description": "สำหรับทดสอบ **endpoint callback ของคุณเอง** — ตั้ง `callback_base_url` เป็นเซิร์ฟเวอร์ของคุณ คำขอเหล่านี้หน้าตาเหมือนที่ engine ยิงจริง (URL, header, ลายเซ็นด้วย `api_key`/`hmac_secret` ใบเดียวกับที่เราออกให้) · engine ส่งแค่ `bet`, `settle`, `rollback`, `getbalance` — `cancelbet` / `void` **ไม่ถูกส่ง** (การคืนเงินทุกแบบมาเป็น `rollback`)\n\nคำตอบที่ถือว่าสำเร็จ: HTTP 2xx `{ \"data\": { \"ok\": true, \"code\": \"ok\", \"balance_satang\": 108684, \"provider_ref\": \"...\" } }` (`balance_satang` ≥ 0 · บังคับสำหรับ `getbalance`)\n\nปฏิเสธต้องตอบ `{ \"data\": { \"ok\": false, \"code\": \"...\" } }` ด้วย HTTP ที่ตรงคู่: 422 `insufficient_funds`/`wallet_frozen`/`recovery_debt` · 400 `bad_request`/`amount_overflow` · 401 `unauthorized` · 403 `binding_mismatch`/`forbidden` · 409 `idempotency_conflict` · 503 `dependency_pending` (engine ลองใหม่) — คำตอบอื่นทั้งหมด engine ถือว่า **ไม่รู้ผล**\n\n`reference` ซ้ำต้องตอบผลเดิม ห้ามตัด/จ่ายซ้ำ · ตอบภายใน 5 วินาที",
      "item": [
        {
          "name": "callback getbalance (legacy_agent)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": ""
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/getbalance",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "getbalance"
              ]
            },
            "description": "ถามยอดสด — หน้า play (ลิงก์เข้าเล่น seamless) เรียกทุกครั้งที่แสดงยอด · `reference`, `round_id`, `ticket_ref` ว่าง และ `Idempotency-Key` ว่าง · ไม่ย้ายเงิน",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"getbalance\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"\",\n  \"round_id\": \"\",\n  \"ticket_ref\": \"\",\n  \"amount_satang\": 0,\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback bet (legacy_agent)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{cb_ref}}"
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/bet",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "bet"
              ]
            },
            "description": "ตัดเงินก่อนรับตั๋ว — ตอบ `ok:true` เฉพาะเมื่อตัดสำเร็จจริง เงินไม่พอตอบ 422 `{ok:false, code:\"insufficient_funds\"}` · ของจริง `reference` = Idempotency-Key ของ bet/place และ `ticket_ref` ว่าง (ยังไม่มีตั๋ว)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"bet\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"{{cb_ref}}\",\n  \"round_id\": \"{{round_id}}\",\n  \"ticket_ref\": \"\",\n  \"amount_satang\": 1000,\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback bet (external_member)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{cb_ref}}"
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/bet",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "bet"
              ]
            },
            "description": "หน้าตา callback ของคีย์ `external_member` (แบบ HuayAdmin): ส่ง `wallet_owner_id` / `wallet_tenant_id` แทน `agent_*` · settle/rollback ของรางวัลมี `settlement_generation` / `settlement_item_ref` เพิ่ม · ของจริง `reference` = Idempotency-Key ของ bet/place\n\nปฏิเสธต้องตอบ `{ok:false, code}` + HTTP ตรงคู่: 422 `insufficient_funds` · 409 `idempotency_conflict` · ยังไม่พร้อมตอบ 503 `dependency_pending` (engine ลองใหม่)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"bet\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"{{cb_ref}}\",\n  \"round_id\": \"{{round_id}}\",\n  \"ticket_ref\": \"\",\n  \"amount_satang\": 1000,\n  \"wallet_owner_id\": {{wallet_owner_id}},\n  \"wallet_tenant_id\": {{wallet_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback settle",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{cb_ref}}"
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/settle",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "settle"
              ]
            },
            "description": "จ่ายรางวัล **ต่อรายการที่ถูก 1 ครั้ง** · ของจริง `reference` = `settle:{tenant}:{batch}:{item}` และ `ticket_ref` = เลขตั๋ว · ผ่าน outbox ลองใหม่ได้สูงสุด 10 ครั้งรวมครั้งแรก ราว 81 นาที หลังจากนั้นเงินค้างจนทีม HuayEngine ตามให้ด้วยมือ",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"settle\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"{{cb_ref}}\",\n  \"round_id\": \"{{round_id}}\",\n  \"ticket_ref\": \"{{ticket_id}}\",\n  \"amount_satang\": 90000,\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback rollback — คืนเดิมพัน (ยกเลิกบิล / void งวด)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{cb_ref}}"
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/rollback",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "rollback"
              ]
            },
            "description": "คืนเงินเดิมพันของตั๋วที่ถูกยกเลิก (`bet/cancel` ของคีย์ `external_member`) หรือถูก void ทั้งงวด · ของจริง `reference` = `rollback:void:{tenant}:{ticket}` และ `ticket_ref` = **Idempotency-Key ของ bet/place เดิม** (ตัวอย่างนี้ใช้ `{{bet_idempotency_key}}` จากคำขอแทงล่าสุด) · ใช้ `ticket_ref` จับคู่รายการ `bet` ที่ต้องคืน\n\nวางบิลไม่สำเร็จหลังตัดเงินไปแล้ว engine ก็คืนด้วย `rollback` เช่นกัน (reference `rollback:{tenant}:{Idempotency-Key}`) · `reference` ซ้ำต้องตอบผลเดิม ห้ามคืนซ้ำ",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"rollback\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"{{cb_ref}}\",\n  \"round_id\": \"{{round_id}}\",\n  \"ticket_ref\": \"{{bet_idempotency_key}}\",\n  \"amount_satang\": 1000,\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback rollback — ดึงรางวัลคืน (กลับรายการ settle)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{cb_ref}}"
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/rollback",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "rollback"
              ]
            },
            "description": "ย้อนการจ่ายเมื่องวดถูก rollback ผล · ของจริง `reference` = `rollback:{tenant}:{batch}:{item}` และ `ticket_ref` = reference ของ `settle` เดิม (`settle:{tenant}:{batch}:{item}`) · `amount_satang` = ยอดรางวัลที่จ่ายไป",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"rollback\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"{{cb_ref}}\",\n  \"round_id\": \"{{round_id}}\",\n  \"ticket_ref\": \"settle:1:1001:5001\",\n  \"amount_satang\": 90000,\n  \"agent_node_path\": \"{{agent_node_path}}\",\n  \"agent_owner_id\": {{agent_owner_id}},\n  \"agent_tenant_id\": {{agent_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        },
        {
          "name": "callback getbalance (external_member)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": ""
              }
            ],
            "url": {
              "raw": "{{callback_base_url}}/seamless/lotto/HUAY/getbalance",
              "host": [
                "{{callback_base_url}}"
              ],
              "path": [
                "seamless",
                "lotto",
                "HUAY",
                "getbalance"
              ]
            },
            "description": "engine ยิงเมื่อหลังบ้านคุณเรียก `POST /wallet/balance` ด้วยคีย์ `external_member` · ต้องตอบ `balance_satang` (≥ 0) ไม่งั้น engine ถือว่าไม่รู้ผล · `reference`, `round_id`, `ticket_ref` และ `Idempotency-Key` ว่าง",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"op\": \"getbalance\",\n  \"member_ref\": \"{{member_code}}\",\n  \"currency\": \"THB\",\n  \"reference\": \"\",\n  \"round_id\": \"\",\n  \"ticket_ref\": \"\",\n  \"amount_satang\": 0,\n  \"wallet_owner_id\": {{wallet_owner_id}},\n  \"wallet_tenant_id\": {{wallet_tenant_id}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "6. ปิดรับและยกเลิกงวด (เปลี่ยนสถานะงวดจริง)",
      "description": "ปิดรับแทง/ยกเลิกทั้งงวดของ tenant ตัวเอง · ใช้ได้ทั้ง transfer และ seamless · ★ **ส่งคำขอเหล่านี้ = เปลี่ยนสถานะงวดจริง** บน environment ที่เลือก และ `void` คืนเงินทุกบิลในงวด ห้ามรันด้วย Collection Runner · ต้องตั้ง `target_round_id` ก่อน\n\nทั้งสอง endpoint บังคับ `Idempotency-Key` · `404` ไม่ได้แปลว่างวดไม่มีจริง (อาจเป็นของผู้เช่าอื่น)",
      "event": [
        {
          "listen": "prerequest",
          "script": {
            "type": "text/javascript",
            "exec": [
              "// โฟลเดอร์ 6 เปลี่ยนสถานะงวดจริง — ต้องตั้ง target_round_id เอง ไม่เติมให้อัตโนมัติ",
              "// (round_id ที่ script โฟลเดอร์ 1 เก็บไว้คืองวด open แรก ซึ่งอาจเป็นงวดจริงที่ยังขายอยู่)",
              "const target = pm.variables.get('target_round_id');",
              "if (!target) {",
              "  throw new Error('ตั้ง target_round_id (collection variable) เป็น id ของงวดที่ต้องการก่อน');",
              "}",
              "// void: Idempotency-Key คงที่ต่อ 1 งวด — Send ซ้ำบนงวดเดิม = retry ด้วยคีย์เดิม (ห้ามใช้คีย์ใหม่หลัง timeout)",
              "// ★ ต่างจาก {{idempotency_key}} ของ collection ที่ได้ค่าใหม่ทุกครั้งที่กด Send",
              "if (pm.request.url.getPath().endsWith('/void')) {",
              "  const same = pm.collectionVariables.get('void_idempotency_round') === String(target);",
              "  if (!same || !pm.collectionVariables.get('void_idempotency_key')) {",
              "    pm.collectionVariables.set('void_idempotency_key', pm.variables.replaceIn('{{$guid}}'));",
              "    pm.collectionVariables.set('void_idempotency_round', String(target));",
              "  }",
              "}"
            ]
          }
        }
      ],
      "item": [
        {
          "name": "ตรวจสถานะงวดหลัง timeout (GET /rounds/{id}/betconfig)",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds/{{target_round_id}}/betconfig",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds",
                "{{target_round_id}}",
                "betconfig"
              ]
            },
            "description": "ดู `data.status` และ `accepts_bets` ของงวด `target_round_id` — `cancelled` = void สำเร็จแล้ว (อย่ายิงซ้ำ) · `closed` = close สำเร็จหรือถึง `close_at` แล้ว · `open`/`scheduled` = ยังไม่สำเร็จ ยิงซ้ำด้วยคีย์เดิม\n\nรหัส error ต่างจาก close/void: `400 bad_request` ถ้า id ไม่ใช่เลข · `404 not_found` (ไม่ใช่ `round_not_found`) ถ้าไม่พบงวดใน tenant ของคีย์ และตอบรหัสเดียวกันนี้แม้อ่านงวดไม่สำเร็จชั่วคราว อย่าสรุปจาก 404 ครั้งเดียวว่างวดไม่มีจริง · `403 lottery_not_allowed` ถ้าตลาดของงวดไม่ได้เปิดให้คีย์นี้"
          },
          "response": []
        },
        {
          "name": "ปิดรับแทงงวด (POST /rounds/{id}/close)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Idempotency-Key",
                "value": "{{idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds/{{target_round_id}}/close",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds",
                "{{target_round_id}}",
                "close"
              ]
            },
            "description": "ปิดรับแทงงวดที่ `open` ของ tenant ตัวเอง · ไม่มี body (เซ็นเป็น `request_id + \".\"` เหมือน GET)\n\n- งวดที่ไม่ได้ `open` ได้ `422 not_closable` · งวดของผู้เช่าอื่น/ไม่มีจริงได้ `404 round_not_found` (แยกไม่ได้โดยตั้งใจ)\n- หลังปิด `/bet/place` ได้ `422 round_closed` · ตั๋วที่รับไว้แล้วยังรอผลตามปกติ · **ย้อนกลับไม่ได้**\n- ไม่มี webhook ส่งตอนปิด"
          },
          "response": []
        },
        {
          "name": "ยกเลิกงวดและคืนเงินทุกบิล (POST /rounds/{id}/void)",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "Idempotency-Key",
                "value": "{{void_idempotency_key}}"
              }
            ],
            "url": {
              "raw": "{{base_url}}/api/v1/provider/rounds/{{target_round_id}}/void",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "api",
                "v1",
                "provider",
                "rounds",
                "{{target_round_id}}",
                "void"
              ]
            },
            "description": "★ **คืนเงินทุกบิลในงวด** (ทุกสมาชิก ทุกคีย์ใน tenant) แล้วงวดเป็น `cancelled` · ย้อนกลับไม่ได้\n\n`reason` บังคับ ยาวสุด **200 อักขระ** (นับเป็น Unicode code point ไม่ใช่ไบต์ · สระและวรรณยุกต์ไทยนับตัวละหนึ่ง เช่น `ที่` นับเป็น 3 ข้อความไทยจึงเต็มเร็วกว่าที่นับด้วยตา) ห้ามมีอักขระควบคุมกลางข้อความ\n\n**Idempotency-Key:** script สร้างให้ 1 ค่าต่อ 1 งวด และ **คงเดิมเมื่อกด Send ซ้ำบนงวดเดิม** (ต่างจากคำขออื่นที่ได้คีย์ใหม่ทุกครั้ง) จะ retry หลัง timeout กด Send ซ้ำได้เลย · ห้ามเปลี่ยน `target_round_id` แล้วกลับมา\n\n- `422 not_voidable` หลัง timeout **อาจแปลว่าสำเร็จไปแล้ว** — ตรวจสถานะด้วย GET /rounds/{id}/betconfig (`status = cancelled`) ก่อน ห้ามยิงซ้ำด้วยคีย์ใหม่ และห้ามคืนเงินผู้เล่นเอง\n- `404 round_not_found` ไม่ได้แปลว่างวดไม่มีจริง อาจเป็นงวดของผู้เช่าอื่น\n- transfer: engine คืนเงินเข้ากระเป๋าสมาชิกทันที · seamless: engine ยิง callback `rollback` ต่อบิล (ห้ามคืนซ้ำในระบบคุณ)\n- ไม่มี webhook ส่งตอนยกเลิก",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"ตลาดต้นทางประกาศงดออกผลงวดนี้\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": []
        }
      ]
    },
    {
      "name": "7. ตัวอย่าง webhook (engine → คุณ)",
      "description": "สำหรับทดสอบ **endpoint webhook ของคุณเอง** — ตั้ง `webhook_url` และ `webhook_secret` (secret ของ webhook endpoint ไม่ใช่ hmac_secret ของคีย์)\n\nengine ส่ง `POST {webhook_url}` body `{event, data, ts}` พร้อม header `X-HuayEngine-Event`, `X-HuayEngine-Delivery` (ใช้กันซ้ำ), `X-HuayEngine-Signature = hex(HMAC-SHA256(webhook_secret, raw_body))`\n\nตอบ 2xx เร็ว ๆ แล้วประมวลผลภายหลัง · engine ส่งรวมไม่เกิน 6 ครั้ง (timeout 8 วินาที · ราว 14 นาที) · ส่งเฉพาะคีย์ที่เกี่ยวข้อง (`bet.placed`/`bet.cancelled` = คีย์ที่วางบิล · ระดับงวด = คีย์ที่ตลาดของงวดเปิดให้) · ลำดับไม่รับประกันและอาจซ้ำ · event ที่ส่ง: `bet.placed`, `bet.cancelled`, `round.closed`, `result.published`, `settlement.done`",
      "item": [
        {
          "name": "webhook settlement.done",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-HuayEngine-Event",
                "value": "settlement.done"
              }
            ],
            "url": {
              "raw": "{{webhook_url}}",
              "host": [
                "{{webhook_url}}"
              ]
            },
            "description": "งวดนี้ settle เสร็จ — ใช้เป็นตัวกระตุ้นให้ sync บิลของงวดด้วย `GET /bets/detail` (data.reason = `incomplete_result` แปลว่ายัง settle ไม่ครบ ให้แจ้งเตือนเท่านั้น)",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event\": \"settlement.done\",\n  \"data\": { \"id\": 1001, \"lottery_round_id\": {{round_id}}, \"generation\": 1, \"status\": \"done\", \"total_items\": 12, \"total_payout\": 90000 },\n  \"ts\": {{$timestamp}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// webhook เซ็นต่างจาก Provider API: hex(HMAC-SHA256(webhook_secret, raw_body)) — ไม่มี request_id นำหน้า",
                  "const secret = pm.variables.get('webhook_secret');",
                  "if (!secret) { throw new Error('ยังไม่ได้ใส่ webhook_secret ใน environment'); }",
                  "const raw = pm.variables.replaceIn(pm.request.body.raw || '');",
                  "pm.request.body.update({ mode: 'raw', raw: raw, options: { raw: { language: 'json' } } });",
                  "pm.request.headers.upsert({ key: 'X-HuayEngine-Delivery', value: pm.variables.replaceIn('{{$guid}}') });",
                  "pm.request.headers.upsert({ key: 'X-HuayEngine-Signature', value: CryptoJS.HmacSHA256(raw, secret).toString(CryptoJS.enc.Hex) });"
                ]
              }
            }
          ]
        },
        {
          "name": "webhook result.published",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-HuayEngine-Event",
                "value": "result.published"
              }
            ],
            "url": {
              "raw": "{{webhook_url}}",
              "host": [
                "{{webhook_url}}"
              ]
            },
            "description": "ผลงวดนี้ประกาศแล้ว — `data = { result_id, round_id }` · ล้าง cache ผลรางวัลแล้วอ่าน `GET /results` ใหม่",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"event\": \"result.published\",\n  \"data\": { \"result_id\": 501, \"round_id\": {{round_id}} },\n  \"ts\": {{$timestamp}}\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          },
          "response": [],
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "// webhook เซ็นต่างจาก Provider API: hex(HMAC-SHA256(webhook_secret, raw_body)) — ไม่มี request_id นำหน้า",
                  "const secret = pm.variables.get('webhook_secret');",
                  "if (!secret) { throw new Error('ยังไม่ได้ใส่ webhook_secret ใน environment'); }",
                  "const raw = pm.variables.replaceIn(pm.request.body.raw || '');",
                  "pm.request.body.update({ mode: 'raw', raw: raw, options: { raw: { language: 'json' } } });",
                  "pm.request.headers.upsert({ key: 'X-HuayEngine-Delivery', value: pm.variables.replaceIn('{{$guid}}') });",
                  "pm.request.headers.upsert({ key: 'X-HuayEngine-Signature', value: CryptoJS.HmacSHA256(raw, secret).toString(CryptoJS.enc.Hex) });"
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}
