Den EPC-Payload selbst generieren
Der EPC-Payload ist ein zeilenorientierter Text. Mit folgender Funktion kannst du ihn in JavaScript/TypeScript erzeugen:
function buildEPC({ name, iban, bic = '', amount, purpose = '' }) {
const amountStr = amount ? 'EUR' + Number(amount).toFixed(2) : '';
return [
'BCD', '001', '1', 'SCT',
bic.trim(),
name.trim().slice(0, 70),
iban.replace(/\s+/g, '').toUpperCase(),
amountStr,
'', '',
purpose.trim().slice(0, 140)
].join('\n');
}QR-Code aus dem Payload generieren
Mit dem Paket qrcode (npm) kannst du aus dem Payload einen QR-Code zeichnen:
import QRCode from 'qrcode';
const payload = buildEPC({
name: 'Max Mustermann',
iban: 'DE89370400440532013000',
amount: 99.99,
purpose: 'Rechnung 2025-001'
});
QRCode.toCanvas(canvas, payload, {
errorCorrectionLevel: 'M',
width: 220
});Diesen Generator verwenden
Du kannst auf diesen Generator verlinken oder ihn als Referenzimplementierung nutzen. Der gesamte Quellcode ist öffentlich auf GitHub einsehbar.
Du willst GiroCodes serverseitig aus deiner eigenen App erzeugen? Unsere REST-API befindet sich derzeit in der Beta-Phase. In der API-Dokumentation kannst du dich für den Beta-Zugang anmelden.
Google Workspace Integration
Für die serverseitige Generierung aus Google Apps Script, Sheets oder Docs brauchst du unsere REST-API. Sie befindet sich derzeit in der Beta-Phase – den Zugang kannst du über die API-Dokumentation anfordern. Für die clientseitige Erzeugung nutzt du den EPC-Payload wie oben gezeigt.
Das Google Workspace Add-on für GiroCodes ist in Entwicklung. Als Beta-Tester anmelden →
Kontakt für Kooperationen
Du bist Agentur oder Softwareanbieter und möchtest kooperieren? Meld dich gerne per E-Mail: jahnke.kaleb@gmail.com