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

หน้านี้พาจากสมัครเสร็จไปถึงคำขอแรกที่ได้ผล ใช้เวลาอ่านไม่กี่นาที ส่วนรายละเอียดทุก route อยู่ในเอกสารอ้างอิง

1. ออก API key#

1. สมัคร และยืนยันเบอร์โทร บัญชีจะได้เครดิตทดลอง 50 เครดิต (ตรวจได้ 50 ใบ)
2. เปิดหน้า API key กดออก key แล้วเลือกสิทธิ์ slip:lookup (ถ้าจะอ่านประวัติด้วย เลือก slip:read เพิ่ม สิทธิ์หนึ่งไม่ได้รวมอีกสิทธิ์)
3. คัดลอก key เก็บไว้ทันที key ขึ้นต้นด้วย csk_ และแสดงครั้งเดียวตอนออก เปิดดูซ้ำไม่ได้ เพราะระบบไม่ได้เก็บตัว key ไว้ ถ้าทำหาย ให้ออก key ใหม่แล้วเพิกถอนตัวเก่า

เก็บ key ไว้ฝั่งเซิร์ฟเวอร์ของคุณ ห้ามใส่ในโค้ดหน้าเว็บหรือแอปมือถือ

2. ส่งคำขอแรก#

อ่านข้อความใน QR บนสลิปด้วยเครื่องอ่าน QR ใดก็ได้ แล้วส่งมา

curl https://api.checkslip.com/api/slips/lookup \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY" \
  -H "Idempotency-Key: order-1042-slip-1" \
  -H "Content-Type: application/json" \
  -d '{"qr":"00330006000001010306902126302105340875102TH9104F86F"}'

const res = await fetch("https://api.checkslip.com/api/slips/lookup", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
    "Idempotency-Key": "order-1042-slip-1",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    qr: "00330006000001010306902126302105340875102TH9104F86F",
  }),
});
const data = await res.json();

import os

import requests

res = requests.post(
    "https://api.checkslip.com/api/slips/lookup",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
        "Idempotency-Key": "order-1042-slip-1",
    },
    json={
        "qr": "00330006000001010306902126302105340875102TH9104F86F",
    },
)
data = res.json()

ค่า qr ในตัวอย่างใช้ดูรูปแบบเท่านั้น ให้ใช้ข้อความจาก QR บนสลิปที่ลูกค้าส่งให้คุณ ถ้าไม่มี QR ในมือ ส่งรูปสลิปแทนได้ด้วย multipart/form-data ฟิลด์ image

3. อ่านคำตอบ#

ตัดสินจาก outcome ใน body ไม่ใช่จาก HTTP status

{
  "request_id": "0192d4e0-7c1a-7b3e-9f00-1a2b3c4d5e6f",
  "outcome": "FOUND",
  "checked_at": "2026-10-29T10:41:02+07:00",
  "slip": {
    "trans_ref": "630210534087",
    "transferred_at": "2026-10-29T10:33:30+07:00",
    "amount": {
      "satang": 5000,
      "currency": "THB"
    },
    "sender": {
      "bank": {
        "code": "KKP",
        "bot_code": "069",
        "name_th": "ธนาคารเกียรตินาคินภัทร",
        "name_en": "Kiatnakin Phatra Bank"
      },
      "name_th": "นาย สมชาย ใ",
      "name_en": "MR. SOMCHAI J",
      "account": "0439"
    },
    "receiver": {
      "kind": "BANK_ACCOUNT",
      "bank": {
        "code": "GSB",
        "bot_code": "030",
        "name_th": "ธนาคารออมสิน",
        "name_en": "Government Savings Bank"
      },
      "name_th": "นางสาว สมหญิง ร",
      "name_en": "MISS SOMYING R",
      "account": "9681"
    }
  }
}

ใน API ผลตรวจหนึ่งครั้งยังใช้ชื่อว่า check ในรหัส CHECK_NOT_FOUND ชื่อเดิมคงไว้เพื่อความเข้ากันได้ และหมายถึงผลตรวจเดียวกัน

4. เงื่อนไขการหักเครดิต#

หัก 1 เครดิตเฉพาะเมื่อผลเป็น FOUND ผลอื่นไม่หัก รวมถึง DUPLICATE และ NOT_FOUND

ถ้าผลเป็น PENDING (รอธนาคาร) ยังไม่หัก ระบบจะตรวจสอบซ้ำให้อัตโนมัติ ถ้าพบรายการภายหลังจะหัก 1 ตอนนั้น และส่งผลทาง webhook

ดูยอดเครดิตและรายการที่หักได้ในแอป

5. ส่ง Idempotency-Key ทุกคำขอ#

การเชื่อมต่อขัดข้อง หรือ timeout ก่อนได้คำตอบ ให้ส่งคำขอเดิมซ้ำด้วย Idempotency-Key เดิม ภายใน 24 ชั่วโมง คุณจะได้คำตอบของครั้งแรกกลับมา (request_id เดิม ผลเดิม) ไม่เรียกดูจากธนาคารใหม่และไม่หักเครดิตเพิ่ม

ถ้าส่งซ้ำโดยไม่มีคีย์เดิม ระบบจะมองเป็นคำขอใหม่ เมื่อครั้งแรกได้ FOUND ไปแล้ว ครั้งใหม่จะได้ DUPLICATE แทน ไม่หักเครดิต แต่โค้ดของคุณอาจเข้าใจผิดว่าสลิปถูกใช้ซ้ำ แล้วปฏิเสธลูกค้าที่จ่ายจริง

ส่งสลิปใบเดียวกันพร้อมกันหลายคำขอโดยไม่มีคีย์ ก็หักแค่ 1 ครั้ง: คำขอหนึ่งได้ FOUND ที่เหลือได้ DUPLICATE แต่ระหว่างที่คำขอแรกยังไม่จบ ทุกคำขอจองเครดิตไว้ชั่วคราว ถ้าเครดิตเหลือน้อย คำขอที่เกินอาจได้ 402 แทน DUPLICATE (ไม่หักทั้งคู่)

ใช้คีย์ที่ผูกกับออเดอร์และสลิปใบนั้น เช่น order-1042-slip-1 คีย์เดิมกับ body ที่ต่างกันจะได้ข้อผิดพลาด idempotency-key-reused และถ้าคำขอแรกยังทำงานอยู่จะได้ idempotency-in-flight ให้รอแล้วส่งใหม่ด้วยคีย์เดิม

6. ตอนมีปัญหา#

ข้อผิดพลาดทุกตัวเป็น application/problem+json (RFC 9457) อ่าน type เพื่อรู้ว่าเกิดอะไร แต่ละ type มีหน้าคำอธิบายและวิธีแก้

แจ้งทีมงานพร้อมค่า instance จาก response (เลขเดียวกับ header X-Request-Id)

ต่อไป#

• ธนาคารที่รองรับ
• รหัสข้อผิดพลาดทั้งหมด
• เอกสารอ้างอิงทุก route