ย้าย API ตรวจสลิปเดิมมาใช้ Thunder Solution ต้องทำอะไรบ้าง?

ถ้าธุรกิจมี API ตรวจสลิป ใช้งานอยู่แล้ว แต่กำลังมองหาผู้ให้บริการรายใหม่ การย้ายระบบไม่ควรเริ่มจากการเปลี่ยน URL API แล้วจบ เพราะแต่ละผู้ให้บริการอาจมี Endpoint, รูปแบบ Request, Response และ Error Code แตกต่างกัน  สำหรับคนที่กำลัง ย้าย API ตรวจสลิป มาใช้ Thunder Solution ปัจจุบันมี API v2 เป็นเวอร์ชันล่าสุด ขณะที่ v1 ถูกระบุเป็น Legacy โดย v2 เพิ่มรูปแบบ Response ที่เป็นมาตรฐาน, Account Matching, Amount Validation, Multi-Branch และ Error Handling ที่ละเอียดขึ้น

ก่อนย้าย API ตรวจสลิป ต้องเช็กอะไรจากระบบเดิม?

สิ่งแรกที่ควรทำคืออย่าเพิ่งแก้โค้ด ให้รวบรวมข้อมูลของ API เดิมก่อนว่าแอปพลิเคชันของคุณเรียก API อย่างไร

1. เช็ก Endpoint และ HTTP Method

ดูว่า API เดิมใช้ GET หรือ POST และส่งข้อมูลสลิปด้วยวิธีไหน เช่น

• QR Payload
• รูปภาพ
• URL รูปสลิป
• Base64

จากนั้นนำมาเทียบกับ Thunder Solution ซึ่ง API v2 ใช้ Endpoint สำหรับตรวจสอบสลิปธนาคารเป็น POST /verify/bank และรองรับการตรวจสอบผ่าน Payload, รูปภาพ และ URL ตามรูปแบบ Request ที่กำหนดในเอกสาร

2. เช็กว่าโค้ดของระบบใช้ข้อมูลอะไรจาก Response

จุดนี้สำคัญมาก เพราะระบบไม่ได้ต้องการแค่คำตอบว่า “ผ่านหรือไม่ผ่าน” แต่อาจนำข้อมูลจาก Response ไปทำงานต่อ เช่น

• จำนวนเงิน
• ธนาคาร
• ผู้โอน
• ผู้รับ
• เลขอ้างอิงธุรกรรม
• สถานะสลิป
• สถานะสลิปซ้ำ

Thunder API v2 ใช้โครงสร้าง Response แบบมาตรฐาน โดย Response สำเร็จจะอยู่ภายใต้ success และ data ส่วน Error จะอยู่ภายใต้ error.code และ error.message ดังนั้นตอน ย้าย API ตรวจสลิป ต้องทำ Mapping ข้อมูลจาก Response เดิมกับ Response ของ Thunder ให้เรียบร้อยก่อน

ขั้นตอนย้าย API ตรวจสลิปมา Thunder Solution

ขั้นตอนที่ 1: สร้างบัญชีและ Application

Thunder Solution ระบุว่าการเริ่มใช้งาน API ต้องมีบัญชี Developer และสร้าง Application จาก Developer Portal จากนั้นจึงรับ API Key สำหรับใช้งาน สิ่งที่ทีมพัฒนาควรเตรียมไว้คือ

• บัญชี Developer 
• Application
•  API Key 
•  ระบบของคุณ

อย่านำ API Key ไปใส่ไว้ใน Frontend หรือ Client-side เพราะเอกสาร Thunder แนะนำให้เก็บ Key ใน Environment Variables หรือระบบจัดการ Secret และเรียก API จากฝั่ง Server

ขั้นตอนที่ 2: เลือกว่าจะใช้ API v1 หรือ v2

ถ้าเป็นการเริ่ม Integration ใหม่ Thunder แนะนำ API v2 เพราะเป็นเวอร์ชันล่าสุดและมีฟีเจอร์เพิ่มเติมจาก v1 ความแตกต่างที่ควรรู้คือ v1 ใช้ Base URL /v1 ส่วน v2 ใช้ /v2 

โดย v2 เพิ่มความสามารถอย่าง

• Account Matching
• Amount Validation
• Multi-Branch
• Response Format แบบมาตรฐาน
• Error Handling ที่ละเอียดขึ้น

ขณะที่ v1 ยังมีฟีเจอร์บางอย่าง เช่น QR Code Generation และ TrueMoney Wallet Verification ตามเอกสารเปรียบเทียบเวอร์ชัน ดังนั้นถ้าระบบเดิมมีฟีเจอร์เหล่านี้ ต้องตรวจสอบ Requirement ให้ละเอียดก่อน Migration

ขั้นตอนที่ 3: เปลี่ยน Authentication

