泰国信用卡账单 OCR

读取泰国信用卡账单，返回卡片、持卡人、银行、每笔交易和各项余额，各字段附置信度。

POST/ocr/v3/creditcard-statement/file

另有 1 个端点

试一试

• 价格1 IC每页
• 累计调用18.8K次

• v3.0
• 运行中

输入

输出POST /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

全部字段见“响应”一节其他端点：/creditcard-statement 见请求

请求

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

响应

200成功。字段在"响应"一节说明。

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

请求

以 multipart/form-data 发送到 /file，或将图像以 Base64 发送到 /base64（JSON 或表单均可）。PDF 最多 10 页。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

filefile必填

账单。JPEG、PNG、HEIC、HEIF 或 PDF，最大 10 MB。使用 /base64 时改为发送 base64_string。

return_imageboolean

设为 true 时以 Base64 返回处理后的图像。

return_ocrboolean

设为 true 时附带原始 OCR 文本。

端点	接受	价格
/ocr/v3/creditcard-statement/file	文件	每页 1 IC
/ocr/v3/creditcard-statement/base64	base64_string	每页 1 IC

/v3/store/ocr/creditcard-statement 是 store 前缀下的同一服务。

响应

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	未知端点
500	处理失败

详情

实测

在 1,000 多份泰国信用卡账单的基准集上测得。

指标	结果
卡号	99.5%
金额	99.8%
日期	99.0%
交易	98.5%
全部字段	99.2%
耗时	典型 20–30 秒，第 95 百分位 45 秒，最长 60 秒

标准版式识别率 99% 以上，非标准版式 95% 以上，手写部分 90% 以上。

限制

• 泰文文档。
• 每个 API 密钥每秒 10 次请求。
• 分辨率低于 300 dpi、光线差、破损、褪色或手写修改会降低准确率。

数据处理

服务符合 GDPR 与 PDPA。

更新日志

版本	日期	变更
3.0	2024 年 12 月 27 日	首次发布。