Opens in a new tab

เชื่อม API ตรวจสลิปด้วย JavaScript (Node.js) พร้อมโค้ดตัวอย่าง

เชื่อม API ตรวจสลิปด้วย JavaScript (Node.js) พร้อมโค้ดตัวอย่าง
เชื่อม API ตรวจสลิปด้วย JavaScript (Node.js) พร้อมโค้ดตัวอย่าง

เชื่อม API ตรวจสลิปด้วย JavaScript ช่วยให้เว็บร้านค้าหรือระบบหลังบ้านที่เขียนด้วย Node.js ตรวจสลิปโอนเงินของลูกค้าได้อัตโนมัติ ไม่ต้องมีคนนั่งเปิดแอปธนาคารเช็กทีละใบ บทความนี้พาทำตั้งแต่เตรียม API Key ของ EasySlip ติดตั้งแพ็กเกจ เขียน Endpoint ด้วย Express ไปจนถึงอ่านผลตรวจเพื่อตัดสินว่าจะยืนยันออเดอร์หรือไม่ ในกรณีที่ทีมใช้ภาษาอื่น ดูบทความที่ใช้ภาษาอื่นได้ที่ เชื่อม API ตรวจสลิปด้วย Python (FastAPI) และ เชื่อม EasySlip API ด้วย PHP และ Laravel

ทำไมต้องเชื่อม API ตรวจสลิปด้วย JavaScript

เว็บร้านค้าจำนวนมากใช้ JavaScript ทั้งฝั่งหน้าเว็บและฝั่งเซิร์ฟเวอร์ (Node.js) การเขียนส่วนตรวจสลิปด้วยภาษาเดียวกันทำให้ดูแลโค้ดง่าย และต่อเข้ากับระบบเดิมได้เลย เช่น

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

ข้อสำคัญคือต้องเรียก API จากฝั่งเซิร์ฟเวอร์ (Node.js) เท่านั้น ห้ามเรียกจากหน้าเว็บตรง ๆ เพราะ API Key จะหลุดไปอยู่ในเบราว์เซอร์ของลูกค้า

วิธีเชื่อม EasySlip API v2 ตรวจสลิปโอนเงินด้วย JavaScript และ Node.js
วิธีเชื่อม EasySlip API v2 ตรวจสลิปโอนเงินด้วย JavaScript และ Node.js

สิ่งที่ต้องเตรียมก่อนเริ่ม

  1. บัญชี EasySlip และ API Key (สมัครแล้วรับ Key ได้จากหน้าระบบ)
  2. Node.js เวอร์ชัน 18 ขึ้นไป เพราะมีคำสั่ง fetch ในตัว ไม่ต้องลงแพ็กเกจเพิ่มสำหรับเรียก API
  3. บัญชีธนาคารรับเงินที่ตั้งค่าไว้ในระบบ EasySlip ถ้าจะใช้การเช็กบัญชีผู้รับ

สำหรับตัวระบบ EasySlip API v2 ใช้ Bearer Token ใน Header เพื่อยืนยันตัวตน และตรวจสลิปธนาคารที่ Endpoint https://api.easyslip.com/v2/verify/bank อ่านรายละเอียดเพิ่มได้ที่ เอกสาร EasySlip API

ขั้นตอนที่ 1 สร้างโปรเจกต์และติดตั้งแพ็กเกจ

เปิด Terminal แล้วสร้างโฟลเดอร์โปรเจกต์ใหม่ จากนั้นติดตั้ง Express กับ dotenv

npm init -y

npm install express dotenv

ตัวอย่างนี้ใช้รูปแบบ import แบบใหม่ของ JavaScript ให้เปิดไฟล์ package.json แล้วเพิ่มบรรทัด “type”: “module”

ขั้นตอนที่ 2 ตั้งค่า API Key

สร้างไฟล์ .env ไว้ในโฟลเดอร์โปรเจกต์ แล้วใส่ API Key ของตัวเอง

EASYSLIP_API_KEY=your_actual_api_key

อย่าส่งไฟล์ .env ขึ้น Git ให้เพิ่มชื่อไฟล์ลงใน .gitignore และตอนใช้งานจริงให้เก็บ Key ในระบบจัดการความลับของเซิร์ฟเวอร์ อ่านวิธีดูแล Key เพิ่มที่ ตั้งค่า IP Whitelist และ Bearer Token ให้ปลอดภัย

