QR-Rechnung programmatisch generieren

Der Link in fünf Schritten

Der Zahlteil lebt vollständig in der URL. Du baust den Link, indem du nacheinander Parameter an die Basis-Adresse https://www.swissqrlink.ch/qr anhängst.

1. 1

   Empfänger angeben (Pflichtfelder)

   Jeder Link beginnt mit den sieben Pflichtfeldern des Empfängers. credAccount ist eine gültige CH- oder LI-IBAN, credCountry muss zur IBAN passen.

   https://www.swissqrlink.ch/qr?credAccount=CH0209000000100013997 &credName=Max%20Muster &credAddress=Musterstrasse &credBuildingNumber=123 &credZip=8001 &credCity=Z%C3%BCrich &credCountry=CH
2. 2

   Betrag und Währung festlegen (optional)

   amount mit Punkt oder Komma, currency entweder CHF oder EUR. Ohne Betrag bleibt das Feld auf dem Einzahlungsschein leer.

   &amount=500.00&currency=CHF
3. 3

   Referenz zur IBAN wählen

   Die Referenzart hängt von der IBAN ab und ist die häufigste Fehlerquelle:

   • QR-IBAN (IID 30000–31999): gültige 27-stellige QR-Referenz erforderlich.
   • Normale IBAN: keine Referenz oder eine gültige Creditor Reference beginnend mit RF (ISO 11649).

   &reference=RF18 5390 0754 7034 # normale IBAN → RF-Referenz &reference=210000000003139431433899012 # QR-IBAN → 27-stellige QR-Referenz
4. 4

   Zahlende Person und Mitteilung ergänzen (optional)

   Die fünf deb-Felder bilden die Adresse der zahlenden Person. Sobald eines davon gesetzt ist, müssen alle fünf vollständig sein – sonst wird der Link abgelehnt. additionalInformation ist die Mitteilung auf dem Einzahlungsschein.

   &debName=Maxine%20Musterine &debAddress=Demostrasse &debBuildingNumber=321 &debZip=8002 &debCity=Z%C3%BCrich &debCountry=CH &additionalInformation=Bitte%20so%20schnell%20wie%20m%C3%B6glich%20bezahlen
5. 5

   Werte URL-kodieren und testen

   Kodiere jeden Wert mit encodeURIComponent – Leerzeichen als %20, Umlaute als %C3%BC (ü). Öffne den fertigen Link im Browser: stimmt alles, erscheint sofort der QR-Einzahlungsschein; bei einem Fehler bleibt die Seite leer.

   const link = `https://www.swissqrlink.ch/qr?${new URLSearchParams(params).toString()}`;