Easy Bank

คู่มือการใช้งานระบบตรวจสอบยอดโอน
กลับหน้าแดชบอร์ด
GETTING STARTED

รับรายการ ตรวจสอบ แล้วจึงยืนยันยอด

ระบบรับข้อความแจ้งเงินเข้าจาก SMS ผ่าน iPhone Shortcuts และบันทึกการยืนยันไว้กับรายการแต่ละรายการ เพื่อป้องกันการนำรายการเดิมไปใช้ซ้ำ ประวัติรายการจะแสดงย้อนหลัง 3 วันและล้างรายการเก่าอัตโนมัติ

01

ส่งข้อความเข้าระบบ

ตั้ง Automation ในแอปคำสั่งลัดให้ส่ง SMS แจ้งเงินเข้ามายัง POST /api/webhook พร้อมข้อความในช่อง body และชื่อธนาคารในช่อง sender

02

ตรวจสอบรายการ

ดูยอด ธนาคาร วันเวลา และข้อความ SMS ต้นทางบนแดชบอร์ด สถานะ ยังไม่ถูกยืนยัน หมายถึงรายการยังว่าง ส่วน ยืนยันแล้ว จะแสดงชื่อผู้ยืนยันและเวลา

03

ยืนยันยอดเพียงครั้งเดียว

กรอกยอด ธนาคาร ชื่อผู้ยืนยัน และเลขอ้างอิงในฟอร์มหน้าแรก ระบบจะบันทึกรายการที่ยังว่างทันที หากรายการนั้นถูกใช้แล้วจะไม่ยืนยันซ้ำ

เชื่อมต่อ iPhone Shortcuts

  1. เปิดแอป คำสั่งลัด → การทำงานอัตโนมัติ แล้วเลือกเหตุการณ์เมื่อได้รับข้อความจากธนาคาร
  2. เพิ่มการทำงาน รับเนื้อหาของ URL ตั้ง URL เป็น https://api-payments.coder-studio.online/api/webhook และวิธีการเป็น POST
  3. ส่ง JSON ที่มี body เป็นข้อความ SMS และ sender เป็นชื่อผู้ส่ง เช่น KBANK
  4. ทดสอบด้วย SMS ตัวอย่าง แล้วตรวจว่ารายการใหม่ปรากฏบนหน้าแดชบอร์ด
{
  "body": "KBANK รับโอน 123.45 บาท 02/11 12:00",
  "sender": "KBANK"
}

เชื่อมต่อระบบคำสั่งซื้อผ่าน API

ใช้ GET /api/transactions/match?amount=123.45&bank=KBANK เพื่อดูว่ามีรายการว่างหรือไม่ จากนั้นเรียก POST /api/transactions/claim เพื่อยืนยันจริง อย่าใช้ผล GET เป็นหลักฐานการยืนยัน เพราะรายการอาจถูกผู้อื่นใช้ระหว่างนั้น

{
  "amount": "123.45",
  "bank": "KBANK",
  "claimedBy": "ระบบคำสั่งซื้อ",
  "reference": "ORDER-123"
}
200 ยืนยันสำเร็จ404 ไม่พบรายการที่ตรง409 รายการที่ตรงถูกใช้แล้ว

หากมียอดเท่ากันหลายรายการ ระบบเลือกรายการล่าสุดที่ยังไม่ถูกยืนยัน ชื่อผู้ยืนยันเป็นข้อมูลที่ผู้เรียกส่งมาเอง ระบบยังไม่ได้พิสูจน์ตัวตนผู้ใช้

ไปหน้าแดชบอร์ดและเริ่มตรวจสอบยอด →