API พร้อมเพย์ - สแกน Qr Code Webhook คืออะไร ?
คือระบบตรวจสอบการโอนเงินอัตโนมัติ โดยโอนผ่านช่องทางพร้อมเพย์ รองรับการสแกนจ่ายด้วย QR code เป็นที่นิยมใช้ ง่าย สะดวก กับลูกค้าที่มาชำระเงิน แค่สแกนจ่าย แล้ว API จะส่งข้อมูลการชำระไปให้ Server ของคุณธนาคารที่ใช้รับยอด รองรับ 1 ธนาคารดังนี้
1. ธนาคาร กสิกร : ต้องผูก พร้อมเพย์ เบอร์โทร - เลขบัตร ปชช บนธนาคาร กสิกร ก่อน
ช่องทางการโอนจ่ายของลูกค้า
✦ รองรับ ทุกธนาคาร ผ่านพร้อมเพย์
✦ รองรับ แอพวอเลทที่มีสแกน QR Promptpay เช่น TrueWallet , mPAY , เป๋าตัง
Download PHP Script
สำหรับผู้ที่ติดตั้งไม่เป็นเรามีบริการติดตั้งให้ ติดต่อมาที่ Facebook ครับ
สำหรับนักพัฒนา API เข้ากับภาษาอื่นๆ มี 3 ขั้นตอนดังนี้
Url API
- http://tmwallet.thaighost.net/api_pph.php
หรือ - http://www.tmweasyapi.com/api_pph.php
ข้อมูลที่จำเป็น
- tmweasy_user = user ที่ลงทะเบียนกับ tmweasy
- password = รหัสผ่าน
- con_id = เลข con_id ที่ได้จากการเปิดใช้งานระบบ พร้อมเพย์ QR Webhook ที่หน้า seting
ขั้นตอน 1 . สร้าง ID Pay
- Request Method GET
- Request Parameters
- username
- password
- con_id
- amount [*ยอดที่ต้องการรับชำระ จำนวนเต็มไม่มีทศนิยม]
- ref1 [*id ของลูกค้าที่ชำระ เช่น username , email , uid , เบอร์โทร ฯลฯ]
- ip [ip ของลูกค้าที่ทำรายการ]
- method=create_pay
- ตัวอย่าง http://tmwallet.thaighost.net/api_pph.php?username=xx&password=xx&amount=50&ref1=xx&con_id=xx&ip=xx&method=create_pay
- Request Parameters
- Response
- Response Data
- status [1=สำเร็จ 0=ผิดพลาด]
- id_pay [ถ้าสำเร็จจะได้เลข id_pay เพื่อนำไปใช้ในขั้นตอนต่อไป]
- msg [กรณีผิดพลาด จะมีข้อความ Error ส่งมาตรงนี้]
- Response Data
ขั้นตอน 2 . รายละเอียดการชำระ และ QR code
- Request Method GET
- Request Parameters
- username
- password
- con_id
- id_pay
- promptpay_id [เลขพร้อมเพย์ที่ผูกไว้กับธนาคารของคุณ เช่น เบอร์โทร , เลขบัตร ปชช}
- type =[ชนิดพร้อมเพย์ 01 คือ แบบเบอร์โทร 02 คือ แบบ เลขบัตร ปชช]
- method=detail_pay
- ตัวอย่าง http://tmwallet.thaighost.net/api_pph.php?username=xx&password=xx&con_id=xx&id_pay=xx&type=01&promptpay_id=0812345678&method=detail_pay
- Request Parameters
- Response
- Response Data
- status [1=สำเร็จ 0=ผิดพลาด]
- ref1
- amount_check [ยอดที่ให้โอน หน่วยเป็น สตางค์ ถ้าจะนำไปใช้ให้นำไป หาร 100 ให้หน่วยเป็นบาทก่อน]
- qr_image_base64 [ภาพ Qr code รูปแบบ Base64]
- msg [กรณีผิดพลาด จะมีข้อความ Error ส่งมาตรงนี้]
- time_out [เวลาคงเหลือที่ต้องชำระ หน่วยเป็นวินาที ติดลบแสดงว่าหมดเวลา]
- Response Data
* การยกเลิก Id Pay สามารถทำได้เมื่อ time out ติดลบแล้วเท่านั้น
- Request Method GET
- Request Parameters
- username
- password
- con_id
- id_pay
- method=cancel
- ตัวอย่าง http://tmwallet.thaighost.net/api_pph.php?username=xx&password=xx&con_id=xx&id_pay=xx&method=cancel
- Request Parameters
ขั้นตอน 3 . การรับข้อมูลการเติมเงินจาก Webhook
- Webhook ส่งข้อมูลไป Url Webhook คุณด้วย Method POST
- Post Body Parameters
- data [คือข้อมูลการเติมเงิน ในรูปแบบ Json]
ตัวอย่างข้อมูลที่ส่งมา {"id_pay":"754349","ref1":"testpay","amount_check":"1901","amount":"19.00","date_pay":"2024-07-29 14:14"} - signature [ลายเซ็นข้อมูล ใช้เพื่อตรวจสอบว่าเป็นข้อมูลที่ส่งมาจาก API จริง]
- data [คือข้อมูลการเติมเงิน ในรูปแบบ Json]
- MD5 Signature
- การเข้ารหัส signature เพื่อให้ได้ข้อมูลมาเปรียบเทียบกับ signature ของ Webhook
- signature ได้มาจากการนำข้อมูลแบบ json ของตัวแปล data ต่อด้วย : ต่อด้วย Api Key ของคุณ มาเข้ารหัส MD5
- ข้อมูลที่จะเข้ารหัสจะมีรูปแบบตามนี้ data:api_key
- Response data
- หากทาง เว็บขอคุณ ได้รับขอมูลถูกต้องเรียบร้อย ควรมีการตอบกลับสถานะ เพื่อให้ API ทราบว่าสำเร็จแล้ว
- ตัวอย่างการตอบกลับข้อมูลที่สำเร็จ แบบ Json {"status":1}
- Post Body Parameters
![](images/tmweasy_api.png)
![](images/facebook-messenger-logo.png)