คู่มือ API SHI SLIP

ตรวจสลิปโอนเงินจากระบบของคุณด้วย HTTP ธรรมดา ส่งได้ทั้งรูปสลิปหรือข้อความจาก QR — ผลตอบกลับเป็น JSON

เริ่มต้น

  1. สมัครและเลือกแพ็กเกจ แล้วไปที่เมนู เชื่อมเว็บร้าน (API) สร้างคีย์ (sk_live_…)
  2. (แนะนำ) ตั้ง บัญชีรับเงิน และ คีย์ EasySlip/SlipOK ที่เมนู ตั้งค่าร้าน เพื่อยืนยันยอดกับธนาคาร
  3. เรียก POST https://slip.shicenter.net/api/v1/verify จากฝั่งเซิร์ฟเวอร์ ของคุณ
Base URL: https://slip.shicenter.net/api/v1

ถ้าโฮสต์ไม่รองรับ URL แบบ /api/… ใช้ https://slip.shicenter.net/api.php/v1 แทนได้ผลเหมือนกัน

การยืนยันตัวตน

ส่งคีย์ใน header ทุกคำขอ (หรือใช้ X-API-Key: sk_live_…)

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

ห้ามใส่คีย์ในโค้ดหน้าเว็บ/แอปที่ลูกค้าเห็น เพราะคนอื่นจะเอาไปใช้โควต้าของคุณได้ จำกัด 60 ครั้ง/นาที ต่อคีย์

ตรวจสลิป

POSThttps://slip.shicenter.net/api/v1/verify

ส่งเป็น multipart/form-data (แนบไฟล์) หรือ application/json อย่างใดอย่างหนึ่ง ต้องมี file, image หรือ payload อย่างน้อย 1 อย่าง

ฟิลด์ชนิดรายละเอียด
fileไฟล์รูปสลิป JPG/PNG/WEBP ไม่เกิน 6 MB (multipart)
imagestringรูปสลิปแบบ base64 หรือ data URI (JSON)
payloadstringข้อความที่อ่านได้จาก QR บนสลิป (ถ้าคุณอ่าน QR เองได้ เร็วและแม่นที่สุด)
amountnumberยอดที่ต้องได้รับ เช่น 149.00 — ไม่ตรงจะได้ amount_mismatch
refstringเลขออเดอร์ของคุณ (ไม่เกิน 100 ตัว) ใช้ค้นย้อนหลังและส่งกลับใน webhook
store_imagebooleanfalse = ไม่เก็บรูปสลิปนี้ (ค่าเริ่มต้นตามตั้งค่าร้าน)

ตัวอย่างผลตอบกลับ (HTTP 200)

{
    "success": true,
    "data": {
        "id": "chk_7hq2m9x4k3pw8vd5nr2a",
        "status": "pass",
        "passed": true,
        "level": "bank",
        "provider": "easyslip",
        "source": "api",
        "ref": "ORDER-1001",
        "expected_amount": 149.0,
        "checks": {
            "qr": true,
            "duplicate": false,
            "bank": true,
            "amount": true,
            "receiver": true,
            "age": true
        },
        "reasons": [],
        "slip": {
            "kind": "bank",
            "trans_ref": "016273145209ATF08813",
            "sending_bank": {
                "code": "004",
                "short": "KBANK",
                "name": "ธนาคารกสิกรไทย"
            },
            "receiving_bank": {
                "code": "014",
                "short": "SCB",
                "name": "ธนาคารไทยพาณิชย์"
            },
            "amount": 149.0,
            "date": "2026-09-24T14:32:05+07:00",
            "sender": {
                "name": "นาย สมชาย ใ",
                "account": "xxx-x-x1234-x"
            },
            "receiver": {
                "name": "ร้าน มิสิริ",
                "account": "xxx-x-x5678-x",
                "proxy": null
            },
            "payload": "0041000600000101030040220016273145209ATF088135102TH9104E699"
        },
        "duplicate_of": null,
        "created_at": "2026-09-24T14:33:10+07:00"
    }
}

ความหมายของผล

