เริ่มใช้งานเป็นใจ

1. เตรียมเครื่องและเปิดใช้งาน

• Android 14 ขึ้นไปสำหรับรับงาน และมี Wi-Fi ระหว่างตั้งค่าครั้งแรก ใช้แบบเปิดจอและปลดล็อกไว้เองได้โดยไม่บันทึก PIN ล็อกโทรศัพท์ในเป็นใจ
• แอพต้นทางเริ่มรองรับ SCB EASY ต้องเข้าแอพธนาคารเองได้ก่อน การปลดล็อกอัตโนมัติขึ้นกับรุ่นเครื่อง ระบบ และภาษา แอพจะตรวจแป้นก่อนทดลอง PIN โดยอัตโนมัติ
• ผู้ดูแลสร้างลูกค้าในเมนู ลูกค้าและสิทธิ์ แล้วออก Key เปิดแอพแยกต่อเครื่อง ส่ง Key ให้เจ้าของเครื่องโดยตรง

1. ติดตั้ง penjai-3.14.0-rc10-customer.apk จากชุดที่ผู้ดูแลส่งให้
2. เปิดเป็นใจ กรอก Key เปิดแอพ แล้วกดเปิดใช้งาน เมื่อสำเร็จ ช่องกรอก Key จะหายไปและมีปุ่มไปตั้งค่ามือถือ
3. ทำขั้นตอนเชื่อมต่อมือถือด้านล่าง ไม่ต้องส่ง PIN หรือรหัสจับคู่ให้ผู้ดูแล

Key เปิดแอพใช้กับมือถือ ส่วน API Key ใช้กับเซิร์ฟเวอร์ของลูกค้า เป็นข้อมูลคนละชุด ห้ามใส่ API Key ใน JavaScript ของหน้าเว็บ

2. เชื่อมต่อมือถือครั้งแรก

1. เปิดตัวเลือกนักพัฒนาใน Android โดยแตะหมายเลขบิลด์ซ้ำตามขั้นตอนของรุ่นเครื่อง Samsung อยู่ที่ เกี่ยวกับโทรศัพท์ → ข้อมูลซอฟต์แวร์
2. เข้าเป็นใจ → ตั้งค่า เปิดการตั้งค่านักพัฒนา แล้วเปิด USB debugging และ Wireless debugging เพื่อเริ่มตั้งค่า
3. ในเป็นใจ กด เริ่มจับคู่ และอนุญาตการแจ้งเตือน จากนั้นแตะชื่อ Wireless debugging เพื่อเข้าหน้ารายละเอียด การแตะสวิตช์อย่างเดียวจะไม่เปิดหน้านี้
4. เลือก จับคู่อุปกรณ์ด้วยรหัส เปิดกล่องรหัสค้างไว้ เลื่อนแถบแจ้งเตือนลง แล้วกรอกรหัส Android 6 หลักผ่านการแจ้งเตือนเป็นใจ
5. เมื่อจับคู่สำเร็จ ปิดกล่องรหัส กลับเป็นใจ โดยเปิด Wireless debugging ค้างไว้ แล้วกด เริ่มตัวช่วย หรือ เชื่อมต่ออีกครั้ง
6. รอให้ขึ้น มือถือพร้อมแล้ว แล้วไปเพิ่มบัญชี

แอพจะปิด Wireless debugging หลังตั้งค่าสำเร็จและคง ADB ภายในด้วยค่า 2 เพื่อให้ตัวช่วยทำงาน ถ้าต่อสายไว้ให้ถอดสายอย่างเดียว ไม่ต้องปิด USB debugging ซ้ำ

3. เพิ่มบัญชี SCB EASY

1. กด เพิ่มบัญชี → SCB EASY กรอก PIN ของธนาคารในมือถือ แล้วกด ทดสอบและอ่านข้อมูล
2. ปล่อยให้แอพเข้า SCB เปิดธุรกรรมของฉันและหน้ารวมบัญชี รอให้กลับมาหน้าตรวจสอบข้อมูลเอง
3. ตรวจชื่อ เลขบัญชี และยอดเงิน หากตรงกับบัญชีที่ต้องการ ให้กด ยืนยันและเพิ่มบัญชี

บัญชีและ PIN ที่บันทึกเก็บแบบเข้ารหัสในมือถือ เมื่อยืนยันเพิ่มบัญชีและเปิดรับงานจาก API ระบบจะผูกกับลูกค้าเจ้าของเครื่องที่มี API Key โดยอัตโนมัติ ใช้ได้ทั้งอ่านยอดและโอนเงิน

4. เลือกวิธีเปิดหน้าจอและรับงานจาก API

เปิดจอไว้เอง — ไม่ต้องตั้ง PIN ในเป็นใจ

