thai_qr_pay 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 10ad6dfb66ac4d72976350536d490f9b342d04de47a592ad41620d8ad89c6e4e
+  data.tar.gz: b1f04737a1e41e736a109fd82a5a1921fc7cd0c191c3bfce632df7eb56953d20
+SHA512:
+  metadata.gz: b1a848f79452f2c9adb643c88af872a599900445a6023c3e4174e0d2dde48603e7699043696c46ebfa985036f510a1225053496f22814bc3df935f14a08e2369
+  data.tar.gz: dc8aa130c9389eca193eeebeeb9368cf0b6dc9daa090b1504e36b989256d1e8a186a194cf0c85000b19c8ff54aa523918c5f2e24c9a5a32acfe8bef3bf1cfbd9

data/.gitignore

@@ -0,0 +1,56 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+# Gemfile
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chayut Orapinpatipat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,124 @@
+# Thai QR Pay / ไทยคิวอาร์เพย์
+
+A Ruby toolkit for Thailand’s EMVCo‐QR payments—PromptPay (AnyID & Bill Payment), TrueMoney, slip-verify, and BOT-barcode-to-QR conversion.  
+It provides:
+
+- ASCII-numeric TLV parsing & encoding  
+- EMVCo CRC-16/XMODEM checksum computation & validation  
+- PromptPay payload generators (AnyID, Bill Payment)  
+- BOT barcode ↔ EMVCo QR Tag-30 conversion  
+- Slip-verify & TrueMoney slip-verify validators  
+
+
+Ruby Gem สำหรับการชำระเงินผ่าน QR ตามมาตรฐาน EMVCo ของประเทศไทย รองรับ PromptPay (AnyID & Bill Payment), TrueMoney, slip-verify และการแปลง BOT barcode เป็น EMVCo QR  
+ฟีเจอร์:
+
+- การแยกวิเคราะห์ (parse) และสร้าง (encode) TLV แบบตัวเลข ASCII  
+- คำนวณและตรวจสอบค่า CRC-16/XMODEM ตามสเปค EMVCo  
+- สร้าง Payload สำหรับ PromptPay AnyID และ Bill Payment  
+- แปลง BOT barcode ↔ EMVCo QR Tag-30  
+- ตรวจสอบความถูกต้องของ Slip-verify และ TrueMoney slip-verify  
+
+---
+
+## Installation / การติดตั้ง
+
+
+```bash
+gem install thai_qr_pay
+````
+
+---
+
+## Usage / การใช้งาน
+
+```ruby
+require 'thai_qr_pay'
+```
+
+### 1. Parsing a QR payload / วิเคราะห์ QR payload
+
+
+```ruby
+qr_string = '000201010212...6304ABCD'
+parser = ThaiQrPay::Parser.new(qr_string, strict: true)
+
+puts parser.get_tag_value('00')        # => '01'
+puts parser.get_tag_value('29', '01')  # nested sub-tag
+```
+
+---
+
+### 2. Generating PromptPay AnyID / สร้าง PromptPay AnyID
+
+```ruby
+payload = ThaiQrPay::Generate::Promptpay::AnyID.payload(
+  type:   'MSISDN',
+  target: '0812345678',
+  amount: 100.0
+)
+# => "00020101021229...6304XXXX"
+```
+
+
+
+---
+
+### 3. Generating PromptPay Bill Payment / สร้าง PromptPay Bill Payment
+
+
+```ruby
+payload = ThaiQrPay::Generate::Promptpay::BillPayment.payload(
+  biller_id: '1234567890123',
+  ref1:      'INV001',
+  amount:    250.50
+)
+```
+
+
+---
+
+### 4. Converting BOT Barcode → QR Tag 30 / แปลง BOT Barcode เป็น QR Tag 30
+
+
+```ruby
+raw = "|1234567890123\rINV001\r\r012345"
+bot = ThaiQrPay::BOTBarcode.from_string(raw)
+qr_tag30 = bot.to_qr_tag30
+```
+
+---
+
+### 5. Validating Slip Verify / ตรวจสอบ Slip-verify
+
+
+```ruby
+result = ThaiQrPay::Validate::SlipVerify.call(qr_string)
+if result
+  puts result[:sending_bank]
+  puts result[:trans_ref]
+else
+  puts 'Invalid Slip-verify QR'
+end
+```
+
+---
+
+### 6. Validating TrueMoney Slip Verify / ตรวจสอบ TrueMoney Slip-verify
+
+```ruby
+tm_res = ThaiQrPay::Validate::TrueMoneySlipVerify.call(qr_string)
+if tm_res
+  puts tm_res[:event_type]
+  puts tm_res[:transaction_id]
+  puts tm_res[:date]
+else
+  puts 'Invalid TrueMoney Slip-verify QR'
+end
+```
+
+
+## License
+
+© 2025 Chayut Orapinpatipat
+Released under the MIT License. See [LICENSE.txt](LICENSE.txt) for details.

data/Rakefile

@@ -0,0 +1,13 @@
+# Rakefile
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'      # provides build, install, release, etc.
+require 'rspec/core/rake_task'   # hook up RSpec
+
+# Define the spec task
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = 'spec/**/*_spec.rb'
+end
+
+# Default task: run specs
+task default: :spec

data/lib/thai_qr_pay/bot_barcode.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module ThaiQrPay
+  # Parses BOT barcode strings and converts them into EMVCo QR Tag-30 payloads.
+  class BOTBarcode
+    attr_reader :biller_id, :ref1, :ref2, :amount, :_raw_amount
+
+    # str: raw BOT barcode like "|<biller>\r<ref1>\r<ref2>\r<amt>"
+    def self.from_string(str)
+      return unless str.start_with?('|')
+
+      parts = str[1..].split("\r", 4)
+      return unless parts.size == 4
+
+      bid, r1, r2, amt_str = parts
+      amount = amt_str != '0' ? (amt_str.to_i / 100.0) : nil
+      new(bid, r1, (r2.empty? ? nil : r2), amount, amt_str)
+    end
+
+    def initialize(biller_id, ref1, ref2 = nil, amount = nil, amt_str = nil)
+      @biller_id    = biller_id
+      @ref1         = ref1
+      @ref2         = ref2
+      @amount       = amount
+      @_raw_amount  = amt_str || (amount ? format('%d', (amount * 100).to_i) : '0')
+    end
+
+    # Reproduce exactly the original barcode string, including any leading zeros
+    def to_s
+      "|#{biller_id}\r#{ref1}\r#{ref2 || ''}\r#{_raw_amount}"
+    end
+
+    def to_qr_tag30
+      ThaiQrPay::Generate::Promptpay::BillPayment.payload(
+        biller_id: biller_id,
+        amount: amount,
+        ref1: ref1,
+        ref2: ref2
+      )
+    end
+  end
+end

data/lib/thai_qr_pay/crc16.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module ThaiQrPay
+  # CRC-16/XMODEM checksum routines for EMVCo QR (poly=0x1021, init=0xFFFF).
+  module CRC16
+    # Compute CRC-16/XMODEM (poly=0x1021, init=0xFFFF) bitwise
+    def self.xmodem(data)
+      crc = 0xFFFF
+      data.bytes.each do |b|
+        crc ^= (b << 8)
+        8.times do
+          crc = if (crc & 0x8000) != 0
+                  ((crc << 1) ^ 0x1021) & 0xFFFF
+                else
+                  (crc << 1) & 0xFFFF
+                end
+        end
+      end
+      crc
+    end
+
+    # Return 4-digit uppercase hex CRC
+    def self.checksum(payload)
+      xmodem(payload).to_s(16).upcase.rjust(4, '0')
+    end
+
+    # Append "<crc_tag>04<CRC>" to a TLV string
+    def self.with_crc(tlv_string, crc_tag = '63')
+      buffer = tlv_string + "#{crc_tag}04"
+      buffer + checksum(buffer)
+    end
+  end
+end

data/lib/thai_qr_pay/generate/promptpay/any_id.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/tlv'
+require 'thai_qr_pay/crc16'
+
+module ThaiQrPay
+  module Generate
+    module Promptpay
+      # Generates PromptPay “AnyID” (mobile/NationalID/etc.) EMVCo QR payloads.
+      class AnyID
+        PROXY = {
+          'MSISDN' => '01',
+          'NATID' => '02',
+          'EWALLETID' => '03',
+          'BANKACC' => '04'
+        }.freeze
+
+        # type: one of 'MSISDN','NATID','EWALLETID','BANKACC'
+        # target: the ID string; amount: optional numeric
+        def self.payload(type:, target:, amount: nil)
+          raise Error, 'Unknown type' unless PROXY.key?(type)
+
+          if type == 'MSISDN'
+            # replace leading 0 with 66
+            target = target.sub(/^0/, '66')
+          end
+
+          sub = [
+            TLV.tag('00', 'A000000677010111'),
+            TLV.tag(PROXY[type], target)
+          ]
+          tag29 = TLV.encode(sub)
+
+          main = [
+            TLV.tag('00', '01'),
+            TLV.tag('01', amount ? '12' : '11'),
+            TLV.tag('29', tag29),
+            TLV.tag('53', '764'),
+            TLV.tag('58', 'TH')
+          ]
+          main << TLV.tag('54', format('%.2f', amount)) if amount
+
+          CRC16.with_crc(TLV.encode(main), '63')
+        end
+      end
+    end
+  end
+end

data/lib/thai_qr_pay/generate/promptpay/bill_payment.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/tlv'
+require 'thai_qr_pay/crc16'
+
+module ThaiQrPay
+  module Generate
+    module Promptpay
+      # Generates PromptPay “Bill Payment” EMVCo QR payloads,
+      # including optional references and amount.
+      class BillPayment
+        # biller_id: string, amount: optional, ref1: string, ref2/3: optional
+        def self.payload(biller_id:, ref1:, amount: nil, ref2: nil, ref3: nil)
+          sub = [
+            TLV.tag('00', 'A000000677010112'),
+            TLV.tag('01', biller_id),
+            TLV.tag('02', ref1)
+          ]
+          sub << TLV.tag('03', ref2) if ref2
+          tag30 = TLV.encode(sub)
+
+          main = [
+            TLV.tag('00', '01'),
+            TLV.tag('01', amount ? '12' : '11'),
+            TLV.tag('30', tag30),
+            TLV.tag('53', '764'),
+            TLV.tag('58', 'TH')
+          ]
+          main << TLV.tag('54', format('%.2f', amount)) if amount
+          main << TLV.tag('62', TLV.encode([TLV.tag('07', ref3)])) if ref3
+
+          CRC16.with_crc(TLV.encode(main), '63')
+        end
+      end
+    end
+  end
+end

data/lib/thai_qr_pay/parser.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/tlv'
+require 'thai_qr_pay/crc16'
+
+module ThaiQrPay
+  # Parses EMVCo QR payloads into TLV tags, with optional CRC checking.
+  class Parser
+    attr_reader :payload, :tags
+
+    # strict: verify CRC before parsing; sub_tags: decode nested TLV
+    def initialize(payload, strict: false, sub_tags: true)
+      @payload = payload.dup
+
+      if strict
+        exp = payload[-4..]
+        calc = CRC16.checksum(payload[0..-5])
+        raise Error, 'CRC mismatch' unless exp == calc
+      end
+
+      @tags = TLV.decode(payload)
+
+      return unless sub_tags
+
+      @tags.each do |t|
+        next unless t.value.match?(/^\d{4}/)
+
+        subt = TLV.decode(t.value)
+        t.sub_tags = subt if subt.map(&:length) == subt.map { |s| s.value.length }
+      end
+    end
+
+    # Fetch a Tag struct by id (and optional sub_id)
+    def get_tag(id, sub_id = nil)
+      t = @tags.find { |x| x.id == id }
+      return unless t
+      return t unless sub_id && t.sub_tags
+
+      t.sub_tags.find { |st| st.id == sub_id }
+    end
+
+    # Fetch just the value
+    def get_tag_value(id, sub_id = nil)
+      get_tag(id, sub_id)&.value
+    end
+
+    # Recompute & compare CRC (default tag '63')
+    def valid_crc?(crc_tag = '63')
+      filtered = @tags.reject { |t| t.id == crc_tag }
+      rebuilt  = TLV.encode(filtered)
+      payload == CRC16.with_crc(rebuilt, crc_tag)
+    end
+  end
+end

data/lib/thai_qr_pay/tlv.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module ThaiQrPay
+  # TLV (Tag–Length–Value) parsing and encoding utilities
+  # for EMVCo-style QR payloads (PromptPay, TrueMoney, etc.).
+  module TLV
+    Tag = Struct.new(:id, :length, :value, :sub_tags)
+
+    # Decode an ASCII-numeric TLV string into an array of Tag structs
+    def self.decode(payload)
+      tags = []
+      idx = 0
+      while idx < payload.length
+        id = payload[idx, 2]
+        idx += 2
+        len = payload[idx, 2].to_i
+        idx += 2
+        value = payload[idx, len]
+        idx += len
+        tags << Tag.new(id, len, value, nil)
+      end
+      tags
+    end
+
+    # Encode an array of Tag structs back into an ASCII TLV string
+    def self.encode(tags)
+      tags.map do |t|
+        inner = t.sub_tags ? encode(t.sub_tags) : t.value
+        "#{t.id}#{inner.length.to_s.rjust(2, '0')}#{inner}"
+      end.join
+    end
+
+    # Helper to build a Tag struct from id + value
+    def self.tag(id, value)
+      Tag.new(id, value.length, value, nil)
+    end
+  end
+end

data/lib/thai_qr_pay/validate/slip_verify.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/parser'
+
+module ThaiQrPay
+  module Validate
+    # Validates EMVCo “slip verify” QR payloads:
+    # checks CRC and extracts sending_bank and trans_ref.
+    class SlipVerify
+      # payload: EMVCo mini-QR slip verify
+      # returns { sending_bank:, trans_ref: } or nil
+      def self.call(payload)
+        parser = ThaiQrPay::Parser.new(payload, strict: true)
+        api  = parser.get_tag_value('00', '00')
+        bank = parser.get_tag_value('00', '01')
+        tr   = parser.get_tag_value('00', '02')
+        return unless api == '000001' && bank && tr
+
+        { sending_bank: bank, trans_ref: tr }
+      end
+    end
+  end
+end

data/lib/thai_qr_pay/validate/true_money_slip_verify.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/parser'
+
+module ThaiQrPay
+  module Validate
+    # Validates TrueMoney “slip verify” QR payloads:
+    # checks CRC, then extracts event_type, transaction_id, and date.
+    class TrueMoneySlipVerify
+      # payload: TrueMoney slip verify format
+      # returns { event_type:, transaction_id:, date: } or nil
+      def self.call(payload)
+        parser = ThaiQrPay::Parser.new(payload, strict: true)
+        api  = parser.get_tag_value('00', '00')
+        evt  = parser.get_tag_value('00', '02')
+        txid = parser.get_tag_value('00', '03')
+        dt   = parser.get_tag_value('00', '04')
+        return unless api == '01' && evt && txid && dt
+
+        { event_type: evt,
+          transaction_id: txid,
+          date: dt }
+      end
+    end
+  end
+end

data/lib/thai_qr_pay/version.rb

@@ -0,0 +1,6 @@
+# lib/thai_qr_pay/version.rb
+# frozen_string_literal: true
+
+module ThaiQrPay
+  VERSION = '0.1.0'
+end

data/lib/thai_qr_pay.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'thai_qr_pay/version'
+require 'thai_qr_pay/tlv'
+require 'thai_qr_pay/crc16'
+require 'thai_qr_pay/parser'
+require 'thai_qr_pay/generate/promptpay/any_id'
+require 'thai_qr_pay/generate/promptpay/bill_payment'
+require 'thai_qr_pay/bot_barcode'
+require 'thai_qr_pay/validate/slip_verify'
+require 'thai_qr_pay/validate/true_money_slip_verify'
+
+module ThaiQrPay
+  class Error < StandardError; end
+end

data/spec/crc16_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# spec/crc16_spec.rb
+require 'thai_qr_pay/crc16'
+
+RSpec.describe ThaiQrPay::CRC16 do
+  describe '.checksum' do
+    it 'computes the correct CRC-16/XMODEM for a known string' do
+      payload = '0002010102116304'
+      # precomputed CRC for that prefix:
+      expect(ThaiQrPay::CRC16.checksum(payload)).to eq('AD0A')
+    end
+  end
+
+  describe '.with_crc' do
+    it 'appends the CRC tag, length and checksum' do
+      base = '000201010211'
+      full = ThaiQrPay::CRC16.with_crc(base, '63')
+      # must end with tag '63', length '04' and the 4-hex CRC
+      expect(full).to match(/\A0002010102116304[0-9A-F]{4}\z/)
+      # and be valid when recomputed
+      prefix = full[0..-5]
+      crc = full[-4..]
+      expect(ThaiQrPay::CRC16.checksum(prefix)).to eq(crc)
+    end
+  end
+end

data/spec/parser_spec.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+# spec/parser_spec.rb
+require 'thai_qr_pay/parser'
+require 'thai_qr_pay/generate/promptpay/any_id'
+
+RSpec.describe ThaiQrPay::Parser do
+  let(:mobile) { '0812345678' }
+  let(:valid_pp_anyid) do
+    ThaiQrPay::Generate::Promptpay::AnyID.payload(
+      type: 'MSISDN',
+      target: mobile,
+      amount: 10.5
+    )
+  end
+
+  describe '#initialize' do
+    it 'parses tags into an array' do
+      parser = described_class.new(valid_pp_anyid)
+      expect(parser.tags).to be_an(Array)
+      expect(parser.get_tag('00').value).to eq('01')
+    end
+
+    it 'raises on bad CRC when strict: true' do
+      bad = valid_pp_anyid.sub(/.{4}$/, 'DEAD')
+      expect { described_class.new(bad, strict: true) }.to raise_error(ThaiQrPay::Error, /CRC mismatch/)
+    end
+
+    it 'does not raise on bad CRC when strict: false' do
+      bad = valid_pp_anyid.sub(/.{4}$/, 'DEAD')
+      expect { described_class.new(bad, strict: false) }.not_to raise_error
+    end
+  end
+
+  describe '#get_tag and #get_tag_value' do
+    subject(:parser) { described_class.new(valid_pp_anyid, strict: true) }
+
+    it 'fetches top-level tag struct' do
+      tag = parser.get_tag('54')
+      expect(tag).to be_a(ThaiQrPay::TLV::Tag)
+      expect(tag.id).to eq('54')
+    end
+
+    it 'fetches nested sub-tag value' do
+      # Tag '29' contains sub-tags; '01' inside gives the MSISDN with 66 prefix
+      expected_msisdn = mobile.sub(/^0/, '66')
+      expect(parser.get_tag_value('29', '01')).to eq(expected_msisdn)
+    end
+
+    it 'returns nil for missing tags' do
+      expect(parser.get_tag('99')).to be_nil
+      expect(parser.get_tag_value('29', '99')).to be_nil
+    end
+  end
+
+  describe '#valid_crc?' do
+    it 'returns true for correct CRC' do
+      parser = described_class.new(valid_pp_anyid, strict: true)
+      expect(parser.valid_crc?).to be true
+    end
+
+    it 'returns false for tampered payload' do
+      tampered = valid_pp_anyid.sub('12', '11')
+      parser   = described_class.new(tampered, strict: false)
+      expect(parser.valid_crc?).to be false
+    end
+  end
+end

data/spec/thai_qr_pay_spec.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# spec/thai_qr_pay_spec.rb
+require 'thai_qr_pay'
+
+RSpec.describe ThaiQrPay do
+  it 'has a version number' do
+    expect(ThaiQrPay::VERSION).not_to be_nil
+  end
+
+  context 'integration examples' do
+    let(:mobile) { '0812345678' }
+    let(:biller) { '1234567890123' }
+
+    it 'generates and parses a PromptPay AnyID QR payload' do
+      payload = ThaiQrPay::Generate::Promptpay::AnyID.payload(
+        type: 'MSISDN',
+        target: mobile,
+        amount: 50.0
+      )
+      parser = ThaiQrPay::Parser.new(payload, strict: true)
+
+      # Standard EMVCo tags
+      expect(parser.get_tag_value('00')).to eq('01')    # Payload Format Indicator
+      expect(parser.get_tag_value('01')).to eq('12')    # Point-of-Initiation Method
+
+      # Sub-tag 29.01 contains the converted mobile number (no padding)
+      expected_msisdn = mobile.sub(/^0/, '66')
+      expect(parser.get_tag_value('29', '01')).to eq(expected_msisdn)
+
+      expect(parser.valid_crc?).to be true
+    end
+
+    it 'generates and parses a PromptPay Bill Payment QR payload' do
+      payload = ThaiQrPay::Generate::Promptpay::BillPayment.payload(
+        biller_id: biller,
+        ref1: 'INV001',
+        amount: 250.25
+      )
+      parser = ThaiQrPay::Parser.new(payload, strict: true)
+
+      # Sub-tag 30.01 is the biller ID
+      expect(parser.get_tag_value('30', '01')).to eq(biller)
+      # Tag 54 is the amount
+      expect(parser.get_tag_value('54')).to eq('250.25')
+      expect(parser.valid_crc?).to be true
+    end
+
+    it 'round-trips BOT barcode to QR Tag 30 payload' do
+      raw = "|#{biller}\rINV001\r\r012345"
+      bot = ThaiQrPay::BOTBarcode.from_string(raw)
+      expect(bot).not_to be_nil
+      expect(bot.biller_id).to eq(biller)
+      expect(bot.to_s).to eq(raw)
+
+      qr = bot.to_qr_tag30
+      parser = ThaiQrPay::Parser.new(qr, strict: true)
+      expect(parser.get_tag_value('30', '01')).to eq(biller)
+    end
+  end
+end

data/spec/tlv_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# spec/tlv_spec.rb
+require 'thai_qr_pay/tlv'
+
+RSpec.describe ThaiQrPay::TLV do
+  let(:raw) { '000201010211' }
+  let(:tags) { ThaiQrPay::TLV.decode(raw) }
+
+  describe '.decode' do
+    it 'parses a simple TLV string into an array of Tag structs' do
+      expect(tags.size).to eq(2)
+      expect(tags[0].id).to eq('00')
+      expect(tags[0].length).to eq(2)
+      expect(tags[0].value).to eq('01')
+
+      expect(tags[1].id).to eq('01')
+      expect(tags[1].length).to eq(2)
+      expect(tags[1].value).to eq('11')
+    end
+
+    it 'round-trips correctly with .encode' do
+      round = ThaiQrPay::TLV.encode(tags)
+      expect(round).to eq(raw)
+    end
+  end
+
+  describe '.encode' do
+    it 'builds a TLV string from Tag structs' do
+      t0 = ThaiQrPay::TLV.tag('00', 'A1')
+      t1 = ThaiQrPay::TLV.tag('01', 'BCD')
+      expect(ThaiQrPay::TLV.encode([t0, t1])).to eq('0002A10103BCD')
+    end
+  end
+end

data/thai_qr_pay.gemspec

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# thai_qr_pay.gemspec
+
+require_relative 'lib/thai_qr_pay/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'thai_qr_pay'
+  s.version     = ThaiQrPay::VERSION
+  s.summary     = 'A Ruby toolkit for Thailand’s EMVCo QR payments (PromptPay, TrueMoney, slip-verify, BOT barcode conversion)'
+  s.description = <<~DESC
+    thai_qr_pay is a Ruby gem providing:
+    - ASCII-numeric TLV parsing and encoding
+    - EMVCo CRC-16/IBM-SDLC checksum computation and validation
+    - Generators for PromptPay AnyID, PromptPay Bill Payment, TrueMoney, etc.
+    - Validators for slip-verify and TrueMoney slip verify payloads
+    - BOT barcode → EMVCo QR Tag-30 conversion
+  DESC
+  s.authors     = ['Chayut Orapinpatipat']
+  s.email       = ['chayut_o@hotmail.com']
+  s.files       = Dir.chdir(__dir__) { `git ls-files -z`.split("\x0") }
+  s.homepage    = 'https://github.com/chayuto/thai-qr-pay'
+  s.metadata ||= {}
+  s.metadata['documentation_uri'] = 'https://github.com/chayuto/thai-qr-pay#readme'
+  s.license = 'MIT'
+
+  s.required_ruby_version = '>= 2.7'
+  s.add_development_dependency 'rake', '~> 13.0'
+  s.add_development_dependency 'rspec', '~> 3.0'
+end

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: thai_qr_pay
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chayut Orapinpatipat
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-06-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: |
+  thai_qr_pay is a Ruby gem providing:
+  - ASCII-numeric TLV parsing and encoding
+  - EMVCo CRC-16/IBM-SDLC checksum computation and validation
+  - Generators for PromptPay AnyID, PromptPay Bill Payment, TrueMoney, etc.
+  - Validators for slip-verify and TrueMoney slip verify payloads
+  - BOT barcode → EMVCo QR Tag-30 conversion
+email:
+- chayut_o@hotmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/thai_qr_pay.rb
+- lib/thai_qr_pay/bot_barcode.rb
+- lib/thai_qr_pay/crc16.rb
+- lib/thai_qr_pay/generate/promptpay/any_id.rb
+- lib/thai_qr_pay/generate/promptpay/bill_payment.rb
+- lib/thai_qr_pay/parser.rb
+- lib/thai_qr_pay/tlv.rb
+- lib/thai_qr_pay/validate/slip_verify.rb
+- lib/thai_qr_pay/validate/true_money_slip_verify.rb
+- lib/thai_qr_pay/version.rb
+- spec/crc16_spec.rb
+- spec/parser_spec.rb
+- spec/thai_qr_pay_spec.rb
+- spec/tlv_spec.rb
+- thai_qr_pay.gemspec
+homepage: https://github.com/chayuto/thai-qr-pay
+licenses:
+- MIT
+metadata:
+  documentation_uri: https://github.com/chayuto/thai-qr-pay#readme
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.11
+signing_key:
+specification_version: 4
+summary: A Ruby toolkit for Thailand’s EMVCo QR payments (PromptPay, TrueMoney, slip-verify,
+  BOT barcode conversion)
+test_files: []