ตรวจสอบคูปองส่วนลด

นี่คือ API ที่ใช้ตรวจสอบว่าคูปองส่วนลดสามารถใช้ได้หรือไม่

Note

Please refer to here for identifier policies.

ข้อมูลการร้องขอ¶

รายการ	คำอธิบาย
URL การผลิต	https://coupon.withhive.com/tp/coupon/discount_coupon_verify
URL แซนด์บ็อกซ์	https://sandbox-coupon.withhive.com/tp/coupon/discount_coupon_verify
วิธีการ	POST
รูปแบบการตอบกลับ	JSON

ส่วนหัวคำขอ¶

รายการ	คำอธิบาย	ประเภท	จำเป็น	หมายเหตุ
Content-Type	application/json	String	Y
Authorization	Bearer	String	Y	วิธีตรวจสอบคีย์การตรวจสอบสิทธิ์ Hive: App Center > การจัดการโปรเจกต์ > รายละเอียดเกม > ข้อมูลพื้นฐาน > คีย์การตรวจสอบสิทธิ์ Hive

พารามิเตอร์การร้องขอ¶

ชื่อ	ประเภท	จำเป็น (จำเป็น: M, ไม่จำเป็น: O)	คำอธิบาย
game_index	จำนวนเต็ม	M	ดัชนีเกมใน App Center
coupon	สตริง	M	หมายเลขคูปอง
cs_code	สตริง	M	รหัส CS ของผู้ใช้ในเกม
language	สตริง	O	การแสดงผลข้อความตอบกลับ รหัสภาษา (ค่าเริ่มต้นคือภาษาอังกฤษ) ใช้เมื่อแสดงข้อความโดยตรงบนหน้าจอ
discount_type	สตริง	O	ประเภทส่วนลด (กำหนดเป็น 'percent')

การตอบกลับ¶

ชื่อ	ประเภท	จำเป็น (จำเป็น: M, ไม่จำเป็น: O)	คำอธิบาย
code	จำนวนเต็ม	M	รหัสการตอบกลับ (103: ใช้งานได้)
message	สตริง	M	ข้อความผลลัพธ์ตามรหัสการตอบกลับ
info	อ็อบเจ็กต์	O	หากใช้งานได้ จะตอบกลับด้วยเปอร์เซ็นต์คูปองส่วนลดในรายการย่อยเปอร์เซ็นต์
info > percent	จำนวนเต็ม	O	เปอร์เซ็นต์คูปองส่วนลด

ตัวอย่างคำขอ¶

curl -L -v
 -d '{"game_index": 539,"coupon": "HIVESDKTEST","cs_code": "123456789","language": "ko","discount_type":"percent"}'
 -H "Content-Type: text/html"
 -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"
 https://sandbox-coupon.withhive.com/tp/coupon/api

>> POST /tp/coupon/discount_coupon_verify HTTP/2
> Host: sandbox-coupon.withhive.com 
> user-agent: curl/7.68.0 
> Content-Type: application/json
> Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY
> Accept: */*
> Content-Length: 105

ตัวอย่างการตอบกลับ¶

< HTTP/2 200
< server: nginx
< date: Wed, 27 Aug 2025 12:22:34 GMT
< content-type: application/json; charset=utf-8
{"code":103,"message":"The coupon will not be used until payment is completed.","info": {"percent": 30}}

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

รหัส	คำอธิบาย	ข้อความ
103	ใช้งานได้	คูปองจะไม่ถูกใช้จนกว่าการชำระเงินจะเสร็จสมบูรณ์
200	ข้อผิดพลาดพารามิเตอร์คำขอ	ขาดพารามิเตอร์บางอย่างหรือชื่อพารามิเตอร์ไม่ถูกต้อง
202	เกินขีดจำกัดการใช้งานสำหรับบัญชี	คุณได้เกินขีดจำกัดการใช้งานคูปองที่มีอยู่
203	เกินขีดจำกัดการใช้งานสำหรับคูปองกลุ่ม	คุณได้เกินขีดจำกัดการใช้งานคูปองที่มีอยู่!
204	ข้อมูลคูปองที่ออกและเกมไม่ตรงกัน	สิ่งนี้สามารถใช้ได้เฉพาะในกรณีการแลกเปลี่ยนคูปองของเกมที่เกี่ยวข้อง
205	คูปองที่ไม่สามารถใช้ได้	คูปองนี้ไม่สามารถใช้ได้
206	คูปองส่วนลดไม่สามารถใช้ในการแลกคูปอง	คูปองที่กรอกสามารถใช้ในร้านค้าออนไลน์
300	ความยาวหมายเลขคูปองไม่ถูกต้อง	หมายเลขคูปองไม่ถูกต้อง กรุณากรอกใหม่
302	คูปองที่ไม่มีอยู่	นี่คือหมายเลขคูปองที่ไม่มีอยู่ กรุณาตรวจสอบอีกครั้ง
303	คูปองที่กำลังใช้งานอยู่	คูปองนี้ถูกใช้ไปแล้ว
304	คูปองที่ถูกใช้ไปแล้ว	คูปองนี้ถูกใช้ไปแล้ว
305	เกินขีดจำกัดการใช้งานคูปอง (ใช้คูปองที่ไม่ซ้ำกันทั้งหมด)	คูปองที่ออกทั้งหมดถูกใช้ไปแล้ว
306	คูปองหมดอายุ	คูปองนี้หมดอายุแล้ว
311	คูปองที่ถูกยกเลิก	คูปองนี้ถูกยกเลิกแล้ว
312	คูปองในช่วงเวลาก่อนการใช้งาน	ยังไม่ถึงช่วงเวลาการใช้คูปอง (คูปองทดสอบไม่รวมในการตรวจสอบ)
400	ข้อผิดพลาดในการส่งข้อมูล (ล้มเหลวทั้งหมด)	การใช้คูปองล้มเหลว หากยังล้มเหลวอยู่ กรุณาติดต่อบริการลูกค้า
401	ข้อผิดพลาดในการส่งข้อมูล (ล้มเหลวบางส่วน)	การใช้คูปองล้มเหลวบางส่วน กรุณาติดต่อบริการลูกค้า
500	ข้อผิดพลาดในการสื่อสารกับฐานข้อมูล	การใช้คูปองล้มเหลว หากยังล้มเหลวอยู่ กรุณาติดต่อบริการลูกค้า
501	ข้อผิดพลาดในการสื่อสารกับเซิร์ฟเวอร์	การใช้คูปองล้มเหลว หากยังล้มเหลวอยู่ กรุณาติดต่อบริการลูกค้า