Opens in a new tab

เชื่อมต่อ API ตรวจสลิปเข้าแอปมือถือ Flutter และ React Native

เชื่อมต่อ API ตรวจสลิป เข้าแอปมือถือ Flutter และ React Native

แอปเติมเงิน แอปร้านค้า หรือแอปสมาชิกที่รับโอนเงิน เพิ่มระบบตรวจสลิปในแอปได้เลยด้วย EasySlip API ลูกค้าเลือกรูปสลิปหรือถ่ายจากกล้องในหน้าชำระเงิน แอปส่งไปตรวจ แล้วรู้ผลภายในไม่กี่วินาทีว่าสลิปจริงไหม ยอดตรงไหม และเคยใช้แล้วหรือยัง ลูกค้าไม่ต้องออกจากแอปไปส่งสลิปในแชต บทนี้อธิบายโครงสร้างที่ปลอดภัย พร้อมตัวอย่างโค้ด Flutter และ React Native

ทำไมแอปควรมีระบบตรวจสลิปในตัว

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

ระบบแบบนี้เหมาะกับแอปเติมเกม แอปขายคอร์ส แอปจองบริการ และแอปร้านค้าที่รับโอนผ่านพร้อมเพย์ ดูตัวอย่างระบบเติมเงินที่ วิธีสร้างระบบเติมเงินอัตโนมัติด้วย EasySlip API

โครงสร้างที่ถูกต้อง ห้ามใส่ API Key ในแอป

API Key ของ EasySlip เป็นรหัสสำหรับเรียกใช้โควตาของร้าน ถ้าใส่ไว้ในแอป คนอื่นแกะไฟล์แอปแล้วเอาไปใช้ได้ วิธีที่ถูกต้องคือให้แอปส่งรูปสลิปไปที่เซิร์ฟเวอร์ของร้านก่อน แล้วเซิร์ฟเวอร์เป็นคนเรียก EasySlip API

  1. ลูกค้าเลือกรูปสลิปในแอป
  2. แอปส่งรูปพร้อมเลขออเดอร์ไปที่เซิร์ฟเวอร์ของร้าน
  3. เซิร์ฟเวอร์ดึงยอดที่ต้องจ่ายจากออเดอร์ แล้วส่งรูปไปตรวจที่ EasySlip API พร้อมเงื่อนไขตรวจยอด ตรวจบัญชีผู้รับ และตรวจสลิปซ้ำ
  4. เซิร์ฟเวอร์อัปเดตออเดอร์ แล้วตอบผลกลับไปที่แอป

ยอดเงินต้องดึงจากออเดอร์ในฐานข้อมูลฝั่งเซิร์ฟเวอร์ ไม่ใช่รับมาจากแอป เพราะคนแก้ค่าที่แอปส่งได้ ส่วนการป้องกันเพิ่ม เช่น IP Whitelist อ่านที่ EasySlip API ป้องกันภัยด้วย IP Whitelist

โครงสร้างแอปมือถือ ส่งสลิปไปเซิร์ฟเวอร์ของร้าน แล้วเซิร์ฟเวอร์เรียก EasySlip API
โครงสร้างแอปมือถือ ส่งสลิปไปเซิร์ฟเวอร์ของร้าน แล้วเซิร์ฟเวอร์เรียก EasySlip API

ฝั่งเซิร์ฟเวอร์ รับสลิปจากแอปแล้วส่งตรวจ

ตัวอย่าง Node.js (Express + multer) รับรูปจากแอป ส่งไปตรวจที่ EasySlip API v2 ต้องใช้ Node.js 18 ขึ้นไป ฟังก์ชัน findOrder และ markOrderPaid เปลี่ยนเป็นของระบบร้านเอง ถ้าใช้ภาษาอื่น ดูบทเชื่อม API ด้วย Python, PHP หรือ C# ที่ลิงก์ท้ายบท

import express from 'express';
import multer from 'multer';

const app = express();
const upload = multer({ limits: { fileSize: 4 * 1024 * 1024 } });

