jansuchanek/nqrpay

Czech QR Platba (SPD) — QR code payment generator for Czech/Slovak banking apps

Maintainers

Package info

github.com/JanSuchanek/nqrpay

pkg:composer/jansuchanek/nqrpay

Statistics

Installs: 2

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-03-19 08:33 UTC

This package is auto-updated.

Last update: 2026-04-20 15:35:25 UTC


README

QR code generator for Czech/Slovak mobile banking apps. Generates SPD (Short Payment Descriptor) strings and QR codes.

Installation

composer require jansuchanek/nqrpay

Usage

use NQrPay\QrPayment;

$qr = new QrPayment(
    iban: 'CZ6508000000192000145399',
    accountName: 'Jan Suchánek',
    bankAccountNumber: '192000145399/0800',
);

// Generate SPD string
$spd = $qr->generateSpdString(1250.50, '2024001', 'Objednavka 001');
// SPD*1.0*ACC:CZ6508000000192000145399*AM:1250.50*CC:CZK*X-VS:2024001*MSG:Objednavka 001

// Generate QR code PNG
$png = $qr->generateQrPng(1250.50, '2024001');

// Save QR to file
$qr->generateQrFile('/path/to/qr', 'pay-001.png', 1250.50, '2024001');

// Extract variable symbol from order number
$vs = QrPayment::extractVariableSymbol('OBJ-20260303-1234');
// '202603031234'

// Account details for display
$details = $qr->getAccountDetails();
// ['ibanFormatted' => 'CZ65 0800 0000 1920 0014 5399', ...]

Requirements

  • PHP >= 8.1
  • endroid/qr-code ^5.0|^6.0