BER‑TLV/TLV parser for EMV payment data: recursive decode of constructed/primitive tags, hex-string I/O, comprehensive EMV tag dictionary, and rich value explainers and visualizations.
A cross-platform BER-TLV / TLV parser for EMV payment systems.
Parse, explain, and visualize EMV BER-TLV data on any platform — Web, Android, iOS, and JVM — from a single Kotlin Multiplatform core.
Universal BERTLV provides:
┌─────────────────────────────────────────────┐
│ Your App │
│ (Flutter / Kotlin) │
├─────────────────────────────────────────────┤
│ plugin/ — Flutter Plugin │
│ ┌─────────────┐ ┌──────────────────────┐ │
│ │ bertlv_emv │ │ Platform packages │ │
│ │ (interface) │ │ _web │ _mobile │ │
│ └─────────────┘ └──────────────────────┘ │
├─────────────────────────────────────────────┤
│ lib/ — Kotlin Multiplatform │
│ bertlv-emv (core) │
│ JS • JVM • Android • iOS (Native) │
└─────────────────────────────────────────────┘
Add the app-facing package to your pubspec.yaml:
dependencies:
bertlv_emv: ^0.0.9
The correct platform package (bertlv_emv_web or bertlv_emv_mobile) is selected automatically.
// build.gradle.kts
implementation("io.github.rafaelrabeloit:bertlv-emv:0.0.9")
GitHub Packages is also available for snapshot builds — see lib/bertlv-emv/build.gradle.kts.
import 'package:bertlv_emv/bertlv_emv.dart';
final parser = BertlvEmv();
final result = await parser.parse('6F1A840E315041592E5359532E4444463031A5088801025F2D02656E');
for (final tag in result.tags) {
print('${tag.hexTag}: ${tag.name} = ${tag.hexValue}');
}
Parse a TLV list from hex:
import io.github.rafaelrabeloit.bertlv.TLV
import io.github.rafaelrabeloit.bertlv.TLVList
import io.github.rafaelrabeloit.bertlv.TlvFindMode
import io.github.rafaelrabeloit.emv.EmvSpecification
val tlvList = TLVList.fromTlvListBuffer(
"6F1A840E315041592E5359532E4444463031A5088801025F2D02656E",
listOf(EmvSpecification),
)
tlvList.tlvs.forEach { println("${it.tag.toString(16).uppercase()}: ${it.hexValue}") }
Parse or build a single TLV:
// Parse complete TLV from hex (spaces allowed)
val aid = TLV.fromBinaryTlvBuffer("9F06 07 A0000000031010")
println(aid.hexValue) // A0000000031010
// Build from tag + value hex
val built = TLV.fromTagAndBinaryValue(0x9F06, "A0000000031010")
// Find a tag inside a TLV list
val tvr = tlvList.find(0x95, TlvFindMode.FIRST)
val duplicateSensitive = tlvList.find(0x95, TlvFindMode.STRICT) // throws if duplicated
| Layer | Path | Role |
|---|
| Core | lib/bertlv-emv | KMP library — parser, tag registry, value explainers |
| Plugin interface | plugin/bertlv_emv | Platform-agnostic Dart API (federated plugin) |
| Web impl | plugin/bertlv_emv_web | dart:js_interop bridge to KMP JS output |
| Mobile impl | plugin/bertlv_emv_mobile | dart:ffi bridge to Kotlin/Native |
| Platform | Mechanism |
|---|
| Web | Kotlin/JS → dart:js_interop |
| Android | Kotlin/Native → dart:ffi |
| iOS | Kotlin/Native → dart:ffi |
| JVM | Direct Kotlin dependency |
Surfaced from shared tags and platforms — no rankings paid for.