app.post('/api/orders/:id/slip', upload.single('slip'), async (req, res) => {
  const order = await findOrder(req.params.id);
  const form = new FormData();
  form.append('image', new Blob([req.file.buffer]), req.file.originalname);
  form.append('matchAmount', String(order.amount));
  form.append('matchAccount', 'true');
  form.append('checkDuplicate', 'true');

  const r = await fetch('https://api.easyslip.com/v2/verify/bank', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.EASYSLIP_API_KEY}` },
    body: form
  });
  const result = await r.json();

  if (!result.success) return res.json({ ok: false, reason: result.error.code });
  const d = result.data;
  if (d.isDuplicate) return res.json({ ok: false, reason: 'DUPLICATE' });
  if (!d.matchedAccount) return res.json({ ok: false, reason: 'WRONG_ACCOUNT' });
  if (!d.isAmountMatched) return res.json({ ok: false, reason: 'AMOUNT_MISMATCH' });

  await markOrderPaid(order.id, d.rawSlip.transRef);
  res.json({ ok: true, amount: d.amountInSlip });
});

app.listen(3000);

เก็บค่า transRef (รหัสอ้างอิงรายการ) ไว้กับออเดอร์ ใช้ตามเรื่องย้อนหลังได้ และเป็นหลักฐานว่าออเดอร์นี้จ่ายด้วยรายการไหน

ตัวอย่างโค้ด Flutter

ใช้แพ็กเกจ image_picker เลือกรูป และ http ส่งรูปแบบ multipart ไปที่เซิร์ฟเวอร์ของร้าน ตั้ง imageQuality ไว้เพื่อลดขนาดไฟล์ให้ไม่เกิน 4 MB ตามเงื่อนไขของ API

import 'dart:convert';
import 'package:http/http.dart' as http;
import 'package:image_picker/image_picker.dart';

Future<Map<String, dynamic>> uploadSlip(String orderId) async {
  final picked = await ImagePicker().pickImage(
    source: ImageSource.gallery,
    imageQuality: 80,
  );
  if (picked == null) return {'ok': false, 'reason': 'CANCELLED'};

  final req = http.MultipartRequest(
    'POST',
    Uri.parse('https://your-server.com/api/orders/$orderId/slip'),
  );
  req.headers['Authorization'] = 'Bearer $userToken';
  req.files.add(await http.MultipartFile.fromPath('slip', picked.path));

  final res = await http.Response.fromStream(await req.send());
  return jsonDecode(res.body) as Map<String, dynamic>;
}

userToken คือรหัสล็อกอินของผู้ใช้ในแอปของร้าน ใช้ยืนยันว่าคนส่งสลิปเป็นเจ้าของออเดอร์ ไม่ใช่ API Key ของ EasySlip ถ้าอยากให้ถ่ายจากกล้อง เปลี่ยน ImageSource.gallery เป็น ImageSource.camera

ตัวอย่างโค้ด React Native

ตัวอย่างนี้ใช้ expo-image-picker สำหรับโปรเจกต์ Expo ถ้าเป็น React Native CLI ใช้ react-native-image-picker แทนได้ หลักการส่งไฟล์เหมือนกัน

import * as ImagePicker from 'expo-image-picker';

export async function uploadSlip(orderId, userToken) {
  const picked = await ImagePicker.launchImageLibraryAsync({ quality: 0.8 });
  if (picked.canceled) return { ok: false, reason: 'CANCELLED' };

  const asset = picked.assets[0];
  const form = new FormData();
  form.append('slip', {
    uri: asset.uri,
    name: 'slip.jpg',
    type: asset.mimeType ?? 'image/jpeg',
  });

  const res = await fetch(`https://your-server.com/api/orders/${orderId}/slip`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${userToken}` },
    body: form,
  });
  return await res.json();
}

ไม่ต้องตั้ง Content-Type เอง ให้ fetch ใส่ค่า multipart/form-data พร้อม boundary ให้อัตโนมัติ

แสดงผลตรวจสลิปให้ลูกค้าเข้าใจง่าย

เซิร์ฟเวอร์ตอบกลับเป็นรหัสสั้นๆ ให้แอปแปลงเป็นข้อความที่ลูกค้าอ่านแล้วรู้ว่าต้องทำอะไรต่อ

  • ok: แสดงว่าชำระเงินสำเร็จ พร้อมยอดที่ได้รับ แล้วพาไปหน้าออเดอร์
  • DUPLICATE: สลิปนี้เคยใช้แล้ว ให้ติดต่อร้าน
  • WRONG_ACCOUNT: สลิปนี้ไม่ได้โอนเข้าบัญชีร้าน ตรวจบัญชีปลายทางอีกครั้ง
  • AMOUNT_MISMATCH: ยอดที่โอนไม่ตรงกับยอดที่ต้องจ่าย
  • SLIP_NOT_FOUND: อ่าน QR Code ไม่ได้ ให้เลือกรูปสลิปที่ชัดและไม่ถูกครอป
  • SLIP_PENDING: สลิปธนาคารกรุงเทพที่เพิ่งโอนไม่ถึง 5 นาที อาจยังตรวจไม่ได้ ให้รอสักครู่แล้วลองใหม่

