ข้ามไปที่เนื้อหา

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

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

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

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

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

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

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

เพื่อให้ API 'การตรวจสอบจำนวนเงินการชำระเงิน' ถูกเรียกใช้ตามปกติ บริษัทเกมต้องลงทะเบียน URL endpoint สำหรับออกกุญแจการตรวจสอบใน Hive Console ก่อน Hive เว็บช็อปเซิร์ฟเวอร์สามารถขอกุญแจการตรวจสอบโดยส่งมอบ PID ของสินค้า ข้อมูลราคา รหัสคูปอง ฯลฯ ไปยัง 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 เว็บช็อปเซิร์ฟเวอร์ → เกมเซิร์ฟเวอร์)

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

Request info

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

Request header

ข้อมูล API คำอธิบาย
Response Format JSON
Content-type application/json

Request body

ชื่อ ประเภท จำเป็น (จำเป็น: O, ทางเลือก: X) คำอธิบาย
game_index Integer O ตัวระบุเฉพาะของเกม
cs_code String O PlayerID ของผู้ใช้ที่ซื้อ
language String O รหัสภาษา (เช่น ko, en, ja)
market_pid String O ID เฉพาะของสินค้า
quantity Integer O จำนวนการซื้อ
original_price Integer O จำนวนเงินสินค้าเดิม
sale_price Integer O จำนวนเงินหลังการใช้ส่วนลด
coupon_price Integer O จำนวนเงินส่วนลดคูปอง
final_price Integer O จำนวนเงินการชำระขั้นสุดท้ายหลังการใช้คูปองและส่วนลด
discount_coupon_code String O รหัสคูปองส่วนลดที่ใช้ (ไม่ส่งมอบเมื่อไม่ใช้คูปอง)

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 เว็บช็อปเซิร์ฟเวอร์)

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

Response body

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

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

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

Response code

รหัสสถานะ HTTP รหัส ข้อความ คำอธิบาย
200 100 Success. สำเร็จ
  • ความสำเร็จต้องส่งมอบเป็น 100
  • เมื่อสำเร็จ gameserver_price_verify_key ต้องรวมอยู่ในการตอบสนอง

Response sample

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