คู่มือการใช้งาน

API Connect

ตรวจสอบสลิปด้วย QR-Code ตรวจสอบสลิปด้วยรูปภาพ ตรวจสอบสลิปด้วย Base64 ตรวจสอบสลิปด้วย Image Url สร้างรหัส QR PromptPay สร้าง Url QR PromptPay ดึงข้อมูลสลิปเก่า ดึงข้อมูลบัญชี

ตรวจสอบสลิปด้วย QR-Code

Authentication

Response

คู่มือการใช้งาน

Queue API

ตรวจสอบสลิปด้วย QR-Code

Requestรายละเอียด Request

Callbackรายละเอียด Callback

Responseรายละเอียด Response

ตัวอย่าง ตัวอย่างการใช้งาน

/api/queue/verify-slip/qr-code

POST

Auth Required

POST

Endpoint:

/api/queue/verify-slip/qr-code

Auth Required

เงื่อนไขการใช้งาน

จะต้องระบุ API Secret มากับ Header ทุกครั้ง ที่เรียกใช้งาน API*ดูวิธีใช้งานได้ที่หน้า Authentication
สามารถระบุ IP Whitelist เพื่อกำหนดการเข้าถึง API จาก IP ที่กำหนดได้
หากต้องการตรวจสอบเงื่อนไขสลิป ให้ส่งข้อมูลเฉพาะ Key ที่ต้องการตรวจสอบเท่านั้น*ดูวิธีใช้งานที่หน้า ตัวอย่างการใช้งาน

ตัวอย่าง Request Body (JSON)

Key

Type

Description

Example

Required

payload

Object

Object ข้อมูลทั้งหมด

{ payload: { ... } }

Object ข้อมูลทั้งหมด

payload.qrCode

String

รหัส QR Code

"0041000600000101030040220014242082547BPM049885102TH9104xxxx"

รหัส QR Code

payload.checkCondition

Object

Object ข้อมูลที่ต้องการตรวจสอบเงื่อนไข*ระบุหากต้องการตรวจสอบเงื่อนไขเพิ่มเติม

{ ... }

payload.checkCondition.checkDuplicate

Boolean

Flag สำหรับตรวจสอบสลิปซ้ำ*ระบุหากต้องการตรวจสอบสลิปซ้ำ

true | false

Flag สำหรับตรวจสอบสลิปซ้ำ*ระบุหากต้องการตรวจสอบสลิปซ้ำ

payload.checkCondition.checkReceiver

Array

Array การตรวจสอบบัญชีผู้รับ*ระบุได้มากกว่า 1 Object เพื่อตรวจสอบหลายเงื่อนไขในคราวเดียว*หากข้อมูลตรงกับเงื่อนไขอย่างน้อย 1 เงื่อนไขจะถือว่าสลิปถูกต้อง

[{ receiver1 }, { receiever2 }, ...]

payload.checkCondition.checkReceiver.accountType

String

ตรวจสอบประเภทบัญชี*ระบุหากต้องการตรวจสอบประเภทบัญชี

"01002" =

ธนาคารกรุงเทพ(Bangkok Bank)

"01004" =

ธนาคารกสิกรไทย(Kasikorn Bank)

"01006" =

ธนาคารกรุงไทย(Krung Thai Bank)

"01008" =

ธนาคารเจพีมอร์แกน เชส(JPMC)

"01011" =

ธนาคารทหารไทยธนชาต(TMB Thanachart Bank)

"01014" =

ธนาคารไทยพาณิชย์(SCB)

"01017" =

ธนาคารซิตี้แบงก์(CITI)

"01018" =

ธนาคารซูมิโตโม มิตซุย(SMBC)

"01020" =

ธนาคารสแตนดาร์ดชาร์เตอร์ด(SCBT)

"01022" =

ธนาคารซีไอเอ็มบีไทย(CIMB Thai Bank)

"01024" =

ธนาคารยูโอบี(UOB)

"01025" =

ธนาคารกรุงศรีอยุธยา(Krungsri Bank)

