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.

Google Workspace Integration

Du kannst den GiroCode Generator direkt aus Google Apps Script aufrufen:

function createGiroCode(name, iban, betrag, zweck) {
  const url = 'https://girocodegenerator.com/api/generate'
    + '?name=' + encodeURIComponent(name)
    + '&iban=' + encodeURIComponent(iban)
    + '&betrag=' + encodeURIComponent(betrag)
    + '&zweck=' + encodeURIComponent(zweck);
  
  const response = UrlFetchApp.fetch(url);
  const data = JSON.parse(response.getContentText());
  return data.qr_base64; // Base64 PNG des QR-Codes
}

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