API ตรวจสอบการจำกัดการซื้อของเว็บช็อป¶

“การตรวจสอบการจำกัดการซื้อของเว็บช็อป” คือฟังก์ชันที่ตรวจสอบว่าสินค้าที่ชำระเงินในเว็บช็อปเกินจำนวนซื้อสูงสุดหรือไม่ Hive Server ให้บริการ API ตรวจสอบข้อมูลการชำระเงินเว็บช็อป สำหรับฟังก์ชันนี้

การเตรียมล่วงหน้า¶

ก่อนเรียก API ตรวจสอบข้อมูลการชำระเงินเว็บช็อป ให้ตั้งค่าจำนวนซื้อสูงสุดใน Hive Console ที่ Hive Console > คอมมูนิตี้ & เว็บช็อป > เว็บช็อป > การจัดการสินค้า ใช้ การตั้งค่าการตรวจสอบการจำกัดจำนวนการซื้อ เพื่อตั้งค่าจำกัดการซื้อรายบัญชีและจำกัดจำนวนการซื้อสำหรับสินค้าเว็บช็อป และสามารถกำหนดจำนวนซื้อสูงสุดสำหรับแต่ละการตั้งค่าได้

โฟลว์การทำงาน¶

1. แอป: สร้างกระบวนการให้เซิร์ฟเวอร์แอปมอบสินค้าเมื่อมีการชำระเงิน PG ในเว็บช็อป ดูการตั้งค่าที่เกี่ยวข้องได้ที่ การตั้งค่าการแจ้งเตือนการชำระเงิน
2. เซิร์ฟเวอร์แอป: เมื่อผู้ใช้ซื้อสินค้า จำกัดจำนวนการซื้อ ในเว็บช็อป ให้เรียก API ตรวจสอบข้อมูลการชำระเงินเว็บช็อป ก่อนมอบสินค้า
3. Hive Server: ตรวจสอบว่าออเดอร์สินค้าของผู้ใช้เกินจำนวนซื้อสูงสุดหรือไม่ จากนั้นส่งผลลัพธ์เป็นค่า API response ไปยังเซิร์ฟเวอร์แอป
4. เซิร์ฟเวอร์แอป: มอบสินค้าเฉพาะเมื่อผล API response ผ่านเงื่อนไขการตรวจสอบ หากออเดอร์เกินจำนวนซื้อสูงสุด ต้องไม่มอบสินค้าและต้องยกเลิกการชำระเงิน เว็บช็อปจะสะท้อนเป็นจำนวนขายสำเร็จและลดจำนวนคงเหลือเฉพาะเมื่อผลตรวจสอบไม่มีปัญหา หาก API response ระบุว่าเป็นการชำระเงินไม่ถูกต้อง เซิร์ฟเวอร์แอปต้องไม่มอบสินค้าให้ผู้ใช้และต้องยกเลิกการชำระเงิน

API ตรวจสอบข้อมูลการชำระเงินเว็บช็อป¶

Validates whether the payment is valid based on completed Web PG payment information, including whether the product exceeds the maximum purchase quantity.

Request information¶

Request header¶

Request header ตัวอย่าง¶

Content-Type : application/json
X-Access-Token: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InByb2plY3RfYWJjMTIzIn0.eyJwcm9qZWN0X2lkIjoiY29tLmNvbTJ1cy5leGFtcGxlIiwidG9rZW5fdHlwZSI6ImFjY2Vzc190b2tlbiIsImdyYW50X3R5cGUiOiJwcm9qZWN0IiwiaWF0IjoxNzE1NTg0MDAwLCJleHAiOjE3MTU1ODc2MDAsImF1dGhfdmVyIjoidjQiLCJ1c2VyX2lkIjoiIiwiaXNfd2hpdGVsaXN0Ijp0cnVlfQ.signature

Request body¶

Request body ตัวอย่าง¶

{
  "type": "paid",
  "market_pid": "com.com2us.hivesdk.windows.microsoftstore.global.normal.item01",
  "order_id": "H3175513391360875943",
  "server_id": "1",
  "appid": "com.com2us.hivesdk.windows.hivepc",
  "cs_code": "20000023100",
  "paid_datetime": "2025-08-14 10:12:18",
  "quantity": "10",
  "iap_payload": "{"cs_code":20000023100,"data":{"server_id":"1","server_name":"Server 1","channels":{"channel_id":"11","channel_name":"Channel 11","characters":{"character_id":"111","character_name":"Character 111"}}}}"
}

Response body¶

• Products should be granted normally only for result_code responses 100 and 101.
• result_code 3001 is an already validated order. Grant the product only if it was not granted previously.
• result_code 3002 means the product maximum purchase quantity was exceeded. You must cancel the payment for that order. For details, see Grant result processing.

Response body ตัวอย่าง¶

สำเร็จ¶

{
  "result_code": 100,
  "result_msg": "success",
  "token_validation": {
    "result_code": 0,
    "result_msg": "success"
  }
}

การตรวจสอบ JWT ล้มเหลว¶

{
  "result_code": 2499,
  "result_msg": "JWT validation failed. See token_validation for details.",
  "token_validation": {
    "result_code": 2408,
    "result_msg": "The access token is expired. Please refresh your token."
  }
}

รหัสตอบกลับ¶