thai-id-validate git:20260516.9cbe34cA

Immutable. This exact content never changes and is served at /api/v1/blob/c386409546fc89a7.

---
name: thai-id-validate
description: Use this skill for any task involving Thai national ID, tax ID, phone number, or PromptPay QR code validation, normalization, or generation. Trigger whenever the user asks to: validate a Thai citizen ID, check a tax ID checksum, normalize Thai phone numbers between +66 and 0X formats, or build a PromptPay QR payload. Also trigger for requests like "ตรวจเลขบัตรประชาชน", "เช็คเลขผู้เสียภาษี", "แปลงเบอร์โทร +66", "สร้าง PromptPay QR", "ทำคิวอาร์พร้อมเพย์", or any variation involving 13-digit Thai IDs or Thai phone formats.
---

# Thai ID / Phone / PromptPay (ตรวจเลขบัตร เบอร์ พร้อมเพย์)

## Overview
ตรวจสอบ checksum ของเลขบัตรประชาชนไทย / เลขประจำตัวผู้เสียภาษี (13 หลัก), แปลงเบอร์โทรระหว่างรูป `+66` กับ `0X`, และสร้าง payload สำหรับ PromptPay QR (รูปแบบ EMVCo TLV). Algorithm and TLV layout follow the official Thai Revenue Department and ITMX PromptPay specifications.

## When to use
- ตรวจ checksum เลขบัตรประชาชน 13 หลัก (citizen ID / individual tax ID share the same algorithm)
- Normalize เบอร์โทร: ผู้ใช้ป้อน `+66 81 234 5678` แต่ระบบเก็บ `0812345678`
- สร้าง QR สำหรับรับเงิน PromptPay จากเบอร์มือถือหรือเลขบัตรประชาชน
- DO NOT use for company tax IDs that follow non-standard formats, or for verifying that an ID belongs to a real person (checksum only proves format, not existence).

## Example prompts
- "ตรวจเลขบัตร 1-1017-00230-70-X ให้หน่อย"
- "เบอร์ 081-234-5678 แปลงเป็น E.164 ให้ที"
- "สร้าง PromptPay QR เบอร์ 0812345678 จำนวน 250 บาท"

## Quick reference

| Function | ภาษาไทย | Returns |
|---|---|---|
| `is_valid_thai_id(s)` | ตรวจ checksum | `bool` |
| `normalize_phone(s)` | แปลงเป็น `+66XXXXXXXXX` | `str` |
| `format_phone_thai(s)` | แปลงเป็น `0XX-XXX-XXXX` | `str` |
| `build_promptpay_payload(target, amount?)` | สร้าง QR payload | `str` |

### Thai ID checksum algorithm
ให้ตัวเลข 12 หลักแรก คูณด้วยน้ำหนัก `[13,12,11,10,9,8,7,6,5,4,3,2]` แล้วรวมกัน. นำผลรวม mod 11, เอา 11 ลบ, แล้ว mod 10 อีกครั้ง = check digit (หลักที่ 13).

### Phone format rules
- หลังจาก strip เครื่องหมายเว้นวรรค `-` `()` แล้ว
- ขึ้นต้น `+66`, `66`, หรือ `0` ถือว่าเทียบเท่ากัน
- มือถือ: 10 หลักรวม 0 (06, 08, 09 หลังจาก 0)
- บ้าน Bangkok: 9 หลักรวม 0 (เช่น 02-880-1234)

### PromptPay TLV (key tags)
- `00` Payload Format Indicator `01`
- `01` POI Method: `11` static / `12` dynamic (with amount)
- `29` Merchant Account Info → sub-tag `00` AID `A000000677010111`, sub-tag `01` phone (`0066` + เบอร์, pad to 13 chars) **or** `02` national ID (13 digits)
- `53` Currency `764` (THB)
- `54` Amount (optional)
- `58` Country `TH`
- `63` CRC-16/CCITT-FALSE (uppercase 4-hex) over the entire payload **including** the `6304` tag/length prefix

## Implementation
- Python: [`validate.py`](validate.py) — `python validate.py` runs all self-tests
- TypeScript: [`validate.ts`](validate.ts) — `npx tsx validate.ts` runs all self-tests

## Common mistakes
- **Hardcoded fake fixtures.** Don't paste a random 13-digit string and assume it passes. Build fixtures by computing the check digit from a 12-digit prefix.
- **Forgetting the `% 10` step.** When `total % 11 == 0`, `11 - 0 = 11`. Mod 10 yields `1`, not `11`.
- **PromptPay CRC scope.** The CRC is computed over the **entire** payload up to and including the literal `"6304"` tag+length, **not** just the body before tag 63.
- **Phone digit count.** Bangkok landlines are 9 digits (incl. leading 0); mobiles are 10. If you assume 10 always you'll mis-validate landlines.
- **Tax ID vs corporate ID.** Individual tax ID == citizen ID checksum. Juristic-person (company) tax IDs are a different 13-digit allocation but use the **same** checksum, so the same function validates both.