API Documentation

- การตั้งค่าเติมเงินสำหรับเกมส์ Ragnarok

- การตั้งค่าเติมเงินสำหรับเกมส์ Yulgang

- API เมื่อทำการบันทึกลิ้ง

- API เมื่อผู้เล่นทำการเรียกเติมเงิน

- API เมื่อผู้เล่นจ่ายเงินสำเร็จ

- การรับข้อมูล Raw JSON ในภาษา PHP

- การแปลง Array เป็น JSON Output ในภาษา PHP

- IP ที่เซิฟเวอร์ใช้ในการเรียกข้อมูล

- เมื่อมีการบันทึกลิ้งในหน้าตั้งค่า ทางเซิฟเวอร์จะส่งข้อมูลไปดังนี้

Method	Content-Type	Body
POST	application/json	RAW JSON

- ตัวอย่าง RAW JSON ที่จะส่งไปลิ้งปลายทาง

{ "action": "CheckServer" }

- เซิฟเวอร์ปลายทางต้องตอบกลับข้อมูลเป็น JSON เท่านั้น โดยมี Key ดังนี้

Key	Type	Mandatory	Description
status	Integer	Required	สถานะ 0 = สำเร็จ นอกนั้นจะไม่สามารถบันทึกลิ้งได้
message	String	Required	ข้อความ เมื่อบันทึกสำเร็จ หรือไม่สำเร็จ

- ตัวอย่างเซิฟเวอร์ปลายทางที่จำเป็นต้องตอบกลับมา

{ "status": 0, "message": "สำเร็จ" }

{ "status": 1, "message": "ไม่สำเร็จ" }

- เมื่อมีการเรียกเติมเงินจากผู้เล่น ทางเซิฟเวอร์จะส่งไปตรวจสอบไอดีว่ามีอยู่จริงหรือไม่ โดยมีรายละเอียดดังนี้

Method	Content-Type	Body
POST	application/json	RAW JSON

- ตัวอย่าง RAW JSON ที่จะส่งไปลิ้งปลายทาง

{ "action": "CheckUser", "username": "ไอดีเกมส์ ที่ผู้เล่นใส่เข้ามา" }

- เซิฟเวอร์ปลายทางต้องตอบกลับข้อมูลเป็น JSON เท่านั้น โดยมี Key ดังนี้

Key	Type	Mandatory	Description
status	Integer	Required	สถานะ 0 = สำเร็จ (มีไอดีอยู่ในระบบจริง) นอกนั้นจะไม่สามารถทำรายการต่อไปได้

- ตัวอย่างเซิฟเวอร์ปลายทางที่จำเป็นต้องตอบกลับมา

{ "status": 0, "message": "การค้นหาไอดีสำเร็จ" }

{ "status": 1, "message": "การค้นหาไอดีไม่สำเร็จ" }

- เมื่อผู้เล่นชำระเงินสำเร็จ ทางเซิฟเวอร์จะส่งข้อมูลที่เจ้าของเซิฟเวอร์ได้ตั้งค่าไว้ที่หน้าตั้งค่า โดยมีรายละเอียดดังนี้

Method	Content-Type	Body
POST	application/json	RAW JSON

- ตัวอย่าง RAW JSON ที่จะส่งไปลิ้งปลายทาง

{ "action": "TOPUP", "GameID": "ไอดีเกมส์ที่ผู้เล่นใส่", "Amount": "จำนวนเงินที่เติมสำเร็จ (เป็นจำนวนเต็มเท่านั้น)", "Point": "จำนวนพ้อยที่ได้ตั้งค่าไว้สำหรับราคาที่เติมสำเร็จ", "Bonus": "จำนวนโบนัสพ้อยที่ได้ตั้งค่าไว้สำหรับราคาที่เติมสำเร็จ", "ItemData": "รายละเอียดไอเท็มที่ได้ดังค่าไว้สำหรับราคาที่เติมสำเร็จ", "TransactionID": "หมายเลข Transaction ของการเติมเงิน" }

- ตัวอย่างเช่น

{ "action": "TOPUP", "GameID": "rankserver", "Amount": "150", "Point": "1500", "Bonus": "1500", "ItemData": "White_Potion:50,Red_Potion:50,503:70", "TransactionID": "RSP41AED970398E" }

- เซิฟเวอร์ปลายทางต้องตอบกลับข้อมูลเป็น JSON เท่านั้น โดยมี Key ดังนี้

Key	Type	Mandatory	Description
status	Integer	Required	สถานะ 0 = สำเร็จ เซิฟเวอร์ปลายทางทำงานสำเร็จ
message	String	Required	ข้อความ เมื่อบันทึกสำเร็จ หรือไม่สำเร็จ

- ตัวอย่างเซิฟเวอร์ปลายทางที่จำเป็นต้องตอบกลับมา

{ "status": 0, "message": "การทำงานสำเร็จ" }

{ "status": 1, "message": "การทำงานล้มเหลว" }

<?php // รับ Raw Post $data = file_get_contents('php://input'); // แปลง Raw Post JSON เป็น PHP Object $data = json_decode($data, true); ?>

