ย้าย API ตรวจสลิปเดิม มาใช้ 1XSlip ต้องทำอะไรบ้าง?
สำหรับร้านค้าหรือระบบที่มี API ตรวจสอบสลิปอยู่แล้ว การย้ายมาใช้ 1XSlip ไม่จำเป็นต้องรื้อระบบใหม่ทั้งหมด หากระบบเดิมมีโครงสร้าง API ที่ชัดเจนอยู่แล้ว ส่วนใหญ่จะเป็นการเปลี่ยนจุดเชื่อมต่อ ปรับรูปแบบ Request/Response และทดสอบการทำงานก่อนเปิดใช้งานจริง
- ตรวจสอบระบบเดิมก่อนย้าย
เริ่มจากตรวจสอบก่อนว่าระบบเดิมส่งข้อมูลอะไรไปยัง API บ้าง เช่น รูปสลิป, QR Code, จำนวนเงิน, เลขออเดอร์ หรือข้อมูลอ้างอิงต่าง ๆ
รวมถึงดูว่าระบบของคุณนำผลลัพธ์จาก API ไปทำอะไรต่อ เช่น อนุมัติออเดอร์ เพิ่มเครดิต เปลี่ยนสถานะคำสั่งซื้อ หรือแจ้งเตือนผ่าน LINE/Telegram
การรู้ Flow เดิมทั้งหมดจะช่วยให้ย้ายระบบได้ง่ายขึ้นและลดปัญหาระหว่างเปลี่ยน API
- เปลี่ยน API Endpoint และ Credentials
หลังจากได้รับข้อมูลเชื่อมต่อจาก 1XSlip แล้ว ให้เปลี่ยน API Endpoint จากผู้ให้บริการเดิมมาเป็น Endpoint ของ 1XSlip
จากนั้นตั้งค่า API Key, Token หรือ Credentials ที่ระบบกำหนด โดยควรเก็บข้อมูลเหล่านี้ไว้ใน Environment Variable หรือฝั่ง Server และไม่ควรเปิดเผยไว้ในหน้าเว็บหรือ Source Code ฝั่งผู้ใช้งาน
- ปรับ Request ให้ตรงกับ API ใหม่
ผู้ให้บริการแต่ละรายอาจใช้รูปแบบการส่งข้อมูลแตกต่างกัน เช่น
ส่งไฟล์รูปภาพ ส่ง URL ของรูป ส่งข้อมูล QR Code ส่งแบบ Base64 ส่งข้อมูลผ่าน JSON หรือ Form Data
ดังนั้นควรตรวจสอบ Documentation ของ 1XSlip และปรับ Request ให้ตรงตามรูปแบบที่ระบบรองรับ
- ปรับการอ่าน Response
API เดิมกับ API ใหม่อาจตั้งชื่อข้อมูลไม่เหมือนกัน ถึงแม้ข้อมูลที่ได้รับจะใกล้เคียงกัน
ตัวอย่างข้อมูลที่ระบบควรนำไปใช้งาน ได้แก่
สถานะการตรวจสอบ, จำนวนเงิน, วันเวลาโอน, ธนาคาร, บัญชีผู้รับ และเลขอ้างอิงธุรกรรม
หากระบบเดิมใช้ชื่อ Field คนละแบบ ควรทำตัวกลางสำหรับ Mapping ข้อมูลก่อนส่งต่อไปยังระบบหลัก
วิธีนี้จะช่วยให้ไม่ต้องแก้ Code หลายจุด
- ตรวจสอบระบบป้องกันสลิปซ้ำ
ก่อนเปิดใช้งานจริง ควรตรวจสอบว่าระบบสามารถตรวจจับรายการเดิมที่เคยใช้งานแล้วได้หรือไม่
โดยเฉพาะระบบเติมเงิน ร้านค้าออนไลน์ หรือระบบที่อนุมัติสินค้าอัตโนมัติ เพราะหากไม่มีการตรวจสอบรายการซ้ำ ผู้ใช้งานอาจนำสลิปเดิมกลับมาใช้กับหลายออเดอร์ได้
ระบบควรมีการบันทึก Reference หรือข้อมูลธุรกรรมไว้สำหรับตรวจสอบย้อนหลัง
- ปรับ Error Handling
อย่าให้ระบบคิดว่า API มีปัญหาแล้วหมายความว่า “สลิปไม่ถูกต้อง” ทันที
ควรแยกสถานะออกจากกัน เช่น
ตรวจสอบสำเร็จ / สลิปไม่ถูกต้อง / รายการซ้ำ / API ไม่ตอบสนอง / Server Error
หาก API ขัดข้อง ระบบสามารถกำหนดสถานะเป็น “รอตรวจสอบ” และลองตรวจสอบใหม่ภายหลังได้
- ทดสอบก่อนใช้งานจริง
ก่อนย้ายระบบทั้งหมด ควรทดสอบหลายกรณี เช่น
สลิปจริง สลิปที่ยอดไม่ตรง สลิปเดิมส่งซ้ำ รูปไม่ชัด รูปที่ไม่ใช่สลิป API Timeout API ตอบ Error รายการจำนวนเงินสูง
ควรตรวจสอบด้วยว่าหลัง API ตอบกลับแล้ว ระบบหลังบ้านยังทำงานต่อได้ถูกต้อง เช่น เปลี่ยนสถานะออเดอร์หรือเพิ่มเครดิตเพียงครั้งเดียว
- ค่อยสลับจาก API เดิม
วิธีที่ปลอดภัยคือไม่ควรถอด API เดิมออกทันที
สามารถติดตั้ง 1XSlip แยกไว้ก่อน ทดสอบให้มั่นใจว่าระบบทำงานครบทุกขั้นตอน จากนั้นจึงเปลี่ยน Traffic หรือระบบหลักมาใช้ API ใหม่
ในช่วงแรกอาจเก็บระบบเดิมไว้เป็น Backup ชั่วคราว เพื่อให้สามารถย้อนกลับได้หากพบปัญหา
สรุป
การย้าย API ตรวจสลิปเดิมมาใช้ 1XSlip หลัก ๆ จะประกอบด้วยการ เปลี่ยน Endpoint และ API Key, ปรับ Request/Response, ตรวจสอบระบบสลิปซ้ำ, จัดการ Error และทดสอบ Flow ทั้งระบบ
หากวางโครงสร้างตัวกลางสำหรับเชื่อม API ไว้ดี การเปลี่ยนผู้ให้บริการในอนาคตก็จะง่ายขึ้น โดยไม่จำเป็นต้องแก้ระบบหลักใหม่ทั้งหมดครับ
