xNearby APIs

Slip Verification API

บริการตรวจสอบสลิปโอนเงินธนาคาร ดึงยอดเงิน และเช็คข้อมูลผู้รับเงินแบบอัตโนมัติ

POST

/slipVerify/v2

⭐ แนะนำที่สุด

ตรวจสอบสลิปแบบอัตโนมัติเต็มรูปแบบ เพียงแนบรูปภาพสลิป ระบบจะอ่าน QR Code และ OCR ยอดเงินให้อัตโนมัติ พร้อมทั้งสามารถระบุข้อมูลผู้รับเงินเพื่อตรวจสอบความถูกต้องได้ในคำสั่งเดียว

พารามิเตอร์ (Form-Data)

Field Type Description
slip จำเป็น File ไฟล์รูปภาพสลิปโอนเงิน (JPEG, PNG, WEBP)
expected_receiver_name ไม่บังคับ String ชื่อผู้รับเงินที่คาดหวัง เช่น "สมชาย ใจดี" หรือ "สมชาย"
expected_bank_code ไม่บังคับ String รหัสธนาคาร 3 หลัก ("004", "014") หรือตัวย่อ ("KBANK", "SCB") [ดูรหัสทั้งหมด]
expected_account_no ไม่บังคับ String เลขบัญชีผู้รับเงินแบบเต็ม เช่น "067-8-999346" หรือเลขท้าย 4 ตัว เช่น "346"
จำเป็นต้องมีสิทธิ์ v2 ใน API Key
cURL
curl -X POST https://api.nearbyshop.xyz/slipVerify/v2 \
  -H 'X-API-Key: nb_live_your_api_key_here' \
  -F 'slip=@slip.jpg' \
  -F 'expected_receiver_name=สมชาย ใจดี' \
  -F 'expected_bank_code=KBANK' \
  -F 'expected_account_no=346'
Node.js (Axios)
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const form = new FormData();
form.append('slip', fs.createReadStream('slip.jpg'));
form.append('expected_receiver_name', 'สมชาย ใจดี');
form.append('expected_bank_code', 'KBANK');
form.append('expected_account_no', '346');

const res = await axios.post('https://api.nearbyshop.xyz/slipVerify/v2', form, {
    headers: {
        'X-API-Key': 'nb_live_your_api_key_here',
        ...form.getHeaders()
    }
});
console.log(res.data);
Python (Requests)
import requests

url = 'https://api.nearbyshop.xyz/slipVerify/v2'
headers = {'X-API-Key': 'nb_live_your_api_key_here'}
data = {
    'expected_receiver_name': 'สมชาย ใจดี',
    'expected_bank_code': 'KBANK',
    'expected_account_no': '346'
}
files = {'slip': open('slip.jpg', 'rb')}

