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.

Du möchtest den Generator per URL-Parameter in deine eigene App oder Website integrieren? Schau dir unsere URL-Parameter API-Dokumentation an – kein API-Key, keine Registrierung.

Kontakt für Kooperationen

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