# ตรวจสอบรายการโอนกับธนาคาร

Source: https://checkslip.com/docs/lookup-slip

POST `https://api.checkslip.com/api/slips/lookup`

ใช้ API key

ส่งข้อความ QR ที่อ่านได้จากสลิป หรือส่งรูปสลิป แล้วเราไปขอข้อมูลรายการโอนที่ธนาคารผู้โอนมีอยู่ และส่งข้อมูลนั้นกลับไป · เราส่งข้อมูลที่ธนาคารมีให้ ไม่ได้ตัดสินแทนคุณว่าจะรับเงินหรือไม่ คุณเอาข้อมูลไปเทียบกับออเดอร์ของคุณเอง · ผลอยู่ในฟิลด์ outcome เช่น FOUND (ธนาคารคืนข้อมูลรายการมา), NOT_FOUND (ธนาคารไม่มีรายการตามเลขนี้), DUPLICATE (บัญชีนี้เคยดึงรายการนี้แล้ว), PENDING (ธนาคารยังไม่ขึ้นรายการ ระบบลองใหม่ให้) · หัก 1 เครดิตเฉพาะเมื่อ outcome เป็น FOUND ผลอื่นไม่หักเครดิต · ไม่เก็บรูปสลิป เก็บเฉพาะข้อความใน QR · รูปไม่เกิน 10 MB และ 50 ล้านพิกเซล รับเฉพาะ JPEG, PNG และ WebP (HEIC, GIF และ PDF ได้ 422 invalid-file ไม่หักเครดิต) · ส่ง header Idempotency-Key ทุกครั้ง ส่งซ้ำด้วยค่าเดิมได้ผลเดิม และไม่หักเครดิตซ้ำ · ใช้ API key ที่มีสิทธิ์ slip:lookup

## Parameters

| ฟิลด์ | ส่งทาง | ชนิด | จำเป็น |
| --- | --- | --- | --- |
| `Idempotency-Key` | header | `string` | ไม่ |

## Request body

`application/json` รับแบบนี้ได้ด้วย: `multipart/form-data`

| ฟิลด์ | ชนิด | จำเป็น |
| --- | --- | --- |
| `qr` | `string` | ใช่ |
| `client_reference` | `string \| null` | ไม่ |

## Responses

### 200 `application/json`

| ฟิลด์ | ชนิด | จำเป็น |
| --- | --- | --- |
| `request_id` | `string (uuid)` | ใช่ |
| `outcome` | `FOUND \| NOT_FOUND \| DUPLICATE \| PENDING` | ใช่ |
| `checked_at` | `string (date-time)` | ใช่ |
| `slip` | `Slip \| SlipSummary` | ใช่ |
| `duplicate_of` | `DuplicateOf` | ไม่ |
| `duplicate_of.request_id` | `string (uuid)` | ใช่ |
| `duplicate_of.checked_at` | `string (date-time)` | ใช่ |
| `client_reference` | `string \| null` | ไม่ |

### 202 `application/json`

| ฟิลด์ | ชนิด | จำเป็น |
| --- | --- | --- |
| `request_id` | `string (uuid)` | ใช่ |
| `outcome` | `FOUND \| NOT_FOUND \| DUPLICATE \| PENDING` | ใช่ |
| `checked_at` | `string (date-time)` | ใช่ |
| `slip` | `Slip \| SlipSummary` | ใช่ |
| `duplicate_of` | `DuplicateOf` | ไม่ |
| `duplicate_of.request_id` | `string (uuid)` | ใช่ |
| `duplicate_of.checked_at` | `string (date-time)` | ใช่ |
| `client_reference` | `string \| null` | ไม่ |

### Error ที่อาจได้

400 401 402 403 409 413 415 422 429 500 503

error ในรูป Problem Details ดูรหัสทั้งหมดที่ [รหัสข้อผิดพลาด](https://checkslip.com/docs/errors)

**cURL**

```bash
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"}'
```

**Node.js**

```javascript
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();
```

**Python**

```python
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()
```

**200 found**

```json
{
  "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"
    }
  }
}
```

**200 found_bill_payment**

```json
{
  "request_id": "0192d4e0-7c1a-7b3e-9f00-1a2b3c4d5e70",
  "outcome": "FOUND",
  "checked_at": "2026-10-29T10:41:02+07:00",
  "slip": {
    "trans_ref": "630210534088",
    "transferred_at": "2026-10-29T10:33:30+07:00",
    "amount": {
      "satang": 125050,
      "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": "BILL_PAYMENT",
      "bank": null,
      "name_th": "บริษัท ตัวอย่าง จำกัด",
      "name_en": null,
      "account": null
    }
  }
}
```

**200 duplicate**

```json
{
  "request_id": "0192d4e2-1111-7c00-8000-000000000002",
  "outcome": "DUPLICATE",
  "checked_at": "2026-10-29T10:45:10+07:00",
  "slip": {
    "trans_ref": "630210534087",
    "sender_bank": {
      "code": "KKP",
      "bot_code": "069",
      "name_th": "ธนาคารเกียรตินาคินภัทร",
      "name_en": "Kiatnakin Phatra Bank"
    },
    "receiver_bank": {
      "code": "GSB",
      "bot_code": "030",
      "name_th": "ธนาคารออมสิน",
      "name_en": "Government Savings Bank"
    },
    "transferred_at": "2026-10-29T10:33:30+07:00",
    "amount": {
      "satang": 5000,
      "currency": "THB"
    }
  },
  "duplicate_of": {
    "request_id": "0192d4e0-7c1a-7b3e-9f00-1a2b3c4d5e6f",
    "checked_at": "2026-10-29T10:41:02+07:00"
  }
}
```

**202**

```json
{
  "request_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
  "outcome": "FOUND",
  "checked_at": "2026-11-05T09:30:00+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": "KKP",
        "bot_code": "069",
        "name_th": "ธนาคารเกียรตินาคินภัทร",
        "name_en": "Kiatnakin Phatra Bank"
      },
      "name_th": "ร้าน ทดสอบ",
      "name_en": "TEST S",
      "account": "0439"
    },
    "names_erased": true
  },
  "duplicate_of": {
    "request_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
    "checked_at": "2026-11-05T09:30:00+07:00"
  },
  "client_reference": "ORDER-10023"
}
```