1. เปิดหน้าจอและปลดล็อกด้วยตนเอง หากเคยเปิดปลดล็อกอัตโนมัติไว้ สามารถปิดได้ในหน้า ปลดล็อกโทรศัพท์
2. เข้า รับงานจาก API เปิดตัวเลือกคงหน้าจอไว้ อนุญาตการแจ้งเตือน แล้วกด เปิดรับงานจาก API
3. ระหว่างเปิดรับงาน แอพจะช่วยคงจอให้เปิดแม้เปลี่ยนไปแอพอื่น หากกดล็อกหรือจอดับ ต้องเปิดจอและปลดล็อกเองก่อนรับงานต่อ

ปลดล็อกอัตโนมัติ — กรอก PIN แล้วทดสอบครั้งเดียว

รุ่นนี้เพิ่มตัวอ่านแป้น ColorOS ผ่านการปลดล็อกจริงบน OPPO CPH2591 / Android 15 / ภาษาไทยแล้ว เครื่องอื่นยังต้องทดสอบ PIN ให้ผ่านก่อนเปิดใช้อัตโนมัติ

1. หยุดรับงานก่อน เข้า ปลดล็อกโทรศัพท์ กรอก PIN ล็อกหน้าจอ แล้วกด บันทึกและทดสอบ PIN ไม่ต้องตรวจแป้นแยกก่อน
2. ยืนยันเจ้าของเครื่องตามที่ Android ขอ รอข้อความนับถอยหลังแล้วล็อกจอภายใน 8 วินาที แอพจะตรวจว่าอ่านแป้นได้ครบก่อน แล้วลองปลดล็อกด้วย PIN เพียงครั้งเดียว หากอ่านไม่ได้จะหยุดก่อนกรอกรหัส
3. เมื่อปลดล็อกสำเร็จจึงเปิดใช้อัตโนมัติ ถ้าไม่สำเร็จจะไม่ลองรหัสซ้ำ ให้ปลดล็อกเองแล้วกลับมาดูเหตุผลและเวลาทดสอบด้านบน มีการแจ้งเตือนเมื่อเสร็จ และยังใช้แบบเปิดจอไว้เองได้

เมื่อเปลี่ยนเครื่อง อัปเดตระบบ หรือเปลี่ยนภาษา ต้องทดสอบใหม่ เมื่อมี API Key และมือถือเปิดรับงาน บัญชี SCB ที่ยืนยันเพิ่มแล้วจะผูกกับลูกค้าอัตโนมัติ ใช้ได้ทั้งอ่านยอดและโอนเงิน รวมถึงบัญชีเดิม เรียก GET /accounts เพื่อรับ accountId ได้เลย เครื่องที่เคยปลดต้องผูกกลับด้วยตนเอง

5. ตั้ง URL รับผล Webhook

1. ลูกค้าต้องมีเซิร์ฟเวอร์รับผลที่เป็น URL HTTPS สาธารณะ รองรับการตรวจลายเซ็นและเหตุการณ์ซ้ำ
2. ที่หน้าบัญชี แตะ ตั้งค่า Webhook หรือเข้า ตั้งค่า → รับงานจาก API → ตั้งค่า Webhook รับผล
3. กรอก URL เปิดส่งผล แล้วกดบันทึก การตั้งค่านี้ใช้ร่วมกันทุกมือถือของลูกค้ารายนั้น
4. นำ Secret ที่แสดงครั้งเดียวไปเก็บบนเซิร์ฟเวอร์รับผล และใช้ตรวจลายเซ็น HMAC ตาม คู่มือ Webhook ไม่ส่ง Secret ในแชต

หากยังไม่มี URL สามารถตรวจผลด้วย GET /v1/customer/jobs/{jobId} ได้ แต่ยังไม่ถือว่าผ่านการตรวจรับ Webhook

6. อ่านสถานะจากหน้าบัญชี

แตะแต่ละรายการเพื่อไปจัดการ และกด ตรวจใหม่ เพื่ออ่านค่าล่าสุด

หากขึ้น “ตรวจไม่ได้” ให้ตรวจอินเทอร์เน็ตหรือสิทธิ์เครื่องก่อน ไม่ควรตีความว่าเครื่องพร้อมจากสถานะเดิม

7. ตรวจรับด้วยงานอ่านยอด

ผู้ดูแลส่ง API Key และ accountId ให้ผู้พัฒนาเซิร์ฟเวอร์ลูกค้า คู่มือ API และตัวอย่างอยู่ที่ penjai.svenme.com/api-docs