statusความหมายควรทำ
passธนาคารยืนยันรายการแล้ว และผ่านทุกเงื่อนไข (ไม่ซ้ำ, ยอด/ผู้รับ/อายุ ตามที่ตั้ง)เปิดออเดอร์ได้
qr_onlyQR ถูกรูปแบบและไม่ซ้ำ แต่ร้านยังไม่ได้ตั้งคีย์ตรวจกับธนาคาร จึงไม่รู้ยอด/ผู้รับจริงให้คนตรวจยอดเข้าบัญชีก่อน
failไม่ผ่านแน่นอน เช่น สลิปซ้ำ, ธนาคารไม่พบรายการ, ยอด/ผู้รับไม่ตรง, ไม่มี QRปฏิเสธ แจ้งลูกค้าตาม reasons[].message
errorตรวจไม่สำเร็จชั่วคราว เช่น ผู้ให้บริการ/ธนาคารขัดข้อง หรือคีย์ผู้ให้บริการมีปัญหา (ไม่นับโควต้า)ลองใหม่ภายหลัง (ดู retry_after วินาที)

checks บอกผลแต่ละข้อ (true/false/null = ไม่ได้เช็ก) — duplicate: true แปลว่าสลิปซ้ำ

รหัสใน reasons[].code (severity: fail, error, warn, info)

codeseverityข้อความ
qr_not_foundfailไม่พบ QR ในรูป — ใช้รูปสลิปเต็มใบที่เห็น QR ชัด ๆ
invalid_imagefailไฟล์เสียหรือไม่ใช่รูปภาพ
not_slip_qrfailQR นี้ไม่ใช่ QR สำหรับตรวจสลิป (อาจเป็น QR รับเงิน)
invalid_qrfailQR ในสลิปผิดรูปแบบหรือเสียหาย
duplicatefailสลิปนี้เคยถูกใช้แล้ว เมื่อ {when}
provider_duplicatefailผู้ให้บริการตรวจสลิปแจ้งว่าสลิปนี้เคยถูกตรวจแล้ว
qr_mismatchfailข้อมูลใน QR ไม่ตรงกับข้อมูลของธนาคาร (QR อาจถูกแก้ไข)
slip_not_foundfailธนาคารไม่พบรายการนี้ — อาจเป็นสลิปปลอม หรือเพิ่งโอน (ลองใหม่ในไม่กี่นาที)
amount_mismatchfailยอดเงินไม่ตรง: สลิป {amount} บาท แต่ต้องการ {expected} บาท
receiver_mismatchfailบัญชีผู้รับในสลิปไม่ใช่บัญชีของร้าน
too_oldfailสลิปเก่าเกินกำหนด ({hours} ชั่วโมง)
before_orderfailสลิปนี้โอนก่อนสร้างคำสั่งซื้อ ใช้กับคำสั่งซื้อนี้ไม่ได้
future_datefailวันเวลาในสลิปผิดปกติ (อยู่ในอนาคต)
provider_autherrorคีย์ EasySlip/SlipOK ของร้านใช้ไม่ได้หรือหมดอายุ — แก้ที่หน้า ตั้งค่าร้าน
provider_quotaerrorโควต้าเช็กกับธนาคาร (EasySlip/SlipOK) ของร้านหมดแล้ว
provider_unavailableerrorระบบธนาคาร/ผู้ให้บริการขัดข้องชั่วคราว ลองใหม่อีกครั้งภายหลัง
bank_delayerrorสลิปจากธนาคารนี้ต้องรอสักครู่หลังโอนจึงจะตรวจได้ — ลองใหม่ในอีก {minutes} นาที
system_busyerrorระบบกำลังตรวจสลิปใบนี้จากอีกคำขออยู่ — กรุณาลองใหม่อีกครั้ง
receiver_unconfirmedwarnยืนยันบัญชีผู้รับไม่ได้ครบ (ธนาคารปิดเลขบางส่วน) — โปรดดูชื่อผู้รับให้แน่ใจ
amount_uncheckedwarnยังไม่ได้เช็กยอดเงิน (เช็กเบื้องต้นดูยอดไม่ได้) — ดูยอดเข้าในแอปธนาคารของร้านประกอบ
truemoney_qr_onlywarnสลิป TrueMoney ตรวจได้แค่เบื้องต้น (ยังไม่ได้เช็กยอด)
crc_warningwarnQR ในรูปอ่านได้ไม่ครบ แต่ธนาคารยืนยันรายการนี้แล้ว
qr_onlyinfoผ่านเบื้องต้น: QR ถูกต้องและไม่ซ้ำ แต่ยังไม่ได้เช็กยอดกับธนาคาร
receiver_not_setinfoร้านยังไม่ได้ตั้งบัญชีรับเงิน จึงยังไม่ได้เช็กผู้รับ

ดูผลตรวจย้อนหลัง

GEThttps://slip.shicenter.net/api/v1/checks/{id}
GEThttps://slip.shicenter.net/api/v1/checks?limit=20&status=pass&ref=ORDER-1001