ขั้นตอนที่ 3 เขียน Endpoint ตรวจสลิป

สร้างไฟล์ server.js แล้ววางโค้ดนี้ โค้ดจะสร้าง Endpoint ชื่อ /verify-slip รับ QR Payload ของสลิปจากระบบเรา แล้วส่งไปตรวจกับ EasySlip API v2 พร้อมเปิดการเช็กสลิปซ้ำ เช็กบัญชีผู้รับ และเทียบยอดเงิน

import "dotenv/config";
import express from "express";

const app = express();
app.use(express.json());

const EASYSLIP_URL = "https://api.easyslip.com/v2/verify/bank";
const API_KEY = process.env.EASYSLIP_API_KEY;

app.post("/verify-slip", async (req, res) => {
  const { payload, expectedAmount, orderId } = req.body || {};

  if (!API_KEY) {
    return res.status(500).json({ message: "ยังไม่ได้ตั้งค่า API Key" });
  }
  if (!payload || typeof payload !== "string") {
    return res.status(400).json({ message: "ต้องส่ง QR Payload ของสลิป" });
  }

  const body = {
    payload,
    checkDuplicate: true,
    matchAccount: true,
  };
  if (expectedAmount) body.matchAmount = Number(expectedAmount);
  if (orderId) body.remark = String(orderId);

  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 15000);

  try {
    const response = await fetch(EASYSLIP_URL, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${API_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
      signal: controller.signal,
    });

    const result = await response.json().catch(() => null);

    if (!result) {
      return res.status(502).json({ message: "อ่านผลจาก EasySlip ไม่ได้" });
    }
    if (!response.ok) {
      return res.status(502).json({
        message: "EasySlip ตอบกลับว่ามีข้อผิดพลาด",
        upstreamStatus: response.status,
      });
    }
    return res.json(result);
  } catch (err) {
    if (err.name === "AbortError") {
      return res.status(504).json({ message: "EasySlip ตอบช้าเกินเวลา" });
    }
    return res.status(502).json({ message: "เชื่อมต่อ EasySlip ไม่ได้" });
  } finally {
    clearTimeout(timer);
  }
});

app.listen(3000, () => console.log("พร้อมที่ http://localhost:3000"));

ส่วนที่ควรรู้ในโค้ด

  • checkDuplicate: ให้ระบบบอกว่าสลิปนี้เคยถูกตรวจไปแล้วหรือยัง
  • matchAccount: เช็กว่าบัญชีผู้รับในสลิปตรงกับบัญชีที่ตั้งไว้ใน EasySlip
  • matchAmount: ยอดที่ลูกค้าต้องจ่าย ระบบจะเทียบกับยอดในสลิป
  • remark: ใส่เลขออเดอร์ไว้ เพื่อตามย้อนหลังได้ว่าสลิปนี้ใช้กับออเดอร์ไหน
  • AbortController: ตัดการรอที่ 15 วินาที ระบบเราจะไม่ค้างถ้าปลายทางตอบช้า

ตัวอย่างนี้ส่งเป็น QR Payload ถ้าต้องการส่งไฟล์รูปสลิปตรง ๆ ต้องเปลี่ยนไปส่งแบบ multipart/form-data ตามเอกสาร API

ขั้นตอนที่ 4 รันและทดสอบ

รันเซิร์ฟเวอร์ด้วยคำสั่ง node server.js แล้วลองส่ง Request ทดสอบจาก Terminal อีกหน้าต่าง เปลี่ยน YOUR_REAL_QR_PAYLOAD เป็น QR Payload จากสลิปจริง

curl -X POST http://localhost:3000/verify-slip \
  -H "Content-Type: application/json" \
  -d '{"payload":"YOUR_REAL_QR_PAYLOAD","expectedAmount":1500,"orderId":"ORDER-12345"}'

อ่านผลตรวจสลิปยังไงให้ถูก

ผลที่ได้จาก EasySlip API v2 มีข้อมูลที่ใช้ตัดสินใจได้หลายตัว

  • success: ผลการเรียกตรวจ
  • amountInSlip: ยอดเงินในสลิป
  • isAmountMatched: ยอดในสลิปตรงกับยอดที่ส่งไปเทียบหรือไม่
  • isDuplicate: สลิปนี้เคยถูกตรวจแล้วหรือไม่
  • matchedAccount: ข้อมูลบัญชีที่จับคู่ได้
  • rawSlip.transRef และ rawSlip.date: เลขอ้างอิงและเวลาของรายการโอน

