ตรวจสลิปโอนเงินจากระบบของคุณด้วย HTTP ธรรมดา ส่งได้ทั้งรูปสลิปหรือข้อความจาก QR — ผลตอบกลับเป็น JSON
sk_live_…)POST https://slip.shicenter.net/api/v1/verify จากฝั่งเซิร์ฟเวอร์ ของคุณถ้าโฮสต์ไม่รองรับ URL แบบ /api/… ใช้ https://slip.shicenter.net/api.php/v1 แทนได้ผลเหมือนกัน
ส่งคีย์ใน header ทุกคำขอ (หรือใช้ X-API-Key: sk_live_…)
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ห้ามใส่คีย์ในโค้ดหน้าเว็บ/แอปที่ลูกค้าเห็น เพราะคนอื่นจะเอาไปใช้โควต้าของคุณได้ จำกัด 60 ครั้ง/นาที ต่อคีย์
ส่งเป็น multipart/form-data (แนบไฟล์) หรือ application/json อย่างใดอย่างหนึ่ง ต้องมี file, image หรือ payload อย่างน้อย 1 อย่าง
| ฟิลด์ | ชนิด | รายละเอียด |
|---|---|---|
| file | ไฟล์ | รูปสลิป JPG/PNG/WEBP ไม่เกิน 6 MB (multipart) |
| image | string | รูปสลิปแบบ base64 หรือ data URI (JSON) |
| payload | string | ข้อความที่อ่านได้จาก QR บนสลิป (ถ้าคุณอ่าน QR เองได้ เร็วและแม่นที่สุด) |
| amount | number | ยอดที่ต้องได้รับ เช่น 149.00 — ไม่ตรงจะได้ amount_mismatch |
| ref | string | เลขออเดอร์ของคุณ (ไม่เกิน 100 ตัว) ใช้ค้นย้อนหลังและส่งกลับใน webhook |
| store_image | boolean | false = ไม่เก็บรูปสลิปนี้ (ค่าเริ่มต้นตามตั้งค่าร้าน) |
ตัวอย่างผลตอบกลับ (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_only | QR ถูกรูปแบบและไม่ซ้ำ แต่ร้านยังไม่ได้ตั้งคีย์ตรวจกับธนาคาร จึงไม่รู้ยอด/ผู้รับจริง | ให้คนตรวจยอดเข้าบัญชีก่อน |
| fail | ไม่ผ่านแน่นอน เช่น สลิปซ้ำ, ธนาคารไม่พบรายการ, ยอด/ผู้รับไม่ตรง, ไม่มี QR | ปฏิเสธ แจ้งลูกค้าตาม reasons[].message |
| error | ตรวจไม่สำเร็จชั่วคราว เช่น ผู้ให้บริการ/ธนาคารขัดข้อง หรือคีย์ผู้ให้บริการมีปัญหา (ไม่นับโควต้า) | ลองใหม่ภายหลัง (ดู retry_after วินาที) |
checks บอกผลแต่ละข้อ (true/false/null = ไม่ได้เช็ก) — duplicate: true แปลว่าสลิปซ้ำ
รหัสใน reasons[].code (severity: fail, error, warn, info)
| code | severity | ข้อความ |
|---|---|---|
| qr_not_found | fail | ไม่พบ QR ในรูป — ใช้รูปสลิปเต็มใบที่เห็น QR ชัด ๆ |
| invalid_image | fail | ไฟล์เสียหรือไม่ใช่รูปภาพ |
| not_slip_qr | fail | QR นี้ไม่ใช่ QR สำหรับตรวจสลิป (อาจเป็น QR รับเงิน) |
| invalid_qr | fail | QR ในสลิปผิดรูปแบบหรือเสียหาย |
| duplicate | fail | สลิปนี้เคยถูกใช้แล้ว เมื่อ {when} |
| provider_duplicate | fail | ผู้ให้บริการตรวจสลิปแจ้งว่าสลิปนี้เคยถูกตรวจแล้ว |
| qr_mismatch | fail | ข้อมูลใน QR ไม่ตรงกับข้อมูลของธนาคาร (QR อาจถูกแก้ไข) |
| slip_not_found | fail | ธนาคารไม่พบรายการนี้ — อาจเป็นสลิปปลอม หรือเพิ่งโอน (ลองใหม่ในไม่กี่นาที) |
| amount_mismatch | fail | ยอดเงินไม่ตรง: สลิป {amount} บาท แต่ต้องการ {expected} บาท |
| receiver_mismatch | fail | บัญชีผู้รับในสลิปไม่ใช่บัญชีของร้าน |
| too_old | fail | สลิปเก่าเกินกำหนด ({hours} ชั่วโมง) |
| before_order | fail | สลิปนี้โอนก่อนสร้างคำสั่งซื้อ ใช้กับคำสั่งซื้อนี้ไม่ได้ |
| future_date | fail | วันเวลาในสลิปผิดปกติ (อยู่ในอนาคต) |
| provider_auth | error | คีย์ EasySlip/SlipOK ของร้านใช้ไม่ได้หรือหมดอายุ — แก้ที่หน้า ตั้งค่าร้าน |
| provider_quota | error | โควต้าเช็กกับธนาคาร (EasySlip/SlipOK) ของร้านหมดแล้ว |
| provider_unavailable | error | ระบบธนาคาร/ผู้ให้บริการขัดข้องชั่วคราว ลองใหม่อีกครั้งภายหลัง |
| bank_delay | error | สลิปจากธนาคารนี้ต้องรอสักครู่หลังโอนจึงจะตรวจได้ — ลองใหม่ในอีก {minutes} นาที |
| system_busy | error | ระบบกำลังตรวจสลิปใบนี้จากอีกคำขออยู่ — กรุณาลองใหม่อีกครั้ง |
| receiver_unconfirmed | warn | ยืนยันบัญชีผู้รับไม่ได้ครบ (ธนาคารปิดเลขบางส่วน) — โปรดดูชื่อผู้รับให้แน่ใจ |
| amount_unchecked | warn | ยังไม่ได้เช็กยอดเงิน (เช็กเบื้องต้นดูยอดไม่ได้) — ดูยอดเข้าในแอปธนาคารของร้านประกอบ |
| truemoney_qr_only | warn | สลิป TrueMoney ตรวจได้แค่เบื้องต้น (ยังไม่ได้เช็กยอด) |
| crc_warning | warn | QR ในรูปอ่านได้ไม่ครบ แต่ธนาคารยืนยันรายการนี้แล้ว |
| qr_only | info | ผ่านเบื้องต้น: QR ถูกต้องและไม่ซ้ำ แต่ยังไม่ได้เช็กยอดกับธนาคาร |
| receiver_not_set | info | ร้านยังไม่ได้ตั้งบัญชีรับเงิน จึงยังไม่ได้เช็กผู้รับ |
ตัวกรอง: limit (1–100), status, ref, trans_ref — เรียงจากใหม่ไปเก่า
{"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 (ภาษาไทย)
| HTTP | code | สาเหตุ |
|---|---|---|
| 400 | invalid_request | ไม่ได้ส่ง file/image/payload หรือค่าผิดรูปแบบ (invalid_amount, invalid_ref, invalid_json) |
| 401 | missing_api_key / invalid_api_key | ไม่มีคีย์ หรือคีย์ถูกยกเลิก |
| 402 | no_package / package_expired | ยังไม่มีแพ็กเกจหรือหมดอายุ |
| 403 | shop_suspended | บัญชีร้านถูกระงับ |
| 404 | not_found | ไม่พบ endpoint หรือผลตรวจ |
| 413 | file_too_large | ไฟล์ใหญ่เกินกำหนด |
| 415 | unsupported_media | ไม่ใช่ไฟล์รูป |
| 429 | rate_limited / quota_exceeded | เรียกถี่เกิน หรือโควต้าเดือนนี้หมด |
| 500 | server_error | ระบบขัดข้อง ลองใหม่ |
ตั้ง 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);import crypto from 'node:crypto';
// Express: app.post('/shislip', express.raw({ type: 'application/json' }), handler)
function verify(req, secret) {
const sig = Object.fromEntries(String(req.headers['x-shislip-signature'] || '')
.split(',').map(s => s.split('=')));
const mac = crypto.createHmac('sha256', secret).update(sig.t + '.' + req.body).digest('hex');
return sig.v1 && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(sig.v1))
&& Math.abs(Date.now() / 1000 - Number(sig.t)) < 300;
}import hmac, hashlib, time
def verify(body: bytes, header: str, secret: str) -> bool:
p = dict(x.split('=', 1) for x in header.split(','))
mac = hmac.new(secret.encode(), (p['t'] + '.').encode() + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, p.get('v1', '')) and abs(time.time() - int(p['t'])) < 300# ส่งรูปสลิป
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}'<?php
function shislip_verify(string $file, float $amount, string $ref): array {
$ch = curl_init('https://slip.shicenter.net/api/v1/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 40,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('SHISLIP_KEY')],
CURLOPT_POSTFIELDS => [
'file' => new CURLFile($file),
'amount' => number_format($amount, 2, '.', ''),
'ref' => $ref,
],
]);
$res = json_decode((string)curl_exec($ch), true) ?: [];
curl_close($ch);
return $res;
}
$r = shislip_verify($_FILES['slip']['tmp_name'], 149, 'ORDER-1001');
if (($r['data']['status'] ?? '') === 'pass') {
// จ่ายแล้ว
} else {
$msg = $r['data']['reasons'][0]['message'] ?? ($r['error']['message'] ?? 'ตรวจไม่สำเร็จ');
}// Node.js 18+
import { readFile } from 'node:fs/promises';
const form = new FormData();
form.append('file', new Blob([await readFile('slip.jpg')]), 'slip.jpg');
form.append('amount', '149.00');
form.append('ref', 'ORDER-1001');
const res = await fetch('https://slip.shicenter.net/api/v1/verify', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.SHISLIP_KEY}` },
body: form,
});
const { success, data, error } = await res.json();
if (success && data.status === 'pass') console.log('จ่ายแล้ว', data.slip.amount);
else console.log(data?.reasons?.[0]?.message ?? error?.message);import os, requests
with open('slip.jpg', 'rb') as f:
r = requests.post(
'https://slip.shicenter.net/api/v1/verify',
headers={'Authorization': f"Bearer {os.environ['SHISLIP_KEY']}"},
files={'file': f},
data={'amount': '149.00', 'ref': 'ORDER-1001'},
timeout=40,
).json()
if r.get('success') and r['data']['status'] == 'pass':
print('จ่ายแล้ว', r['data']['slip']['amount'])
else:
print((r.get('data') or {}).get('reasons', [{}])[0].get('message') or r['error']['message'])status === "pass" เท่านั้น — qr_only ยังไม่ยืนยันยอดกับธนาคารamount ทุกครั้ง และตั้งบัญชีรับเงินของร้าน เพื่อกันลูกค้าส่งสลิปของร้านอื่น/ยอดไม่ครบerror ให้ลองใหม่ภายหลัง ไม่ต้องให้ลูกค้าโอนใหม่