"01029" =

ธนาคารอินเดียนโอเวอร์ซีส์(IOBA)

"01030" =

ธนาคารออมสิน(GSB)

"01031" =

ธนาคารเอชเอสบีซี(HSBC)

"01032" =

ธนาคารดอยซ์แบงก์ เอจี(DB)

"01033" =

ธนาคารอาคารสงเคราะห์(GHB)

"01034" =

ธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร(BAAC)

"01039" =

ธนาคารมิซูโฮ(MIZUHO)

"01045" =

ธนาคารบีเอ็นพี พารีบาส์(BNPP)

"01052" =

ธนาคารแห่งประเทศจีน (ไทย)(BOC)

"01066" =

ธนาคารอิสลามแห่งประเทศไทย(Islamic Bank)

"01067" =

ธนาคารทิสโก้(TISCO Bank)

"01069" =

ธนาคารเกียรตินาคินภัทร(Kiatnakin Bank)

"01070" =

ธนาคารไอซีบีซี (ไทย)(ICBC Thai)

"01071" =

ธนาคารไทยเครดิต(Thai Credit Bank)

"01073" =

ธนาคารแลนด์ แอนด์ เฮ้าส์(LH Bank)

"01088" =

ธนาคารคลิกซ์(CLICX Bank)

"01098" =

ธพว.(SME Bank)

"02001" =

PromptPay เบอร์โทรศัพท์

"02003" =

PromptPay บัตรประชาชน/เลขประจำตัวผู้เสียภาษี

"02004" =

PromptPay รหัส E-Wallet

"03000" =

K+ Shop (KBANK), แม่มณี (SCB), Be Merchant NextGen (BBL), TTB Smart Shop (TTB), ร้านน้องหอมจัง (BAAC)

"04000" =

True Money Wallet

ตรวจสอบประเภทบัญชี*ระบุหากต้องการตรวจสอบประเภทบัญชี

payload.checkCondition.checkReceiver.accountNameTH

String

ชื่อบัญชีผู้รับภาษาไทย*ระบุหากต้องการตรวจสอบชื่อบัญชีภาษาไทย

"สมชาย สลิปทูโก"*ห้ามใส่คำนำหน้า

ชื่อบัญชีผู้รับภาษาไทย*ระบุหากต้องการตรวจสอบชื่อบัญชีภาษาไทย

payload.checkCondition.checkReceiver.accountNameEN

String

ชื่อบัญชีผู้รับภาษาอังกฤษ*ระบุหากต้องการตรวจสอบชื่อบัญชีภาษาอังกฤษ

"Somchay Slip2go"*ห้ามใส่คำนำหน้า

ชื่อบัญชีผู้รับภาษาอังกฤษ*ระบุหากต้องการตรวจสอบชื่อบัญชีภาษาอังกฤษ

payload.checkCondition.checkReceiver.accountNumber

String

เลขที่บัญชี*ระบุหากต้องการตรวจสอบเลขที่บัญชี

"xxxxxx1234"*ห้ามเว้นวรรคหรือใส่สัญลักษณ์

เลขที่บัญชี*ระบุหากต้องการตรวจสอบเลขที่บัญชี

payload.checkCondition.checkAmount

Object

Object การตรวจสอบจำนวนเงิน*ระบุหากต้องการตรวจสอบจำนวนเงินโอน

{ ... }

Object การตรวจสอบจำนวนเงิน*ระบุหากต้องการตรวจสอบจำนวนเงินโอน

payload.checkCondition.checkAmount.type

String

รูปแบบการตรวจสอบจำนวนเงิน*ระบุรูปแบบการตรวจสอบ

"lte" = น้อยกว่าหรือเท่ากับ"eq" = เท่ากับ"gte" = มากกว่าหรือเท่ากับ*หากไม่ระบุจะมีค่าเท่ากับ "eq"

รูปแบบการตรวจสอบจำนวนเงิน*ระบุรูปแบบการตรวจสอบ

payload.checkCondition.checkAmount.amount

String

