Integration & API

GiroCode für Entwickler & Agenturen

Diese Seite richtet sich an Entwickler, die GiroCodes in eigene Projekte, Faktura-Software oder Webseiten integrieren möchten.

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.

Zum GiroCode Generator

Kontakt für Kooperationen

Du bist Agentur oder Softwareanbieter und möchtest kooperieren? Meld dich gerne per E-Mail: kontakt@girocodegenerator.com