thanakan-qr

Thai bank slip QR code parser following the SCB specification.

Installation

pip install thanakan-qr

System Dependencies

QR parsing requires libzbar:

# Ubuntu/Debian
sudo apt-get install libzbar0

# macOS
brew install zbar

Usage

Parse from image

from PIL import Image
from thanakan_qr import SlipQRData

image = Image.open("slip.png")
data = SlipQRData.create_from_image(image)

print(f"Sending Bank: {data.payload.sending_bank_id}")
print(f"Transaction Ref: {data.payload.transaction_ref_id}")

Parse from QR string

from thanakan_qr import SlipQRData

data = SlipQRData.create_from_code("00520102...")
print(data.model_dump_json(indent=2))

API

SlipQRData

• SlipQRData.create_from_image(image) - Parse QR from PIL Image
• SlipQRData.create_from_code(code) - Parse QR from string

Exceptions

• not_bank_slip - Raised when QR is not a valid bank slip
• expect_single_qrcode - Raised when image has zero or multiple QR codes

Bank Codes

Documentation

Full documentation: https://ninyawee.github.io/thanakan/libraries/thanakan-qr/