ตัวกรอง: limit (1–100), status, ref, trans_ref — เรียงจากใหม่ไปเก่า

ข้อมูลร้านและโควต้า

GEThttps://slip.shicenter.net/api/v1/me
{"success":true,"data":{"shop":{"name":"ร้านมิสิริ","status":"active"},"package":{"code":"pro","name":"โปร"},
 "expires_at":"2026-10-24T14:00:00+07:00","active":true,
 "usage":{"month":"2026-09","used":1320,"quota":5000,"remaining":3680},
 "verification":{"provider":"easyslip","level":"bank"}}}

ข้อผิดพลาด

คำขอที่ผิดจะได้ success: false พร้อม error.code และ error.message (ภาษาไทย)

HTTPcodeสาเหตุ
400invalid_requestไม่ได้ส่ง file/image/payload หรือค่าผิดรูปแบบ (invalid_amount, invalid_ref, invalid_json)
401missing_api_key / invalid_api_keyไม่มีคีย์ หรือคีย์ถูกยกเลิก
402no_package / package_expiredยังไม่มีแพ็กเกจหรือหมดอายุ
403shop_suspendedบัญชีร้านถูกระงับ
404not_foundไม่พบ endpoint หรือผลตรวจ
413file_too_largeไฟล์ใหญ่เกินกำหนด
415unsupported_mediaไม่ใช่ไฟล์รูป
429rate_limited / quota_exceededเรียกถี่เกิน หรือโควต้าเดือนนี้หมด
500server_errorระบบขัดข้อง ลองใหม่

Webhook

ตั้ง URL ที่เมนู เชื่อมเว็บร้าน (API) เราจะส่ง POST ทุกครั้งที่ตรวจเสร็จ (ทุกช่องทาง) body เป็น JSON:

{"event":"check.completed","data":{ …เหมือนผล /verify… },"sent_at":"2026-09-24T14:33:10+07:00"}

Header ที่ส่งไปด้วย: X-ShiSlip-Event, X-ShiSlip-Delivery, X-ShiSlip-Signature: t=<unix>,v1=<hex> — ลายเซ็นคือ HMAC-SHA256 ของ t + "." + body ด้วย webhook secret ของคุณ ตอบกลับ 2xx ภายใน 6 วินาที ไม่งั้นระบบส่งซ้ำ 3 ครั้ง

<?php
$secret = 'whsec_xxxxxxxx';
$body = file_get_contents('php://input');
$sig = $_SERVER['HTTP_X_SHISLIP_SIGNATURE'] ?? '';
parse_str(str_replace(',', '&', $sig), $p);           // t=..., v1=...
$expected = hash_hmac('sha256', $p['t'] . '.' . $body, $secret);
if (!hash_equals($expected, $p['v1'] ?? '') || abs(time() - (int)$p['t']) > 300) {
    http_response_code(400); exit('bad signature');
}
$event = json_decode($body, true);
if ($event['event'] === 'check.completed' && $event['data']['status'] === 'pass') {
    // $event['data']['ref'] = เลขออเดอร์ของคุณ → เปิดออเดอร์
}
http_response_code(200);

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

# ส่งรูปสลิป
curl -X POST https://slip.shicenter.net/api/v1/verify \
  -H "Authorization: Bearer sk_live_xxxxxxxx" \
  -F "file=@slip.jpg" -F "amount=149.00" -F "ref=ORDER-1001"

# ส่งข้อความจาก QR (ถ้าอ่าน QR เองได้)
curl -X POST https://slip.shicenter.net/api/v1/verify \
  -H "Authorization: Bearer sk_live_xxxxxxxx" -H "Content-Type: application/json" \
  -d '{"payload":"0041000600000101030040220016273145209ATF088135102TH9104E699","amount":149}'

ข้อแนะนำ

  • ยอมรับเงินเมื่อ status === "pass" เท่านั้น — qr_only ยังไม่ยืนยันยอดกับธนาคาร
  • ส่ง amount ทุกครั้ง และตั้งบัญชีรับเงินของร้าน เพื่อกันลูกค้าส่งสลิปของร้านอื่น/ยอดไม่ครบ
  • ระบบกันสลิปซ้ำให้แล้ว (ต่อร้าน) — สลิปที่ผ่านแล้วจะใช้ซ้ำไม่ได้ทุกช่องทาง
  • ตั้ง timeout ฝั่งคุณอย่างน้อย 30 วินาที เพราะบางครั้งต้องรอธนาคาร
  • ถ้าได้ error ให้ลองใหม่ภายหลัง ไม่ต้องให้ลูกค้าโอนใหม่