qris_dinamis 1.0.1

Convert static QRIS (Quick Response Code Indonesian Standard) to dynamic QRIS. Supports string output and image generation with template overlay.

Qris Dinamis

Convert static QRIS (Quick Response Code Indonesian Standard) to dynamic QRIS. Pure Dart — works on Flutter, server-side Dart, and CLI.

Features

• Convert static QRIS to dynamic — with or without image output
• Parse QRIS data — extract merchant name, NMID, NNS, etc.
• CRC-16 validation — verify QRIS checksum integrity

Installation

dependencies:
  qris_dinamis: ^1.0.0

dart pub get

Usage

All functionality is accessed through a single QrisDinamis class:

import 'package:qris_dinamis/qris_dinamis.dart';

final qris = QrisDinamis('00020101021126570011ID........');

Convert to Dynamic QRIS (String Only)

final result = qris.convertFromStatic(nominal: '50000');
print(result.qrisString); // Dynamic QRIS string
print(result.imageBytes);  // null

Convert to Dynamic QRIS (With Image)

final result = qris.convertFromStatic(
  nominal: '50000',
  withImage: true,
);
print(result.qrisString);  // Dynamic QRIS string
File('output.png').writeAsBytesSync(result.imageBytes!); // PNG image

Convert with Template Overlay

final template = File('template.png').readAsBytesSync();
final result = qris.convertFromStatic(
  nominal: '50000',
  withImage: true,
  templateImage: template,
);

Convert with Tax/Fee

// Percentage fee
final result = qris.convertFromStatic(
  nominal: '50000',
  taxType: 'p',
  fee: '10',
);

// Fixed rupiah fee
final result = qris.convertFromStatic(
  nominal: '50000',
  taxType: 'r',
  fee: '1000',
);

Parse QRIS Data

final data = qris.parse();
print(data.merchantName); // Merchant name
print(data.nmid);         // National Merchant ID
print(data.nns);          // National Number System
print(data.crcIsValid);   // CRC validation result

Validate CRC

print(qris.isCrcValid); // true or false

convertFromStatic() Parameters

Parameter	Required	Description
nominal	✅	Transaction amount
taxType	❌	'p' for percentage, 'r' for rupiah (default: 'p')
fee	❌	Fee amount (default: '0')
withImage	❌	Generate PNG image (default: false)
templateImage	❌	Template image bytes for overlay
qrSize	❌	QR code size in pixels (default: 400)
qrMargin	❌	QR code margin in modules (default: 2)

Credits

Based on Qris-Dinamis by Rachma Azis.

License

MIT

Support