เอกสารสำหรับนักพัฒนา EZ2Pay

EZ2Pay คือระบบขายในเกม เซิร์ฟเวอร์เกมสร้าง Order ผู้เล่นจ่ายบนหน้าจ่ายของ EZ2Pay แล้ว EZ2Pay แจ้งเซิร์ฟเวอร์เกมว่าต้องส่งของอะไรให้ใคร

EZ2Pay เป็นผู้ขายต่อผู้เล่น คุณขายของในเกมให้ EZ2Pay และรับเงินค่าสินค้าตามอัตราที่แสดงใน Dashboard

amount คือราคาขายเต็มที่ผู้เล่นจ่ายให้ EZ2Pay ไม่ใช่เงินที่คุณได้รับ "100.00" คือผู้เล่นจ่าย 100 บาท ส่วนเงินที่คุณได้รับและวันที่รับได้ ดูใน Dashboard

การขายทำงานอย่างไร

ผู้เล่นกดซื้อในเกม
  -> เซิร์ฟเวอร์เกม: POST /v1/orders ได้ checkout_url
  -> ผู้เล่นจ่ายบนหน้าจ่ายของ EZ2Pay
  -> EZ2Pay ยืนยันเงินเข้าแล้ว POST Webhook ที่ลงนามไปยังเซิร์ฟเวอร์เกม
  -> เซิร์ฟเวอร์เกมตรวจลายเซ็น แล้วถามกลับ GET /v1/orders/{id}
  -> เซิร์ฟเวอร์เกมให้ของครั้งเดียวใน transaction เดียว
  -> เซิร์ฟเวอร์เกม: POST /v1/orders/{id}/delivered แล้วตอบ 200
  -> ผู้เล่นกลับมาที่ return_url

กฎหลัก

1. การซื้อเริ่มจากในเกมเท่านั้น เว็บ EZ2Pay ไม่มีหน้าเติมเงิน
2. ราคามาจาก SKU ของ EZ2Pay เกมส่งแค่รหัส SKU ห้ามส่งราคา
3. ไม่มีโหมดทดสอบ ใช้ปุ่มทดสอบ Webhook แล้วซื้อจริงด้วย SKU ราคาต่ำสุดหลังเปิดขาย
4. ห้ามแสดงชื่อหรือเครดิตของ EZ2Pay ในเกม ชื่อผู้ขายแสดงบนหน้าจ่ายและใบเสร็จของ EZ2Pay เอง
5. ส่งของจากเซิร์ฟเวอร์เท่านั้น ห้ามส่งจาก client หรือจากหน้า return_url
6. เก็บเงินเป็นจำนวนเต็มสตางค์ 1 บาท = 100 สตางค์ ห้ามใช้ float

หน้าเอกสาร

สำหรับเครื่องมือ AI และตัวสร้างโค้ด: llms.txt และ OpenAPI

สิ่งที่ต้องมี

• เซิร์ฟเวอร์เกมที่มี URL แบบ HTTPS สาธารณะสำหรับรับ Webhook
• ฐานข้อมูลถาวร เช่น PostgreSQL เพื่อส่งของครั้งเดียวต่อ Order
• ภาษาฝั่งเซิร์ฟเวอร์ใดก็ได้ที่เรียก HTTPS และคำนวณ HMAC-SHA256 ได้ ไม่ต้องติดตั้งไลบรารีของ EZ2Pay

คำศัพท์

เมื่อผู้เล่นมีปัญหา

ผู้เล่นติดต่อทีมเกมของคุณก่อน ผ่านช่องทางในใบเสร็จ จากนั้นค้น Order ใน Dashboard ด้วย Order ID หรือ Player ID เพื่อดูสถานะ ส่งแจ้งซ้ำ หรือส่งเรื่องให้ EZ2Pay ดูข้อผิดพลาดและวิธีแก้