API Reference

Public REST API สำหรับเชื่อมต่อระบบของคุณ (POS / ERP / บอท) เข้ากับ SlipBolt ยืนยันตัวตนด้วย API key (sk_live_… / sk_test_…) — ดู Authentication

Base URL

https://api.slip-bolt.com/api/v1

ทุก request ต้องมี header:

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

POST /api/v1/verify

ตรวจสลิปโอนเงิน 1 ใบ ส่งรูปสลิปเป็น raw bytes (ไม่ใช่ JSON / ไม่ใช่ base64)

Request

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"

Node.js

import { readFile } from 'node:fs/promises';

const image = await readFile('slip.jpg');
const res = await fetch('https://api.slip-bolt.com/api/v1/verify', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SLIPBOLT_API_KEY}`,
    'Content-Type': 'application/octet-stream',
  },
  body: image,
});

if (res.status === 402) throw new Error('โควตาหมด — อัปเกรดแพ็ก');
const data = await res.json();
console.log(data.verified, data.amount, res.headers.get('X-Slipbolt-Quota-Remaining'));

Python

import requests

with open("slip.jpg", "rb") as f:
    res = requests.post(
        "https://api.slip-bolt.com/api/v1/verify",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/octet-stream",
        },
        data=f.read(),
    )

if res.status_code == 402:
    raise RuntimeError("quota exhausted")
print(res.json()["verified"], res.headers["X-Slipbolt-Quota-Remaining"])

Response 200 OK

{
  "success": true,
  "data": {
    "id": "8f3c…",
    "status": "SUCCESS",
    "verified": true,
    "transRef": "015170106978META…",
    "amount": 250.0,
    "bankCode": "002",
    "bankName": "ธนาคารกรุงเทพ",
    "senderName": "นาย ก. …",
    "senderAccount": "xxx-x-x1234-x",
    "receiverName": "ร้าน ข.",
    "receiverAccount": "xxx-x-x5678-x",
    "transDate": "2026-06-17T03:21:05.000Z",
    "errorCode": null,
    "errorMessage": null,
    "createdAt": "2026-06-17T03:21:06.412Z",
    "duplicate": false,
    "cached": false,
    "latencyMs": 480,
    "environment": "live",
    "quota": { "used": 132, "limit": 500, "remaining": 368 }
  },
  "meta": { "requestId": "req_…", "timestamp": "2026-06-17T10:21:06+07:00" }
}

verified เป็น true เฉพาะเมื่อ status === "SUCCESS" — ดูตาราง status ด้านล่าง

Quota — pool เดียวกับสลิป LINE

การเรียก API ใช้โควตารายเดือนเดียวกับสลิปจาก LINE ของร้าน (pool เดียว นับรวมกัน) ไม่ใช่โควตาแยก — ใช้ผ่านช่องไหนก็หักจากก้อนเดียวกัน

ทุก response (รวม GET /api/v1/quota) แนบ header บอกยอดคงเหลือ:

{ "success": false, "statusCode": 402, "error": "Payment Required",
  "message": "โควตาสลิปรายเดือนของร้านถูกใช้หมดแล้ว — อัปเกรดแพ็กหรือรอรอบบิลถัดไป",
  "code": "QUOTA_EXCEEDED", "quota": { "used": 500, "limit": 500, "remaining": 0 } }

GET /api/v1/quota

อ่านโควตาคงเหลือ โดยไม่เปลือง verify — เหมาะให้ระบบ poll ก่อนยิงงานชุดใหญ่

curl https://api.slip-bolt.com/api/v1/quota \
  -H "Authorization: Bearer sk_live_..."

{
  "success": true,
  "data": {
    "used": 132,
    "limit": 500,
    "remaining": 368,
    "percentUsed": 26,
    "allowOverage": false,
    "planCode": "STARTER",
    "periodMonth": "2026-06",
    "daysUntilReset": 13
  }
}

GET /api/v1/me

ข้อมูลร้าน · คีย์ · แพ็ก · โควตาคงเหลือ — ไม่เปลืองโควตา เหมาะเรียกตอนบูตระบบของคุณ เพื่อเช็คว่าคีย์ถูกร้าน scope ครบ เหลือสลิปเท่าไหร่ และบัญชีรับเงินที่ระบบใช้เทียบผู้รับคือบัญชีไหน (สาเหตุอันดับหนึ่งของ RECEIVER_MISMATCH คือร้านยังไม่ได้เพิ่มบัญชีที่ลูกค้าโอนเข้า)

ช่วงทดลอง 7 วัน plan.code จะเป็น "TRIAL" และ quota.limit = 50 เสมอ แม้ร้านจะเคยเลือกการ์ด Pro/Business ตอนสมัคร — สิทธิ์แพ็กจ่ายเริ่มหลังชำระแล้วเท่านั้น

curl https://api.slip-bolt.com/api/v1/me \
  -H "Authorization: Bearer sk_live_..."

{
  "success": true,
  "data": {
    "shop": { "id": "8f3c…", "name": "ร้าน ข." },
    "apiKey": {
      "name": "POS หน้าร้าน",
      "prefix": "sk_live_a1b2c3",
      "environment": "live",
      "scopes": ["verify", "read"],
      "lastUsedAt": "2026-06-17T03:21:06.000Z",
      "createdAt": "2026-05-01T00:00:00.000Z"
    },
    "plan": { "code": "STARTER", "name": "Starter" },
    "quota": { "used": 132, "limit": 500, "remaining": 368, "percentUsed": 26,
      "overage": 0, "allowOverage": false, "planCode": "STARTER",
      "periodMonth": "2026-06", "daysUntilReset": 13 },
    "testQuota": { "used": 12, "limit": 200, "remaining": 188 },
    "rateLimit": { "perKeyPerMinute": 120, "verifyPerMinute": 240 },
    "payeeAccounts": [
      { "bankCode": "kbank", "kind": "BANK", "holder": "ร้าน ข.", "accountLast4": "5678", "isPrimary": true, "status": "ACTIVE" }
    ]
  }
}

GET /api/v1/transactions

ลิสต์ผลตรวจสลิปของร้านย้อนหลัง — ใหม่สุดก่อน แบ่งหน้าแบบ cursor รวมทุกช่องทาง (API / LINE / Dashboard) เหมาะกับตอน POST /verify หลุดกลางทาง (timeout/เน็ตตัด) แล้วอยากรู้ผลจริงโดยไม่ต้องส่งสลิปซ้ำ

curl "https://api.slip-bolt.com/api/v1/transactions?status=SUCCESS&limit=20" \
  -H "Authorization: Bearer sk_live_..."

{
  "success": true,
  "data": {
    "items": [ { "id": "8f3c…", "status": "SUCCESS", "verified": true, "…": "…" } ],
    "nextCursor": "7ab1…"
  }
}

ส่ง nextCursor กลับมาเป็น cursor เพื่อดึงหน้าถัดไป · null = หมดแล้ว

GET /api/v1/transactions/:id

ดึงผลตรวจสลิป 1 รายการ — ใช้คู่กับ webhook (รับ data.id จาก event แล้วมาดึงรายละเอียดเต็ม) รายการของร้านอื่น หรือ id ที่ไม่มีอยู่ → 404 เหมือนกัน (ไม่ยืนยันว่า id นั้นมีอยู่จริงในระบบ)

curl https://api.slip-bolt.com/api/v1/transactions/8f3c2a1e-… \
  -H "Authorization: Bearer sk_live_..."

Scopes

แต่ละ key ถือ scope ได้หลายตัว — endpoint ต้องการ scope ครบทุกตัวที่ระบุ (ตั้งค่าได้ที่ Settings → API Keys)

scope ไม่พอ → 403 Forbidden (API key missing scope(s): …)

Rate limit

120 req/min ต่อ key (เท่ากันทุกแพ็ก) + เพดานรวมของ POST /api/v1/verify ที่ 240 req/min เกินแล้ว → 429 Too Many Requests + header Retry-After · ดู Authentication

Transaction status

Idempotency

ระบบ dedupe ให้อัตโนมัติ — สองเคสที่ต่างกัน:

• ส่ง "รูปเดิม" ซ้ำภายใน 24 ชม. → cached: true · status/verified เป็นผลจริงของ รายการเดิม (retry ตอนเน็ตตัด/timeout ได้อย่างปลอดภัย — ไม่ตรวจซ้ำ ไม่หักโควตา)
• transRef เดียวกัน เคยตรวจผ่านไปแล้ว (คนละไฟล์รูป/ถ่ายซ้ำ) → duplicate: true และ status จะเป็น "DUPLICATE" เสมอในการตอบครั้งนี้ (verified: false) — ไม่ว่าผลตรวจ ครั้งแรกจะเป็นอะไรก็ตาม

Error envelope

ทุก error รูปแบบเดียวกัน:

{
  "success": false,
  "error": "Forbidden",
  "message": "API key missing scope(s): read",
  "statusCode": 403,
  "path": "/api/v1/quota",
  "requestId": "req_abc123",
  "timestamp": "2026-06-17T10:30:45+07:00"
}

ถัดไป

• Webhooks — รับ event slip.verified / slip.duplicate / slip.failed แบบ HMAC-signed แทนการ poll
• Authentication — รายละเอียด key · โควตาต่อแพ็ก · rate limit