MODULE FOR WHMCS
MANUAL DOCUMENT [ภาษาไทย]
Version 1.0.0
การติดตั้ง ChillPay Module for WHMCS
1. ร้านค้าทำการ Download ChillPay Module จากเว็บไซต์ ChillPay
- 1.1 เลือกเมนู Plug-in
- 1.2 เลือก Tab WHMCS
- 1.3 กดปุ่ม MODULE CHILLPAY WHMCS เพื่อทำการ Download
2. ร้านค้านำไฟล์ ChillPay Module ไปวางที่ Server WHMCS ของร้านค้า path /whmcs/modules/gateways
3. ไปที่หน้า Apps & Integrations
4. กดค้นหา ใส่ข้อความ “ChillPay”
5. เลือก ChillPay และกดปุ่ม Activate
6. เมื่อ Activate แล้ว ระบบจะแสดงหน้า Setting ของ ChillPay
- 6.1 ข้อมูล Production
- 6.2 ข้อมูล Sandbox
7. ไปที่หน้าเว็บไซต์ของ ChillPay จากนั้นเลือกเมนู Setting > API ทำการคัดลอกข้อมูล (Copy) Merchant Code, API Key และ MD5 Secret Key
8. นำข้อมูลที่คัดลอกมาจากหน้าเว็บไซต์ ChillPay ตามรูปภาพข้อที่ 6. มาใส่ในช่องข้อมูลของ WHMCS ตามรูปภาพด้านล่าง หากต้องการทดสอบด้วยระบบทดสอบ (Sandbox) คลิกเลือก Tick to enable test mode เมื่อระบุข้อมูลครบแล้ว จากนั้นกดปุ่ม Save Changes
9. ร้านค้าสามารถระบุช่องทางการชำระเงินได้ โดยการนำข้อมูล Route No. ในหน้า Payment Channel จากหน้าเว็บไซต์ ChillPay มาระบุในช่อง Parameter ของ WHMCS ตามข้อ 7.
10. เมื่อระบุข้อมูลครบแล้ว จากนั้นกดปุ่ม Save Changes
11. เมื่อเปิดช่องทางการชำระเงินแล้ว ให้ร้านค้าทำการคัดลอก (Copy) URL Background และ URL Result
12. ไปที่หน้าเว็บไซต์ของ ChillPay จากนั้นเลือกเมนู Setting > Payment Channel แล้วนำข้อมูล Url ที่คัดลอกมาวางในทุกช่องทางการชำระเงินที่ร้านค้าเปิด แล้วกดปุ่มบันทึก
การตรวจสอบสถานะ (Status)
1. กรณีตรวจสอบสถานะการชำระเงินจาก WHMCS (Payment Status) ร้านค้าสามารถตรวจสอบสถานะ (Status) ของแต่ละรายการได้จากเมนู Orders > List All Orders
2. กรณีตรวจสอบสถานะจาก ChillPay ร้านค้าสามารถตรวจสอบสถานะ (Status) ของแต่ละรายการได้จากเมนู Transaction > Payment Transaction โดยสถานะอ้างอิงจาก ภาคผนวก ก.
ตัวอย่างขั้นตอนการชำระเงินผ่าน WHMCS
ข้อมูลการทดสอบบน Sandbox
ข้อมูลหมายเลขบัตรเครดิต สำหรับทดสอบบน Sandbox
| หมายเลขบัตรเครดิต – สำหรับทดสอบ Credit Card |
|---|
| 1. Visa Card Number : 4444-4444-4444-4444 Expired Date : 09/2030 CVV2 : 123 |
| 2. Master Card Card Number : 3333-3333-3333-3333 Expired Date : 09/2030 CVV2 : 123 |
| 3. JCB Card Number : 2222-2222-2222-2222 Expired Date : 09/2030 CVV2 : 123 |
| 4. UnionPay Card Number : 4444-4444-4444-4444 Expired Date : 09/2030 CVV2 : 123 SMS Code : 111111 |
ภาคผนวก
ภาคผนวก ก. รหัสผลของการทำรายการ
| Response Code | Description | Remark |
|---|---|---|
| 200 | ทำรายการสำเร็จ | Success |
| 1001 | ข้อมูลพารามิเตอร์ไม่ถูกต้อง | Invalid Parameter |
| 1002 | รหัสร้านค้าไม่ถูกต้อง | Invalid Merchant Code |
| 1003 | API Key ไม่ถูกต้อง | Invalid API Key |
| 1004 | Bank Channel Code ไม่ถูกต้อง | Invalid Channel ID |
| 1005 | Route No. ไม่ถูกต้อง | Invalid Route No |
| 1006 | Order Number ไม่ถูกต้อง | Invalid Order No |
| 1007 | จำนวนเงินไม่ถูกต้อง | Invalid Amount |
| 1008 | Customer ID/Customer Name ไม่ถูกต้อง | Invalid Customer ID |
| 1009 | เบอร์โทรศัพท์มือถือไม่ถูกต้อง | Invalid Mobile Phone Number |
| 1010 | รหัสภาษาไม่ถูกต้อง | Invalid Language Code |
| 1011 | รหัส Checksum ไม่ถูกต้อง | Invalid Checksum |
| 1012 | เลขที่อ้างอิงรายการ(Transaction ID) ไม่ถูกต้อง | Invalid Transaction ID |
| 1013 | รายละเอียดการชำระเงินไม่ถูกต้อง | Invalid Description |
| 1014 | ข้อมูล Token Flag ไม่ถูกต้อง | Invalid Token Flag |
| 1015 | ข้อมูลรหัสสกุลเงินไม่ถูกต้อง | Invalid Currency Code |
| 1016 | ข้อมูล Credit Card Token ไม่ถูกต้อง | Invalid Credit Card Token |
| 1018 | ข้อมูล IP Address ไม่ถูกต้อง | Invalid IP Address |
| 2001 | Account ของร้านค้ายังไม่ได้รับการอนุมัติ | Account Unauthorized |
| 2002 | API Key ร้านค้ายังไม่ได้รับการอนุมัติ | Invalid Merchant API Key |
| 2003 | ข้อมูล Checksum ไม่ถูกต้อง | Invalid Checksum Data |
| 2004 | ไม่พบข้อมูลช่องทางการชำระเงินสำหรับร้านค้า | Invalid Merchant Routing |
| 2005 | จำนวนเงินที่ชำระน้อยกว่าจำนวนเงินขั้นต่ำสุดที่กำหนดไว้ | Payment minimum price {0} less than {1}เช่น Payment minimum price 15.00 less than 20.00 |
| 2006 | จำนวนเงินที่ชำระมากกว่าจำนวนเงินขั้นสูงสุดที่กำหนดไว้ | Payment maximum price {0} is over than {1}เช่น Payment maximum price 55000.00 is over than 50000.00 |
| 2007 | ไม่สามารถสร้างรายการรับชำระเงินได้ | Request Transaction Error |
| 2008 | ไม่สามารถสร้างรายการ Token รับชำระเงินได้ | Request Transaction Token Error |
| 2009 | ไม่พบข้อมูลรายการที่ต้องการ | Transaction Not Found |
| 2010 | ไม่พบข้อมูล Credit Card Token ที่ใช้ชำระเงิน | Credit Card Token Not Found |
| 2011 | ไม่พบข้อมูลรหัสสกุลเงินที่ใช้ชำระเงิน | Currency Code Not Supported |
| 2014 | ไม่พบ Email หรือรูปแบบ Email ไม่ถูกต้อง | Invalid/Incorrect email address. |
| 3001 | ระบบเกิดข้อผิดพลาดไม่สามารถทำรายการได้ | System Error |
| 3002 | ระบบไม่สามารถให้บริการได้ในช่วงเวลา xx:xx:xx – xx:xx:xx กรุณาทำรายการเข้ามาใหม่อีกครั้ง | System is unavailable at xx:xx:xx – xx:xx:xx o’clock. Please try again later. |
ภาคผนวก ข. สกุลเงินที่รองรับ (Currency)
| No. | Currency |
|---|---|
| 1 | Thai baht (฿) |
| 2 | United States (US) dollar ($) |
| 3 | Euro (€) |
| 4 | Japanese yen (¥) |
| 5 | Pound sterling (£) |
| 6 | Australian dollar ($) |
| 7 | New Zealand dollar ($) |
| 8 | Hong Kong dollar ($) |
| 9 | Singapore dollar ($) |
| 10 | Swiss franc (CHF) |
| 11 | Malaysian ringgit (RM) |
| 12 | Chinese yuan (¥) |