<?php function Array2JSON(array $data) { return json_encode($data); } // ตัวอย่างการสร้าง Array $data = array("status" => 1, "message" => "การทำงานสำเร็จ"); // แปลง Array เป็น JSON $data = Array2JSON($data); // วิธีตอบกลับเป็นข้อมูล JSON header("Content-Type: application/json; charset=UTF-8"); exit($data); ?>

ดาวน์โหลดไฟล์สำหรับเกมส์ Ragnarok กดตรงนี้

1. เมื่อดาวน์โหลดเสร็จจะได้ไฟล์ RagnarokPayment.zip ตามภาพ

2. กดแตกซิป จะได้ไฟล์ callback.php, rank_payment.txt ตามภาพ

สามารถใช้โปรแกรม 7Z เพื่อแตกซิป

2. เปิดไฟล์ callback.php และแก้ไข $_CONFIG["DB_NAME"], $_CONFIG["DB_USER"], $_CONFIG["DB_PWD"] เพื่อใช้เชื่อมต่อ Database ตามภาพ

3. เมื่อแก้ไขไฟล์ callback.php สำเร็จให้นำขึ้นไปไว้ใน Server และนำลิ้งไปใส่ในหน้าตั้งค่า ตามภาพ และกดบันทึก หากสามารถใช้งานได้จะสามารถบันทึกลิ้งได้

วิธีไปหน้าตั้งค่า ไปที่หน้ากระทู้ -> เข้าสู่หน้าจัดการระบบเติมเงิน -> ตั้งค่า -> ลิ้งของหลังบ้าน (API Link)

4. Copy ไฟล์ rank_payment.txt ไปไว้ใน Folder เซิฟเวอร์/npc/rank_payment.txt เปิดไฟล์ scripts_custom.conf ใส่บันทัดสุดท้ายว่า "npc/rank_payment.txt", ตามภาพ

รองรับ rathena, herc.ws

5. เปิดเซิฟเวอร์และทดสอบเติมเงิน ไปที่ ตั้งค่า -> ตั้งค่าการเติมเงิน และของรางวัล ตั้งค่าการเติมเงินให้เรียบร้อย ตามภาพ

6. ทดสอบเติมเงิน ไปที่ ตั้งค่า -> ทดสอบเติมเงิน กดใส่ไอดีและจำนวนเงิน กดทดลองเติมเงิน ตามภาพ

วิธีไปหน้าตั้งค่า ไปที่หน้ากระทู้ -> เข้าสู่หน้าจัดการระบบเติมเงิน -> ตั้งค่า -> ทดสอบเติมเงิน

7. เมื่อการทดสอบเติมเงินสำเร็จ ของรางวัลจะเข้าไอดีทันที ตามภาพ ถือเป็นอันเสร็จสิ้นการตั้งค่าทั้งหมด

ดาวน์โหลดไฟล์สำหรับเกมส์ Yulgang กดตรงนี้

1. เมื่อดาวน์โหลดเสร็จจะได้ไฟล์ YulgangPayment.zip ตามภาพ

2. กดแตกซิป จะได้ไฟล์ callback.php ตามภาพ

สามารถใช้โปรแกรม 7Z เพื่อแตกซิป

3. เปิดไฟล์ callback.php และแก้ไข $_CONFIG["DB_HOST"], $_CONFIG["DB_USER"], $_CONFIG["DB_PWD"], $_CONFIG["DB_NAME"] เพื่อใช้เชื่อมต่อ Database ตามภาพ

4. เมื่อแก้ไขไฟล์ callback.php สำเร็จให้นำขึ้นไปไว้ใน Server และนำลิ้งไปใส่ในหน้าตั้งค่า ตามภาพ และกดบันทึก หากสามารถใช้งานได้จะสามารถบันทึกลิ้งได้

วิธีไปหน้าตั้งค่า ไปที่หน้ากระทู้ -> เข้าสู่หน้าจัดการระบบเติมเงิน -> ตั้งค่า -> ลิ้งของหลังบ้าน (API Link)

5. เปิดเซิฟเวอร์และทดสอบเติมเงิน ไปที่ ตั้งค่า -> ตั้งค่าการเติมเงิน และของรางวัล ตั้งค่าการเติมเงินให้เรียบร้อย ตามภาพ

6. ทดสอบเติมเงิน ไปที่ ตั้งค่า -> ทดสอบเติมเงิน กดใส่ไอดีและจำนวนเงิน กดทดลองเติมเงิน ตามภาพ

วิธีไปหน้าตั้งค่า ไปที่หน้ากระทู้ -> เข้าสู่หน้าจัดการระบบเติมเงิน -> ตั้งค่า -> ทดสอบเติมเงิน

ไอพีที่เซิฟเวอร์จะใช้ในการเรียกข้อมูลมีไอพีเดียวเท่านั้นคือ 103.91.191.226 เพื่อความปลอดภัยโปรดอนุญาตไอนี้ไอพีเดียวเท่านั้น