Thunder Solution API ใช้ Bearer Token โดยต้องส่ง API Key ผ่าน Header Authorization: Bearer YOUR_API_KEY ทุก Request ที่เรียก API ต้องมีการยืนยันตัวตน และสามารถตั้งค่า IP Whitelist เพื่อจำกัด IP ที่อนุญาตให้เรียก API ได้ ทีมพัฒนาจึงควรเปลี่ยน Credential ในระบบให้เรียบร้อย และตรวจสอบ IP ของ Production Server ก่อนเปิดใช้งานจริง

ต้องแก้โค้ดตรงไหนบ้าง?

การ Migration ส่วนใหญ่จะอยู่ที่ Integration Layer มากกว่าการรื้อระบบทั้งหมด

1. เปลี่ยน API Endpoint

API v2 ของ Thunder ใช้ https://api.thunder.in.th/v2/verify/bank สำหรับตรวจสอบสลิปธนาคาร

2. ปรับ Request

หากระบบเดิมส่งข้อมูลเป็น Payload สามารถปรับ Request ให้ตรงกับรูปแบบของ Thunder ได้ นอกจากนี้ Thunder v2 ยังรองรับการส่งตัวเลือกเพื่อตรวจสอบเพิ่มเติม เช่น

• matchAccount
• matchAmount
• checkDuplicate

โดย Account Matching สามารถใช้ตรวจว่าผู้รับตรงกับบัญชีที่ลงทะเบียนไว้หรือไม่ และ Amount Validation ใช้ตรวจจำนวนเงินกับยอดที่คาดหวัง

3. ปรับ Response Mapping

อย่าลืมแก้ Logic หลังจาก API ตอบกลับด้วย ตัวอย่างเช่น ระบบเดิมอาจเขียนว่า API ผ่าน → เปลี่ยน Order เป็น Paid เมื่อย้ายมา Thunder ก็ควรกำหนด Mapping ให้ชัดว่า Response แบบใดหมายถึง “ชำระเงินสำเร็จ” และแบบใดต้องส่งต่อให้ตรวจสอบเพิ่มเติม

Error Code ก็ต้อง Migration ด้วย

อีกจุดที่มักถูกมองข้ามคือ Error Handling Thunder v2 มี Error Code แยกตามสาเหตุ เช่น MISSING_API_KEY, INVALID_API_KEY, IP_NOT_ALLOWED, QUOTA_EXCEEDED, VALIDATION_ERROR, SLIP_NOT_FOUND และ Error ฝั่ง Server เช่น API_SERVER_ERROR ดังนั้นอย่าเอา Error Code จาก API เดิมมาใช้ต่อโดยตรง ควรทำ Mapping ใหม่ เช่น

• HTTP Status / Error Code → ระบบของคุณ → Action ที่ต้องทำ

วิธีนี้ช่วยให้ทีมรู้ว่า Error ไหนควร Retry, Error ไหนควรแจ้งผู้ดูแล และ Error ไหนเกิดจากข้อมูล Request ไม่ถูกต้อง

อย่าลืมทดสอบ “สลิปซ้ำ” และยอดเงิน

ก่อนเปิดใช้งานจริง ควรทดสอบกรณีที่สำคัญกับธุรกิจ เช่น

สลิปปกติ

ส่งสลิปจริงและตรวจสอบว่าระบบสามารถอ่านข้อมูลที่ต้องใช้ได้ครบ

สลิปซ้ำ

Thunder มีฟังก์ชันตรวจจับสลิปซ้ำในระบบ และ API v2 รองรับ checkDuplicate

จำนวนเงินไม่ตรง

ใช้ matchAmount เพื่อช่วยตรวจสอบว่ายอดบนสลิปตรงกับยอดที่ระบบคาดหวังหรือไม่

บัญชีผู้รับไม่ตรง

สามารถใช้ Account Matching เพื่อช่วยตรวจสอบผู้รับกับบัญชีที่ลงทะเบียนไว้

ถ้ามีหลายสาขา ย้าย API อย่างไร?

หากธุรกิจมีหลายสาขา Thunder API v2 รองรับ Multi-Branch โดยแต่ละ Branch สามารถมี API Key และการติดตามโควต้าแยกกัน รวมถึงกำหนด IP Restrictions แตกต่างกันได้ ต้องบอกเลยว่า ฟีเจอร์นี้จึงเหมาะกับธุรกิจที่ต้องการแยกการใช้งาน API ระหว่างสาขา ทีม หรือจุด Integration นอกจากนี้ API GET /info สามารถใช้ดูข้อมูล Application, Branch และการใช้โควต้าได้ โดย Endpoint นี้ไม่หักโควต้า

Checklist ก่อน Switch ระบบจริง

ก่อน ย้าย API ตรวจสลิป จากผู้ให้บริการเดิมมา Thunder Solution แนะนำให้ทีมเช็กอย่างน้อย 8 ข้อนี้

