Unzer verbinden

Unzer wird über den Private Key verbunden. Die Besonderheit: Für Gebühren gibt es bei Unzer keine Schnittstelle, sie kommen einmal im Monat per CSV-Upload.

Einrichtung

1. Deinen Unzer Private Key bereitlegen. Wichtig: Verwende den Live-Key (p-priv-...), auch wenn du Rechnungskit erst testest. Rechnungskit liest nur mit und löst keine Zahlungen aus. Ein s-priv-...-Key verbindet die Unzer-Sandbox, in der deine echten Zahlungen nie erscheinen.
2. Unter Einstellungen → Connect bei Unzer eintragen. Rechnungskit prüft den Schlüssel gegen die Unzer-API.
3. Den Webhook registriert Rechnungskit automatisch bei Unzer (Zahlungs- und Rücklastschrift-Ereignisse).

Sicherheit der Webhooks

Unzer-Webhooks sind nicht signiert. Deshalb übernimmt Rechnungskit niemals Beträge aus der Webhook-Meldung selbst: Jede Meldung ist nur ein Anstoß, die Zahlung authentifiziert über deinen Private Key von der Unzer-API zurückzulesen. Gebucht wird ausschließlich, was die API bestätigt, und nur tatsächlich belastete Beträge (eine reine Autorisierung erzeugt keinen Beleg).

Was automatisch passiert

• Zahlungen aller Unzer-Zahlarten (Karte, Lastschrift, Rechnungskauf, Wallet) werden verarbeitet und zugeordnet, sofern das Unzer-Modul des Shops die Bestellnummer als Unzer-Order-ID übergibt (Shopware- und WooCommerce-Module tun das standardmäßig) und der Shop unter Einstellungen → Verbinden als Matching-Quelle der Unzer-Verbindung gewählt ist.
• Erstattungen erzeugen automatisch die Stornorechnung.
• Rücklastschriften sind bei Unzer endgültig, sie öffnen den Posten und landen zur Klärung in den Aufgaben, ohne automatischen Storno.
• Ein Sicherheitsnetz ruft regelmäßig nach, falls eine Webhook-Meldung verloren geht.

Gebühren: der monatliche ETN-Upload

Unzer weist Transaktionsgebühren nicht über die API aus, sondern im Einzeltransaktionsnachweis (ETN), der CSV-Datei zu deiner monatlichen Unzer-Rechnung.

• Lade die ETN-Datei einmal im Monat im Monatsbericht (/report) hoch; die Upload-Box erscheint dort, sobald Unzer verbunden ist.
• Nutzt du Unzer-Paylater-Methoden (Rechnungskauf, Ratenkauf), gibt es dafür eine ZWEITE, separate ETN-Datei im eigenen Paylater-Format. Lade beide Dateien in dieselbe Upload-Box; Rechnungskit erkennt am Dateiaufbau automatisch, welche Variante es ist. Die Paylater-Datei kommt per E-Mail zusammen mit der Paylater-Abrechnung oder per SFTP von Unzer.
• Rechnungskit ordnet die Gebühren den einzelnen Transaktionen zu, inklusive Netto/USt-Aufteilung, Disagio, Interchange und Scheme-Gebühren.
• Ein erneuter Upload derselben oder einer korrigierten Datei ist sicher: Positionen werden über die Unzer-Rechnungsnummer aktualisiert, nie dupliziert.

Der Upload ist bewusst manuell: Der ETN-Download bei Unzer läuft über eine kurzlebige Portal-Sitzung, die sich nicht unbeaufsichtigt automatisieren lässt.

Grenzen, ehrlich benannt

• Unzer hat keine Auszahlungs-Schnittstelle. Ein Abgleich gegen den Zahlungseingang auf dem Bankkonto, wie bei Stripe oder Mollie, ist bei Unzer technisch nicht möglich. Basis für Gebühren ist die monatliche Unzer-Rechnung (ETN).

Wo in der App

• /settings/connect, Unzer verbinden
• /report, ETN-CSV hochladen (Monatsbericht)
• /payments, Zahlungen, Rücklastschriften und Klärfälle

Zuordnung und Grenzen der ETN-Positionen

• Die automatische Zuordnung braucht zwei Einstellungen: Das Unzer-Modul im Shop übergibt die Bestellnummer als Unzer-Order-ID (Shopware und WooCommerce standardmäßig; bei anderen Shops in der Modul-Konfiguration prüfen), und der Shop ist unter Einstellungen → Verbinden als Matching-Quelle der Unzer-Verbindung gewählt. Die Vorschau an der Verbindung zeigt, ob die letzten Zahlungen matchen.
• Am 1. des Monats erinnert Rechnungskit automatisch an den ETN-Upload des Vormonats: als offene Aufgabe im Dashboard und in der Aufgaben-Erinnerung per E-Mail (standardmäßig freitags), mit Direktlink zum passenden Monat im Bericht. Die Aufgabe verschwindet mit dem Upload.
• ETN-Positionen tragen Unzers eigene Transaktionsnummern, nicht die API-Zahlungs-IDs. Summen, Gebühren und USt-Aufteilung stimmen automatisch; einzelne Auszahlungspositionen werden bei Bedarf manuell auf /payouts zugeordnet.