res = requests.post(url, headers=headers, data=data, files=files)
print(res.json())
PHP (cURL)
<?php
$ch = curl_init('https://api.nearbyshop.xyz/slipVerify/v2');
$postData = [
    'slip' => new CURLFile('slip.jpg'),
    'expected_receiver_name' => 'สมชาย ใจดี',
    'expected_bank_code' => 'KBANK',
    'expected_account_no' => '346'
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-API-Key: nb_live_your_api_key_here']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

ตัวอย่างผลลัพธ์ (Response 200 OK)

JSON Response (200 OK)
{
  "status": "success",
  "data": {
    "trans_id": "202609031200183310899",
    "type": "BANK_TRANSFER",
    "amount": 100,
    "date_time": "2026-09-03T12:00:00.000Z",
    "sender": {
      "name": "นาย สมศักดิ์ สุขใจ",
      "bank": "ธนาคารไทยพาณิชย์ จำกัด (มหาชน)",
      "bank_code": "014",
      "bank_abbr": "SCB",
      "account_no": "xxx-x-x1234-x"
    },
    "receiver": {
      "name": "นาย สมชาย ใจดี",
      "bank": "ธนาคารกสิกรไทย จำกัด (มหาชน)",
      "bank_code": "004",
      "bank_abbr": "KBANK",
      "details": {
        "account_no": "067-8-xxx346"
      }
    }
  },
  "extracted_amount": 100
}
POST

/slipVerify/v1

ตรวจสอบสลิปโดยการอัปโหลดไฟล์ภาพ และระบุจำนวนเงินที่ต้องการตรวจสอบด้วยตัวเอง

พารามิเตอร์ (Form-Data)

Field Type Description
qr_img จำเป็น File ไฟล์รูปภาพสลิปโอนเงิน
amount จำเป็น String จำนวนเงินที่ต้องการตรวจสอบ เช่น "100.00"
expected_receiver_name ไม่บังคับ String ชื่อผู้รับเงินที่คาดหวัง เช่น "สมชาย ใจดี"
expected_bank_code ไม่บังคับ String รหัสธนาคาร เช่น "004" หรือ "KBANK" [ดูรหัสทั้งหมด]
expected_account_no ไม่บังคับ String เลขบัญชีผู้รับเงินแบบเต็ม หรือเลขท้าย 4 ตัว
จำเป็นต้องมีสิทธิ์ v1 ใน API Key
cURL
curl -X POST https://api.nearbyshop.xyz/slipVerify/v1 \
  -H 'X-API-Key: nb_live_your_api_key_here' \
  -F 'qr_img=@slip.jpg' \
  -F 'amount=100.00' \
  -F 'expected_bank_code=KBANK'
POST

/slipVerify/noSlip

⚡ เร็วที่สุด

ตรวจสอบสลิปผ่าน QR Payload และจำนวนเงิน โดยไม่ต้องอัปโหลดไฟล์รูปภาพ เหมาะสำหรับระบบที่ถอดรหัส QR Code มาจากฝั่ง Client แล้ว

พารามิเตอร์ (Form-Data หรือ JSON)

Field Type Description
qr_payload จำเป็น String ข้อความ Raw Payload จาก QR Code (เช่น "00460006000001...")
amount จำเป็น String จำนวนเงินที่ต้องการตรวจสอบ
expected_receiver_name ไม่บังคับ String ชื่อผู้รับเงินที่คาดหวัง
expected_bank_code ไม่บังคับ String รหัสธนาคาร (เช่น "004" หรือ "KBANK") [ดูรหัสทั้งหมด]
expected_account_no ไม่บังคับ String เลขที่บัญชีผู้รับเงิน
จำเป็นต้องมีสิทธิ์ noSlip ใน API Key
cURL
curl -X POST https://api.nearbyshop.xyz/slipVerify/noSlip \
  -H 'X-API-Key: nb_live_your_api_key_here' \
  -F 'qr_payload=0046000600000101030040225202609031200000462385o94634ugqprde5102TH910404C7' \
  -F 'amount=100.00' \
  -F 'expected_account_no=346'

🛡️ ระบบตรวจสอบข้อมูลผู้รับเงิน (Receiver Validation)

ระบบตรวจผู้รับเงินถูกออกแบบมาเพื่อป้องกันกรณีลูกค้าส่งสลิปโอนผิดบัญชี หรือส่งสลิปโอนเงินให้ผู้อื่นมาแอบอ้าง โดยระบบรองรับความยืดหยุ่นสูง ดังนี้:

1. ชื่อ-นามสกุล ผู้รับเงิน

  • ส่งชื่อ-นามสกุลเต็มได้ เช่น "สมชาย ใจดี"
  • มี/ไม่มีคำนำหน้าได้ (นาย/นาง/นางสาว/MR)
  • สลิปธนาคารที่ย่อนามสกุล (เช่น "สมชาย จ.") ระบบจะจับคู่และผ่านให้อัตโนมัติ

2. รหัสธนาคาร (Bank Code)

3. เลขที่บัญชี (Account No)

  • ส่งเลขบัญชีเต็มได้ทั้งแบบมีขีด ("067-8-999346") หรือไม่มีขีด
  • ส่งเฉพาะเลขท้าย 4 ตัวได้ เช่น "0346" หรือ "346"
  • ระบบจะเทียบทั้งส่วนหน้าและหลังกับเลข unmasked ในสลิปอย่างแม่นยำ

ตัวอย่างการตอบกลับเมื่อข้อมูลผู้รับเงินไม่ตรง (HTTP 400)

JSON Error Response (400 Bad Request)
{
  "status": "error",
  "code": "RECEIVER_NAME_MISMATCH",
  "message": "ชื่อผู้รับเงินในสลิป (นาย สมชาย ใจดี) ไม่ตรงกับที่ระบุ (นาย วิทยา ทรัพย์สมบูรณ์)",
  "actual_receiver": {
    "name": "นาย สมชาย ใจดี",
    "bank_abbr": "KBANK",
    "bank_code": "004",
    "details": {
      "account_no": "067-8-xxx346"
    }
  }
}

🏦 รหัสและตัวย่อธนาคารที่รองรับ (Bank Codes & Abbreviations)

41 ธนาคาร

รหัสธนาคารและตัวย่อทั้งหมดที่ระบบ SlipVerify รองรับ สำหรับนำไปใช้ในพารามิเตอร์ expected_bank_code ของการตรวจสอบผู้รับเงิน (Receiver Validation) หรือข้อมูลที่ได้รับกลับมาใน actual_receiver.bank_code และ actual_receiver.bank_abbr

💡 เคล็ดลับการระบุค่า expected_bank_code:
  • ส่งได้ทั้ง รหัสตัวเลข 3 หลัก เช่น "004" หรือ ตัวย่อภาษาอังกฤษ เช่น "KBANK"
  • ระบบไม่จำกัดตัวพิมพ์เล็กหรือใหญ่ (Case-Insensitive) เช่น "kbank" หรือ "KBANK" ใช้ได้เหมือนกัน
  • หากส่งตัวเลขไม่มีศูนย์นำหน้า เช่น "4" ระบบจะแปลงเป็น "004" ให้อัตโนมัติ
  • คลิกที่รหัสหรือตัวย่อ ในตารางด้านล่างเพื่อคัดลอก (Copy) ไปใช้งานได้ทันที
แสดง 41 ธนาคาร
Bank Code ตัวย่อ (Abbr) ชื่อธนาคาร (ไทย / อังกฤษ) ประเภท ตัวอย่างค่าที่ส่ง
ธนาคารแห่งประเทศไทย
Bank of Thailand
🏛️ รัฐ/เฉพาะกิจ "BOT" หรือ "001"
ธนาคารกรุงเทพ จำกัด (มหาชน)
BANGKOK BANK PUBLIC COMPANY LTD.
⭐ ยอดนิยม "BBL" หรือ "002"
ธนาคารกสิกรไทย จำกัด (มหาชน)
KASIKORNBANK
⭐ ยอดนิยม "KBANK" หรือ "004"
ธนาคารเอบีเอ็น แอมโร
ABN-AMRO Bank N.V. Bangkok Branch
🏢 พาณิชย์ "AMRO" หรือ "005"
ธนาคารกรุงไทย จำกัด (มหาชน)
KRUNG THAI BANK PUBLIC COMPANY LTD.
⭐ ยอดนิยม "KTB" หรือ "006"
ธนาคารเจพีมอร์แกน เชส
JP Morgan Chase Bank, N.A Bangkok Branch
🏢 พาณิชย์ "JPMC" หรือ "008"
ธนาคารแห่งโตเกียว-มิตซูบิชิ ยูเอฟเจ
The Bank of Tokyo-Mitsubishi Ltd. Bangkok Branch
🏢 พาณิชย์ "BTMU" หรือ "010"
ธนาคารทหารไทยธนชาต
TMBThanachart Bank
⭐ ยอดนิยม "TTB" หรือ "011"
ธนาคารไทยพาณิชย์ จำกัด (มหาชน)
THE SIAM COMMERCIAL BANK PUBLIC COMPANY LIMITED
⭐ ยอดนิยม "SCB" หรือ "014"
ธนาคารนครหลวงไทย
Siam City Bank Public Company Limited
🏢 พาณิชย์ "SCIB" หรือ "015"
ธนาคารซิตี้แบงก์
Citibank N.A.
🏢 พาณิชย์ "CITI" หรือ "017"
ธนาคารซูมิโตโม มิตซุย แบงกิ้ง คอร์ปอเรชั่น
Sumitomo Mitsui Banking Corporation
🏢 พาณิชย์ "SMBC" หรือ "018"
ธนาคารสแตนดาร์ดชาร์เตอร์ด (ไทย)
Standard Chartered Bank (Thai)
🏢 พาณิชย์ "SCBT" หรือ "020"
ธนาคารซีไอเอ็มบี ไทย
CIMB Thai Bank
⭐ ยอดนิยม "CIMB" หรือ "022"
ธนาคารยูโอบี
United Overseas Bank (Thai)
⭐ ยอดนิยม "UOB" หรือ "024"
ธนาคารกรุงศรีอยุธยา
Bank of Ayudhya
⭐ ยอดนิยม "BAY" หรือ "025"
ธนาคารเมกะ สากลพาณิชย์
Mega International Commercial Bank PCL
🏢 พาณิชย์ "MEGA" หรือ "026"
ธนาคารเกียรตินาคิน จำกัด (มหาชน)
KIATNAKIN BANK PUBLIC COMPANY LIMITED
🏢 พาณิชย์ "BA" หรือ "027"
ธนาคารคาลิยอน
Calyon
🏢 พาณิชย์ "CALYON" หรือ "028"
ธนาคารไอโอบีเอ จำกัด (มหาชน)
IOBA Bank Public Company Limited
🏢 พาณิชย์ "IOBA" หรือ "029"
ธนาคารออมสิน
Government Savings Bank
⭐ ยอดนิยม "GSB" หรือ "030"
ธนาคารฮ่องกงและเซี่ยงไฮ้แบงกิ้งคอร์ปอเรชั่น
Hongkong and Shanghai Banking Corporation Limited
🏢 พาณิชย์ "HSBC" หรือ "031"
ธนาคารดอยช์แบงก์
Deutsche Bank Aktiengesellschaft
🏢 พาณิชย์ "DEUTSCHE" หรือ "032"
ธนาคารอาคารสงเคราะห์
Government Housing Bank
⭐ ยอดนิยม "GHB" หรือ "033"
ธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร
Bank for Agriculture and Agricultural Cooperatives
⭐ ยอดนิยม "BAAC" หรือ "034"
ธนาคารมิซูโฮ คอร์ปอเรต
Mizuho Corporate Bank Limited
🏢 พาณิชย์ "MHCB" หรือ "039"
ธนาคารบีเอ็นพีพี จำกัด (มหาชน)
BNPP Bank Public Company Limited
🏢 พาณิชย์ "BNPP" หรือ "045"
ธนาคารบีโอซี จำกัด (มหาชน)
BOCB Bank Public Company Limited
🏢 พาณิชย์ "BOCB" หรือ "052"
ธนาคารธนชาต
Thanachart Bank Public Company Limited
🏢 พาณิชย์ "TBANK" หรือ "065"
ธนาคารอิสลามแห่งประเทศไทย
Islamic Bank of Thailand
🏛️ รัฐ/เฉพาะกิจ "ISBT" หรือ "066"
ธนาคารทิสโก้
Tisco Bank Public Company Limited
🏢 พาณิชย์ "TISCO" หรือ "067"
ธนาคารเอไอจี เพื่อรายย่อย
AIG Retail Bank Public Company Limited
🏢 พาณิชย์ "AIG" หรือ "068"
ธนาคารเกียรตินาคินภัทร
Kiatnakin Phatra Bank Public Company Limited
⭐ ยอดนิยม "KKP" หรือ "069"
ธนาคารสินเอเซีย
ACL Bank Public Company Limited
🏢 พาณิชย์ "ACL" หรือ "070"
ธนาคารไทยเครดิต เพื่อรายย่อย
The Thai Credit Retail Bank Public Company Limited
🏢 พาณิชย์ "TCRB" หรือ "071"
ธนาคารแลนด์ แอนด์ เฮ้าส์
Land and Houses Bank Public Company Limited
⭐ ยอดนิยม "LHBANK" หรือ "073"
ธนาคารซูมิโตโม มิตซุย ทรัสต์ (ไทย) จำกัด (มหาชน)
SMTB Bank Public Company Limited
🏢 พาณิชย์ "SMTB" หรือ "080"
ธนาคารแอสเซนด์ แบงก์ จำกัด (มหาชน)
ASCB Bank Public Company Limited
🏢 พาณิชย์ "ASCB" หรือ "087"
ธนาคารคลิกซ์
CLICX Bank Public Company Limited
🏢 พาณิชย์ "CLICX" หรือ "088"
ธนาคารแบงก์เอกซ์ จำกัด (มหาชน)
BNKX Bank Public Company Limited
🏢 พาณิชย์ "BNKX" หรือ "089"
ธนาคารธวพ. จำกัด (มหาชน)
SMEA Bank Public Company Limited
🏛️ รัฐ/เฉพาะกิจ "SMEA" หรือ "098"

⚠️ รหัสข้อผิดพลาดของสลิป (Slip Error Codes)

รหัสข้อผิดพลาดเฉพาะที่อาจเกิดขึ้นระหว่างการสแกน OCR, การอ่าน QR Code หรือการตรวจสอบสลิปกับระบบธนาคาร:

HTTP Status Error Code สาเหตุ / ความหมาย
400 Bad Request RECEIVER_NAME_MISMATCH ชื่อผู้รับเงินในสลิปไม่ตรงกับที่ระบุใน expected_receiver_name
400 Bad Request RECEIVER_BANK_MISMATCH ธนาคารผู้รับเงินในสลิปไม่ตรงกับที่ระบุใน expected_bank_code
400 Bad Request RECEIVER_ACCOUNT_MISMATCH เลขที่บัญชีผู้รับเงินในสลิปไม่ตรงกับที่ระบุใน expected_account_no
400 Bad Request AMOUNT_MISMATCH ยอดเงินที่ส่งไปตรวจสอบไม่ตรงกับยอดเงินจริงที่ทำรายการในสลิปธนาคาร
400 Bad Request QR_NOT_FOUND ไม่พบ QR Code ในรูปภาพ หรือภาพสลิปเบลอ/แตกเกินกว่าจะอ่านได้
400 Bad Request SLIP_DATA_INCOMPLETE ข้อมูลสลิปไม่สมบูรณ์ หรือสลิปปลอมที่ไม่มี Transaction Reference จากธนาคาร
400 Bad Request DUPLICATE_SLIP สลิปนี้เคยถูกส่งมาตรวจสอบและยืนยันในระบบไปแล้ว (ป้องกันการใช้สลิปซ้ำ)