จำนวนเงิน*ระบุจำนวนเงินที่ต้องการตรวจสอบ

"10000"*ห้ามใส่ 0 และลูกน้ำ

จำนวนเงิน*ระบุจำนวนเงินที่ต้องการตรวจสอบ

payload.checkCondition.checkDate

Object

Object การตรวจสอบวันที่โอน*ระบุหากต้องการตรวจสอบวันที่โอน

{ ... }

Object การตรวจสอบวันที่โอน*ระบุหากต้องการตรวจสอบวันที่โอน

payload.checkCondition.checkDate.type

String

รูปแบบการตรวจสอบวันที่*ระบุรูปแบบการตรวจสอบ

payload.checkCondition.checkDate.date

DateISO

วันที่โอน*ระบุวันที่โอน

"2025-10-05T14:48:00.000Z"*ระบุเป็นเวลา GMT

วันที่โอน*ระบุวันที่โอน

รายละเอียด Callback

Key

Type

Description

Example

ตัวอย่าง

code

String

รหัสผลลัพธ์ของการทำรายการ

"200000"

รหัสผลลัพธ์ของการทำรายการ

message

String

ข้อความผลลัพธ์ของการทำรายการ

"Slip found"

ข้อความผลลัพธ์ของการทำรายการ

data

Object | undefined

ผลลัพธ์ข้อมูลทั้งหมด

{ ... }

ผลลัพธ์ข้อมูลทั้งหมด

data.queueId

String

รหัสคิวสลิป

"92887bf5-6683-4746-9c68-b857-4xxxxxxxxx",

รหัสคิวสลิป

data.decode

String

รหัสอ้างอิง QR Code

"0041000600000101030040220014242082547BPM049885102TH9104xxxx",

รหัสอ้างอิง QR Code

data.transRef

String

รหัสอ้างอิงของข้อมูลชุดนี้

"015073144041ATF00999",

รหัสอ้างอิงของข้อมูลชุดนี้

data.dateTime

String

วันที่โอน

"2025-10-05T14:48:00.000Z",

วันที่โอน

data.amount

Number

จำนวนเงินที่โอน

data.ref1

String | NULL

รหัสอ้างอิง 1

"xxx" | null

รหัสอ้างอิง 1

data.ref2

String | NULL

รหัสอ้างอิง 2

"xxx" | null

รหัสอ้างอิง 2

data.ref3

String | NULL

รหัสอ้างอิง 3

"xxx" | null

รหัสอ้างอิง 3

data.receiver

Object

ข้อมูลผู้รับ

{ ... }

ข้อมูลผู้รับ

data.receiver.account

Object

ข้อมูลบัญชีผู้รับ

{ ... }

ข้อมูลบัญชีผู้รับ

data.receiver.account.name

String

ชื่อบัญชีผู้รับ

"บริษัท สลิปทูโก จำกัด"

ชื่อบัญชีผู้รับ

data.receiver.account.bank

Object

ข้อมูลธนาคารผู้รับ

{ ... }

ข้อมูลธนาคารผู้รับ

data.receiver.account.bank.account

String | NULL

เลขบัญชีธนาคารผู้รับ

"xxx-x-x5366-x"

เลขบัญชีธนาคารผู้รับ

data.receiver.account.proxy

Object | NULL

ข้อมูลตัวแทนบัญชีผู้รับ

{ ... } | null

ข้อมูลตัวแทนบัญชีผู้รับ

data.receiver.account.proxy.type

String | NULL

NATID, MSISDN, EWALLTID, EMAIL, BILLERID

"NATID"

NATID, MSISDN, EWALLTID, EMAIL, BILLERID

data.receiver.account.proxy.account

String | NULL

เลขตัวแทนบัญชีผู้รับ

"xxx-x-x5366-x"

เลขตัวแทนบัญชีผู้รับ

data.receiver.bank

Object

ข้อมูลธนาคารผู้รับ

{ ... }

ข้อมูลธนาคารผู้รับ

data.receiver.bank.id

String

เลขธนาคารผู้รับ

