iso8583-lite

Pro ISO 8583 parser and builder for Node.js
Lightweight, zero-dependency library to build and parse ISO 8583 financial messages.
Supports bitmaps, variable-length fields (LLVAR), and string-based ISO 8583 messages.

Features

• ✅ Build and parse ISO 8583 messages (MTI + bitmap + fields)
• ✅ Primary and secondary bitmap support
• ✅ Set and get fields 1–128
• ✅ LLVAR and LLLVAR variable-length fields
• ✅ Field type enforcement (numeric, alphanumeric, amount, date/time)
• ✅ Lightweight, zero dependencies
• ✅ Ready for POS, ATM, and fintech projects

Installation

Using npm

npm install iso8583-lite

yarn add iso8583-lite

Using CDN

import { ISO8583 } from "iso8583-lite";

// Create ISO 8583 message
const iso = new ISO8583();

// Set fields
iso.setField(2, "1234567890123456"); // PAN
iso.setField(3, "000000");           // Processing code
iso.setField(4, "1000");             // Amount
iso.setField(7, "20251009123000");   // Transmission date/time

// Build message string
const msg = iso.buildMessage("0200");
console.log("Built ISO8583 Message:", msg);

// Parse message string
const iso2 = new ISO8583();
const parsed = iso2.parseMessage(msg);
console.log("Parsed MTI:", parsed.mti);
console.log("Parsed Fields:", parsed.fields);