1. ตรวจ Endpoint เดิม
2. ตรวจ Request และ Response
3. ตรวจฟิลด์ที่ระบบนำไปใช้ต่อ
4. สร้าง Thunder API Key
5. ตั้งค่า Environment และ IP Whitelist
6. ปรับ Endpoint และ Request
7. Mapping Response และ Error Code
8. ทดสอบสลิปจริง สลิปซ้ำ ยอดไม่ตรง และกรณี API Error

หากระบบมีออเดอร์จำนวนมาก ควรทดสอบ Integration ในสภาพแวดล้อมที่ควบคุมได้ก่อน แล้วจึงเปลี่ยน Traffic ไปยัง API ใหม่ เพื่อลดความเสี่ยงที่ระบบรับชำระเงินจะหยุดทำงานระหว่าง Migration

สรุป ย้าย API ตรวจสลิปไม่จำเป็นต้องรื้อระบบทั้งหมด

การ ย้าย API ตรวจสลิป มา Thunder Solution ไม่ได้หมายความว่าต้องสร้างระบบใหม่ทั้งหมด แต่ต้องปรับจุดเชื่อมต่อให้ตรงกับ API ใหม่ โดยเฉพาะ Endpoint, Authentication, Request, Response และ Error Handling หากเลือกใช้ Thunder API v2 จะมีฟีเจอร์อย่าง Account Matching, Amount Validation, Duplicate Detection และ Multi-Branch ที่สามารถนำไปต่อยอดกับระบบตรวจสอบการชำระเงินของธุรกิจได้ สิ่งสำคัญที่สุดคือ อย่า Switch ระบบทันทีโดยไม่ทดสอบ ควรทำ Checklist, Mapping ข้อมูล และทดสอบกรณีผิดพลาดให้ครบก่อน แล้วจึงเปลี่ยนไปใช้งาน Production

คำถามที่พบบ่อย (FAQ)

ย้าย API ตรวจสลิปมา Thunder ต้องเขียนระบบใหม่ทั้งหมดไหม?

ไม่จำเป็น หากระบบเดิมมี Integration Layer ที่แยกจาก Business Logic สามารถปรับส่วนที่เรียก API, Request/Response Mapping และ Error Handling ให้เข้ากับ Thunder ได้ แต่ขอบเขตงานจริงขึ้นอยู่กับโครงสร้างระบบเดิม

Thunder Solution มี API ตรวจสลิปเวอร์ชันไหน?

ปัจจุบัน Thunder ระบุว่า API v2 เป็นเวอร์ชันล่าสุด ส่วน v1 เป็น Legacy โดย v2 มี Standardized Response, Account Matching, Amount Validation และ Multi-Branch

Thunder API ตรวจสลิปซ้ำได้ไหม?

ได้ API v2 รองรับ checkDuplicate สำหรับตรวจจับสลิปซ้ำ และสามารถใช้ร่วมกับการตรวจสอบบัญชีผู้รับและจำนวนเงินได้

ย้ายระบบแล้วสามารถแยก API ตามสาขาได้ไหม?

ได้ Thunder API v2 รองรับ Multi-Branch โดยแต่ละ Branch สามารถมี API Key และการติดตามโควต้าแยกกันได้

เปลี่ยน API ตรวจสลิปให้เป็นเรื่องง่ายด้วย Thunder Solution

ถ้าธุรกิจมี API ตรวจสลิปเดิมอยู่แล้ว และกำลังมองหาผู้ให้บริการใหม่ Thunder Solution มีทั้ง Slip Verification API สำหรับเชื่อมต่อเข้ากับเว็บไซต์ E-commerce, POS, ERP/CRM และระบบ Automation รวมถึงบริการตรวจสลิปผ่าน LINE Chatbot สำหรับธุรกิจที่ต้องการเริ่มใช้งานง่ายขึ้น

Thunder Solution API รองรับการตรวจสอบสลิปผ่าน QR Payload, รูปภาพ, Base64 และ URL พร้อม Duplicate Detection และ API v2 ยังรองรับ Account Matching, Amount Validation และ Multi-Branch นอกจากนี้ Thunder Solution ระบุว่ามีผู้ใช้งานธุรกิจมากกว่า 3,000 ธุรกิจ และหน้าเว็บไซต์ระบุการรองรับธนาคารไทยมากกว่า 18 แห่ง

หากกำลังวางแผน ย้าย API ตรวจสลิป จากระบบเดิมมา Thunder Solution สามารถเริ่มจากการตรวจสอบ Requirement และรูปแบบ API เดิม แล้ววางโครงสร้าง Integration ให้เหมาะกับระบบของธุรกิจ ก่อนนำขึ้นใช้งานจริง เลือกบริการ API ตรวจสลิปที่เหมาะกับธุรกิจ และเริ่มต้นใช้งานกับ Thunder Solution ได้เลย