"004"

เลขธนาคารผู้รับ

data.receiver.bank.name

String | NULL

ชื่อธนาคารผู้รับ

"ธนาคารกสิกรไทย"

ชื่อธนาคารผู้รับ

data.sender

Object

ข้อมูลผู้ส่ง

{ ... }

ข้อมูลผู้ส่ง

data.sender.account

Object

ข้อมูลบัญชีผู้ส่ง

{ ... }

ข้อมูลบัญชีผู้ส่ง

data.sender.account.name

String

ชื่อผู้ส่ง

"บริษัท สลิปทูโก จำกัด",

ชื่อผู้ส่ง

data.sender.account.bank

Object

ข้อมูลบัญชีผู้ส่ง

{ ... }

ข้อมูลบัญชีผู้ส่ง

data.sender.account.bank.account

String

เลขที่บัญชีผู้ส่ง

"xxx-x-x9866-x"

เลขที่บัญชีผู้ส่ง

data.sender.bank

Object

ข้อมูลธนาคารผู้ส่ง

{ ... }

ข้อมูลธนาคารผู้ส่ง

data.sender.bank.id

String

เลขธนาคารผู้ส่ง

"004"

เลขธนาคารผู้ส่ง

data.sender.bank.name

String | NULL

ชื่อธนาคารผู้ส่ง

"ธนาคารกสิกรไทย"

ชื่อธนาคารผู้ส่ง

ตัวอย่าง Callback

{
    "code": "200000",
    "message": "Slip found.",
    "data": {
        "queueId": "92887bd5-60d3-4744-9a98-b8574eaxxxxx-xx",
        "decode": "0041000600000101030040220014242082547BPM049885102TH9104xxxx",
        "transRef": "015073144041ATF00999",
        "dateTime": "2025-10-05T14:48:00.000Z",
        "amount": 1,
        "ref1": null,
        "ref2": null,
        "ref3": null,
        "receiver": {
            "account": {
                "name": "บริษัท สลิปทูโก จำกัด",
                "bank": {
                    "account": "xxx-x-x5366-x"
                },
                "proxy": {
                    "type": "NATID",
                    "account": "xxx-x-x5366-x"
                }
            },
            "bank": {
                "id": "004",
                "name": "ธนาคารกสิกรไทย"
            }
        },
        "sender": {
            "account": {
                "name": "บริษัท สลิปทูโก จำกัด",
                "bank": {
                    "account": "xxx-x-x9866-x"
                }
            },
            "bank": {
                "id": "004",
                "name": "ธนาคารกสิกรไทย"
            }
        }
    }
}

รายละเอียด Response

สถานะ

รายละเอียด

HTTP

Response

ตัวอย่าง

Successfully Queue

ข้อมูลบันทึกลง Queue สำเร็จ

200

200202

ข้อมูลบันทึกลง Queue สำเร็จ (200 / 200202)

QR Code is missing

QR Code ไม่ถูกต้อง

400

400001

QR Code ไม่ถูกต้อง (400 / 400001)

File is incorrect

File ไม่ถูกต้อง

400

400002

File ไม่ถูกต้อง (400 / 400002)

Reference Id is invalid

ไม่พบรหัส Reference Id

400

400003

ไม่พบรหัส Reference Id (400 / 400003)

Image url format is not Valid

Image url มี format ไม่ถูกต้อง

400

400004

Image url มี format ไม่ถูกต้อง (400 / 400004)

Base64 format is not Valid

Base64 มี format ไม่ถูกต้อง

400

400005

Base64 มี format ไม่ถูกต้อง (400 / 400005)

Request object is invalid

ข้อมูลการตรวจสอบไม่ถูกต้อง

400

400400

ข้อมูลการตรวจสอบไม่ถูกต้อง (400 / 400400)

Request is conflicted

ส่ง request ข้อมูลซ้ำซ้อน

400

400409

ส่ง request ข้อมูลซ้ำซ้อน (400 / 400409)

Webhook URL is required for this service

Queue API จำเป็นต้องตั้งค่า Webhook URL ก่อน

