เริ่มต้นใช้งาน
ตรวจสลิปแรกของคุณภายใน 5 นาที — ตั้งร้าน, ผูก LINE, เช็คโควตา, ยิง API (Starter ขึ้นไป)
ขั้นตอนทั้งหมดที่ต้องทำเพื่อให้ 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 → กระเบื้องโควตา | ทุกแพ็ก รวม Trial | used / 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

