ethqr-gen

A Rust library for generating EMVCo-compliant QR codes for payments according to the Ethiopian Interoperable QR Standard.

Features

• EMVCo QR Code standard compliance
• Support for multiple payment schemes (Visa, Mastercard, IPS ET, etc.)
• Static and dynamic QR code generation
• Built-in validation and error handling
• QR code image generation** (enable with qr-image feature)

Installation

Add this to your Cargo.toml:

[dependencies]
ethqr-gen = "0.1.0"

# For QR code image generation
ethqr-gen = { version = "0.1.0", features = ["qr-image"] }

Quick Start

Static QR Code (no amount specified)

use ethqr_gen::{QRBuilder, fields::SchemeConfig};

let qr_code = QRBuilder::new()
    .merchant_name("Coffee Shop")
    .merchant_city("Addis Ababa")
    .merchant_category_code("5812") // Restaurant
    .add_scheme(SchemeConfig::visa("4111111111111111"))
    .build()?;

Dynamic QR Code (with specific amount)

use ethqr_gen::{QRBuilder, fields::{SchemeConfig, AdditionalData}};

let additional_data = AdditionalData::new()
    .bill_number("INV-001")
    .reference_label("ORDER-123");

let qr_code = QRBuilder::new()
    .merchant_name("Restaurant")
    .merchant_city("Dire Dawa")
    .merchant_category_code("5812")
    .add_scheme(SchemeConfig::ips_et(
        "581b314e257f41bfbbdc6384daa31d16",
        "CBETETAA",
        "10000171234567890",
    ))
    .transaction_amount("420.00")
    .additional_data(additional_data)
    .build()?;

Multiple Payment Schemes

let qr_code = QRBuilder::new()
    .merchant_name("Supermarket")
    .merchant_city("Bahir Dar")
    .merchant_category_code("5411") // Grocery store
    .add_scheme(SchemeConfig::visa("4111111111111111"))
    .add_scheme(SchemeConfig::mastercard("5555555555554444"))
    .add_scheme(SchemeConfig::ips_et(
        "899c314e257f41bfbbdc6384dab49e15",
        "CBETETAA",
        "10000171234567890",
    ))
    .build()?;

Supported Payment Schemes

Scheme	Method	Description
Visa	SchemeConfig::visa()	Visa payment cards
Mastercard	SchemeConfig::mastercard()	Mastercard payment cards
UnionPay	SchemeConfig::unionpay()	UnionPay payment cards
IPS ET	SchemeConfig::ips_et()	Ethiopian Interbank Payment System

Standards Compliance

This library implements:

• EMVCo QR Code Specification for Payment Systems
• Ethiopian Interoperable QR Standard
• ISO 4217 currency codes (ETB - Ethiopian Birr)
• ISO 3166-1 country codes (ET - Ethiopia)

Examples

Check out the examples/ directory for more comprehensive usage examples:

Contributing

Contributions are always welcome!

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}