thai-bank-transfer-qr 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# thai-bank-transfer-qr
+
+Minimal, dependency-free Thai bank transfer QR payload builder (PromptPay / Tag 29 + CRC16-CCITT).
+
+- No merchant name or city tags (59/60) included.
+- Privacy: never publish real bank account numbers.
+
+## Install
+
+Use directly in a monorepo or publish to npm.
+
+## Usage
+
+```js
+import buildThaiQRBankTransfer from "thai-bank-transfer-qr"
+
+const payload = buildThaiQRBankTransfer({
+  bankCode: "004",            // example only
+  accountNumber: "1234567890", // example only
+  amount: 10,
+  dynamic: false,              // 11 static, 12 dynamic
+})
+
+console.log(payload)
+```
+
+## API
+
+- buildThaiQRBankTransfer(options)
+  - bankCode: string (3 digits)
+  - accountNumber: string (digits only)
+  - amount: number|string (formatted to 2 decimals)
+  - dynamic?: boolean (default true)
+  - referenceId?: string (Tag 62 >> 05)
+
+Also exports: `tlv`, `crc16CCITT`.
+
+## License
+MIT

package/index.js

@@ -0,0 +1,85 @@
+// Minimal, dependency-free Thai bank transfer QR payload builder
+// Exports: buildThaiQRBankTransfer, tlv, crc16CCITT
+
+/**
+ * Tag-Length-Value encoder
+ * @param {string} tag
+ * @param {string} value
+ * @returns {string}
+ */
+export function tlv(tag, value) {
+  const len = value.length.toString().padStart(2, "0");
+  return `${tag}${len}${value}`;
+}
+
+/**
+ * CRC16-CCITT (poly 0x1021), init 0xFFFF, no XOR-out
+ * @param {string} input
+ * @returns {string} Uppercase hex (4 chars)
+ */
+export function crc16CCITT(input) {
+  let crc = 0xffff;
+  for (let i = 0; i < input.length; i++) {
+    crc ^= input.charCodeAt(i) << 8;
+    for (let j = 0; j < 8; j++) {
+      crc = crc & 0x8000 ? (crc << 1) ^ 0x1021 : crc << 1;
+      crc &= 0xffff;
+    }
+  }
+  return crc.toString(16).toUpperCase().padStart(4, "0");
+}
+
+/**
+ * Build Thai QR Bank Transfer payload (EMVCo + Thai spec)
+ * @param {Object} options
+ * @param {string} options.bankCode 3-digit Thai bank code (e.g. "004")
+ * @param {string} options.accountNumber Digits only
+ * @param {number|string} options.amount Fixed THB amount
+ * @param {boolean} [options.dynamic=true] Tag 01: 12=dynamic, 11=static
+ * @param {string} [options.merchantName]
+ * @param {string} [options.merchantCity]
+ * @param {string} [options.referenceId]
+ * @returns {string}
+ */
+export function buildThaiQRBankTransfer({
+  bankCode,
+  accountNumber,
+  amount,
+  dynamic = true,
+  referenceId,
+}) {
+  if (!/^\d{3}$/.test(bankCode))
+    throw new Error("bankCode must be 3 digits (e.g. 004)");
+  if (!/^\d+$/.test(accountNumber))
+    throw new Error("accountNumber must be digits only");
+
+  const amt = (
+    typeof amount === "number" ? amount : parseFloat(amount)
+  ).toFixed(2);
+  if (isNaN(Number(amt))) throw new Error("amount must be a number");
+
+  // Tag 29 (Bank transfer template) → 00=AID, 03=bankCode+accountNumber
+  const tag29 = tlv(
+    "29",
+    tlv("00", "A000000677010111") + tlv("03", `${bankCode}${accountNumber}`)
+  );
+
+  // Optional Tag 62 → 05=Reference ID
+  const tag62 = referenceId ? tlv("62", tlv("05", referenceId)) : "";
+
+  const withoutCRC =
+    tlv("00", "01") +
+    tlv("01", dynamic ? "12" : "11") +
+    tag29 +
+    tlv("52", "0000") +
+    tlv("53", "764") +
+    tlv("54", amt) +
+    tlv("58", "TH") +
+    tag62 +
+    "6304";
+
+  const crc = crc16CCITT(withoutCRC);
+  return withoutCRC + crc;
+}
+
+export default buildThaiQRBankTransfer;

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "thai-bank-transfer-qr",
+  "version": "0.1.0",
+  "description": "Thai bank transfer QR payload builder (PromptPay – Tag 29 + CRC16)",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "keywords": [
+    "thai",
+    "promptpay",
+    "qr",
+    "emv",
+    "bank",
+    "transfer"
+  ],
+  "license": "MIT",
+  "author": "thunthup",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thunthup/thai-bank-qr.git"
+  },
+  "homepage": "https://github.com/thunthup/thai-bank-qr#readme",
+  "bugs": {
+    "url": "https://github.com/thunthup/thai-bank-qr/issues"
+  }
+}