ตัวอย่างฟังก์ชันตัดสินว่าจะยืนยันออเดอร์ได้หรือไม่

function canConfirmOrder(result) {
  const d = result.data ?? result;
  if (d.isDuplicate) return false;
  if (d.isAmountMatched === false) return false;
  return true;
}

ถ้า isDuplicate เป็น true ให้หยุดทันที เพราะอาจเป็นการรับเงินซ้ำ ถ้า isAmountMatched เป็น false อย่ายืนยันว่าลูกค้าจ่ายครบ ส่วนความหมายของรหัสข้อผิดพลาดแต่ละตัว ดูได้ที่ รวม Error Code ของ EasySlip API

เชื่อม API ตรวจสลิปด้วย JavaScript (Node.js) พร้อมโค้ดตัวอย่าง
ป้องกัน Endpoint ของเราเองด้วย เช่น ให้เรียกได้เฉพาะผู้ใช้ที่ล็อกอินแล้ว

ข้อควรระวังก่อนใช้งานจริง

  1. เก็บ API Key ฝั่งเซิร์ฟเวอร์เท่านั้น ห้ามใส่ในโค้ดหน้าเว็บ
  2. ป้องกัน Endpoint ของเราเองด้วย เช่น ให้เรียกได้เฉพาะผู้ใช้ที่ล็อกอินแล้ว
  3. เก็บเลขอ้างอิงรายการโอนคู่กับเลขออเดอร์ กันการยืนยันออเดอร์ซ้ำ
  4. แยกข้อผิดพลาดให้ชัด ข้อมูลผิด ปลายทางตอบช้า หรือเชื่อมต่อไม่ได้ จะได้แจ้งลูกค้าถูก
  5. ทดสอบกับหลายกรณีก่อนเปิดจริง เช่น ยอดไม่ตรง สลิปซ้ำ โอนผิดบัญชี

ถ้าต้องตรวจสลิปจำนวนมากพร้อมกัน ดูการตรวจแบบเข้าคิวที่ Async Verify ผ่าน Queue และ Webhook

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

เรียก API ตรวจสลิปจากหน้าเว็บด้วย JavaScript ตรง ๆ ได้ไหม

ไม่ควร เพราะต้องใส่ API Key ไว้ในโค้ดหน้าเว็บ ใครก็เปิดดูได้ ให้หน้าเว็บส่งข้อมูลมาที่เซิร์ฟเวอร์ Node.js ของเรา แล้วให้เซิร์ฟเวอร์เป็นคนเรียก EasySlip

ใช้ Node.js เวอร์ชันเก่ากว่า 18 ได้ไหม

ได้ แต่ต้องติดตั้งแพ็กเกจสำหรับเรียก API เพิ่ม เช่น axios หรือ node-fetch แล้วเปลี่ยนส่วน fetch ในโค้ด

ใช้กับ Next.js หรือ NestJS ได้ไหม

ได้ หลักการเหมือนกัน ย้ายโค้ดส่วนเรียก API ไปไว้ใน API Route หรือ Service ฝั่งเซิร์ฟเวอร์ของเฟรมเวิร์กนั้น

ส่งรูปสลิปแทน QR Payload ได้ไหม

ได้ EasySlip API v2 รับได้ทั้ง QR Payload ไฟล์รูป Base64 และ URL แต่แต่ละแบบส่งข้อมูลต่างกัน ดูรูปแบบในเอกสาร API

สรุป

เชื่อม API ตรวจสลิปด้วย JavaScript ทำได้ในไม่กี่ขั้น สร้าง Endpoint ด้วย Express ส่ง QR Payload ไปที่ EasySlip API v2 เปิดการเช็กสลิปซ้ำ บัญชีผู้รับ และยอดเงิน แล้วอ่านผลก่อนยืนยันออเดอร์ทุกครั้ง สิ่งที่ต้องระวังที่สุดคือเก็บ API Key ไว้ฝั่งเซิร์ฟเวอร์ และจัดการกรณีผิดพลาดให้ครบ เริ่มใช้งานได้ที่ Slip Verification API จาก EasySlip

บทความที่เกี่ยวข้อง