intro

เริ่มต้นใช้งาน

ตรวจสลิปแรกของคุณภายใน 5 นาที — ตั้งร้าน, ผูก LINE, เช็คโควตา, ยิง API (Starter ขึ้นไป)

⏱ 5 min
The documentation is currently written in Thai only — an English translation is on the way. The navigation and page chrome are already in English.

ขั้นตอนทั้งหมดที่ต้องทำเพื่อให้ SlipBolt ตรวจสลิปใบแรกของคุณ

1. สร้างบัญชี + ร้านค้า

ไปที่ app.slip-bolt.com/auth/signup แล้วยืนยันอีเมล จากนั้นตั้งชื่อร้านใน onboarding — ร้านแรกเริ่มทดลอง 7 วันเสมอ (สิทธิ์แพ็ก Trial เท่านั้น ไม่ใช่ Pro/Business ฟรี)

ช่วงทดลองได้:

  • 50 สลิป · 1 ที่นั่ง (เจ้าของ) · 1 กลุ่ม LINE · 1 LINE OA
  • ตรวจสลิปผ่าน LINE OA + Dashboard
  • ไม่มี REST API / Webhook — ออก API key ได้เมื่ออัปเกรดเป็น Starter ขึ้นไป

โควตาเหลือดูได้ทันทีที่ Dashboard (กระเบื้องโควตา) โดยไม่ต้องมี API key

2. เพิ่มบัญชีรับเงิน

Settings → Shop → บัญชีรับเงิน — ร้านที่ยังไม่มีบัญชีที่ลูกค้าโอนเข้า ระบบจะปัดสลิปทุกใบ (NO_PAYEE_CONFIGURED) ก่อนยิงไปตรวจ

3. ผูก LINE OA

ที่ Settings → LINE Channels วาง Channel ID + Secret + Access Token จาก LINE OA Manager แล้วเชิญบอทเข้ากลุ่ม ลองส่งสลิปทดสอบ 1 ใบ

4. สร้าง API key (แพ็ก Starter ขึ้นไป)

ที่ Settings → API Keys กดสร้าง key ใหม่ — ระบบจะแสดง key เต็ม ครั้งเดียวเท่านั้น ช่วง Trial ออกคีย์ไม่ได้ (403 PLAN_API_ACCESS_REQUIRED)

sk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Copy ทันที — เราเก็บแค่ argon2 hash บน server (ลืมแล้วต้องสร้างใหม่)

5. ยิงคำสั่งแรก

ส่ง รูปสลิปเป็น raw bytes (ไม่ใช่ JSON/base64) ไปที่ POST /api/v1/verify:

curl -X POST https://api.slip-bolt.com/api/v1/verify \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/octet-stream" \
  --data-binary "@slip.jpg"

ตอบกลับ:

{
  "success": true,
  "data": {
    "status": "SUCCESS",
    "verified": true,
    "amount": 50.0,
    "transRef": "20260525123045123456",
    "transDate": "2026-05-25T05:30:45.000Z",
    "senderName": "นายสมชาย ใจดี",
    "bankName": "ธนาคารกสิกรไทย",
    "receiverName": "ร้านกาแฟพี่ตุ๊ก",
    "quota": { "used": 1, "limit": 500, "remaining": 499 }
  }
}

การเรียก API ใช้ โควตาเดียวกับสลิป LINE ของร้าน · ยอดคงเหลือดูได้จาก quota ในผลลัพธ์หรือ header X-Slipbolt-Quota-Remaining · โควตาหมด → 402 (ดู API Reference) · ใช้ key sk_test_ ทดสอบได้โดยไม่กินโควตาของร้าน (เพดานแยก 200 ครั้ง/เดือน)

6. เช็คโควตาคงเหลือ (ไม่หักสลิป)

ช่องทางใช้เมื่อได้ข้อมูลอะไร
Dashboard → กระเบื้องโควตาทุกแพ็ก รวม Trialused / limit / เหลือกี่วันถึงรีเซ็ต
GET /api/v1/quotaมี API key + scope readโควตาร้านอย่างเดียว
GET /api/v1/meมี API key + scope readร้าน · คีย์ · แพ็ก · โควตา live+test · บัญชีรับเงิน (4 ตัวท้าย)
curl https://api.slip-bolt.com/api/v1/me \
  -H "Authorization: Bearer sk_live_..."

รายละเอียดฟิลด์อยู่ที่ API Reference — GET /me

7. รับ Webhook (optional)

หาก subscribe ที่ /settings/webhooks ระบบจะ POST event ทุกครั้งที่มีผลตรวจสลิปใหม่:

{
  "event": "slip.verified",
  "id": "evt_9f3c1a7b2d4e6f8a0b1c2d3e",
  "created": 1781107927,
  "data": {
    "transactionId": "8f3c…",
    "transRef": "20260525123045123456",
    "amount": 50.0,
    "status": "SUCCESS",
    "sender": "นายสมชาย ใจดี",
    "receiver": "ร้านกาแฟพี่ตุ๊ก",
    "verifiedAt": "2026-05-25T05:30:46.412Z",
    "latencyMs": 480
  }
}

Verify signature ทุกครั้ง — header X-Slipbolt-Signature มาในรูป t=<unix>,v1=<hex> โดย v1 = HMAC-SHA256(secret, "<ts>." + raw_body) · สตริงที่เซ็นไม่มี t= นำหน้า และต้องใช้ raw body — โค้ดตัวอย่างพร้อมใช้อยู่ที่ Webhooks

ขั้นถัดไป