400

400422

Queue API จำเป็นต้องตั้งค่า Webhook URL ก่อน (400 / 400422)

Authentication Token Mismatch

Token ไม่ถูกต้อง

401

401001

Token ไม่ถูกต้อง (401 / 401001)

Shop not found

ไม่พบร้านค้าหรือสาขานี้

401

401002

ไม่พบร้านค้าหรือสาขานี้ (401 / 401002)

Account not found

บัญชีถูกระงับ

401

401003

บัญชีถูกระงับ (401 / 401003)

Package Expired

แพ็กเกจหมดอายุ

401

401004

แพ็กเกจหมดอายุ (401 / 401004)

Insufficient Token

โทเคนตรวจสอบสลิปหมด

401

401005

โทเคนตรวจสอบสลิปหมด (401 / 401005)

Insufficient Credit

เครดิตไม่เพียงพอ

401

401006

เครดิตไม่เพียงพอ (401 / 401006)

IP Address not Allowed

IP Address ไม่ถูกต้อง

401

401007

IP Address ไม่ถูกต้อง (401 / 401007)

ตัวอย่าง Response

{
  "code": "200202",
  "message": "successfully queue.",
  "data": {
    "queueId": "92887bd5-60d3-4744-9a98-b8574eaxxxxx-xx"
  }
}

เงื่อนไขการใช้งาน

จะต้องระบุ API Secret มากับ Header ทุกครั้ง ที่เรียกใช้งาน API*ดูวิธีใช้งานได้ที่หน้า Authentication
สามารถระบุ IP Whitelist เพื่อกำหนดการเข้าถึง API จาก IP ที่กำหนดได้
หากต้องการตรวจสอบเงื่อนไขสลิป ให้ส่งข้อมูลเฉพาะ Key ที่ต้องการตรวจสอบเท่านั้น*ดูวิธีใช้งานที่หน้า ตัวอย่างการใช้งาน

ตัวอย่าง Request Body

ตัวอย่าง Code

ตัวอย่าง

ตรวจสลิปโดยไม่กำหนดเงื่อนไข

ตรวจสลิปแบบเช็คสลิปซ้ำ

ตรวจสลิปโดยตรวจประเภทบัญชี

ตรวจสลิปโดยตรวจเลขที่บัญชี

ตรวจสลิปโดยตรวจชื่อบัญชี

ตรวจสลิปโดยตรวจยอดเงินโอน

ตรวจสลิปโดยตรวจวันที่โอน

ตรวจบัญชีธนาคาร และ เลขที่บัญชี (01004 = ธนาคารกสิกรไทย)

ตรวจบัญชี PromptPay และ รหัส PromptPay (02001 = เบอร์โทรศัพท์)

ตรวจบัญชี Merchant และ รหัสร้านค้า (เช่น Kshop, แม่มณี)

ตรวจบัญชี TrueMoney ด้วยรหัส Wallet

ตรวจสลิปโดยตรวจประเภทบัญชีและชื่อบัญชี

ตรวจสลิปโดยตรวจประเภทบัญชี, ชื่อบัญชี และเลขที่บัญชี

ตรวจสลิปโดยตรวจประเภทบัญชี, ชื่อบัญชี, เลขที่บัญชี และยอดเงินโอน

ตรวจสลิปโดยตรวจประเภทบัญชี, ชื่อบัญชี, เลขที่บัญชี, ยอดเงินโอน และวันที่โอน

ตรวจสอบเงื่อนไขตามต้องการ และตรวจสอบสลิปซ้ำเพิ่มเติม

ตรวจสอบสลิปครั้งละหลายบัญชี (หากเงื่อนไขบัญชีใดเงื่อนไขหนึ่งถูกต้องจะนับว่าสลิปถูกต้อง)

ข้อมูลเงื่อนไขไม่ถูกต้อง (accountType ไม่ถูกต้อง)

ประเภท

ตัวอย่าง

วิธีการใช้งาน JavaScript

วิธีการใช้งาน Curl