รหัสข้อผิดพลาดอื่นๆ ดูความหมายและวิธีรับมือที่ รวม Error Code ของ EasySlip API

API ตรวจสลิป หน้าจอแอปมือถือแสดงผลตรวจสลิปสำเร็จและกรณีสลิปซ้ำ
หน้าจอแอปมือถือแสดงผลตรวจสลิปสำเร็จและกรณีสลิปซ้ำ

ข้อควรรู้ก่อนเปิดใช้จริง

  • ไฟล์รูปต้องไม่เกิน 4 MB เป็น JPEG, PNG, GIF หรือ WebP
  • เพิ่มบัญชีรับเงินของร้านไว้ใน EasySlip ก่อน ไม่อย่างนั้นค่า matchedAccount จะว่างทุกครั้ง ร้านหนึ่งเพิ่มได้สูงสุด 10 บัญชี
  • ถ้าแอปรับสลิป TrueMoney Wallet ด้วย ใช้ช่องทางตรวจ POST /verify/truewallet แยกต่างหาก อ่านเพิ่มที่ สลิป TrueMoney Wallet ตรวจได้ไหม
  • ทุกครั้งที่เรียกตรวจนับเป็นโควตาของแพ็กเกจ ป้องกันการกดส่งซ้ำหลายรอบด้วยการปิดปุ่มระหว่างรอผล
  • ทดสอบกับสลิปจริงหลายธนาคาร ทั้งสลิปปกติ สลิปซ้ำ และยอดไม่ตรง ก่อนปล่อยแอปเวอร์ชันใหม่ ดู วิธีทดสอบ API ตรวจสลิป ก่อนขึ้น Production

ราคา EasySlip API สำหรับแอป

EasySlip API ทดลองใช้ฟรี 7 วัน แพ็กเกจรายเดือนเริ่มต้น Start 99 บาท ตรวจได้ 250 ครั้ง Basic 350 บาท 1,000 ครั้ง Starter 700 บาท 2,500 ครั้ง ไปจนถึง Premium-3 40,000 บาท 320,000 ครั้ง ทุกแพ็กเกจใช้ได้ 30 วัน แอปที่มีรายการชำระเงินมาก แพ็กเกจใหญ่ราคาต่อครั้งจะถูกลง เช่น Diamond 5,000 บาท 35,000 ครั้ง ตกครั้งละประมาณ 0.14 บาท ดูราคาทุกแพ็กเกจที่ Slip Verification API ส่วนการเลือกแพ็กเกจรายเดือนหรือรายปี อ่านที่ EasySlip API รายเดือน vs รายปี เลือกแบบไหนให้คุ้มที่สุด

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

เรียก EasySlip API จากแอปตรงๆ ได้ไหม

ไม่ควร เพราะต้องใส่ API Key ไว้ในแอป ซึ่งคนอื่นดึงไปใช้ได้ ให้ส่งผ่านเซิร์ฟเวอร์ของร้านตามโครงสร้างในบทนี้

มี SDK สำหรับ Flutter หรือ React Native ไหม

ฝั่งเซิร์ฟเวอร์ใช้ SDK เหล่านี้ได้ ส่วนในแอปแค่ส่งรูปไปเซิร์ฟเวอร์ตามตัวอย่างข้างบน

ใช้ Firebase แทนเซิร์ฟเวอร์ของตัวเองได้ไหม

ได้ เขียนโค้ดฝั่งเซิร์ฟเวอร์เป็น Cloud Functions แล้วเก็บ API Key ไว้ในค่าตั้งค่าลับของ Functions หลักการเหมือนตัวอย่าง Node.js ในบทนี้

ตรวจสลิปจากหลายแอปด้วยบัญชีเดียวได้ไหม

ได้ ทุกแอปส่งไปที่เซิร์ฟเวอร์ของร้าน และใช้ API Key เดียวกัน โควตาใช้ร่วมกัน ถ้าแต่ละแอปมีบัญชีรับเงินต่างกัน เพิ่มบัญชีไว้ในระบบให้ครบ

สรุป

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

อ่านต่อ:

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