TMWEASY

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
• Response
  • Response Data
    • status  [1=สำเร็จ 0=ผิดพลาด]
    • id_pay  [ถ้าสำเร็จจะได้เลข id_pay เพื่อนำไปใช้ในขั้นตอนต่อไป]
    • msg [กรณีผิดพลาด จะมีข้อความ Error ส่งมาตรงนี้]

ขั้นตอน 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
• Response
  • Response Data
    • status [1=สำเร็จ 0=ผิดพลาด]
    • ref1
    • amount_check [ยอดที่ให้โอน หน่วยเป็น สตางค์ ถ้าจะนำไปใช้ให้นำไป หาร 100 ให้หน่วยเป็นบาทก่อน]
    • qr_image_base64 [ภาพ Qr code รูปแบบ Base64]
    • msg [กรณีผิดพลาด จะมีข้อความ Error ส่งมาตรงนี้]
    • time_out [เวลาคงเหลือที่ต้องชำระ หน่วยเป็นวินาที ติดลบแสดงว่าหมดเวลา]

---

* การยกเลิก 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

ขั้นตอน 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 จริง]
  • MD5 Signature
    • การเข้ารหัส signature เพื่อให้ได้ข้อมูลมาเปรียบเทียบกับ signature ของ Webhook
    • signature ได้มาจากการนำข้อมูลแบบ json ของตัวแปล data ต่อด้วย : ต่อด้วย Api Key ของคุณ มาเข้ารหัส MD5
    • ข้อมูลที่จะเข้ารหัสจะมีรูปแบบตามนี้ data:api_key
  • Response data
    • หากทาง เว็บขอคุณ ได้รับขอมูลถูกต้องเรียบร้อย ควรมีการตอบกลับสถานะ เพื่อให้ API ทราบว่าสำเร็จแล้ว
    • ตัวอย่างการตอบกลับข้อมูลที่สำเร็จ แบบ Json {"status":1}