OCR ใบแจ้งยอดบัตรเครดิต

อ่านใบแจ้งยอดบัตรเครดิตไทย แล้วส่งกลับข้อมูลบัตร ผู้ถือ ธนาคาร ทุกรายการ และยอดต่าง ๆ พร้อมค่าความมั่นใจรายฟิลด์

POST/ocr/v3/creditcard-statement/file

และอีก 1 endpoint

ทดลองใช้

• ราคา1 ICต่อหน้า
• ให้บริการแล้ว18.8Kครั้ง

• v3.0
• ใช้งานได้

Input

OutputPOST /ocr/v3/creditcard-statement/file

statementType

ใบแจ้งยอดบัญชีบัตรเครดิต

statementDate

31/12/2566

dueDate

25/01/2567

cardNumber

4711-XXXX-XXXX-1234

cardHolderName

นาย ทดสอบ ระบบ

bankName

ธนาคารกสิกรไทย จำกัด (มหาชน)

creditLimit

100000

newBalancePayment

15789.4

minimumPaymentDue

789.47

transactions

transactionDate: 20/12 postingDate: 21/12 description: CHOKCHAI STEAK HOUSE PATHUMTHANI THA foreignAmount: — foreignCurrencyCode: — amountTHB: 1089

previousBalance

14789.4

thisPeriodBalance

15789.4

ฟิลด์ทั้งหมดอยู่ในหัวข้อ Responseendpoint อื่น: /creditcard-statement ดูที่ Request

Request

curl -X POST https://api.iapp.co.th/ocr/v3/creditcard-statement/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@statement.pdf"

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
  "message": "success",
  "processed": {
    "statementType": "ใบแจ้งยอดบัญชีบัตรเครดิต",
    "statementDate": "31/12/2566",
    "dueDate": "25/01/2567",
    "cardNumber": "4711-XXXX-XXXX-1234",
    "cardHolderName": "นาย ทดสอบ ระบบ",
    "bankName": "ธนาคารกสิกรไทย จำกัด (มหาชน)",
    "creditLimit": 100000.0,
    "newBalancePayment": 15789.4,
    "minimumPaymentDue": 789.47,
    "transactions": [
      { "transactionDate": "20/12", "postingDate": "21/12",
        "description": "CHOKCHAI STEAK HOUSE PATHUMTHANI THA",
        "foreignAmount": null, "foreignCurrencyCode": null, "amountTHB": 1089.0 }
    ],
    "previousBalance": 14789.4,
    "thisPeriodBalance": 15789.4
  },
  "confidence": { "cardNumber": 0.95, "newBalancePayment": 0.95, "transactions": 0.9 }
}

Request

ส่งเป็น multipart/form-data ไปที่ /file หรือส่งภาพเป็น Base64 ไปที่ /base64 แบบ JSON หรือฟอร์มก็ได้ ไฟล์ PDF ได้ไม่เกิน 10 หน้า

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Body

filefilerequired

ใบแจ้งยอด ไฟล์ JPEG, PNG, HEIC, HEIF หรือ PDF ไม่เกิน 10 MB ถ้าใช้ /base64 ส่ง base64_string แทน

return_imageboolean

ใส่ true เพื่อรับภาพที่ประมวลผลแล้วกลับเป็น Base64

return_ocrboolean

ใส่ true เพื่อรับข้อความ OCR ดิบด้วย

Endpoint	รับ	ราคา
/ocr/v3/creditcard-statement/file	ไฟล์	1 IC ต่อหน้า
/ocr/v3/creditcard-statement/base64	base64_string	1 IC ต่อหน้า

/v3/store/ocr/creditcard-statement คือบริการเดียวกันภายใต้ prefix ของ store

Response

ฟิลด์ด้านล่างอยู่ใน processed และเมื่อตั้ง return_ocr เป็น true จะได้ raw ที่เป็นข้อความ OCR มาด้วย

statementTypestatementDateclosingDatedueDate

ใบแจ้งยอดและวันที่ต่าง ๆ

cardNumbercardHolderName

เลขบัตรตามที่พิมพ์แบบปิดบัง และชื่อผู้ถือ

bankNamebankAddressbankTaxIDbankPhonebankFax

ธนาคารผู้ออกบัตร

creditLimitinterestRatepaymentByDebitAccountNo

วงเงิน อัตราดอกเบี้ยเป็นเปอร์เซ็นต์ และบัญชีหักชำระ

transactionspayments_adjustment_others

รายการละหนึ่งชุด: transactionDate, postingDate, description, foreignAmount, foreignCurrencyCode, amountTHB

previousBalancethisPeriodBalancenewBalancePaymentminimumPaymentDuetotalPaymentstotalInterestCharges

ยอดต่าง ๆ บาท ทศนิยมสองตำแหน่ง

reward

คะแนนสะสม ได้รับ โบนัส ปรับปรุง และแลกใช้

paymentBarcodeNo

เลขบาร์โค้ดชำระเงิน

messagestring

ข้อความสถานะ

processedobject

ฟิลด์ที่อ่านได้จากเอกสาร

processed.statementTypestring

processed.statementDatestring

processed.dueDatestring

processed.cardNumberstring

processed.cardHolderNamestring

processed.bankNamestring

processed.creditLimitnumber

processed.newBalancePaymentnumber

processed.minimumPaymentDuenumber

processed.transactionsarray

processed.previousBalancenumber

processed.thisPeriodBalancenumber

confidenceobject

ความมั่นใจรายฟิลด์ 0 ถึง 1

รหัสสถานะ

รหัส	ความหมาย
400	พารามิเตอร์หรือรูปแบบไฟล์ไม่ถูกต้อง
404	ไม่รู้จัก Endpoint
500	ประมวลผลไม่สำเร็จ

รายละเอียดเพิ่มเติม

ผลการทดสอบ

วัดบนชุดทดสอบใบแจ้งยอดบัตรเครดิตไทยกว่า 1,000 ฉบับ

รายการ	ผล
เลขบัตร	99.5%
จำนวนเงิน	99.8%
วันที่	99.0%
รายการ	98.5%
ทุกฟิลด์	99.2%
เวลา	โดยทั่วไป 20–30 วินาที เปอร์เซ็นไทล์ที่ 95 อยู่ที่ 45 วินาที สูงสุด 60 วินาที

เอกสารรูปแบบมาตรฐานอ่านได้ 99% ขึ้นไป รูปแบบไม่มาตรฐาน 95% ขึ้นไป ส่วนที่เขียนด้วยลายมือ 90% ขึ้นไป

ข้อจำกัด

• เอกสารภาษาไทย
• 10 Request ต่อวินาทีต่อ API key
• ความละเอียดต่ำกว่า 300 dpi แสงไม่ดี เอกสารชำรุด สีจาง หรือการแก้ด้วยลายมือ ทำให้ความแม่นยำลดลง

การจัดการข้อมูล

บริการเป็นไปตาม GDPR และ PDPA

Changelog

เวอร์ชัน	วันที่	การเปลี่ยนแปลง
3.0	27 ธ.ค. 2567	เปิดให้บริการ