Für Entwickler

API-Dokumentation

Erzeuge SEPA-QR-Codes mit einem einzigen HTTP-Endpunkt und erhalte direkt eine PNG-Datei.

Überblick

Die API erstellt einen QR-Code für eine SEPA-Überweisung. Er lässt sich mit gängigen Banking-Apps scannen und eignet sich zum Beispiel für Rechnungen, Spenden oder Zahlungsaufforderungen.

Ein Endpunkt

Schnell und unkompliziert integrierbar.

Für Überweisungen

IBAN, Betrag und Referenz im QR-Code.

Direkte Antwort

Das Ergebnis kommt als PNG-Datei.

Endpunkt

POSThttps://sepaqr.de/api/qr

HeaderContent-Type: application/json

Parameter

Parameter	Typ	Pflicht	Beschreibung
`iban`	string	Ja	Gültige IBAN; Leerzeichen sind erlaubt.
`amount`	number	Nein	Positiver Überweisungsbetrag in Euro.
`recipient`	string	Ja	Name des Zahlungsempfängers.
`usage`	string	Nein	Verwendungszweck oder Zahlungsreferenz.

Beispiele

const response = await fetch('https://sepaqr.de/api/qr', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    iban: 'DE89 3704 0044 0532 0130 00',
    amount: 50.00,
    recipient: 'Max Mustermann',
    usage: 'Rechnung 123'
  })
});

const qrCode = await response.blob();

Antworten

200

Erfolgreich

PNG-Bilddaten mit Content-Type: image/png.

400

Ungültige Eingabe

{ "error": "Invalid IBAN format" }

500

Serverfehler

{ "error": "Failed to generate QR code" }

Hinweise

Validierung

Die IBAN muss formal gültig sein.
Der Betrag muss größer als null sein.
Der Empfängername ist erforderlich.
Der Verwendungszweck ist optional.

Empfehlungen

Eingaben vor dem Senden prüfen.
Eindeutige Empfängernamen verwenden.
Nachvollziehbare Referenzen angeben.
Fehlerantworten im Client behandeln.