การตรวจสอบจำนวนเงินการชำระเงิน API

API 'การตรวจสอบจำนวนเงินการชำระเงิน' รองรับการตรวจสอบจำนวนเงินการชำระที่ได้รับส่วนลดโดยใช้กุญแจการตรวจสอบที่ออกโดยเกมเซิร์ฟเวอร์เมื่อผู้ใช้ต้องการซื้อสินค้าที่มีจำนวนเงินที่เปลี่ยนแปลงเนื่องจากส่วนลดสินค้าในเว็บช็อปหรือการใช้คูปอง เมื่อการชำระเงินเสร็จสิ้นด้วยกุญแจการตรวจสอบที่ถูกต้อง เกมเซิร์ฟเวอร์สามารถมอบสินค้าได้ในที่สุด

ขั้นตอนการทำงาน¶

อธิบายลำดับการประมวลผลโดยรวมและการประมวลผลระหว่างระบบตั้งแต่การเรียกใช้ API 'การตรวจสอบจำนวนเงินการชำระเงิน' จนถึงการมอบสินค้าขั้นสุดท้าย

การทำงานและการไหลของข้อมูลระหว่าง Hive Server และแอปเซิร์ฟเวอร์มีดังนี้:

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

ข้อกำหนดเบื้องต้น¶

เพื่อให้ API 'การตรวจสอบจำนวนเงินการชำระเงิน' ถูกเรียกใช้ตามปกติ โปรดลงทะเบียน URL endpoint สำหรับออกกุญแจการตรวจสอบใน Hive Console ก่อน Hive Server สามารถขอกุญแจการตรวจสอบโดยส่งมอบ ID ของสินค้า ข้อมูลราคา รหัสคูปอง ฯลฯ ไปยัง URL นั้น

ลงทะเบียน API endpoint (callback URL) ใน Hive Console > Community & Web Shop > Web Shop > Web Shop Settings > Payment Amount Verification ตามการตั้งค่าการตรวจสอบความถูกต้องของการชำระเงิน

• รูปแบบ Callback URL สามารถตั้งค่าได้อย่างอิสระโดยบริษัทเกม
• ข้อกำหนด API อื่น ๆ ให้ปฏิบัติตามรายการการกำหนดค่า API request และการกำหนดค่า API response ด้านล่าง

การเรียกใช้ API (Hive Server → แอปเซิร์ฟเวอร์)¶

อธิบายวิธีการเรียกใช้ API 'การตรวจสอบจำนวนเงินการชำระเงิน' จาก Hive Server ไปยังแอปเซิร์ฟเวอร์

Request info¶

• Endpoint: Endpoint (callback URL) ที่ตั้งค่าไว้ใน Hive Console > Community & Web Shop > Web Shop > Web Shop Settings > Payment Amount Verification
• HTTP Method: POST

Request header¶

Request body¶

Request body sample¶

{
    "game_index": 1001,
    "cs_code": "20000010000",
    "language": "ko",
    "market_pid": "item01",
    "quantity": 1,
    "original_price": 10000,
    "sale_price": 8000,
    "coupon_price": 1000,
    "final_price": 7000,
    "discount_coupon_code": "SUMMER2025"
}

การตอบสนอง API (แอปเซิร์ฟเวอร์ → Hive Server)¶

อธิบายข้อมูลการตอบสนองที่ส่งจากแอปเซิร์ฟเวอร์ไปยัง Hive Server เป็นผลจากการเรียกใช้ API 'การตรวจสอบจำนวนเงินการชำระเงิน'

Response body¶

• ประเภทข้อมูล: JSON

• พารามิเตอร์

  ชื่อ	ประเภท	คำอธิบาย
  code	Integer	รหัสผลลัพธ์ (100: สำเร็จ)
  gameserver_price_verify_key	String	กุญแจการตรวจสอบที่จะใช้สำหรับการตรวจสอบการชำระเงิน (ต้องส่งคืนเมื่อสำเร็จ)

Response code¶

• ความสำเร็จต้องส่งมอบเป็น 100
• เมื่อสำเร็จ gameserver_price_verify_key ต้องรวมอยู่ในการตอบสนอง

Response sample¶

{
    "code": 100,
    "gameserver_price_verify_key": "a1b2c3d4e5f6g7h8i9j0"
}