1. เรียก GET /v1/customer/accounts ตรวจว่าพบบัญชีและมือถือพร้อมใช้งาน
2. ส่ง POST /v1/customer/jobs โดยใช้ requestId แบบ UUID หนึ่งค่า และ type: "read_balance" หากคำขอเดิมหมดเวลารอ ให้ส่ง requestId เดิมกับข้อมูลเดิม
3. HTTP 202 หมายถึงรับเข้าคิว ตรวจต่อจนงาน succeeded แล้วตรวจยอดและเวลาอ่านจากผล
4. ตรวจว่า Webhook ของงานเดียวกันถึงเซิร์ฟเวอร์ลูกค้า ลายเซ็นถูกต้อง และรับ eventId ซ้ำได้โดยไม่ทำรายการซ้ำ
5. ทดสอบหลังล็อกจอ และหลังรีสตาร์ทตามหัวข้อถัดไป ก่อนรับงานประจำ

{
  "requestId": "UUID_OF_THIS_REQUEST",
  "type": "read_balance",
  "accountId": "ACCOUNT_ID_FROM_ACCOUNTS"
}

บัญชีของลูกค้าใช้อ่านยอดและโอนได้โดยไม่ต้องเปิดสิทธิ์รายบัญชี เมื่ออ่านยอดและรับผลผ่านแล้วจึงทดสอบการโอน ให้เจ้าของบัญชีเป็นผู้ส่งคำสั่งโอนทดสอบและตรวจผล ก่อนขยายให้ลูกค้ารายอื่น ไม่ส่งสลิป ผลโอนแจ้งยอด เวลา และเลขอ้างอิง

8. อัปเดต รีสตาร์ท และแก้ปัญหา

อัปเดตจากในแอพ

ตั้งแต่รุ่น 3.14.0-rc4 เข้า ตั้งค่ามือถือ → ตรวจสอบและอัปเดตแอพ กดตรวจสอบและดาวน์โหลด เมื่อไฟล์ผ่านการตรวจแล้วกดติดตั้ง หาก Android ขออนุญาตให้เป็นใจติดตั้งอัปเดต ให้เปิดสิทธิ์แล้วกลับมากดติดตั้งอีกครั้ง แอพจะรอให้งานจบและส่งผลครบก่อนหยุดรับงาน จากนั้นกดยืนยันในหน้าติดตั้งของ Android กลับมาเริ่มตัวช่วยใหม่และเปิดรับงานอีกครั้ง หากยกเลิกหรือติดตั้งไม่สำเร็จ แอพรุ่นเดิมยังอยู่

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

ติดตั้ง APK ทับด้วยตนเอง

รอให้งานจบ หยุดรับงานจาก API แล้วติดตั้ง APK ใหม่ทับของเดิม ไม่ถอนแอพหรือล้างข้อมูล รุ่นนี้ต้องเริ่มตัวช่วยใหม่ให้ตรงกับแอพ ในหน้าตั้งค่ามือถือกดเชื่อมต่อหรือเริ่มตัวช่วย หาก Android ยังจำการจับคู่ ไม่ต้องจับคู่ซ้ำ จากนั้นเลือกเปิดจอไว้เอง หรือกลับไปตรวจรองรับและทดสอบ PIN ก่อนใช้ปลดล็อกอัตโนมัติ แล้วเปิดรับงานและทดสอบอ่านยอด

หลังรีสตาร์ทหรือตัวช่วยหยุด

ปลดล็อกเครื่องครั้งแรกด้วยตนเอง เปิดการเชื่อมต่อเพื่อเริ่มตัวช่วยใหม่ในหน้าตั้งค่ามือถือ หาก Android ยังจำการจับคู่อยู่ ให้กดเชื่อมต่ออีกครั้งโดยไม่จับคู่ซ้ำ จากนั้นเปิดรับงานจาก API และทดสอบอ่านยอด

จับคู่ได้แต่เชื่อมต่อไม่ได้

ปิดกล่องรหัสจับคู่ เปิด Wireless debugging ค้างไว้ แล้วเริ่มตัวช่วยใหม่ หากระบุพอร์ตเอง ให้ใช้พอร์ตจากหน้ารายละเอียด Wireless debugging ไม่ใช่พอร์ตในกล่องรหัสจับคู่

งานขึ้น unknown หรือผลไม่ชัดเจน

หยุดส่งงานโอนใหม่ ตรวจประวัติรายการเดิมและให้ผู้ดูแลตรวจทานก่อน ระบบจะไม่กดยืนยันโอนซ้ำอัตโนมัติ

ติดต่อผู้ดูแล

แจ้งรุ่นเครื่อง Android เวอร์ชันเป็นใจ ชื่อสถานะ และ jobId เมื่อมีงาน หน้า ปลดล็อกโทรศัพท์ มี ดูและแชร์ผลตรวจรุ่นโทรศัพท์ ให้ตรวจข้อมูลก่อนแชร์ ห้ามส่ง PIN, Key, Secret หรือภาพที่เปิดเผยข้อมูลบัญชีโดยไม่จำเป็น