การตรวจสอบข้อจำกัดการซื้อในเว็บสโตร์

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

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

ภาพรวม¶

ภาพรวมของกระบวนการตรวจสอบขีดจำกัดการซื้อเว็บช็อป รวมถึงการเรียกใช้ API ตรวจสอบข้อมูลการชำระเงินเว็บช็อป มีดังนี้

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

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

ตรวจสอบความถูกต้องของการชำระเงิน (จากข้อมูลการชำระเงิน PG เว็บที่เสร็จสมบูรณ์) รวมถึงการตรวจสอบว่าสินค้าเกินจำนวนซื้อสูงสุดหรือไม่

Request information¶

Request header¶

Request header sample¶

Content-Type : application/json
Authorization : Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY

Request body¶

Request body sample¶

{
    "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¶

• มอบสินค้าเฉพาะเมื่อการตอบกลับเป็น 100, 101
• 3001 หมายถึงออเดอร์นี้ได้รับการตรวจสอบแล้ว มอบสินค้าเฉพาะเมื่อยังไม่เคยมอบ
• 3002 หมายถึงเกินจำนวนซื้อสูงสุดของสินค้า ต้องยกเลิกการชำระเงิน ดู การประมวลผลผลการมอบ สำหรับรายละเอียด

Response body sample¶

{
    "code": 100,
    "msg": "success"
}

Response codes¶

ตารางด้านล่างเป็นรายละเอียดรหัสตอบกลับ (code)