Zum Hauptinhalt springen

PostFinance QR-Rechnung

Überblick​

Mit dem QR-Rechnungs-Verarbeiter können Sie Schweizer QR-Rechnungen ausstellen und die entsprechenden Zahlungen automatisch in Ihrem Space abgleichen. Auf dieser Seite erfahren Sie, wie Sie den Verarbeiter aktivieren, eine QR-IBAN für den Produktivbetrieb beantragen und in den Live-Modus wechseln.

Voraussetzungen​

  • Ein PostFinance Checkout-Konto mit Administrator-Zugriff
  • Ein Schweizer Geschäftskonto
  • Unterschriftsberechtigung für das ESR-Anmeldeformular – PostFinance generiert die QR-IBAN
info

Sie können alle Schritte bis hin zu „Go live“ auch ohne QR-IBAN abschließen; die Transaktionen verbleiben im Test-Modus, bis Sie diese eingeben.

1. Verarbeiter aktivieren (Testmodus)​

  1. Melden Sie sich bei PostFinance Checkout an und wählen Sie den gewünschten Space aus.
  2. Öffnen Sie Einstellungen > Funktionen.
  3. Suchen Sie nach qr und wählen Sie QR-Verarbeiter für Rechnungen mit PostFinance aus.
  4. Klicken Sie auf Hinzufügen und anschließend auf Weiter.
  5. Geben Sie einen internen Namen ein (z. B. QR Invoice) und klicken Sie auf Speichern.

Ein Verarbeiter wird mit dem Status Test angezeigt.

2. Verhalten konfigurieren (optional)​

OptionZweck
Erinnerungs-E-Mails versendenVersendet vor dem Fälligkeitsdatum eine automatische Zahlungserinnerung.
Rechnungs-E-Mails versendenVersendet die PDF-Rechnung mit einem eingebetteten QR-Code an den Kunden.

Aktivieren Sie die Optionen, die zu Ihrem Arbeitsablauf passen, und klicken Sie auf Speichern.

Sofortige Rechnungszahlung (Konnektor-Einstellung)​

Im Konnektor Ihrer Zahlungsmethode „QR-Rechnung“ (Einstellungen > Zahlung > Konnektoren) können Sie die Option Sofortige Rechnungszahlung aktivieren. Ist diese Option aktiviert, enthält die Rechnungs-PDF-Datei zusätzlich einen QR-Code und einen Zahlungslink, sodass der Kunde die Rechnung sofort online bezahlen kann.

3. Beantragung einer QR-IBAN für den Produktivbetrieb​

  1. Öffnen Sie den Verarbeiter und klicken Sie auf ESR-Anmeldeformular.
  2. Laden Sie das PDF herunter, füllen Sie es aus und unterschreiben Sie es.
  3. Senden Sie das Formular an PostFinance – die Adresse und die Anweisungen finden Sie auf der letzten Seite.
  4. PostFinance stellt Ihre QR-IBAN innerhalb von etwa 5 Werktagen aus.
warnung

Die QR-IBAN unterscheidet sich von Ihrer regulären IBAN und beginnt immer mit CHxx 30000. Wenn Sie stattdessen Ihre reguläre IBAN verwenden, können die Zahlungen nicht abgeglichen werden.

4. In Betrieb nehmen​

  1. Nachdem Sie die QR-IBAN erhalten haben, kehren Sie zu Einstellungen > Funktionen > QR-Rechnungsverarbeiter zurück.
  2. Klicken Sie auf Auf Live umschalten.
  3. Fügen Sie die QR-IBAN in das Feld IBAN (Live) ein und klicken Sie auf Speichern.

Der Verarbeiterstatus ändert sich zu Live, und Ihr Konto kann nun echte QR-Rechnungen erstellen.

5. Eine QR-Rechnung erstellen (API-Beispiel)​

curl https://api.PostFinance Checkout.ch/transaction/create \
-u YOUR_USER_ID:YOUR_APP_SECRET \
-H "Content-Type: application/json" \
-d '{
"spaceId": 101112,
"currency": "CHF",
"amount": "120.00",
"paymentMethod": "QR_INVOICE",
"reference": "INV-2025-042"
}'
warnung

Der Host in diesem Beispiel verweist auf die PostFinance Checkout-API. Ersetzen Sie ihn durch den API-Endpunkt Ihrer eigenen Plattform – die korrekte Basis-URL und die Authentifizierungsdaten finden Sie unter Webservice-API.

Verwandte Themen​

  • Verarbeitern – wie Verarbeiter im Allgemeinen konfiguriert werden.
  • Transaktionsstatus – Eine QR-Rechnung wird asynchron bezahlt, daher verbleibt die Transaktion im Status Completed, bis die Zahlung eingegangen ist.
  • Abstimmung / Buchhaltung – Wie die abgestimmten Zahlungen in Ihren Berichten angezeigt werden.